SAP Cloud Platform Open Connectors

Using Common Resource Templates

SAP provides a library of common resource templates you can use to help more quickly transform fields provided by some of the most frequently used types of connectors into single, normalized resources. For more information about COs and how to utilize and create them, see Introduction to Common Resources and Creating Common Resources.

To use a CO template, you have to clone it from the CO Templates catalog into a new CO, select your connectors and services, and edit the fields. See Cloning a CO Template to learn more.

Accessing the Common Resources Template Catalog

  1. Log in to SAP and navigate to the Common Resources page.
  2. On the Common Resources Catalog page, click the Resource Templates tab.
  3. Hover over a CO template and do one of the following:
    • Click Overview to see the CO's description, fields, and data types.
    • Click Mappings to clone the CO, or to see the CO's name and URL, system level fields, and mapped connectors.

Common Resource Overview tab

On this tab, you can view the following information about the CO template:

Section
Definition
NameThe name of the CO. You cannot edit the name of a CO template, but you can clone the template into a new CO and give it a custom name.
DescriptionA description of the CO's functionality and purpose
Mapped ConnectorsIcons indicating the connectors the CO is pre-mapped to
Fields and Data Types tableThe fields mapped to the connectors included in the CO

Common Resources Mappings tab

On this tab, you can clone the CO template and view the following information about it:

Section
Definition
Common Resource Name and URLThe name of the CO and the URL path where it is accessed
System Level FieldsThe fields mapped at the system level of the CO. When cloning a CO template, you can select the level at which the system level fields will be set. See Cloning a CO Template to learn more.
Mapped ConnectorsConnector cards indicating the connector instances premapped to in the CO template. To see which system level fields of the connector the CO template will transform, hover over an connector card and click View.

Cloning a Common Resource Template

  1. Navigate to the Mappings tab of the CO template and click Clone.
  2. Search for and select the connectors you want to include in the CO, and then click Next. You can also click the check box next to the Connector Name column header to select all listed connectors.
  3. Select the level at which the system fields should be created in the CO, and then click Next.
  4. Enter a unique name for your CO, and then click Save.
  5. Your new CO now appears in the My Resources list and is ready for transformations. See  Mapping and Transforming Fields to learn more about transformations.

Known issue: if you clone a CO template into a new CO, you cannot delete the new CO and will receive an error. We are aware of this issue and are working to resolve it. As a workaround, clone the CO template into a new CO, give it a unique name, and ignore the CO you want to delete. As a best practice, consider renaming the CO you are trying to delete with a junk name, e.g. DoNotUseThisCO, until it can be deleted.

About Levels

Within COs, the available fields are defined within a hierarchy of three levels, each with their own sets of privileges and access: organization, account, and instance. Fields defined at the account level are inherited by all users associated with a specific account, while fields defined at the instance level only apply to a specific connector instance. See Introduction to Common Resources to learn more.

Available Common Resource Templates

These CO templates are available in the Resource Template catalog. This list will be updated as new CO templates are added; keep checking this space for new resources.

  • /companies

    Description: The Companies CO template provides a pre-mapped, common data interface into several cloud marketing and CRM services. It represents a company made in a crm or marketing system that can be applied to a customer's account. This template provides one unified RESTful Resource that allows you to interact with the companies objects associated with the connectors below.

    Mapped Connectors:

    1. Salesforce Sales Cloud
    2. Oracle Eloqua
    3. HubSpot Marketing
    4. HubSpot CRM
    5. SugarCRM
    6. Microsoft Dynamics CRM
  • /basic-contacts

    Description: The Contacts CO template provides a pre-mapped, common data interface into several cloud marketing and CRM services. It represents a simplified contact made in a crm or marketing system that can be applied to a customer's account. This template provides one unified RESTful Resource that allows you to interact with the contact objects associated with the connectors below.

    Mapped Connectors:

    1. Salesforce Sales Cloud
    2. Oracle Eloqua
    3. HubSpot Marketing
    4. HubSpot CRM
    5. SugarCRM
    6. Netsuite CRM 2018 Release 1
  • /basic-leads

    Description: The Leads CO template provides a pre-mapped, common data interface into several cloud marketing and CRM services. It represents a simplified lead made in a crm or marketing system that can be applied to a customer's account. This template provides one, unified RESTful Resource that allows you to interact with the lead objects associated with the connectors below.

    Mapped Connectors:

    1. Salesforce Sales Cloud
    2. Marketo
    3. HubSpot CRM
    4. SugarCRM
  • /leads

    Description: The Leads CO template provides a pre-mapped, common data interface into several cloud marketing and CRM services. It represents a lead made in a crm or marketing system that can be applied to a customer's account. This template provides one, unified RESTful Resource that allows you to interact with the lead objects associated with the connectors below.

    Mapped Connectors:

    1. Salesforce Sales Cloud
    2. Marketo
    3. HubSpot CRM
    4. SugarCRM
  • /contacts

    Description: The Contacts CO template provides a pre-mapped, common data interface into several cloud marketing and CRM services. It represents a contact made in a crm or marketing system that can be applied to a customer's account. This template provides one, unified RESTful Resource that allows you to interact with the contact objects associated with the connectors below.

    Mapped Connectors:

    1. Salesforce Sales Cloud
    2. Oracle Eloqua
    3. HubSpot Marketing
    4. HubSpot CRM
    5. SugarCRM
    6. Netsuite CRM 2018 Release 1
    7. Bullhorn
  • /basic-companies

    Description: The Companies CO template provides a pre-mapped, common data interface into several cloud marketing and CRM services. It represents a simplified company made in a crm or marketing system that can be applied to a customer's account. This template provides one, unified RESTful Resource that allows you to interact with the companies objects associated with the connectors below.

    Mapped Connectors:

    1. Salesforce Sales Cloud
    2. Oracle Eloqua
    3. HubSpot Marketing
    4. Marketo
    5. dynamicscrm
    6. HubSpot CRM
    7. SugarCRM