Free cookie consent management tool by TermsFeed Control Center [Robotic Workforce Manager v5.3]
Control Center
This content applies solely to Robotic Workforce Manager, which must be purchased separately from the Appian base platform. This content was written for Appian 21.3 and may not reflect the interfaces or functionality of other Appian versions.

Introduction

The Control Center provides useful statistics about your digital workforce and orchestrates your robotic and business process management (BPM) operations. It displays information such as how many processes were automated in a certain period and how many resources and queues are deployed.

The page provides an overview of the different Control Center tabs, including:

Automation

You see the Automation page when you open the Control Center. This tab provides the list of automations in Production.

Figure 2.2.1.a: List of automations in production

Click on an Automation Name to get further statistics about the automation on the Automation Details page.

The Automation Details page consists of three views - Summary, Onboarding Request Information, and Onboarding Request Lifecycle.

The Summary view provides the Automation Steps details and Average Completion time of different steps.

Figure 2.2.1.b: Summary of details of the selected automation request

Users can click on each step in the Description column to see detailed information about that step. If that step is BPM or RPA, then users can see the detailed information about the BPM Process or RPA Process respectively. For AI related capabilities, there is no deep-dive navigation.

The Onboarding Request Information view provides the details of every stage of approval for automation.

Figure 2.2.1.c: Automation onboarding information

The Onboarding Request Lifecycle view provides the collective information of the automation request and will give information regarding all the approval stages.

Figure 2.2.1.d: Automation onboarding lifecycle

RPA

This tab provides useful statistics about the digital workforce and can be considered the orchestrator of your robotic process automation (RPA).

The RPA Module consists of six key views:

  1. Metrics
  2. Process
  3. Executions
  4. Resource
  5. Queue
  6. Calendar

Metrics

This view shows the following insights:

  • Key Performance Indicators (KPIs) - Count of total processes, resources, sessions, and work items.
  • Process Insights - Top exceptions and top time saved of RPA processes.
  • Sessions Analytics - Total number of sessions that have occurred on each quarter, month, and week.
  • Work Items - Total number of work items that have been processed each quarter, month, and week. This value can be compared against the total work items completed and deferred, as well as exceptions. This can be further drilled down at the process level.

Figure 2.2.2.1.a: Metrics

Process

The Process view provides a bird's eye view of all processes such as the Process Name, the Business Owner and Technical Owner, etc. This screen also allows the users to either start or schedule the Blue Prism, UiPath, Automation Anywhere, and Appian RPA processes from Appian on a real-time basis.

Figure 2.2.2.2.a: List of processes in Blue Prism, UiPath, Automation Anywhere, and Appian RPA

Users can click on the Process Name to get further statistics about the process.

The RPA Process Details page consists of three views - Summary, Audit Logs, and Start/Schedule Summary. The Summary view provides information pertaining to the process sessions, KPIs for sessions count, exception sessions, avg. session time, work item count, avg. work item time, etc.

Figure 2.2.2.2.b: Key statistics corresponding to a single process

Start and schedule an RPA process

While starting or scheduling a process from Appian, users cannot pass collections and complex data types.

Users can also start or schedule a process right from the process dashboard.

Figure 2.2.2.2.1.a: Start/schedule the RPA process user interface

The start and schedule action appears as shown above. Displayed at the top right is the list of inputs for which the user specifies the values. For the schedule, there is a section in the middle called Configure Scheduler where the user enters the start date, end date, time of schedule, and the days at which it needs to be scheduled.

There are two places where a user could start a process:

  1. Navigate to the Process tab.
  2. In the Action column, click Start or Schedule for the process.

Or

  1. Navigate to the Process tab.
  2. Click a process in the Process Name column.
  3. At the top right, there are related actions to start or schedule the process.
Configure Blue Prism schedules

If you're using Blue Prism as your RPA vendor, you can use RWM to configure specific schedules for process executions. The schedule appears in the Calendar, where you can cancel the schedule.

Schedule options reflect your user account's chosen time zone.

To create a new schedule for a Blue Prism process:

  1. Go to the RPA > Process tab.
  2. Find the process you want to schedule. Begin configuring the schedule one of two ways:
    1. Click Schedule in the Actions column in the Process list. OR
    2. Click a process in the Process Name column and click the SCHEDULE related action.
  3. Select Start Schedule.
  4. Configure the following fields:
    • Start Date: Set the schedule's start date.
    • End Date: Set the schedule's end date. If you leave this field empty, the schedule won't end or expire.
    • Recurrence: Choose whether the process execution should be repeated during the scheduled period. Options include:
      • Only Once: The process execution should occur only once for this scheduled period.
      • Every X minutes: The process execution should occur at a regular interval based on a defined number of minutes during this schedule.
        • Recurrence value: Enter the number of minutes to define the time interval. For example, enter 90 to initiate a process execution every 90 minutes. The minimum value for this field is 5 to ensure performance.
      • Every X hours: The process execution should occur at a regular interval based on a defined number of hours during this schedule.
        • Recurrence value: Enter the number of hours to define the time interval. For example, enter 2 to initiate a process execution every 2 hours.
      • Every X days: The process execution should occur at a regular interval based on a defined number of days during this schedule.
        • Recurrence value: Enter the number of days to define the time interval. For example, enter 3 to initiate a process execution every 3 days.
    • Start Time: Select the time the process should start execution. This field uses the format HH:MM where HH is the hour (0-12) and MM is minutes (0-59). Select AM or PM. This value must be at least 10 minutes in the future.
    • End Time: Select the time the process should end execution. This field uses the format HH:MM where HH is the hour (0-12) and MM is minutes (0-59). Select AM or PM. This field appears when you select Every X minutes or Every X hours for the Recurrence.
    • Days: Select the days of the week the execution should occur. If you selected Every X days for the recurrence, consider that interval when configuring which days you choose here. The schedule will run the process when the interval and selected Days overlap. For example, if you configure the schedule to run a process every 3 days, but you select Mon, Tues, Weds, and Thurs for Days, the schedule will run on Mon and Thurs for that week.
  5. Click SCHEDULE PROCESS.

Configure the schedule of a Blue Prism process in RWM.

The Blue Prism scheduling feature uses constants to determine time intervals for process executions. These values are configured to ensure performance, so we recommend testing any changes you make to the following constants:

  • RWM_SCH_TIME_CONSTRAINT: Determines the minimum amount of minutes for schedules configured to run using the Every X minutes recurrence. Default value: 5.
  • RWM_BP_SCHEDULE_INTERVAL: Determines the interval at which the RWM background process starts the scheduled Blue Prism processes. Default value: 3.
  • RWM_SCH_START_TIME_CONSTRAINT: Determines the minimum amount of time, from the user's current time, for newly created or canceled scheduled processes to take effect. Default value: 10.

Users can navigate to the Start/Schedule Summary view:

Figure 2.2.2.2.1.b: Summary of RPA processes started/schedule from the Robotic Workforce Manager

This opens up the RPA schedule calendar against the selected process. The calendar shows the various times at which the process is scheduled to run during that month.

Figure 2.2.2.2.1.c: RPA schedule calendar

A table appears at the bottom of the page that shows the list of processes triggered by Appian (for the current day). The Start History table displays five columns: Started By, Started At, Inputs, Comments, and Status.

Figure 2.2.2.2.1.d: RPA start history

Audit Log

The Audit log gives information about the processes that are changed on the RPA vendor side.

Figure 2.2.2.2.2.a: Audit log

Executions

Clicking on the Execution tab provides a view for the sessions that are completed of Blue Prism, UiPath, Appian RPA, and Automation Anywhere processes.

Figure 2.2.2.3.a: Executions

The Executions tab includes two views: Executions and Active Sessions:

  • Use the Executions view for a comprehensive list of past process executions. The table includes details about the instance, process name, start and end dates, work items processed, and the time it took to process those items. You can also see the overall result (SUCCESS, FAILURE, or ABORTED) and whether exceptions occurred.
  • In the Active Sessions view, you can view sessions in progress on a connected Blue Prism server. The table includes details about the session Id, start date, the active process, and the resource where the process is running. You can terminate a session in the Actions column. You can also configure resource details.

View logs from Blue Prism

On the Executions tab, you can retrieve session logs from Blue Prism. You can also access Blue Prism logs for an individual exception through the Exceptions tab.

  1. In the Executions grid, find the session that contains data you want to retrieve. You can use the filters to narrow the list of entries.
  2. Click the file icon in the Session Logs column.
  3. In the Session logs banner, choose how to refine the results:
    • Select Using index range to choose a subset of results based on the page. Enter a page number to see which items are included in the export. Each page contains up to 5000 entries. You can configure the page size using the RWM_LOGS_MAXLOGSIZE constant.
    • Select Using time range to choose a subset of results based on date and time. Enter the date and time boundaries for the items to include in the export.
  4. Click RETRIEVE DATA to retrieve the data from Blue Prism. Depending on how many items RWM needs to retrieve, this step may take a few seconds.
  5. Click EXPORT to generate the document containing the retrieved data. The file is in .XLSX format.
  6. Click Download to save the file to your computer.
  7. When you're finished, click the X icon to hide the Session logs banner.

Select the data to export from the Blue Prism session logs.

Resource

The Resource view provides an overview of all the resources (typically runtime machines) along with its current status (active, offline, etc). It also gives statistics about usage. Add and configure resources through your RPA vendor. RWM shows resource information on this tab. If you're using Blue Prism, you can terminate active sessions directly from RWM.

Figure 2.2.2.4.a: Resource utilization snapshot

Click a resource to see further information, such as a total number of sessions executed, the total number of processes executed, the percentage of utilization of the resource in a given period, etc. The percentage utilization of the resource may be an interesting metric for the operations, business, and the IT teams to plan capacity utilization. If utilization at runtime is high, then capacity may have to expand to accommodate future RPA automation requests.

In the Utilization Details table, you can see a breakdown of all the processes that have been executed on the resource in the given time period.

Figure 2.2.2.3.b: Resource record

Queue

This view provides details about the Blue Prism, UiPath, Automation Anywhere, and Appian RPA queues. It provides basic information such as the name of the queue, the number of work items in the queue, the status of each work item (completed or pending, etc), the amount of time taken for each work item in the queue, etc.

Figure 2.2.2.5.a: List of queues

Click a queue to see further information about each item in the queue, such as the resource that executed the work item, the priority, the status of each work item, etc.

Figure 2.2.2.5.b: Breakdown of a queue

In the Queue Items tab, a new set of export options are available. Choose to export queue items using the Most recent results or Using index range. When exporting the most recent results, the export is limited to 10000 entries.

Figure 2.2.2.5.c: Queue Items tab

Queue status definitions

The Summary section of the Queue tab shows the number of queues in each status, as described here:

  • In Progress: At least one robot is currently processing the queue.
  • Pending: No robot has processed the queue yet.
  • Paused: A robot isn't processing the queue, but the queue isn't accepting new items.
  • Finished: All items in the queue have been processed, or the status has been manually set. Queues with this status won't be processed further, even if some items are pending.
  • Completed: All items in the queue have been processed and the queue is not expected to be processed again.
  • Reserved: A robot has claimed the queue and no other robot can access it.
  • Not in Use: The queue is not pending or expected to be processed again.

Calendar

The calendar shows you a list of all the processes that have been scheduled in Appian as well as in Blue Prism, UiPath, Automation Anywhere, and Appian RPA. You can filter based on the process categories and the process names. Companies that work across different time zones can toggle between their timezone and the GMT for comparison. The calendar uses icons to display the real-time status of the schedules.

Figure 2.2.2.6.a: Global calendar view

There are several icons which will be shown in the calendar:

Icon Description
user_guide_icon_1.png This is a process scheduled in Blue Prism, UiPath, Automation Anywhere, Appian RPA itself.
user_guide_icon_2.png This is a process scheduled in Appian and waiting to be executed.
user_guide_icon_3.png This was a process scheduled in Appian and executed successfully.
user_guide_icon_4.png This was a process scheduled in Appian and the execution has failed.
user_guide_icon_5.png This was a process scheduled in Appian and the scheduled execution was canceled.
* Indicates that the schedule runs every hour. The time listed here indicates the first occurrence of the schedule.
** Indicates that the schedule runs every minute. The time listed here indicates the first occurrence of the schedule.

Click on a schedule to see additional details in the grid below the calendar.

Cancel a Blue Prism schedule

To cancel a schedule from the calendar:

  1. Click the scheduled Blue Prism process in the calendar.
  2. In the grid that appears below the calendar, click CANCEL SCHEDULE in the Actions column.
  3. In the confirmation window, click REMOVE SCHEDULE.

BPM

The BPM tab provides a bird's eye view of the BPM process and information such as the process Name, Description, Instance Count, Percent Successful, Avg Processing Time, and Avg Task Time.

Figure 2.2.3.a: List of queues

Click a BPM process name to get further statistics about the process.

Figure 2.2.3.b: BPM process statistics

Exceptions

All robotic processes in production have exceptions that occur from robots and humans working together. The Exceptions tab can be used to track all work item exceptions, as well as resource, schedule, and session alerts that occur within Blue Prism, UiPath, Automation Anywhere, and Appian RPA processes.

When alerts and exceptions occur, use the Exceptions tab to:

  • View all exceptions in a centralized repository.
  • Automatically add exceptions to a case and have a holistic view.
  • Triage exceptions and assign them to a specific user.
  • View the history and action items for individual exceptions.
  • View the number of open, in-progress, closed cases, etc., instead of dealing with cases ad-hoc.

If you're using Appian RPA, exceptions appear automatically in RWM only for robotic processes that take data from a queue as input.

Figure 2.2.4.a: List of tasks assigned to the user

Exception types

Exceptions fall under either System Exceptions, Alerts or Business Exceptions.

System exceptions

There are four types of system exceptions that need to be addressed:

  • Work item exceptions
  • Resource alerts
  • Session alerts
  • Schedule alerts

These are automated exceptions that originate from any available RPA vendor configured to work with your environment. These exceptions can include technical issues that a robotic process has encountered. These exceptions do not require additional configuration to receive in RWM. On the Exceptions tab, you can view all types of exceptions: WORK ITEM, SESSION, RESOURCE, CUSTOM, or OTHER. Click a category to view a list of those exceptions.

Click the Exception Id in the table to view details for an individual exception. On this page, a user can:

  • Look at the case details
  • Add comments
  • Edit the business data from Blue Prism, UiPath, Appian RPA, and Automation Anywhere
  • Reassign the case
  • Resubmit the case back to the RPA vendor to continue the processing of that case
  • View session logs (Blue Prism only)

Appian RPA processes can only be re-added to a queue and re-executed with work item exceptions if the process doesn't have data type parameters, which were introduced in 20.4. If the process contains data type parameters, this functionality is only available if the parameters contain null values.

For automatic case routing, the current version of RWM supports exceptions that are triggered within each work item in a queue. The application does not support exceptions that are triggered at the session level in this release.

Work item exception information received by the user

View a session log from Blue Prism

You can access Blue Prism logs for an individual exception. Session logs are only available for work item and session exceptions.

  1. Go to the Exceptions tab.
  2. In the grid, find the work item or session that contains data you want to retrieve. You can use the filters to narrow the list of entries.
  3. Click the Exception Id in the table to view details for an individual exception.
  4. Click SESSION LOGS to view session data related to the exception.
  5. In the Session logs banner, choose how to refine the results:
    • Select Using index range to choose a subset of results based on the page. Enter a page number to see which items are included in the export. Each page contains up to 5000 entries. You can configure the page size using the RWM_LOGS_MAXLOGSIZE constant.
    • Select Using time range to choose a subset of results based on date and time. Enter the date and time boundaries for the items to include in the export.
  6. Click RETRIEVE DATA to retrieve the data from Blue Prism. Depending on how many items RWM needs to retrieve, this step may take a few seconds.
  7. Click EXPORT to generate the document containing the retrieved data. The file is in .XLSX format.
  8. Click Download to save the file to your computer.
  9. When you're finished, click the X icon to hide the Session logs banner.

Session logs can be accessed from an individual exception.

Select the data to export from the Blue Prism session logs.

Alerts

You can also find alerts related to resources, sessions, and schedules in the Exceptions tab. These tasks are assigned to the RWM Exception Managers by default, whenever the status of a resource is changed from Active or Running to either Missing or Offline (for resources). For sessions, you'll see an alert when the executing session fails. For Blue Prism customers using schedules, you'll see an alert when an execution doesn't occur as scheduled.

Examples are shown below:

Resource alerts user interface

Sessions alerts user interface

For Blue Prism session alerts, there is also an option to restart the process.

Schedule alerts user interface

Business Exceptions

Business exceptions are exceptions and alerts that result from the activities in Appian business processes used as part of automations occurring in the application. These business processes can be designed to capture the range of business relevant activities that fall outside of the capabilities of robotic processes, but are possible within Appian BPM. This includes pulling various users in the organization into the process for comments, reviews, approvals, reconciliation of inconsistent data, as well as automated activities and integrations with external systems. All of these BPM and RPA processes can be seamlessly connected to create an end-to-end automation workflow.

To see your Appian BPM processes appear in the business exceptions list, follow the customization instructions.

Handling Exceptions

When an exception occurs, the exceptions are added to a case and assigned to the user automatically, based on the RWM_caseManagementRoutingDetails decision table, which can be found in Appian Designer. The format of the decision routing table is shown below.

The last empty entry should not be removed as that's the condition at which the unmatched cases get assigned to the Exception Manager.

Exceptions tasks auto assignment

You can manually assign different exception types from the Exceptions tab. Select WORK ITEM, SESSION, RESOURCE, CUSTOM, or OTHER to view a list of those exceptions. The instructions below apply to all exception types.

Appian RPA is the only vendor supported to use with RWM's bulk exception handling. You can manage individual exceptions originating from other RPA vendors in RWM.

Assign cases

Exceptions created on the RPA vendor side by default are assigned to the Exception Manager if they do not have any assignee configured in the decision table as shown above. The Exception Case Manager can select assignees from this screen. Assignees are then able to work on the exceptions.

You can assign one exception at a time, or assign multiple exceptions in one step.

To assign exceptions:

  1. Go to the Exceptions tab in RWM.
  2. Use the filter options to narrow the list of exceptions.
  3. Click SET FILTER.
  4. In the list, check the box next to each exception you want to assign.

    You can select up to 100 exceptions by default. This limit can be configured using the RWM_EXCEPTIONS_BULK_ACTION_MAX_SELECTION object. If you change this value, test how these changes impact performance in your RWM environment.

  5. Click ASSIGN.

    Assign cases

  6. The Assign Cases page displays the selected exceptions in a grid. In the picker, search for a user to assign these exceptions.
  7. After you search for the user, click ASSIGN ALL to assign these exceptions to the selected user.

    Assign cases

  8. Alternatively, click Assign all to me to assign the exceptions to yourself.

Update details

You can update an exception's Priority and Status in the Exceptions tab.

  1. Go to the Exceptions tab in RWM.
  2. Use the filter options to narrow the list of exceptions.
  3. Click SET FILTER.
  4. In the list, check the box next to each exception you want to update.

    You can select up to 100 exceptions by default. This limit can be configured using the RWM_EXCEPTIONS_BULK_ACTION_MAX_SELECTION object. If you change this value, test how these changes impact performance in your RWM environment.

  5. Click UPDATE DETAILS.
  6. The Update Case Details page displays the selected exceptions in a grid. Under Case Details, you can select a Status and Priority to assign to all of the selected exceptions. You can also Add Comments for the exceptions.
  7. Click UPDATE ALL to save your changes.

    Update multiple exceptions at once

Close exceptions

You can view closed exceptions from the Exceptions tab as well. In the filter options, select Closed to see the exception and alerts that are closed.

Closed exceptions

To close an exception:

  1. Go to the Exceptions tab in RWM.
  2. Use the filter options to narrow the list of exceptions.
  3. Click SET FILTER.
  4. In the list, check the box next to each exception you want to close.

    You can select up to 100 exceptions by default. This limit can be configured using the RWM_EXCEPTIONS_BULK_ACTION_MAX_SELECTION object. If you change this value, test how these changes impact performance in your RWM environment.

  5. Click CLOSE OR DISCARD.
  6. The Close or Discard Items page displays the selected exceptions in a grid. Under Case Details, you can select a Status (Closed or Discarded) and Priority to give to all of the selected exceptions. You can also Add Comments for the exceptions.
  7. Click CLOSE ALL to save your changes.

    Close multiple exceptions at once

Re-execute exceptions

You can re-execute a robotic process from the Exceptions tab. This option is useful after the exception is addressed. The re-execute workflow lets you re-execute the process that encountered an exception, and then close that exception all in one step.

Appian RPA is the only vendor supported to use with RWM's bulk exception handling. If you're using more than one RPA vendor with RWM, you will only be able to re-execute multiple exceptions that originate from the same vendor (Appian RPA).

  1. Go to the Exceptions tab in RWM.
  2. Use the filter options to narrow the list of exceptions.
  3. Click SET FILTER.
  4. In the list, check the box next to each exception you want to update and re-execute.

    You can select up to 30 exceptions by default. This limit can be configured using the RWM_EXCEPTIONS_BULK_REEXECUTE_MAX_SELECTION object. If you change this value, test how these changes impact performance in your RWM environment.

  5. Click UPDATE INPUTS AND RE-EXECUTE.

The configuration options you see on the Update & Re-execute page vary, based on the exception type.

The following options appear for WORK ITEM exceptions:

  • Case Details: Choose the exception's Priority and Add Comments if you'd like.
  • Actions: Choose how to re-execute the exception:
    • Add all to queue: This option updates the queue items with the changes you make on this page, adds those items back to the queue, and waits for the next time the queue executes.
    • Add to queue & re-execute all: This option updates the queue items with the changes you make on this page, adds those items back to the queue, and executes the queue.
  • Bulk Update Common Inputs: This section appears if you selected two or more work item exceptions to update. Click bulk update common inputs to reveal fields the work items have in common. Only fields in common among the selected items appear here. Input new values and click APPLY TO ALL to use these values for all of the work items you selected, which appear in the table.
  • Field Values: Enter unique values for a single work item exception. Select the exception in the table to populate its values and edit as you like.
  • Action Inputs: This section displays metadata related to the work item, which is displayed in the RPA vendor's user interface. Select the exception in the table to populate its inputs and edit as you like.

Click RE-SUBMIT AND CLOSE ALL to trigger the re-execution and close the exceptions.

Update multiple work items values at once

The following options appear for SESSION exceptions:

  • Case Details: Choose the exception's Priority and Add Comments if you'd like.
  • Bulk Update Common Inputs: This section appears if you selected two or more session exceptions to update. If the selected sessions have any fields in common, you can add that information in this section. Only fields in common among the selected sessions appear here. Click bulk update common inputs to reveal the fields and input values. Click APPLY TO ALL to use these values for all of the sessions you selected, which appear in the table.
  • Action Inputs: Select the Resource and Queues to use with this execution. You can also update values for the respective process inputs.

Click RE-RUN AND CLOSE ALL to trigger the re-execution and close the exceptions.

Update multiple session values at once

The UPDATE INPUTS AND RE-EXECUTE option isn't available for RESOURCE exceptions.

Open in Github Built: Fri, Nov 10, 2023 (03:42:48 PM)

Control Center

FEEDBACK