Contents of the Salesforce Form

Use the Salesforce form to set up Vantagepoint to connect to your Salesforce instance to allow linking of Salesforce opportunity, account, and contact records to project, firm, and contact records in Vantagepoint.

Enable Updates

Use the settings below to connect your Salesforce instance, define when and what information is imported and what existing rules should be honored.

Be sure to complete all sections before enabling updates.

Use the following fields on the Salesforce form to set up the integration with Salesforce. Integration with Salesforce is only available if the CRM or CRM Plus module is activated.

Field Description
Active Select this option to run the update at the next scheduled time, which is based on the interval that is specified in the Data Update Options fields. Selecting Active enables the Update Now button. Select this button to run the update immediately.
Inactive This option is selected by default.

Connect Your Salesforce Instance

Use these fields to enter the Salesforce-required information for establishing the connection. You must have ADMIN rights to the Salesforce application to complete these fields and specify the consumer secret and key for connecting to Salesforce.

Field Description
Callback URL This field displays the callback URL that you copy and paste it into the Salesforce application when you connect. For details, see Connect Your Salesforce Instance.
Consumer Key Enter the Consumer Key that is provided by Salesforce when you connect your Salesforce instance.
Consumer Secret Enter the Consumer Secret that is provided by Salesforce when you connect your Salesforce instance.
Connect Click this option to connect the Salesforce instance to Vantagepoint. One of the following displays based on the status of the connection. When the connection is successful, a success displays in the top banner and the Data Update Options, Advanced Options, and Data Mapping sections are enabled.

If the connection is invalid, an unsuccessful message displays.

After a successful connection, the Connect button changes to Disconnect. Click Disconnect at any point to disconnect Salesforce from Vantagepoint and to disable the Data Update Options, Advanced Options, and Mapping.

Data Update Options

Field Description
Schedule Your Data Update Intervals Select the interval for how often the Vantagepoint data is updated with Salesforce records. Details about the last update and next scheduled update display based on the option selected.
View Last Error Log Click this link to view details from the most recent error log.

Failures are recorded in an error log table and if alerts are configured, and Vantagepoint sends a notification alert to the users with roles impacted by the failure.

All failed records are included in the next import process.

Import Record Options Select to import either new records or new and existing records.

Selecting only new records does not update or overwrite any information in the Vantagepoint database. For example, if you import opportunities into Vantagepoint to create projects and want to manage that project information in Vantagepoint, you must select the Import only new records option. Or, if you want to manage your records in Salesforce and will have the Salesforce data update the Vantagepoint information, select the Import new records and update existing records option.

Add a Filter for New Record Imports When importing new records, specify a filter for the type of opportunities to import. For example, you can choose to only import opportunities that are at the Qualified stage in Salesforce. You can select multiple filters as needed.
Update Now Click this button to manually run the data update. This option is enabled when Enable Updates is set to Active.

Advanced Options

Field Description
Honor Screen Designer Required Fields Select this option for imported records to apply the Screen Designer required fields. When selected, new records will not be created if a required field is empty or not mapped.
Error Notification Method: Select the type of notification method to use for errors:
  • Email: A failure triggers an email that is sent to the users assigned to the selected security role.
  • Notification Center: Users in the selected security role can open the Notification Center and view errors. This is selected by default.
Security Role for Error Notification Specify the security role for the users that should receive the error notification. This field includes all security roles that are configured for Vantagepoint.
Honor Workflow Rules on Import? Select this option for workflow to apply to imported records. For example, when this option is selected the workflow that is associated with the creation of a new record will be triggered when importing new records when Honor Workflow is set to Yes.

Data Mapping

Use the Opportunity Mapping, Account Mapping, and Contact Mapping options to specify the data that is pulled in from Salesforce to Vantagepoint for each area.

When you select Opportunity Mapping, Account Mapping, or Contact Mapping, the fields in the grid for both Salesforce and Vantagepoint update to reflect each area.

You must refresh the page for the updates to take place.

Field Description
Salesforce Field This column displays the standard Opportunity, Account, and Contact Salesforce fields that are mapped to the Vantagepoint fields. You can add additional fields as needed for your application.
Vantagepoint Field This column displays the standard Vantagepoint fields as well as any user-defined fields. You can add additional fields as needed for your application.
+ Add Salesforce Field Click this option to add a Salesforce field to map to a Vantagepoint field.
Delete a Field Click the X at the end of a grid row to delete a field mapping from the grid and from the applications.