How to view the Change Calendar

Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

From the main menu, select Build > Change > Calendar.

The Change Calendar is displayed.

The calendar can display a maximum of 100 change records.

If the filter selection is 100 or more change records, a warning icon is displayed, with an informative tooltip message.

The default display is 30 change records.

To display more change records, click Show more at the bottom of the records list. This displays up to 60 change records, and if clicked again, shows up to 100 change records.

To return to the default display, click F5, or reset the filter selection.

To maximize calendar performance, refine the filter selection to display fewer change records.

The default display is in order of scheduled start, with the first at the top.

For information about filtering changes in the calendar, see How to filter records in the Change Calendar.

Change Calendar User Interface (UI)

The Change Calendar has the following UI elements:

Left pane

The left pane displays a list of changes, each showing a risk icon, record Id, and title. There are also other icons to reflect various statuses.

You can use the Sort by drop-down and button on the toolbar to choose the order in which they appear.
You can point to an icon to display a tooltip explaining its meaning.

For example:

If you schedule a change to occur outside a maintenance time period (or "window"), or inside a blackout time period, an icon is displayed as a warning:
- for a change which is not yet approved.
- for a change which is approved.
For more information, see How to deal with a change that breaches the scheduling standards.
If a change is approved and not in breach of the change scheduling standards, an approved icon is displayed.
If there is an unscheduled change, a clock icon is displayed. For more information, see How to deal with an unscheduled change.

Main pane

The main pane displays the calendar, including changes and time periods.

Calendar

You can use the DAY, WEEK, and MONTH buttons on the toolbar to change the calendar display format.

If View calendar by is set to DAY, the change calendar displays units of one hour.

If View calendar by is set to WEEK or MONTH, the change calendar displays units of one day.
You can use the NOW button on the toolbar to scroll to the current time. This assumes the current time is within the calendar time range.
You can use the GO TO... button on the toolbar to go to the date of your choice.
You can use the Previous and Next buttons to go to the previous or next day, week, or month.
You can use the horizontal scroll bar at the bottom of the main pane to scroll backwards and forwards through the calendar.

The calendar can display dates up to one month backwards and six months forward from the current date.

Changes

Each change is shown on the matching row of the calendar by a colored graphical representation ("representation") that is displayed from its start to end time. Scheduled downtime is highlighted within the change representation. A key for the change representation and downtime is displayed at the bottom of the calendar.

If the change has an owner, the avatar for that person is displayed to the left of the change representation.
If you point to the avatar, a popup window is displayed with brief details of the owner, and icons allowing you to send the owner an email, or start a discussion with the owner. For more information, see Discussions.
If the change representation is not visible, point to the change in the left pane and click the Scroll to change button .
If you point to the change representation in the calendar, a popup window is displayed with brief details of the change.
If a change is:
- Approved and does not breach the change scheduling standards, an approved icon is displayed.
- Approved, but breaches the change scheduling standards, this icon is displayed: .
- Not approved, and breaches the change scheduling standards, this icon is displayed: .
  
  For more information about the change scheduling standards, see Scheduling changes.

Time periods

Maintenance and blackout periods (or "windows") are shown with a colored highlight matching the legend in the footer.
If the change affects a service, and for that service there is a maintenance or blackout period, the relevant period is displayed in the row of the change.
If there is an overlap of a maintenance period with a blackout period, the calendar displays only the blackout period for the overlapping time.
To view information about a maintenance or blackout period:
1. Select a change by clicking on its row.
2. Click the calendar at the relevant time unit, on the row for which you want to view information.
  
  The time unit displayed is either an hour or a day depending on the View calendar by selection.
  
  The information is displayed in a popup window with a link to the time period record.
To view information about a holiday or event period:
1. Holiday and event time periods are shown on the calendar header only as a solid line.
2. Point to the solid line, and a tooltip is displayed with information about the time period.

You can turn off the display of time periods by clearing the appropriate check box in the footer.

If there is a time period that applies to a service, and there are no changes affecting the service, that time period does not display in the Change Calendar.

Leaving the Change Calendar