Customization Changes

Introduction

Robotic Workforce Manager (RWM) is built on Appian's low-code platform and is as flexible as any application developed in Appian. In order to make sure your application remains scalable and aligns with best practices, this page guides you through some of the most common changes.

This guide intends to provide expert Appian designers with the best practices, guidelines, and recommendations for configuring RWM.

Automation Planner

In the Automation Planner, Request New RPA Process is a process to request a new RPA automation. Using this feature, the requestor or a member of the CoE can track the specific automation request until the request is taken to production.

The below customizations are possible within the Automation Planner module:

  • Customizing Roles
    • Customizing Role Name
    • Customizing Members
  • Customizing Status
    • Modifying Status Name
    • Adding New Status
  • Adding New Approval in Workflow

Request New RPA Process

The workflow of the RWM core application is illustrated below.

user_guide_request_rpa_process

Rationale

Every organization has its own approval hierarchy to onboard any RPA process. The approval built in this application can be customized as per the Organization needs.

Given below are instructions on how to customize the workflow.

Customizing Roles

Refer to - Security and Role-Based Access which is fully configurable.

Customizing Status

The process has the following statuses for each step in the workflow. These values are mentioned in the constant - RWM_VAL_PROCESS_STATUS and RWM Database - RWM_LOOKUP_STATUS table.

Modifying Status Name

  • The value of the constant can be changed to update the status name.
    • It will be changed in the new version of the application is imported in the environment.
Adding Status

It has three steps:

  1. Adding to status list constant
  2. Adding to status index constant
  3. Adding to the status in rwm_lookup_status table

Adding to status list constant

The status needs to be added in the constants RWM_VAL_PROCESS_STATUS and RWM_LOOKUP_STATUS.

Adding to status index constant

There is another set of constants which has the index of each status. Information is given below:

  • 1 - RWM_VAL_DEP_MAN_STATUS_REQUEST
  • 2 - RWM_VAL_DEP_MAN_STATUS_BIZ_COE_REVIEW
  • 3 - RWM_VAL_DEP_MAN_STATUS_TEC_COE_ANALYSIS
  • 4 - RWM_VAL_DEP_MAN_BUDGET_APPROVAL
  • 5 - RWM_VAL_DEP_MAN_STATUS_IN_DEV
  • 6 - RWM_VAL_DEP_MAN_STATUS_IN_PROD
  • 7 - RWM_VAL_DEP_MAN_STATUS_AI_REVIEW

If any new approval should be introduced, one constant should be created with the index as value. And all the status constants after this new status needs to be updated with value+1.

  • Do not delete the status constants since it drives the entire Request New RPA Process workflow.

Adding a New Step in Workflow

This section explains at a high level how to add a new step in the workflow.

  1. Adding a new step to the status
  2. Updating the Approval Interface
Adding a new step to the status

Refer to the section Adding Status.

Updating the Approval Interface

The existing interface - RWM_DM_FORM_requestNewRPAProcess is common for the below stages as they have the same content for review:

  • Business COE Review
  • Technical COE Review
  • Budget Approval
  • Start Project

The status field in the process input is the driving factor to show the feedback given by the previous approver. For the new stage, the comment section should be added and configured to conditionally shown based on the stage.

  • If additional data points are required, create an additional CDT with one to one mapping to the solution CDT and add the new data points there. This will require an additional query entity and write to datastore. This will make the future upgrade more difficult as several of the solution objects such as process models and interfaces must also be updated to accommodate the new data.

  • Do not introduce any new fields in the User Interface
    • The reason for this is that when updating the application, the user interface being imported will not have this field, and this field will need to be manually re-created with each application update. To avoid this issue, the interface can be copied and that can be used in the User Input Task instead.
  • Do not change the solution CDT (RWM_PROCESS_ONBOARDING, RWM_PROCESS, RWM_VALUE_ASSESSMENT) because they will be overwritten by the next version of the RWM application.

General Customization

The Charts, Grids, and Dashboards that are part of the Control Center module can be customized in the RPA Management application.

While customizing, the following points need to be followed:

All the below content will be overwritten while upgrading the application to the newer version. To handle it, below suggestions can be followed:

  • If the Appian version is 19.2, The DevOps can be used to see the difference between objects in the environments. The new version of the application can be compared with the customized environment.
  • It is recommended to make a copy of the existing object (Rule/Interface/Query Entity) and make the corresponding changes.

Charts/Grids

  • Colors can be customized.
  • The label of the chart content can be customized.

  • Do not change the View/Stored Procedure content.
    • If any database content is changed that can override the current functionality of the charts and that also may have an impact on other functionalities if they were reused.

Dashboards

  • New charts, grids, other contents can be added.
  • Additional Dashboards can be added.

These are all the general guidelines for items that should not be customized.

  • Do not change the type of any columns in any CDT.
  • Do not change any of the CDT names.
  • Do not change the type of any columns in any table.
  • Do not change any of the table names.
  • Do not change the script for any View.
  • Do not change the script for any Stored Procedure.
  • Do not change the script for any Function.

For general guidelines on customization please refer to Backward Compatible Design: Planning for Subsequent Deployments.

Database support

Customize the RWM application to support Oracle DB apart from MySQL cloud DB.

Open in Github Built: Fri, Mar 11, 2022 (04:59:07 PM)

On This Page

FEEDBACK