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
- 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 item | PCA item | Description |
|---|---|---|
| Namespace ID | namespace | The 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 Type | type | The general type of data represented by the entity, such as product, category, contact or concept. |
| Unique ID | id | The unique identifier provided by the external system. The external system defines the ID format. |
| Locale ID | localeId | An 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 Type | structureType | 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.5.