Skip to main content
Aria Knowledge Central

Configure the Aria for Salesforce Application

Overview

Once you complete the pre-installation tasks and install the Aria for Salesforce application, you are ready to configure Aria for Salesforce. The following details the various configuration elements and necessary steps for configuring your Aria for Salesforce application.

Set Up the Aria for Salesforce Loader 

When account related data changes in Aria, it’s synced to Salesforce via the Loader. When an Aria-related account data is updated in Salesforce, the Aria For Salesforce.com Connector sends out an Aria API call to update the account in Aria. This method optimizes account data synchronization of accounts and transactions.

afs_loader_3.png

The Aria for Salesforce Loader does not depend on call backs from Aria to Salesforce to do the syncing. When an account is updated in Aria, a micro service generates additional account data from Aria, then processes the data via low latency REST APIs or bulk API calls to Salesforce. 

Tuning the balance between low latency and high-volume throughput happens automatically. This method of syncing eliminates the overhead of Aria call backs to Salesforce and API call outs from Salesforce. It improves overall integration efficiency and provides higher volume throughput capability for accounts and transactions.

Note: You must submit a request to Aria Customer Support to enable this synchronization process.

Configuring an Aria for Salesforce Integration User Profile to Support the Aria for Salesforce Loader Integration. 

You must first create and configure a custom profile in Salesforce that will be assigned to an Aria for Salesforce Integration User that has the necessary Administrative, Standard, and Custom object permissions. 

Log Into Salesforce

Click_on_Setup_Icon.jpeg

  1. Click on the Setup icon and click Setup.

Click_on_Users_Profiles.jpeg

  1. Click on the Users drop-down arrow, and then click Profiles.

Click_on_New_Profile_Button.jpeg

  1. Click on the New Profile button.

Clone_Profile.jpeg

  1. Click on the Existing Profile field's drop down arrow, and select System Administrator, as the profile you want to clone. 
  2. Type in a new Profile Name. In this example, we are naming the new profile, "Aria for Salesforce Integration Profile".
  3. Click on the Save button to save this new profile.

Edit_Profile.jpeg

  1. Click on Edit to configure AdministrativeStandard and Custom Object settings for this profile, which are required for the Loader, that will be assigned to the Aria for Salesforce Integration User.

API_Enabled.jpeg

  1. Scroll down the page to the Administrative Permissions section, and check to ensure that  "API Enabled" is selected (checked)

Note: This profile requires that "API Enabled" be activated . You can select any other Administrative Permissions you require.

Accounts_Contacts_Opportunities.jpeg

  1. Scroll down the page to the Standard Object Permissions section, and check that the (Read, Create, Edit, Delete, View All, and Modify All) boxes are selected (checked) for Accounts, Contacts, and Opportunities.

Custom_Objects.jpeg

  1. Scroll down the page to the Custom Object's section. And select (check) permission settings for the Aria Custom Objects as referenced  in Custom Object Field Settings.

Save_Integration_Profile.jpeg

  1. Scroll down to the bottom of the page and click on the Save button to save this new profile.

Go to Top

Creating an Aria for Salesforce Integration User to Support the Aria for Salesforce Loader Integration. 

Setup_User_Users_Menu.jpeg

  1. From the Salesforce Setup Home menu, click on the Users down-arrow key, and then click on Users.

Click_on_New_User.jpeg

  1. Click on the New User button.

Create_Integration_User_Save.jpeg

Note: The above screen provides an example of a Salesforce user created to facilitate the Aria for Salesforce Loader integration. In this example, we are creating a user with a Username of "xyzintegrationuser@xyzcompany.com". 

  1. Create a Username.
  2. Click on the User License field's drop-down arrow, and select Salesforce from the available options.
  3. Click on the Profile field's drop-down arrow, and select the Aria for Salesforce Integration User profile you created in the previous section.
  4. Click on the Save button.

Note: Salesforce fields "piped" in red are required.

Go to Top

Assigning the Aria to Salesforce Integration User  

Custom_Settings.jpeg

  1. From the Salesforce Setup Home menu, click on the Custom Code down-arrow key, and then click on Custom Settings.

Manage_Aria_Custom_Settings.jpeg

  1. Click on Manage next to Aria Custom Settings.

Edit_Aria_Integration_User_Name.jpeg

  1. Click on Edit next to ARIA_INTEGRATION_USER_NAME.

Save_Integration_User_Username.jpeg

  1. Type in the Username of the Aria to Salesforce integration user you created in the previous section.
  2. Click on the Save button to save this user as the Aria Integration User.

Go to Top

Aria for Salesforce External Services Configuration to Support the Aria for Salesforce Loader Integration

The Aria for Salesforce Loader requires an external services configuration be enabled within your Aria tenant to support the syncing of account information to your Salesforce tenant. 

Login to Aria 

Getting Here: Configuration > Integrations > External Services

Click_New_External_Services.jpeg

  1. Click on the New button to create a new Salesforce external service integration.

Create_New_External_Service.jpeg

  1. Click on the Destination drop down arrow and select SalesForce.com.

Note: The settings on this page are typically configured by the Aria for Salesforce Administrator at your company, who is responsible for setting up, and monitoring your Aria for Salesforce integration. 

External_Service_Configuration.jpeg

  1. Type in "true" in the Enable Connection field to automatically transfer data from Aria to your Aria for Salesforce application in Salesforce.

Note: The default value for this field is "false". When set to false or left blank the Aria for Salesforce Loader will not sync any data to Salesforce.

  1. Type in the "Salesforce" Username of the user you created and configured in your Salesforce tenant to facilitate the system-to-system integration between Aria and Salesforce in support of the Aria to Salesforce Loader.

Note: This user is NOT required to be actively logged into your Salesforce tenant for the Loader integration to work. 

  1. Type in the "Salesforce" Login Password of the above referenced Salesforce User.
  2. Type in the "Salesforce" Security Token of the above referenced Salesforce User.

Note: A user can obtain their security token by changing their password, or resetting their security token via the Salesforce user interface. When a user changes a password, or resets the security token, Salesforce sends a new security token to the email address on the user's Salesforce record. The security token is valid until the user resets the security token, changes a password, or has a password reset.

  1.  Leave the API Version field blank unless otherwise directed.

Note: When left blank, The API Version field defaults to the most recent Salesforce REST API version supporting the Aria for Salesforce application. Newer API versions own/provide new functionality and thus the option exists to update this field to a new API version.

  1. Type in "true"  in Map Company Name to map the account's Company Name field in Aria to the account's Name field in Salesforce. 

Note: The default setting for this field is "false". False will map the Aria account number to the account's Name field in Salesforce in the form of  "Aria Account XXXXXX". This field setting does not apply to consumer / person accounts.

  1. Type in the desired Objects to Transfer (NON case_sensitive) to Salesforce, separated by a comma, per the list shown below:
    • Account_Coupon_Assignment
    • Plan_Instance_Coupon_Assignment
    • Account
    • Contact
    • Comment
    • Billing_Group
    • Payment_Method
    • Dunning_Group
    • Contract
    • Invoice
    • Plan_Instance
    • Order
    • Statement
    • Transaction

Note: By default (field left blank), Aria will transfer all objects to Salesforce.

  1. The Disabled Object Fields should currently be left blank. 
  2. The current default value for BULK API Min Threshold is 15, if left blank. Jobs smaller than this threshold will use the standard SFDC REST API instead of the Bulk API Loader

Note: Clients should contact Aria's Customer Support, or Professional Services team before changing this default.

  1. The default value for Allow Company Default Name is "false". 

Note: If set to "true", the account name will be generated automatically in Salesforce. 

  1. Click on the Save button to add this external Salesforce destination.

Go to Top

Setting Up Your Aria API Configuration in Salesforce 

In your Salesforce - Aria for Salesforce API configuration, you provide your login credentials for accessing your Aria client, the promotion code that will be used to display plans in Salesforce, the Aria environment that your Salesforce account should point to, and the email address(es) at which you want to receive error notifications. Salesforce will point to your most recently created API configuration.

Note:

If you have a Salesforce account for testing and a different account that you use in production, it is recommended that you:

  • Set up an Aria API configuration under your Salesforce test account that points to the Aria stage environment.
  • Set up an Aria API configuration under your Salesforce production account that points to the Aria production environment.

If you do not have separate Salesforce test and production accounts, it is recommended that you:

  • Create an API configuration that points to the Aria stage environment.
  • Complete your testing.
  • Create an API configuration that points to the Aria production environment.

To set up your Aria API Configuration in Salesforce, perform the following steps:

Log into Salesforce

Aria_Systems_Menu.jpeg

  1. Click Aria Systems from the Salesforce drop-down menu.

Add_New_Aria_API_Configuration.jpeg

  1. Click on the New button.

New_API_Configuration_Screen.jpeg

Complete the fields as described below: 

  1. Client No:   Enter your Aria-assigned client identification number.
  2. Auth Key:   Enter your Aria-assigned authorization key.

Note: Your Client No, and Auth Key can be found in your Aria tenant via the > Configuration > Integrations > Web Service API tabs 

  1. Promo Code: Type in the promotion code that will be used to retrieve/sync the Aria plans that you want to make available to select within your Salesforce tenant. 

Note: You must first create a Promotional Plan Set in Aria that includes the Aria Plans you want to make available in Salesforce via the > Marketing > Promotional Plan Sets tabs in Aria. You then create a Promotion (Promo Code) that includes the Promotional Plan Set you created via the > Marketing > Promotions tabs.

  1. Type/Copy the Aria Admin Tool URL to be used for accessing AdminTools from within Salesforce:
  1. Type/Copy the Aria Remote Site URL to be used for accessing the Aria Web Services API.
  1. Click/Check Map Company Name with Account Name.
  2. Type in the Failure Notification Email address(es) at which you want to receive error notifications.  You can enter up to 5 email addresses separated by commas.
  3. Click on the Save button to save the Aria for Salesforce API Configuration.
  • s) at which you want to receive error notifications. You can enter up to 5 email addresses separated by commas.

Note: Clients, who are using Aria Remote Site URL's outside of the US environment, also need to add this URL to Salesforce's Remote Site Settings configuration. This configuration setting enables call outs to the Aria URL's from within Salesforce. Access this configuration via the Setup > Administer > Security Controls > Remote Site Settings tabs, and click on the "New Remote Site" button. Name, and Add this URL to your Remote Site Settings configuration. As an example, if your Aria client tenant in Production is based in Europe, you would use https://secure.prod.cph.ariasystems.net      

Go to Top

Importing Your Plans from Aria into Salesforce

After setting up your Aria API configuration in Salesforce, and having previously whitelisted the Salesforce IP addresses in your Aria tenant, you can now import your plans from Aria into Salesforce. Only those Aria plans associated to the Promotional Plan Set / Promotion Code that you set up in Aria, which is associated with your Aria API Configuration in Salesforce will be imported into Salesforce.

Log into Salesforce

Import_Client_Plans.jpeg

  1. From the Aria Systems main menu in Salesforce, click on Client Plans.

Click_on_Refresh_Client_Plans_from_Aria.jpeg

  1. Click on Refresh Client Plans from Aria.

Note: It may take more than 15 minutes to import your plans from Aria depending on the number of plans associated with your specified promotional plan set / promotion code. To check the status of the from the Salesforce Setup menu, click Environments > Jobs > Apex Jobs .

After the job is complete, the imported plans display under the Client Plans tab as shown below.

Client_Plans_in_Salesforce.jpeg

Go to Top

Enabling and Using Plan Instance Product Fields in Aria for Salesforce

Users can access and enter plan instance product fields from within Aria for Salesforce. In order to do this, you need to create and configure plan instance product fields in your Aria tenant, and then sync those fields via on-demand sync within Aria for Salesforce. Users can then see and assign these fields when using the Accounts' Plans wizard from within Aria for Salesforce.

Note: See Create Product Fields for instructions on creating and configuring plan instance product fields in Aria.  

Below is an example of the Product Fields screen in Aria:

Aria Product Fields.jpg  

You can assign a plan instance product field to a Plan in Aria as shown below:

Plan Instance Product Field Assigned At Plan Level.jpg

Note: A Plan Instance Product Field with an associated field value can be assigned to a Plan at the Product Catalog level. The Plan Instance Product field and field value will then be automatically saved to all plan instances for accounts purchasing the plan.

Plan Instance Product Field Not Assigned At Plan Level.jpg

Note: A Plan Instance Product Field with a null field value supports the assignment of a unique value for any accounts purchasing an instance of the Plan. 

Enabling Plan Instance Product Fields in Aria for Salesforce

Click on Create_Update Plan Supp Fields.jpg

  1. From the Aria Systems' main menu, click on Client Plans.
  2. Click on Create/Update Plan Supp Fields to refresh Aria Plan Instance Product Fields into Aria for Salesforce.

Note: Repeat this process to update new/updated Plan Instance Product Fields from Aria into Aria for Salesforce.

Using Plan Instance Product Fields in Aria for Salesforce

Click on Plan Actions Drop Down Arrow.jpg

  1. From the Accounts' Plan Wizard screen, click on the Plans' Actions down arrow, and then click Configure.

Note: See Creating Accounts Using Aria for Salesforce Opportunity and Quote Management for instructions on creating accounts and assigning plans.

Type in Product Field Value and Save.jpg

  1. Type in a field value for the desired Plan Instance Product Field.
  2. Click on the Save Button.

Save and Commit Plan for Product Field.jpg

  1. Click on the Save button to save this Plan Instance Product Field and field value for the associated plan.
  2. Click on the Commit button to save the new plan/plan changes to Aria.

Note: A Plan Instance Product Field value entered and committed to Aria in this fashion will have primacy and override any field value saved with the Plan at the Product Catalog level. 

Go to Top

Batch Synchronization of Aria's Product Catalog to Salesforce  

You need to schedule one Apex job, AriaBatchProductFieldSyncScheduler, to refresh new/changed Aria plan data in Salesforce.

Note: The AriaBatchProductFieldSyncScheduler job takes approximately one hour to run. 

Login into Salesforce

Setup_APEX_Job.jpeg

  1. From the Salesforce Setup Home menu, click on the Custom Code drop down arrow and then click Apex Classes.

Click_on_Schedule_Apex.jpeg

  1. Click on Schedule Apex.

Meaningful_Job_Name.jpeg

  1. Type in a meaningful Job Name

Select_Apex_Class.jpeg

  1. Click the Apex Classes' search symbol.
  2. Click AriaBatchProductFieldSyncScheduler from the available options.

APEX_Job_Freq_Dates_Time.jpeg

  1. Click on all days for Frequency.
  2. Type in or select the Start, and End dates for the job to run.
  3. Click on the Preferred Start Time at which this job should run every day.

Note: You should select a Preferred Start Time that falls within off-peak hours.

  1. Click on the Save button to save and schedule this job.

The newly scheduled Apex job, as shown below, can be found in the Salesforce Setup Home menu under > Environments > Jobs > Scheduled Jobs.

Apex_Scheduled_Jobs.jpeg

Go to Top

Turn On Sync Aria Transactions to SFDC Objects

Clicking the Refresh Aria Transactions button on the Aria for Salesforce Accounts page pulls transaction records (transactions, statements, comments, payments, refunds, invoices, etc.) on-demand from Aria into Aria for Salesforce. To enable this functionality, perform the following steps.   

Log into Salesforce

Custom_Settings.jpeg

  1. From the Salesforce Setup Home menu, click on the Custom Code down-arrow key, and then click on Custom Settings.

Click on Manage to Support Refresh Aria Transactions_2.jpg

  1. Click the Manage link next to Aria Custom Settings.

Click on Edit Button Next to Sync Aria Transactions to SFDC Objects_2.jpg

  1. Click the Edit link next to SYNC ARIA TRANSACTIONS TO SFDC OBJECTS.

Click on Setting Boolean Key_Description_Save.jpg

  1. Click the Aria Boolean Key checkbox
  2. Type in an Aria Key Description (for example: Refresh_SyncAria Transaction)
  3. Click on the Save button.

Go To Top

Account Re-Synchronization

There are occasions when it may be required, either manually or programmatically, to cause one or more accounts to be fully re-synchronized. The process of performing an account re-synchronization requires that a special account supplemental field be created in Aria which is modified, per account, each time you want to trigger a re-synchronization.

Account Supplemental Field Setup

Before any account re-synchronization, you need to create the following account supplemental field.

Log into Aria

Getting Here: Configuration > Client Settings > Account Fields > New

Account_Sync_New_Account_Field.jpeg

  1. Click on the New button.

Create_SYNC_Account_Field.jpeg

  1. Type in a Field Name of SYNC_ACCOUNT.
  2. Type in a Description. In this example "This account supplemental field supports the full account synchronization between Aria and Salesforce".
  3. The Field Order will automatically populate based on the number of Account Fields previously created in your Aria tenant.
  4. Use the Required field's default selection of No.
  5. If you plan to use the Aria UI to re-synchronize an account(s), select No from the Hidden fields drop down. If you plan to programmatically re-synchronize accounts, select Yes from the field's dropdown.
  6. Use the Presentation Mode field's default selection of Text input.
  7. Use the Minimum Selection field's default value of 0.
  8. Use the Maximum Selection field's default value of 1.
  9. Click on the Save button to save this new account supplemental field.

Triggering an Account Re-Synchronization

For a given account, you must set the SYNC_ACCOUNT account supplemental field value to the current Unix epoch timestamp, seconds since January 1, 1970 at 00:00:00 GMT (1970-01-01 00:00:00 GMT).

As an example, if the current time was 2018-07-19T22:11:38Z, the seconds since the epoch would be 1532038298.

The following is a link to an external website that provides information on how to get the epoch time in seconds in various programming languages: https://www.epochconverter.com/#code

Once this is done, the system supports the following logic:

  • The system will examine any changes to an account's supplemental fields looking for the SYNC_ACCOUNT supplemental field.
  • If the key is Not present, supplemental field processing will proceed as normal.
  • If the key is present, the timestamp will be examined:
    • If it is Not a valid timestamp, the supplemental field processing will proceed as normal.
    • If the timestamp is valid and is within a certain system-wide threshold, and has not already been recently processed (based on local cache):
      • A full re-synchronization of the account and all associated objects will occur.
      • The timestamp is added to local cache to prevent reprocessing.
    • If the timestamp is outside of the system-wide threshold or has recently been processed (based on local cache), normal supplemental field synchronization will occur.

Go To Top

Assign or Customize Your Page Layouts

In order for your Salesforce users to be able to utilize Aria functionality in Salesforce, they must have access to the applicable Aria page layouts or access to Aria controls (fields, buttons, etc.) on your existing Accounts, Contacts, Opportunities, and Quotes layouts.

To provide your Salesforce users with access to Aria functionality, you can do either of the following:

  • If you are new to Salesforce, assign Aria page layouts to your Salesforce profiles.
  • If you have previously used Salesforce, customize your existing page layout. This will allow you to display the same controls as the Aria page layouts.

Assigning Aria Page Layouts to Your Salesforce Profiles

If you are new to Salesforce, you want to assign Aria page layouts to your Salesforce profiles by following the steps below. You may then choose to customize the Aria page layouts by removing and/or rearranging controls on them.

Log into Salesforce

Click_on_Object_Manager_Tab.jpeg

  1. From the Salesforce Setup menu, click on the Object Manager tab.

Click_on_the_Account_Label.jpeg

  1. Click on the Account label.

Click_on_Page_Layouts.jpeg

  1. Click on Page Layouts.

Click_on_Page_Layout_Assignment_Button.jpeg

Note: Click on any of these page layouts to view what each looks like.

  1. Click on the Page Layout Assignment button.

Click_on_the_Edit_Assignment_Button.jpeg

  1. Click on the Edit Assignment button.

Edit_the_Page_Layout_Assignment.jpeg

  1. Click on a Salesforce Profile in order to change it's Account Page Layout.

Note: You can select multiple profiles by using Ctrl + click or Shift + click. Your selected profiles will be highlighted.

  1. Click on the Page Layout to Use drop-down arrow and select (click) on the Aria page layout you want to assign to the Salesforce profile(s).
  2. Click on the Save button.

Note: Repeat Steps 1 - 8 above to assign the Aria page layouts for Contacts, Opportunities, and Quotes to your Salesforce profiles.

"Lightning" Configuration for the Aria Quote Layout

 

Note: The Aria Quote Page for the Lightning interface comes installed with the Aria for Salesforce application

In order to set the Aria Quote Layout for the Lightning interface after you have installed Aria for Salesforce.com, you need to perform the following steps:

Log into Salesforce.

From the Salesforce Setup menu, click on the Object Manager > Quotes tabs.

Click on Lightning Page Layouts to Set Aria Quote Layout.png

  1. Click on Lightning Record Pages.

Click on Lightning Record Pages_Aria Quote Page.png

  1. Click on Aria Quote Page.

Click on Light Record Pages_Aria Quote Page_Edit.png

  1. Click on the Edit button.

Click on Lightning Record Pages_Aria Quote Page_Edit_Activation.png

  1. Click on the Activation button.

Click on Lightning Page_Aria Quote Page_Edit_Activation_Assign as Org Default.png

  1. Click on Assign as Org Default.
  2. Click on the Close button.

Click on Desktop_Phone_Next.png

  1. Click on the Desktop and phone radio button.
  2. Click on the Next button.

Click on the Save Button to Save Aria Quote Page from Lightning.png

  1. Click the Save button in the Edit layout view to save this as the default Aria Quote Page.

Customizing Your Existing Salesforce Page Layouts

If you have previously used Salesforce, you should customize your existing layouts so that they display the same controls as the Aria page layouts. To see what the Aria page layouts look like:

Log into Salesforce.

From the Salesforce Setup menu, click on Object Manager > Accounts, Contacts, Opportunities, or Quotes > Page Layouts tabs.

Click_on_Account_Page_Layout_Drop_Down_and_Select_Edit.jpeg

  1. Click Edit next to your existing (non-Aria) page layout that you want to customize.

Drag_and_Drop_Aria_Fields_Controls.jpeg

  1. Drag and drop your chosen Aria fields/controls from the top of the page to the desired location on the page layout. You should add the same controls that are on the corresponding Aria page layout.
  2. Click on the Save button.
  3. Repeat Steps 1 - 3 above to customize your existing Contacts, Opportunities, and Quotes layouts.
  4. Verify that your chosen page layouts are assigned to the applicable profiles.

Go to Top

Account Plan Columns Configuration

You can configure the plan columns for active plans subscribed to by the customer as displayed via the Accounts > Account Overview > Account Plan > Active tabs within Aria for Salesforce as shown below: Column Display.jpg

Log into Salesforce

From the Salesforce Setup menu, click on the Object Manager > Account Plan > Field Sets tabs.

Click on Accont Plan Hierarchy Field Set.jpg

  1. Click on the Aria Account Plan Hierarchy field label.

Drag and Drop Field to Field Set.jpg

  1. Drag and drop a desired field(s) from the Account Plan field source to the field set container. Reverse this action to remove fields from the field set container. To change the order of a rendered field, drag a field up or down the list and drop the field in the order you want it to appear.
  2. Click on the Save button to save your changes.

Go to Top

Using the App Manager to Configure Menu Options for your Aria for Salesforce Users

You can use the App Manager to configure menu options that will be available to your Aria for Salesforce users. To do this, perform the following steps: 

Setup_Apps.jpeg

  1. From the Salesforce Setup Home menu, click on the Apps down-arrow key, and then click on App Manager.Edit_Aria_Systems_App_Manager.jpeg
  2. Click on the Aria Systems drop-down arrow, and then click on Edit

Use_Add_Remove_Arrows.jpeg

Assign_Menu_Options_to_Profiles.jpeg

  1. Click on any of the Available/Selected Tabs and use the Add/Remove arrows to add/remove menu tabs to the Aria for Salesforce application. Use the Up/Down arrows to position the selected menu tabs.
  2. Click on the various Profiles' check boxes you want to have access to the selected menu options.
  3. Click on the Save button.

The selected Profiles will have access to the selected menu options when using Aria for Salesforce as shown below:

Aria_Systems_Menu.jpeg

Go to Top

  • Was this article helpful?