Difference between revisions of "Template Only Features for Version 6.0 (OnePager Express)"

From OnePager Documentation
Jump to: navigation, search
(Basic and Data Field Mappings)
(Task/Milestone Identity Mapping)
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
==About Template Only Features==
 
==About Template Only Features==
  
1) Because the '''Template Properties''' and Project-View Properties ('''PVP''') forms are similar, this section only covers the areas of the former that are different from the later.  
+
1) Because the '''Template Properties''' and Project-View Properties ('''PVP''') forms are similar, this section only covers the areas of the former that are different from the latter.  
  
 
2) If you are unclear on the differences between a '''Template''' and a '''PVP''', please review the explanation in the [[Core Concepts for OnePager 6.0 (Portal) | Core Concepts (Portal)]] <!--4.0-60--> and [[Templates versus Project Views for Version 6.0 | Templates versus Project Views]] <!--4.3-60--> articles.
 
2) If you are unclear on the differences between a '''Template''' and a '''PVP''', please review the explanation in the [[Core Concepts for OnePager 6.0 (Portal) | Core Concepts (Portal)]] <!--4.0-60--> and [[Templates versus Project Views for Version 6.0 | Templates versus Project Views]] <!--4.3-60--> articles.
Line 33: Line 33:
 
==Main Template Tab==
 
==Main Template Tab==
  
1) The '''Main''' tab of the '''Template Properties''' form differs slightly from the '''PVP''' form.  
+
1) The '''Main''' tab of the '''Template Properties''' form differs slightly from the '''PVP''' form.   The '''Template''' does not have entry controls for the '''Start date''', '''End date''', '''Title''', because '''dates''' are systematically produced by OnePager based on the earliest '''start date''' and '''latest finish dates''' in your '''source plan''' data.  The '''Title''' is something you designate as you create the new project view with the OnePager choices ('''OPC''') form.
 
+
:a) The '''Template''' does not have entry positions for the '''Start date''', and '''End date''', or project view '''title''', because'''dates''' are systematically produced by OnePager based on the earliest '''start date''' and '''latest finish dates''' in your data.   
+
 
+
:b) The '''Title''' is something you designate as you create the new project view with the OnePager choices ('''OPC''') form.
+
  
 
<center>[[File:X60-24_2_1-60-(1)-02222017.png]]</center>
 
<center>[[File:X60-24_2_1-60-(1)-02222017.png]]</center>
Line 84: Line 80:
 
==Field Mappings Template Tab==
 
==Field Mappings Template Tab==
  
1) The new '''Field Mappings '''tab in the '''Template''' form for OnePager Express looks like this:
+
The new '''Field Mappings '''tab in the '''Template''' form for OnePager Express looks like this:
  
<center>[[File:X60-24_2_1-60-(3BB)-03032017.png]]</center>
+
<center>[[File:X60-24_2_1-60-(3CC)-06052017.png]]</center>
<!--<center>X60-24_2_1-60-(3BB)-03032017.png</center>-->
+
<!--<center>X60-24_2_1-60-(3CC)-06052017.png</center>-->
  
===Basic and Data Field Mappings===
+
===Basic and Date Mappings===
  
:a) The eight dropdown lists shown in the form above are the most common fields that our customers tell us they use.   
+
1) OnePager uses '''source fields''' for many purposes : displaying task names, displaying start dates, assigning colors to tasks, and grouping rows into swimlanes.  We call the use of a '''source field''' for a purpose a '''field mapping'''. The eight dropdown lists above are a set of important '''field mappings''' that are collected in one form tab page.  The other '''field mappings''' are on the Rows/Swimlanes, Task Bars, and Milestones form tab pagesSome '''field mappings''' (e.g. percent-complete) appear both here and on other form tab pages.
  
:b) The new '''Field Mappings''' tab in the '''Template''', which is also available in the OnePager Express '''PVP''' form, provides a convenient and shortcut way to change the meaning of the source plan fields as they will appear in the project view.
+
2) This new '''Field Mappings''' tab in the '''Template''' is also available in the '''PVP''' form.
  
:c) Each dropdown list contains the source file fields '''by data type''' available for OnePager Pro and Express.  
+
3) Each dropdown list contains the '''source fields''' that have the correct data type(s) for the  purpose.  For example, in the '''Basic Mappings''' group, the '''Task label''' field dropdown contains only text fields from Microsoft Project.  And the dropdown lists in the '''Date Mappings''' group contain only Microsoft Exce; date fields.
  
::i) For example, in the '''Basic Fields''' group, the '''Critical-path field''' dropdown contains '''Boolean''' and '''Numeric''' fields from Microsoft Project. 
+
4) These mappings are useful if your standard field usage differs and you want to avoid having to constantly make the changes on the second page of '''OPC''' form shown below:
::ii) For the dropdown lists in the '''Date Fields''' group, the lists are composed of '''date''' type fields used by Microsoft Excel.
+
  
:d)  For more detailed information on the use of this feature please go to article with starting section link:  [[Field Mappings Tab for OnePager Express for Version 6.0#Basic Fields | Field Mappings Tab for OnePager Express - Basic Fields]] <!--21.16.1-60-->
+
<center>[[File:X60-3_0_3-60-(15AA)-03072017.png]]</center>
 +
<!--<center>X60-3_0_3-60-(15AA)-03072017.png</center>-->
  
===Task/Milestone Identity Feature===
+
5)  For more detailed information on the use of this feature please go to article with starting section link:  [[Field Mappings Tab for OnePager Express for Version 6.0#Basic Mappings | Field Mappings Tab for OnePager Express - Basic Mappings]] <!--21.16.1-60-->
  
2) The '''Task/Milestone Identity''' group in the '''Field Mappings''' tab of the OnePager Express '''Template''' form provides the means for you to select a Microsoft Excel field that can be used to uniquely identify tasks. 
+
===Task/Milestone Identity Mapping===
  
:a) This is especially useful when you are creating a Microsoft Excel '''source plan''' by combining task/milestones from different Microsoft Excel '''source plan''' files.   
+
The '''Task/Milestone Identity Mapping''' group lets you select a Microsoft Excel field that can be used to uniquely identifies each task.   
  
::i) OnePager Express uses the '''Unique Id''' field you specified to properly manage the updates of project views built from these combined Microsoft Excel '''source plan''' files. 
+
1) Uniquely identifying each task or milestone is always important when you plan to update your project view later on, but you normally do not need to change this '''field mapping''' because the default mapping works just fine.
::ii) You are responsible for populating the field's contents with unique numbers prior to creating the first project view.  This is an advanced function of OnePager Express.
+
  
:b) To select a different '''Unique Id''', use the dropdown menu shown in the illustration below to select the desired Microsoft Excel filed you wish to use:
+
:a) OnePager uses the '''Unique Id''' field to identify each task in the '''source plan''', enabling preservation of each task’s color, labeling, and vertical location as you import new or modified data in later updates of the project view.
  
<center>[[File:X60-24_2_1-60-(8)-03162017.png]]</center>
+
:b) For '''source plans''' that are Microsoft Excel files, the default mapping is to the Microsoft Excel '''Task ID''' field.  
<!--<center>X60-24_2_1-60-(8)-03162017.png</center>-->
+
  
===Field Splitting Feature===
+
:c) If you opt to change the '''Task ID''' mapping away from these reliable defaults, make sure that the new '''source''' field has a unique value for each task or milestone.  Bear in mind that once you create a project view with a '''Task ID''' mapping, it is nearly impossible to change your mind about how tasks are to be identified.  Change this mapping away from the default only if you have a good reason to do so and are sure that the field contains no duplicate values.
  
3) The '''Field Splitting''' group in the '''Field Mappings '''tab of the OnePager Express '''Template''' form works in the same way as it did in the '''Other Columns''' tab of previous versions. 
+
2) To map an alternate '''Task ID''' field, use the dropdown menu shown in the illustration below:
  
4) See the article at: [[Splitting and Parsing Columns for OnePager Express for Version 6.0 | Splitting and Parsing Columns-OnePager Express]] <!--24.5.1-60--> for more information.
+
<center>[[File:X60-24_2_1-60-(8AA)-06052017.png]]</center>
 +
<!--<center>X60-24_2_1-60-(8AA)-06052017.png</center>-->
  
5) Additionally, you may change the '''standard''' Microsoft Excel '''source plan''' usage for any of the fields mentioned in the '''Date Fields''' group shown on the right side of the '''Field Mappings''' tab. This is useful if your '''standard''' field usage differs and you want to avoid having to constantly make the changes on the second page of '''OPC''' form shown below:
+
3) When changing to an alternate '''Unique Id''' field, OnePager will display a warning message as follows:
  
<center>[[File:X60-3_0_3-60-(15AA)-03072017.png]]</center>
+
<center>[[File:X60-24_2_1-60-(9AA)-06052017.png]]</center>
<!--<center>X60-3_0_3-60-(15AA)-03072017.png</center>-->
+
<!--<center>X60-24_2_1-60-(9AA)-06052017.png</center>-->
 +
 
 +
4) For more information on this feature, please go to this link: [[Field Mappings Tab for OnePager Express for Version 6.0#Task/Milestone Identity Mapping | Field Mappings Tab for OnePager Express - Task/Milestone Identity Mapping]] <!--21.16.1-60-->
 +
 
 +
===Field Splitting Feature===
 +
 
 +
4) The '''Field Splitting''' group lets you split each task into a set of nearly-duplicate tasks based upon a comma-separated list of values in some '''source''' field.  For example, you could split a task that had three '''Resources''' assigned to it into three almost-identical tasks that differ only in their value of '''Resource'''. Once you create a project view with '''field splitting''' turned on, it is impossible to change your mind and go back to '''unsplit''' tasks for that project view or change to a different field for the splitting.
  
6) Please note that the implementation of the '''Retroactive Column Mapping''' feature necessitated that the '''Field Mappings''' tab be implemented on the '''Project-View Properties''' form as well as the '''Template''' form for version 6.0. Nevertheless, we are documenting the '''Field Mappings''' tab for the '''Template''' form here although the tab is not truly at '''Template''' only tab.
+
5) See the article at:  [[Splitting and Parsing Columns for OnePager Express for Version 6.0 | Splitting and Parsing Columns-OnePager Express]] <!--24.5.1-60--> for more information.
  
7) For more detailed usage information on the '''Field Mappings''' Tab see the article at this link:   [[Field Mappings Tab for OnePager Express for Version 6.0 | Field Mappings Tab for OnePager Express]] <!--21.16.1-60-->
+
6) For more information on the '''Field Mappings''' Tab, see the article at this link: [[Field Mappings Tab for OnePager Express for Version 6.0 | Field Mappings Tab for OnePager Express]] <!--21.16.1-60-->
  
 
(24.2.1-60)
 
(24.2.1-60)

Latest revision as of 17:00, 5 June 2017

About Template Only Features

1) Because the Template Properties and Project-View Properties (PVP) forms are similar, this section only covers the areas of the former that are different from the latter.

2) If you are unclear on the differences between a Template and a PVP, please review the explanation in the Core Concepts (Portal) and Templates versus Project Views articles.

3) You should familiarize yourself with PVP form before reading this section.

4) Please see the article at this link: Editing with the Project-View Properties form (Portal) for more information and access to more detailed articles.

A Few Words On Templates

1) Permanent Template. Chronicle Graphics, Inc. ships OPX with one pre-defined permanent template that you cannot accidentally delete.

a) The permanent template has the word Permanent in its name.
b) The permanent template cannot be modified hence all the control features on each tab are disabled (ghosted).

2) Metric versus Non-Metric. Within a Template there are settings which are measures that must be considered when building the project view graph.

a) These include the height of individual rows, the height of the percent-complete bar within a task bar, and the like.
b) OnePager supports two measurement conventions: (1) English (inches) and (2) Metric (centimeters). For convenience you can identify a Metric based Template because the word (metric) is included in the title. And these two sets of Templates are separated by default into English and a Metric subfolder of the default templates folder.

3) In addition to the English and Metric folders in the Template folder there is a Legacy folder containing Templates from versions of OPP prior to version 5.3.

4) Ideally, you will use one of the Templates provided one time and then from there you will customize your project using your own customer Template.

a) Once a project view is customized it may be transformed into a Template using the Copy to Template button on the ribbon's Home tab.
b) Our Templates will give you a starting point, but to maximize your efficiency, we recommend you learn how to create and update your own Templates.

Main Template Tab

1) The Main tab of the Template Properties form differs slightly from the PVP form. The Template does not have entry controls for the Start date, End date, Title, because dates are systematically produced by OnePager based on the earliest start date and latest finish dates in your source plan data. The Title is something you designate as you create the new project view with the OnePager choices (OPC) form.

X60-24 2 1-60-(1)-02222017.png

Advanced Template Tab

2) The Advanced tab is shown below. Most of these parameters in the Template are identical to those appearing in the PVP form.

X60-24 2 1-60-(2A)-02222017.png
a) In the Template’s Advanced tab there is no Lock background checkbox in the Display options group. This is an option available after the project view is created.
b) One key difference between the Template Properties form and PVP form is the ability to use the Template to configure a multi-project import The next sub-section explains this further.
c) For more information on creating multi-project project views please visit these two articles:
Basic Workflows (Portal)
Creating Various Multi-Project Views with OnePager Pro and Express (Portal)

Merge Tasks On Snapshot Replacement (see screenshot above)

3) Checking this checkbox puts any project views created with this Template into the multi-file multi-project mode.

4) This mode is specifically designed to support users who want to create multi-project project views from several independent Microsoft Excel source plans. It allows OnePager to recognize data as coming from more than one unique file and combine that into your OnePager project view, hence the merge reference.

5) This is an advanced feature and when used, OnePager needs you to create a Task ID column with uniquely numbered tasks and milestones that can be imported from the various Microsoft Excel source plans.

6) This is necessary so that OnePager uniquely recognize each row in each separate file.

a) A simple example shows how this checkbox works.
i) Suppose that the first Microsoft Excel source plan contains tasks A, B, and C and that the second source plan contains tasks D, E, and F.
ii) After making a new project view from the first source plan, you open the second Microsoft Excel source plan and update the project view in Replace Snapshot mode.
iii) If the checkbox is checked, the project view will now contain tasks A, B, C, D, E, and F.
iv) If the checkbox is not checked, the project view will now contain only tasks D, E, and F.
b) Once you adopted this scheme for the project view being created, it is not possible to update the project view in the future in the default single-file single-project mode.

Field Mappings Template Tab

The new Field Mappings tab in the Template form for OnePager Express looks like this:

X60-24 2 1-60-(3CC)-06052017.png

Basic and Date Mappings

1) OnePager uses source fields for many purposes : displaying task names, displaying start dates, assigning colors to tasks, and grouping rows into swimlanes. We call the use of a source field for a purpose a field mapping. The eight dropdown lists above are a set of important field mappings that are collected in one form tab page. The other field mappings are on the Rows/Swimlanes, Task Bars, and Milestones form tab pages. Some field mappings (e.g. percent-complete) appear both here and on other form tab pages.

2) This new Field Mappings tab in the Template is also available in the PVP form.

3) Each dropdown list contains the source fields that have the correct data type(s) for the purpose. For example, in the Basic Mappings group, the Task label field dropdown contains only text fields from Microsoft Project. And the dropdown lists in the Date Mappings group contain only Microsoft Exce; date fields.

4) These mappings are useful if your standard field usage differs and you want to avoid having to constantly make the changes on the second page of OPC form shown below:

X60-3 0 3-60-(15AA)-03072017.png

5) For more detailed information on the use of this feature please go to article with starting section link: Field Mappings Tab for OnePager Express - Basic Mappings

Task/Milestone Identity Mapping

The Task/Milestone Identity Mapping group lets you select a Microsoft Excel field that can be used to uniquely identifies each task.

1) Uniquely identifying each task or milestone is always important when you plan to update your project view later on, but you normally do not need to change this field mapping because the default mapping works just fine.

a) OnePager uses the Unique Id field to identify each task in the source plan, enabling preservation of each task’s color, labeling, and vertical location as you import new or modified data in later updates of the project view.
b) For source plans that are Microsoft Excel files, the default mapping is to the Microsoft Excel Task ID field.
c) If you opt to change the Task ID mapping away from these reliable defaults, make sure that the new source field has a unique value for each task or milestone. Bear in mind that once you create a project view with a Task ID mapping, it is nearly impossible to change your mind about how tasks are to be identified. Change this mapping away from the default only if you have a good reason to do so and are sure that the field contains no duplicate values.

2) To map an alternate Task ID field, use the dropdown menu shown in the illustration below:

X60-24 2 1-60-(8AA)-06052017.png

3) When changing to an alternate Unique Id field, OnePager will display a warning message as follows:

X60-24 2 1-60-(9AA)-06052017.png

4) For more information on this feature, please go to this link: Field Mappings Tab for OnePager Express - Task/Milestone Identity Mapping

Field Splitting Feature

4) The Field Splitting group lets you split each task into a set of nearly-duplicate tasks based upon a comma-separated list of values in some source field. For example, you could split a task that had three Resources assigned to it into three almost-identical tasks that differ only in their value of Resource. Once you create a project view with field splitting turned on, it is impossible to change your mind and go back to unsplit tasks for that project view or change to a different field for the splitting.

5) See the article at: Splitting and Parsing Columns-OnePager Express for more information.

6) For more information on the Field Mappings Tab, see the article at this link: Field Mappings Tab for OnePager Express

(24.2.1-60)