Home Orlando DevOps DevOps DevOps User-created DevOps integrations

User-created DevOps integrations

The DevOps product is rolling out gradually by region with an initial focus on the Northeast US and the UK. Please reach out to your ServiceNow account manager for availability in your area or other opportunities for early access. For more information, please see DevOps FAQ KB0785090 .

User-created DevOps integrations

User-created integrations are for integrating additional planning, coding, orchestration, and test tools not included in the integrations provided with the DevOps application.

The DevOps application includes tool definitions for integrating some common planning, coding, orchestration, and test tools, but you can also set up user-created integrations for additional tools in your DevOps environment.

Note: User-created integrations for test tools are not supported.

Tool integrations provided with the DevOps application:

Planning (Azure DevOps Boards, Jira ver 7.x and 8.x, ServiceNow Agile Development ver 2.x)
Coding (Azure DevOps Repos, Bitbucket Server/Enterprise ver 5.10.0, GitHub ver 2.x, GitHub Enterprise ver 2.x, GitLab SCM ver 12.8.0)
Orchestration and Test (Azure DevOps Pipelines, Jenkins ver 2.138, GitLab CI/CD ver 12.8.0 basic CI pipelines)

DevOps integration objects

Starting with version 1.12, DevOps tool integration consists of these objects.

A tool can be mapped to multiple capabilities.


Tool Integration	Tool Type Capability	Tool Capability Mapping
Agile Development 2.0 Azure DevOps Bitbucket GitHub GitHub Enterprise GitLab Jenkins Jira	Plan Code Orchestration Artifact Test	Plan Agile Development 2.0 - Plan Azure DevOps - Plan Jira - Plan Code Azure DevOps - Code Bitbucket - Code GitHub - Code GitHub Enterprise - Code GitLab - Code Orchestration Azure DevOps - Orchestration Jenkins - Orchestration GitLab - Orchestration Test Azure DevOps - Test Jenkins - Test

A tool capability mapping can be mapped to multiple actions.


Tool Capability Mapping	Tool Action	Integration Capability
Agile Development 2.0 - Plan Azure DevOps - Plan Azure DevOps - Code Azure DevOps - Orchestration Bitbucket - Code GitHub - Code GitHub Enterprise - Code GitLab - Code GitLab - Orchestration Jenkins - Orchestration Jira - Plan	Connect Discover Import Lookup Notification	Agile Development 2.0 Agile Development 2.0 - Plan - Connect Agile Development 2.0 - Plan - Discover Agile Development 2.0 - Plan - Import Agile Development 2.0 - Plan - Notification Azure DevOps Azure DevOps - Plan - Connect Azure DevOps - Plan - Discover Azure DevOps - Plan - Notification Azure DevOps - Code - Discover Azure DevOps - Code - Notification Azure DevOps - Orchestration - Discover Azure DevOps - Orchestration - Notification Bitbucket Bitbucket - Code - Connect Bitbucket - Code - Discover Bitbucket - Code - Import Bitbucket - Code - Notification GitHub GitHub - Code - Connect GitHub - Code - Discover GitHub - Code - Import GitHub - Code - Notification GitHub Enterprise GitHub - Code - Connect GitHub - Code - Discover GitHub - Code - Import GitHub - Code - Notification GitLab GitLab - Code - Connect GitLab - Code - Discover GitLab - Code - Notification GitLab - Orchestration - Notification Jenkins Jenkins - Orchestration - Connect Jenkins - Orchestration - Discover Jenkins - Orchestration - Import Jenkins - Orchestration - Notification Jira Jira - Plan - Connect Jira - Plan - Discover Jira - Plan - Import Jira - Plan - Notification

Test tools

Starting with version 1.15, these test types are supported.

Unit (JUnit)
Functional (Integration, Regression, Smoke, System, User Acceptance)
Performance (Load)

Use the DevOps - POST /devops/tool/{capability} endpoint of the DevOps API to integrate your test tool.

Table 1. Test tool mappings
Tool Integration	Test Type	Test Type Mapping
Azure DevOps Jenkins	Unit: JUnit Functional: Integration Regression Smoke System User Acceptance Performance: Load	Azure DevOps - JUnit Jenkins - JUnit

The default test type is JUnit. You can change the default test type by modifying the [sn_devops.default_test_type] DevOps property.

View summary results:

DevOps > Test Results module.
DevOps change request - Test Results related list.
DevOps Pipeline UI - Quality tile.

Tool capability actions

Starting with version 1.9, Connect action:
When connecting, the subflow for the specific tool is called and the connection state is updated. The connection status message is shown on the form.
See Connect capability subflow for more details.
Starting with version 1.9, Discover action:
When discovering, an import request record is created and the subflow for the specific tool is called (as defined in the Integration Capability record). Detail and Status fields in the Import Request record are updated with the number of items discovered, updated, and failed.
The transformed payload consists of an array of objects as a JSON string. Elements vary depending on the tool type (planning, coding, or orchestration).
See Discover capability subflow for more details.
Note: Pagination is not supported in the Discover action for user-created integrations.
Starting with version 1.12, Import action:
Import action does not support historical import functionality.
Starting with version 1.12, Lookup action:
Lookup master flow is provided to support artifact tool type in a subflow created by your integration developer.
Notification (webhook) action:
The source tool is configured manually (by your integration developer) to send raw data to the ServiceNow instance. The raw payload is then transformed into a standard JSON object using a subflow.
See the Notification capability subflow and the DevOps - POST /devops/tool/{capability} endpoint of the DevOps API for more details.

Note: Starting with version 1.11, if a subflow is not specified, default handling of notifications occurs (original payload is automatically copied to transformed payload).
This behavior is useful when the transactional data of the tool is supported by ServiceNow DevOps as is.
See the expected standard payloads in the Notification capability subflow for more details.

DevOps integration configuration overview

Tool integration configuration can be completed by your integration developer and your DevOps admin.

Integration developer

Create a tool integration record in DevOps to define the tool you are integrating (source tool).
Create an API manager in DevOps for the tool integration.
Create a Flow Designer subflow to collect and transform data from the tool you are integrating (source tool).
Create a tool capability mapping record in DevOps to map the tool integration record to the tool type capability.
Note: Notifications (webhook) capability is supported. Starting with version 1.9, connect and discover capabilities are also supported.
Create an integration capability record in DevOps to specify the action for the tool type capability.

DevOps admin

Create a (planning, coding, or orchestration) tool record in DevOps to connect to the tool you are integrating (source tool).
Note: The tool integration record must be specified in the Tool field of the tool record.
Configure the source tool with the webhook and credentials.

Inbound event

An inbound event serves as a staging area for the notifications flow that supports reprocessing of failed payloads. Meaning, a record in an error state from a failed integration or transformation can be retried.

If an Inbound Event record is in the Error state, the flow was not able to insert the record successfully into the core DevOps tables.

Common errors can be resolved with these actions.

Table 2. Inbound event error states
Error	Action
Missing required fields	The transformed payload does not match the standard payload. Refer to the standard and JSON payloads provided.
Repository not marked for tracking	The commit cannot be inserted. The DevOps admin needs to track the repository.
[Subflow] has not been published within application scope [app_scope]	The subflow is created but not published yet.
Timeout exception	The subflow takes more time than the value set in the property: com.glide.hub.flow_api.default_execution_time See FlowAPI - executeSubflowQuick(String name, Map inputs, Number timeout) for more details. Note: Starting with version 1.10, the execution of the subflow exceeds the value set in the Timeout field in the Integration Capability record.
Did not find a matching subflow for notification capability and [tool_integration_sys_id] tool integration	The flow was not able to find the matching subflow. Verify the integration setup procedure.

Note: An inbound event record is not created when any of the following conditions occur:

Source tool has not passed the tool ID as a query parameter.
Source tool has passed on a tool ID, but there is no matching tool ID in the instance.

Previous topic

Next topic

Send feedback

Release version

User-created DevOps integrations

User-created integrations are for integrating additional planning, coding, orchestration, and test tools not included in the integrations provided with the DevOps application.

Note: User-created integrations for test tools are not supported.

Tool integrations provided with the DevOps application:

Planning (Azure DevOps Boards, Jira ver 7.x and 8.x, ServiceNow Agile Development ver 2.x)
Coding (Azure DevOps Repos, Bitbucket Server/Enterprise ver 5.10.0, GitHub ver 2.x, GitHub Enterprise ver 2.x, GitLab SCM ver 12.8.0)
Orchestration and Test (Azure DevOps Pipelines, Jenkins ver 2.138, GitLab CI/CD ver 12.8.0 basic CI pipelines)

DevOps integration objects

Starting with version 1.12, DevOps tool integration consists of these objects.

A tool can be mapped to multiple capabilities.


Tool Integration	Tool Type Capability	Tool Capability Mapping
Agile Development 2.0 Azure DevOps Bitbucket GitHub GitHub Enterprise GitLab Jenkins Jira	Plan Code Orchestration Artifact Test	Plan Agile Development 2.0 - Plan Azure DevOps - Plan Jira - Plan Code Azure DevOps - Code Bitbucket - Code GitHub - Code GitHub Enterprise - Code GitLab - Code Orchestration Azure DevOps - Orchestration Jenkins - Orchestration GitLab - Orchestration Test Azure DevOps - Test Jenkins - Test

A tool capability mapping can be mapped to multiple actions.


Tool Capability Mapping	Tool Action	Integration Capability
Agile Development 2.0 - Plan Azure DevOps - Plan Azure DevOps - Code Azure DevOps - Orchestration Bitbucket - Code GitHub - Code GitHub Enterprise - Code GitLab - Code GitLab - Orchestration Jenkins - Orchestration Jira - Plan	Connect Discover Import Lookup Notification	Agile Development 2.0 Agile Development 2.0 - Plan - Connect Agile Development 2.0 - Plan - Discover Agile Development 2.0 - Plan - Import Agile Development 2.0 - Plan - Notification Azure DevOps Azure DevOps - Plan - Connect Azure DevOps - Plan - Discover Azure DevOps - Plan - Notification Azure DevOps - Code - Discover Azure DevOps - Code - Notification Azure DevOps - Orchestration - Discover Azure DevOps - Orchestration - Notification Bitbucket Bitbucket - Code - Connect Bitbucket - Code - Discover Bitbucket - Code - Import Bitbucket - Code - Notification GitHub GitHub - Code - Connect GitHub - Code - Discover GitHub - Code - Import GitHub - Code - Notification GitHub Enterprise GitHub - Code - Connect GitHub - Code - Discover GitHub - Code - Import GitHub - Code - Notification GitLab GitLab - Code - Connect GitLab - Code - Discover GitLab - Code - Notification GitLab - Orchestration - Notification Jenkins Jenkins - Orchestration - Connect Jenkins - Orchestration - Discover Jenkins - Orchestration - Import Jenkins - Orchestration - Notification Jira Jira - Plan - Connect Jira - Plan - Discover Jira - Plan - Import Jira - Plan - Notification

Test tools

Starting with version 1.15, these test types are supported.

Unit (JUnit)
Functional (Integration, Regression, Smoke, System, User Acceptance)
Performance (Load)

Use the DevOps - POST /devops/tool/{capability} endpoint of the DevOps API to integrate your test tool.

Table 1. Test tool mappings
Tool Integration	Test Type	Test Type Mapping
Azure DevOps Jenkins	Unit: JUnit Functional: Integration Regression Smoke System User Acceptance Performance: Load	Azure DevOps - JUnit Jenkins - JUnit

The default test type is JUnit. You can change the default test type by modifying the [sn_devops.default_test_type] DevOps property.

View summary results:

DevOps > Test Results module.
DevOps change request - Test Results related list.
DevOps Pipeline UI - Quality tile.

Tool capability actions

Starting with version 1.9, Connect action:
When connecting, the subflow for the specific tool is called and the connection state is updated. The connection status message is shown on the form.
See Connect capability subflow for more details.
Starting with version 1.9, Discover action:
When discovering, an import request record is created and the subflow for the specific tool is called (as defined in the Integration Capability record). Detail and Status fields in the Import Request record are updated with the number of items discovered, updated, and failed.
The transformed payload consists of an array of objects as a JSON string. Elements vary depending on the tool type (planning, coding, or orchestration).
See Discover capability subflow for more details.
Note: Pagination is not supported in the Discover action for user-created integrations.
Starting with version 1.12, Import action:
Import action does not support historical import functionality.
Starting with version 1.12, Lookup action:
Lookup master flow is provided to support artifact tool type in a subflow created by your integration developer.
Notification (webhook) action:
The source tool is configured manually (by your integration developer) to send raw data to the ServiceNow instance. The raw payload is then transformed into a standard JSON object using a subflow.
See the Notification capability subflow and the DevOps - POST /devops/tool/{capability} endpoint of the DevOps API for more details.

Note: Starting with version 1.11, if a subflow is not specified, default handling of notifications occurs (original payload is automatically copied to transformed payload).
This behavior is useful when the transactional data of the tool is supported by ServiceNow DevOps as is.
See the expected standard payloads in the Notification capability subflow for more details.

DevOps integration configuration overview

Tool integration configuration can be completed by your integration developer and your DevOps admin.

Integration developer

Create a tool integration record in DevOps to define the tool you are integrating (source tool).
Create an API manager in DevOps for the tool integration.
Create a Flow Designer subflow to collect and transform data from the tool you are integrating (source tool).
Create a tool capability mapping record in DevOps to map the tool integration record to the tool type capability.
Note: Notifications (webhook) capability is supported. Starting with version 1.9, connect and discover capabilities are also supported.
Create an integration capability record in DevOps to specify the action for the tool type capability.

DevOps admin

Create a (planning, coding, or orchestration) tool record in DevOps to connect to the tool you are integrating (source tool).
Note: The tool integration record must be specified in the Tool field of the tool record.
Configure the source tool with the webhook and credentials.

Inbound event

If an Inbound Event record is in the Error state, the flow was not able to insert the record successfully into the core DevOps tables.

Common errors can be resolved with these actions.

Table 2. Inbound event error states
Error	Action
Missing required fields	The transformed payload does not match the standard payload. Refer to the standard and JSON payloads provided.
Repository not marked for tracking	The commit cannot be inserted. The DevOps admin needs to track the repository.
[Subflow] has not been published within application scope [app_scope]	The subflow is created but not published yet.
Timeout exception	The subflow takes more time than the value set in the property: com.glide.hub.flow_api.default_execution_time See FlowAPI - executeSubflowQuick(String name, Map inputs, Number timeout) for more details. Note: Starting with version 1.10, the execution of the subflow exceeds the value set in the Timeout field in the Integration Capability record.
Did not find a matching subflow for notification capability and [tool_integration_sys_id] tool integration	The flow was not able to find the matching subflow. Verify the integration setup procedure.

Note: An inbound event record is not created when any of the following conditions occur:

Source tool has not passed the tool ID as a query parameter.
Source tool has passed on a tool ID, but there is no matching tool ID in the instance.

How search works:

Topics are ranked in search results by how closely they match your search terms

User-created DevOps integrations

User-created DevOps integrations

DevOps integration objects

Test tools

Tool capability actions

DevOps integration configuration overview

Inbound event

On this page

User-created DevOps integrations

User-created DevOps integrations

DevOps integration objects

Test tools

Tool capability actions

DevOps integration configuration overview

Inbound event

Log in to personalize your search results and subscribe to topics