The following plugin provides functionality available through Pipeline-compatible steps. Read more about how to integrate steps into your Pipeline in the Steps section of the Pipeline Syntax page.

For a list of other such plugins, see the Pipeline Steps Reference page.

ServiceNow CI/CD Plugin

snActivatePlugin: SN: Activate plugin

  • credentialsId (optional)
    User name and password defined in global credentials (credentials ID is required here).
    This field cannot be empty. It doesn't use global settings from ServiceNow Parameters.
    • Type: String
  • apiVersion (optional)
    Optional. Version of the endpoint to access. For example, v1 or v2. Only specify this value to use an endpoint version other than the latest.
    • Type: String
  • pluginId (optional)
    Unique identifier of the plugin. You can locate this identifier on the Plugins page within the card of the desired plugin; identified with the name "ID".
    • Type: String
  • url (optional)
    ServiceNow instance url. This field cannot be empty. It doesn't use global settings from ServiceNow Parameters.
    • Type: String

snApplyChanges: SN: Apply changes

  • credentialsId (optional)
    User name and password defined in global credentials (credentials ID is required here) used for the instance (usually where the application will be published).
    • Type: String
  • apiVersion (optional)
    Optional. Version of the endpoint to access. For example, v1 or v2. Only specify this value to use an endpoint version other than the latest.
    • Type: String
  • appScope (optional)
    Required if application system ID is not specified. The scope name of the application for which to apply the changes, such as x_aah_custom_app. You can locate this value in the scope field in the Custom Application [sys_app] table.
    • Type: String
  • appSysId (optional)
    Required if application scope is not specified. The system id of the application for which to apply the changes. You can locate this value in the Sys ID field in the Custom Application [sys_app] table.
    • Type: String
  • branchName (optional)
    Name of the branch in the source control system from which to acquire the application.
    • Type: String
  • url (optional)
    ServiceNow instance url (usually where the application will be published to).
    • Type: String

snInstallApp: SN: Install application

  • credentialsId (optional)
    User name and password defined in global credentials (credentials ID is required here) used for the instance where the application will be installed.
    • Type: String
  • apiVersion (optional)
    Optional. Version of the endpoint to access. For example, v1 or v2. Only specify this value to use an endpoint version other than the latest.
    • Type: String
  • appScope (optional)
    Required if application system ID is not specified. The scope name of the application for which to apply the changes, such as x_aah_custom_app. You can locate this value in the scope field in the Custom Application [sys_app] table.
    • Type: String
  • appSysId (optional)
    Required if application scope is not specified. The system id of the application for which to apply the changes. You can locate this value in the Sys ID field in the Custom Application [sys_app] table.
    • Type: String
  • appVersion (optional)
    Version of the application to install. If empty, the published version will be used.
    • Type: String
  • url (optional)
    ServiceNow instance url where the application will be installed.
    • Type: String

snPublishApp: SN: Publish application

  • credentialsId (optional)
    User name and password defined in global credentials (credentials ID is required here) used for the instance where the application will be published.
    • Type: String
  • apiVersion (optional)
    Optional. Version of the endpoint to access. For example, v1 or v2. Only specify this value to use an endpoint version other than the latest.
    • Type: String
  • appScope (optional)
    Required if application system ID is not specified. The scope name of the application for which to apply the changes, such as x_aah_custom_app. You can locate this value in the scope field in the Custom Application [sys_app] table.
    • Type: String
  • appSysId (optional)
    Required if application scope is not specified. The system id of the application for which to apply the changes. You can locate this value in the Sys ID field in the Custom Application [sys_app] table.
    • Type: String
  • appVersion (optional)
    Version under which to store the application. Provide 2 significant numbers separated by '.' eg. 1.0 (the third number will be automatically added with build number, what gives eg. 1.0.106).
    If the version number is passed, the publish process uses that version and updates the local application version if different. If the version number is not passed, the publish process uses the current version of the local application.
    • Type: String
  • devNotes (optional)
    Developer notes to store with the application.
    • Type: String
  • obtainVersionAutomatically (optional)
    Calculate next application version that will be published. Retrieve it in smart way using API or source control (if SCM is configured for the build). API has the highest priority, then SCM will be used.
    The value from ''Application version'' will be ignored.
    • Type: boolean
  • url (optional)
    ServiceNow instance url where the application will be published to.
    • Type: String

snRollbackApp: SN: Roll back application

  • credentialsId (optional)
    User name and password defined in global credentials (credentials ID is required here) used for the instance where the application is installed.
    • Type: String
  • apiVersion (optional)
    Optional. Version of the endpoint to access. For example, v1 or v2. Only specify this value to use an endpoint version other than the latest.
    • Type: String
  • appScope (optional)
    Required if application system ID is not specified. The scope name of the application for which to apply the changes, such as x_aah_custom_app. You can locate this value in the scope field in the Custom Application [sys_app] table.
    • Type: String
  • appSysId (optional)
    Required if application scope is not specified. The system id of the application for which to apply the changes. You can locate this value in the Sys ID field in the Custom Application [sys_app] table.
    • Type: String
  • rollbackAppVersion (optional)
    Expected rollback version. This version is compared to the version that is included in the last rollback context, if they don't match, the build step fails.
    If empty, installed version from previous step will be taken.
    • Type: String
  • url (optional)
    ServiceNow instance url where the application was installed.
    • Type: String

snRollbackPlugin: SN: Roll back plugin

  • credentialsId (optional)
    User name and password defined in global credentials (credentials ID is required here).
    This field cannot be empty. It doesn't use global settings from ServiceNow Parameters.
    • Type: String
  • apiVersion (optional)
    Optional. Version of the endpoint to access. For example, v1 or v2. Only specify this value to use an endpoint version other than the latest.
    • Type: String
  • pluginId (optional)
    Unique identifier of the plugin. You can locate this identifier on the Plugins page within the card of the desired plugin; identified with the name "ID".
    • Type: String
  • url (optional)
    ServiceNow instance url. This field cannot be empty. It doesn't use global settings from ServiceNow Parameters.
    • Type: String

snRunTestSuite: SN: Run test suite with results

  • credentialsId (optional)
    User name and password defined in global credentials (credentials ID is required here) used for the instance where the application will be installed.
    • Type: String
  • apiVersion (optional)
    Optional. Version of the endpoint to access. For example, v1 or v2. Only specify this value to use an endpoint version other than the latest.
    • Type: String
  • browserName (optional)
    Name of the browser to use to run the client test. This value must match what is specified in the scheduled client test runner. For additional information on scheduled client test runners, see Scheduled Client Test Runners.

    Valid values:

    • Any
    • Chrome
    • Firefox
    • Edge
    • IE
    • Safari
    • Type: String
  • browserVersion (optional)
    Starting value of the version of the browser specified in browser_name to use to run the test. For example, if you enter "9", that would enable all 9.x.x.x versions. This value must match what is specified in the scheduled client test runner.
    • Type: String
  • osName (optional)
    Name of the operating system under which to run the test suite. This value must match what is specified in the scheduled client test runner.
    • Type: String
  • osVersion (optional)
    Starting value of the version of the operating system under which to run the test suite. For example, if you enter "8", that would enable all 8.x.x.x versions. This value must match what is specified in the scheduled client test. runner.
    • Type: String
  • responseBodyFormat (optional)
    • Type: String
  • testSuiteName (optional)
    Required if Test suite sys_id is not specified. The name of the test suite to run. This value is located in the Test [sys_atf_test_suite] table.
    • Type: String
  • testSuiteSysId (optional)
    Required if Test suite name is not specified. The sys_id of the test suite to run. This value is located in the Test [sys_atf_test_suite] table.
    • Type: String
  • url (optional)
    ServiceNow instance url where the application will be installed.
    • Type: String
  • withResults (optional)
    If the checkbox is checked, then results from ServiceNow will be visible in Output Console, together with the link to the visualization on the NOW platform.
    • Type: boolean

Was this page helpful?

Please submit your feedback about this page through this quick form.

Alternatively, if you don't wish to complete the quick form, you can simply indicate if you found this page helpful?

    


See existing feedback here.