Documentation Center

Connectors for use with Public Content API

Tridion Integration Framework enables Connectors to perform GraphQL requests to the Public Content API (PCA), including complex queries and CRUD operations on external data.

Tridion Integration Framework extends the Content Service and enables you to use GraphQL requests to access of Tridion content in a headless fashion. The extension is responsible for downloading Connector packages from the Add-on Service.

Use cases

Requests made through PCA can support a wide variety of Tridion Sites use cases, such as the following:
  • Accessing and managing external data using the same interface as for Tridion Sites content.
  • Mashing up external data with Tridion Sites content.

Entity identity mapping to PCA

The entity identity of an external item maps to PCA is as follows:

Entity identity itemPCA itemDescription
Namespace IDnamespaceThe namespace where the external data is made available. A connector can expose several namespaces with different setups, such as different end points or entity types. Typical namespaces are 'sapcommerce', 'salesforce' and 'poolparty'.
Entity TypetypeThe general type of data represented by the entity, such as product, category, contact or concept.
Unique IDidThe unique identifier provided by the external system. The external system defines the ID format.
Locale IDlocaleIdAn identifier for a locale-specific variant of the entity, such as a product ID for a specific market. The locale ID can either be a Tridion Sites publication ID or a locale string, such as 'en' or 'sv-se'. The connector is responsible for the actual locale value and mappings between locales and publication IDs.
Structure TypestructureType A read-only value to identify the type of element that the entity represents in the structure, and one of the following: root item, container item or a leaf item. This value is available only as a returned value; therefore, it cannot be modified through a GraphQL mutation.

More on PCA

For more information on PCA, refer to the main documentation for SDL Tridion Sites 9.1.