Sales2CM User Manual 1.2.7
  • 01 Jul 2022
  • 9 Minutes to read
  • Contributors
  • Dark
    Light
  • PDF

Sales2CM User Manual 1.2.7

  • Dark
    Light
  • PDF

Article Summary

GENERAL

  1. Navigate to the Sales2CM site
  2. On the Admin tab you can configure the following settings:
    2021-08-17_14-17-29.jpg
FUNCTIONALITYDESCRIPTION
IMPORT/EXPORT SETTINGS
Export existing configuration settings or import previously configured settings. See the EXPORTING AND IMPORTING SETTINGS section of this guide.
DOWNLOAD LOGS
Download a zip file containing all the Sales2CM log files
WHITELIST ADMIN ACCESS
This field allows you to whitelist Content Manager users who are not an Administrator or Records manager to allow them access to Sales2CM's admin section.
DATASET IDThe two-digit dataset identifier of the Content Manager Dataset you wish to connect to
WORKGROUP SERVER NAMEThe Content Manager Workgroup Server name.
IMPORTANT: The workgroup server value must be set to local this is required so that Sales2CM can perform impersonation and all CM Access Controls are applied to displayed records
TEMP PATHThe folder Sales2CM will use to store temporary files
Note

If the Temp Path, Dataset ID, or workgroup server name is updated, an app pool restart is required

  1. To save the settings on this tab, click Save
    Save.png

EXPORTING AND IMPORTING SETTINGS

You can either export the current configuration settings or import existing settings using the buttons below.

2020-10-08_9-56-43.png

EXPORTING SETTINGS

To export Sales2CM's current settings, click the Export Settings button. This will automatically download the zip file containing the Sales2CM configuration files. These files can be imported back into Sales2CM when required.

IMPORTING SETTINGS

To import existing settings, follow the steps below.

Warning

Only import files that were previously taken from the Sales2CM App_Data folder or exported from Sales2CM.

  1. Click the Import Settings button
    2021-08-17_14-18-50.jpg

  2. Select the files previously exported with Sales2CM (or copied out of the Sales2CM App_Data folder) then click Open. Multiple files can be selected by holding down the SHIFT or CTRL key
    2021-06-08_12-28-11.png

  3. A success message will appear once the settings files have been updated and the admin page will reload shortly after to update the settings

APPEARANCE

2021-06-08_14-00-26.png

FUNCTIONALITYDESCRIPTION
PRIMARY BACKGROUND COLOURControls the colour of the header and footers for the application
PRIMARY FONT COLOURControls the font colour of the header and footers for the application
UPLOAD LOGOAllows the administrator to set the logo for the application.

EMAIL NOTIFICATIONS

The Email Notifications page allows you to specify the mail settings to allow Sales2CM to send automated license expiry emails to the specified email addresses

2021-06-08_14-06-15.png

FUNCTIONALITYDESCRIPTION
MAIL HOSTYour organisation's Email server address
MAIL PORTThe Email server port
SEND FROMNominated sender e-mail address
LICENSE EXPIRYSpecify email address (separated by a semi-colon) to be notified when the Sales2CM license is about to expire

LICENSE

The license tab allows you to view details about the existing license and upload a new license if required. For steps on updating the license please see the dedicated SALES2CM LICENSE UPDATE guide.

CONFIGURATION

  1. On the Configuration tab you can configure the following settings:
Note

If any of these values apart from the below fields are updated an app pool restart will be required:

  • Account ID
  • Contact ID
  • Document ID
  • Case ID
  • Folder Type
  • Template ID
  • Email ID
FUNCTIONALITYDESCRIPTION
Account ID FieldThe Content Manager additional field that is used to store the ID of the Salesforce Account.
Contact ID FieldThe Content Manager additional field that is used to store the ID of the Salesforce Contact.
Document ID FieldThe Content Manager additional field that is used to store the ID of the Salesforce Document.
Case ID FieldThe Content Manager additional field that is used to store the ID of the Salesforce Case.
Folder Type FieldThe Content Manager additional field that is used to store the folder type of folders created by Sales2CM
Template ID FieldThe Content Manager additional field that is used to store the folder template Id configured in Sales2CM for a Content Manager Container
Email ID FieldThe Content Manager additional field that is used to store the ID of an email sent from Salesforce.
Account ChannelThe name of the Salesforce streaming push topic that relates to Salesforce accounts. You can enter any value into this field and Sales2CM will create the channel on Salesforce. Sales2CM uses this channel to receive notifications from Salesforce that new accounts have been created, and then create new folders and a new organisation in Content Manager. The value cannot already exist in Salesforce and can only contain the following characters: A-Z, a-z, 0-9, '.', '-' and '_'. The character limit must not be greater than 25 characters.
Contact ChannelThe name of the Salesforce streaming push topic that relates to Salesforce contacts. You can enter any value into this field and Sales2CM will create the channel on Salesforce. Sales2CM uses this channel to receive notifications from Salesforce that new contacts have been created, and then create new folders and a new organisation in Content Manager. The value cannot already exist in Salesforce and can only contain the following characters: A-Z, a-z, 0-9, '.', '-' and '_'. The character limit must not be greater than 25 characters.
Polling Interval (Seconds)The time that Sales2CM will wait between polling cycles where it checks for new emails in Salesforce.
Salesforce Client IDThe Consumer Key of the Salesforce connected app. This is obtained during the Sales2CM installation process.
Salesforce UsernameThe username of the account that Sales2CM will use to connect to Salesforce.
Salesforce Authorisation ServerThe web address of the Salesforce authorisation server. This should be set to https://login.salesforce.com
Salesforce Sandbox Authorisation ServerThe web address of the Salesforce sandbox authorisation server. This should be set to https://test.salesforce.com
Salesforce Login EndpointThe endpoint that Sales2CM will use to login to the production environment. This should be set to /services/oauth2/token
Salesforce API EndpointThe endpoint that Sales2CM will use to connect to the Salesforce REST API. This should be set to /services/data/vXX.X where X is version number.
Salesforce Streaming EndpointThe endpoint that Sales2CM will use to connect to the Salesforce Streaming API. This should be set to /cometd/XX.X where X is version number.
Certificate Friendly NameThe certificate friendly name of the certificate used to authenticate with Salesforce
SandboxIf checked, Sales2CM will connect to the Sandbox Salesforce environment. If unchecked, Sales2CM will connect to the Production Salesforce environment
  1. To save the settings on this tab, click Save
    Save.png

ACCOUNT, CONTACT AND PUSH TOPIC CHANNEL NAMES

When providing the value for the Account and Contact Push Topic Channel Name fields in Sales2CM, ensure that these channels don't already exist in Salesforce.

To check for existing channel names:

  1. Navigate and log into the Salesforce workbench (You must enable the I agree to the terms of service checkbox
    image.png

  2. On the queries dropdown, click Streaming Push Topics
    image.png

  3. The Push Topic dropdown will contain a list of current Channels. If you wish to use an existing channel for Sales2CM, ensure that the case for letters exactly match those in Salesforce as the channel names are case sensitive.
    image.png

If you wish to delete an existing channel:

  1. On the Streaming Push Topics page, select the channel to delete in the Push Topic dropdown
    image.png

  2. Click Details
    image.png

  3. Click Delete
    image.png

  4. You will get this notification after your channel has been successfully deleted
    image.png

FOLDERS

  1. On the Folders tab, you can define the folder structure that should be created in Content Manager for each account that is created in Salesforce
    2021-08-23_10-34-00.jpg

  2. For each folder, select the record type from the dropdown box in the Record Type column

  3. You can add extra folders by clicking the Add Level button
    2021-08-17_14-42-58.jpg

  4. Enter the folder's title in the Title column
    2021-08-17_14-43-27.jpg

To include an account field in the title, include the field name within {}, e.g. {Name}
If the folder is a conditional folder (other than the account folder), you can include fields from the object in the title by prefixing the field with the object title and '.' e.g. {Case.Subject}

2021-08-17_14-44-50.jpg

  1. Click on the Settings icon to configure additional settings for the folder selected. This will open a modal window
    2021-08-17_14-45-53.jpg
Note

For the main account folder (top level), the Conditional, Topic Channel, and Salesforce Object settings are disabled.

2021-08-27_11-37-33.jpg

  1. If Conditional is selected, then the folder will only be created in response to a notification from the selected topic channel. If Conditional is selected you must also enter a topic channel name and select the relevant Salesforce object. The topic channel name cannot be greater than 25 characters and can only contain the following characters: A-Z, a-z, 0-9, '.', '-' and '_' . This will make the fields of the selected object available for mapping to CM fields. Sales2CM will create and subscribe to the topic channel.
Note

Only Custom Salesforce Objects and the following objects can be selected: Campaign, Case, Contact, ContractLineItem, Entitlement, Lead, LiveChatTranscript, Opportunity, Quote, QuoteLineItem, ServiceAppointment, ServiceContract, Task, WorkOrder, WorkOrderLineItem.

Custom Objects

In order for Custom Objects to be transferred into Content Manager the AccountId (Account) must be populated within the Custom Object. This is a requirement by all conditional folders created. The account Id is always populated on Salesforce Objects, but this must be mapped on Custom Objects.

2021-08-17_14-55-07.jpg

  1. Select which folder that emails from Salesforce should be transferred into
    2021-08-17_14-55-48.jpg
NOTE

Folders that have been selected as the Email folder cannot be set as conditional folders.

  1. Within the Folder Properties section, all mandatory folder properties will display. These must be populated to successfully create a folder.
    2021-08-17_14-57-47.jpg

  2. You can set folder additional fields to values from Salesforce objects by mapping these fields. Select a Salesforce field and a Content Manager field to map them.
    2021-08-23_10-37-02.jpg

  3. You can click the Remove button to remove a field mapping
    2021-08-17_14-59-49.jpg

  4. To update the current Folders settings, click Save
    2021-08-27_9-24-07.jpg

  5. To close the Folders window and revert all changes, click Close
    close.png

  6. To remove an entire folder from the structure, click the Remove button
    2021-08-23_10-37-57.jpg

  7. To save the folder structure, click Save
    Save.png

DOCUMENTS

On the Documents tab, you can configure the record metadata used when transferring account and case files from Salesforce to Content Manager.

  1. Under Document Record Type Field, select the Record Type. Selecting a record type will display any mandatory fields associated with the record type
    2021-08-17_15-06-32.jpg
Note

If required you can leave the title field blank and Sales2CM will use the filename as the title.

  1. Select a Salesforce field and a Content Manager field to map them together
    2021-08-17_15-06-32.jpg

  2. Click the Remove button to remove a field mapping (if required)
    2021-08-17_14-59-49.jpg

  3. To save the Record configuration, click the Save button
    Save.png

EMAILS

On the Emails tab, you can configure the record metadata used when transferring emails from Salesforce to Content Manager.

  1. Under Document Record Type Field, select the Record Type. Selecting a record type will display any mandatory fields associated with the record type
    2021-08-17_15-08-26.jpg
Note

If required you can leave the title field blank and Sales2CM will use the filename as the title.

If you would like to use the same Record Type configuration that is used for documents, enable the "Use document record type configuration" option
2020-12-03_15-29-54.png

  1. Select a Salesforce field and a Content Manager field to map together
    2021-08-17_15-08-26.jpg

  2. You can click the Remove button to remove a field mapping.
    2021-08-17_14-59-49.jpg

  3. To save the Record configuration, click the Save button
    Save.png

ACCOUNTS

On the Accounts tab, you can map values from Salesforce Account objects to fields on the related organization locations in Content Manager.

  1. Select a Salesforce field and a Content Manager field to map
    2021-08-17_15-09-44.jpg

  2. Click the Remove button to remove a field mapping (if required)
    2021-08-17_14-59-49.jpg

  3. To save the account field mappings, click the Save button
    Save.png

CONTACTS

On the Contacts tab, you can map values from Salesforce Contact objects to fields on the related person locations in Content Manager.

  1. Select a Salesforce field and a Content Manager field to map
    2021-08-17_15-10-20.jpg

  2. Under Contact Id Field, select the Content Manager field to store the Contact Id from salesforce.
    You can click the Remove button to remove a field mapping.
    2021-08-17_14-59-49.jpg

  3. To save the contact field mappings, click the Save button
    Save.png


Was this article helpful?