This article is intended for implementation teams and developers. Note that cropping of Aprimo content is not supported within the Assette PowerPoint Editor.
The Assette-Aprimo Integration allows users to access the Aprimo content in the Assette PowerPoint Editor via the Aprimo API. The article covers the basics of how to successfully integrate Aprimo with Assette. By default, the Aprimo Data Blocks use Assette’s Demo images.
Authorization #
To integrate Aprimo with Assette, please communicate the following information to the Assette Team, and Assette will make the required updates to the Aprimo specific Data Blocks and Assette back-end.
Prerequisites
- The organization must have a Aprimo account
- The user must be able to provide Aprimo endpoint and credentials
OAuth 2.0 Flow – Client Credentials
- The Aprimo authorization method (e.g., OAuth 2.0)
- Client ID (e.g., “7ABCDEFG-9ABC”)
- Client Secret (e.g., “49Gdq7#pDOG}eDnD”)
- The “/api/core” and “/login/connect/token” Aprimo URL endpoints:
- https://[client_name].dam.aprimo.com/api/core
- https://[client_name].dam.aprimo.com/login/connect/token
Aprimo Specific Data Blocks #
The following Data Blocks are related to Aprimo are used by Assette to connect to the Aprimo API. These Data Blocks are not to be edited.
| Data Block | Description |
|---|---|
| Aprimo_api_order_status | The Aprimo API Order Status Data Block is used to make a GET request to the Aprimo API. The Data Block fetches information about a specific order by appending the order ID ({{id}}) to the path. [Link] |
| Aprimo_api_post_order | The Aprimo API Post Order Data Block is an API forwarder and describes how to sends a request to an the Aprimo API and creates a request to download the latest version of a file without sending any notifications. The Aprimo API Post Order Data Block is not edited. [Link] |
| Aprimo_api_records | The Aprimo API Records Data Block functions as an API key forwarder for the Assette-Aprimo integration. This block is set up by Assette after the client has provided a valid public API key from Aprimo. This Data Block is not edited. [Link] |
| Aprimo_api_single_record | The Aprimo API Single Record (Aprimo_api_single_record) Data Block gets the thumbnail URL parameter for a single thumbnail. [Link] |
| ImageContent | The Image Content Data Block is used to retrieve the image from Aprimo API. Once the image is ready and available, the Data Block downloads the image and captures its content and format. If successful, the image data and its type are returned as a response. This Data Block is not edited. [Link] |
| ImageLibrary | The Image Library Data Block is used to list of images according to given filter parameters within the Assette application. [Link] |
| ImageLibrary_Api_Thumbnail_Aprimo | The Aprimo Image Library API Data Block passes the URL which was received from the Aprimo API Order Status Data Block and sets the action to “Download”. [Link] |