With common resource (COs), you can transform fields provided by your service providers to a single, normalized resource at SAP. This allows you to take advantage of our one-to-many integration approach where you write to a single CO to integrate the transformed resources from your various service providers.
On this page
A frequent example is to create a CO to represent your
/contacts for various CRMs, and then transform the
/contacts resources from those CRMs. You know that you want your contacts to look a certain way, regardless of the CRM system. You want
FirstName something else, like
properties.firstname. You need to create a single CO with fields named
This example shows fields in the
/Contact resource from Salesforce mapped to fields in a CO called
lastName into a single field called
name. Or tackle even more complicated issues like transforming a number based priority value (1-10) to a descriptor based value (low, medium, or high).
You define the fields in COs within a hierarchy that includes three levels: organization, account, and instance. Only users at the organization level can create COs, while users at other levels can configure the COs for specific transformations.
- The organization is the highest level. A CO built at this level represents a template that you can use for all accounts within your organization.
- The account is the next highest level. Accounts typically represent your customers. Transformations at the account level are shared by all users associated with a specific account.
- The instance is the most granular level. Transformations that you or other users create at this level apply only to a specific connector instance.
To help you understand COs, review the definitions in this section.
- common resource
- A stand-alone resource, created and defined by a user with the intention of creating a one-to-many transformation.
- Relates to transforming information from vendors to a common language within SAP. In relation to COs, normalization is the transformation of related fields and objects in multiple connector resources to a single definition of the field or object within a CO.
- Data within a resource. Fields mapped between a CO and an connector instance result in a transformation of the connector fields.
- The process of associating objects within a vendor's resource to objects in a CO so the vendor objects can be transformed.
- An object or entity that can be accessed via a URI request. Similar resources, such as Accounts, Contacts, and Customers appear in multiple APIs. COs at SAP normalize these varied resources.
- The result of mapping an API provider resource to a CO.
- connector instance resource
- The resources available to the connector instance through its API. You map the data from the connector instance resources to the data in your CO to create a transformation.