MuleSoft Accelerator for Financial Services

This page provides guidance on configuring the various systems and products required to implement the use cases provided by this solution.

Salesforce Financial Services Cloud

This section describes how to configure an existing Salesforce Financial Services Cloud (FSC) instance to support the default MuleSoft Accelerator for Financial Services functionality. These instructions assume that the required FSC packages have been deployed to the target Salesforce instance and that the appropriate permissions have already been assigned.

Record types

The following record type must be created in the corresponding object.

To create the Money Market record type in the Financial Account object, first create a page layout for it based on an existing account layout.

1. Click the Salesforce Setup icon
2. Select Object Manager tab from the Setup home page
3. Select the FinServ__FinancialAccount__c object
4. Select Page Layouts from the left nav and click New
5. Select an existing page layout (e.g., "Financial Account (Savings Account) Layout")
6. Set the Page Layout Name field to "Financial Account (Money Market Account) Layout"
7. Click Save to create the new layout

Now create the new record type:

1. Select Record Types from the left nav and click New
2. Select an existing record type (e.g., "Savings Account")
3. Fill out the following fields as indicated
   • Record Type Label -> "Money Market"
   • Record Type Name -> "Money_Market"
   • Description -> "Represents a money market account"
4. Enable the Active checkbox
5. In the list of profiles, check the Make available option the profile assigned to the target API service account (at a minimum)
6. Click Next and select the option Apply one layout to all profiles
7. Select the page layout "Financial Account (Money Market Account) Layout"
8. Click Save

The new record type should now be available in the Records Types section. You can verify that the new record type is also available to the target user profile as follows:

1. Click the Salesforce Setup icon
2. Navigate to Users -> Profiles
3. Select the target profile
4. Navigate to Object Settings -> Financial Accounts and click the Edit link
5. Verify that the new record type is listed under Record Types and Page Layout Assignments

Custom fields

The following fields must be created in the corresponding objects.

Note:
The Card_Type__c picklist values are DebitCard and CreditCard The Credit_Card_Type__c picklist values are Amex, Discover, Mastercard, Visa and Other

To create each of these custom fields and enable visibility for them on page layouts:

1. Click the Salesforce Setup icon
2. Select Object Manager tab from the Setup home page
3. Find and select the target Salesforce object
4. Select the Fields & Relationships page
5. Click the New button and create the field as specified above
6. Once the field has been created, click the Set Field-Level Security button
7. Enable for desired profile, or tick the master checkbox next to Visible to enable visibility for all profiles

Repeat these steps for each custom field in the above list.

Enable Financial Accounts in Sales

When the Financial Services Cloud feature is added to the Salesforce instance, the Commercial and Retail Banking apps are provided to work with financial accounts. If you want to enable the Financial Accounts tab on the Sales app, follow these steps:

1. Navigate to the Sales app home page
2. Click the pencil icon on the right corner of the navigation pane, which opens the Edit Sales App Navigation Items dialog box
3. Click Add More Items
4. Navigate to All under the Available Items menu
5. Search for Financial Accounts and Select it
6. Click Add 1 Nav Item and then click Save

Enable multiple currencies

The default implementation of the solution requires the enablement of multiple currency support in the target FSC instance. This can be done as follows:

1. Click the Salesforce Setup icon
2. Navigate to Company Settings -> Company Information
3. Click Edit and enable the Activate Multiple Currencies option
4. Click Save

If desired, click the Currency Setup button to add support for additional currency codes (e.g., EUR).

Create PushTopics

The following PushTopics must be created in order to capture updates from Salesforce. The apex scripts to create these PushTopics are located in the FINS Salesforce Topic Listener integration template.

Follow the below steps to create the above PushTopics

1. Click on Salesforce Setup icon
2. Select 'Developer Console' -> 'Debug'-> 'Open Execute Anonymous Window'
3. Copy and paste the script from the 'Apex script location' column in the above table and execute
4. Repeat above step #3 for all the Salesforce objects in the above table

Note All the PushTopics created above filters records based on LastModifiedBy <> 'Service account user Id'. This is to filter out updates done by the 'fins-salesforce-customers-sys-api' and 'fins-salesforce-financial-sys-api' to avoid cyclical updates. Ensure to replace the Id in the apex scripts.

Adding MailingAddress to Person Account Details page in Salesforce Org

The following instructions assume you have already Salesforce Org created and PersonAccount is enabled. Perform the following actions to enable MailingAddress on PersonAccount detail page.

1. Open the Salesforce SetUp -> Object Manager -> Search for 'PersonAccount' and Select
2. From the menu on the left Click on 'Page Layouts' -> Select the Page layout that is assigned to the user profile logged in
3. Click on 'Fields' tab on the palatte and it shows all the available fields
4. Search for 'MailingAddress'. Drag from the palette and drop it in the 'Address Information' section of the layout and click on 'Save'

Creating Contacts that are not associated with an Account

These instructions assume an Org was created in Salesforce with access to Contact object.

1. From the object management settings for contacts, go to Page Layouts.
2. Select the layout you want to edit.
3. Find the 'Account Name' field on the layout and hover over it. Then, click the wrench icon to show the field properties.
4. Deselect the Required checkbox and confirm your changes.

Install LWC components

FINS Financial Account Sync Lightning Web Component - This LWC allows users to sync customers, financial accounts, and transactions from a system of record to Salesforce Financial Services Cloud.

See the Source for information on how to install and configure the component.

ID Graph Lightning Web Component - This LWC displays a network graph relating a source record in Salesforce (as the root node) to N-number of systems (as child / edge nodes).

See the Source for information on how to install and configure the component.

Anypoint MQ Configuration

The Anypoint-MQ-Queues-Exchanges postman collection in the FINS Common Resources Project will pre-create all MQ destinations required by the accelerator components.

The collection will require the "dev" environment template be imported into your Postman workspace and assigned proper values first. The following MQ destinations will be created on successful execution.