The Nitrogen Managed Package for Salesforce allows users to sync Client and Portfolio Risk Numbers to Contacts in common versions of Salesforce. If your organization uses Person Accounts (such as with Financial Services Cloud), see the notes at the bottom of this article.
This article describes the steps your Salesforce Administrator needs to take before the Salesforce integration can be enabled by individual users. All steps must be completed for the integration to work correctly.
Looking for instructions on how to use the Salesforce.com integration? Here's how.
Install the Nitrogen Managed Package
The Nitrogen Managed Package is available via the link below. Install the package and then proceed with setting up the custom Contact fields required for the Nitrogen integration.
Steps to Install:
- Install the Managed Package using this link: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t37000000IiAg
- Choose Install for All Users and click Install:
- You'll see a message that the Installation is complete, click Done to finish.
Success! Now you're ready to set up custom Contact fields.
Set up Custom Fields in Salesforce
These instructions are for Salesforce Lightning. See the Salesforce help article for Setup Home in Lightning if you are unfamiliar.
There are four custom Contact fields that must be created for the integration to function properly. If your organization uses Person Accounts, see the special notes at the end of this article.
Set Up the "Link to Nitrogen" Field
This configuration adds a Nitrogen link to the Contact layout. Salesforce users can click this link to go directly to the linked profile in Nitrogen. If the contact is not linked yet, a new active Nitrogen client will be created.
- In Salesforce, go to Setup>Object Manager>Contact>Fields & Relationships
- Click New
- Select the Data Type: Formula
- Set Field Label to: Link to Nitrogen
- Select Return Type: Text
- Click Next
- Copy and paste the following formula into the Formula box:
HYPERLINK("https://pro.riskalyze.com/api/connect/salesforce/" & CASESAFEID(Id), "View Client Profile")
- Click Next
- Set the field via the "Field Level Security" button to Visible and Read-Only for all users/groups that should have access to the Nitrogen data in Salesforce
- Add it to the desired Page Layout(s)
- Click "Save & New"
Set Up the "Client Risk Number" Field
This adds a field to the Contact layout to hold the client's Risk Number. Nitrogen updates this field whenever the linked client's Risk Number is created or updated.
- In Salesforce, go to Setup>Object Manager>Contact>Fields & Relationships
- Click New
- Select the Data Type: Number
- Set Field Label to: Client Risk Number
- Select a Length of 18 and Decimal Places 0
- Click Next
- Set the field (via the "Field Level Security" button) to Visible and Read-Only for all users/groups that should have access to the Nitrogen data in Salesforce
- Add it to the desired Page Layout(s)
- Click "Save & New"
Set Up the "Current Portfolio Risk Number" Field
This adds a field to hold the Risk Number of your client's Current Portfolio. Nitrogen updates this field whenever the Current Portfolio is created or updated.
- In Salesforce, go to Setup>Object Manager>Contact>Fields & Relationships
- Click New
- Select the Data Type: Number
- Set Field Label to: Current Portfolio Risk Number
- Select a Length of 18 and Decimal Places 0
- Click Next
- Set the field (via the "Field Level Security" button) to Visible and Read-Only for all users/groups that should have access to the Nitrogen data in Salesforce
- Add it to the desired Page Layout(s)
- Click "Save & New"
Set Up the "Proposed Portfolio Risk Number" Field
This adds a field to hold the Risk Number of your client's Proposed Portfolio. Nitrogen updates this field whenever the Proposed Portfolio is created or updated.
- In Salesforce, go to Setup>Object Manager>Contact>Fields & Relationships
- Click New
- Select Data Type: Number
- Set the Field Label to: Proposed Portfolio Risk Number
- Select a length of 18 and Decimal Places 0.
- Click Next
- Set the field (via the "Field Level Security" button) to Visible and Read-Only for all users/groups that should have access to the Nitrogen data in Salesforce
- Add it to the desired Page Layout(s)
- Click "Save"
Huzzah! The foundation for your Nitrogen Salesforce integration is complete. Now it's time to get your users' accounts connected.
Connect Nitrogen to Salesforce
The last step in completing the integration will be for each advisor user to connect their Nitrogen account to Salesforce. See Salesforce.com: Using the Integration
Special Setups
Salesforce Person Accounts
Some Salesforce implementations use Person Accounts instead of Contacts. Worry not! The Nitrogen integration supports Person Accounts with one small adjustment.
Navigate to Setup > Object Manager > Account > Fields & Relationships. To use Nitrogen with Salesforce Person Accounts, simply update the Link to Nitrogen formula.
HYPERLINK("https://pro.riskalyze.com/api/connect/salesforce/" & CASESAFEID(PersonContactId), "View Client Profile")
The Client, Current Portfolio, and Proposed Portfolio Risk Number fields are all unchanged. Nitrogen will push data to the Contact fields, which Salesforce will automatically apply to the associated Person Account.