SalesForce Integration Installation Tutorial

introduction and prerequisites this article is a tutorial on the necessary steps that you need to take to install our licensespring salesforce integration on your saleforce instance we are assuming that you have a salesforce instance and a licensespring instance setup beforehand and that you have the admin rights needed to install applications on it and edit / add lightning record pages app installation the integration is a salesforce app that can be installed by using the following link https //login salesforce com/packaging/installpackage apexp?p0=04tgk0000006denqai https //login salesforce com/packaging/installpackage apexp?p0=04tgk0000006denqai the app is currently not published on the salesforce marketpace, but we are planning to do so in the future so users will be able to find the app on the salesforce marketpalce as well once you click on the link and log into you saleforce instance you will be show the following page in the image below in this page you have the ability to pick who will be able to use the app in your sf instance (the choice does not matter from the perspective of the integration so choose which ever you prefer for your use case) after you choose the permission setting, you will need to check the check mark " i acknowledge that i'm isntalling a non salesforce applicaiton " and then click on the " install" button this will take you to a loading animation if everything is installed correctly you will be show the following message " installation complete!" lightning pages setup now the application is installed and we need to add the applications ui to the contacts and accounts record pages so that we are able to see and use our integration on those lightining pages our integration currently supports the the contacts and accounts salesforce objects the integraiton only works in the salesforce record pages you are able to add the integraton to any lightning page types, but it wont work properly if you need the integration to work with other sf objects or on other lightning page types please submit a a support ticket to our support team https //licensespring zendesk com/hc/en us/requests/new https //licensespring zendesk com/hc/en us/requests/new go to the setup page on the setup page, click on to the lightning app builder there may already be lightning pages listed in your salesforce instance click on the "new" button if you do not already have a lightning record page for the contact and account objects if you do have a lightning record page for the contact and account objects, you will need to click on the edit button on those pages this will take you to the lightning page editing tool, so you can skip the next few steps of the tutorial by clicking on this link on the right side of the screen for the "lightining page editing tool / lightning app builder" in the above step, click " record page " and click the " next " button you will be prompted to create a label and pick an object for the page for the label you can put anything you like, but make sure it is recognizable (in our case we will put "contactrecordpage"), and for the object you need to pick " contact " after you click next, you will need to pick a tempalate , or clone an existing page choose what ever is the best for your use case and click " done " lightining page editing tool / lightning app builder once that is done, you will be redirected to the editing tool for the newly created lightning page (or an existing page) if in the steps above you have picked to edit an already existing contact or account record page, you would be redirected to this editing tool on this step you will add the licensespring integrations ui component to the page you can do so by scrolling to the bottom of the component list on the left side of the screen, or by searching for the " contactlicensespreview " component to add the component, you will need to drag and drop the contactlicensespreview component to an empty slot on the page where you wish for our integrations ui to be shown later on in the example, we have also added the "record detail" component just to have more informaiton on the page when our component is added, click 'save', and click 'activation ' this will take us to the activation wizard on this wizard you have additional options on how to show / use the page you decide on how / where you want to show the page for this example, we will click on assign as org default and after a couple of more custom options that you can choose based on your use case you are done with the integration setup for the contact object repeat the steps on the account object and its lightning page go to the lightning app builder add a new account record page or edit an existing one add our accountlicensespreview save the page and activate it management api key now when we have installed the app and added the needed component to our pages we can go to any contact or account record and we should be able to see the integration window to do so we need to go back to the salesforce home page, click on the upper left 9 dots icon, and search for contacts or accounts the last step in the integration setup is for us to set the licensespring management api key to do so, log into the licensespring vendor platform , click on the settings and click on the " keys " tab on this tab, we need to copy our management api key that is active and is not read only paste the key in the text field saleforce integration management api key field and click on the "set key" button in the lower right corner of the integration window if users who are not system administrators are going to use the integration, they must be assigned the ls admin permission set in addition, they need the standard object permission user external credential granted this permission cannot be assigned through the installed package and must be granted manually, as explained here additional steps for single tenant instances if you are using a single tenant instance, you’ll need to update the named credential url to point to your dedicated integrations instance go to setup → named credentials, locate the ls credential , click edit, and update the url accordingly by default, the url is https //integrations licensespring com , but your instance will have its own integrations endpoint so you'll need to use that endpoint if you are not sure what endpoint you are using, contact our support team, and they will help you find it contact support if you still have issues with the setup, need answers to certain questions or need additional functionalities added to the integration, feel free to contact our licensespring support team https //licensespring zendesk com/hc/en us/requests/new https //licensespring zendesk com/hc/en us/requests/new