Use Pega^® Robot Manager to monitor the performance, health, and throughput of your robotic process automation (RPA) virtual machines (VMs).

You can do the following tasks:

• Manage VMs and work queues, such as specifying the number of automations that can fail on a VM.
• Configure the organizational hierarchy of departments and users.
• Apply roles to users to define the tasks that they can perform.
• Obtain updated automation packages and deploy them to robotic work groups, departments, and users.

For more information about configuring and using RPA with Pega Platform 7.3, see the following articles:

• Tutorial: Automating processes in your Pega Platform application with robotic process automation (RPA)
• Configuring robotic process automation

Pega Robot Manager 3 is supported on Pega Platform 7.3. To download Pega Robot Manager from Pega Exchange, see Pega Robot Manager.

You must also use versions 8.0.1058 or later of Pega Robotic Automation Studio and Pega Robotic Automation Runtime.

For information about Pega Robot Manager 3, see the following sections:

• Enhancements
• Importing Pega Robot Manager
• Banker Pro sample application
• Configuring Pega Platform to use Pega Robot Manager
• User management
• Pega Robot Manager dashboard
• Managing work queues and VMs
• Automation packages

Enhancements

The following enhancements have been added to this version of Pega Robot Manager:

• Ability to manage and deploy automation packages

After the Pega Robotic Automation Studio developer publishes an updated automation package, you can deploy it to robotic work groups, departments, or users. For example, an automation package can contain new automated customer service tasks, which you can deploy to users in a production environment.

• Ability to manage users and departments

You can now create departments that define your organizational hierarchy and the users that perform work within departments. You can also define the tasks that users can perform with Pega Robot Manager by associating permissions with users.

Importing Pega Robot Manager

After you download Pega Robot Manager, import it to Pega Platform by completing the following steps:

1. In Designer Studio, click Designer Studio > Application > Distribution > Import.
2. Click Choose File.
3. Browse for the .jar file that you downloaded.
4. Click Submit.

Banker Pro sample application

Pega Robot Manager includes a sample application that you can use to understand how RPA solutions are configured within a Pega Platform application. The Banker Pro sample application is configured for traditional, straight-through RPA processing. The application contains work groups for Customer Service and Banking, and each group contains several work queues to hold assignments.

The Banker Pro sample application also defines several case types to perform common back-office tasks, such as updating account information, processing claims, and resolving customer disputes. Each case type has a single stage and a single processing step. Each step queues a new assignment to a VM by using the Assign to robot queue advanced shape on the Process Modeler.

Logging in to the Banker Pro sample application

After you import Pega Robot Manager, you can explore the sample application by logging in to Pega Platform with the following credentials:

• User ID - admin@bankerpro
• Password - rules

VM registration in the Banker Pro sample application

VM registrations are handled by the BankingAdministrator operator, which registers new VMs and assigns them to the correct access group. You must configure the credentials for this operator in each Pega Robotic Automation Runtime instance. As a best practice, when you configure RPA, give your administrative operator a unique access group with the PegaRULES:RoboticAdministrator access role.

You must also customize the pyGetAccessGroupForRobotByWorkGroup decision table to map a work group to the correct access group. Each access group can have different access roles so that you can customize the access rights of each VM in your application. This decision table has been specialized in the Banker Pro application layer.

Customizing the dashboard layout in the Banker Pro sample application

To start Pega Robot Manager, click Launch > Robotic console.

You can customize the dashboard page of Pega Robot Manager by clicking the Gear icon in the upper-right corner of the console. A default configuration is configured in the pyCaseManagerDashboards data transform, which is specialized in the Banker Pro application layer.

Configuring Pega Platform to use Pega Robot Manager

After you import Pega Robot Manager, you must configure certain settings, such as adding the console to an application and enabling agents. For more information, see the following sections:

• Adding Pega Robot Manager to a new application
• Adding Pega Robot Manager to an existing application that uses a previous UI-Kit version
• Enabling the ProcessStaleRobots agent
• Enabling the RoboticAssignmentProcessing agent

Adding Pega Robot Manager to a new application

When you create a Pega Platform application, you can add Pega Robot Manager to your application by completing the following steps:

1. Create the application by using the New Application wizard in Designer Studio. Your application will be automatically configured to be built on the UIKit 09.01 application layer.
2. Open the application record by clicking the application name in the Designer Studio header, and then clicking Open application.
3. In the Edit Application rule form, In the Built on application(s) section, add the PegaRoboticAutomationConsole application to the stack:
   1. Click Add application.
   2. In the Name field, enter PegaRoboticAutomationConsole.
   3. In the Version field, enter 01.02.01.
4. Click Save.

Adding Pega Robot Manager to an existing application that uses a previous UI-Kit version

​If you have an existing Pega Platform application that uses an earlier version of the UI-Kit, you can add Pega Robot Manager to your application by completing the following steps:

1. Open the PegaRoboticAutomationConsole application rule.
   1. Click Records.
   2. Click Application Definition > Application.
   3. Search for PegaRoboticAutomationConsole by using the Name filter.
   4. Click PegaRoboticAutomationConsole.
2. ​In the header, click Definition.
3. In the Edit Application form, in the Built on application(s) section, add UIKit 09.01 to the application stack.
   1. Click Add application.
   2. In the Name field, press the Down Arrow key and select UIKit.
   3. In the Version field, press the Down Arrow key and select 09.01.
4. Add your application to the application stack.
   1. Click Add application.
   2. In the Name field, press the Down Arrow key and select the name of your application.
   3. In the Version field, press the Down Arrow key and select the version of your application.
5. Click Save.
6. Create an access group that points to the PegaRobotAutomationConsole application:
   1. Click +Create > Security > Access Group.
   2. Enter a name and description, and click Create and Open.
   3. In the Application section, in the Name field, enter PegaRoboticAutomationConsole.
   4. In the Version field, enter 01.02.01.
   5. In the Available portals section of the access group, add pyRoboticConsole to the list of portals.
   6. On the Advanced tab of the access group, add the default work pool of your existing built-on application.
   7. Click Save in the Edit Access Group form.
7. Assign the new access group to your users. For more information, see Operator ID: Completing the Profile tab.

Enabling the ProcessStaleRobots agent

The ProcessStaleRobots agent finds the VMs that are running and that have lost connectivity with Pega Robot Manager, and disables them.

Enable this agent by completing the following steps:

1. Click Records > Sys Admin > Agent Schedule.
2. Select the Pega-ProcessEngine instance on the node where you want to enable the ProcessStaleRobots agent.
3. Select the Enabled? check box for the ProcessStaleRobots agent.
4. Click Save.

Enabling the RoboticAssignmentProcessing agent

The RoboticAssignmentProcessing agent finds stale assignments that have been in the VM queue for longer than expected, and moves the assignments back to the work queues from which they originated.

​Enable this agent by completing the following steps:

1. Click Records > Sys Admin > Agent Schedule.
2. Select the Pega-ProCom instance on the node where you want to enable the RoboticAssignmentProcessing agent.
3. Select the Enabled? check box for the RoboticAssignmentProcessing agent.
4. Click Save.

User management

You can create and manage your organizational structure of departments and users. The departments at the third level and below comprise one or more users that perform similar functions in an organization. For example, an organization can have a department of developers that maintain automations and a department of testers that test an automation before it is deployed to a production environment.

You also assign roles to users, which determine what actions they can perform in Pega Robot Manager.

For more information, see the following topics:

• Roles
• Configuring default authentication for roles
• Associating access groups and roles
• Adding departments
• Modifying departments
• Deleting departments
• Adding and modifying users
• Moving users
• Deleting users

Roles

Pega Robot Manager provides the following roles, which define the tasks that users can perform:

• AutomationPackageManagement:Administrators – Users with this role can perform all actions in Pega Robot Manager. Only these users can deploy packages to the Production deployment level and promote them to different levels.
• AutomationPackageManagement:Developer – Users with the this role can publish and manage packages. They can only view users and departments.
• AutomationPackageManagement:UserAdmin – Users with this role can manage users and departments, and they can view packages. They cannot deploy packages.
• AutomationPackageManagement:RuntimeUser – Users with this role cannot log in to Robot Manager; they are the end users, such as case workers, who use automations in a production environment.

The following table provides information about the tasks that each role can perform.

For more information, see Access Roles.

Roles also determine the form of authentication that is used when users log in to Pega Robot Manager. For more information, see Configuring default authentication for roles.

Configuring default authentication for roles

By default, users with the AutomationPackageManagement:RuntimeUser role log in to Pega Robot Manager by using single sign-on (SSO) authentication; users with all other roles log in by using basic authentication. You can change the default authentication type by configuring Dynamic System Settings in Pega Platform.

When you create users, they use the default authentication that you specify.

1. In Designer Studio, click Records > Sysadmin > Dynamic System Settings.
2. To specify the authentication used for the AutomationPackageManagement:RuntimeUser role:
   1. Click the PegaRoboticAutomationManagement owning ruleset that has the pegarobotics/DefaultAuthenticationTypeRuntimeOnlyUser Setting Purpose value.
   2. In the Value field, enter SSO or Basic.
   3. Save the rule form.
3. To specify the authentication for all other roles:
   1. Click the PegaRoboticAutomationManagement owning ruleset that has the
      pegarobotics/DefaultAuthenticationType Setting Purpose value.
   2. In the Value field, enter SSO or Basic.
   3. Save the rule form.

Associating access groups and roles

Permissions are applied to users by using access groups on which roles are associated. When you add a user in Pega Robot Manager, you associate the access group to apply the role permissions to the user.

1. In Designer Studio, create an access group that points to your application by clicking +Create > Security > Access Group.
2. Enter a name and description, and click Create and Open.
3. In the Application section, specify your application name and version.
4. In the Available roles section, click Add role.
5. In the field that is displayed, press the Down Arrow key and select the role that you want to associate with the access group.
6. Save the Edit Access Group rule form.

For more information, see Access Group data instances.

You can also create an access role and add privileges to it. For more information, see Access Roles.

Adding departments

You can add multiple top-level departments, and you can add multiple subdepartments to a department.

1. Click Departments.
2. Click Actions > New department.
3. Select the parent level to which the department belongs.
4. Enter a description, and then click Submit.

Modifying departments

You can modify the name and description of a department.

1. Click Departments.
2. Expand the organizational tree, click the Selector icon, and click Edit.
3. Enter a name and description, and then click Submit.

Deleting departments

You can delete a department that has no users in it.

1. If there are users in the department, either delete them or move them to another department. For more information, see Moving users to another department or Deleting users.
2. Click Departments.
3. Expand the organizational tree, click the Selector icon, and click Delete.
4. Click Submit.

Adding and modifying users

You can add users to departments and specify their access groups, which are associated with the roles that define the tasks that they can perform. You cannot edit the email address for users who use basic authentication or edit the user principal name (UPN) for users who use SSO authentication.

Operator IDs are created for each user that you add, and users log in with the email address or UPN that you specify.

1. Click Users.
2. Do one of the following:
   1. To add a new user, click Add new.
   2. To modify a user, click the user that you want to modify, and click Actions > Edit.
3. In the New user or Edit user dialog box, in the First Name field, enter the first name of the user.
4. Click the Department field and select the department to which the user belongs. This department is at least the third level in the organizational hierarchy.
5. In the Last Name field, enter the last name of the user.
6. In the Role field, press the Down Arrow key and select the access group to which the user belongs.
7. In the Email address field, enter the email address of the user. This field is required for user roles that use basic authentication. Users log in to Pega Robot Manager with their email addresses.
8. In the UPN field, enter the UPN. This field appears for roles that use SSO authentication and is required.
9. In the Status field, press the Down Arrow key and select the status of the user (Active or Inactive).
10. Click Submit.

For users who log in to Pega Robot Manager with basic authentication, the system generates the password Pega. Users should change their passwords by clicking Forgot password? in the Pega Robot Manager login page and having an email sent to them.

Moving users to another department

You can move users to another department.

1. Click Departments.
2. Expand the organizational tree to find the department that contains the users that you want to move, and click the department.
3. In the Users section, select one or more check boxes for the users that you want to move.
4. Click Move.
5. In the Move users dialog box, select the department to which to move the users.
6. Click Move.

Deleting users

You can delete users, which also removes their operator IDs.

1. Click Departments.
2. Expand the organizational tree to find the department that contains the users that you want to delete, and click the department.
3. In the Users section, click one or more checkboxes for the users that you want to delete.
4. Click Delete.

Pega Robot Manager dashboard

The Pega Robot Manager dashboard is a centralized workspace that displays operational information about your robotic process automations and key performance indicators, such as the status of your VMs.

For more information, see the following topics:

• Templates and widgets
• Customizing the dashboard
• Pega Robot Manager widgets
• Creating widgets and displaying them in the dashboard

Templates and widgets

Each dashboard uses a template that provides preconfigured layouts that define the standard size and position of widgets. Several standard templates are available.

After you apply a template to your dashboard, you can add widgets to each slot to display helpful functions in your console. Slots in a template are shown as gray rectangles.

Customizing the dashboard

The dashboard is displayed each time that you log in to your application. When personalization is enabled, you can configure your dashboard based on your individual preferences and business needs.

For example, you can add a widget that displays the number of assignments that could not be processed or the number of assignments that did not meet a service-level agreement (SLA) goal.

Click the Gear icon to display the Edit dashboard panel to customize your dashboard.

For information about configuring your dashboard display, adding and configuring widgets, and publishing your dashboard, see Configuring your dashboard.

Pega Robot Manager widgets

Pega Robot Manager provides the following widgets that you can add to your dashboard:

• Automation alerts – Displays failed robotic automations.
• Automation alerts over time – Displays the number of failed robotic automations over a period of time.
• Case activity – Displays the cases that were created and resolved over a period of time.
• Cases past SLA – Displays the cases that exceeded an SLA goal.
• Resolved cases by type – Displays the number of resolved cases by case type.
• Robot status – Displays the VMs in each work group that have issues or that are not running.

Creating widgets and displaying them in the dashboard

You can create your own widgets to display in the Pega Robot Manager dashboard.

For example, you can create a report that displays the percentage of robotic automations on a VM that run and are successfully completed on the first attempt. The following procedure describes the general steps for creating a report widget to display in the dashboard.

1. Create a report in Designer Studio in your application ruleset. For more information, see Creating reports in Designer Studio.
2. Create a section in your application ruleset. For more information, see Sections - Completing the Create, Save as, or Specialize form.
3. Add a chart control to the section and configure it so that it displays the report that you created.
   1. In the Data Source section, from the Type list, select Report Definition.
   2. In the Applies to field, press the Down Arrow and select the class to which your report applies.
   3. In the Report field, press the Down Arrow and select the name of your report.
   4. From the X-axis data field, select the property to use for the X-axis.
   5. Configure other information, as appropriate. For more information, see Harness and section forms - Adding a chart.
   6. Click Submit.
4. Mark the section as a widget, and configure the report widget.
   1. In the Edit Section form, click Settings.
   2. In the Widget title section, enter the name of the widget.
   3. From the Category list, select Robotic process automation.
   4. Configure other information, as appropriate. For more information, see Section form - Completing the Settings tab.
   5. Click Save.

After you log out and log back in to Pega Platform and start the Robotic Console, you can select the widget and display it in your dashboard.

Managing work queues and VMs

You can use Pega Robot Manager to manage your work queues and VMs in several ways. For example, you can start and stop queues and modify the frequency of pings that are sent from your VM to your Pega Platform application.

For more information, see the following topics:

• Monitoring VMs
• Reprioritizing work queues
• Starting and stopping work queues
• Configuring assignment information on work queues
• Modifying the heartbeat and work polling intervals
• Configuring the number of assignments that can fail on a VM
• Processing failed assignments

Monitoring VMs

You can view information about VMs to monitor their performance. For example, you can view a history of all the assignments that VMs in a work group processed.

You can do the following actions on the Work groups page:

• View all the work groups in your application, all the work queues in each work group, and all the VMs that retrieve assignments from those work queues.
• Click a work basket to view information about assignments in a work queue, such as how many assignments are in it.
  A work queue displays a red icon if the number of queued items meets or exceeds the maximum number of assignments that should be in it.
• Click a VM to view information about VM performance, such as audit trail information and how many assignments the VM could not process.
  ​A VM displays a red icon on the Work groups and Dashboard pages in one of the following scenarios:
  • The number of run-time automations is greater than the number of automations that can be in a work queue.
  • The connection to the VM is lost (the heartbeat interval has been exceeded).
  • The last automation took longer than expected to complete.

Reprioritizing work queues

VMs retrieve assignments from work queues in order of priority. Assignments are retrieved from the work queues according to their order on the Work groups page, from the top of the list to the bottom. You can reprioritize work queues by completing the following steps:

1. Click Work groups.
2. Click Edit in the panel for the work group that contains the work queue that you want to reprioritize.
3. Drag the work queue to its intended priority in the list.
4. Click Save.

Starting and stopping work queues

You can start or stop a work queue by completing the following steps:

1. Click Work groups.
2. In the panel for the work group that contains the work queue that you want to start or run, click Edit.
3. From the State list for the corresponding work queue, select RUNNING or STOPPED.
4. Click Save.

Configuring assignment information on work queues

You can configure information about assignments that are running on VMs within a work queue. For example, you can specify the number of assignments that should be running on a VM in a work queue.

1. Click Work groups.
2. Click the work queue that you want to modify.
3. Click Edit.
4. In the Max items field, enter the maximum number of assignments that should be in the work queue at any time.
   If the number of queued items meets or exceeds this threshold, the work queue turns red on the Work groups page, indicating that the VMs are not keeping pace with the incoming rate of work.
5. In the Max automation run time (in sec) field, enter the expected run time for the assignments in this queue.
   If the run time of an automation exceeds the value that is specified on its originating work queue, the VM displays a red icon on the Work groups and Dashboard pages, indicating that it might need administrative attention.
6. Click Save.

Modifying the heartbeat and work polling intervals

Each VM sends a heartbeat, or periodic message, to your application to indicate that the VM is still running and available. The work polling interval is the period of time that a VM waits before polling its work queue for more assignments.

You can modify these intervals by completing the following steps:

1. Click Dashboard, and then click a VM in the Robot Status section.
2. Click the Edit icon in the Robot Settings section.
3. In the Heartbeat interval field, enter the heartbeat interval, in seconds, that VMs should use when they ping your Pega Platform application.

A VM displays a red icon on the Dashboard and Work groups pages if the heartbeat interval has been exceeded, indicating that the connection to the VM has been lost.

4. In the Work polling interval field, enter the polling interval, in seconds, that the VM should use when requesting assignments from a work queue.
5. Click Save. The new intervals are applied after the VM next registers with your Pega Platform application.

Configuring the number of automations that can fail on a VM

You can configure the number of automations that can fail on a VM. If automation failures exceed this value, Pega Robot Manager indicates that there are issues with the VM health on the Dashboard page.

1. Click Work groups, and then click the VM that you want to modify.
2. Click the Edit icon in the Compliance section.
3. In the Max failed automations field, enter the number of automations that can fail on a VM during its processing life.

If the number of failures is greater than this value, the VM displays a red icon on the Dashboard and Work groups pages to indicate that the maximum number of failed automations has been exceeded.

4. Click Submit.

Processing failed assignments

If an assignment is not successfully processed, you can resend it to the work queue for reprocessing, or you can skip processing on the automation by manually continuing the flow in a case type.

1. Click Dashboard, and then click View all alerts in the Automation alerts section.
2. Click the case that contains the failed assignment that you want to process .
3. In the Assignments section, click Begin.
4. Do one of the following actions:
   • To manually continue the flow, select Actions > Manually continue the flow, and then click Submit.
   • To resend the assignment back to its work queue to be reprocessed by the VM that is running the assignment, do the following actions:
     1. Optional: Click Action > Edit to update a field.
     2. Click Submit.

Automation packages

When a change is made to an automation, the updated automation package can be sent to Pega Platform. In Pega Robot Manager, you can then deploy it to a robotic work group, department of users, or individual users in your organization. For example, a package can contain updates to customer service tasks, which you can test and deploy those changes to the case workers who use the application.

After the Pega Robotic Automation Studio developer updates an automation, the developer publishes the automation package to the Package Server. When a VM logs in to Pega Platform, the VM registers into its defined workgroup, which might be different from the one specified in Pega Platform. It retrieves the automation from the Package Server, loads it, and then begins requesting assignments.

For more information, see the following topics:

• Package versions
• Modifying package details
• Viewing package versions
• Deleting package versions
• Deleting packages
• Deployment levels
• Deploying packages
• Assigning deployment levels and packages
• Removing assignments
• Viewing package assignments
• Enabling and disabling package assignments
• Package configurations
• Promoting a package to another level
• Removing a package from a deployment level
• Restoring a package to a deployment level
• Viewing package deployment history

Package versions

Packages can have one or more versions, and you can deploy and promote any version of a package. For example, a Pega Robotic Automation Studio developer can publish an initial 1.0 package, which has been deployed to a production level. The developer can later publish an updated 1.1 package, which you can deploy to your QA level, where you can test it and then deploy it to production users.

Modifying package details

You can modify the name and description of a package.

1. Click Packages.
2. Click the package that you want to rename.
3. Click Actions > Edit.
4. Enter a name, description, or both, and then click Submit.

Viewing package versions

You can view information about versions of a package, such as when a package was published and by whom, that are on Pega Platform.

1. Click Packages.
2. Click the package for which you want to view version information.
3. Click Actions > Versions.
4. Click Close.

Deleting package versions

You can delete a version of a package from Pega Robot Manager.

1. Click Packages.
2. Click the package for which you want to delete a version.
3. Click Actions > Versions.

A Lock icon indicates that a package version has been deployed, and you cannot delete it. You must remove the package deployment first; For more information, see Removing a package from a deployment level.

1. Click Delete for the package version that you want to delete from Pega Platform.
2. Click Close.

Deleting a package

You can delete a package from Pega Robot Manager.

1. Click Packages.
2. Click the package that you want to delete.
3. Optional: If a package is assigned to a department, work group, or user, remove the package assignments. For more information, see Removing package assignments.
4. Optional: If a package is deployed, remove the package from all levels to which it is deployed. For more information, see Removing a package from a deployment level.
5. Delete each version of the package. For more information, see Deleting package versions.
6. Click Actions > Delete.
7. Click Submit.

Deployment levels

The deployment pipeline defines the levels through which an automation package moves from software development to a production environment. You deploy a package to a level and assign the deployment level to departments, users, and robotic work groups in that level so that the appropriate resources can develop, test, and use the package.

Pega Robot Manager provides the following default deployment levels:

• Development – The level in which developers update and maintain packages
• UAT – User acceptance testing. The level in which business users test packages to validate that a package performs as expected in real-world scenarios
• Production – The level in which case workers use the final version of the package in a live environment

You cannot rename, change the respective order of, or delete these deployment levels.

For more information, see the following topics:

• Adding a deployment level
• Renaming a deployment level
• Reordering deployment levels
• Deleting a deployment level

Adding a deployment level

You can add deployment levels to your pipeline, in addition to the three default levels that Pega Robot Manager provides. For example, you can create a QA level, where QA testers can run performance tests before you promote the package to the UAT level.

1. Click Packages.
2. Click the package for which you want to add a deployment level.
3. Click the Down Arrow of the deployment level to the left of where you want to add the new level.
4. Click Add deployment.
5. Enter a name, and then press Enter. The deployment level is displayed to the right of the level that you clicked.

Renaming a deployment level

You can rename a deployment level that you created.

1. Click Packages.
2. Click the package for which you want to rename a deployment level.
3. Click the Down Arrow for the deployment level that you want to rename.
4. Enter a name, and then press Enter.

Reordering deployment levels

You can move deployment levels to change their order in the deployment pipeline.

1. Click Packages.
2. Click the package for which you want to reorder a deployment level.
3. Drag the deployment level that you want to move to the appropriate location.

Deleting a deployment level

You can delete a deployment level that you created.

1. Click Packages.
2. Click the package from which you want to delete a deployment level.
3. If a package has been deployed to the deployment level, you must first remove the package deployment. For more information, see Removing a package from a deployment level.
4. Click the Down Arrow for the deployment level that you want to delete, and then click Delete.

Deploying a package

You deploy a package into a deployment level and then assign the deployment level and its package to the appropriate robotic work group, department, or user.

1. Click Packages.
2. Click the package that you want to deploy.
3. Complete one of the following actions:

• Deploy a package into a development level on which there is no package deployment:

1. Click Deploy version in the development level into which you want to deploy a package.
2. In the Available versions dialog box, click Deploy for the package version that you want to deploy.

• Deploy a package version that has already been deployed to a deployment level:

1. Click the Deploy icon in the deployment level to which you want to deploy a package.
2. In the Available versionsdialog box, click Deploy for the package version that you want to deploy.
3. Assign the deployment level and package to the appropriate resource. For more information, see Assigning deployment levels and packages.

Assigning deployment levels and packages

You assign a deployment level and the package that is deployed in it to a robotic work group, department of users, or individual users. For example, you can assign the Production deployment level, which contains a package so that VMs can automatically process claims, to a robotic work group.

When you assign a deployment level and package to a department, the package is inherited by all the subdepartments and users in each subdepartment. If you later add users or subdepartments to the department, any packages that were assigned to the department are also inherited by new subdepartments and users.

You can assign multiple deployment levels and packages to a user. For example, users inherit packages on a deployment level that are assigned to their departments, and you can also assign deployment levels and their associated packages directly to those users. If users are assigned multiple packages, they can select which package they want to use when they log in to their work stations.

Note: You can assign only one package to a robotic work group.

6. Click Packages.
7. Click the package, and then click the deployment level that you want to assign.
8. Click Assign new.
9. In the Create assignment dialog box, assign the deployment level and package.
   • To assign a deployment level and package to a robotic work group:
     1. Click the Group radio button.
     2. In the Group field, press the Down Arrow key and select the work group.
   • To assign a deployment level and package to a department:
     1. Click the Department radio button.
     2. From the Department drop-down list, select the department.
   • To assign a deployment level and package to a user:
     1. Click the User radio button.
     2. In the User field, press the Down Arrow key and select the user.
10. Click​ Next.
11. Optional: If a package configuration is defined, click the configuration that you want to assign. For more information, see Package configurations.
12. Click Next.
13. Click Assign.

Removing assignments

You can remove an assignment, for example, if case worker was inadvertently assigned to use the Development deployment level and package.

1. Click Packages.
2. Click the package for which you want to remove an assignment.
3. Click the deployment level that you want to remove.
4. In the Assigned to section, click the Delete icon for the department, work group, or user to which the deployment level is assigned.
5. Click Submit.

Viewing assignments

You can view all the packages that are assigned to departments or to individual users.

To view package assignments for a department:

1. Click Departments.
2. Click the department for which you want to view package assignments.

To view package assignments for a user, click Users, and then click the user.

The Assigned to section displays all the packages that are assigned to the department or user.

Enabling and disabling assignments

You can enable or disable packages that are assigned to departments or users.

To enable or disable a package assignment for a department, which disables or enables it for all subdepartments users:

1. Click Departments.
2. Click the department for which you want to enable or disable a package assignment.
3. Click the switch in the Assigned to section to enable or disable a package assignment.

To enable or disable a package assignment for a user:

1. Click Users, and then click the user.
2. Click the switch in the Assigned to section to enable or disable a package assignment.

Package configurations

A package can contain one or more configurations, which are defined on the automation by the Pega Robotic Automation Studio developer. Configurations act as variables into which different information can be substituted as needed.

For example, an automation developer builds an automation that retrieves parcel delivery information from an intranet website. A user must enter a tracking number in the website to retrieve parcel information.

For performance purposes, two sites are maintained on the intranet website—one for the East Coast of the United States, and one for the West Coast, with separate URLs for each site. The automation developer can create two configurations for the automation package, with one for the East Coast and one for the West Coast. Depending on which package configuration is used, when the automation runs, it loads either the East Coast or West Coast website URL.

In Pega Robot Manager, when you assign a package, you can assign the package configuration for the East Coast website to East Coast users and the package configuration for the West Coast website to West Coast users.

Promoting a package to another deployment level

After a package has been deployed to a level, you can promote the package to another level in the pipeline. For example, after business users finish testing in the UAT level, you can move the package from the UAT level to the production level.

Package deployments are not removed from the original deployment level when you promote them to another level.

1. Click Packages.
2. Click the package that you want to promote.
3. Click the package on the deployment level that you want to promote.
4. Drag the package to the deployment level to promote the package to that level.

Removing a package from a deployment level

You can remove a deployed package from a deployment level.

1. Click Packages.
2. Click the package that you want to remove from a deployment level.
3. Optional: If the deployed package is assigned to a department, work group, or user, you must remove the package assignments. For more information, see Removing assignments.
4. Click the Delete icon for the package version that you want to delete.

Restoring a package on a deployment level

You can restore a previously deployed version of a package deployment on a deployment level. For example, if you deployed a package version from UAT to Production but need to perform more testing, you can restore a previously deployed production package in the Production level.

1. Click Packages.
2. Click the package for which you want to restore a package version.
3. In the deployment level for which you want to restore a package, click the Down Arrow, and then click Deployment history.
4. Click Restore for the package deployment that you want to restore.

Viewing package deployment history

You can view details about a package deployment, such as which version of a package was deployed and when it was deployed.

1. Click Packages.
2. Click the package for which you want to view deployment history.
3. In the deployment level for which you want to view the deployment history, click the Down Arrow, and then click Deployment history.