Difference between revisions of "Adding Conditional Formatting Rules for OnePager Express for Version 7.0"

From OnePager Documentation
Jump to: navigation, search
Line 1: Line 1:
 
==About Adding Conditional Formatting Rules==
 
==About Adding Conditional Formatting Rules==
  
1) '''Conditional Formatting''' is a capability in OnePager Express that you can use to '''tailor''' various '''attributes''' of task/milestones in the chart depending on the data '''imported''' from your Microsoft Excel '''source plan'''.
+
1) '''Conditional Formatting''' is a capability in OnePager Express that you can use to '''tailor''' various '''attributes''' of task/milestone shapes in the chart depending on the data '''imported''' from your Microsoft Excel '''source plan'''.
  
:a) You can define one or more '''conditional formatting rules''' that will apply your specified '''actions''' to appropriate task/milestones when the specified '''conditions''' in your defined '''rules''' are true.
+
2) You can define one or more '''conditional formatting rules''' that apply your specified '''actions''' to appropriate task/milestone shapes when the specified '''conditions''' in your defined '''rules''' are '''true'''.
  
:b) For example, you can define a '''rule''' that changes the '''color''' of a task shape depending on the value contained the '''Category''' field (used to report risk in the example below) '''imported''' from your Microsoft Excel '''source plan'''.
+
3) For example, you can define a '''rule''' that changes the '''color''' of a task shape depending on the value contained the '''Category''' field (used to report risk in the example below) '''imported''' from your Microsoft Excel '''source plan'''.
  
:c)  In this example, suppose the '''Category''' field is used to '''import Risk information''' in the form of '''High''', '''Medium''', and '''Low'''.
+
4)  In this example, suppose the '''Category''' field is used to '''import Risk information''' in the form of '''High''', '''Medium''', and '''Low'''.
  
:d) You can '''add rules''' that tell OnePager Express, for instance, to set the '''color''' Red for task shapes associated with a '''Category''' value of '''High''', set the '''color''' yellow for task shapes associated with a '''Category''' value of '''Medium''', and set the '''color''' green''' for task shapes associated with a '''Category''' value of '''Low'''.
+
5) You can '''add rules''' that tell OnePager Express, for instance, to set the '''color''' Red for task shapes associated with a '''Category''' value of '''High''', set the '''color''' yellow for task shapes associated with a '''Category''' value of '''Medium''', and set the '''color''' green''' for task shapes associated with a '''Category''' value of '''Low'''.
  
:e) A video illustrating this example is available at: [https://www.onepager.com/support/video_tutorials/conditional_formatting.html Conditional Formatting Tutorial Video].
+
6) A video illustrating this example is available at: [https://www.onepager.com/support/video_tutorials/conditional_formatting.html Conditional Formatting Tutorial Video].
  
2) There are nine (9) set of task/milestone '''attributes''' that can be altered to respond to '''condition statement''' established in your '''conditional formatting rule''' sets.   
+
7) There are nine (9) sets of task/milestone shape '''attributes''' that can be altered to respond to '''condition statement''' established in your '''conditional formatting rule''' sets.   
  
3) This article provides the basic instructions to for '''adding conditional formatting rules''' to OnePager which can be done at the '''Template''' or '''Chart Properties''' forms level.
+
8) This article provides the basic instructions to for '''adding conditional formatting rules''' to OnePager which can be done at the '''Template''' or '''Chart Properties''' forms level.
  
4) These '''conditional formatting rules''' can be '''edited''' at any time in terms of the contents of '''condition columns''' and '''action columns''' found in the '''Conditional Formatting Rules''' form discussed below.
+
9) These '''conditional formatting rules''' can be '''edited''' at any time in terms of the contents of '''condition columns''' and '''action columns''' found in the '''Conditional Formatting Rules''' form discussed below.
  
5) Use the following steps to '''add''' a '''conditional formatting rule''' or rules to the '''Conditional Formatting Rules''' form's grid:
+
10) Use the following steps to '''add''' a '''conditional formatting rule''' or rules to the '''Conditional Formatting Rules''' form's '''grid''':
  
6) From either the '''Task Bars''' or '''Milestones''' tab of the '''Chart Properties''' or '''Template Properties''' forms, click the '''Manage Rules...''' button:  
+
11) From either the '''Task Bars''' or '''Milestones''' tab of the '''Chart Properties''' or '''Template Properties''' forms, click the '''Manage Rules...''' button:  
  
 
<center>[[File:X70-11_4_1-70-(1)-09272019.png]]</center>
 
<center>[[File:X70-11_4_1-70-(1)-09272019.png]]</center>
 
<center>X70-11_4_1-70-(1)-09272019.png</center>
 
<center>X70-11_4_1-70-(1)-09272019.png</center>
  
7) You are now ready to '''add''' rules.  
+
12) You are now ready to '''add''' rules.  
  
8) Click the '''Add Rule''' button and OnePager then creates a blank line in the window shown above so you can enter the first rule.  
+
13) Click the '''Add Rule''' button and OnePager then creates a blank line in the window shown above so you can enter the first rule.  
  
9) The line consists of three major components:  
+
14) The line consists of three (3) major components:  
  
:a) the rule '''select'''  and '''enable/disable''' checkboxes,
+
:a) The rule '''select'''  and '''enable/disable''' checkboxes.
  
:b) the rule '''condition''' columns, and
+
:b) The rule '''condition''' columns.
  
:c) the rule '''action''' columns.  
+
:c) The rule '''action''' columns.
  
10) '''Adding''', '''editing''', '''copying''', and '''deleting''' '''conditional formatting rules''' is very similar to the process for doing the same with respect to '''Conditional Import Filter Rules''' which are described at this link:  [[Conditional Import for Version 7.0 (Portal) | Conditional Import Filters (Portal)]] 7.18.1-70.
+
15) '''Adding''', '''editing''', '''copying''', and '''deleting''' '''conditional formatting rules''' is very similar to the process for doing the same with respect to '''Conditional Import Filter Rules''' which are described in the article at:  [[Conditional Import for Version 7.0 (Portal) | Conditional Import Filters (Portal)]] 7.18.1-70.
  
11) The sections that follow cover each of the major components of a '''conditional formatting rule'''.
+
16) The sections that follow cover each of the major components of a '''conditional formatting rule'''.
  
 
==Rule Selection and Enable/Disable Checkboxes==
 
==Rule Selection and Enable/Disable Checkboxes==
Line 46: Line 46:
 
===Rule Selection Columns===
 
===Rule Selection Columns===
  
1) The left most column in the grid, shown below, has the following function:
+
1) The left most column in the '''grid''', shown below, has the following function:
  
 
<center>[[File:X70-11_4_1-70-(2A)-09272019.png]]</center>
 
<center>[[File:X70-11_4_1-70-(2A)-09272019.png]]</center>
Line 79: Line 79:
 
===Operator Column===
 
===Operator Column===
  
4)The '''Operator''' column shown below is a dropdown that allows you to pick from a list of operators depending on the '''data type''' of the '''Field''' selected as discussed above:
+
4) The '''Operator''' column shown below is a dropdown that allows you to pick from a list of operators depending on the '''data type''' of the '''Field''' selected as discussed above:
  
 
<center>[[File:X70-11_4_1-70-(4)-09272019.png]]</center>
 
<center>[[File:X70-11_4_1-70-(4)-09272019.png]]</center>
Line 90: Line 90:
 
6) For '''Text String''' field '''types''' there are four operators:  
 
6) For '''Text String''' field '''types''' there are four operators:  
  
:a) '''equal''',
+
:a) '''equal'''
  
:b) '''not equal''',
+
:b) '''not equal'''
  
:c) '''Contains''', and
+
:c) '''Contains'''  
  
:d) '''Does not contain'''.
+
:d) '''Does not contain'''
  
 
====Numeric and Data Field Types====
 
====Numeric and Data Field Types====
Line 107: Line 107:
 
8) For '''Numeric and Date''' field '''types''' there are six operators:  
 
8) For '''Numeric and Date''' field '''types''' there are six operators:  
  
:a) '''equal''',
+
:a) '''equal'''
  
:b) '''not equal''',
+
:b) '''not equal'''
  
 
:c) '''less than'''
 
:c) '''less than'''
Line 126: Line 126:
 
<center>X70-11_4_1-70-(6)-09272019.png</center>
 
<center>X70-11_4_1-70-(6)-09272019.png</center>
  
10) For '''Boolean''' field '''types''' there are two operators that can be expressed in two different ways as shown below:
+
10) For '''Boolean''' field '''types''' there are two operators that can be expressed in two (2) different ways as shown below:
  
 
:a) '''Yes''' or '''1'''
 
:a) '''Yes''' or '''1'''
Line 136: Line 136:
 
===Value Column===
 
===Value Column===
  
12) The '''Value''' column is the grid cell that you fill in that is the '''match''' desired against the '''Field Column''' given the contents of the '''Operator Column'''.
+
12) The '''Value''' column is the '''grid cell''' that you fill in that is the '''match''' desired against the '''Field Column''' given the contents of the '''Operator Column'''.
  
 
====Boolean Field Types====
 
====Boolean Field Types====
Line 144: Line 144:
 
====Text String Field Types====
 
====Text String Field Types====
  
15)  For '''Text String type''' fields, any text that might appear in a Microsoft Excel '''text string field''' can be typed in to the '''Value''' column's grid cell for a rule.
+
15)  For '''Text String type''' fields, any text that might appear in a Microsoft Excel '''text string field''' can be typed in to the '''Value''' column's '''grid cell''' for a rule.
  
:a) '''Note''' that for string '''matches''', it is permissible to have the '''Value''' column be a set of strings separated by commas.   
+
16) '''Note''' that for string '''matches''', it is permissible to have the '''Value''' column be a set of strings separated by commas.   
  
:b) In this situation, the rule is '''matched''' when the column '''value is equal''' to '''any''' of the comma separated values.
+
17) In this situation, the rule is '''matched''' when the column '''value is equal''' to '''any''' of the comma separated values.
  
:c) To make the comparison between '''text''' data specified in the '''Field''' column of the '''Conditional Formatting Rules''' form, OnePager trims leading and trailing '''white''' space such as blanks or control characters.   
+
18) To make the comparison between '''text''' data specified in the '''Field''' column of the '''Conditional Formatting Rules''' form, OnePager trims leading and trailing '''white''' space such as blanks or control characters.   
  
:d) However, OnePager does not trim '''excess white space''' within a valid character string.
+
19) However, OnePager does not trim '''excess white space''' within a valid character string.
  
 
====Numeric Field Types====
 
====Numeric Field Types====
  
16) For '''Numeric type''' '''matches''' any integer or integer with a decimal fraction is permissible.
+
20) For '''Numeric type''' '''matches''' any integer or integer with a decimal fraction is permissible.
  
 
====Date Field Types====
 
====Date Field Types====
  
17) For '''Date type matches''' the '''Value Column''' provides the standard OnePager '''calendar''' when you click in the '''Value Column''' and the '''Field Column''' is a '''date type field''' as shown below:
+
21) For '''Date type matches''' the '''Value Column''' provides the standard OnePager '''calendar''' when you click in the '''Value Column''' and the '''Field Column''' is a '''date type field''' as shown below:
  
 
<center>[[File:X70-11_4_1-70-(6B)-09272019.png]]</center>
 
<center>[[File:X70-11_4_1-70-(6B)-09272019.png]]</center>
 
<center>X70-11_4_1-70-(6B)-09272019.png</center>
 
<center>X70-11_4_1-70-(6B)-09272019.png</center>
  
18) The '''Value''' column can be used to compare against '''today’s date''' by clicking the '''Today: ...''' checkbox in the '''Pick a date Calendar''' form shown above.   
+
22) The '''Value''' column can be used to compare against '''today’s date''' by clicking the '''Today: ...''' checkbox in the '''Pick a date Calendar''' form shown above.   
  
19) This is useful for establishing a rule where it is important to '''color''' or otherwise highlight a task whose '''Finish date''' is less than or equal to '''today’s date''', for example.
+
23) This is useful for establishing a rule where it is important to '''color''' or otherwise highlight a task whose '''Finish date''' is less than or equal to '''today’s date''', for example.
  
 
===Applies to Column===
 
===Applies to Column===
  
20) OnePager Express performs the evaluation and then '''applies''' the formats specified in the rule to the tasks or milestones or both as determined by the '''Applies to''' column as shown here:   
+
24) OnePager Express performs the evaluation and then '''applies''' the formats specified in the rule to the task shapes, milestone shapes, or both as determined by the '''Applies to''' column as shown here:   
  
 
<center>[[File:X70-11_4_1-70-(6A)-09272019.png]]</center>
 
<center>[[File:X70-11_4_1-70-(6A)-09272019.png]]</center>
 
<center>X70-11_4_1-70-(6A)-09272019.png</center>
 
<center>X70-11_4_1-70-(6A)-09272019.png</center>
  
21) To tell OnePager whether to apply a rule to tasks, to milestones, or to both, there are three options for the '''Applies to''' column as shown below:
+
25) To tell OnePager whether to apply a rule to task shapes, to milestone shapes, or to both, there are three options for the '''Applies to''' column as shown below:
  
:a) Both
+
:a) '''Both'''
  
:b) Tasks
+
:b) '''Tasks'''
  
:c) Milestones
+
:c) '''Milestones'''
  
 
==Rule Action Columns==
 
==Rule Action Columns==
  
1) To the right of the columns in the '''Conditional Formatting Rules''' form's grid '''Condition''' columns are nine (9) '''Action''' columns.
+
1) To the right of the columns in the '''Conditional Formatting Rules''' form's '''grid''' '''Condition''' columns are nine (9) '''Action''' columns.
  
2) When a '''condition''' in the rule '''matches or is true''' all valid '''actions''' specified in the '''Action''' columns are applied to the task/milestones in the chart.
+
2) When a '''condition''' in the rule '''matches or is true''' all valid '''actions''' specified in the '''Action''' columns are applied to the task/milestone shapes in the chart.
  
3) If the rule's '''condition''' does '''not match or is false''', none of the '''actions''' specified in the '''Action''' columns are taken or applied to the task/milestones in the chart.
+
3) If the rule's '''condition''' does '''not match or is false''', none of the '''actions''' specified in the '''Action''' columns are taken or applied to the task/milestone shapes in the chart.
  
4)  The '''Conditional Formatting Rules''' form's grid has a '''horizontal scroll bar''' allowing you to scroll to the left or right to being all of the nine '''Action''' columns into view within the grid as shown in the illustrations below:
+
4)  The '''Conditional Formatting Rules''' form's '''grid''' has a '''horizontal scroll bar''' allowing you to scroll to the left or right to being all of the nine '''Action''' columns into view within the '''grid''' as shown in the illustrations below:
  
 
<center>'''Horizontal Scroll Bar to the Far Left'''</center>
 
<center>'''Horizontal Scroll Bar to the Far Left'''</center>
Line 206: Line 206:
 
<center>X70-11_4_1-70-(9)-09272019.png</center>
 
<center>X70-11_4_1-70-(9)-09272019.png</center>
  
5) In the three illustrations above the thee '''Conditions''' columns of '''Field, Operator, and Value''' remain fixed in the grid and do not scroll left or right.
+
5) In the three illustrations above the thee '''Conditions''' columns of '''Field, Operator, and Value''' remain fixed in the '''grid''' and do not scroll left or right.
  
6) It is important to note that whenever a rule's '''conditions''' result in a '''match or true''' result, '''all''' of the '''Action''' columns that are not blank are applied to the appropriate tasks/milestones in the chart.
+
6) It is important to note that whenever a rule's '''conditions''' result in a '''match or true''' result, '''all''' of the '''Action''' columns that are not blank are applied to the appropriate tasks/milestone shapes in the chart.
  
 
7) Accordingly, while you may have more than one '''Action''' column associated with a specific '''condition''', we recommend that minimizing the number of '''Action''' columns you intend to apply in one rule.
 
7) Accordingly, while you may have more than one '''Action''' column associated with a specific '''condition''', we recommend that minimizing the number of '''Action''' columns you intend to apply in one rule.
  
8) As you have have capability to turn rules '''On''' and '''Off''', you can define many rules in the grid and turn the desired rules '''On''' when they meet your schedule conversation needs with the chart.
+
8) As you have have capability to turn rules '''On''' and '''Off''', you can define many rules in the '''grid''' and turn the desired rules '''On''' when they meet your schedule conversation needs with the chart.
  
 
9) In the following sub-sections are discussions of the attributes of each of the nine '''Action''' columns available.
 
9) In the following sub-sections are discussions of the attributes of each of the nine '''Action''' columns available.
Line 223: Line 223:
 
<center>X70-11_4_1-70-(10)-09272019.png</center>
 
<center>X70-11_4_1-70-(10)-09272019.png</center>
  
11) For more information on using the standard '''Color Chooser''' form, please see the articles at:  [[Changing Individual Task/Milestone Properties (Color, Shape, Labels, etc.) for Version 7.0#Changing Individual Task/Milestone Shape Colors | Changing Individual Task/Milestone Shape Colors]] 9.2.1-70
+
11) For more information on using the standard '''Color Chooser''' form, please see the section in the articles at:  [[Changing Individual Task/Milestone Properties (Color, Shape, Labels, etc.) for Version 7.0#Changing Individual Task/Milestone Shape Colors | Changing Individual Task/Milestone Shape Colors]] 9.2.1-70
  
 
===Taskbar and Milestone Shape Action Columns===
 
===Taskbar and Milestone Shape Action Columns===
  
11) Clicking the '''Taskbar Shape Action''' column cell accesses the standard '''Task Shape''' dropdown list as shown below:
+
12) Clicking the '''Taskbar Shape Action''' column cell accesses the standard '''Task Shape''' dropdown list as shown below:
  
 
<center>[[File:X70-11_4_1-70-(11)-09272019.png]]</center>
 
<center>[[File:X70-11_4_1-70-(11)-09272019.png]]</center>
 
<center>X70-11_4_1-70-(11)-09272019.png</center>
 
<center>X70-11_4_1-70-(11)-09272019.png</center>
  
12) In a similar way, clicking the '''Milestone Shape Action''' column cell accesses the standard '''Milestone Shape''' dropdown list as shown here:
+
13) In a similar way, clicking the '''Milestone Shape Action''' column cell accesses the standard '''Milestone Shape''' dropdown list as shown here:
  
 
<center>[[File:X70-11_4_1-70-(12)-09272019.png]]</center>
 
<center>[[File:X70-11_4_1-70-(12)-09272019.png]]</center>
Line 239: Line 239:
 
===Height % Action Column===
 
===Height % Action Column===
  
13) You can manage the '''height''' of a task or milestone shape as a percentage of the '''height of the row''' occupied by the task/milestone shape.
+
14) You can manage the '''height''' of a task or milestone shape as a percentage of the '''height of the row''' occupied by the task/milestone shape.
  
14) The default '''Height %''' for task/milestone shapes is 91% of the '''height of the row'''.
+
15) The default '''Height %''' for task/milestone shapes is 91% of the '''height of the row'''.
  
15)  As shown below, the '''Height %''' for the rule shown is set to 50% by typing in the number 50 as the value:
+
16)  As shown below, the '''Height %''' for the rule shown is set to 50% by typing in the number 50 as the value:
  
 
<center>[[File:X70-11_4_1-70-(13)-09272019.png]]</center>
 
<center>[[File:X70-11_4_1-70-(13)-09272019.png]]</center>
Line 250: Line 250:
 
===Border Action Column===
 
===Border Action Column===
  
16) Using the '''Border Action''' column, you can automatically change the look of the task or milestone's '''border''' if the rule results in a '''match or true''' result.
+
17) Using the '''Border Action''' column, you can automatically change the look of the task or milestone shape's '''border''' if the rule results in a '''match or true'''.
  
17) To do this, clicking on the '''Border Action''' column's cell accesses the '''Border Style Rules''' form where the '''Use default''' checkbox is checked '''On''' as shown below:
+
18) To do this, clicking on the '''Border Action''' column's '''grid cell''' accesses the '''Border Style Rules''' form where the '''Use default''' checkbox is checked '''On''' as shown below:
  
 
<center>[[File:X70-11_4_1-70-(14)-09272019.png]]</center>
 
<center>[[File:X70-11_4_1-70-(14)-09272019.png]]</center>
 
<center>X70-11_4_1-70-(14)-09272019.png</center>
 
<center>X70-11_4_1-70-(14)-09272019.png</center>
  
18) To '''edit''' any of the parameters of the task/milestone's '''border''' uncheck the '''Use default''' checkbox and use the '''Border Color''', '''Border Width''', and '''Border Style''' controls as appropriate.
+
19) To '''edit''' any of the parameters of the task/milestone shape's '''border''' uncheck the '''Use default''' checkbox and use the '''Border Color''', '''Border Width''', and '''Border Style''' controls as appropriate.
  
19) For more information on task/milestone '''border management''', please see the articles at:  [[Changing Individual Task/Milestone Properties (Color, Shape, Labels, etc.) for Version 7.0#Changing Task/milestone Shape Borders | Changing Task/milestone Shape Borders]] 9.2.1-70
+
20) For more information on task/milestone '''border management''', please see the section in the articles at:  [[Changing Individual Task/Milestone Properties (Color, Shape, Labels, etc.) for Version 7.0#Changing Task/milestone Shape Borders | Changing Task/milestone Shape Borders]] 9.2.1-70
  
 
===Label Font Action Column===
 
===Label Font Action Column===
  
20) Using the '''Label Font Action''' column, you can change the look of the task/milestone '''label text''' if the rue results in a '''match or true''' result.
+
21) Using the '''Label Font Action''' column, you can change the look of the task/milestone shape's '''label text''' if the rue results in a '''match or true''' result.
  
21) Clicking the '''Label font Action''' column's cell accesses the standard '''Font properties''' form as shown here:
+
22) Clicking the '''Label font Action''' column's '''grid cell''' accesses the standard '''Font properties''' form as shown here:
  
 
<center>[[File:X70-11_4_1-70-(15)-09272019.png]]</center>
 
<center>[[File:X70-11_4_1-70-(15)-09272019.png]]</center>
 
<center>X70-11_4_1-70-(15)-09272019.png</center>
 
<center>X70-11_4_1-70-(15)-09272019.png</center>
  
22) Using the standard '''Font properties''' form has the controls for '''editing''' the important characteristics of the '''label text'''.
+
23) Using the standard '''Font properties''' form has the controls for '''editing''' the important characteristics of the '''label text'''.
  
23) For more information on task/milestone '''label text management''', please see the articles at:  [[Changing Individual Task/Milestone Properties (Color, Shape, Labels, etc.) for Version 7.0#Use the Context Menus | Use the Context Menus]] 9.2.1-70
+
24) For more information on task/milestone shape '''label text management''', please see the section in the articles at:  [[Changing Individual Task/Milestone Properties (Color, Shape, Labels, etc.) for Version 7.0#Use the Context Menus | Use the Context Menus]] 9.2.1-70
  
 
===Priority Action Column===
 
===Priority Action Column===
  
24) The '''Priority Action''' column is set and mostly managed by OnePager Express.   
+
25) The '''Priority Action''' column is set and mostly managed by OnePager Express.   
  
25) That is, each time you '''add''' a new rule to the grid, OnePager increments the value in the '''Priority Action''' column's cell by one starting at zero (0) for the first rule in the grid.
+
26) That is, each time you '''add''' a new rule to the '''grid''', OnePager increments the value in the '''Priority Action''' column's '''grid cell''' by one starting at zero (0) for the first rule in the '''grid'''.
  
26) If several rules are in competition to set a particular '''formatting property''' (i.e., '''color''', '''border''', etc.) , the rule with the lowest '''Priority number''' has '''priority''' over all the others.   
+
27) If several rules are in competition to set a particular '''formatting property''' (i.e., '''color''', '''border''', etc.) , the rule with the lowest '''Priority number''' has '''priority''' over all the others.   
  
27) You can change the values in the '''Priority column''' at any time after the rule is completely defined, and any numeric value is acceptable.
+
28) You can change the values in the '''Priority column''' at any time after the rule is completely defined, and any numeric value is acceptable.
  
28) In this way you can define several identical '''condition''' columns and use a single '''Action''' column with different values and control their '''priority''' manually to achieve a desired result as shown in the example below:  
+
29) In this way you can define several identical '''condition''' columns and use a single '''Action''' column with different values and control their '''priority''' manually to achieve a desired result as shown in the example below:  
  
 
<center>[[File:X70-11_4_1-70-(16)-09272019.png]]</center>
 
<center>[[File:X70-11_4_1-70-(16)-09272019.png]]</center>
Line 291: Line 291:
 
===Legend Text Action Column===
 
===Legend Text Action Column===
  
29) Using the '''Legend Text Action''' column, you can change the '''text appearing in the Legend''' of the task/milestone to any desired '''text string''' if the rule results in a '''match or true''' result.
+
30) Using the '''Legend Text Action''' column, you can change the '''text appearing in the Legend''' of the task/milestone shape to any desired '''text string''' if the rule results in a '''match or true'''.
  
30) Clicking the '''Legend Text Action''' column's cell allows you to enter the desired '''text string''' as shown here:
+
31) Clicking the '''Legend Text Action''' column's '''grid cell''' allows you to enter the desired '''text string''' as shown here:
  
 
<center>[[File:X70-11_4_1-70-(17)-09272019.png]]</center>
 
<center>[[File:X70-11_4_1-70-(17)-09272019.png]]</center>
 
<center>X70-11_4_1-70-(17)-09272019.png</center>
 
<center>X70-11_4_1-70-(17)-09272019.png</center>
  
31) It is recommended that the '''Color Action''' column also be set to a unique '''color''' when the '''Legend Text Action''' column cell is selected so that a '''color''' is shown in the chart for the task/milestones involved as well as in the '''Legend item''' added.
+
32) It is recommended that the '''Color Action''' column also be set to a unique '''color''' when the '''Legend Text Action''' column '''grid cell''' is selected so that a '''color''' is shown in the chart for the task/milestone shapes involved as well as in the '''Legend item''' added.
  
32) When a '''match or true''' condition is found for the rule, the '''Legend''' in the chart is '''updated''' to reflect the '''text string''' entered in the '''Legend text''' cell as shown here:
+
33) When a '''match or true''' condition is found for the rule, the '''Legend''' in the chart is '''updated''' to reflect the '''text string''' entered in the '''Legend text''' '''grid cell''' as shown here:
  
 
<center>[[File:X70-11_4_1-70-(18)-09272019.png]]</center>
 
<center>[[File:X70-11_4_1-70-(18)-09272019.png]]</center>
Line 308: Line 308:
 
<center>P70-11_3_1-70-(18-1)-09232019.png</center>
 
<center>P70-11_3_1-70-(18-1)-09232019.png</center>
  
33) For more information on '''Legend management''', please see the articles in the series at:  [[The Chart Legend for Version 7.0 (Portal) | The Chart Legend (Portal)]] 15.0.1-70
+
34) For more information on '''Legend management''', please see the articles in the series at:  [[The Chart Legend for Version 7.0 (Portal) | The Chart Legend (Portal)]] 15.0.1-70
  
 
===Text Location Action Column===
 
===Text Location Action Column===
  
33) You can change the position of the '''label text''' for a task/milestone to any one of eleven (11) standard positions the rule results in a '''match or true''' result.
+
35) You can change the position of the '''label text''' for a task/milestone shape to any one of eleven (11) standard positions the rule results in a '''match or true'''.
  
34) Clicking the '''Text Location Action''' column's cells accesses the '''label text position''' dropdown as shown below:
+
36) Clicking the '''Text Location Action''' column's '''grid cells''' accesses the '''label text position''' dropdown as shown below:
  
 
<center>[[File:X70-11_4_1-70-(19-1)-09272019.png]]</center>
 
<center>[[File:X70-11_4_1-70-(19-1)-09272019.png]]</center>
 
<center>X70-11_4_1-70-(19-1)-09272019.png</center>
 
<center>X70-11_4_1-70-(19-1)-09272019.png</center>
  
35) It is recommended that the '''Color Action''' column also be set to a unique '''color''' when the '''Text Location Action''' column cell is selected so that a '''color''' is shown in the chart for the task/milestones involved as well as in the '''Legend item''' added.
+
37) It is recommended that the '''Color Action''' column also be set to a unique '''color''' when the '''Text Location Action''' column '''grid cell''' is selected so that a '''color''' is shown in the chart for the task/milestone shapes involved as well as in the '''Legend item''' added.
  
36) When a '''match or true''' condition is found for the rule, OnePager '''re-positions''' the associated task/milestone's '''label text''' to the position selected in the rule as shown here where the '''In comment box''' option is selected for Team 1 in this example:
+
38) When a '''match or true''' condition is found for the rule, OnePager '''re-positions''' the associated task/milestone shape's '''label text''' to the position selected in the rule as shown here where the '''In comment box''' option is selected for Team 1 in this example:
  
 
<center>[[File:X70-11_4_1-70-(20)-09272019.png]]</center>
 
<center>[[File:X70-11_4_1-70-(20)-09272019.png]]</center>
 
<center>X70-11_4_1-70-(20)-09272019.png</center>
 
<center>X70-11_4_1-70-(20)-09272019.png</center>
  
37) For more information on '''Label Text Management''', please see the articles in the series at:  [[Manual Editing Task/Milestone Shapes and Text Labels for Version 7.0 (Portal) | Manual Editing Task/Milestone Shapes and Text Labels (Portal)]] 9.0.1-70
+
39) For more information on '''Label Text Management''', please see the articles in the series at:  [[Manual Editing Task/Milestone Shapes and Text Labels for Version 7.0 (Portal) | Manual Editing Task/Milestone Shapes and Text Labels (Portal)]] 9.0.1-70
  
 
==Related Links==
 
==Related Links==
Line 343: Line 343:
  
 
[[Managing Templates for Version 7.0 (Portal) | Managing Templates (Portal)]] 24.0.1-70
 
[[Managing Templates for Version 7.0 (Portal) | Managing Templates (Portal)]] 24.0.1-70
 
==Other Resources==
 
  
 
[https://www.onepager.com/support/video_tutorials/conditional_formatting.html Conditional Formatting Tutorial Video]
 
[https://www.onepager.com/support/video_tutorials/conditional_formatting.html Conditional Formatting Tutorial Video]

Revision as of 21:44, 20 December 2019

About Adding Conditional Formatting Rules

1) Conditional Formatting is a capability in OnePager Express that you can use to tailor various attributes of task/milestone shapes in the chart depending on the data imported from your Microsoft Excel source plan.

2) You can define one or more conditional formatting rules that apply your specified actions to appropriate task/milestone shapes when the specified conditions in your defined rules are true.

3) For example, you can define a rule that changes the color of a task shape depending on the value contained the Category field (used to report risk in the example below) imported from your Microsoft Excel source plan.

4) In this example, suppose the Category field is used to import Risk information in the form of High, Medium, and Low.

5) You can add rules that tell OnePager Express, for instance, to set the color Red for task shapes associated with a Category value of High, set the color yellow for task shapes associated with a Category value of Medium, and set the color green for task shapes associated with a Category value of Low.

6) A video illustrating this example is available at: Conditional Formatting Tutorial Video.

7) There are nine (9) sets of task/milestone shape attributes that can be altered to respond to condition statement established in your conditional formatting rule sets.

8) This article provides the basic instructions to for adding conditional formatting rules to OnePager which can be done at the Template or Chart Properties forms level.

9) These conditional formatting rules can be edited at any time in terms of the contents of condition columns and action columns found in the Conditional Formatting Rules form discussed below.

10) Use the following steps to add a conditional formatting rule or rules to the Conditional Formatting Rules form's grid:

11) From either the Task Bars or Milestones tab of the Chart Properties or Template Properties forms, click the Manage Rules... button:

File:X70-11 4 1-70-(1)-09272019.png
X70-11_4_1-70-(1)-09272019.png

12) You are now ready to add rules.

13) Click the Add Rule button and OnePager then creates a blank line in the window shown above so you can enter the first rule.

14) The line consists of three (3) major components:

a) The rule select and enable/disable checkboxes.
b) The rule condition columns.
c) The rule action columns.

15) Adding, editing, copying, and deleting conditional formatting rules is very similar to the process for doing the same with respect to Conditional Import Filter Rules which are described in the article at: Conditional Import Filters (Portal) 7.18.1-70.

16) The sections that follow cover each of the major components of a conditional formatting rule.

Rule Selection and Enable/Disable Checkboxes

Rule Selection Columns

1) The left most column in the grid, shown below, has the following function:

X70-11 4 1-70-(2A)-09272019.png
X70-11_4_1-70-(2A)-09272019.png

2) The Rule Select checkbox is provided so you can select the rule for editing, copying, or deletion.

Enable/Disable or On Column

3) The checkbox to the right of the Rule Select cell with the column heading of On provides control over turning the rule On and Off.

4) When the On checkbox in the column above is checked, the columns that include the rule conditions and actions are enabled.

5) It may become useful to have sets of rules in the Conditional Formatting Rules form and by turning them On or Off as required you can achieve a variety of results.

Rule Condition Columns

1) There are three rule condition columns as shown below:

X70-11 4 1-70-(2)-09272019.png
X70-11_4_1-70-(2)-09272019.png

Field Column

2) In the Field column shown below is a dropdown that allows you to select the field from your Microsoft Excel source plan.

X70-11 4 1-70-(3)-09272019.png
X70-11_4_1-70-(3)-09272019.png

3) OnePager Express imports all the fields from your Microsoft Excel source plan so they are all available for use as a Field in a conditional formatting rule.

Operator Column

4) The Operator column shown below is a dropdown that allows you to pick from a list of operators depending on the data type of the Field selected as discussed above:

X70-11 4 1-70-(4)-09272019.png
X70-11_4_1-70-(4)-09272019.png

5) Since OnePager Express knows the field type imported from your Microsoft Excel source plan, the Operator column shows the appropriate operator selections when the dropdown menu above is accessed.

Text String Field Types

6) For Text String field types there are four operators:

a) equal
b) not equal
c) Contains
d) Does not contain

Numeric and Data Field Types

7) For Numeric and Date field types, the operators are shown here:

X70-11 4 1-70-(5)-09272019.png
X70-11_4_1-70-(5)-09272019.png

8) For Numeric and Date field types there are six operators:

a) equal
b) not equal
c) less than
d) less than or equal
e) greater than
f) greater than or equal

Boolean Field Types

9) For Boolean fields types (i.e., Yes/No, True/False) the operators are shown below.

X70-11 4 1-70-(6)-09272019.png
X70-11_4_1-70-(6)-09272019.png

10) For Boolean field types there are two operators that can be expressed in two (2) different ways as shown below:

a) Yes or 1
b) No or 0

11) The Value column is ghosted since selecting the Operator satisfies the need for a value.

Value Column

12) The Value column is the grid cell that you fill in that is the match desired against the Field Column given the contents of the Operator Column.

Boolean Field Types

13) The Value column is not used when the Field column is a Microsoft Project Boolean type.

Text String Field Types

15) For Text String type fields, any text that might appear in a Microsoft Excel text string field can be typed in to the Value column's grid cell for a rule.

16) Note that for string matches, it is permissible to have the Value column be a set of strings separated by commas.

17) In this situation, the rule is matched when the column value is equal to any of the comma separated values.

18) To make the comparison between text data specified in the Field column of the Conditional Formatting Rules form, OnePager trims leading and trailing white space such as blanks or control characters.

19) However, OnePager does not trim excess white space within a valid character string.

Numeric Field Types

20) For Numeric type matches any integer or integer with a decimal fraction is permissible.

Date Field Types

21) For Date type matches the Value Column provides the standard OnePager calendar when you click in the Value Column and the Field Column is a date type field as shown below:

X70-11 4 1-70-(6B)-09272019.png
X70-11_4_1-70-(6B)-09272019.png

22) The Value column can be used to compare against today’s date by clicking the Today: ... checkbox in the Pick a date Calendar form shown above.

23) This is useful for establishing a rule where it is important to color or otherwise highlight a task whose Finish date is less than or equal to today’s date, for example.

Applies to Column

24) OnePager Express performs the evaluation and then applies the formats specified in the rule to the task shapes, milestone shapes, or both as determined by the Applies to column as shown here:

X70-11 4 1-70-(6A)-09272019.png
X70-11_4_1-70-(6A)-09272019.png

25) To tell OnePager whether to apply a rule to task shapes, to milestone shapes, or to both, there are three options for the Applies to column as shown below:

a) Both
b) Tasks
c) Milestones

Rule Action Columns

1) To the right of the columns in the Conditional Formatting Rules form's grid Condition columns are nine (9) Action columns.

2) When a condition in the rule matches or is true all valid actions specified in the Action columns are applied to the task/milestone shapes in the chart.

3) If the rule's condition does not match or is false, none of the actions specified in the Action columns are taken or applied to the task/milestone shapes in the chart.

4) The Conditional Formatting Rules form's grid has a horizontal scroll bar allowing you to scroll to the left or right to being all of the nine Action columns into view within the grid as shown in the illustrations below:

Horizontal Scroll Bar to the Far Left
X70-11 4 1-70-(7)-09272019.png
X70-11_4_1-70-(7)-09272019.png
Horizontal Scroll Bar in the Middle
X70-11 4 1-70-(8)-09272019.png
X70-11_4_1-70-(8)-09272019.png
Horizontal Scroll Bar to the Far Right
X70-11 4 1-70-(9)-09272019.png
X70-11_4_1-70-(9)-09272019.png

5) In the three illustrations above the thee Conditions columns of Field, Operator, and Value remain fixed in the grid and do not scroll left or right.

6) It is important to note that whenever a rule's conditions result in a match or true result, all of the Action columns that are not blank are applied to the appropriate tasks/milestone shapes in the chart.

7) Accordingly, while you may have more than one Action column associated with a specific condition, we recommend that minimizing the number of Action columns you intend to apply in one rule.

8) As you have have capability to turn rules On and Off, you can define many rules in the grid and turn the desired rules On when they meet your schedule conversation needs with the chart.

9) In the following sub-sections are discussions of the attributes of each of the nine Action columns available.

Color Action Column

10) To add a color to the Color Action column, click on the cell for the specific rule to access the standard Color Chooser as shown below:

X70-11 4 1-70-(10)-09272019.png
X70-11_4_1-70-(10)-09272019.png

11) For more information on using the standard Color Chooser form, please see the section in the articles at: Changing Individual Task/Milestone Shape Colors 9.2.1-70

Taskbar and Milestone Shape Action Columns

12) Clicking the Taskbar Shape Action column cell accesses the standard Task Shape dropdown list as shown below:

X70-11 4 1-70-(11)-09272019.png
X70-11_4_1-70-(11)-09272019.png

13) In a similar way, clicking the Milestone Shape Action column cell accesses the standard Milestone Shape dropdown list as shown here:

X70-11 4 1-70-(12)-09272019.png
X70-11_4_1-70-(12)-09272019.png

Height % Action Column

14) You can manage the height of a task or milestone shape as a percentage of the height of the row occupied by the task/milestone shape.

15) The default Height % for task/milestone shapes is 91% of the height of the row.

16) As shown below, the Height % for the rule shown is set to 50% by typing in the number 50 as the value:

X70-11 4 1-70-(13)-09272019.png
X70-11_4_1-70-(13)-09272019.png

Border Action Column

17) Using the Border Action column, you can automatically change the look of the task or milestone shape's border if the rule results in a match or true.

18) To do this, clicking on the Border Action column's grid cell accesses the Border Style Rules form where the Use default checkbox is checked On as shown below:

X70-11 4 1-70-(14)-09272019.png
X70-11_4_1-70-(14)-09272019.png

19) To edit any of the parameters of the task/milestone shape's border uncheck the Use default checkbox and use the Border Color, Border Width, and Border Style controls as appropriate.

20) For more information on task/milestone border management, please see the section in the articles at: Changing Task/milestone Shape Borders 9.2.1-70

Label Font Action Column

21) Using the Label Font Action column, you can change the look of the task/milestone shape's label text if the rue results in a match or true result.

22) Clicking the Label font Action column's grid cell accesses the standard Font properties form as shown here:

X70-11 4 1-70-(15)-09272019.png
X70-11_4_1-70-(15)-09272019.png

23) Using the standard Font properties form has the controls for editing the important characteristics of the label text.

24) For more information on task/milestone shape label text management, please see the section in the articles at: Use the Context Menus 9.2.1-70

Priority Action Column

25) The Priority Action column is set and mostly managed by OnePager Express.

26) That is, each time you add a new rule to the grid, OnePager increments the value in the Priority Action column's grid cell by one starting at zero (0) for the first rule in the grid.

27) If several rules are in competition to set a particular formatting property (i.e., color, border, etc.) , the rule with the lowest Priority number has priority over all the others.

28) You can change the values in the Priority column at any time after the rule is completely defined, and any numeric value is acceptable.

29) In this way you can define several identical condition columns and use a single Action column with different values and control their priority manually to achieve a desired result as shown in the example below:

X70-11 4 1-70-(16)-09272019.png
X70-11_4_1-70-(16)-09272019.png

Legend Text Action Column

30) Using the Legend Text Action column, you can change the text appearing in the Legend of the task/milestone shape to any desired text string if the rule results in a match or true.

31) Clicking the Legend Text Action column's grid cell allows you to enter the desired text string as shown here:

X70-11 4 1-70-(17)-09272019.png
X70-11_4_1-70-(17)-09272019.png

32) It is recommended that the Color Action column also be set to a unique color when the Legend Text Action column grid cell is selected so that a color is shown in the chart for the task/milestone shapes involved as well as in the Legend item added.

33) When a match or true condition is found for the rule, the Legend in the chart is updated to reflect the text string entered in the Legend text grid cell as shown here:

X70-11 4 1-70-(18)-09272019.png
X70-11_4_1-70-(18)-09272019.png
File:P70-11 3 1-70-(18-1)-09232019.png
P70-11_3_1-70-(18-1)-09232019.png

34) For more information on Legend management, please see the articles in the series at: The Chart Legend (Portal) 15.0.1-70

Text Location Action Column

35) You can change the position of the label text for a task/milestone shape to any one of eleven (11) standard positions the rule results in a match or true.

36) Clicking the Text Location Action column's grid cells accesses the label text position dropdown as shown below:

X70-11 4 1-70-(19-1)-09272019.png
X70-11_4_1-70-(19-1)-09272019.png

37) It is recommended that the Color Action column also be set to a unique color when the Text Location Action column grid cell is selected so that a color is shown in the chart for the task/milestone shapes involved as well as in the Legend item added.

38) When a match or true condition is found for the rule, OnePager re-positions the associated task/milestone shape's label text to the position selected in the rule as shown here where the In comment box option is selected for Team 1 in this example:

X70-11 4 1-70-(20)-09272019.png
X70-11_4_1-70-(20)-09272019.png

39) For more information on Label Text Management, please see the articles in the series at: Manual Editing Task/Milestone Shapes and Text Labels (Portal) 9.0.1-70

Related Links

Conditional Import Filters (Portal) 7.18.1-70

Manual Editing Task/Milestone Shapes and Text Labels (Portal) 9.0.1-70

Changing Individual Task/Milestone Properties (Color, Shapes, Labels, etc.) 9.2.1-70

Modifying Decorations on Tasks/Milestones (Portal) 10.0.1-70

The Chart Legend (Portal) 15.0.1-70

Editing with the Chart Properties form (Portal) 21.0.1-70

Managing Templates (Portal) 24.0.1-70

Conditional Formatting Tutorial Video

Blog-Display Certainty in Your Plan by Using Conditional Formatting

Using Microsoft Project Flag Fields with OnePager Pro's Conditional Formatting Rules

(11.4.1-70)