Configure Upland Qvidian Integration Package in Salesforce

To configure the Upland Qvidian Integration Package, follow the tasks below.

  1. In Salesforce, do one of the following:
    • Salesforce Classic: Click the + tab to open the All Tabs page.
    • Salesforce Lightning: Open the App Launcher, then expand the All Items section.
  2. Click Qvidian Proposal Automation Settings. This option is only available to Salesforce Administrators. The Upland Qvidian Proposal Automation Settings Home page displays.

  3. To add a new setting, click New. The New Upland Qvidian Proposal Automation Setting page displays.


    New Qvidian Proposal Automation Setting screen in Salesforce Aloha New Qvidian Proposal Automation Setting screen in Salesforce Lightning

    The New Upland Qvidian Proposal Automation Setting page in Salesforce Classic (first) and Lightning (second). Click to expand.

  4. Enter Qvidian_Proposal_Automation_URL in the Qvidian Proposal Automation Setting Name field.
  5. In the Value field, enter the full URL of the Upland Qvidian installation to integrate with Salesforce.
    • For sites hosted in the Unites States: https://qpalogin.qvidian.com
    • For sites hosted in the European Union: https://qpalogin.qvidian.eu

  6. (Optional) If you are not using Upland Qvidian mapping, enter the Merge Code/SFDC field pairs into the Merge Code Mapping field. This data will be sent to Upland Qvidian when creating new documents and projects. The Merge Code and SFDC field pairs should be created as a comma separated list of pairs in the following format:

    Copy 
    <merge code1>:<sfdc field name1>,<merge code2>:<sfdc field name2>

    Example: To set the merge code OpportunityStage when creating an Opportunity document or project in Upland Qvidian, the syntax would be: OpportunityState:StageName.

    If you are creating an Opportunity document or project, but need the Name field from the Account table, the format would be: CustomerLongName:Account.Name. Minimal error checking is performed. If a field cannot be found or the merge code cannot be located in Upland Qvidian, the data will not be passed or displayed.

    Note: A prefix must be added to the SFDC field name if the field will be pulled from a related information table.

  7. Enter the Instance ID, used to uniquely identify this Salesforce instance to Upland Qvidian. This allows Upland Qvidian to know which Salesforce instance to update when multiple Salesforce instances are integrated with a single Upland Qvidian instance. This ID is arbitrary and must match the Salesforce Instance ID configured in Upland Qvidian. For more information, see Connection to Salesforce. The initial value for this field is blank for backward compatibility.
  8. Enter the Subscriber IDP ID, used to uniquely identify this user when using Single Sign-On from Salesforce to Upland Qvidian. This value is needed to determine the SSO IDP required to validate the user. This value must match what the QPA application has configured for SSO. This value should be blank for non-SSO integrations. If you are unsure about this value, contact your Customer Success Manager.
  9. (Optional) If you want to create a field that can be used to distinguish between users who can and cannot use SSO, such as employees versus contractors, enter the name of the field in the SSO Enabled User Field field. This field will display on the user’s record with a check box that can be selected or cleared to set the login requirement. This field is used in conjunction with the Subscriber IDP ID field. If this field in the user record evaluates to false, then the user will be prompted for credentials when connecting to the QPA application. It is only required for Salesforce to Upland Qvidian SSO customers that have a mixture of SSO and non-SSO Salesforce users.

    10. Tip: (Optional) Enter a Wait in seconds before redirecting time, to specify how long a redirection page is displayed after opening a Qvidian Documents or Projects link before it redirects back to the Salesforce object. The default value is 18. After a user clicks any link that causes a Upland Qvidian window or tab to open, this page displays briefly while their browser prompts the user to allow pop-ups. We strongly recommend you do not update this setting to allow users the chance to read the pop-up message.

  10. (Optional) Enter your Salesforce Community name. This field indicates that this Salesforce instance is a Community portal and needs special consideration when redirecting to and from the Managed package Visual Force page.
  11. Click Save. The Qvidian Integration Package is configured.

Create an App for Salesforce

Connect to Salesforce by creating one of the following: 

Custom Profile for Qvidian Minimum Security Requirements

We recommend creating a new profile to form a baseline collection of permissions and other settings associated with a user or a group of users. You can assign this same permission to multiple users.

Note: There are a number of standard profiles already defined. The permissions and settings to access Qvidian and associated objects are disabled for most profiles. This security setting ensures that access to Qvidian and its data is only explicitly granted to users. You can change object permissions in custom profiles, but not standard profiles.

Create the "Qvidian Minimum Security" Custom Profile

In the following tasks, you will create a custom profile in Salesforce that you can assign to users who need to access Qvidian and its custom objects.

  1. From Salesforce, navigate to: Setup | Manage Users | Profiles.
  2. Click the Standard User Profile Name.
  3. Select Clone, found next to the Profile Detail.
  4. Enter Qvidian Minimum Security into the Profile Name field.
  5. Within the Standard Object Permissions section, give Read permissions for: Account, Contacts, and Opportunities objects.

    6. Note: For QPA, the ID needs read access to any object that will be used as a merge code, in addition to read access to Accounts, Opportunities and Contacts.

  6. Within the Custom Object Permissions section, give Full Access permissions to the QPCO_Shadow object to perform insert, update, and delete operations.
  7. Click Save.

Assign the "Qvidian Minimum Security" Custom Profile

Now you can assign the Salesforce user to this profile to be used for QPA / Salesforce synchronization, as follows:

  1. Click the View Users button on the Profile Detail page for the newly created "Qvidian Minimum Security" profile.
  2. Click New User.
  3. Complete the General Information section for each desired user and assign them the Qvidian Minimum Security Profile.