Free cookie consent management tool by TermsFeed How to Set Up Connected Servicing [Connected Servicing v23.3.2.6]
Page not found in the selected version; redirected to the home page.
How to Set Up Connected Servicing
This content applies solely to Connected Servicing, which must be purchased separately from the Appian base platform. This content was written for Appian 23.3 and may not reflect the interfaces or functionality of other Appian versions.

Introduction

After installing Connected Servicing, there are several configurations you will likely perform to customize the solution for your organization's processes. In order to make sure your solution remains flexible, scalable, and aligns with best practices, we have provided instructions to guide you through some of the most common configurations.

This page outlines the order we recommend for configuring the default solution to work for your organization after completing the installation process. However, all of these instructions can be used to modify the solution at any time.

Note:  Updates in Appian Designer should be done with caution by someone familiar with Appian development.

Modifying objects

To make sure you always have the default interfaces, expression rules, and process models to refer back to, we suggest performing the following steps if you need to customize the solution:

  • Create copies of the interfaces, expression rules, and process models you want to update.
  • Name them with the suffix of CUSTOM. For example, something different than AS_SRQ_FM_Service RequestSummary_CUSTOM.
  • Use your new objects instead of the original objects.

Tip:  Do not create copies of the CDTs. This would require you to update every reference to the CDT in the application. Instead, just modify the default CDTs provided in the application.

Following this paradigm will reduce the time and effort required to upgrade or add an additional Connected FS solution to your environment.

Step 1: Configure user groups and security

Configuring user groups and security is a good place to start.

You will need to know:

  • If your organization has any additional business roles that are not covered in the default business groups.
  • What users should be members of each business group.

For more information on how to configure groups and security, see the following pages:

  • See Modifying Groups to understand how to modify groups to fit your organization, as well as how to add users to the appropriate groups.
  • See Groups Reference Page for more information about the default groups in Connected Servicing and what they provide access to.
  • See Managing Group Membership for instructions on adding users to groups from the front-end Connected FS Settings site.

Step 2: Set default system behavior

The following solution behaviors can be configured by simply updating certain constants:

  • Enabling or disabling comment notification.
  • Turning integrations on or off.
  • Setting the default currency.

Step 3: Configure the create a new Service Request process

The create a new Service Request process consists of the following data-entry steps:

  1. Choose a customer.
  2. Provide Service Request details.
  3. Add required documents.
  4. Review customer Service Request.

These steps can be modified to fit your organization's processes and data requirements by configuring service request values, fields, labels, and validations.

Configure service request values

The Create New Service Request form includes several key dropdown values that allow you to tailor the solution's Service Request process to match your organization's requirements and needs. In order to adapt Connected Servicing for your organization, a business user can easily set these values and relationships in the DATA tab of the Connected Servicing settings page.

data_settings.png

A business user will be able to set up:

  • The values of account types, customer types, document types, Service Request types, Service Request subtypes, and product types.
  • Document examples to train the IDP classification process.

Configure dropdown lists

Most dropdown lists that are required for creating an Service Request can be configured by a front end business user in the Connected FS Settings page. The dropdown lists that cannot be set in the Connected FS Settings page are stored in reference tables. A dropdown list type is how you group dropdown list values, such as Entity or Request Status. You can update these values by updating the reference data tables.

dropdown_list_types_and_values.jpg

You will need to know:

  • What changes are required for the dropdown list values?
  • Do you need any additional dropdown lists?

As long as you haven't loaded any data into the application, deleting unnecessary dropdown list values from the reference data tables should not cause a problem. Solution setup is the only time you should delete any values from reference data tables, and you must do so with care. However, you should never delete the data from a shared table. These include:

  • AS_FS_R_COUNTRY
  • AS_FS_R_CURRENCY
  • AS_FS_R_DATA
  • AS_FS_R_GLOBAL_INDUSTRY_CLASS
  • AS_FS_R_M_CURRENCY
  • AS_FS_R_REGION
  • AS_FS_R_STATE

These tables are shared within the Financial Services solutions, were built to work together. If your organization ever decides to use more than one Financial Solution solution, deleting rows from these tables could cause problems. However, adding or editing rows is fine. If you don't need a value from one of these tables, make the value inactive instead of deleting it.

Note:  When setting up your solution, do not delete all of the values for a certain dropdown list type. If you do delete a dropdown list type, you will need to remove any references to that dropdown list type in the solution.

For instructions on how to modify these types of reference data, see the following pages:

  • See Modifying Dropdown Lists for instructions on how to:
    • Modify the dropdown list values.
    • Add new dropdown lists types.

Configure fields and UI text

It is likely that the default fields and UI text throughout the create new Service Request process will not exactly match your organization's requirements. You can configure them to meet your organization's needs.

Field and label diagram

For each of the create new Service Request data-entry steps, you will want to know:

  • What fields are not applicable?
  • What fields need to be added?
  • What UI text needs to be modified or added?

For instructions on how to modify fields and UI text, see the following pages:

  • See Modifying Record Fields for instructions on how to add or modify the fields that appear in the solution interfaces and store data.
  • See the Solutions Hub User Guide for instructions on how to modify UI text, including adding a new language.

Configure validations

The create new Service Requests process includes many validations by default, including validations that:

  • Prevent invalid data from being entered into certain fields.

    Field validation example

  • Ensure that all of the required information has been entered for an Service Request.

The Modifying Field Validations page describes the default validations and how to modify these validations.

Step 4: Create Service Request process templates

After you have configured your application, you can create the Service Request process templates to be used during the create new Service Request process. The Service Request process templates determine which tasks will be assigned by default for each new Service Request that is created.

You will need to understand your organization's current Service Request processes including:

  • What categories to organize the tasks by?
  • What are the distinct types of Service Requests that have a standard set of tasks?
  • What are all the tasks required to complete the various types of Service Request?
  • What types of tasks will your organization need?
  • Which business groups are responsible for each task?
  • What tasks rely on other tasks to be completed first?
  • What are the expected due dates for each task?

Before you create any templates, you will need to set up the attributes that will be used to select an Service Request template. The out-of-the-box, Service Request templates selected are based on the Service Request Type and Region of the Service Request. See the Solutions Hub User Guide for instructions on how to customize these attributes. See Template Selection Attributes.

You will also need to confirm which key dates the task due dates should be based on. By default, the task due dates are based off of the Service Request's target due date. You can modify key dates that are available for calculating task due dates.

When users create new tasks, they can choose from attach document, review, confirmation. If you need different types of tasks, you can add new automated or data entry task types. See Adding a New Task Type for instructions.

task_types.jpg

See Setting Up Service Request Workflows for more information, including how to manage task categories, tasks, and Service Request templates.

workflow_settings.png

Step 5: Import existing data

You can migrate data into Connected Servicing from other systems that your organization is using. This process is generally very unique and has its own nuances that depend on many factors.

Migrating Data provides the general steps to move customers, documents, accounts, and products into Connected Servicing.

Step 6: Internationalize display text (optional)

If your organization requires it, you can translate all of the text displayed in interfaces into multiple other languages using bundle files and reference data.

Before you begin, you will need translations for all of the text displayed in the UI.

See the Solutions Hub User Guide for instructions on how to modify UI text, including adding a new language.

Internationalizing the Connected Servicing application includes:

Step 7: Set up web APIs and integrations (optional)

After you complete the initial setup of the solution, you may want to take advantage of the various capabilities to extend the Connected Servicing application.

You can use web APIs and integrations to automatically create new Service Requests, classify documents, pull in customer information, and collect signatures.

Automatically create new Service Requests through a web API

Many organizations will be able to create new Service Requests automatically by kicking off an Service Request from another application, such as Salesforce.

See Create Onboarding Web API for information on the web API that is used to facilitate automatic Service Request creation.

Configure integrations

Several integrations are available to be used throughout Connected Servicing. These integrations need some initial prerequisite set up and minimal configuration in the System Administration Center in order to be used. Using these integrations is completely optional.

The available integrations are:

Step 8: Configure auditing for new fields (optional)

After setting up your initial CDTs, you may want to go back and track specific fields. You can use auditing to automatically configure this in your solution.

How to Set Up Connected Servicing

FEEDBACK