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
    • Now Platform capabilities
Table of Contents
Choose your release version
    Home Orlando Now Platform Capabilities Now Platform capabilities Workflow Workflow management Work on workflows

    Work on workflows

    • 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

    Work on workflows

    To complete a workflow, you add workflow activities, validate the workflow, and publish it.

    Add a workflow activity

    Activities determine the functionality of the workflow.

    Before you begin

    Role required: workflow_admin, workflow_creator, or admin

    About this task

    When they are created, all workflows contain Start and End activities.

    For more information, see Workflow activities.

    Procedure

    1. Open a workflow.
    2. Check out the workflow.
    3. Drag a workflow activity from the Activities menu into the workflow body.
    4. Populate the Workflow Activity form that appears.

    Validate a workflow

    You can manually validate a workflow from the Workflow Editor. You can generate a workflow validation report from the Workflow Version form.

    Before you begin

    Role required: workflow_admin, workflow_creator, or admin

    About this task

    Running a workflow on a new node automatically attempts to validate the workflow. If validation is successful, the system updates the workflow version record to indicate the workflow has been validated and marks the record as updated by the user who ran the workflow.

    Procedure

    1. Open the workflow to validate in the Workflow Editor.
      When the workflow is loaded, the workflow validator icon appears in the toolbar.
      Workflow validator icon
    2. Click the validator icon to run a series of validation tests on the current workflow version and generate a report.
      Workflow validation report
    3. Complete the following steps to generate a workflow validation report from the Workflow Version form
      1. Navigate to Workflow > Administration > Workflow Versions, and select a workflow to validate.
      2. Under Related Links, click Validate Workflow.

    Publish a workflow

    When a workflow is complete, publish the workflow so that it is available to all users.

    Before you begin

    Before you publish a workflow, validate it to test it for issues that might cause it to fail, such as missing subflows or disconnected transitions. For more information, see Workflow validation.

    Role required: workflow_admin, workflow_creator, or admin

    About this task

    To publish a workflow:

    Procedure

    1. Navigate to Workflow > Workflow Editor.
    2. Open the workflow that you want to publish.
    3. In the title bar, click the menu icon and select Publish.

    Result

    If you published a new version of workflow, the changes are not applied to running workflow contexts. Any currently running workflow context continues using the workflow version that was available when the workflow started. The next time the workflow runs, it uses the new version.

    Determine whether a workflow can run

    A workflow can run only if a checked out version is available to the user who has it checked out, and a valid, published version is available for all users with permission to run it.

    Before you begin

    Role required: workflow_admin, workflow_creator, or admin

    Procedure

    1. In the navigation filter, enter wf_workflow.list, and then open one of the workflows.
    2. In the Versions related list, check for all of the following conditions:
      1. There is only one workflow version in a state of Checked out and Checked out by.
      2. There is only one version and it is not checked out. This version must be both Active and Published.
        You may need to personalize the list and add the Active column.
      3. If there are multiple versions, only one is Published.
      These checks determine the only two conditions under which a workflow can run:
      • A checked out version of a workflow is available for the user who has it checked out.
      • A valid, published version of a workflow is available for all users who have permission to run the workflow.

      Main flows containing subflows that do not meet one of these two conditions are not permitted to execute against a current record transaction. Instead, a critical log entry detailing the subflow state is added to the Workflow Context record. To enable the workflow to execute on the next appropriate transaction, remove the subflow from the main flow or modify the published and active states of the subflow.

    Edit a published workflow

    You can edit a published workflow after you check it out.

    Before you begin

    Role required: workflow_admin, workflow_creator, workflow_publisher, or admin

    About this task

    Note: You cannot check out or delete workflows that are associated with a read-only application file.

    To check out a workflow:

    Procedure

    1. Navigate to Workflow > Workflow Editor.
    2. Open the workflow that you want to edit.
    3. In the title bar, click the menu icon and select Checkout.

      A new version of the workflow is created and assigned to you.

      If you are in a different domain than the published workflow, the new workflow version is created in your domain.

    What to do next

    After you finish editing the workflow, validate and publish the workflow to make the new version available to other users.

    Copy a workflow between two application scopes

    Application scoping protects applications by identifying and restricting access to application files and data. You can copy a workflow created in one application scope (for example, Test) to another (Production) as needed.

    Before you begin

    Role required: admin

    Procedure

    1. On the Home page, click System Settings icon, located next to the logged in user name.
    2. In the Developer tab, in the Application field, select the application scope (for example, Test) in which you want to operate the Now Platform.
    3. Close the System Settings page.
    4. Navigate to Workflow > Workflow Editor.
    5. Create a workflow in the Workflow Editor. For more details, see Create a workflow.
    6. In the Workflow Editor, click Information icon.
    7. In the Application tab, Application is set to the current application scope selected in System Settings.
    8. In Accessible from, select All application scopes if the workflow is available to all application scopes, or select This application scope only if it is only available to, and accessible in the current application scope only.
      Only those workflows that are accessible from all application scopes can be copied to another application scope.
    9. Go back to the Homepage, click System Settings icon.
    10. In the Developer tab, in the Application field, select the application scope (for example, Production) to which you want to copy the workflow.
    11. Navigate to Workflow > Workflow Editor.
    12. Refresh the page, then open the same workflow you created.
      An Out of scope workflow, workflow belongs to <scope name> scope message appears, where <scope name> is the application scope in which the workflow was originally created.
    13. In the Workflow Editor, click Context menu.
    14. Select Copy.
      The Workflow Name dialog appears:

      Add a name for the workflow copy in the Workflow Name dialog.

      1. In Workflow Name, type the new name for the copied workflow.
      2. Click OK. The system creates a workflow in the current application scope.
    15. In the Workflow Editor, click Information icon.
    16. In the Application tab, Application is set to the current application scope.
    17. In Accessible from, select This application scope only if to make the newly copied workflow a private one that cannot be accessed from outside current scope.
    18. Click Update.

    Result

    A new workflow record is created in the selected application scope and marked as private if designated as one in the Workflow Editor.

    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

      Work on workflows

      • 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

      Work on workflows

      To complete a workflow, you add workflow activities, validate the workflow, and publish it.

      Add a workflow activity

      Activities determine the functionality of the workflow.

      Before you begin

      Role required: workflow_admin, workflow_creator, or admin

      About this task

      When they are created, all workflows contain Start and End activities.

      For more information, see Workflow activities.

      Procedure

      1. Open a workflow.
      2. Check out the workflow.
      3. Drag a workflow activity from the Activities menu into the workflow body.
      4. Populate the Workflow Activity form that appears.

      Validate a workflow

      You can manually validate a workflow from the Workflow Editor. You can generate a workflow validation report from the Workflow Version form.

      Before you begin

      Role required: workflow_admin, workflow_creator, or admin

      About this task

      Running a workflow on a new node automatically attempts to validate the workflow. If validation is successful, the system updates the workflow version record to indicate the workflow has been validated and marks the record as updated by the user who ran the workflow.

      Procedure

      1. Open the workflow to validate in the Workflow Editor.
        When the workflow is loaded, the workflow validator icon appears in the toolbar.
        Workflow validator icon
      2. Click the validator icon to run a series of validation tests on the current workflow version and generate a report.
        Workflow validation report
      3. Complete the following steps to generate a workflow validation report from the Workflow Version form
        1. Navigate to Workflow > Administration > Workflow Versions, and select a workflow to validate.
        2. Under Related Links, click Validate Workflow.

      Publish a workflow

      When a workflow is complete, publish the workflow so that it is available to all users.

      Before you begin

      Before you publish a workflow, validate it to test it for issues that might cause it to fail, such as missing subflows or disconnected transitions. For more information, see Workflow validation.

      Role required: workflow_admin, workflow_creator, or admin

      About this task

      To publish a workflow:

      Procedure

      1. Navigate to Workflow > Workflow Editor.
      2. Open the workflow that you want to publish.
      3. In the title bar, click the menu icon and select Publish.

      Result

      If you published a new version of workflow, the changes are not applied to running workflow contexts. Any currently running workflow context continues using the workflow version that was available when the workflow started. The next time the workflow runs, it uses the new version.

      Determine whether a workflow can run

      A workflow can run only if a checked out version is available to the user who has it checked out, and a valid, published version is available for all users with permission to run it.

      Before you begin

      Role required: workflow_admin, workflow_creator, or admin

      Procedure

      1. In the navigation filter, enter wf_workflow.list, and then open one of the workflows.
      2. In the Versions related list, check for all of the following conditions:
        1. There is only one workflow version in a state of Checked out and Checked out by.
        2. There is only one version and it is not checked out. This version must be both Active and Published.
          You may need to personalize the list and add the Active column.
        3. If there are multiple versions, only one is Published.
        These checks determine the only two conditions under which a workflow can run:
        • A checked out version of a workflow is available for the user who has it checked out.
        • A valid, published version of a workflow is available for all users who have permission to run the workflow.

        Main flows containing subflows that do not meet one of these two conditions are not permitted to execute against a current record transaction. Instead, a critical log entry detailing the subflow state is added to the Workflow Context record. To enable the workflow to execute on the next appropriate transaction, remove the subflow from the main flow or modify the published and active states of the subflow.

      Edit a published workflow

      You can edit a published workflow after you check it out.

      Before you begin

      Role required: workflow_admin, workflow_creator, workflow_publisher, or admin

      About this task

      Note: You cannot check out or delete workflows that are associated with a read-only application file.

      To check out a workflow:

      Procedure

      1. Navigate to Workflow > Workflow Editor.
      2. Open the workflow that you want to edit.
      3. In the title bar, click the menu icon and select Checkout.

        A new version of the workflow is created and assigned to you.

        If you are in a different domain than the published workflow, the new workflow version is created in your domain.

      What to do next

      After you finish editing the workflow, validate and publish the workflow to make the new version available to other users.

      Copy a workflow between two application scopes

      Application scoping protects applications by identifying and restricting access to application files and data. You can copy a workflow created in one application scope (for example, Test) to another (Production) as needed.

      Before you begin

      Role required: admin

      Procedure

      1. On the Home page, click System Settings icon, located next to the logged in user name.
      2. In the Developer tab, in the Application field, select the application scope (for example, Test) in which you want to operate the Now Platform.
      3. Close the System Settings page.
      4. Navigate to Workflow > Workflow Editor.
      5. Create a workflow in the Workflow Editor. For more details, see Create a workflow.
      6. In the Workflow Editor, click Information icon.
      7. In the Application tab, Application is set to the current application scope selected in System Settings.
      8. In Accessible from, select All application scopes if the workflow is available to all application scopes, or select This application scope only if it is only available to, and accessible in the current application scope only.
        Only those workflows that are accessible from all application scopes can be copied to another application scope.
      9. Go back to the Homepage, click System Settings icon.
      10. In the Developer tab, in the Application field, select the application scope (for example, Production) to which you want to copy the workflow.
      11. Navigate to Workflow > Workflow Editor.
      12. Refresh the page, then open the same workflow you created.
        An Out of scope workflow, workflow belongs to <scope name> scope message appears, where <scope name> is the application scope in which the workflow was originally created.
      13. In the Workflow Editor, click Context menu.
      14. Select Copy.
        The Workflow Name dialog appears:

        Add a name for the workflow copy in the Workflow Name dialog.

        1. In Workflow Name, type the new name for the copied workflow.
        2. Click OK. The system creates a workflow in the current application scope.
      15. In the Workflow Editor, click Information icon.
      16. In the Application tab, Application is set to the current application scope.
      17. In Accessible from, select This application scope only if to make the newly copied workflow a private one that cannot be accessed from outside current scope.
      18. Click Update.

      Result

      A new workflow record is created in the selected application scope and marked as private if designated as one in the Workflow Editor.

      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