Difference between revisions of "Testing Article1"

From OnePager Documentation
Jump to: navigation, search
Line 1: Line 1:
 
==Overview==
 
==Overview==
  
−
The '''Custom Date Format '''is a feature in OnePager Express that provides the capability to '''create''' your own '''date formats''' for use in the '''Time Axis''', '''Floating Time Axis''', and other places where OnePager supports various '''date formats'''.  As an example, the '''Top Level''' '''Time Axis''' shown below has a user '''created''' '''Custom Date Format''' where the Year is augmented with “Calendar Year” as an added text:
+
There are situations and environments where OnePager is used to represent '''timespans''' that are '''short periods''' during which '''work periods''' are possibly divided between '''working times''' and '''non-working times'''.  The '''Working Hours and Non-Working Hours '''feature in OnePager provides a capability to display these '''timespans''' in the chart that represent '''time periods''' where '''work is and is not being performed'''.  '''Non-working timespans '''take the visual form of '''colored''' '''Curtains''' in the '''graph''' as illustrated below:
  
−
<center>[[File:X70-22_5_2-70-(11)-11242020.png]]</center>
+
<center>[[File:P70-22_5_3-70-(1)-11112020.png]]</center>
−
<!--<center>X70-22_5_2-70-(11)-11242020.png</center>-->
+
<!--<center>P70-22_5_3-70-(1)-11112020.png</center>-->
  
−
Access to the feature is provided through the '''Chart Properties''' form '''Time Axis '''tab’s '''Calendar '''sub-tab in the '''Formatting & Layout''' control group as shown below:
+
Above, the '''Non-Working Hours''' are shown in blue for '''timespans '''from midnight to 8:00 AM, the lunch hour, and from 5:00 PM to midnight.  The controls for this feature are available in the '''Chart Properties ''' form '''Time Axis '''tab '''Format '''sub-tab in the '''Days of the Week and Non-Working Times '''group’s '''Working Hours: '''sub-group as shown below:
  
−
<center>[[File:X70-22_5_2-70-(1)-11242020.png]]</center>
+
<center>[[File:P70-22_5_3-70-(2)-11112020.png]]</center>
−
<!--<center>X70-22_5_2-70-(1)-11242020.png</center>-->
+
<!--<center>P70-22_5_3-70-(2)-11112020.png</center>-->
  
−
Clicking the '''Manage Custom Date Formats''' button accesses the '''Add Custom-Date Format''' form at the beginning of the '''creation''' or '''editing''' process as shown above.  '''Custom Date Formats''' are also supported in the OnePager '''Template Properties '''form at the '''Time Axis '''tab’s '''Calendar '''sub-tab shown here:
+
The '''Template Properties '''form's '''Time Axis '''tab’s '''Format '''sub-tab has identical controls where you can manage '''Working and Non-Working Hours''' at a '''global '''level.  You can access the '''Set Working Times '''form for defining '''Working Hours '''by clicking the '''Define Working Hours…''' button as illustrated below:
  
−
<center>[[File:X70-22_5_2-70-(2)-11242020.png]]</center>
+
<center>[[File:P70-22_5_3-70-(3)-11112020.png]]</center>
−
<!--<center>X70-22_5_2-70-(2)-11242020.png</center>-->
+
<!--<center>P70-22_5_3-70-(3)-11112020.png</center>-->
  
−
The intent of this article is to provide the information essential for you to '''create''', '''edit''', and '''manage''' your own '''date formats'''.
+
Once you establish your '''Working Hour '''periods in the '''Set Working Times''' form, the '''Non-Working Hours''' checkbox is available to display these '''non-working time periods''' as '''colored Curtains''' in the chart.  In the '''Working Hours:''' sub-group are the controls for '''showing/hiding Non-Working Hours''' and a Standard '''Color Chooser '''dropdown button for setting the '''color''' for '''Non-Working Hour Curtains'''.
  
−
==Accessing the Custom Date Format Feature==
+
The intent of this article is to provide the information essential for you to '''create''', '''edit''', and '''manage Working and Non-Working Hour time periods''' in the chart.
  
−
The '''Custom Date Format '''feature is accessible from the '''Chart Properties '''and '''Template '''forms.  Creating a '''Custom Date Format''' in the '''Template Properties '''form allows you to '''create''' '''Custom Date Format '''and use it in any chart created using that specific '''Template'''.  Creating a '''Custom Date Format '''in the '''Chart Properties '''form allows you to '''create''' '''Custom Date Format''' and use it in charts created with that specific '''Chart Properties '''form and in an follow on snapshots that might be created subsequently.  '''Chart Properties''' forms containing '''Custom Date Formats '''can be '''saved''' as '''Template Properties '''forms for future use and to standardize '''Date Formats '''throughout an organization.
+
==Accessing the Working Hours and Non-Working Hours Feature==
  
−
===Using the Chart Properties Form to Create and Edit Custom Date Formats===
+
The '''Working Hours and Non-Working Hours '''feature is accessible from the '''Chart Properties '''form and the '''Template Properties '''form.  Defining '''Working Hours '''in the '''Template Properties '''form allows you to define '''Working Hours''' and use them in any chart '''created''' using that specific '''Template Properties''' form.  Defining '''Working Hours '''in the '''Chart Properties '''form allows you to define '''Working Hours '''and use them in charts '''created''' with that specific '''Chart Properties '''form and in any follow on snapshots that might be '''created''' subsequently.  '''Chart Properties '''forms that contain '''Working Hours '''definitions can be '''saved''' as '''Template Properties '''forms for future use and to standardize '''Working Hours '''definitions throughout the organization.
  
−
You can access controls for the new feature for '''creating''' and '''editing''' '''Custom Date Formats '''by accessing the '''Chart Properties '''form '''Time Axis '''tab’s '''Calendar '''sub-tab in the '''Formatting & Layout '''control group by clicking the '''Manage Custom Date Formats''' button as shown here: 
+
===Using the Chart Properties Form to Define Working and Non-Working Hours===
  
−
<center>[[File:X70-22_4_2-70-(3)-11232020.png]]</center>
+
You can access the controls for '''managing Working and Non-Working Hours''' by accessing the '''Chart Properties '''form '''Time Axis '''tab’s '''Format '''sub-tab in the '''Days of the Week and Non-Working Hours''' group of controls and the '''Working Hours: '''sub-group as shown below:
−
<!--<center>X70-22_4_2-70-(3)-11232020.png</center>-->
+
  
−
When this button is clicked, the '''Add Custom-Date Format''' form is accessed as shown below:
+
<center>[[File:P70-22_5_3-70-(2)-11112020.png]]</center>
 +
<!--<center>P70-22_5_3-70-(2)-11112020.png</center>-->
  
−
<center>[[File:X70-22_4_2-70-(4)-11232020.png]]</center>
+
Clicking the '''Define Working Hours… '''button accesses the '''Set Working Times '''form with the '''default settings''' as shown below:
−
<!--<center>X70-22_4_2-70-(4)-11232020.png</center>-->
+
  
−
This form allows you to '''add Custom Date Formats''' by typing in the desired '''format''' in the '''Date Format''' window shown in the form above.
+
<center>[[File:P70-22_5_3-70-(5)-11112020.png]]</center>
 +
<!--<center>P70-22_5_3-70-(5)-11112020.png</center>-->
  
−
After typing in the new '''Date Format''' into the window provided and clicking the '''Add Format''' button as shown here the software provides an example of the '''Custom Date Format''' in the '''Sample''' window after you click the '''See the format''' button:
+
The '''default settings''' shown in the form above sets Monday through Friday as the default '''working days'''.  The '''Work Time Start '''and '''Work Time End''' are set to 8:00 AM and 5:00 PM respectively.  You have the option of specifying the '''Time format: '''either as a 24 Hour or 12 Hour format depending on your selection of the appropriate radio button.  The controls in the '''Set Working Times '''form are covered below.
  
−
<center>[[File:X70-22_5_2-70-(3)-11242020.png]]</center>
+
====Select Day(s): Option Control====
−
<!--<center>X70-22_5_2-70-(3)-11242020.png</center>-->
+
−
In the form above, there is a link to the OnePager website where all the '''syntax information''' needed to '''create''' your own '''Custom Date Formats''' can be found: [[https://www.onepager.com/support/faq.php?id=123 Format Help]]
+
  
−
When you click the '''Add Format '''button, OnePager accesses the '''Manage Custom Date Formats '''form that includes your new '''Custom Date Format '''in the '''Date Format List '''as shown here:
+
Making a selection of the '''days of the week''' to apply '''Working Hours''' is done by using the mouse left-click to select an individual day.  You can '''select''' a series of individual days by using the '''CTL+Left-Click '''operation.  Hold down the '''CTL key''' and use the mouse left-click to select more than one '''day of the week'''.  You can also '''select''' a continuous series of day by using the '''SHIFT+Left-Click '''operation.  Hold down the '''SHIFT key''' and click the first '''day of the week '''in the sequence and follow by continuing to hold down the '''SHIFT key''' and use the mouse left-click to select the last '''day of the week '''in your sequence.
  
−
<center>[[File:X70-22_5_2-70-(4)-11242020.png]]</center>
+
====Set Working Times for Selected Day(s): ====
−
<!--<center>X70-22_5_2-70-(4)-11242020.png</center>-->
+
  
−
The form above is multi-purpose in that it provides a '''Sample''' of the selected '''Custom Date Format''' in the '''Date Format''' window, provides a list of '''Custom Date Formats '''that can be selected for further '''editing''' or '''deleting''', and tells you where the applicable '''time unit''' the '''Custom Date Format '''is going to be applied in the '''Applies to time unit(s): '''window.   Additionally, there is another convenient link to the OnePager website page providing instructions on the '''syntax instructions '''for '''Custom Date Formats''': [[https://www.onepager.com/support/faq.php?id=123 Format Help]]
+
After making the selection for '''days of the week''', the second step is to establish the '''Work Time Start''' and '''Work Time End''' settings.  You have the option to establish more than one set of '''Start/End''' settings by using the '''Add '''button.  Each '''Start''' and '''End''' dropdown provides time options in increments of '''15 minutes'''.  Use each '''Start/End''' dropdown to set the respective required '''Work Start''' and '''Work End '''times. Once the '''Start/End '''times are set, either use the '''Add '''button to make another entry or click the '''OK '''button to finish the operation.
  
−
From the above form you can choose to '''create''' another '''Custom Date Format '''by clicking the '''Add Format '''button or '''delete''' the selected '''Custom Date Format''' in the list by clicking the '''Delete Format '''button. When you are finished, click the '''OK '''button to return to the '''Chart Properties''' form '''Time Axis '''tab’s '''Calendar '''sub-tab.  '''Creating''' your own '''Custom Date Formats''' can be useful when you want the '''text''' displayed in various '''Time Axis '''and '''Floating Time Axis Levels''' for specific meaning beyond what OnePager provides.
+
===Using the Template Properties Form to Define Working and Non-Working Hours===
  
−
For more information on the '''Chart Properties '''form, please see the article at: [[Time Axis Tab for Version 7.0 (OnePager Express) | Time Axis Tab for OnePager Express]] <!--21.17.2-70-->
+
The '''Template Properties '''form '''Time Axis '''tab’s '''Format '''sub-tab is identical to the corresponding sub-tab in the '''Chart Properties '''form. The process for defining '''Working Hours and Non-Working Hours''' described for the '''Chart Properties '''form is the same for the '''Template Properties''' form. '''Working Hours and Non-Working Hours''' defined in the '''Chart Properties '''form can be made into '''Template Properties '''forms by '''saving''' the '''Chart Properties '''form as a '''Template Properties '''form. 
  
−
===Using the Template Properties Form to Create and Edit Custom Date Formats===
+
For more information on '''Managing the Current Template''', please see this section in the article at:  [[Managing the Current Template for Version 7.0#Making a Template Properties Form from a Chart | Managing the Current Template – Making a Template Properties Form from a Chart]] <!--24.6.1-70-->
  
−
The '''Template '''form '''Time Axis '''tab’s '''Calendar '''sub-tab is identical to the corresponding sub-tab in the '''Chart Properties '''form.  The processes for '''creating''', '''editing''', and '''managing''' '''Custom Date Formats''' in the '''Template '''form are identical to the processes used in the '''Chart Properties '''form.  '''Custom Date Formats created''' in the '''Chart Properties''' form can be made into '''Template '''forms by '''saving''' the '''Chart Properties''' form as a '''Template '''form.
+
'''Working Hours and Non-Working Hours''' defined in a '''Chart Properties '''form can also be '''edited '''for future use in subsequent snapshots.  However, '''edits''' made in the '''Chart Properties '''form to '''Working Hours and Non-Working Hours''' do not change the information residing in the basic '''Template Properties '''form used to create the initial chart.
  
−
For more information on '''Making a Template Properties Form from a Chart''', please see this section in the article at: [[Managing the Current Template for Version 7.0#Making a Template Properties Form from a Chart | Managing the Current Template - Making a Template Properties Form from a Chart]] <!--24.6.1-70-->
+
For more information on the '''Template Properties''' form's '''Time Axis''' tab, please see this section in the article at: [[Template Only Features for Version 7.0 (OnePager Pro)#Template Properties Form's Time Axis Tab | Template Only Features-OnePager Pro – Template Properties Form's Time Axis Tab]] <!--24.1.1-70-->
  
−
'''Custom Date Formats created''' in a '''Template Properties '''form can be '''edited''' in the '''Template Properties '''form, '''saved''', and used in the creation of future charts.  '''Custom Date Formats created''' in a '''Chart Properties''' form can also be '''edited''' in the '''Chart Properties '''form and '''saved''' for future use in subsequent snapshots.  However, '''edits''' made in the '''Chart Properties '''form to '''Custom Date Formats''' do not change the '''Custom Date Formats '''residing in the basic '''Template '''form used to create the initial chart.
+
==Defining Working Hours - An Example==
  
−
For more information on the '''Template Properties '''form's '''Time Axis''' tab, please see this section in the article at [[Template Only Features for Version 7.0 (OnePager Express)#Template Properties Form's Time Axis Tab | Template Only Features-OnePager Express – Template Properties Form's Time Axis Tab]] <!--24.2.1-70-->
+
The following is an example using the '''Working Hours and Non-Working Hours '''feature.
  
−
===Using the Label Format Dropdown to Create Custom Date Formats===
+
===Setting Up The Working Hours Example===
  
−
'''Custom Date Formats''' can also be '''created''' using the '''Label format '''dropdown found in each of the three (3) '''Chart Properties '''form '''Time Axis '''tab '''Level '''sub-tabs ('''Top Level''', '''Middle Level''', or '''Bottom Level''') shown below:
+
To establish '''Working Hours '''for the chart, click the '''Define Working Hours…''' button as discussed above.  Clicking the '''Define Working Hours…''' button accesses the '''Set Working Times''' form shown below:
  
−
<center>[[File:X70-22_1_6-70-(5)-11132020.png]]</center>
+
<center>[[File:P70-22_5_3-70-(6)-11112020.png]]</center>
−
<!--<center>X70-22_1_6-70-(5)-11132020.png</center>-->
+
<!--<center>P70-22_5_3-70-(6)-11112020.png</center>-->
  
−
Clicking the '''Add Custom Format…''' selection in the dropdown accesses the '''Add Custom-Date Format '''form referenced above.  With the '''Add Custom-Date Format '''form accessed you can '''create''' a new '''Custom Date Format''' that becomes immediately available when the '''Add Format '''button on the '''Add Custom-Date Format '''form is clicked.  After the '''Custom Date Format '''is entered into the '''Add Custom-Date Format '''form it is immediately available in all '''Label format '''dropdown menus.
+
The form above is shown with Monday through Friday pre-selected so that the pre-defined '''Work Time Start''' and '''Work Time End''' settings are show in the '''Set working times for selected day(s): '''window.  You can '''select''' more than one day of the week and your entries in the adjacent window apply to all these days.  Within '''selected days''' you are able to enter more than one set of '''Work Time Start''' and '''Work Time End''' sets.  This is particularly useful when there are multiple '''shift work schedules'''.
  
−
For more information on '''Labeling Time Axis Levels''', please see the article at:  [[Labeling Time Axis Levels for OnePager Express for Version 7.0 | Labeling Time Axis Levels for OnePager Express]] <!--22.1.6-70-->
+
Clicking the '''Add''' button below the window places a '''blank entry''' where you can use the '''Time Selector '''dropdowns to make '''time of day '''selections. The '''Time Selector''' dropdown list provides '''time of day '''selections at '''15 minute''' intervals beginning at '''12:00 AM''' ('''00:00 hours''' for '''24 hour''' representations) and ending at '''midnight''' ('''24:00 hour''' for '''24 hour''' representations).
  
−
==Creating and Managing Custom Date Formats==
+
The '''Delete''' button removes a selected entry from the window.  Instructions are provided in the area below the '''Add''' and '''Delete '''buttons.  As mentioned above, you have the option with the '''Time format: '''control to select between '''24 Hour''' and '''12 Hour''' representations of time in the '''Set working times for selected day(s): '''window.  When all entries are made, click the '''OK '''button to complete the definition and the '''Apply '''or '''OK '''button on the '''Chart Properties '''form to apply the formats to the chart.
  
−
In previous versions, OnePager '''date formats''' were the only formats available.  While the '''date formats''' provided mirror those provided for similar features in other applications, you were limited to a finite set.  OnePager provides the capability to '''create''' your own '''Custom Date Formats''' from the '''Year''' down to the '''Second''' with some '''miscellaneous '''options also provided.  You can '''create''' and '''manage''' your own '''Custom Date Formats''' by first clicking the '''Manage Custom Date Formats ''' button on the '''Template Properties''' or '''Chart Properties '''form’s '''Time Axis '''tab at the '''Calendar''' sub-tab as shown here:
+
===Creating The Working Hours For The Example===
  
−
<center>[[File:X70-22_4_2-70-(3)-11232020.png]]</center>
+
As an example, suppose you want to '''define working hours''' as Monday through Friday from 8:00 AM to 5:00 PM with a '''one hour lunch period''' from 12:00 PM to 1:00 PM. After accessing the '''Set Working Times '''form, you might do the following.  First make the five day selections in the '''Select day(s): '''window so it looks like this:
−
<!--<center>X70-22_4_2-70-(3)-11232020.png</center>-->
+
  
−
Clicking the button shown above accesses the '''Add Custom-Date Format''' form where you can construct your '''Custom Date Format''' by typing it in the window indicated below.
+
<center>[[File:P70-22_5_3-70-(6)-11112020.png]]</center>
 +
<!--<center>P70-22_5_3-70-(6)-11112020.png</center>-->
  
−
<center>[[File:X70-22_5_2-70-(5)-11242020.png]]</center>
+
You can use the '''CTL+Left-Click''' to select several days of the week one at a time or use the '''SHIFT+Left-Click''' to select a range of days.  Shown above is the single predefined '''Working Time''' for a typical five-day work week.   Since you want to represent the '''time period''' between 12:00 PM and 1:00 PM as the '''Non-Working Time''' lunch period, you need to modify the first entry above so that the '''Work Time End''' value is 12:00 PM.   This is done by clicking on the '''Time Picker '''dropdown and selected the desired '''work time '''from the list as shown below:
−
<!--<center>X70-22_5_2-70-(5)-11242020.png</center>-->
+
  
−
The above form displays a sample of your '''Custom Date Format''' after you’ve '''created''' it and clicked the '''See the format''' button shown above.  
+
<center>[[File:P70-22_5_3-70-(8)-11112020.png]]</center>
 +
<!--<center>P70-22_5_3-70-(8)-11112020.png</center>-->
  
−
A '''Hyperlink''' is provided in the form as '''Format Help''' [[https://www.onepager.com/support/faq.php?id=123 Format Help]] that takes you to the OnePager website page where all the syntax information and examples for '''creating''' a '''Custom Date Format''' are provided.
+
Once the first '''edit''' above is made, you need to '''Add''' another entry to define the afternoon '''work  hours''' from 1:00 PM to 5:00 PM as shown below using the individual '''Time Pickers''' to make the '''time of day '''selections:
  
−
When you’ve finished '''creating''' your '''Custom Date Format''', click the '''Add Format '''button and your '''Custom Date Format''' is displayed in the '''Manage Custom Date Formats''' form which is accessed and shown below.   If more than one '''Custom Date Format''' is '''created''', this form displays them all and makes them available for future '''editing'''.
+
<center>[[File:P70-22_5_3-70-(9)-11112020.png]]</center>
 +
<!--<center>P70-22_5_3-70-(9)-11112020.png</center>-->
  
−
<center>[[File:X70-22_5_2-70-(6)-11242020.png]]</center>
+
When this is done, click the '''OK '''button on the form and the desired '''Working Hours '''are entered.  If we take a segment of the chart used in this document and establish it with '''Time Axis Levels '''of '''Years''', '''Quarters''', and '''Days of the Week''', it looks like this:
−
<!--<center>X70-22_5_2-70-(6)-11242020.png</center>-->
+
  
−
An example helps illustrate the process. Suppose you want to '''create''' a '''Custom Date Format''' that displays the year followed by the text '''“Calendar Year”'''.  
+
<center>[[File:P70-22_5_3-70-(10)-11112020.png]]</center>
 +
<!--<center>P70-22_5_3-70-(10)-11112020.png</center>-->
  
−
===Custom Date Format - An Example===
+
If we set up the '''Working Hours and Non-Working Hours''' to equate to a standard work day, the '''Set Working Times '''form looks like this:
  
−
Access the '''Add Custom-Date Format''' form as described above and type your desired '''Custom Date Format''' into the '''Date Format '''window as shown below:
+
<center>[[File:P70-22_5_3-70-(11)-11112020.png]]</center>
 +
<!--<center>P70-22_5_3-70-(11)-11112020.png</center>-->
  
−
<center>[[File:X70-22_5_2-70-(6A)-11242020.png]]</center>
+
When you click '''OK '''on the above form you are taken back to the '''Chart Properties '''form where the next step is to select the '''color''' for the '''Non-Working Hours''' by clicking the standard '''Color Chooser '''dropdown as shown below:
−
<!--<center>X70-22_5_2-70-(6A)-11242020.png</center>-->
+
  
−
The '''Custom Date Format '''consists of a '''“code”''' for the type of '''date format''' and can be followed by '''text''' enclosed in either single or double quotes. The example above shows a four digit code for years expressed as '''yyyy'''. 
+
<center>[[File:P70-22_5_3-70-(12)-11112020.png]]</center>
−
This is followed by the double quote enclosed text – '''Calendar Year'''.  Text and date codes can be interchanged.  '''Codes''' for the various '''date formats''' supported are fairly intuitive.  For instance the code for '''day '''is a '''d'''.
+
<!--<center>P70-22_5_3-70-(12)-11112020.png</center>-->
  
−
When you finish adding your '''Custom Date Format''', click the '''Add Format '''button on the '''Add Custom-Date Format '''form which accesses the '''Manage Custom Date Format '''form with your '''Custom Date Format''' added as shown here:
+
The light green '''color '''is selected from the Standard '''Color Chooser''' and becomes the '''color''' of the '''Curtains''' introduced into the chart across the day '''timespans '''to indicate the portion of the day that represents '''Non-Working Hours''' as shown in the chart below:
  
−
<center>[[File:X70-22_5_2-70-(7)-11242020.png]]</center>
+
<center>[[File:P70-22_5_3-70-(13)-11112020.png]]</center>
−
<!--<center>X70-22_5_2-70-(7)-11242020.png</center>-->
+
<!--<center>P70-22_5_3-70-(13)-11112020.png</center>-->
  
−
The process is completed at this point by clicking the '''OK '''button on the '''Manage Custom Date Formats''' form or you can go back to the '''Add Custom-Date Format''' form by clicking the '''Add Format '''button to '''create''' another '''Custom Date Format'''. You have the option in the '''Manage Custom Date Formats''' form to '''edit''' any '''Custom Date Format''' listed by selecting it and '''editing''' it in the '''Date Format''' window.  You can also '''delete''' any selected '''Custom Date Format''' from the list by selecting it and click the '''Delete Format''' button.  When you’ve finished and either clicked the '''Apply''' or '''OK '''button on the '''Chart Properties '''form, OnePager adds your '''Custom Date Format''', in this case a '''Year''', to the list of '''Date formats''' already predefined by OnePager. 
+
The above chart displays '''Non-Working Hours''' when the '''Show Non-Working Hours''' checkbox is checked '''ON'''.   Unchecking the '''Show Non-Working Hours '''checkbox to '''OFF''' '''hides''' all '''Non-Working Hour timespans''' and shrinks the '''width '''of the chart because these '''timespans '''are '''hidden'''.  Such a chart looks like this after the right edge of the chart is '''widened''' to the right:
  
−
The added '''Custom Date Format''' can be seen in the dropdown list example shown below:
+
<center>[[File:P70-22_5_3-70-(14)-11112020.png]]</center>
 +
<!--<center>P70-22_5_3-70-(14)-11112020.png</center>-->
  
−
<center>[[File:X70-22_5_2-70-(8)-11242020.png]]</center>
+
Above, Saturdays and Sundays are '''hidden''' as are '''Non-Working Hour''' portions of the five day work week. With '''Non-Working Hours hidden''', the days of the week are represented above with uniform '''widths'''.
−
<!--<center>X70-22_5_2-70-(8)-11242020.png</center>-->
+
  
−
When you click '''Apply''' or '''OK '''in the '''Chart Properties '''form, the '''Top Level Time Axis''' looks like this:
+
===Restoring Default Working Hour Settings===
  
−
<center>[[File:X70-22_5_2-70-(9)-11242020.png]]</center>
+
The recommended method to restore a chart to the '''default settings '''is to remove unwanted '''timespans''' for '''Non-Working Hours'''. To do this, go back to the '''Set Working Times '''form through the '''Chart Properties '''form access method and revert to a single entry with the '''default working hours''' for Monday through Friday. Click the '''OK''' button on the form when this action is completed.
−
<!--<center>X70-22_5_2-70-(9)-11242020.png</center>-->
+
  
−
You can also access the '''Add Custom-Date Format '''from the first entry in the '''Label format '''dropdown as shown below:
+
Next, access the standard '''Color Chooser''' and reset the '''color''' by clicking the '''No Fill '''checkbox in the Standard '''Color Chooser''' form.  Make sure that the '''Show Non-Working Hours '''checkbox is checked '''ON'''.  Last, click '''Apply/OK''' on the '''Chart Properties '''form.
  
−
<center>[[File:X70-22_5_2-70-(10)-11242020.png]]</center>
+
==The Honor Non-Working Time Feature==
−
<!--<center>X70-22_5_2-70-(10)-11242020.png</center>-->
+
  
−
'''Custom Date Formats''' added in the '''Chart Properties''' form are retained as long as the charts associated with the '''Chart Properties '''are available.  The '''Custom Date Format''' can be used in any snapshot associated with the chart and the '''Chart Properties''' form.  The '''Custom Date Format''' available in such a chart can be '''edited''' through the '''Chart Properties''', as shown earlier, and used, as modified, in all snapshots.  '''Custom Date Formats''' added to a '''Template''' form are available for all charts created with that '''Template''' form.  '''Custom Date Formats''' included in a '''Chart Properties''' form are retained in a '''Template Properties '''form '''created''' from that '''Chart Properties''' form as explained above.
+
The '''Honor Non-Working Time '''feature is an '''advanced feature''' provided in OnePager Pro so that you can accurately display '''%Complete''' bars in your charts that match the '''%Complete''' bars in Microsoft Project’s Gantt Charts when you configure the Microsoft Project Calendar with appropriate '''Working '''and '''Non-Working Time'''.
  
−
==Custom Date Format Syntax==
+
Specifying precise '''Working Hours '''and '''Non-Working Hours''' has an impact on how OnePager Pro expresses '''Percent Complete''' ('''%Complete''') when you decide to '''Honor non-working time '''in the calculations.  This '''advanced feature''' assures that you can apply your Microsoft Project '''Calendar''' and have the OnePager Pro '''graph''' accurately reflect the '''percent complete''' information from the '''source plan'''.  You have the capability to '''select''' whether you want to take into account '''source plan''' '''Working Hours''' or '''Elapsed Time''' as is the case with previous versions of OnePager.
  
−
As shown in the examples above the '''syntax''' for a '''Custom Date Format''' is a combination of '''English letters '''as codes with options for you to add '''text''' enclosed in either '''single or double quotes'''.  There are also some '''special characters '''such as '''single and double colons''', '''single and double forward slashes''', '''hyphens''', and '''commas''' used as separators.  The '''timespans '''available range from '''seconds''' on up to '''years '''with intermediate periods such as '''days''', '''weeks''', '''months''', and '''quarters'''. 
+
===Controls for Honoring Non-Working Time===
  
−
Please use this link for a full list of all available '''codes''' and '''special characters''' available for defining '''Custom Date Formats''': [[https://www.onepager.com/support/faq.php?id=123 Format Help]]
+
If you specifically define '''Working '''and '''Non-Working Hours''' precisely, you can tell OnePager Pro to '''Honor non-working time''' by checking the checkbox '''ON''' in the '''Set percent-complete properties '''form accessed from the '''Chart Properties '''form '''Task Bars '''tab by clicking the '''%Complete Properties''' button as shown in the illustration below:  
  
−
==Related Links==
+
<center>[[File:P70-22_5_3-70-(15)-11112020.png]]</center>
 +
<!--<center>P70-22_5_3-70-(15)-11112020.png</center>-->
  
−
[[Labeling Time Axis Levels for OnePager Express for Version 7.0 | Labeling Time Axis Levels for OnePager Express]] <!--22.1.6-70-->
+
The '''Honor non-working time '''checkbox is shown above in the checked''' '''or '''ON''' setting. The '''Honor non-working time '''checkbox is '''NOT '''provided in the '''Set percent-complete properties''' form for '''Milestone symbols.''' 
 +
The '''Template Properties '''form '''Task Bars''' tab '''Task Bar Decorations '''control group’s '''%Complete Properties… '''button provides access to the '''Template Properties '''form’s '''Set percent-complete properties''' form where its '''Honor non-working hours '''checkbox is located.
  
−
[[Editing Time Axes with the Chart Properties Form for OnePager Express for Version 7.0 | Editing Time Axes with the Chart Properties Form for OnePager Express]] <!--22.4.2-70-->
+
===Honoring Non-Working Time - An Example===
  
−
[[Template Only Features for Version 7.0 (OnePager Express) | Template Only Features-OnePager Express]] <!--24.2.1-70-->
+
As an example, suppose you have a simple Microsoft Project '''source plan '''that has five tasks with the '''%Complete''' information as shown below:
  
−
[[Managing the Current Template for Version 7.0 | Managing the Current Template]] <!--24.6.1-70-->
+
<center>[[File:P70-22_5_3-70-(16)-11112020.png]]</center>
 +
<!--<center>P70-22_5_3-70-(16)-11112020.png</center>-->
  
−
[[Time Axis Tab for Version 7.0 (OnePager Express) | Time Axis Tab for OnePager Express]] <!--21.17.2-70-->
+
If you '''create''' a standard OnePager chart from the above '''source plan '''it looks like this:
  
−
'''Help Page for Adding Custom Date Formats:''' [[https://www.onepager.com/support/faq.php?id=123 Format Help]]
+
<center>'''Honor Non-Working Time Checkbox is OFF'''</center>
 +
<center>[[File:P70-22_5_3-70-(17)-11112020.png]]</center>
 +
<!--<center>P70-22_5_3-70-(17)-11112020.png</center>-->
 +
 
 +
In the chart above, the '''Honor non-working time''' checkbox is unchecked or '''OFF'''.  This means that OnePager Pro does '''not''' take into consideration any of the '''Non-Working Time '''information you provided in the '''Set Working Times '''form to display '''%Complete''' information.  To show the change when '''Non-Working Time''' information is specified, suppose you establish rules in the '''Set Working Times''' form that show '''working times''' from 8:00 AM to Noon and from 1:00 PM to 5:00 PM for Monday through Friday as shown below:
 +
 
 +
<center>[[File:P70-22_5_3-70-(18)-11112020.png]]</center>
 +
<!--<center>P70-22_5_3-70-(18)-11112020.png</center>-->
 +
 
 +
After clicking the '''OK''' button on the form above and the '''Apply''' button on the '''Chart Properties''' form, go back to the '''Task Bars''' tab on the '''Chart Properties''' form and access the '''Set percent-complete properties '''form as you did before and check the '''Honor non-working time''' checkbox to '''ON'''.  This step is completed when you click '''OK '''on the '''Set percent-complete properties''' form and the '''Apply''' or '''OK''' buttons on the '''Chart Properties '''form.  The last step required is to do a snapshot '''Replace All''' by going to the OnePager Pro '''Data''' ribbon tool bar tab and clicking the '''Replace Snapshot '''button.  After the '''Replace Snapshot '''operation is complete,''' '''the chart looks like this:
 +
 
 +
<center>'''Honor Non-Working Time Checkbox is ON'''</center>
 +
<center>[[File:P70-22_5_3-70-(19)-11112020.png]]</center>
 +
<!--<center>P70-22_5_3-70-(19)-11112020.png</center>-->
 +
 
 +
The differences can be emphasized more if the two illustrations are placed in a before and after arrangement as shown below:
 +
 
 +
<center>'''Honor Non-Working Time Checkbox is OFF'''</center>
 +
<center>[[File:P70-22_5_3-70-(20)-11112020.png]]</center>
 +
<!--<center>P70-22_5_3-70-(20)-11112020.png</center>-->
 +
 
 +
<center>'''Honor Non-Working Time Checkbox is ON'''</center>
 +
<center>[[File:P70-22_5_3-70-(21)-11112020.png]]</center>
 +
<!--<center>P70-22_5_3-70-(21)-11112020.png</center>-->
 +
 
 +
The result from looking at the two charts above, is that when '''Non-Working Time''' is displayed for '''%Complete''' bars they appear shorter when '''Non-Working Time''' is precisely defined''' '''and the '''Honor Non-Working Time '''checkbox is checked '''ON'''.  This is because in the second chart above, no work is performed between 12 noon and 1:00 PM or from 5:00 PM to 8:00 AM the next day.  Since the example above used the '''Standard Calendar''' in Microsoft Project, the '''graph '''above with the '''Honor Non-Working Time '''checkbox checked''' On''' is exactly like the Microsoft Project Gantt chart shown here.
 +
 
 +
<center>[[File:P70-22_5_3-70-(22)-11112020.png]]</center>
 +
<!--<center>P70-22_5_3-70-(22)-11112020.png</center>-->
 +
 
 +
==Related Links==
 +
 
 +
[[Template Only Features for Version 7.0 (OnePager Pro) | Template Only Features-OnePager Pro]] <!--24.1.1-70-->
 +
 
 +
[[Managing the Current Template for Version 7.0 | Managing the Current Template]] <!--24.6.1-70-->
  
−
(22.5.2-70)
+
(22.5.3-70)
  
 
[[Category:Version 7.0]]
 
[[Category:Version 7.0]]
−
[[Category:OnePager Express]]
+
[[Category:OnePager Pro]]
 
[[Category:Editing the Chart]]
 
[[Category:Editing the Chart]]
 
[[Category:Charts]]
 
[[Category:Charts]]
 
[[Category:Time Axis]]
 
[[Category:Time Axis]]
−
[[Category:Time AxisTab]]
+
[[Category:Time Axis Tab]]
−
[[Category:Calendar Sub-Tab]]
+
[[Category:Working Times]]
−
[[Category:Floating Time Axis]]
+
[[Category:Non-Working Times]]
−
[[Category:Non-Linear Time Axis]]
+
[[Category:Color Palettes]]
−
[[Category:Custom Date Formats]]
+
[[Category:Curtains]]
 +
[[Category:Ribbon]]
 
[[Category:Snapshots]]
 
[[Category:Snapshots]]
 +
[[Category:Task/Milestone]]
 +
[[Category:Percent Complete]]
 
[[Category:Template]]
 
[[Category:Template]]
 
[[Category:Chart Properties]]
 
[[Category:Chart Properties]]

Revision as of 15:55, 19 January 2021

Overview

There are situations and environments where OnePager is used to represent timespans that are short periods during which work periods are possibly divided between working times and non-working times. The Working Hours and Non-Working Hours feature in OnePager provides a capability to display these timespans in the chart that represent time periods where work is and is not being performed. Non-working timespans take the visual form of colored Curtains in the graph as illustrated below:

P70-22 5 3-70-(1)-11112020.png

Above, the Non-Working Hours are shown in blue for timespans from midnight to 8:00 AM, the lunch hour, and from 5:00 PM to midnight. The controls for this feature are available in the Chart Properties form Time Axis tab Format sub-tab in the Days of the Week and Non-Working Times group’s Working Hours: sub-group as shown below:

P70-22 5 3-70-(2)-11112020.png

The Template Properties form's Time Axis tab’s Format sub-tab has identical controls where you can manage Working and Non-Working Hours at a global level. You can access the Set Working Times form for defining Working Hours by clicking the Define Working Hours… button as illustrated below:

P70-22 5 3-70-(3)-11112020.png

Once you establish your Working Hour periods in the Set Working Times form, the Non-Working Hours checkbox is available to display these non-working time periods as colored Curtains in the chart. In the Working Hours: sub-group are the controls for showing/hiding Non-Working Hours and a Standard Color Chooser dropdown button for setting the color for Non-Working Hour Curtains.

The intent of this article is to provide the information essential for you to create, edit, and manage Working and Non-Working Hour time periods in the chart.

Accessing the Working Hours and Non-Working Hours Feature

The Working Hours and Non-Working Hours feature is accessible from the Chart Properties form and the Template Properties form. Defining Working Hours in the Template Properties form allows you to define Working Hours and use them in any chart created using that specific Template Properties form. Defining Working Hours in the Chart Properties form allows you to define Working Hours and use them in charts created with that specific Chart Properties form and in any follow on snapshots that might be created subsequently. Chart Properties forms that contain Working Hours definitions can be saved as Template Properties forms for future use and to standardize Working Hours definitions throughout the organization.

Using the Chart Properties Form to Define Working and Non-Working Hours

You can access the controls for managing Working and Non-Working Hours by accessing the Chart Properties form Time Axis tab’s Format sub-tab in the Days of the Week and Non-Working Hours group of controls and the Working Hours: sub-group as shown below:

P70-22 5 3-70-(2)-11112020.png

Clicking the Define Working Hours… button accesses the Set Working Times form with the default settings as shown below:

P70-22 5 3-70-(5)-11112020.png

The default settings shown in the form above sets Monday through Friday as the default working days. The Work Time Start and Work Time End are set to 8:00 AM and 5:00 PM respectively. You have the option of specifying the Time format: either as a 24 Hour or 12 Hour format depending on your selection of the appropriate radio button. The controls in the Set Working Times form are covered below.

Select Day(s): Option Control

Making a selection of the days of the week to apply Working Hours is done by using the mouse left-click to select an individual day. You can select a series of individual days by using the CTL+Left-Click operation. Hold down the CTL key and use the mouse left-click to select more than one day of the week. You can also select a continuous series of day by using the SHIFT+Left-Click operation. Hold down the SHIFT key and click the first day of the week in the sequence and follow by continuing to hold down the SHIFT key and use the mouse left-click to select the last day of the week in your sequence.

Set Working Times for Selected Day(s):

After making the selection for days of the week, the second step is to establish the Work Time Start and Work Time End settings. You have the option to establish more than one set of Start/End settings by using the Add button. Each Start and End dropdown provides time options in increments of 15 minutes. Use each Start/End dropdown to set the respective required Work Start and Work End times. Once the Start/End times are set, either use the Add button to make another entry or click the OK button to finish the operation.

Using the Template Properties Form to Define Working and Non-Working Hours

The Template Properties form Time Axis tab’s Format sub-tab is identical to the corresponding sub-tab in the Chart Properties form. The process for defining Working Hours and Non-Working Hours described for the Chart Properties form is the same for the Template Properties form. Working Hours and Non-Working Hours defined in the Chart Properties form can be made into Template Properties forms by saving the Chart Properties form as a Template Properties form.

For more information on Managing the Current Template, please see this section in the article at: Managing the Current Template – Making a Template Properties Form from a Chart

Working Hours and Non-Working Hours defined in a Chart Properties form can also be edited for future use in subsequent snapshots. However, edits made in the Chart Properties form to Working Hours and Non-Working Hours do not change the information residing in the basic Template Properties form used to create the initial chart.

For more information on the Template Properties form's Time Axis tab, please see this section in the article at: Template Only Features-OnePager Pro – Template Properties Form's Time Axis Tab

Defining Working Hours - An Example

The following is an example using the Working Hours and Non-Working Hours feature.

Setting Up The Working Hours Example

To establish Working Hours for the chart, click the Define Working Hours… button as discussed above. Clicking the Define Working Hours… button accesses the Set Working Times form shown below:

P70-22 5 3-70-(6)-11112020.png

The form above is shown with Monday through Friday pre-selected so that the pre-defined Work Time Start and Work Time End settings are show in the Set working times for selected day(s): window. You can select more than one day of the week and your entries in the adjacent window apply to all these days. Within selected days you are able to enter more than one set of Work Time Start and Work Time End sets. This is particularly useful when there are multiple shift work schedules.

Clicking the Add button below the window places a blank entry where you can use the Time Selector dropdowns to make time of day selections. The Time Selector dropdown list provides time of day selections at 15 minute intervals beginning at 12:00 AM (00:00 hours for 24 hour representations) and ending at midnight (24:00 hour for 24 hour representations).

The Delete button removes a selected entry from the window. Instructions are provided in the area below the Add and Delete buttons. As mentioned above, you have the option with the Time format: control to select between 24 Hour and 12 Hour representations of time in the Set working times for selected day(s): window. When all entries are made, click the OK button to complete the definition and the Apply or OK button on the Chart Properties form to apply the formats to the chart.

Creating The Working Hours For The Example

As an example, suppose you want to define working hours as Monday through Friday from 8:00 AM to 5:00 PM with a one hour lunch period from 12:00 PM to 1:00 PM. After accessing the Set Working Times form, you might do the following. First make the five day selections in the Select day(s): window so it looks like this:

P70-22 5 3-70-(6)-11112020.png

You can use the CTL+Left-Click to select several days of the week one at a time or use the SHIFT+Left-Click to select a range of days. Shown above is the single predefined Working Time for a typical five-day work week. Since you want to represent the time period between 12:00 PM and 1:00 PM as the Non-Working Time lunch period, you need to modify the first entry above so that the Work Time End value is 12:00 PM. This is done by clicking on the Time Picker dropdown and selected the desired work time from the list as shown below:

P70-22 5 3-70-(8)-11112020.png

Once the first edit above is made, you need to Add another entry to define the afternoon work hours from 1:00 PM to 5:00 PM as shown below using the individual Time Pickers to make the time of day selections:

P70-22 5 3-70-(9)-11112020.png

When this is done, click the OK button on the form and the desired Working Hours are entered. If we take a segment of the chart used in this document and establish it with Time Axis Levels of Years, Quarters, and Days of the Week, it looks like this:

P70-22 5 3-70-(10)-11112020.png

If we set up the Working Hours and Non-Working Hours to equate to a standard work day, the Set Working Times form looks like this:

P70-22 5 3-70-(11)-11112020.png

When you click OK on the above form you are taken back to the Chart Properties form where the next step is to select the color for the Non-Working Hours by clicking the standard Color Chooser dropdown as shown below:

P70-22 5 3-70-(12)-11112020.png

The light green color is selected from the Standard Color Chooser and becomes the color of the Curtains introduced into the chart across the day timespans to indicate the portion of the day that represents Non-Working Hours as shown in the chart below:

P70-22 5 3-70-(13)-11112020.png

The above chart displays Non-Working Hours when the Show Non-Working Hours checkbox is checked ON. Unchecking the Show Non-Working Hours checkbox to OFF hides all Non-Working Hour timespans and shrinks the width of the chart because these timespans are hidden. Such a chart looks like this after the right edge of the chart is widened to the right:

P70-22 5 3-70-(14)-11112020.png

Above, Saturdays and Sundays are hidden as are Non-Working Hour portions of the five day work week. With Non-Working Hours hidden, the days of the week are represented above with uniform widths.

Restoring Default Working Hour Settings

The recommended method to restore a chart to the default settings is to remove unwanted timespans for Non-Working Hours. To do this, go back to the Set Working Times form through the Chart Properties form access method and revert to a single entry with the default working hours for Monday through Friday. Click the OK button on the form when this action is completed.

Next, access the standard Color Chooser and reset the color by clicking the No Fill checkbox in the Standard Color Chooser form. Make sure that the Show Non-Working Hours checkbox is checked ON. Last, click Apply/OK on the Chart Properties form.

The Honor Non-Working Time Feature

The Honor Non-Working Time feature is an advanced feature provided in OnePager Pro so that you can accurately display %Complete bars in your charts that match the %Complete bars in Microsoft Project’s Gantt Charts when you configure the Microsoft Project Calendar with appropriate Working and Non-Working Time.

Specifying precise Working Hours and Non-Working Hours has an impact on how OnePager Pro expresses Percent Complete (%Complete) when you decide to Honor non-working time in the calculations. This advanced feature assures that you can apply your Microsoft Project Calendar and have the OnePager Pro graph accurately reflect the percent complete information from the source plan. You have the capability to select whether you want to take into account source plan Working Hours or Elapsed Time as is the case with previous versions of OnePager.

Controls for Honoring Non-Working Time

If you specifically define Working and Non-Working Hours precisely, you can tell OnePager Pro to Honor non-working time by checking the checkbox ON in the Set percent-complete properties form accessed from the Chart Properties form Task Bars tab by clicking the %Complete Properties button as shown in the illustration below:

P70-22 5 3-70-(15)-11112020.png

The Honor non-working time checkbox is shown above in the checked or ON setting. The Honor non-working time checkbox is NOT provided in the Set percent-complete properties form for Milestone symbols. The Template Properties form Task Bars tab Task Bar Decorations control group’s %Complete Properties… button provides access to the Template Properties form’s Set percent-complete properties form where its Honor non-working hours checkbox is located.

Honoring Non-Working Time - An Example

As an example, suppose you have a simple Microsoft Project source plan that has five tasks with the %Complete information as shown below:

P70-22 5 3-70-(16)-11112020.png

If you create a standard OnePager chart from the above source plan it looks like this:

Honor Non-Working Time Checkbox is OFF
P70-22 5 3-70-(17)-11112020.png

In the chart above, the Honor non-working time checkbox is unchecked or OFF. This means that OnePager Pro does not take into consideration any of the Non-Working Time information you provided in the Set Working Times form to display %Complete information. To show the change when Non-Working Time information is specified, suppose you establish rules in the Set Working Times form that show working times from 8:00 AM to Noon and from 1:00 PM to 5:00 PM for Monday through Friday as shown below:

P70-22 5 3-70-(18)-11112020.png

After clicking the OK button on the form above and the Apply button on the Chart Properties form, go back to the Task Bars tab on the Chart Properties form and access the Set percent-complete properties form as you did before and check the Honor non-working time checkbox to ON. This step is completed when you click OK on the Set percent-complete properties form and the Apply or OK buttons on the Chart Properties form. The last step required is to do a snapshot Replace All by going to the OnePager Pro Data ribbon tool bar tab and clicking the Replace Snapshot button. After the Replace Snapshot operation is complete, the chart looks like this:

Honor Non-Working Time Checkbox is ON
P70-22 5 3-70-(19)-11112020.png

The differences can be emphasized more if the two illustrations are placed in a before and after arrangement as shown below:

Honor Non-Working Time Checkbox is OFF
P70-22 5 3-70-(20)-11112020.png
Honor Non-Working Time Checkbox is ON
P70-22 5 3-70-(21)-11112020.png

The result from looking at the two charts above, is that when Non-Working Time is displayed for %Complete bars they appear shorter when Non-Working Time is precisely defined and the Honor Non-Working Time checkbox is checked ON. This is because in the second chart above, no work is performed between 12 noon and 1:00 PM or from 5:00 PM to 8:00 AM the next day. Since the example above used the Standard Calendar in Microsoft Project, the graph above with the Honor Non-Working Time checkbox checked On is exactly like the Microsoft Project Gantt chart shown here.

P70-22 5 3-70-(22)-11112020.png

Related Links

Template Only Features-OnePager Pro

Managing the Current Template

(22.5.3-70)

Retrieved from "https://wiki.onepager.com/wiki/index.php?title=Testing_Article1&oldid=35053"