How to edit a change record

You can edit multiple records simultaneously by selecting them in the grid and updating them in the Preview pane on the right. For more information, see Mass update.

  1. From the main menu, select Build > Change. Service Management displays the available changes.

  2. Select the change record that you want to edit.

    To filter the record list, click the Add filter  button. For more information, see Filters.

  3. Click the record identifier in the ID column to display the selected record.

    • If the change is in breach of the scheduling standards, a warning icon is displayed at the top right of the form. You can click the icon to display information about the breach, and a link to the Change Calendar. For more information, see Scheduling changes.

    • Click View in calendar to see the change record displayed in the Change Calendar.
    • In the right pane, there are Change Analytics widgets that display information about changes relevant to the change record you are viewing. Relevant means these changes:

      • Used the same change model and affected the same service as the current change record; and

      • Were closed within the preceding six months.

      The information displayed in the following widgets can help you improve the chance of the current change being successfully completed. The central idea is that by looking at past changes you can improve future performance.

      • Success analysis widget

        This displays, as a pie chart, the successful changes out of all the relevant changes.

        If you point to the chart, actual percentages are displayed.

        If you click on a portion of the pie chart, Service Management takes you to a filtered list of changes to match the portion you clicked on. For example, if you click on the successful portion, Service Management displays all the successful, closed changes that used the same model and affected the same service as the change record you are viewing.

      • Risk statistics widget

        This displays, as a bar chart, the risk profile of all the relevant changes.

        If you point to the chart, actual percentages are displayed.

        If you click a bar in the chart, Service Management takes you to a filtered list of changes to match the bar you clicked on. For example, if you click on the High risk bar, Service Management displays all the high risk changes that used the same model and affected the same service as the change record you are viewing.

      • Similar past changes widget

        This displays, in separate tabs, successful and failed relevant changes.

        Note You can use the information displayed in the Similar past changes widget to help you in various aspects of change management.

        For example:

        • You may be able to improve scheduling by referring to similar past changes and noting and investigating material differences between scheduled time and actual time.

        • You may be able to improve success rate by referring to similar past changes and analyzing what factors contributed to a change succeeding or failing.

        UI Description
        Successful tab

        Relevant change records are listed in this tab if they have either of the following completion codes:

        • Successful

        • Successful with problems

        The maximum number of changes displayed in this tab is three.

        Failed tab

        Relevant change update records are listed in this tab if they have either of the following completion codes:

        • Failed

        • Rejected

        The maximum number of changes displayed in this tab is three.

        The summary information displayed for each change includes:

        • Owner's avatar

        • Change record Id

        • Title

        • Actual duration*

        If you point to the change summary, further details are displayed, including:

        • Title

        • Description

        • Review results

        • Actual duration*

        • Link to comments and number of comments**

        *If there was a difference of more than 30% between the actual duration and the planned duration, an alert icon is displayed beside the actual duration. If you point to the icon, a pop-up message displays the scheduled duration.

        ** Depending on the available comments, you may see information that can help improve implementation of the current change.

    • In the right pane, the Related Contracts widget displays all of the contracts related to the record you are viewing.

      • Click the down arrow to expand the list of related contracts.
      • Click a contract to see its full details.

      The icon in the left of the contract indicates the type of contract:

  4. By default, the change record is displayed with the General tab selected. Click the tab you want to edit or view:

    Tab Description
    General Displays general information about the current record. For more information about the General tab, see General tab.
    Workflow Displays the workflow metaphase and phase for the current record. For more information about workflow, see Change workflow.
    Schedule Displays a Change Calendar, scheduled and actual times for the current record. For more information about scheduling, see Schedule tab.
    Plan and execute Displays task and planning items for the current record. For more information about tasks and planning, see Plan and execute tab.
    Involved CIs Displays involved devices, system elements and affected services. For more information about Involved CIs, see Involved CIs tab.
    Related records Displays records which are causes of, or effects of, the current record. For more information about related records, see Related records tab.
    Approvals Displays approvals for the current record. For more information about approvals, see Approvals tab.
    Related knowledge Displays relevant articles and news items for the current record. For more information, see Related knowledge tab.
    Discussions Displays any relevant conversations about the current record. For more information about discussions, see Discussions.
    History Displays changes to the selected record. For more information about history, see History.

    Note  

    • Click the record title to edit it.

    • To use a template, click Apply template on the toolbar.

  5. Click Save icon Save on the toolbar.

You can edit multiple records simultaneously by selecting them in the grid and updating them in the Preview pane on the right. For more information, see Mass update.

Change record tabs

General tab

The Change record's General tab has screen reader support. For more information, see Screen reader support.

This tab includes the following sections:

Section Description
Review

This part of the record is only visible after the change enters the review phase in the workflow. It includes the following fields:

  • Review results: the result of the review.
  • Completion code: a shorthand code for a description of the completion.
General change details This section contains basic information about the change record. For more information about general change details, see General change details .
Classification This section helps you put the change into the correct workflow with assigned ownership. For more information about classification, see Classification .
External Assignment This section is only relevant when an external group is selected in the Owning group field. The data in the section is populated by the external system.
User options

This section contains any user options. These are cloned from the change model for the record.

For more information about user options, see User options.

Attachments

Click Add attachment if you want to attach a file to the record.

Note

  • The following file formats are supported: jpg; jpeg; gif; png; doc; docx; ppt; pptx; xls; xlsx; pdf; txt; xml; zip; msg; sql; gz; rar; tar; 7z.

  • The maximum file size of an attachment is 10 MB.

  • If the Attachments field has been defined as encrypted for this record type and you are a member of an encryption domain, click Add encrypted attachments to attach an encrypted file to the record.

  • Attachments are not visible in the Service Portal.

  • General change details

    Field Description
    Title

    The title is a summary of the change request.

    Best practice: choose a meaningful, descriptive, and relatively short title. Titles are often the only identification used in selection lists and in other areas to identify components.

    Description

    A description that captures the details of the change. Service Management may automatically recognize CIs whose details are entered here. See CI Detection - Automatic recognition of CIs.

    Reason for change

    The reason for the change. Select the reason that most closely matches the purpose of the change request.

    Latest execution time

    The date and time by when the change will complete.

    Justification

    The justification for the change. What may happen if the change is not implemented?

    Best practice: be as specific as possible.

    Reported by

    The person requesting the change.

  • Classification

    Field Description
    Priority

    The priority for implementing the change. This is a read-only, calculated field that Service Management chooses based on the Impact and Urgency values. The following table describes the default priority matrix.

      Enterprise Site or department Multiple users Single user
    Total loss of service Critical High High Medium
    Severe disruption High High Medium Medium
    Slight disruption High Medium Medium Low
    No disruption Medium Medium Low Low

    This matrix can be adjusted through business rule configuration.

    Owning group

    The group responsible for dealing with the change.

    Urgency

    The urgency value describes how important the issue is for the customer. Service Management uses the urgency value to calculate the priority for the change implementation.

    Owner

    The person responsible for dealing with the change.

    Note: The drop-down list displays only people who are members of the owning group.

    Impact

    The global effect on the user community. Consider whether the change affects the entire enterprise, a business unit, or an individual.

    Risk

    The risk involved in making the change.

    Release The release, if any, the change record is part of.
    Service

    The service affected by the change.

    Services are usually related to one of the following:

    • Infrastructure. For example, database or network services.

    • Business services. For example, email or a web portal.

    The selected service affects the change model you can select. See “Change model”.

    Category

    The category of the change. Service Management uses the category to classify change records.

    The selected category affects the change model you can select. See “Change model”.

    Service component The service component related to the change.
    Subtype

    The subtype of the change. The following options are available:

    • Minor
    • Significant
    • Major
    Change model

    A collection of predefined values. Selecting the model automatically populates the relevant fields and creates the tasks necessary to complete the change.

    In the drop-down, change models are grouped as follows:

    • ALL MODELS

    • MODELS BY SERVICE – the change models relevant to the selected service, and those change models that are not connected to a service

    • MODELS BY CATEGORY - the change models relevant to the selected category, and those change models that are not connected to a category

    • MODELS BY SERVICE AND CATEGORY – all of the following change models:

      • Relevant to the selected service and the relevant category

      • Not connected to a service, but relevant to the selected category

      • Not connected to a category, but relevant to the selected service

      • Not connected to a service, and not connected to a category

    The change models available for selection depend on the selected Service and Category.

    Service selected Category selected Change models displayed
    No No ALL MODELS
    Yes No MODELS BY SERVICE
    No Yes

    ALL MODELS

    MODELS BY CATEGORY

    Yes Yes

    MODELS BY SERVICE AND CATEGORY

    MODELS BY SERVICE

    Change model notes

    • When you select a change model, the drop-down list also displays the model's process type: normal, standard, or emergency change.

    • After you select a change model, you may overwrite any field values which the change model provided. If you do so, saving the record saves the overwritten field values, and not the values which the change model provided.

    • Service Management allows you to select a new model for a change record after you have created the record. Take care because this major operation may change the workflow type and overwrite field values.

    • If you try to save a change record with a new change model, Service Management displays a confirmation message.

      To undo the selection, click Cancel and refresh the page. Note that refreshing the page also affects all edits since you last saved your work. Otherwise, continue editing and saving the record.

Schedule tab

This tab includes the following sections:

Section Description
Change Calendar

Displays the change, when scheduled, and time periods.

The calendar can display dates up to one month backwards and six months forward from the current date. If scheduled, the change is shown 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 and time period is displayed at the bottom of the calendar.

Change scheduling information

If a change is:

  • Approved and does not breach the change scheduling standards, an approved icon Approved icon is displayed.

  • Approved, but breaches the change scheduling standards, this icon is displayed: Approved change breaches scheduling standards.

  • Not approved, and breaches the change scheduling standards, this icon is displayed: Breach.

    Note  

    • If there is no active maintenance time period and no active blackout time period, Service Management disables the display of the breach icons.

    • For more information about the change scheduling standards, see Scheduling changes.

To schedule a change:

  • If not already scheduled: click on the calendar. A popup is displayed for you to enter the change duration. After entering a value, click Suggest next available window to schedule the change for the next available maintenance window.

  • If already scheduled, click the drop-down to the right of the change representation. A popup is displayed with available windows. Select a window to schedule the change.

  • You can drag the change representation to a time in the calendar.

  • To view information about a time period, click it. The information is displayed in a popup window with a link to the time period record.

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

To use 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.

  • 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, or the date of the change.

  • If the change is part of a release, a colored line displays in the calendar header to match the release schedule.

    You can point to the line to display information about the release in a popup window, including a link to the release record.

  • You can use the scroll bar at the bottom of the calendar, to scroll through the calendar.

  • To view information about a time period, click it. The information is displayed in a popup window, including a link to the time period record.

  • 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 the current change does not affect the service, that time period does not display in the Change Calendar.

Scheduled times

Details of the scheduled times for the change:

  • Breach status: a message about the change record and scheduling standards. For more information, see Scheduling changes.

  • Scheduled start: the date and time when work on the change is scheduled to start. Click the calendar icon to select the date, and the clock icon to select the time.

  • Scheduled end: the date and time when work on the change is scheduled to end. Click the calendar icon to select the date, and the clock icon to select the time.

  • Scheduled duration: the scheduled duration for the change. Click the duration to display a widget for editing the value.

    Service Management automatically calculates the scheduled duration from the scheduled start and end, each time the record is saved. If you increase or decrease the scheduled duration, Service Management automatically adjusts the scheduled end, when the record is saved.

  • Scheduled DT start: the date and time when any required downtime is scheduled to start. Click the calendar icon to select the date, and the clock icon to select the time.

  • Scheduled DT end: the date and time when any required downtime is scheduled to end. Click the calendar icon to select the date, and the clock icon to select the time.

  • Scheduled DT duration: the scheduled downtime duration for the change. Click the duration to display a widget for editing the value.

    Service Management automatically calculates the scheduled downtime duration from the scheduled downtime start and end, each time the record is saved. If you increase or decrease the scheduled downtime duration, Service Management automatically adjusts the scheduled downtime end, when the record is saved.

Actual times

Details of the actual times for the change.

  • Actual start: the date and time when work on the change started. Click the calendar icon to select the date, and the clock icon to select the time.

  • Actual end: the date and time when work on the change ended. Click the calendar icon to select the date, and the clock icon to select the time.

  • Actual duration: the actual duration for the change. Click the duration to display a widget for editing the value.

    Service Management automatically calculates the actual duration from the actual start and end, each time the record is saved. If you increase or decrease the actual duration, Service Management automatically adjusts the actual end, when the record is saved.

  • Actual DT start: the date and time when downtime started. Click the calendar icon to select the date, and the clock icon to select the time.

  • Actual DT end: the date and time when downtime ended. Click the calendar icon to select the date, and the clock icon to select the time.

  • Actual DT duration: the actual downtime duration for the change. Click the duration to display a widget for editing the value.

    Service Management automatically calculates the actual downtime duration from the actual downtime start and end, each time the record is saved. If you increase or decrease the actual downtime duration, Service Management automatically adjusts the actual end, when the record is saved.

Duration widget

If you have the appropriate permissions, you can configure the widget to display either of the following:

  • Days, hours, and minutes

  • Months, days, and hours

The length of a month is hard-coded in the widget at 30 days.

For more information, see "Precision" in Edit a field.

Plan and execute tab

This tab includes the following sections:

Section Description
Change plan

Details of the change plan. It includes the following fields:

  • Build and test required: marks the change as requiring a build and test. Ensure you clear this check box if a build and test is not required.

  • Implementation plan: details of the implementation plan. Service Management may automatically recognize CIs whose details are entered here. See CI Detection - Automatic recognition of CIs.

  • Remediation plan: details of the remediation plan.

  • External reference: the relevant external reference number, if available.

Task plan

This is where you design, create, and edit tasks. The tabs that appear under task plan depend on the type of change, with each tab matching a workflow phase which may require completion of a task. The parenthesized number on the tab is the number of tasks in each phase.

If the change model used to create the change has a predefined task plan, the plan is cloned to the change. You can edit the task plan where necessary.

Service Management sets the task plan to read-only, in each of the following cases:

  • When the tasks for the current phase have been completed, and the change record enters a new phase.

  • When a change record enters the Abandon phase.

You can also generate task report in xlsx format.

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

  2. Select the change records that you want to generate the task report. The report includes the tasks for the selected change records only.

    Note The maximum number of change records can be selected is 100 at one time.

  3. Click Generate Task Report on the toolbar to download the tasks, the downloaded file includes current displayed fields in the list view of parent change records and specific fields of tasks. All tasks, regardless of their status, are included in the report.

For more information about the task plan, see How to build a task/approval plan.

Involved CIs tab

In this tab you may add, change, or delete associations with business devices, infrastructure and peripheral assets, licenses, and system elements that are related to the record. When you link a device, an infrastructure asset, a license, or a system element to a record, you create an internal relationship between them. This tab also displays relevant affected services.

In this tab you can also view a topology impact map for each device and system element you choose, and the affecting CIs and a topology impact map for each affected service.

How to add an involved device, infrastructure and peripheral asset, license, or system element:

  1. Click Add or the grid icon .

  2. Select the required records. The added items appear in yellow.

  3. Click Save.

Affected services connected to the selected involved devices are shown in the Affected Services part of the tab.

How to delete an involved device, infrastructure and peripheral asset, license, or system element:

  1. Select the required records.

  2. Click Remove. The selected items appear in strikethrough text.

  3. Click Save.

How to view an impact map for a device:

  1. In the Involved Devices section, select the device.

  2. Click Show Impact Impact icon. An impact map of the device is displayed.

How to view an impact map for a system element:

  1. In the Involved System elements section, select the system element.

  2. Click Show Impact Impact icon. An impact map of the system element is displayed.

How to view the CIs affecting a service and an impact map:

  1. In the Affected Services section, select the service.

  2. Click View CIs affecting. A list of CIs affecting the service is displayed.

  3. Select the CI whose impact map you want to view.

  4. Click Show Impact Impact icon. An impact map of the CI is displayed.

    The impact map highlights the path (or paths, if there is more than one) from the chosen CI (the device or system element) to the service.

You can zoom in and out of the impact map by using the mouse wheel button. If a text string is too long to be displayed, an ellipsis (…) appears. You can hover over the ellipsis to display the full text string.

You can hover over the following icons in the impact map:

  • Owner avatar Avatar – a window is displayed with the owner’s details.

  • Business criticality Criticality – a tooltip is displayed with the criticality.

  • Location Location – a tooltip is displayed with the name of the location.

Depending on the size of the impact map and the browser window, Service Management may not display the subtype of a Device, Service or System Element. Hover over the subtype graphic to see a tooltip with this information.

Related records tab

The records displayed are those that are the causes of the current record, and those that are the effects of the current record.

  1. In each section, the default sort order is first by record type, then by phase. You can click a column heading to reverse the sort order in any column.

    Field Description
    Id The identifier of the record. Click the ID value to link to the record.
    Title or Name A short description provided by the end user.
    Phase Id The current phase of the current record in the workflow.
    Priority The priority is a value based on urgency and business impact values.
    Active Indicates if the related record is active.
  2. In the appropriate section, do one of the following:

    • Click Add icon Add to create a relationship between the current record and another record.

      The Add related record dialog appears. The dialog box displays a list of potential related records. If you select an individual record, Service Management displays the contents of that record in the right pane.

      • If you want to search for more records, you can use the Search box at the top of the dialog box.

      • Find each record that you want to link, and click Add to select it.

      • When you have selected all the records that you want to link, click OK.

      • Click Save icon Save on the toolbar.

    • Click Remove icon Remove to delete the relationship between the current record and the selected record.

      • Click OK to confirm the action.

      • Click Save icon Save on the toolbar.

      This action removes the relationship only. It does not delete either record.

For more information about related records, see How to relate change records.

Approvals tab

The Approvals tab is where you design, create, and edit approvals. It is also where you give or refuse approvals. The tabs that appear depend on the type of change. The parenthesized number on the tab is the number of approvals in each phase.

Change Approval tabs
Emergency ECAB
Normal

Approve plan

Approve deployment

Standard None

Approval plans are defined out-of-the-box for Normal and Emergency type changes. These plans are defined in the record definition of each of these types of changes. For more information, see Approval definitions.

You can edit the approval plans of a normal or emergency change workflow in the Approvals tab.

  1. In the Change record, go to the Approvals tab.
  2. Select a phase to display its approval plan.
  3. Move the mouse over the Start node, and click the Edit    button.
  4. Select an element to add to the plan. The following elements are available:

    Step Description
    Approval Requires one or more users to grant an approval before the workflow can move on to the next phase.
    Decision A decision point that uses an Expression Language phrase to determine which path in the approval plan to follow.
    Join Joins two or more nodes in the approval plan. Both must be completed before moving on to the next node in the plan.
    Path to Creates a path between two nodes in the plan.
  5. Fill in the relevant information for the selected node.

    • Approval

      Requires one or more users to grant an approval before the workflow can move on to the next phase.

      Available for the approval phases only.

      Title A title for the approval.
      Strategy

      The strategy to use to obtain the approval:

      • All must approve. Every assigned user must grant an approval.
      • All must approve - immediate deny. Every assigned user must grant an approval. If one user denies an approval, the approval is denied.
      • Quorum. The majority of responses determines whether the approval is granted or denied.
      • One must approve. Requires only one assigned user to grant an approval. The approval is granted regardless of the responses of the other users.
      • One must approve – immediate deny. Requires only one assigned user to grant an approval. If one user denies an approval, the approval is denied. (The decision follows the first user who answers.)

      Add approver user Adds a User line to the list of approvers where you can specify a user who must grant the approval.
      Add approver group

      Adds a Group line to the list of approvers where you can specify a group that must grant the approval.

      When a user in the group assigns the approval to himself, the approval is removed from the Approvals queues of the other members of the group.

      Add approver expression

      Adds an Expression line to the list of approvers where you can specify an Expression Language phrase to determine which users must grant an approval.

      You can also define a condition on which to base the resulting list of users. The condition is defined as an Expression Language phrase.

    • Decision

      A decision point that uses Expression Language phrases to determine which path in the task plan to follow:

      1. Enter the details of the decision to be made.

      2. Enter an Expression Language phrase to define when the decision must be made.

      3. For decisions that require a yes or no answer, you can use the predefined Yes/No decision options.

        Alternatively, click Advanced to define other decision options. In this case, the list of options always includes an otherwise option in case none of the defined options are met.

      4. For each decision option, define the next step.

  6. To create a path from one node to another, click the Edit  button on the source node, select Path to, and click the destination node. A path is drawn from the source node to the destination node.

  7. To ensure that certain tasks are completed before moving on with another task, you can direct them through a join node. Each task node leading into the join node must be completed before the task node leading out of the join node can be instantiated.

    To join nodes:

    1. Click the Edit button on one of the nodes, and select Join. A join node is added.

    2. Click the node that you want to join to the first node, and select Path to.

    3. Click the join node. Both nodes lead into the join node.

    4. Repeat to direct more nodes through the join node if desired.

  8. Continue to build the plan in the same way from one node to another.
  9. Save the plan.

Related knowledge tab

The Related knowledge tab is where related knowledge or news articles are displayed.

Action Procedure
Add a knowledge or news article
  1. Click  Add. The Add related record dialog box opens.

  2. Select a knowledge or news article.

    You can filter the selection using the drop-down list and the filter button.

  3. Click  Add in the right pane of the dialog box.

  4. Repeat the above 2 steps as required, and then click OK. The selected records are added to the Related knowledge tab.

Remove a knowledge or news article
  1. Select the knowledge article or news article you want to delete.

  2. Click Image of clear all icon Remove, and then OK.

View a knowledge or news article
  1. Select the knowledge or news article you want to view.

  2. Click the record identifier in the ID column to display the selected record.

Related topics