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. In the left navigation panel, click the Marketplace icon to go to the Marketplace.
      
   3. Click Apps from the left panel.
   4. Within the Marketplace, you can see all the available apps. Hover over the Aprimo app and click Install App.
      
   5. In the popup window, select the stack where you want to install the Aprimo app and click the Install button.
      
      
   6. On the Configuration page, enter the Aprimo Account Tenant Name you retrieved in step 1.
      
   7. On the UI Locations tab, you can see the predefined app locations. You can use the toggle button corresponding to each UI location to enable or disable it based on your requirements.

   Additional Resource: For more information on UI locations, please refer to the Installed Apps guide.

   8. Click the Save button.
   9. Click Open Stack to start using the Aprimo application.

3. Use Aprimo within your Stack Entry

   1. Go to your stack, and click the Content Models icon in 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. 
      

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

   1. Custom Field
   2. JSON Rich Text Editor field

   Steps to use the Aprimo application using a Custom field

   1. Click the Insert a field link represented by a + sign to add a custom field.
   2. Under Select Extension/App, select Aprimo, and then click Proceed. 
      
      
   3. After adding the app, click Save or Save and Close to save your changes. 
      
   4. 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: 
      
   5. Click + Choose Asset(s) button.
      

      Note: After clicking the + Choose Asset(s) button, the app redirects you to log in to your Aprimo account if you are using it for the first time. Enter the Login ID and Password provided by Aprimo for fetching assets from your Aprimo account.

      Select image(s) from your Aprimo account. 
      
   6. 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. 
   
   7. 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. 
      
   8. After adding the asset(s), Save and Publish your entry.

   Steps to use the Aprimo application using a JSON Rich Text Editor field

   1. 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.
      
   2. 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. 
      
      
   3. After adding the plugin, click Save or Save and Close to save your changes. 
      
   4. 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: 
      
   5. Click the Aprimo app icon to open the Media Library. 
      
   6. 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: 
   
   7. To resize the image, drag the corner of the image and adjust the size as required.
   8. 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. 
      
   9. After adding the asset(s), Save and Publish your entry.