Managing Change › Change Calendar › Scheduling View Configuration › schedGroup Macro—Specify an Event Group

schedGroup Macro—Specify an Event Group

The schedGroup macro specifies the name and color coding of a group of items. The monthly view aggregates all items in a group into a single event. Views other than the monthly show individual items in the format for the group to which they belong. The following optional values are valid macro arguments:

grpname=xxx

(Required) Specifes the name of the group. The macro automatically assigns a number to the group and assigns the number to a JavaScript variable with a name of the form schedGroup_xxx, where xxx is the name of the group. This variable can be used in the setSchedEvents() JavaScript function to create an event belonging to the group.

Note: This argument is the only required argument for the schedGroup macro.

label=xxx

Specifies a label for the group. If specified, the label is displayed in all views.

legend=xxx|0

Displays a description of the group for the legend that appears at the bottom of the schedule. Groups appear in the legend if at least one example of the group exists in the current view. Specifying 0 causes the group always to be excluded from the legend.

Default: 0

color=black|color

Specifies the color of text in items of this group. You can specify color in CSS format, either a valid web color or a hexadecimal value preceded by a pound sign.

Example: Enter either "#FF0000" or "red" for red.

Default: black

bgcolor=white|color

Specifies the background color of items of this group. You can specify bgcolor in CSS format, either a valid web color or a hexadecimal value preceded by a pound sign.

Example: Enter either "#FF000" or "red" for red.

Default: white.

style=normal|bold|italic

Specifies the style of text of this group in the normal, bold, or italic style.

Default: normal

Configure Blackout and Maintenance Windows on the Change Calendar

You edit PDM_MACRO statements in list_chgsched_config.htmpl to modify colors, labels, legends, and icons for change windows.

Note: If you use schedGroup macros to change the formatting of windows on the Change Calendar, you must also update schedule.css if you want the formatting to be consistent with the Change Scheduler.

To configure change windows

1. Open the list_chgsched_config.htmpl form in a text editor or WSP.

   You can locate this file in the following directory:

   $NX_ROOT\bopcfg\www\htmpl\web\analyst\
   

2. On the schedGroup macro, modify the following PDM_MACRO statements:

   For maintenance windows:

   <PDM_MACRO NAME=schedGroup grpname=maintWindow 
   

   bgcolor=lightgreen
   label="Maintenance"
   legend="Maintenance Window"
   icon= "confirmation_12.png">
   

   For blackout windows:

   <PDM_MACRO NAME=schedGroup grpname=blackoutWindow style=italic color=white 
   

   bgcolor=black
   label="Blackout"
   legend="Blackout Window"
   icon= "warning_12.png">
   

   bgcolor

   Specifies the background color of the window.

   label

   Specifies the window label as Blackout or Maintenance.

   legend

   Specifies the text of the legend as it appears on the Change Calendar.

   icon

   Specifies an optional URL to a 12x12 pixel web graphic.

   This icon displays with a change order or group on the Change Calendar if the change order lies completely within a maintenance window or overlaps a blackout window.

3. Save the form.

   The change windows are configured.