Aprimo App Installation Guide

Aprimo is a digital asset management platform used by many brands to organize all digital assets in one place. For a collaborative workflow, you can upload, store, and manage images, videos, icons, logos, and documents. Using asset personalization, you can control and set the accessibility of certain assets within your team.

Contentstack Marketplace lets you install the Aprimo application and use it within your stack to fetch and display images from Aprimo within your entries.

Prerequisites

• Aprimo account
  • Unique login URL provided by Aprimo with a tenant name (For example, https://<sometenant>.dam.aprimo.com)
• Contentstack account
• Access to the Contentstack Organization/Stack as the Owner/Admin

Let's follow this step-by-step guide to install and configure Aprimo within your stack.

Steps for Execution

1. Fetch your Aprimo tenant name
2. Install and Configure Aprimo in Contentstack Marketplace
3. Use Aprimo within your Stack Entry

1. Fetch your Aprimo tenant name

   You can fetch Aprimo Account Tenant Name from the URL shared by Aprimo. For example, in the URL https://<sometenant>.dam.aprimo.com/, <sometenant> is the Tenant Name.

2. Install and Configure Aprimo in Contentstack Marketplace

   Follow the steps to install the application in Contentstack.

   1. Log in to your Contentstack account.
   2. On the left navigation panel, click the Marketplace icon to go to the Marketplace. 
   
   3. Select Aprimo from the list of apps and click the Install App button.
   
   4. Select the stack where you want to install the Aprimo app, accept the Terms of Service and Privacy Policy and click the Install button. 
   
   5. On the Configuration page, enter the Aprimo Account Tenant Name you retrieved in step 1. 
   
   6. Click the Save button.
   7. Click Open Stack to start using the Aprimo application.

3. Use Aprimo within your Stack Entry

   There are two ways to use the Aprimo application in your entry.

   1. Custom Field
   2. JSON RTE field
   
   

   Steps to use the Aprimo application using a Custom field:
   
   

   1. Go to your stack, and click the Content Models icon on the left navigation panel.
   2. Click the + New Content Type button to create a new content type.
   3. Add relevant details and click the Save and proceed button. 
   
   4. Click the Insert a field link represented by a + sign to add a custom field.
   5. Under Select Extension/App, select Aprimo, and then click Proceed. 
   
   6. After adding the app, click Save or Save and Close to save your changes. 
   
   7. To use the Aprimo app, create an entry for the above content type, and you will see the Aprimo custom field on your entry page as shown below: 
   
   8. Click + Choose Asset(s) to select image(s) from your Aprimo account. 
   
   9. Choose the rendition and then click Select to add the image to your entry. 
   

   Note: You can select only one image at a time.

   The assets you select are added within your entry. 

   
   10. Hover over the image to view the options to remove or preview the image.
       1. Click the Preview icon to view the image.
       2. Click the Remove icon to delete the selected image. 
       

   Steps to use the Aprimo application using a JSON RTE field:

   1. Go to your stack, and click the Content Models icon on the left navigation panel.
   2. Click the + New Content Type button to create a new content type.
   3. Add relevant details and click the Save and proceed button. 
   
   4. In the Content Type Builder page, add JSON Rich Text Editor in your content type by clicking on the Insert a field link represented by a + sign.
   5. To add the Aprimo plugin in JSON RTE, click the Properties icon of JSON RTE, and under Select JSON RTE Plugin(s), choose the Aprimo app, and then click the Add Plugin(s) button. 
   
   6. After adding the plugin, click Save or Save and Close to save your changes. 
   
   7. To use the Aprimo app as a JSON RTE plugin, create an entry for this content type, and you will see the Aprimo app icon in the JSON RTE field on your entry page, as shown below: 
   
   8. Click the Aprimo app icon to open the Media Library. 
   
   9. Choose the rendition and then click Select to add the image to your entry. 
   

   The selected asset(s) is displayed in the JSON RTE editor: 

   
   10. To resize the image, drag the corner of the image and adjust the size as required.
   11. Hover over the image to view, edit or delete it.
       1. Click the View icon to view the image.
       2. Click the Edit icon to edit the image. Make the necessary changes and click the Save button.
       3. Click the Delete icon to delete the selected image.