Admins can link different CTA types with one or more SFDC objects that are related to an account. Linking allows end users to perform additional actions within the CTA detail view. For example, if you link Contacts or SFDC Opportunities to a CTA, the end user can link the CTA to an existing Contact or Opportunity, or create new ones in SFDC. With linked objects, Admins can essentially configure CTA forms that will display or collect information from the end user directly in the Cockpit. 

The SFDC objects which have at least one field with a look up to the account will be available in the Linked Objects section to link to CTAs. Examples: SFDC Opportunity, Milestone, Cases, etc. For specific use cases and instructions, see Create CTA Forms Using Linked Objects (written tutorial), or this video.

Add a linked object to a CTA type

At both Account and Relationship levels:

  • Select a CTA type and a linked object. A new field will be created on the CTA object which will hold reference to the linked record.
  • Gear Icon: This enables you to configure search and filter criteria for a linked object.
    1. Click the Gear icon for any linked object. The ‘Selected Linked Object’ Search Configuration dialog box is displayed.
    2. Enter the required information as displayed in the following image:

  1. Search Fields: Click +ADD to add fields.

Note: A minimum of one field must be added. The maximum limit is four fields.

  1. Filters:
    1. Account fields: By default, Account ID is selected. Admins can edit this field.
    2. Click +FIELDS to add fields to filter criteria. By default, the Account ID = CTA Account ID filter is mapped. Admins can edit this mapping.
    3. Admin can modify the expression as required.
  1. Click SAVE to save the configuration or click CANCEL.
  2. Navigate to Cockpit > List View > CTA detail view to view the configuration results while performing search.
  • Bi-directional association: Enabling bi-directional sync will create a field on the linked object to hold reference on the linked record back to the CTA. De-linking the object will not remove fields from the corresponding objects and should be deleted manually from the back end.

Once an object is associated, you will see a new sub-tab under the Detail view layout configuration where you can add fields from the selected object into that section.

Configure linked objects for Relationship CTAs

To configure linked objects for relationship CTAs:

  1. Navigate to Administration > Workflow > Call to Action > RELATIONSHIP.
  2. Scroll down to the Linked Objects section.
  3. Select the CTA Type in Detail view layout configuration section.

Notes:

  • By default, you can view the fields in the Relationship Mapping Attributes group for the selected CTA type, based on the relationship type definition.
  • The fields in Relationship Mapping Attributes are mandatory and not editable.
  • If a field already exists in the Relationship type definition and CTA type layout, the relationship type definition takes precedence. This field is visible in the Mapping group in CTA detail view and not in the Linked object group.
  1. Click SAVE to save the configuration.

In Cockpit - CTA detail view:

The relationship linked object fields are displayed in Default Group and relationship mapping fields are displayed in Relationship Mapping Attributes.

Mapped.png

If only one field is mapped, this field is not editable. If multiple fields are mapped, you can select from the available mapped values.

Configure Detail view layout configuration

  1. Select the CTA Type. (This configuration is per CTA type.)
  2. Click the new linked object sub-tab (eg. Case) and create a new group by clicking “+ Group” or edit the existing Default Group (change the name by clicking it once).
  3. Click +Field to add the fields you want to display in the CTA detail view.
  4. Set the fields to Read Only or Mandatory as needed.
  5. Click Save

From the Cockpit list view, users will be able to view the fields you've configured, and/or create a new record of this type, or link with an existing record. Example: You could create a new SFDC opportunity or link with an existing opportunity from the Cockpit.

Case linked object example:

Opportunity linked object example:

Notes:

  • Admin must have permission to link objects, otherwise they will see an error upon saving. Go to Setup > Profiles > edit your profile > [enable modify all data].
  • Objects having Read Only permissions in Salesforce setup can be linked in CTA configuration but the fields can only be viewed in CTA detail view.
  • Objects having Read and Write permissions in Salesforce setup can be linked in CTA configuration. End users can view and edit the fields in CTA detail view provided Bidirectional Association is enabled in Linked Objects section.
  • If you are linking to any Gainsight object, you will only be able to link a CTA with an existing record but will not be able to create new records.
  • ‘Task’ and ‘Call to action’ objects are not supported.
  • 'Description' should be an added field to the task layout; and 'Comments' should also be added to the CTA detail view layout configuration for the desired CTA types in order for comments on tasks to appear on SFDC tasks.