Introduction

After installing the Studio module, you need to set it up before using it with the Appian Case Management Studio Base application. This guide walks you through the recommended setup steps, which include:

• Enabling milestone generation on case creation
• Enabling task generation on case creation
• Creating a case type category and case type
• Enabling an add-hoc-template-task-to-existing-cases
• Incorporating a quick action
• Translating the application

Implementers can customize the security, display names, and other aspects of the application to best suit their needs.

Step 1: Enabling milestone generation on case creation

This is a required step. Since milestones are created and configured to tasks in case types in the Studio module, the following steps must be completed to ensure that milestones are generated successfully upon case creation.

1. Log in to the target environment.
2. Navigate to the Appian Designer.
3. Navigate to CMGT Case Management Studio Base application.
4. Search for and select the expression rule CMGT_Case_SetMetaData.
5. Locate the milestones map.
6. At line 105, replace the CMGT_Case_GenerateCaseCreationMilestones_Logic rule reference with the following code block:

   1
   rule!CMGT_WFL_Case_GenerateCaseCreationMilestones_Logic(case: fv!item)
   

7. Click SAVE CHANGES.

   

Step 2: Enabling task generation on case creation

This is a required step. Since reference tasks are created and configured to case types in the Studio module, the following steps must be completed to ensure that tasks are generated successfully upon case creation.

1. Log in to the target environment.
2. Navigate to the Appian Designer.
3. Navigate to CMGT Case Management Studio Base application.
4. Search for and select the process model CMGT_Case_Create.
5. Double-click the Create Tasks for Case sub-process node.
6. Navigate to the Setup tab.
7. In Input Variables, click the expression editor icon for the tasks input variable.
8. Update the expression to the following:

   1
   2
   3
   =rule!CMGT_WFL_Case_GenerateCaseCreationTasks_Logic(
       case:pv!case
   )
   

9. Click SAVE AND CLOSE.
10. Click OK.
11. Save & Publish the process model.

Step 3: Creating a case type category and case type

This is a required step. For cases to be created, at least one case type category and case type must be created in Studio first.

To create a case type category:

1. Navigate to the Studio site.
2. On the CASE TYPES page, click CREATE CATEGORY.
3. Complete the form. Name is the only required field.

4. Click CREATE.

   

To create a case type:

1. On the CASE TYPES page of the Studio site, click CREATE CASE TYPE.

2. Complete Step 1 of the form.

   

3. Click NEXT to proceed to Step 2 where the case type workflow can be configured.

4. Click ADD TASKS to create and add template tasks or task blocks and configure their relationships.

   

5. Click CREATE.

Step 4: Enabling an ad-hoc template task to existing cases

This is an optional step. In order to add a CREATE FROM TEMPLATE action button to existing cases, which allows caseworkers to add an ad-hoc Confirmation or Document Upload template task to the case after the case was created when needed, complete the following steps:

1. Navigate to the Appian Designer.
2. Navigate to CMGT Case Management Studio Base application.
3. Search for and select the record type CMGT_Case.
4. Add the following new related action to the Related Actions section:
   1. Create From Template
      • Display Name: Click Expression and enter translation!Create From Template
      • Key: createTaskFromExisting
      • Dialog Box Size: Large
      • Process model: CMGT_WFL_TaskFromExisting_Create with context

        1
        2
        3
        4
        5
        6
        {
        cancel: null, /* Boolean */
        task: rule!CMGT_Task_RecordAction_Create_InitializeParameters(
           caseId: rv!identifier
        ).tasks
        }
        

5. Save the action and the record type.
6. Search for CMGT_Case_RecordView_Tasks in the CMGT Case Management Studio Base application.
7. Search for the interface rule!CMGT_Task_RecordGrid
8. Find the parameter topGridRecordActions and the commented action.

9. Uncomment the action and point it to createTaskFromExisting on the CMGT_Case record.

   

Step 5: Incorporating a quick action to Studio

This is an optional step. In order to add a quick action on the Workspace Home page, which takes users to the Studio site, complete the following steps:

1. In Appian Designer, go to the CMGT WFL Studio Module application, search for the constant CMGT_WFL_TXT_SITE_URL_STUB.
   • Update the correct site URL stub where the Studio application is hosted.
2. Search for CMGT_WFL_QuickLink_ItemMap and review the expression rule.
   • Confirm the URL is generated as expected by looking at the item.value.values.link.uri value.
   • Confirm the visibility logic.
3. Go to Appian Designer.
4. Go to the CMGT Case Management Studio Base application and search for CMGT_Workspace_InternalUser_Sub_QuickLinks.

5. In local!itemMap, add CMGT_WFL_QuickLink_ItemMap to the list by copying the following:

   1
   rule!CMGT_WFL_QuickLink_ItemMap()
   

6. Click SAVE CHANGES.
7. Confirm quick action is working as expected.

Step 6: Translating the application

This is an optional step. Refer to Exporting translation strings for translation for information on translating the Studio module to other languages.