Difference between revisions of "Testing Article1"

From OnePager Documentation
Jump to: navigation, search
Line 1: Line 1:
==About Using Enterprise Custom Fields==
+
==About Splitting and Parsing Fields==
  
OnePager Pro ('''OPP''') offers access to Microsoft Project Server’s Enterprise Custom Fields ('''ECF''').  You can use these fields to determine '''swimlanes, colors, flagging of tasks, and other properties'''.
+
The OnePager '''field splitting''' feature allows you to '''duplicate task bars''' when a task in your Microsoft Project '''source plan''' is assigned to '''multiple resources''' (or anything else).  Because assignments from Microsoft Project often are '''comma-delimited''', this feature enables OnePager to '''parse the comma-delimited list''' and '''create a unique task bar''' for each instance in the '''comma-separated''' list.
  
For some basic information on Microsoft Project Server's Enterprise Custom Fields, please see the website article at:  [https://www.onepager.com/tips/project-online/create-enterprise-custom-field-pwa.html Create a new enterprise custom field in Project Server or Project Online]
+
===Split Resource Names Example===
  
This article covers how to log-in to your Microsoft Project Server accounts and how to access your '''ECF''' data through '''OPP's Template Properties''' form.
+
Say you want to use '''color-codes''' on task bars/milestone symbols based upon your Microsoft Project '''source plan’s Resource Names''' field as shown below:
  
==Logging-in to Your Microsoft Project Server Account from Microsoft Project Professional==
+
<center>[[File:P70-24_4_1-70-(1-1)-12012020.png]]</center>
 +
<!--<center>P70-24_4_1-70-(1-1)-12012020.png</center>-->
  
You can '''always''' log-in to your Microsoft Project Server account from Microsoft ProjectOnce you are logged-in, you can follow the steps below from that point, where OnePager Pro ('''OPP''') is launched, and access the  '''Template Properties''' form to access your '''ECF''' data.
+
Some of the entries in the '''Resource Names''' field consist of multiple, '''comma-separated''' items and some of these are followed by percentages in square bracketsWithout the '''field splitting''' feature, a chart '''created''' from these data and assigned task bar/milestone symbol '''colors''' based upon the '''Resource Name''' field looks like this:
  
===Logging-in to Your Microsoft Project Server Account through the OnePager Pro Add-in===
+
<center>[[File:P70-24_4_1-70-(2)-12012020.png]]</center>
 +
<!--<center>P70-24_4_1-70-(2)-12012020.png</center>-->
  
Logging-in to your Microsoft Project Server Account can also be done directly from the '''OPP Add-in''' application.
+
OnePager, in this case, treats the '''entire string''' as an individual '''Resource Name''' value.  To provide more flexibility in displaying task bars that have '''multiple resources''' assigned, OnePager supports the concept of a '''field splitting'''.  This feature recognizes '''comma-separated''' values in a '''designated field''' and '''creates a separate task bar''' for each of the '''comma-separated''' values.
  
Launch Microsoft Project Professional and load the Microsoft Project '''source plan''' desired from its storage location.
+
===Enabling Splitting===
  
Click the '''Template Properties''' button on the Microsoft Project '''Add-in''' tab which accesses the '''OPP Template Properties''' form shown below:
+
To use this feature, click the '''Templates…''' button on the Microsoft Project tool bar and navigate to the '''Field Mappings''' tab page on the '''Template Properties''' form as shown below:
  
<center>[[File:P70-24_3_1-70-(1)-12022020.png]]</center>
+
<center>[[File:P70-24_4_1-70-(3)-12012020.png]]</center>
<!--<center>P70-24_3_1-70-(1)-12022020.png</center>-->
+
<!--<center>P70-24_4_1-70-(3)-12012020.png</center>-->
  
The bottom of the form above contains the '''Get Enterprise Custom Fields''' checkbox and the window used in conjunction with the '''Change''' button that helps you to access and manage your Microsoft Project Server Accounts. This method does not apply when using the OnePager Pro '''Desktop''' application.
+
In the '''Template Properties''' form above, the '''Enable splitting on''' checkbox is checked '''ON''' and the '''Resource Names''' field is identified to participate in the '''field splitting''' process.  After making the above change and while still within the '''Template Properties''' form, navigate to the '''Task Bar''' or '''Milestone''' tab and go to the '''Gantt Bar/Milestone Fill Color''' group of this tab.
  
===Accessing Your Microsoft Project Server’s Enterprise Custom Fields - OnePager Pro Add-in===
+
Note that the '''Color-code based on''' checkbox is checked '''ON''' and the dropdown window shows that '''Resource Names (Split)''' is set as shown below:
  
When you check the '''Get Enterprise Custom Fields''' checkbox to '''ON''', OnePager checks to see if it is already logged-in to your Microsoft Project Server account. If so, the '''ECF''' data are loaded into the '''Template Properties''' form’s dropdown list of fields as shown below:
+
<center>[[File:P70-24_4_1-70-(4-1)-12012020.png]]</center>
 +
<!--<center>P70-24_4_1-70-(4-1)-12012020.png</center>-->
  
<center>[[File:P70-24_3_1-70-(7)-12022020.png]]</center>
+
Next, '''save''' the modified '''Template Properties''' form.
<!--<center>P70-24_3_1-70-(7)-12022020.png</center>-->
+
  
If OnePager is not already logged-in, '''OPP Add-in''' attempts to log-in using the '''URL''' for whatever Microsoft Project Server account Microsoft Project is connected to.  If OnePager finds that Microsoft Windows has stored '''default credentials''' for Microsoft Project to log-in to Microsoft Project Server, OnePager attempts to use these '''credentials''' without prompting you and without ever actually knowing the username and password. If successful, OnePager '''creates''' a OnePager log-in account with just the '''URL''' but with no username and password.
+
===Split Resources in the Chart===
  
<center>[[File:P70-24_3_1-70-(3)-12022020.png]]</center>
+
Now make a '''NEW''' chart using the modified '''Template''' (and '''splitting''' of the '''Resource Names''' field).
<!--<center>P70-24_3_1-70-(3)-12022020.png</center>-->
+
  
Once OnePager connects to your Microsoft Project Server server account, it retrieves the '''ECF''' data and displays a success message, '''Added Enterprise Custom Fields''', as shown here:
+
The chart with '''splitting''' looks like this:
  
<center>[[File:P70-24_3_1-70-(4)-12022020.png]]</center>
+
<center>[[File:P70-24_4_1-70-(5)-12012020.png]]</center>
<!--<center>P70-24_3_1-70-(4)-12022020.png</center>-->
+
<!--<center>P70-24_4_1-70-(5)-12012020.png</center>-->
  
The '''ECF''' data are now loaded into the dropdown lists as shown above.
+
In the chart with '''splitting''' shown above, there are now several more task bars in the '''Chart Editor''' than there were before.  The task bar '''Centrifugal Barrier''' is now '''split into three separate task bars''', one for each of the '''three resources''' that were assigned to this task in the Microsoft Project '''source plan'''.  Each of the '''resources''' has a unique '''color''' assigned.  Each of the '''resources''' appears by itself in the '''Legend'''.  The '''square brackets''' enclosing the percentage figures (%) are '''removed''' from the '''Legend''' entries.
  
You can now select the '''ECF''' for various purposes such as for controlling '''(1) rows/swimlane organization, (2) selection of task bar/milestone symbol colors, or (3) Field Mappings selections''' on the '''Template Properties''' form's '''Advanced''' tab.  When you click the '''Save and use''' button, the action makes the '''Template Properties''' form with the '''ECF''' data the '''current Template Properties''' form.  It now can be used to create a '''NEW''' chart or '''UPDATE/OPEN''' an existing one.  
+
With this feature, you can use '''split fields''' just like any other field by using the dropdowns in the '''Template Properties''' form or '''Chart Properties''' form to assign '''colors, label task shapes and milestone shapes, to define/label rows and swimlanes'''.
  
When a new chart is '''created''' using the desired '''ECF''' information, you can '''open''' the chart, access the '''Chart Properties''' form, and make '''edits''' to the row/swimlane organization as described above by selecting the desired '''ECF''' now available.  As a '''note''', other '''ECF’s''' are not available to you unless you already included them in some mapping in the original '''Template Properties''' form. 
+
==Splitting Resources and Task Links==
  
For more information on the '''Field Mappings Tab'''. please see the article at:  [[Template Only Features for Version 7.0 (OnePager Pro) | Template Only Features for OnePager Pro]] <!--24.1.1-70-->
+
When task bars with '''Data-Driven''' or manual '''Task Links''' are '''split''', the '''Task Links''' ('''Data-Driven''' and manual) are '''not shown'''.  Further, the '''Task Links''' that are now '''hidden''' and '''do not''' have entries in the '''Where are My Links?''' form.
 
+
A similar approach using the '''OPP Add-in''' application can be used to '''UPDATE''' a chart build with '''ECF’s'''.  The '''note''' in the previous paragraph also applies.
+
 
+
===Suspending the Use of Enterprise Custom Fields===
+
 
+
To '''suspend''' the use of '''Enterprise Custom Fields''', uncheck the '''Get Enterprise Custom Fields''' checkbox to '''OFF''' and click '''Save and use''' on the '''Template Properties''' form.  This action '''removes''' the '''ECF’s''' from the '''Template Properties''' form's dropdown lists so that '''creating and updating''' charts can take place with these '''Template Properties''' forms without the '''ECF’s'''.
+
 
+
==Logging-in to Your Microsoft Project Server Account through the OnePager Pro Desktop==
+
 
+
Logging-in to your Microsoft Project Server Account can also be done from the OnePager Pro '''Desktop''' application as well as the '''Add-in''' application.
+
 
+
To do this, launch '''OPP''' from the '''Desktop icon'''.  The log-in is performed in the '''Template Properties''' form.  You can access the '''Template Properties''' form for the '''OPP Desktop''' application by clicking the '''File''' tab on the ribbon and then clicking the '''Options''' tab.  This accesses the '''OnePager Options''' page where you’ll find the '''Template''' button in the lower right of the page.  Clicking the '''Template''' button which accesses the '''Template Properties''' form shown below:
+
 
+
<center>[[File:P70-24_3_1-70-(1)-12022020.png]]</center>
+
<!--<center>P70-24_3_1-70-(1)-12022020.png</center>-->
+
 
+
===Accessing Your Microsoft Project Server’s Enterprise Custom Fields - OnePager Desktop===
+
 
+
Now, check the '''Get Enterprise Custom Fields''' checkbox to '''ON''' and the  '''OPP Desktop''' application accesses the log-in form shown below:
+
 
+
<center>[[File:P70-24_3_1-70-(3)-12022020.png]]</center>
+
<!--<center>P70-24_3_1-70-(3)-12022020.png</center>-->
+
 
+
Once you enter your '''credentials''', click the '''OK''' button to attempt the '''connection'''.  The '''OPP Desktop''' application logs into your account and download your '''ECF''' information into the '''Template Properties''' form’s dropdown lists as shown below:
+
 
+
<center>[[File:P70-24_3_1-70-(7)-12022020.png]]</center>
+
<!--<center>P70-24_3_1-70-(7)-12022020.png</center>-->
+
 
+
When the '''OPP Desktop''' application is launched and running, Microsoft Project is '''not running''' so it is not possible to connect to your Microsoft Project Server account through Microsoft Project.  If the '''OPP Desktop''' application is '''not able to connect''' to the Microsoft Project Server you’ve requested, a message appears at the bottom of the '''Template Properties''' form as shown below:
+
 
+
<center>[[File:P70-24_3_1-70-(8)-12022020.png]]</center>
+
<!--<center>P70-24_3_1-70-(8)-12022020.png</center>-->
+
 
+
Once you are logged-in to your Microsoft Project Server account through the '''OPP Desktop''' application, all features and functions with respect to '''ECF''' are available as if you were using the '''OPP Add-in''' application.
+
  
 
==Related Links==
 
==Related Links==
  
 
[[Templates versus Charts for Version 7.0 | Templates versus Charts]] <!--4.0.1.3-70-->
 
[[Templates versus Charts for Version 7.0 | Templates versus Charts]] <!--4.0.1.3-70-->
 +
 +
[[Linking Task and Milestones Using Manual and Data-Driven Task Links for Version 7.0 | Linking Task and Milestone Using Manual and Data-Driven Task Links (Portal)]] <!--19.0.1-70-->
  
 
[[Editing with the Chart Properties form for Version 7.0 (Portal) | Editing with the Chart Properties form (Portal)]] <!--21.0.1-70-->
 
[[Editing with the Chart Properties form for Version 7.0 (Portal) | Editing with the Chart Properties form (Portal)]] <!--21.0.1-70-->
  
[[Template Only Features for Version 7.0 (OnePager Pro) | Template Only Features for OnePager Pro]]. 24.1.1-70
+
[[Template Only Features for Version 7.0 (OnePager Pro) | Template Only Features-OnePager Pro]] <!--24.1.1-70-->
  
(24.3.1-70)
+
(24.4.1-70)
  
 
[[Category:Version 7.0]]
 
[[Category:Version 7.0]]
 
[[Category:Editing the Chart]]
 
[[Category:Editing the Chart]]
 
[[Category:Task/Milestone Editing]]
 
[[Category:Task/Milestone Editing]]
 +
[[Category:Column Splitting]]
 
[[Category:Charts]]
 
[[Category:Charts]]
[[Category:Enterprise Integration]]
+
[[Category:Task Links]]
[[Category:Enterprise Custom Fields]]
+
 
[[Category:Ribbon]]
 
[[Category:Ribbon]]
 
[[Category:Snapshots]]
 
[[Category:Snapshots]]

Revision as of 15:48, 15 January 2021

About Splitting and Parsing Fields

The OnePager field splitting feature allows you to duplicate task bars when a task in your Microsoft Project source plan is assigned to multiple resources (or anything else). Because assignments from Microsoft Project often are comma-delimited, this feature enables OnePager to parse the comma-delimited list and create a unique task bar for each instance in the comma-separated list.

Split Resource Names Example

Say you want to use color-codes on task bars/milestone symbols based upon your Microsoft Project source plan’s Resource Names field as shown below:

P70-24 4 1-70-(1-1)-12012020.png

Some of the entries in the Resource Names field consist of multiple, comma-separated items and some of these are followed by percentages in square brackets. Without the field splitting feature, a chart created from these data and assigned task bar/milestone symbol colors based upon the Resource Name field looks like this:

P70-24 4 1-70-(2)-12012020.png

OnePager, in this case, treats the entire string as an individual Resource Name value. To provide more flexibility in displaying task bars that have multiple resources assigned, OnePager supports the concept of a field splitting. This feature recognizes comma-separated values in a designated field and creates a separate task bar for each of the comma-separated values.

Enabling Splitting

To use this feature, click the Templates… button on the Microsoft Project tool bar and navigate to the Field Mappings tab page on the Template Properties form as shown below:

P70-24 4 1-70-(3)-12012020.png

In the Template Properties form above, the Enable splitting on checkbox is checked ON and the Resource Names field is identified to participate in the field splitting process. After making the above change and while still within the Template Properties form, navigate to the Task Bar or Milestone tab and go to the Gantt Bar/Milestone Fill Color group of this tab.

Note that the Color-code based on checkbox is checked ON and the dropdown window shows that Resource Names (Split) is set as shown below:

P70-24 4 1-70-(4-1)-12012020.png

Next, save the modified Template Properties form.

Split Resources in the Chart

Now make a NEW chart using the modified Template (and splitting of the Resource Names field).

The chart with splitting looks like this:

P70-24 4 1-70-(5)-12012020.png

In the chart with splitting shown above, there are now several more task bars in the Chart Editor than there were before. The task bar Centrifugal Barrier is now split into three separate task bars, one for each of the three resources that were assigned to this task in the Microsoft Project source plan. Each of the resources has a unique color assigned. Each of the resources appears by itself in the Legend. The square brackets enclosing the percentage figures (%) are removed from the Legend entries.

With this feature, you can use split fields just like any other field by using the dropdowns in the Template Properties form or Chart Properties form to assign colors, label task shapes and milestone shapes, to define/label rows and swimlanes.

Splitting Resources and Task Links

When task bars with Data-Driven or manual Task Links are split, the Task Links (Data-Driven and manual) are not shown. Further, the Task Links that are now hidden and do not have entries in the Where are My Links? form.

Related Links

Templates versus Charts

Linking Task and Milestone Using Manual and Data-Driven Task Links (Portal)

Editing with the Chart Properties form (Portal)

Template Only Features-OnePager Pro

(24.4.1-70)