Product documentation Docs
    • English
    • Deutsch
    • 日本語
    • 한국어
    • Français
  • More Sites
    • Now Community
    • Developer Site
    • Knowledge Base
    • Product Information
    • ServiceNow.com
    • Training
    • Customer Success Center
    • ServiceNow Support Videos
  • Log in

Product documentation

  • Home
How search works:
  • Punctuation and capital letters are ignored
  • Special characters like underscores (_) are removed
  • Known synonyms are applied
  • The most relevant topics (based on weighting and matching to search terms) are listed first in search results
Topics are ranked in search results by how closely they match your search terms
  • A match on the entire phrase you typed
  • A match on part of the phrase you typed
  • A match on ALL of the terms in the phrase you typed
  • A match on ANY of the terms in the phrase you typed

Note: Matches in titles are always highly ranked.

  • Release version
    Table of Contents
    • DevOps
Table of Contents
Choose your release version
    Home Orlando DevOps DevOps DevOps DevOps reference DevOps record deletion cascade

    DevOps record deletion cascade

    • Save as PDF Selected topic Topic & subtopics All topics in contents
    • Unsubscribe Log in to subscribe to topics and get notified when content changes.
    • Share this page

    DevOps record deletion cascade

    Starting with version 1.21, cascade record deletion is implemented to delete all dependent lower level DevOps records whenever a parent or higher level DevOps entity is deleted.

    For example, when a Plan record is deleted, all dependent Work Item, Plan Version, and many-to-many relation (like App to Plan, and Work Item to Plan Version) records are deleted.

    DevOps cascade deletion is implemented for these tables.

    • Pipeline, Pipeline Execution, Step, Orchestration Task, Task Execution
    • Repository, Commit, Branch, Tag
    • Plan, Work item, Plan Version
    • DevOps Tool, Artifact Repository, Artifact, Test Summary / Performance test summary

    Delete action on a DevOps form

    A user with the sn_devops.admin role can delete a DevOps record, but only if it meets the defined ACL criteria.

    Note: To see the Delete button on a form, you must have the sn_devops.admin role, and the current record must meet the criteria defined in the scripted ACL.
    Entity Scripted ACL criteria
    Pipeline A Pipeline record can be deleted only if no other pipeline executions from other pipelines are dependent on the artifact versions generated by the pipeline executions of this pipeline.
    Pipeline Execution A Pipeline Execution record can be deleted only if no other pipeline executions are dependent on the artifact versions generated by this pipeline execution.
    Task Execution
    A Task Execution record can be deleted if ALL of these conditions are met.
    • There are no step executions referencing it.
    • There are no downstream task executions referencing it.
    • There are no pipeline executions dependent on the artifact versions built by this task execution.
    Step A Step record can be deleted only if there are no orchestration tasks or step executions referencing this step.
    Orchestration Task

    If the orchestration task has a step associated, it can be deleted only if there are no task executions referencing this orchestration task.

    If the orchestration task does not have a step associated (example Jenkins freestyle job), it can be deleted only if no other pipeline executions are dependent on the artifact versions generated by the task executions of this orchestration task.

    Repository

    A Repository record can be deleted only if none of the commits of this repository are associated to the artifact versions (Artifact Version to Commit table) or task executions (Run Commit table).

    Therefore, before cleaning up the repository, delete the dependent pipeline entities.

    Branch A Branch record can be deleted only if there are no commits associated to it in the Branch To Commit table.
    Tag A Tag record cannot be deleted by a sn_devops.admin.
    Commit
    A Commit record can be deleted if ALL of these conditions are met.
    • The commit is not associated to the artifact version (Artifact Version to Commit table).
    • The commit is not associated to task executions (Run Commit table).
    • The commit is not being referenced by other commits as a revert commit.
    Plan A Plan record can be deleted only if none of the work items of this plan are associated or referenced by any commits.
    Work Item
    A Work Item record can be deleted if ALL of these conditions are met.
    • The work item is not being referenced by another work item as parent.
    • There are no commits referencing or associated to this work item.
    Plan Version A Plan Version record can be deleted only if there are no work items associated to it in the Work Item To Plan Version table.
    Test Summary / Performance Test Summary A Test Summary record can be deleted only if it doesn’t have an associated related record (Artifact version/Package/Task Execution) in the Test Summary Relations table.
    Artifact An Artifact Record can be deleted only if all the artifact versions belonging to it are deletable.
    Artifact Repository An Artifact Repository record can be deleted only if all the artifacts belonging to it are deletable.
    Artifact Version An Artifact Version record can be deleted only if it's built by task execution field is empty.
    Artifact Staged Request An Artifact Staged Request record can be deleted when it is either an orphaned record, or the state is Processed / Error.
    Package A Package record can be deleted if ALL of these conditions are met.
    • There are no pipeline executions referenced to it.
    • The built by task execution value on the Package record is null.
    DevOps Tool A DevOps Tool record cannot be deleted by a sn_devops.admin.

    Build Test Summary

    Build Test Result

    Commit Details

    Event

    Inbound Event

    These entities cannot be deleted by a sn_devops.admin.

    DevOps record delete cascade

    Deleting a record in a parent table cascade deletes all the child records in the hierarchy.

    Parent record being deleted Cascade deleted child records
    Pipeline
    Step
    • Orchestration Task
    Pipeline Execution
    • Step Execution
    • Callback
    • Task Execution
      • Package
      • Run Commit
      • Test Summary Relations
      • Build Test Summary
        • Build Test Result
      • Artifact Version
        • Artifact Staged Request
        • Artifact Version To Commit
        • Artifact Version To Package
    Pipeline Execution

    Step Execution

    Callback

    Task Execution
    • Package
    • Run Commit
    • Test Summary Relations
    • Build Test Summary
      • Build Test Result
    • Artifact Version
      • Artifact Staged Request
      • Artifact Version To Commit
      • Artifact Version To Package
    Step

    None.

    A Step record can be deleted only if there are no Orchestration Task or Step Execution records associated to it.

    Orchestration Task
    Task Execution
    • Package
    • Run Commit
    • Test Summary Relations
    • Build Test Summary
      • Build Test Result
    • Artifact Version
      • Artifact Staged Request
      • Artifact Version to Commit
      • Artifact Version to Package
    Repository

    Tag

    Branch
    • Branch to Commit
    Commit
    • Commit Details
    • Branch to Commit
    • Tag
    Branch Branch to Commit
    Tag No dependent child records.
    Commit

    Commit Details

    Branch to Commit

    Tag

    Plan

    Work Item

    App to Plan

    Plan Version
    • Work Item to Plan Version
    Work Item Work Item to Plan Version
    Plan Version Work Item to Plan Version
    Test Summary / Performance Test Summary Test Summary Relations
    Artifact
    Artifact Version
    • Artifact Staged Request
    • Artifact Version to Commit
    • Artifact Version to Package
    Artifact Repository
    Artifact
    • Artifact Version
      • Artifact Staged Request
      • Artifact Version to Commit
      • Artifact Version to Package
    DevOps Tool

    Event

    Inbound Event

    Test Summary / Performance Test Summary
    • Test Summary Relations
    Plan
    • Work Item
    • App to Plan
    • Plan Version
      • Work Item to Plan Version
    Artifact Repository
    • Artifact
      • Artifact Version
        • Artifact Staged Request
        • Artifact Version to Commit
        • Artifact Version to Package
    Repository
    • Tag
    • Branch
      • Branch to Commit
    • Commit
      • Commit Details
      • Branch to Commit
      • Tag
    Pipeline
    • Step
      • Orchestration Task
    • Pipeline Execution
      • Step Execution
      • Callback
      • Task Execution
        • Package
        • Run Commit
        • Test Summary Relations
        • Build Test Summary
          • Build Test Result
        • Artifact Version
          • Artifact Staged Request
          • Artifact Version To Commit
          • Artifact Version To Package

    DevOps record delete cascade exceptions

    These records are always deleted in the foreground.

    Parent record being deleted Cascade deleted child records
    Artifact Version
    These records are deleted along with Artifact Version.
    • Artifact Staged Request
      Note: For existing releases upgraded to version 1.21, Artifact Staged Request records are not deleted, and the Artifact Version reference is set to empty.
    • Artifact Version To Commit
    • Artifact Version to Package
    Build Test Summary
    These records are deleted along with Build Test Summary.
    • Build Test Result
      Note: For existing releases upgraded to version 1.21, you must delete any dependent Build Test Result records before deleting the Build Test Summary record.
    Package
    These records are deleted along with Package.
    • Artifact Staged Request
      Note: For existing releases upgraded to version 1.21, Artifact Staged Request records are not deleted, and the Package reference is set to empty.
    • Artifact Version to Package

    Foreground deletion threshold property

    Deletion of DevOps records occurs in the foreground (synchronously) by default. Meaning, other UI actions cannot be performed during synchronous deletion. Since the deletion of a parent record can result in the deletion of multiple child records, you can set a threshold value so the remaining records are deleted in the background.

    Note: Artifact Version, Build Test Summary, and Package records are always deleted in the foreground.

    To set the DevOps Cascade delete threshold property, navigate to DevOps > Administration > Properties. Define the total number of records that can be cascade deleted in the foreground, after which the remaining records are deleted in the background. Default is 1000.

    Note: The records of tables in a hierarchy are deleted in a bottom-up manner. For example, it may be possible that even after triggering the delete action on a Repository record, it will still be available for read, write, and update in the system until deletion is complete.

    DevOps record deletions do not trigger any business rules or workflows.

    DevOps record deletion UI

    Cascade delete of a DevOps record triggers multiple confirmation approvals.

    DevOps delete record
    DevOps delete record warning
    DevOps delete record cascade

    Tags:

    Feedback
    On this page

    Previous topic

    Next topic

    • Contact Us
    • Careers
    • Terms of Use
    • Privacy Statement
    • Sitemap
    • © ServiceNow. All rights reserved.

    Release version
    Choose your release version

      DevOps record deletion cascade

      • Save as PDF Selected topic Topic & subtopics All topics in contents
      • Unsubscribe Log in to subscribe to topics and get notified when content changes.
      • Share this page

      DevOps record deletion cascade

      Starting with version 1.21, cascade record deletion is implemented to delete all dependent lower level DevOps records whenever a parent or higher level DevOps entity is deleted.

      For example, when a Plan record is deleted, all dependent Work Item, Plan Version, and many-to-many relation (like App to Plan, and Work Item to Plan Version) records are deleted.

      DevOps cascade deletion is implemented for these tables.

      • Pipeline, Pipeline Execution, Step, Orchestration Task, Task Execution
      • Repository, Commit, Branch, Tag
      • Plan, Work item, Plan Version
      • DevOps Tool, Artifact Repository, Artifact, Test Summary / Performance test summary

      Delete action on a DevOps form

      A user with the sn_devops.admin role can delete a DevOps record, but only if it meets the defined ACL criteria.

      Note: To see the Delete button on a form, you must have the sn_devops.admin role, and the current record must meet the criteria defined in the scripted ACL.
      Entity Scripted ACL criteria
      Pipeline A Pipeline record can be deleted only if no other pipeline executions from other pipelines are dependent on the artifact versions generated by the pipeline executions of this pipeline.
      Pipeline Execution A Pipeline Execution record can be deleted only if no other pipeline executions are dependent on the artifact versions generated by this pipeline execution.
      Task Execution
      A Task Execution record can be deleted if ALL of these conditions are met.
      • There are no step executions referencing it.
      • There are no downstream task executions referencing it.
      • There are no pipeline executions dependent on the artifact versions built by this task execution.
      Step A Step record can be deleted only if there are no orchestration tasks or step executions referencing this step.
      Orchestration Task

      If the orchestration task has a step associated, it can be deleted only if there are no task executions referencing this orchestration task.

      If the orchestration task does not have a step associated (example Jenkins freestyle job), it can be deleted only if no other pipeline executions are dependent on the artifact versions generated by the task executions of this orchestration task.

      Repository

      A Repository record can be deleted only if none of the commits of this repository are associated to the artifact versions (Artifact Version to Commit table) or task executions (Run Commit table).

      Therefore, before cleaning up the repository, delete the dependent pipeline entities.

      Branch A Branch record can be deleted only if there are no commits associated to it in the Branch To Commit table.
      Tag A Tag record cannot be deleted by a sn_devops.admin.
      Commit
      A Commit record can be deleted if ALL of these conditions are met.
      • The commit is not associated to the artifact version (Artifact Version to Commit table).
      • The commit is not associated to task executions (Run Commit table).
      • The commit is not being referenced by other commits as a revert commit.
      Plan A Plan record can be deleted only if none of the work items of this plan are associated or referenced by any commits.
      Work Item
      A Work Item record can be deleted if ALL of these conditions are met.
      • The work item is not being referenced by another work item as parent.
      • There are no commits referencing or associated to this work item.
      Plan Version A Plan Version record can be deleted only if there are no work items associated to it in the Work Item To Plan Version table.
      Test Summary / Performance Test Summary A Test Summary record can be deleted only if it doesn’t have an associated related record (Artifact version/Package/Task Execution) in the Test Summary Relations table.
      Artifact An Artifact Record can be deleted only if all the artifact versions belonging to it are deletable.
      Artifact Repository An Artifact Repository record can be deleted only if all the artifacts belonging to it are deletable.
      Artifact Version An Artifact Version record can be deleted only if it's built by task execution field is empty.
      Artifact Staged Request An Artifact Staged Request record can be deleted when it is either an orphaned record, or the state is Processed / Error.
      Package A Package record can be deleted if ALL of these conditions are met.
      • There are no pipeline executions referenced to it.
      • The built by task execution value on the Package record is null.
      DevOps Tool A DevOps Tool record cannot be deleted by a sn_devops.admin.

      Build Test Summary

      Build Test Result

      Commit Details

      Event

      Inbound Event

      These entities cannot be deleted by a sn_devops.admin.

      DevOps record delete cascade

      Deleting a record in a parent table cascade deletes all the child records in the hierarchy.

      Parent record being deleted Cascade deleted child records
      Pipeline
      Step
      • Orchestration Task
      Pipeline Execution
      • Step Execution
      • Callback
      • Task Execution
        • Package
        • Run Commit
        • Test Summary Relations
        • Build Test Summary
          • Build Test Result
        • Artifact Version
          • Artifact Staged Request
          • Artifact Version To Commit
          • Artifact Version To Package
      Pipeline Execution

      Step Execution

      Callback

      Task Execution
      • Package
      • Run Commit
      • Test Summary Relations
      • Build Test Summary
        • Build Test Result
      • Artifact Version
        • Artifact Staged Request
        • Artifact Version To Commit
        • Artifact Version To Package
      Step

      None.

      A Step record can be deleted only if there are no Orchestration Task or Step Execution records associated to it.

      Orchestration Task
      Task Execution
      • Package
      • Run Commit
      • Test Summary Relations
      • Build Test Summary
        • Build Test Result
      • Artifact Version
        • Artifact Staged Request
        • Artifact Version to Commit
        • Artifact Version to Package
      Repository

      Tag

      Branch
      • Branch to Commit
      Commit
      • Commit Details
      • Branch to Commit
      • Tag
      Branch Branch to Commit
      Tag No dependent child records.
      Commit

      Commit Details

      Branch to Commit

      Tag

      Plan

      Work Item

      App to Plan

      Plan Version
      • Work Item to Plan Version
      Work Item Work Item to Plan Version
      Plan Version Work Item to Plan Version
      Test Summary / Performance Test Summary Test Summary Relations
      Artifact
      Artifact Version
      • Artifact Staged Request
      • Artifact Version to Commit
      • Artifact Version to Package
      Artifact Repository
      Artifact
      • Artifact Version
        • Artifact Staged Request
        • Artifact Version to Commit
        • Artifact Version to Package
      DevOps Tool

      Event

      Inbound Event

      Test Summary / Performance Test Summary
      • Test Summary Relations
      Plan
      • Work Item
      • App to Plan
      • Plan Version
        • Work Item to Plan Version
      Artifact Repository
      • Artifact
        • Artifact Version
          • Artifact Staged Request
          • Artifact Version to Commit
          • Artifact Version to Package
      Repository
      • Tag
      • Branch
        • Branch to Commit
      • Commit
        • Commit Details
        • Branch to Commit
        • Tag
      Pipeline
      • Step
        • Orchestration Task
      • Pipeline Execution
        • Step Execution
        • Callback
        • Task Execution
          • Package
          • Run Commit
          • Test Summary Relations
          • Build Test Summary
            • Build Test Result
          • Artifact Version
            • Artifact Staged Request
            • Artifact Version To Commit
            • Artifact Version To Package

      DevOps record delete cascade exceptions

      These records are always deleted in the foreground.

      Parent record being deleted Cascade deleted child records
      Artifact Version
      These records are deleted along with Artifact Version.
      • Artifact Staged Request
        Note: For existing releases upgraded to version 1.21, Artifact Staged Request records are not deleted, and the Artifact Version reference is set to empty.
      • Artifact Version To Commit
      • Artifact Version to Package
      Build Test Summary
      These records are deleted along with Build Test Summary.
      • Build Test Result
        Note: For existing releases upgraded to version 1.21, you must delete any dependent Build Test Result records before deleting the Build Test Summary record.
      Package
      These records are deleted along with Package.
      • Artifact Staged Request
        Note: For existing releases upgraded to version 1.21, Artifact Staged Request records are not deleted, and the Package reference is set to empty.
      • Artifact Version to Package

      Foreground deletion threshold property

      Deletion of DevOps records occurs in the foreground (synchronously) by default. Meaning, other UI actions cannot be performed during synchronous deletion. Since the deletion of a parent record can result in the deletion of multiple child records, you can set a threshold value so the remaining records are deleted in the background.

      Note: Artifact Version, Build Test Summary, and Package records are always deleted in the foreground.

      To set the DevOps Cascade delete threshold property, navigate to DevOps > Administration > Properties. Define the total number of records that can be cascade deleted in the foreground, after which the remaining records are deleted in the background. Default is 1000.

      Note: The records of tables in a hierarchy are deleted in a bottom-up manner. For example, it may be possible that even after triggering the delete action on a Repository record, it will still be available for read, write, and update in the system until deletion is complete.

      DevOps record deletions do not trigger any business rules or workflows.

      DevOps record deletion UI

      Cascade delete of a DevOps record triggers multiple confirmation approvals.

      DevOps delete record
      DevOps delete record warning
      DevOps delete record cascade

      Tags:

      Feedback

          Share this page

          Got it! Feel free to add a comment
          To share your product suggestions, visit the Idea Portal.
          Please let us know how to improve this content

          Check any that apply

          To share your product suggestions, visit the Idea Portal.
          Confirm

          We were unable to find "Coaching" in Jakarta. Would you like to search instead?

          No Yes
          • Contact Us
          • Careers
          • Terms of Use
          • Privacy Statement
          • Sitemap
          • © ServiceNow. All rights reserved.

          Subscribe Subscribed Unsubscribe Last updated: Tags: January February March April May June July August September October November December No Results Found Versions Search preferences successfully updated My release version successfully updated My release version successfully deleted An error has occurred. Please try again later. You have been unsubscribed from all topics. You are now subscribed to and will receive notifications if any changes are made to this page. You have been unsubscribed from this content Thank you for your feedback. Form temporarily unavailable. Please try again or contact  docfeedback@servicenow.com  to submit your comments. The topic you requested does not exist in the release. You were redirected to a related topic instead. The available release versions for this topic are listed There is no specific version for this documentation. Explore products Click to go to the page. Release notes and upgrades Click to open the dropdown menu. Delete Remove No selected version Reset This field is required You are already subscribed to this topic Attach screenshot The file you uploaded exceeds the allowed file size of 20MB. Please try again with a smaller file. Please complete the reCAPTCHA step to attach a screenshot
          Log in to personalize your search results and subscribe to topics
          No, thanks Login