Change Management integration with ITOM Visibility

concept australia Updated Sep 10, 2026 3 min read change-mgmt-integ-wth-Discovery.md
Raw file servicenow.com

If your organization is subscribed to ITOM Discovery or ITOM Visibility, integration with these ITOM products is automatically enabled. With this integration, any configuration item (CI) with an IP address that is part of a change request process can be maintained automatically. Change request fulfillers can also manually request the discovery process for a CI.

Enabling integration

Depending on subscriptions purchased by your organization, you must install and configure the following plugins:

  • For ITOM Discovery: the Discovery plugin (com.snc.discovery)
  • For ITOM Visibility: the Discovery plugin (com.snc.discovery) and Service Mapping plugin (com.snc.service-mapping)

Integration with ITOM Discovery

When Discovery is activated, Change Management adds three properties to the Change Properties module (Change Management > Administration > Change Properties). The following table describes these properties.

Property

Description

Configures how discovery is triggered for Affected CIs (automatically, manually or off)

Determines whether to trigger discovery for the affected CIs automatically, manually, both, or not at all.Type: Choice list

Values: Off, Both, Automatic, Manual

Default value: Off

Note: If this property is set to Both and you trigger discovery manually, automatic discovery isn't triggered for that change request.

List of Change Request states (comma-separated) where discovery can be triggered manually

Defines the change request states in which users can manually initiate discovery. For these defined state values, the Initiate Discovery related link is available.Type: String

Default value: Implement, Review

Note: If there are multiple languages used on the instance, then this property needs to be set to the internal state value for Review.

List of Change Request states (comma-separated) where discovery triggers automatically. For example, when the Change Request's state changes to Review

Defines the change request state values for which discovery is automatically triggered. Discovery initiates when transitioning to the state values listed.Type: String

Default values: Review

Note: If there are multiple languages used on the instance, then this property needs to be set to the internal state value for Review.

**Note:** For the last two properties in the preceding table, if there are multiple languages used on the instance, then the property needs to be set to the internal value, which is 0, for Review.

In addition to these properties, the Discovery State and the Discovery last updated fields are added to the Affected CIs related list. Discovery State provides one of five status values and a corresponding icon to reflect that status:

  • In Progress
  • Completed Successfully
  • Completed w/Warning
  • Completed w/Error
  • Cancelled

The Discovery State value is presented as a link to the corresponding Discovery log file. The Discovery last updated field contains a date and time stamp indicating the last time Discovery was executed.

If you have opted to manually initiate the Discovery module, or opted for both manual and automatic initiation, then the Initiate Discovery related link appears in the Related Links section when the state of the change request matches one of the defined states in the property. When Discovery is triggered, the values in the Discovery State and the Discovery last updated fields change.

[Omitted image "cm-integration-discovery"] Alt text: Affected CIs related list with Discovery State and Discovery last updated fields, and the Initiate Discovery related link

Integration with ITOM Visibility

You can view the changes in the context of application services. Service maps available in Service Mapping show changes to an application service as a whole and to the individual configuration items (CIs) comprising the service.

If the ServiceNow AI Platform is configured to validate changes, all changes are evaluated and rendered as valid or not. If a change is valid, its change record on the service instance map is marked as approved. For more information about configuring the platform for change validation, see Managing proposed changes.

The type of change mark depends on the nature of changes that it represents:

  • Light gray balloon ([Omitted image "ChangeHistoryBalloonsLightGray.png"] Alt text: Light grey balloon icon)

    Unapproved change that does not influence the service instance behavior. For example, a change in a network path or adding a node to a cluster.

  • Dark gray balloon ([Omitted image "ChangeHistoryBalloonsDarkGray.png"] Alt text: Dark gray balloon icon)

    Unapproved change that changes the service instance behavior.

  • Green balloon ([Omitted image "ChangeHistoryBalloonsGreen.png"] Alt text: Green balloon icon)

    An approved change in deployments where the ServiceNow AI Platform is configured to validate changes.

  • Double balloon ([Omitted image "ChangeHistoryBalloonsDouble.png"] Alt text: Green balloon icon)

    Multiple separate changes that happened a short time from each other.

Parent Topic:Change management integrations

Related topics

Discovery

View the change history of application services

View the change history of application services in Agent Workspace

Search documentation
Search document titles and file paths on the australia branch