Skip to main content
Knowledge Central
Aria Knowledge Central

Configure the Aria for Salesforce Application

  1. Last updated
  2. Save as PDF

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.

  1. Overview
  2. Set Up the Aria for Salesforce Loader 
    1. Configuring an Aria for Salesforce Integration User Profile to Support the Aria for Salesforce Loader Integration. 
    2. Creating an Aria for Salesforce Integration User to Support the Aria for Salesforce Loader Integration. 
    3. Assigning the Aria to Salesforce Integration User  
    5. Aria for Salesforce External Services Configuration to Support the Aria for Salesforce Loader Integration
  3. Setting Up Your Aria API Configuration in Salesforce 
  4. Importing Your Product Catalog Elements from Aria into Aria for Salesforce
    1. Import / Refresh Client Plans / Supplemental Fields from Aria
    2. One-Time Products
    3. Coupons
    4. Templates
  5. Enabling and Using Plan Instance Product Fields in Aria for Salesforce
    1. Enabling Plan Instance Product Fields in Aria for Salesforce
    2. Using Plan Instance Product Fields in Aria for Salesforce
  6. Batch Synchronization of Aria's Product Catalog to Salesforce  
  7. Turn On Sync Aria Transactions to SFDC Objects
  8. Account Re-Synchronization
    1. Account Supplemental Field Setup
    2. Triggering an Account Re-Synchronization
  9. Assign or Customize Your Page Layouts
    1. Assigning Aria Page Layouts to Your Salesforce Profiles
      1. "Lightning" Configuration for the Aria Quote Layout
    2. Customizing Your Existing Salesforce Page Layouts
  10. Account Plan Columns Configuration
  11. Aria Configurations
    1. Custom Sections
    2. Miscellaneous
    3. Permissions
    4. Plans
    5. Quick View
    6. Taxes
    7. Usage
  12. Using the App Manager to Configure Menu Options for your Aria for Salesforce Users

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 Administrative, Standard 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.

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.

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.

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 Product Catalog Elements from Aria into Aria for 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 Product Catalog elements from Aria into Aria 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 Aria for Salesforce.

Log into Salesforce

Click on Aria Product Catalog.png

  1. From the Aria Systems main menu, click on Aria Product Catalog.

Import / Refresh Client Plans / Supplemental Fields from Aria

Product Catalog_Plans Screen.png

  1. Click on the Refresh Plans or Refresh Supplemental Fields button to facilitate the on-demand syncing of Aria Plans or Aria Plan Supplemental Fields from your Aria client instance to your Salesforce.com/Aria for Salesforce application.  

Note: When either button is clicked, a small spinner and progress-ring appears next to the 'Refresh' button indicating that a sync is in progress. The 'Refresh' buttons are disabled while the sync is in progress. 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 import from the Salesforce Setup menu, click Environments > Jobs > Apex Jobs .

  1. Use the Master Plan Name search field to type search information for the search and display of a specific Plan or set of Plans in line with your search text. 
  2. Click on a Plan's right arrow symbol to display any Supplemental Plans associated with a Master Plan.
  3. To view a Master or Supplemental Plan's service and rate schedule details, click on the Plan Name's blue hyperlink. A drawer window opens displaying the Plan Name, Services and Rate Schedules associated with the Plan. When there are multiple rate schedules with multiple defaults, the rate schedules are sorted alphabetically by currency. Use the scroll bar in this section of the window to see additional services and rate schedules associated with the Plan.
  4. Click on a Rate Schedules right arrow to open the services and rates specific to that rate schedule. 
  5. To view more details regarding the Plan, click on the View More Details button.

The "Client Plan" Details screen is displayed as shown below.

Products_Detail Screen.png

Note: Aria for Salesforce does NOT currently support the bi-directional syncing of Product Catalog (Plan) elements. Thus, this screen is provided for viewing and informational purposes ONLY. Any edits made to field elements shown here will not be synced back to Aria.

  1. Click on the 'X' in the upper right to close the drawer window. 

One-Time Products

Products_One Time Products Screen.png

  1. Use the One Time Product Name search field to type search information for the search and display of a specific One Time Product(s) per your search text. 
  2. To view a One-Time Product's service and rate schedule details, click on the One-Time Product's blue hyperlink. A drawer window opens displaying the One-Time Product's service and rate schedule(s). When there are multiple rate schedules with multiple defaults, the rate schedules are sorted alphabetically by currency. Use the scroll bar in this section of the window to see additional services and rate schedules associated with the Plan.Click on a 'One Time Products Name'.
  3. Click on a Rate Schedules right arrow to open the service and rates specific to that rate schedule. 
  4. To view more details regarding the One-Time Product, click on the View More Details button.

A One Time Product's "Drawer Window" opens as shown below.

Product_One Time Product Details Screen.png

Note: Aria for Salesforce does NOT currently support the bi-directional syncing of Product Catalog (One-Time Product) elements. Thus, this screen is provided for viewing and informational purposes ONLY. Any edits made to field elements shown here will not be synced back to Aria.

  1. Click on the 'X' in the upper right to close the drawer window. 

Coupons

Products_Coupons Screen.png

  1. Click on the Refresh Coupons button to facilitate the on-demand syncing of Coupons from your Aria client instance to your Salesforce.com/Aria for Salesforce application. When clicked, a small spinner and progress-ring appear next to the Refresh Coupons button indicating that a sync is in progress. 
  2. Use the Coupon Code search field to type search information for the search and display of a specific Coupon(s) per your search text. 

Templates

Products_Templates Screen.png

  • Use the Template Name search field to type search information for the search and display of a specific Template(s) per your search text. 

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. 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 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 into 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.png777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777777

  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

Aria Configurations

This feature supports the enabling/configuring of various elements such as the setup of custom sections, user permissions, plan access, account quick view options, usage types, and taxes.

Logon to Salesforce

Click on Aria Configurations.png

From the Aria Systems main menu, click on the Aria Configurations menu tab.

The Aria Configurations screen is displayed as shown below, and the Custom Sections tab is opened by default.

Custom Sections

Custom Sections allows Aria for Salesforce users, with the appropriate permission level, to add custom Lightning sections to the Aria for Salesforce Manage Plans screen.

Custom Section.png

  1. Type in a Section Name.
  2. Type in a Custom Header Name. (It can be the name of a Standard Salesforce Custom Label).

Note: If the Custom Header Name field is left blank, then the name of the Custom Section on the Manage Plans screen will be the text entered in the Section Name field. If a custom label name is entered in the Custom Header Name field, then the name of the custom section in the Manage Plans screen will be the value of the Custom Label. 

  1. Enter the Lightning Component Name. You must prepend the Component Name with "ASF3:"

Note: A Lightning component is a compact, configurable, and reusable element. You use components to build apps and custom pages. The Lightning Component framework has two development models. Aura is the original model. Lightning Web Components (LWC) is the newer model. Develop Lightning web components using standard HTML, JavaScript, and CSS. 

  1. In the Position field, choose Insert Up if you want the navigation link for the component to be above the specified navigation link (next step). Choose Insert Down if you want navigation link to be below specified navigation link. In the From field, choose the existing navigation link you want to precede or follow.
  2. Click the All Profiles check box, if you want to provide access to the Lightning Component to all user profiles. 
  3. Click the Profile Access field's down arrow to limit access to the Lightning Component to selected user profiles.
  4. Click on the Visible on Manage Plans Section field's checkbox to make the new custom section visible on the Manage Plans screen.
  5. Click on the Save button to save this new Custom Section. Clicking the Reset button resets the screen back to its original state for any edited draft changes (unsaved values). 
  6. The new Custom Section will display in the Existing Custom Section of the screen. Click on the Action / Edit links (in blue) to edit or delete the Custom Section.

Below we see the new Custom Section has been added to the Manage Plans screen.

New Custom Section Added to Manage Plans Screen.png

Miscellaneous

Allows Aria for Salesforce users, with the appropriate system permissions, to configure miscellaneous settings.

Miscellaneous Screen1.png

Miscellaneous Screen2.png

Miscellaneous Screen3.png

  1. Click on the Miscellaneous menu tab to open this section.

The four(4) sections of this screen include miscellaneous settings respective to Account, Contract, Opportunity, and Other Configurations. The Account section and it's associated configuration settings is opened by default. Click on any section's 'blue arrow' to open configuration settings specific to that section.

  1. Click on the Account Status field's dropdown arrow and select a default account status. This selection governs the default account status for a new account when creating an opportunity. Selection options include Active, Registered Pending Activation, Temporary Service Ban, Permanent, Archived, and Deactivated. To disable the New Account Billing Option popup on the Manage Plans screen, click on the field's checkbox.
  2. Click on the Account Search By field's dropdown arrow and select a default search by condition. Selection options include Account Name, Client Account ID, and User ID. Use the If multiple accounts found, update the account with field's dropdown arrow and select the option you desire to update the account. Selection options include Earliest Created Date, Last Created Date, Earliest Modified Date, or Latest Modified Date. 
  3. Click on the Contract Completion field's dropdown arrow and select a default contract completion option. This selection governs the default option for contract completion on the Manage Plans screen. Selection options include Date Range, and Duration.
  4. Click on the Opportunity Allow Commit and/or Allow Save as Draft check boxes to allow these permissions when creating an Opportunity. Both actions are checked and allowed by default.
  5. Click on the Other Configurations' Aria Contact Detail Sync field's User Aria Contact Detail Object check box to enable the creation of Aria contact records after Aria for Salesforce has been installed on your Salesforce application. 

Note: Enabling this setting will have the effect of no longer updating the Salesforce standard contact. This can only be enabled once and cannot be undone. Enabling and then disabling this setting will result in a non-functional contact-sync.

  1. Type in the SSL Configuration 'Certificate Name'. An SSL Certificate Name is needed for making an API call from the Aria for Salesforce connector.

Note: Before adding a certificate, you must install it in Salesforce using Salesforce's Certificate and Key Management function. Refer to the Salesforce help documentation for these instructions.

  1. Type in a Person Account Record Type Developer Name. 

Note: Once Person Accounts is enabled, it cannot be disabled. It is recommended that you review and consider the effects of enabling this feature in your Salesforce tenant. You can review information by searching Personal Accounts in Quick Find via the Salesforce Setup menu.  More information is also available at Enable Person Accounts in Salesforce - Apex Hours

  1. Type in a 'Dummy Email' in the Configure Dummy Email field.  This email is considered to be the contact if do not use email is set to True.
  2. Click on the Save button to save your changes.

Permissions

Allows Aria for Salesforce users with the appropriate system permission level to configure a collection of settings and permissions that give users access to various functions. Custom Permission Sets extend user’s functional access without changing their profiles. 

Permissions Section.png

  1. Click on the Permissions menu tab to open this section.
  2. Click on each desired Restrict Actions and Access element's blue dropdown arrow and select the desired custom permission to apply to that element.

Note: Custom Permissions are first created via the Salesforce Setup > Custom Code > Custom Permissions menu selections and then assigned to Users to provide access to that specific element's functionality.

  1. Click on the Save button to save your changes.

Plans

Allows Aria for Salesforce users with the appropriate system permission level to configure profile access to your subscription plans.

Plans Section.png

  1. Click on the Plans menu tab to open this section. 
  2. Click on the All Profiles column label's check box to allow complete Plan access to all User Profiles configured in the system.
  3. Conversely, use the Plan detail section to alternatively allow an individual Plan's access to All User Profiles by clicking the All checkbox, or click on the Select Profiles dropdown arrow to select specific profiles having access.
  4. Click on the Save button to save your Plan's billing and access configuration.

Quick View

This feature allows for the selecting of metric components that will be displayed on the Account "Quick View".

Quick View Section.png

  1. Click on the Quick View menu tab to open this section.
  2. Click on the Show checkbox to select ALL metric components. By default, the "Show" field is unchecked.
  3. Click on each individual metric component(s) checkbox to select any subset of components. Only those checked will appear in the Accounts "Quick View".
  4. Click on the Save Settings button to save this Account "Quick View" setting.

Note: Metric components are automatically sized and arranged (no blank areas) on the Account "Quick View" regardless whether ALL or just a subset of metric components are selected.

Taxes

Allows Aria for Salesforce users with the appropriate system permission level to configure tax percentages for Tax Groups synced from your Aria client instance to your Aria for Salesforce application. These are then applied to an Opportunity or a Quote for a tax estimate.

Note: Tax Groups are synced along with Plans from your Aria client instance to your Aria for Salesforce application when Plans are refreshed via the > Aria Systems > Product Catalog > Plans > Refresh Plans selections in Aria for Salesforce.

Taxes Screen.png

  1. Click on the Taxes menu tab to open this section.
  2. Click on the Enabled Taxes slider button to enable taxes.
  3. Type in a Percentage for each Tax Group.
  4. Click on the Save button to save your changes.

Usage

Allows Aria for Salesforce users with the appropriate system permission level to configure usage types to be used in the Usage Type filter when viewing Aria Usage history on an account.

Usage Screen.png

  1. Click on the Usage menu tab to open this section.
  2. Click on the Refresh Usage Types button to sync usage types in your Aria client instance to your Aria for Salesforce application in Salesforce.
  3. Click on the Available Usage Types fields Select All checkbox to include all usage types in the Usage Type filter when viewing Aria Aria Usage history for an account.
  4. Alternatively, click on selective individual usage types checkbox(s) to limit the filter selections for viewing Aria Usage history for an account.
  5. 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

  1. Back to top
  • Was this article helpful?

Recommended articles

  1. Page type
    Topic
  2. Tags
    This page has no tags.