Change request creation with DevOps data retrieval errors
Summarize
Summary of Change request creation with DevOps data retrieval errors
This feature allows ServiceNow customers to create change requests even if there are errors retrieving DevOps data during pipeline runs for supported tools including Azure DevOps, GitHub Actions, GitLab, Jenkins, and Harness pipelines. This capability is controlled by theEnable change request creation even with errors in DevOps data retrievalproperty, which when enabled, ensures change requests are created with whatever DevOps data is available, while notifying users of any retrieval errors.
Show less
Key Features
- Change Request Creation with Partial Data: When enabled, change requests are created despite errors in retrieving work items, commits, test summaries, or security summaries. Errors are logged in the third-party console, change worknotes, and step execution comments.
- Approval Process Adjustments: Change requests with partial data trigger manual approval only, allowing approvers to verify the available DevOps data before approving or rejecting.
- Pipeline UI Indication: Errors during pipeline stages are visually highlighted in yellow on the pipeline UI to indicate where data retrieval problems occurred.
- Callback Timeout Handling: Pipelines wait for inbound event processing until the timeout set by the
sndevops.changerequestcallbacktimeoutproperty (default 120 minutes). After timeout, the pipeline aborts and logs the error. - Integration Considerations for Custom Actions: For GitHub, GitLab, and Harness custom change automation actions, polling intervals must be configured to synchronize change status between ServiceNow and external pipelines. If step notifications fail to reach ServiceNow within the interval and timeout, pipelines may terminate without ServiceNow notifications.
- Upgrade Behavior: After upgrading, the property defaults to false, maintaining the existing behavior where pipelines abort on any data retrieval error unless the property is explicitly enabled.
Practical Impact and Usage
Enabling this property helps maintain continuous pipeline execution by preventing aborts due to DevOps data retrieval errors, thereby supporting automatic change creation with partial data. This improves visibility for change approvers and development teams by ensuring change requests are generated with available DevOps evidence while clearly documenting missing or errored data.
Limitations
If the property is enabled and an Azure DevOps artifact package step fails, the change request will still be created without the artifact data, but no error notification is recorded in worknotes, step execution comments, or the Azure DevOps console.
Create change requests even with errors in DevOps data retrieval.
Change request creation overview
You can create a change request with or without errors in DevOps data retrieval. This functionality can be controlled by the Enable change request creation even with errors in DevOps data retrieval property. When the Enable change request creation even with errors in DevOps data retrieval property is enabled, and an error occurs in retrieving DevOps data like work items, commits, test summaries, or security summaries, the corresponding change request is still created. The data that can be retrieved will still be associated with the change request. For the data that can’t be retrieved, the reason for the error will be notified to the user in the third-party console, and the same information will also be added in the Change Comments field in the Step Execution record and the change Worknotes.
If the Enable change request creation even with errors in DevOps data retrieval property isn’t enabled, a change request is created only when there’s no error in any step of a pipeline run. When an error occurs, the pipeline is aborted and the reason for the error is added in the inbound event's Processing details field, and the same is notified to the user in the third-party console.
For more information, see DevOps Change Velocity properties.
Approval for change requests with DevOps data retrieval errors
For change requests created with DevOps data retrieval errors, the is_change_with_partial_data policy input is set to True for all the change approval policies. Only a manual change approval decision is applied to such changes so that you can approve or reject the change after manually verifying the DevOps data in it. In the DevOps Gather Change Policy Data subflow, the Is change with partial data action determines whether a change is created with DevOps data retrieval errors or not.
Pipeline UI for change requests with DevOps data retrieval errors
When a change request gets created with DevOps data retrieval errors, the card specifying the stage where the error occurred will be displayed in the Yellow color.
Callback timeout
If an inbound event goes into the waiting state during a pipeline run, the system tries to process the change until the timeout value in the sn_devops.change _request_callback_timeout property is exceeded, after that the pipeline is aborted. The reason for the error is displayed in your third-party tool's console logs. When a pipeline is canceled because of callback timeout, the same information is added in the callback record of the corresponding step execution. You can contact your DevOps admin to increase the timeout value in the sn_devops.change_request_callback_timeout property. The default value of this property is 120 minutes, and the minimum value is 60 minutes. For more information, see DevOps Change Velocity properties.
Upgrade
After you upgrade, the property will be set to false by default. Your current change process will function as is, but the only difference you’ll see is that, when an error occurs in retrieving DevOps data the pipeline is aborted (instead of waiting indefinitely) and the reason for the error is added in the inbound event Processing details field, and the same is notified to the user in the third-party console. If you want to create change requests with errors in retrieving DevOps data and also not fail your pipeline, you can enable the Enable change request creation even with errors in DevOps data retrieval property. This provides value to your change approvers and AppDev teams by getting the changes created automatically with DevOps evidence that is gathered and appropriately notified in the change request work notes and third-party console logs with errors or data that may be missing.
Limitation
If the Enable change request creation even with errors in DevOps data retrieval property is enabled, and the ADO artifact package step in your pipeline results in error, the change will be created without ADO artifacts associated with it, but the corresponding error will not be notified in Worknotes, or Step Execution change comments, or in the ADO console log.