This documentation supports the 21.3 version of BMC Helix ITSM: Change Management. To view an earlier version, select the version from the Product version menu.

Calendar functional areas


The Calendar displays the data for a selected time span in the selected view. From within the various views, you can perform multiple operations on an event in the Calendar. An event can be an incident, problem, change, release, business event, or CI outage.

View the Calendar by selecting Calendar from the Quick Links menu.

Additionally, from the Change Management and Release Management applications, you can access the Calendar by using the following options:

  • From the Applications menu, select Change Management > Calendar.
  • On the Change Management console or Release Management console, select Functions > View Calendar.
  • On the Change form or Release form, select Quick Action > View Calendar.

The following figure shows the options described for the Calendar.

Cal2.PNG



Filters & Queries

The Filters & Queries pane provides options for selecting the primary data source and applying additional filters to the data.

Filters menu

You can choose to view details of incidents, problems, changes, and releases for the selected time span by selecting the appropriate option under Filters. The calendar displays the events relevant to each filter type, if you specified the start and end dates while creating a ticket. The table below displays the default out-of-the-box start and end date set by the system for each filter type.

Filter

Default start date

Default end date 

Releases

Scheduled Start Date

Scheduled End Date

Changes

Scheduled Start Date

Scheduled End Date

Problems

Problem Reported On

Target Date

 Incidents

Reported Date

Target Date

A user with administrator permissions can change the default start and end date for each filter type by using the backend form NGC:DataSource. The following example shows how to change the default start and end date for a problem:

  1. On the  NGC:DataSource form, set the Primary Source list value to Yes and click Search to view the filter types.
  2. From the search results, select Problems to view the data source details.

    search results.PNG

  3. From the Start Date Type list, select Actual Start Date.
    The Start Date Type field displays the ID of the selected field.

    Actual Start Date.PNG

  4. From the End Date Type list, select Actual End Date.
    The End Date Type field displays the ID of the selected field.
  5. Select the Default check box to set the selected start and end date values as the default value.
  6. (Optional) Click Add to add the selected values to the panel below.
  7. Click Save.
  8. Repeat steps 1 and 2 to refresh the page and view the newly set default values.

    Refresh.PNG

Queries menu

You can apply additional queries to filter the displayed data by selecting an option from the Queries > Predefined Queries menu. If you have any user-defined queries, you can select them from the Queries > My Queries menu.

To clear all the additional queries that have been applied, select Predefined Queries > By Status and then select All Open (for incidents), All Open Problems, All Open Changes, or All Open Releases based on the type of request that you have selected.

Important

  • The list of queries that is displayed depends on the value selected in the Filters menu. For example, if you select Change Request, all queries related to change requests are displayed.
  • Any saved queries migrated from an earlier version of the Calendar are displayed under Queries > Predefined Queries.

The following predefined queries are available for incidents out of the box:

Query name

Description

All Open

View all the requests in the Open status from the list.

The following options are available:

  • All Priorities—All incidents.
  • Critical Priority—All critical priority incidents.
  • High Priority—All high priority incidents.
  • Medium Priority—All medium priority incidents.
  • Low Priority—All low priority incidents.
  • Extensive Impact—All incidents that have extensive impact.

All Open Submitted By Me

View all the requests submitted by you in the Open status.

The following options are available:

  • All Priorities—All incidents submitted by you.
  • Critical Priority—All critical priority incidents submitted by you.
  • High Priority—All high priority incidents submitted by you.
  • Medium Priority—All medium priority incidents submitted by you.
  • Low Priority—All low priority Incidents submitted by you.

All Open Unacknowledged

View all the requests in the Open status that are unacknowledged.

The following options are available:

  • All Priorities—All unacknowledged incidents.
  • Critical Priority—All unacknowledged critical priority incidents.
  • High Priority—All unacknowledged high priority incidents.
  • Medium Priority—All unacknowledged medium priority incidents.
  • Low Priority—All unacknowledged low priority incidents.

All Open Unassigned

View all the unassigned requests.

The following options are available:

  • All Priorities—All unassigned high priority incidents.
  • Critical Priority—All unassigned critical priority incidents.
  • High Priority—All unassigned high priority incidents.
  • Medium Priority—All unassigned medium priority incidents.
  • Low Priority—All unassigned low priority incidents.

The following predefined query is available for problems out of the box:

Query name

Description

By Status

View the records by the status selected from the list.

For problems, the following options are available:

  • All Open Problems—All problems in the Open status.
  • All Problems—All problems.
  • All Open Problems with Extensive Impact—All problems in the Open status and with the Impact defined as Extensive.
  • All Open Unassigned Problems—All unassigned problems in the Open status.
  • All Completed Problems—All problems in the Completed status.
  • All Closed Problems—All problems in the Closed status.

The following predefined queries are available for changes out of the box:

Query name

Description

By Status

View the requests by the status selected from the list.

For changes, the following options are available:

  • All Draft Changes—All changes that are in the Draft status.
  • All Pending Changes—All changes that are in the Pending status.
  • All Pre-Scheduled Changes—All changes with a status earlier than Scheduled.
  • All Open Changes with Extensive Impact—All changes in the Open status and with the Impact defined as Extensive.
  • All Open Changes—All changes in the Open status.

By Service

View requests by service CIs.

You can define, save, and delete your own search criteria, based on service CIs. Service CIs are in a hierarchical structure as defined by the user company. In searching for changes by service CI, you can specify the depth level at which to search. For example, depth level 2 means that you are searching the specified CI, its children, and its grandchildren (in the hierarchy tree) for all the related changes.

You can view results based on your search criteria in the Calendar by performing the following actions:

  • Select a saved search from the Saved Searches list and click OK.
  • Select the search criteria and click OK.

You can define a new service CI search by selecting the search criteria and clicking Save Search. For more information about service CIs, see Creating-a-CI.

By Location

Include an impact location in your search (for example, by company, region, site group, or site).

You can define, save, and delete your own search criteria based on categories such as change status, approval status, and so on. You can further filter requests by choosing options such as product categorization (for example, Software) and assignment (by manager's name, group, or assignee).

You can view results based on your search criteria in the Calendar by performing the following actions:

  • Select a saved search from the Saved Searches list and click OK.
  • Select the search criteria and click OK.

You can define a new location search by selecting the search criteria and clicking Save Search.

By Related CI

Define, save, and delete your own search criteria based on categories such as status and impact. You can further filter requests by selecting options such as operational categorization (for example, Add) and assignment (by manager's name, group, or assignee).

Finally, you can include CI criteria in your search (for example, a CI class such as software).

You can view results based on your search criteria in the Calendar by performing the following actions:

  • Select a saved search from the Saved Searches list and click OK.
  • Select the search criteria and click OK.

You can define a new search by selecting search criteria and clicking Save Search.

Quick Search

Run and create quick searches for change or release based on basic fields.

In the Quick Search dialog box, you can perform the following actions:

  • Define your search criteria and click OK to run it or click Save Search to save your selections.
  • Run a saved search by selecting it from the list and then click OK.
  • Delete a saved search by selecting it from the list and then click Delete Search.


Time durations

The date or date range of the data is displayed in the Calendar. Click the arrow next to this date to view the date picker and select a specific date. Click the arrows next to the timeline bar to change the duration by a day, week, or month, depending on the duration that you selected. To move back to the current date, click Today on the timeline bar.

Important

The duration of a week is equivalent to the 5-day and 7-day periods available in the previous version of the Calendar.


Legend

The Legend in the Calendar displays details about the field values and the color codes used for each value. It includes the color codes for business events, CI outages, and colliding changes. By default, the Legend is displayed, but you can click the arrow to hide the details.

On the Calendar, incidents, problems, changes, releases, and their related tasks and manifest are shown in transparent color-coded blocks. Although related tasks and activities are shown in the predefined default color, the color code for incidents, problems, changes, and releases can be configured. For more information about configuring the field and colors, see Managing-Change-Calendar-preferences.

Business events, planned outages, and unplanned outages that can be displayed in the Calendar view are shown in solid bars. When you are viewing collisions, colliding changes are displayed in solid shaded blocks. These colors are predefined and cannot be configured.


Event InfoTips

When you hover your mouse pointer over an event, a summary of the requests is displayed in a small window called an InfoTip. You can configure the fields displayed in the InfoTip. For more information about adding or removing fields from the InfoTip, see Managing-Change-Calendar-preferences. The InfoTip is a subset of the information displayed on the Details pane, which provides additional details about a request or an outage in the Calendar view.


Details pane

To view additional details of an incident, problem, change, release, or outages, select the record and click the Details pane on the right of the calendar. In the Timeline view, you can drill down to the related records like change tasks, problem tasks, incident tasks, or a release manifest and view their details in the Details pane.

Important

Details of business events are not displayed in the Details pane.

The Details pane displays the following sections:

  • Activity Info displays details of the selected request, like summary, ID, status, and coordinators.
  • Collision Detection (applies to changes and releases) displays all the colliding changes for the selected duration. You must have run collision detection for the selected record from the change or release application to view this information here. When you select a request and select the Collision Detection option in the Details pane, all colliding changes are displayed in gray-shaded blocks on the calendar. For more information about collision detection, see Detecting-collisions-between-change-requests.
  • Impact Analysis (applies to changes and releases) displays all the relationships of the selected impact type from the relationship list created for that record within the application. You must have run the impact analysis for the selected record from the change or release application to view this information. For more information about impact analysis, see Viewing the impact of CIs on change requests
  • Relationships displays all the requests related to the selected record. For example, when you select a problem record and select the Relationships option in the Details pane, all the requests related to that problem record are displayed.


Right-click menu commands

When you right-click an incident, problem, change, or release in a view, or their related tasks or manifest in the Eventlist view, all available commands for the selected record are displayed:

Menu command

Description

Applicable data source

Open record

If you have appropriate permissions, opens the record in the application console.

Incidents and problems

Open request

If you have appropriate permissions, opens the request in the application console.

Changes and releases

Edit Event

Displays a dialog box in which you can update the summary or the start and end date of the request. Ensure that the edited scheduled dates do not conflict with existing events.

Important: You cannot edit incidents and problems. You can edit only changes and releases.

Changes and releases

Show Approval

Displays a light version of Approval Central if you are a valid approver. This light version does not display the pane. As a valid approver, you can approve or reject the request, reassign the request, and save your changes.

Changes and releases

Service Context

Displays the Service Context Summary window of the service CI associated with the selected request, if any. The summary window displays the basic details of the service CI. For more information about the Service Context Summary window, see Configuring attributes by using the Service Context Administration window.

Incidents, problems, changes, and releases

Broadcast record

Displays the New/Modify Broadcasts window. You can broadcast the record that you selected. The Broadcast option is available in the Calendar view only.

Important: You cannot broadcast business events. You can broadcast only incidents, problems, changes, releases, and outages.

Incidents, problems, changes, and releases

Export to ICS file

Exports all the events seen on the Calendar to an iCalendar (ICS) file. This functionality is available only in the Calendar view. For more information about how to export events to the ICS file, see Exporting-Calendar-events-to-an-ICS-file.

Incidents, problems, changes, and releases


Drag-and-drop events

For changes and releases, an additional option is provided in the Calendar and Timeline views. You can drag changes and releases to another date and time. In the Timeline view, the date and time of the event is displayed as a tooltip as you drag the request. In case of a collision, you can use this option to move the request to a date and time that does not collide with existing requests. When you move the request, the details of the event are automatically updated to the new date and time. A confirmation message is displayed based on the success or failure of the operation. If you do not have permissions to modify the request, an error message is displayed. In the Timeline view, you can also drag related tasks and activities; however, you cannot move them across changes or releases.

Important

You can drag-and-drop changes and releases, but you cannot drag-and-drop problems and incidents.


Menu icons

The following icons are available on the calendar:

Icon

Description

today.gif

In the timeline bar, click the arrows to change the duration by a day, week, or month, depending on the duration that you had selected. Click Today to see the data for the current date.

create_broadcast.gif

Click this link to open the broadcast dialog box, from where you can view, create, modify, and delete broadcasts. When there are unread broadcasts, this area displays the icon followed by the number of new broadcasts. For more information about broadcasting messages, see Broadcasting messages.

Important: You can create or modify broadcasts only if you have the functional role of a Broadcast submitter.

export_icon.png

Click the Export all Events to ICS file icon to export all the events being displayed on the Calendar to an ICS file.

refresh_icon.gif

Click the Refresh icon to refresh the calendar data.

save_icon.gif

If you move multiple events within the Calendar, click the Save icon to save changes made to all the records. This option is enabled only if Bulk Modification is enabled.

Important: You can move events within the calendar only in the Calendar and Timeline views.

print_icon.gif

Click the Print icon to print the displayed data. When you click this icon, the Print dialog box appears. Select the appropriate printer and click OK to print the data. In the Eventlist view and Timeline view, a preview of the printed data is also displayed. In the Calendar view, the Filters & Queries pane is also printed.

report_icon.gif

Click the Report Console icon to launch the Reporting console to create or view reports. You must have the required permissions to view the Reporting console. For more information about creating reports, see Using reports and flashboards .

settings_icon.gif

Click the Settings icon to perform the following actions:


Using the date picker on the Change Calendar

The Calendar header provides information about the data filters applied and duration of the calendar data. For example, if the data filter applied is for all open changes and the duration selected is Month, the header is All Open Changes for August 2012.

The arrow next to the header displays the date picker for the calendar, as shown in the following figure:

date_picker_specific.gif

You can perform the following functions on the date picker:

  • Click < and > to move the calendar to the previous or next month.
  • Press Ctrl+Up Arrow or Ctrl+Down Arrow to move the calendar to the same month in the previous or next year.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*