Example of updating default package version across bots

This example shows how to perform a bulk update of multiple bots in the Control Room repository and use the default version of the Excel advanced and Message Box packages.

Prerequisites

To update bots to the default package version, ensure you have the View packages permission and the permission to edit bots .

This example shows how you can update all the bots in a public repository that use the Excel advanced and Message Box packages to their default versions with one action.

Procedure

  1. To update all the bots in the public repository that use Excel advanced and Message Box packages to default version, perform these steps:
    1. Navigate to Administration > Bot update.
    2. Click the Update Bots drop-down and click Package Version.
    3. On the Update - Package Version > Settings page, search and select the Excel advanced and Message Box packages.
    4. Click the right arrow (→) to add the Excel advanced and Message Box packages to the selection.
    5. In the selection list, select the Excel advanced and Message Box packages and click Next.
    6. From the list of available bots, select the required bots for which you want to update the package version.
    7. Click the right arrow (→) to add your selection, select the bots from the selection list, and click Next.
    8. Review the selected bots and dependencies that you selected for the update and click Update-Package Version.
    The bots are checked out to set the package default versions for the Excel advanced and Message Box packages.
  2. On the Bot update list page, click the three dots icon next to the required update and click View update bot details to view a detailed report.
  3. Navigate to Administration > Audit log.
  4. On the Audit log page, search by event type and select the Update default package value.
    You can view information about status, name, start and end time, duration required for the update, the number of completed, failed, skipped, and total items with last modified time, and user details (such as username) who initiated the package update.
    1. Click the three dots icon next to the required event and click View event details.
      Event details:
      • Status: Successful
      • Item name: AAAb
      • Event started by: doc-packages
      • Time: 12:49:06IST2023-02-27
      • Object type: Event
      • Event type: Update default package
      • Source device: product-kernel-5cbc499957-ln4s8
      • Source: Control Room
      • Request ID: 83cfaceb03d4528fe4785d10f1e02ae6
      Update default package details:
      • Request name: Updatebots.doc-packages.23.02.27.12.18.02
      • Bot path: Bots\AAAb
      • What changed?: Package version
      • Package name: MessageBox
      • Old package version: 2.1.0-20210118-185321
      • Target package version: 6.14.0-20221221-171419,3.5.0-20221223-065722
      • Old bot version: 1
      • New bot version: 2
    2. Copy the Request ID , for example, 83cfaceb03d4528fe4785d10f1e02ae6 from the Update default package page.
    3. On the Audit log page, search by filter Request ID and enter the value 83cfaceb03d4528fe4785d10f1e02ae6.
      The Audit log page displays all the bots that are either successfully updated or those that failed the update process as shown in the following image:
      Bulk update package version process
    4. Click any bot, for example, AddTwoNumber, to view the Update default package details.
  5. Select the required event from the Audit log page, for example, AddTwoNumber, and click Export checked items to CSV to download the audit data to a CSV file.
    Bulk package update audit log export