Compare bot versions

You can compare different versions of your bots and view any modifications in your workflows in both the public and the private workspaces.

Prerequisites

Ensure you have the following permissions:

  • View my bots
  • View content
  • Check in or Check out

Procedure

  • Public workspace
    1. Log in to the Control Room as a Bot Creator or a Citizen Developer user.
    2. Navigate to the public workspace.
    3. On the left pane, click Automation.
      A list of available bots and forms is displayed.
    4. Select a bot, hover over the actions menu (vertical ellipsis) on the right of the bot name, and click Compare versions.
      The compare version page appears with two versions of your bot. The left column shows the previous version of your bot, and the right column shows the newer version of your bot.
    5. Click the Change version icon to select and confirm the version of the bot that you want to compare on the left and right column.
      You can review the two versions of your bot. The red highlights on the left column show the lines that are modified. The green or blue highlights on the right column show the lines that are added or changed. This view shows the bot versions by Actions.
      Note: When you compare two versions of a bot, you might sometimes not observe any visible changes. This is because the bot version is modified as a result of changes in the underlying JSON file.
    6. Optional: Select Variables, Triggers, Packages, or Dependencies to compare your bot versions by these categories.
      Note: The changes made to the immediate dependencies are displayed, and the dependencies are sorted in an alphabetical order.
    7. Optional: Select the Swap versions icon to swap between your two current versions.
    8. Click Close to exit the comparison view.
  • Private workspace
    1. Log in to the Control Room as a Bot Creator or a Citizen Developer user.
    2. Navigate to the private workspace.
    3. On the left pane, click Automation.
      A list of available bots and forms is displayed.
    4. Select a bot, hover over the actions menu (vertical ellipsis) on the right of the bot name, and click Compare versions.
      The compare version page appears with the left column displaying the source checked-out version of the bot in the public workspace and the right column displaying the checked-out and edited bot in the private workspace.
    5. Click Change version to change the current bot version in the left column (Public version).
      The Select version to compare page prompts you to select a new bot version.
      Note: You cannot change version on the right column (Private version).
    6. Select and confirm the version of the bot that you want to compare on the left column.
      You can review the source and edited versions of your bot . The red highlights on the left column show the lines that are modified. The green or blue highlights on the right column show the lines that are added or changed. This view shows the bot versions by Actions.
    7. Optional: Select Variables, Triggers, Packages, or Dependencies to compare your bot versions by these categories.
      Note: The changes made to the immediate dependencies are displayed, and the dependencies are sorted in an alphabetical order.
    8. Click Close to exit the comparison view.