Difference between revisions of "Getting Started with OnePager Pro Version 5.3 Add-in"

From OnePager Documentation
Jump to: navigation, search
Line 5: Line 5:
 
<center>[[File:P53-3_0_1-53-(01)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(01)-11062015.png]]</center>
  
This article covers the '''Getting Started''' process when you launch '''OPP'''.  The article which provides “Getting Started” guidance when using the desktop icon to launch OnePager Pro is at [[Getting Started with OnePager Pro Version 5.3 Desktop]].
+
This article covers the '''Getting Started''' process when you launch '''OPP''' from Microsoft Project.   
 +
 
 +
The article which provides '''Getting Started''' guidance when using the '''desktop''' icon to launch '''OPP''' is at [[Getting Started with OnePager Pro Version 5.3 Desktop]].
  
 
===Launching OnePager Pro for the First Time===
 
===Launching OnePager Pro for the First Time===
  
1) OnePager Pro is an add-in to Microsoft Project, which automatically displays the “OnePager” icon once OnePager is installed. That tool bar looks like this:
+
1) The '''OPP Add-in''' automatically displays the '''OnePager''' icon on the Microsoft Project ribbon once OnePager is installed. That tool bar looks like this:
  
 
<center>[[File:P53-3_0_1-53-(1)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(1)-11062015.png]]</center>
  
<center></center>
+
2) Clicking the '''OnePager Pro''' button will take you to the Project View Editor ('''PVE'''). Clicking the '''Templates…''' button will let you edit the templates for your graphs. For now, it is simplest to use the default template.  You can learn how templates let you customize and standardize graph features later in this document.
  
<center>P53-3_0_1-53-(1)-11062015.png</center>
+
3) Before you launch '''OPP''', it is a good idea to unhide the '''flag''' column you intend to use. (Note that when you unhide a column in Microsoft Project, that column may now appear in some of Microsoft Project’s standard reports. Do not forget to hide the column again before generating such reports if you do not want the column to appear in those reports.)  The selected '''flag''' column allows you to control which tasks get graphed and to store those choices in Microsoft Project for future use. For example, the '''flag''' field (e.g., Flag20) is shown below:
 
+
<center></center>
+
 
+
2) Clicking the “OnePager Pro” button will take you to the Project View Editor. Clicking the “Templates…” button will let you edit the templates for your graphs. For now, it is simplest to use the default template, but you can learn how templates let you customize and standardize graph features later in this document.
+
 
+
3) Before you launch OnePager Pro, it is a good idea to unhide the “flag” column you intend to. (Note that when you unhide a column in Microsoft Project, that column may now appear in some of Microsoft Project’s standard reports. Do not forget to hide the column again before generating such reports if you do not want the column to appear in those reports.)  The selected “flag” column allows you to control which tasks get graphed and to store those choices in Microsoft Project for future use. An example of the use of a “flag” field (Flag20) is shown below:
+
  
 
<center>[[File:P53-3_0_1-53-(2)-11162015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(2)-11162015.png]]</center>
  
<center>P53-3_0_1-53-(2)-11162015.png</center>
+
4) To control which tasks get graphed, specify the '''flag''' column (e.g. Flag1, Flag2 … Flag20) that you wish to use. '''Number''' fields may also be used the same as the '''flag''' fields where a “1” in a '''Number''' field indicates '''Yes'''and a '''0''' in a '''Number''' field indicates '''No'''. Unhide that column in Microsoft Project by right-clicking in the column header area and selecting '''Insert Column''':
 
+
4) To control which tasks get graphed, specify the flag column (e.g. Flag1, Flag2 … Flag20) that you wish to use. Number fields may also be used the same as the Flag fields where a “1” in a Number field indicates “Yes” and a “0” in a Number field indicates “No. ”Unhide that column in Microsoft Project by right-clicking in the column header area and selecting “Insert Column”:
+
  
 
<center>[[File:P53-3_0_1-53-(3)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(3)-11062015.png]]</center>
  
<center></center>
+
5) Now put a '''Yes''' in this flag column for any task that you want to graph:
 
+
<center>P53-3_0_1-53-(3)-11062015.png</center>
+
 
+
<center></center>
+
 
+
5) Now put a “Yes” in this flag column for any task that you want to graph:
+
  
 
<center>[[File:P53-3_0_1-53-(4)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(4)-11062015.png]]</center>
  
<center></center>
+
:a) When making your first project view, we strongly recommend that you mark 50 or fewer tasks with '''Yes'''.
  
<center>P53-3_0_1-53-(4)-11062015.png</center>
+
:b) Please note that '''OPP''' is shipped with a number of fully populated templates that are based on the Microsoft Project file used in the tutorial also shipped with the product – BlueGrass Project 2J-303.
  
<center></center>
+
:c) Starting in Microsoft Project 2010, there is a '''Manual Scheduling''' mode that allows you to leave dates blank in your schedule. However, behind the scenes, these dates are still being automatically assigned to the project '''Start Date''', or to '''Today's Date''' if the project '''Start Date''' is not defined. Even though the dates appear to be undefined, they are defined behind the scenes, and are being passed to '''OPP'''. Because '''Today's Date''' often equals your '''Snapshot date''', it is not surprising to see all of these '''dateless tasks''' appearing near the '''time cursor'''. 
  
:a) '''When making your first project view, we strongly recommend that you mark 50 or fewer tasks with “Yes.”'''
+
:d) There are two solutions to this issue: (1) Define the dates for your tasks and milestones in Microsoft Project. This will overwrite any default dates that Microsoft Project is assigning, and will make your project schedule more consistent with your '''OPP''' timeline. (2) Remove the '''dateless tasks''' from your '''OPP''' graph. You can leave them in project, but by removing them from the '''OPP''' graph, you won't have to explain why certain tasks/milestones are appearing in weird places when they really should not.  As a rule of thumb, we recommend defining dates for all tasks and milestones, especially when it comes to graph generation.
  
:b) '''Please note that OnePager Pro is shipped with a number of fully populated templates that are based on the Microsoft Project file used in the Tutorial also shipped with the product – BlueGrass Project 2J-303. '''
+
6) To launch '''OPP''' and make a project view, click the '''OnePager Pro''' button on the Microsoft Project tool bar’s '''Add-ins''' tab, which brings up the '''OnePager Pro Start''' form:
 
+
:c) Starting in Microsoft Project 2010, there is a "Manual Scheduling" mode that allows you to leave dates blank in your schedule. However, behind the scenes, these dates are still being automatically assigned to the project Start Date, or to Today's Date if the project Start Date is not defined. Even though the dates appear to be undefined, they are defined behind the scenes, and are being passed to OnePager Pro. Because Today's Date often equals your “Snapshot date”, it is not surprising to see all of these "dateless tasks" appearing near the time cursor. 
+
 
+
:d) There are two solutions to this issue: (1) Define the dates for your tasks and milestones in Microsoft Project. This will overwrite any default dates that Microsoft Project is assigning, and will make your project schedule more consistent with your OnePager Pro timeline. (2) Remove the dateless tasks from your OnePager Pro graph. You can leave them in project, but by removing them from the OnePager Pro graph, you won't have to explain why certain Tasks/Milestones are appearing in weird places when they really should not be. As a rule of thumb, we recommend defining dates for all tasks and milestones, especially when it comes to graph generation.
+
 
+
6) To launch OnePager Pro and make a project view, click the “OnePager Pro” button on the Microsoft Project tool bar’s “Add-ins” tab, which brings up the “OnePager Pro Start” form:
+
  
 
<center>[[File:P53-3_0_1-53-(5)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(5)-11062015.png]]</center>
  
<center></center>
+
7) The '''OnePager Pro Start''' form provides you with three options:
 
+
<center>P53-3_0_1-53-(5)-11062015.png</center>
+
 
+
7) The “OnePager Pro Start” form provides you with three options:
+
  
:a) '''NEW''': Clicking the “NEW” button will bring up the “OnePager Pro choices” form for creating a new project view.
+
:a) '''NEW'''  Clicking the '''NEW''' button will bring up the '''OnePager choices''' ('''OPC''') form.
  
:b) '''UPDATE''': Clicking the “UPDATE” button will allow you to BROWSE FILES for an existing project view file or select a recently-opened project view file so that you can add or replace a snapshot in it.
+
:b) '''UPDATE'''  Clicking the '''UPDATE''' button will allow you to '''BROWSE FILES''' for an existing project view file or select a recently-opened project view file.
  
:c) '''OPEN''': Clicking the “OPEN” button will allow you to BROWSE FILES for an existing project view file or select a recently-opened project view file.  Once selected and opened, the project view is available for editing.
+
:c) '''OPEN'''  Clicking the '''OPEN''' button will allow you to '''BROWSE FILES''' for an existing project view file or select a recently-opened project view file.  Once selected and opened, the project view is available for editing.
  
 
===Creating a New Project View===
 
===Creating a New Project View===
  
8) Clicking the “NEW” button brings up the “OnePager choices” form as shown below:
+
8) Clicking the '''NEW''' button brings up the '''OPC''' form as shown below:
  
 
<center>[[File:P53-3_0_1-53-(6)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(6)-11062015.png]]</center>
 
<center></center>
 
 
<center>P53-3_0_1-53-(6)-11062015.png</center>
 
  
 
===Options on the New OnePager Choices form===
 
===Options on the New OnePager Choices form===
  
9) We’ve enhanced the “OnePager choices” form to give you more options for selecting source files as input to OnePager Pro.  The illustration above shows that OnePager Pro was initiated from Microsoft Project with the source file shown in the “Selected File(s) section shown above.  The “Add/Remove” button gives you the capability to '''add''' more files to the source file “package” or, for multiple file packages to '''remove''' files if desired.
+
9) We’ve enhanced the '''OPC''' form to give you more options for selecting source files.  The illustration above shows that '''OPP''' was initiated from Microsoft Project with the source file shown in the '''Selected File(s)''' group shown above.  The '''Add/Remove''' button gives you the capability to '''add''' more files to the '''source packet''' or, for multiple file packets to '''remove''' files.
  
:a) Clicking the “Add/Remove” button brings up the “Data source selection” form as shown below:
+
:a) Clicking the '''Add/Remove''' button brings up the '''Data source selection''' form as shown below:
  
 
<center>[[File:P53-3_0_1-53-(7)-02122016.png]]</center>
 
<center>[[File:P53-3_0_1-53-(7)-02122016.png]]</center>
  
<center></center>
+
:b) The '''Data source selection''' form displays the current source file that was loaded with Microsoft Project when you clicked the '''OnePager Pro'''.  This form lets you '''Add''' more source Microsoft Project source files to create a multi-project project view or '''Remove''' a file from a multi-file '''source packet'''.  These options are detailed below.
 
+
<center>P53-3_0_1-53-(7)-02122016.png</center>
+
 
+
<center></center>
+
 
+
:b) The “Data source selection” form displays the current source file that was loaded with Microsoft Project when you clicked the “OnePager Pro” button on the Microsoft Project tool bar.  This form lets you '''Add''' more source Microsoft Project source files to create a multi-project project view, '''Remove''' a file from a multi-file source package, or '''Preview''' a Microsoft Project source file within Microsoft Project if you added a new source file to the package.  These options are detailed below.
+
  
 
===Adding a New Source File===
 
===Adding a New Source File===
  
:c) '''Add''' a new source file to the list.  When you click the “Add” button, OnePager Pro will give you the option to bring up a Windows “Open” form when you select the “BROWSE FILES…” option as shown here:
+
:c) '''Add''' a new source file to the '''source packet'''.  When you click the '''Add''' button, '''OPP''' will give you the option to bring up a Windows '''Open''' form when you select the '''BROWSE FILES…''' option as shown here:
  
 
<center>[[File:P53-3_0_1-53-(8)-02122016.png]]</center>
 
<center>[[File:P53-3_0_1-53-(8)-02122016.png]]</center>
  
<center></center>
+
::i) Clicking the '''BROWSE FILES…''' option will display a Window’s '''Open''' form from which you may select a Microsoft Project file to add to the '''source packet'''.  A sample '''Open''' form is shown below:
 
+
<center>P53-3_0_1-53-(8)-02122016.png</center>
+
 
+
::i) Clicking the “BROWSE FILES…” option will display a Window’s “Open” form from which you may select a Microsoft Project file to add to the source file package.  A sample “Open” form is shown below:
+
  
 
<center>[[File:P53-3_0_1-53-(9)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(9)-11062015.png]]</center>
Line 115: Line 79:
 
<center>P53-3_0_1-53-(9)-11062015.png</center>
 
<center>P53-3_0_1-53-(9)-11062015.png</center>
  
::ii) When you select a desired Microsoft Project source file and click the “Open” button as shown above, OnePager Pro will add the file to the package and display it in the “Data source selection” window as shown below:
+
::ii) When you select a desired Microsoft Project source file and click the '''Open''' button as shown above, '''OPP''' will add the file to the '''source packet''' and display it in the '''Data source selection''' window as shown below:
  
 
<center>[[File:P53-3_0_1-53-(10)-02122016.png]]</center>
 
<center>[[File:P53-3_0_1-53-(10)-02122016.png]]</center>
  
<center>P53-3_0_1-53-(10)-02122016.png</center>
+
::iii) The selected file is added to the '''source packet''' as shown above.  '''OPP''' shows the path name of the files in the window if you hover the mouse over the file name.
  
::iii) The selected file is added to the source file package as shown above.  For convenience, OnePager Pro shows the path name of the files in the window if you hover the mouse over the file name.
+
::iv) If you select a recently used file from the dropdown menu displayed with the '''Add''' button is clicked in the '''Data source selection''' form, '''OPP''' will add that file to the '''source packet'''.
 
+
::iv) If you select a recently used file from the drop down menu displayed with the “Add” button is clicked in the “Data source selection” form, OnePager Pro will add that file to the source file package.
+
  
 
===Removing a Source File===
 
===Removing a Source File===
  
:d) '''Remove''' source from list.  The “Remove” button allows you to remove a source file from a source file package if that file is not needed to create the NEW project view.  To remove a file first select the file in the “Data source selection” form’s window so that it is highlighted in blue then click the “Remove” button as shown in the sequence below:
+
:d) '''Remove''' source from '''source packet'''.  The '''Remove''' button allows you to remove a source file from a '''source packet''' if that file is not needed to create the new project view.  To remove a file, first select the file in the '''Data source selection''' form’s window so that it is highlighted in blue then click the '''Remove''' button as shown in the sequence below:
  
 
<center>[[File:P53-3_0_1-53-(11)-02122016.png]]</center>
 
<center>[[File:P53-3_0_1-53-(11)-02122016.png]]</center>
 
<center>P53-3_0_1-53-(11)-02122016.png</center>
 
  
 
<center>[[File:P53-3_0_1-53-(12)-02122016.png]]</center>
 
<center>[[File:P53-3_0_1-53-(12)-02122016.png]]</center>
 
<center>P53-3_0_1-53-(12)-02122016.png</center>
 
  
 
===Other Choices to Make===
 
===Other Choices to Make===
  
10) Moving on to the other sections of the “OnePager choices” form, you are asked to confirm a few things before you build the project view. OnePager Pro will make good guesses for each of these choices, but you can change any of them:
+
10) Moving on to the other sections of the '''OPC''' form, you are asked to confirm a few things before you build the project view. '''OPP''' will make good guesses for each of these choices, but you can change any of them:
  
 
<center>[[File:P53-3_0_1-53-(15)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(15)-11062015.png]]</center>
  
<center>P53-3_0_1-53-(15)-11062015.png</center>
+
:a) '''Starting Template''' The current template determines which columns get imported from Microsoft Project and how the initial project view looks.  '''OPP''' ships with many sample templates, but you can also customize your own templates.
 +
 
 +
::i) To choose which template to use in building your project view, click the '''Change…''' button in the top group of the '''OPC''' form.
 +
::ii) For now, just stick with the default template entitled '''Single Project Gantt View – Detailed''', but you can always use a different template to get a different type of project view.
  
:a) '''Starting Template:''' The current template determines which columns get imported from Microsoft Project and how the initial project view looksOnePager Pro ships with many sample templates, but you can also customize your own templates. To choose which template to use in building your project view, click the “Change…” button in the top group of the “OnePager choices” form. For now, just stick with the default template entitled “Single Project Gantt View – Detailed,” but you can always use a different template to get a different type of project view.
+
:b) '''Title of the New Project View''' This is the title of the graph and also the suggested file name in which it can be savedYou can change the file name when you actually save it. We recommend that you enter a title that helps you identify the view later on.
  
:b) '''Title of the New Project View:''' This is the title of the graph and also the suggested name of the file in which it will be saved, though you can change the file name when you actually save it.  We recommend that you enter a title that helps you identify the view later on.  For each project view that you create, OnePager remembers colors, titles, legends, font sizes, and all other graph properties so that your work is saved for future use. Later, you can update the project view with a snapshot of how the project looks on a different date. Then you can browse through the snapshots to see how the project is changing over time.  '''OnePager Pro Version 5.3 also saves the path name associated with the file (.TAM).  Path names are not available in .TAM files produced with previous version of OnePager Pro.'''
+
::i) For each project view that you create, OnePager remembers colors, titles, legends, font sizes, and all other graph properties so that your work is saved for future use.  
 +
::ii) Later, you can update the project view with a snapshot of how the project looks on a different date. Then you can browse through the snapshots to see how the project is changing over time.   
 +
::iii)  '''OPP''' version 5.3 also saves the path name associated with the file ('''.TAM''').  Path names are not available in '''.TAM''' files produced with previous version of '''OPP'''.
  
:c) '''Task Selection:''' This is how you tell OnePager Pro which tasks from your Microsoft Project plan to include. Either click the “Select all tasks” radio button to graph everything or choose a flag column. You can make several project views from a single Microsoft Project plan, each using a different flag or number column.  '''In OnePager Pro Version 5.3 if no flags are set to “Yes,” OnePager Pro will provide the user with a warning message.'''
+
:c) '''Task Selection''' This is how you tell '''OPP''' which tasks from your Microsoft Project plan to include. Either click the '''Select all tasks''' radio button to graph everything or choose a '''flag''' column. You can make several project views from a single Microsoft Project plan, each using a different '''flag''' or '''number''' column.  In '''OPP''' version 5.3 if no '''flags''' are set to '''Yes''', '''OPP''' will provide the user with a warning message.
  
:d) '''Snapshot Date:''' This is the date of the report and lets you keep track of how schedules change over time. Each project view can have several snapshots.  
+
:d) '''Snapshot Date''' This is the date of the report and lets you keep track of how schedules change over time. Each project view can have many snapshots.  
  
11) Since the “Show column mappings” button near the bottom of the screen is checked in the “OnePager choices” form above, you will now have a chance to review and change the Microsoft Project column mappings to OnePager Pro before you make your first project view.  To do this, click the “Next&gt;button.    You now see the following form:
+
11) Since the '''Show column mappings''' button near the bottom of the screen is checked in the '''OPC''' form above, you now have a chance to review and change the Microsoft Project column mappings to '''OPP''' before you make your first project view.  To do this, click the '''Next&gt;''' button.    You now see the following form:
  
 
<center></center>
 
<center></center>
Line 159: Line 122:
 
<center>[[File:P53-3_0_1-53-(16)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(16)-11062015.png]]</center>
  
<center></center>
+
12) Notice in the form above that '''OPP''' has relied on the current template to make some guesses on what Microsoft Project columns should be used in making the graph.    You can easily change any of these column mappings by making selections from the dropdown menus.  For example, we show below how to change the '''Finish Date''' :
 
+
<center>P53-3_0_1-53-(16)-11062015.png</center>
+
 
+
12) '''Notice in the form above that OnePager Pro has relied on the current template to make some guesses on what Microsoft Project plan columns should be used in making the graph.'''   You can easily change any of these column mappings by making selections from the drop-down lists.  For example, we show below how to change the “Finish Date” for tasks:
+
 
+
 
<center>[[File:P53-3_0_1-53-(17)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(17)-11062015.png]]</center>
  
Line 173: Line 131:
 
===Making the Graph===
 
===Making the Graph===
  
13) Once you are satisfied with the column mappings, click the “Create new project view” button to import your selected data into OnePager and create a project view from it.  After a second or two you will see a screen that looks like this:
+
13) Once you are satisfied with the column mappings, click the '''Create new project view''' button to import your selected data and create a project view.  After a second or two you will see a screen that looks like this:
  
 
<center>[[File:P53-3_0_1-53-(18)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(18)-11062015.png]]</center>
  
<center></center>
+
14) Note that each task or milestone was color coded based on the value in the '''Resource Names''' column. 
  
<center>P53-3_0_1-53-(18)-11062015.png</center>
+
:a) The legend contains an optional diagram near the bottom, explaining that the bars inside the Gantt bars represent percent complete extracted from Microsoft Project.
  
<center></center>
+
:b) '''Percent complete''' comes from a Microsoft Project column that you specified in the column mapping screen. 
  
14) '''Note that each task or milestone was color-coded based on the value in the “Resource Names” column, as is detailed in the legend.'''   The legend contains an optional diagram near the bottom, explaining that the bars inside the Gantt bars represent percent complete extracted from Microsoft Project.  Percent complete comes from a Microsoft Project plan column that you specified in the column mapping screen.  '''Also note that the template that is active when you press the “Create new project view” button is the template for how things look in the new project view.''' The template’s “Task Bars” tab showing where the color control is located is shown below:
+
:c) Note that the current template, when you press the '''Create new project view''' button, is the template for how things look in the new project view. The template’s '''Task Bars''' tab showing where the color control is located is shown below:
  
 
<center>[[File:P53-3_0_1-53-(19)-01122016.png]]</center>
 
<center>[[File:P53-3_0_1-53-(19)-01122016.png]]</center>
 
<center></center>
 
 
<center>P53-3_0_1-53-(19)-01122016.png</center>
 
  
 
===Opening a Project View===
 
===Opening a Project View===
  
15) The right-most button on the “OnePager choices” form is the “OPEN” button.  Clicking the “OPEN” button displays the same dropdown menu that you saw with the “NEW” and “UPDATE” buttons as shown below:
+
15) The right-most button on the '''OPC''' form is the '''OPEN''' button.  Clicking the '''OPEN''' button displays the same dropdown menu that you saw with the '''NEW''' and '''UPDATE''' buttons as shown below:
  
 
<center>[[File:P53-3_0_1-53-(19E)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(19E)-11062015.png]]</center>
  
<center></center>
+
:a) Clicking the '''BROWSE FILES''' option will bring up a Windows '''Open''' form from which you can select a '''.TAM''' file that you want to open.  Selecting the desired '''.TAM''' file will cause O'''OPP''' to display the selected project view.  From this position, you may edit the project view, save it, or share it with others.
 
+
<center>P53-3_0_1-53-(19E)-11062015.png</center>
+
 
+
:a) Clicking the BROWSE FILES option will bring up a Windows “Open” form from which you can select a .TAM file that you want to open.  Selecting the desired .TAM file will cause OnePager Pro to display the selected project view in the Project View Editor.  From this position, you may edit the project view, save it, or share it with others.
+
  
:b) Clicking any of the RECENT Project views in the dropdown menu above will cause OnePager Pro to load the associated .TAM file into the Project View Editor where you may also edit the project view, save it, or share it with others.
+
:b) Clicking any of the '''RECENT''' project views in the dropdown menu above will cause '''OPP''' to load the associated '''.TAM''' file into the '''PVE''' where you may also edit the project view, save it, or share it with others.
  
 
===Updating a Project View with Changes Made to the Microsoft Project Source File Data===
 
===Updating a Project View with Changes Made to the Microsoft Project Source File Data===
  
16) Suppose after examining the project view you created before you realize that it would be best to show more task bars.  This, you think, would greatly improve the schedule discussion you are about to have on the project.  Updating the project view at this point is a simple matter with OnePager Pro Version 5.3.  Recall that OnePager Pro is active and the Project View Editor is displaying the current project view you want to update with changed Microsoft Project source file data.  Additionally, the Microsoft Project source file and the application are active.  The original project view looked like this:
+
16) Suppose after examining the project view you created before you realize that it would be best to show more task bars.  This, you think, would greatly improve the schedule discussion you are about to have on the project.  Updating the project view at this point is a simple matter.  Recall that '''OPP''' is active and the '''PVE''' is displaying the current project view you want to update.  Additionally, the Microsoft Project source file and the application are active.  The original project view looked like this:
  
 
<center>[[File:P53-3_0_1-53-(18)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(18)-11062015.png]]</center>
  
<center></center>
+
:a) Since Microsoft Project is still an active program and the Microsoft Project source file you are using is still being displayed, go back to the Microsoft Project application and change the '''Flag20''' column setting for the rows you want to now display from '''No''' to '''Yes'''.  A section of the Microsoft Project source file where this is done is shown below:
 
+
<center>P53-3_0_1-53-(18)-11062015.png</center>
+
 
+
<center></center>
+
 
+
:a) Since Microsoft Project is still an active program in your computer and the Microsoft Project source file you are using is still being displayed, go back to the Microsoft Project application and change the “Flag20” column setting for the rows in the source file you want to now display from “No” to “Yes”.  A section of the Microsoft Project source file where this is done is shown below:
+
  
 
<center>[[File:P53-3_0_1-53-(19A)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(19A)-11062015.png]]</center>
  
<center></center>
+
:b) Once you’ve made the ''Flag20''' changes lines 7 through 15 in the Microsoft Project the source file will look like this:
 
+
<center>P53-3_0_1-53-(19A)-11062015.png</center>
+
 
+
<center></center>
+
 
+
:b) Once you’ve made the “Flag20” changes lines 7 through 15 in the Microsoft Project the source file will look like this:
+
  
 
<center>[[File:P53-3_0_1-53-(19B)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(19B)-11062015.png]]</center>
  
<center>P53-3_0_1-53-(19B)-11062015.png</center>
+
:c) With the Microsoft Project source file updated, go back to '''OPP''' and navigate to the '''Data''' tab on the ribbon where you’ll see several buttons.  To update your project view to now show the additional rows from your Microsoft Project source file click the '''Replace Snapshot''' button as shown below:
 
+
:c) With the Microsoft Project source file updated, go back to the OnePager Pro project view editor and navigate to the “Data” tab on the ribbon where you’ll see several buttons.  To update your project view to now show the additional rows from your Microsoft Project source file you will need to click the “Replace Snapshot” button as shown below:
+
  
 
<center>[[File:P53-3_0_1-53-(19C)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(19C)-11062015.png]]</center>
  
<center>P53-3_0_1-53-(19C)-11062015.png</center>
+
:d) When you click the '''Replace Snapshot''' button, '''OPP''' will go back to the associated Microsoft Project source file that you just changed, bring in all the rows that changed, and update your project view.
 
+
<center></center>
+
 
+
:d) When you click the “Replace Snapshot” button, OnePager Pro Version 5.3 will go back to the associated Microsoft Project source file that you just changed, bring in all the rows that changed, and update your project view visible in the OnePager Pro Project View Editor.
+
  
 
:e) At the conclusion of the operation, the updated project view will look like this:
 
:e) At the conclusion of the operation, the updated project view will look like this:
  
 
<center>[[File:P53-3_0_1-53-(19D)-11062015.png]]</center>
 
<center>[[File:P53-3_0_1-53-(19D)-11062015.png]]</center>
 
<center>P53-3_0_1-53-(19D)-11062015.png</center>
 
 
<center></center>
 
  
 
17) The example above is just one of many uses of the “Data” tab’s “Replace Snapshot” button when you need to update a project view with data that changed in your Microsoft Project source file.  And, you can do this as many times as necessary until the project view is the way you need it to be with respect to the information being brought in from the source file.  In addition to adding and removing rows by changing the “Flag20” field, you may need to change Start Dates, Finish Dates, or Percent Complete in the Microsoft Source Project source file and display these data changes in the project view.  Using the procedure above you can do this very efficiently.  
 
17) The example above is just one of many uses of the “Data” tab’s “Replace Snapshot” button when you need to update a project view with data that changed in your Microsoft Project source file.  And, you can do this as many times as necessary until the project view is the way you need it to be with respect to the information being brought in from the source file.  In addition to adding and removing rows by changing the “Flag20” field, you may need to change Start Dates, Finish Dates, or Percent Complete in the Microsoft Source Project source file and display these data changes in the project view.  Using the procedure above you can do this very efficiently.  

Revision as of 19:04, 23 February 2016

As mentioned in the article What's New with OnePager Release 5.3? version 5.3 of OPP can be launched from a desktop icon as well as from within Microsoft Project.

Please note that after selecting the Add-in launch option that you will not be able to launch the OnePager desktop application. Only one of these applications (Add-in or Desktop) may be active at a time. If you attempt to launch both, a warning message will appear as shown for OPP below.

P53-3 0 1-53-(01)-11062015.png

This article covers the Getting Started process when you launch OPP from Microsoft Project.

The article which provides Getting Started guidance when using the desktop icon to launch OPP is at Getting Started with OnePager Pro Version 5.3 Desktop.

Launching OnePager Pro for the First Time

1) The OPP Add-in automatically displays the OnePager icon on the Microsoft Project ribbon once OnePager is installed. That tool bar looks like this:

P53-3 0 1-53-(1)-11062015.png

2) Clicking the OnePager Pro button will take you to the Project View Editor (PVE). Clicking the Templates… button will let you edit the templates for your graphs. For now, it is simplest to use the default template. You can learn how templates let you customize and standardize graph features later in this document.

3) Before you launch OPP, it is a good idea to unhide the flag column you intend to use. (Note that when you unhide a column in Microsoft Project, that column may now appear in some of Microsoft Project’s standard reports. Do not forget to hide the column again before generating such reports if you do not want the column to appear in those reports.) The selected flag column allows you to control which tasks get graphed and to store those choices in Microsoft Project for future use. For example, the flag field (e.g., Flag20) is shown below:

P53-3 0 1-53-(2)-11162015.png

4) To control which tasks get graphed, specify the flag column (e.g. Flag1, Flag2 … Flag20) that you wish to use. Number fields may also be used the same as the flag fields where a “1” in a Number field indicates Yesand a 0 in a Number field indicates No. Unhide that column in Microsoft Project by right-clicking in the column header area and selecting Insert Column:

P53-3 0 1-53-(3)-11062015.png

5) Now put a Yes in this flag column for any task that you want to graph:

P53-3 0 1-53-(4)-11062015.png
a) When making your first project view, we strongly recommend that you mark 50 or fewer tasks with Yes.
b) Please note that OPP is shipped with a number of fully populated templates that are based on the Microsoft Project file used in the tutorial also shipped with the product – BlueGrass Project 2J-303.
c) Starting in Microsoft Project 2010, there is a Manual Scheduling mode that allows you to leave dates blank in your schedule. However, behind the scenes, these dates are still being automatically assigned to the project Start Date, or to Today's Date if the project Start Date is not defined. Even though the dates appear to be undefined, they are defined behind the scenes, and are being passed to OPP. Because Today's Date often equals your Snapshot date, it is not surprising to see all of these dateless tasks appearing near the time cursor.
d) There are two solutions to this issue: (1) Define the dates for your tasks and milestones in Microsoft Project. This will overwrite any default dates that Microsoft Project is assigning, and will make your project schedule more consistent with your OPP timeline. (2) Remove the dateless tasks from your OPP graph. You can leave them in project, but by removing them from the OPP graph, you won't have to explain why certain tasks/milestones are appearing in weird places when they really should not. As a rule of thumb, we recommend defining dates for all tasks and milestones, especially when it comes to graph generation.

6) To launch OPP and make a project view, click the OnePager Pro button on the Microsoft Project tool bar’s Add-ins tab, which brings up the OnePager Pro Start form:

P53-3 0 1-53-(5)-11062015.png

7) The OnePager Pro Start form provides you with three options:

a) NEW Clicking the NEW button will bring up the OnePager choices (OPC) form.
b) UPDATE Clicking the UPDATE button will allow you to BROWSE FILES for an existing project view file or select a recently-opened project view file.
c) OPEN Clicking the OPEN button will allow you to BROWSE FILES for an existing project view file or select a recently-opened project view file. Once selected and opened, the project view is available for editing.

Creating a New Project View

8) Clicking the NEW button brings up the OPC form as shown below:

P53-3 0 1-53-(6)-11062015.png

Options on the New OnePager Choices form

9) We’ve enhanced the OPC form to give you more options for selecting source files. The illustration above shows that OPP was initiated from Microsoft Project with the source file shown in the Selected File(s) group shown above. The Add/Remove button gives you the capability to add more files to the source packet or, for multiple file packets to remove files.

a) Clicking the Add/Remove button brings up the Data source selection form as shown below:
P53-3 0 1-53-(7)-02122016.png
b) The Data source selection form displays the current source file that was loaded with Microsoft Project when you clicked the OnePager Pro. This form lets you Add more source Microsoft Project source files to create a multi-project project view or Remove a file from a multi-file source packet. These options are detailed below.

Adding a New Source File

c) Add a new source file to the source packet. When you click the Add button, OPP will give you the option to bring up a Windows Open form when you select the BROWSE FILES… option as shown here:
P53-3 0 1-53-(8)-02122016.png
i) Clicking the BROWSE FILES… option will display a Window’s Open form from which you may select a Microsoft Project file to add to the source packet. A sample Open form is shown below:
P53-3 0 1-53-(9)-11062015.png
P53-3_0_1-53-(9)-11062015.png
ii) When you select a desired Microsoft Project source file and click the Open button as shown above, OPP will add the file to the source packet and display it in the Data source selection window as shown below:
P53-3 0 1-53-(10)-02122016.png
iii) The selected file is added to the source packet as shown above. OPP shows the path name of the files in the window if you hover the mouse over the file name.
iv) If you select a recently used file from the dropdown menu displayed with the Add button is clicked in the Data source selection form, OPP will add that file to the source packet.

Removing a Source File

d) Remove source from source packet. The Remove button allows you to remove a source file from a source packet if that file is not needed to create the new project view. To remove a file, first select the file in the Data source selection form’s window so that it is highlighted in blue then click the Remove button as shown in the sequence below:
P53-3 0 1-53-(11)-02122016.png
P53-3 0 1-53-(12)-02122016.png

Other Choices to Make

10) Moving on to the other sections of the OPC form, you are asked to confirm a few things before you build the project view. OPP will make good guesses for each of these choices, but you can change any of them:

P53-3 0 1-53-(15)-11062015.png
a) Starting Template The current template determines which columns get imported from Microsoft Project and how the initial project view looks. OPP ships with many sample templates, but you can also customize your own templates.
i) To choose which template to use in building your project view, click the Change… button in the top group of the OPC form.
ii) For now, just stick with the default template entitled Single Project Gantt View – Detailed, but you can always use a different template to get a different type of project view.
b) Title of the New Project View This is the title of the graph and also the suggested file name in which it can be saved. You can change the file name when you actually save it. We recommend that you enter a title that helps you identify the view later on.
i) For each project view that you create, OnePager remembers colors, titles, legends, font sizes, and all other graph properties so that your work is saved for future use.
ii) Later, you can update the project view with a snapshot of how the project looks on a different date. Then you can browse through the snapshots to see how the project is changing over time.
iii) OPP version 5.3 also saves the path name associated with the file (.TAM). Path names are not available in .TAM files produced with previous version of OPP.
c) Task Selection This is how you tell OPP which tasks from your Microsoft Project plan to include. Either click the Select all tasks radio button to graph everything or choose a flag column. You can make several project views from a single Microsoft Project plan, each using a different flag or number column. In OPP version 5.3 if no flags are set to Yes, OPP will provide the user with a warning message.
d) Snapshot Date This is the date of the report and lets you keep track of how schedules change over time. Each project view can have many snapshots.

11) Since the Show column mappings button near the bottom of the screen is checked in the OPC form above, you now have a chance to review and change the Microsoft Project column mappings to OPP before you make your first project view. To do this, click the Next> button. You now see the following form:

P53-3 0 1-53-(16)-11062015.png

12) Notice in the form above that OPP has relied on the current template to make some guesses on what Microsoft Project columns should be used in making the graph. You can easily change any of these column mappings by making selections from the dropdown menus. For example, we show below how to change the Finish Date :

P53-3 0 1-53-(17)-11062015.png
P53-3_0_1-53-(17)-11062015.png

Making the Graph

13) Once you are satisfied with the column mappings, click the Create new project view button to import your selected data and create a project view. After a second or two you will see a screen that looks like this:

P53-3 0 1-53-(18)-11062015.png

14) Note that each task or milestone was color coded based on the value in the Resource Names column.

a) The legend contains an optional diagram near the bottom, explaining that the bars inside the Gantt bars represent percent complete extracted from Microsoft Project.
b) Percent complete comes from a Microsoft Project column that you specified in the column mapping screen.
c) Note that the current template, when you press the Create new project view button, is the template for how things look in the new project view. The template’s Task Bars tab showing where the color control is located is shown below:
P53-3 0 1-53-(19)-01122016.png

Opening a Project View

15) The right-most button on the OPC form is the OPEN button. Clicking the OPEN button displays the same dropdown menu that you saw with the NEW and UPDATE buttons as shown below:

P53-3 0 1-53-(19E)-11062015.png
a) Clicking the BROWSE FILES option will bring up a Windows Open form from which you can select a .TAM file that you want to open. Selecting the desired .TAM file will cause OOPP to display the selected project view. From this position, you may edit the project view, save it, or share it with others.
b) Clicking any of the RECENT project views in the dropdown menu above will cause OPP to load the associated .TAM file into the PVE where you may also edit the project view, save it, or share it with others.

Updating a Project View with Changes Made to the Microsoft Project Source File Data

16) Suppose after examining the project view you created before you realize that it would be best to show more task bars. This, you think, would greatly improve the schedule discussion you are about to have on the project. Updating the project view at this point is a simple matter. Recall that OPP is active and the PVE is displaying the current project view you want to update. Additionally, the Microsoft Project source file and the application are active. The original project view looked like this:

P53-3 0 1-53-(18)-11062015.png
a) Since Microsoft Project is still an active program and the Microsoft Project source file you are using is still being displayed, go back to the Microsoft Project application and change the Flag20 column setting for the rows you want to now display from No to Yes. A section of the Microsoft Project source file where this is done is shown below:
P53-3 0 1-53-(19A)-11062015.png
b) Once you’ve made the Flag20' changes lines 7 through 15 in the Microsoft Project the source file will look like this:
P53-3 0 1-53-(19B)-11062015.png
c) With the Microsoft Project source file updated, go back to OPP and navigate to the Data tab on the ribbon where you’ll see several buttons. To update your project view to now show the additional rows from your Microsoft Project source file click the Replace Snapshot button as shown below:
P53-3 0 1-53-(19C)-11062015.png
d) When you click the Replace Snapshot button, OPP will go back to the associated Microsoft Project source file that you just changed, bring in all the rows that changed, and update your project view.
e) At the conclusion of the operation, the updated project view will look like this:
P53-3 0 1-53-(19D)-11062015.png

17) The example above is just one of many uses of the “Data” tab’s “Replace Snapshot” button when you need to update a project view with data that changed in your Microsoft Project source file. And, you can do this as many times as necessary until the project view is the way you need it to be with respect to the information being brought in from the source file. In addition to adding and removing rows by changing the “Flag20” field, you may need to change Start Dates, Finish Dates, or Percent Complete in the Microsoft Source Project source file and display these data changes in the project view. Using the procedure above you can do this very efficiently.


18) At this point you may save the project view by giving it a file name. When you save the project view in OnePager Pro Version 5.3, OnePager will save the .TAM file (the data representation of the project view) and within will save the Microsoft Project file name and path information. This is useful when you want to further update the project view or when you want to add a snapshot later on as your project proceeds. In the examples below we will assume that the project view was saved as “BlueGrass Project 2J-303-Revised”.

Adding a Snapshot to a Project View

19) The power of OnePager Pro is illustrated when, after a period of progress on the project, it is time to produce another project view, with the same look and feel, for a new status date. Assuming that the Microsoft Project plan was updated with actual start and finish, percent complete, and other relevant data during the reporting interval, OnePager Pro can easily generate a new snapshot. Launch OnePager Pro either from Microsoft Project or from the desktop icon and click the “UPDATE” button on the “OnePager Start” form that appears. Doing so will bring up the following “OnePager choices” form:

P53-3 0 1-53-(24)-11062015.png
P53-3_0_1-53-(24)-11062015.png
a) In the “OnePager choices” form select the “NEW snapshot at date:” as shown above. You will want to select a current date for the snapshot so that this snapshot will represent the project at the status date point in time. To see which snapshot dates already exist, just position your mouse over the “NEW snapshot-date:” box to see a list of the existing dates. Use the built in calendar drop down button or type in the new snapshot’s month, day, and year in the window provided as shown below:
P53-3 0 1-53-(25)-11062015.png
P53-3_0_1-53-(25)-11062015.png
b) Uncheck the “Show column mappings” box if you want to use the same mappings as you used before. The bottom of the screen now looks like this:
P53-3 0 1-53-(26)-11062015.png
P53-3_0_1-53-(26)-11062015.png
c) Pressing the large “New” button creates a new snapshot for the project view, showing how the project changed from the previous snapshot date to the date entered for the current snapshot. The project view opens at the new snapshot. The color, fonts, title, and swimlane assignments are consistent between the two snapshots:
P53-3 0 1-53-(27)-11062015.png
P53-3_0_1-53-(27)-11062015.png
d) You can go back and forth between the two snapshots by using the snapshot forward/backward buttons on the “View” tab as shown above:
P53-3 0 1-53-(28)-11062015.png
P53-3_0_1-53-(28)-11062015.png

Editing the Project View

20) Sooner or later, most of you will edit the font sizes and text position to optimize readability. To do this, hold down the left mouse button and “drag” a selection box that encloses many tasks/milestones at once:

P53-3 0 1-53-(29)-11062015.png
P53-3_0_1-53-(29)-11062015.png
a) When you release the mouse, the enclosed tasks/milestones will all be selected:
P53-3 0 1-53-(30)-11062015.png
P53-3_0_1-53-(30)-11062015.png
b) Click the “Increase Font Size” button on the tool bar shown below:
P53-3 0 1-53-(31)-11062015.png
P53-3_0_1-53-(31)-11062015.png
c) The project view will now look something like this:
P53-3 0 1-53-(32)-11062015.png
P53-3_0_1-53-(32)-11062015.png
d) Repeating this operation for the remaining tasks/milestones (we could have done “Select All” and done it all at once!), we obtain a project view with larger fonts on all the tasks/milestones:
P53-3 0 1-53-(33)-11062015.png
P53-3_0_1-53-(33)-11062015.png

21) Another common editing task is to move the task names from their current position, centered on the task, to a position left or right of the task. To do this, select a set of tasks/milestones as before, but this time click one of the text-positioning buttons on the tool bar:

P53-3 0 1-53-(34)-11062015.png
P53-3_0_1-53-(34)-11062015.png
a) Doing this on several batches of tasks/milestones results in the following edited project view. (We have also dragged the legend to a new position and have adjusted some of its font sizes):
P53-3 0 1-53-(35)-11062015.png
P53-3_0_1-53-(35)-11062015.png
b) In case you change your mind about the last editing action you took, you can UNDO the last editing action by clicking the UNDO button above the OnePager tool bar. Successive clicking the UNDO button will undo editing actions in the reverse order that they were applied.
P53-3 0 1-53-(36)-11062015.png
P53-3_0_1-53-(36)-11062015.png

22) Save the edited project view by pressing the save button above the tool bar next to the UNDO button. All of the font-size changes, text-position edits, and the new legend position are now saved in the file structure in case you need to update this project view with new data at a later time.

Copying the Project View to PowerPoint

23) Finally, copy the current snapshot of the project view to the clipboard by pressing the “Copy” button on the tool bar. Then paste the graph into a PowerPoint slide, as shown below:

P53-3 0 1-53-(37)-11062015.png
P53-3_0_1-53-(37)-11062015.png

24) That’s it! You’ve now created a professional 1-page schedule summary from a complex Microsoft Project plan schedule and have copied it into a Microsoft PowerPoint presentation. You can also print the graph by selecting File…Print. OnePager has other features that let you move tasks vertically to different “rows and swimlanes,” change the number of swimlanes, add swimlane titles, show dependencies among tasks, change task colors, hide tasks, add floating comment boxes, and standardize on graph styles across organizations. To learn more about these features, read about the specific workflows in this Wiki.

(3.0.1-53)