Frequently Asked Questions

Integration Overview & Use Cases

What is the Hygraph-Aprimo integration?

The Hygraph-Aprimo integration connects Hygraph, a GraphQL-native Headless CMS, with Aprimo, an AI-powered content operations platform. This integration allows you to organize, store, retrieve, and distribute digital assets in a centralized and structured manner directly within the Hygraph UI. You can manage, measure, and monitor your digital assets without leaving Hygraph, streamlining content operations for marketing, product, and development teams.
Source: Hygraph Docs

What can I do with the Hygraph-Aprimo integration?

With the Hygraph-Aprimo integration, you can manage, measure, and monitor your digital assets directly within the Hygraph UI. This includes adding Aprimo fields to your content models, selecting and organizing assets, and leveraging Aprimo's asset management capabilities for content creation and publishing workflows.
Source: Hygraph Docs

Getting Started & Prerequisites

What do I need before connecting Aprimo to Hygraph?

To use the Hygraph-Aprimo integration, you need:

Source: Hygraph Docs

How do I install the Aprimo app in Hygraph?

To install the Aprimo app in Hygraph:

  1. Go to the Hygraph Marketplace and select the Aprimo app.
  2. Choose the project and environment where you want to install the app, then click Install app.
  3. Authorize the app when prompted.
  4. Enter your Aprimo Tenant name, Client ID, and Client secret.
  5. Click Save config settings to complete the installation. A notification will confirm the changes.
For a video walkthrough, see this tutorial.
Source: Hygraph Docs

How do I add the Aprimo field to my Hygraph model?

To add the Aprimo field to your model:

  1. Navigate to the Schema builder in your Hygraph project.
  2. Select the model you want to add the Aprimo field to.
  3. Choose the Aprimo field from the Add fields sidebar.
  4. Fill in the Display name (the API ID will autocomplete). Optionally, add a description.
  5. Configure field options such as allowing multiple values or localization.
  6. Click Add to save the field.
For a video walkthrough, see this tutorial.
Source: Hygraph Docs

Using the Integration

How do I use Aprimo assets in my Hygraph project?

To use Aprimo assets in Hygraph:

  1. Go to the Content editor in your Hygraph project.
  2. Select the view configured with the Aprimo field.
  3. Click + Add entry or edit an existing entry.
  4. In the Aprimo section, click Add Aprimo asset. Log in to Aprimo if prompted.
  5. Select one or more assets (depending on your field configuration) and click Select.
  6. Organize assets as needed and click Save or Save & Publish.
For a video walkthrough, see this tutorial.
Source: Hygraph Docs

What are Aprimo image renditions and how do I use them in Hygraph?

If your Aprimo field is configured to allow only one value, you can select from multiple image renditions when adding an asset. After clicking on an image, you'll be taken to a selection screen to choose the desired rendition (if multiple versions are available in Aprimo). Select the rendition and click Select to add it to your content entry.
Source: Hygraph Docs

Troubleshooting

Why can't I view my images in the Aprimo picker screen?

If you cannot view your images in the picker screen, ensure that the images in your Aprimo account have public links. To create a public link:

  1. Go to Drafts in your Aprimo account.
  2. Select the image you want to share.
  3. Scroll to the Public links section and click Create public link...
  4. Select the renditions you want to make available and click Create.
Source: Hygraph Docs

Features & Capabilities

What are the key features of the Hygraph-Aprimo integration?

The Hygraph-Aprimo integration enables you to:

Source: Hygraph Docs

Are Hygraph apps environment specific?

Yes, Hygraph apps are environment specific. This means their configuration is applied per environment. If you are working with a project using more than one environment, you need to configure the app separately for each environment.
Source: Hygraph Docs

Resources & Support

Where can I find more resources and documentation for the Hygraph-Aprimo integration?

You can find more resources and documentation at:

Video tutorials are also available for installation, adding fields, and using Aprimo in Hygraph.
Source: Hygraph Docs

Security & Compliance

What security and compliance certifications does Hygraph have?

Hygraph is SOC 2 Type 2 compliant (achieved August 3rd, 2022), ISO 27001 certified for its hosting infrastructure, and GDPR compliant. These certifications demonstrate Hygraph's commitment to providing a secure and compliant platform for integrations like Aprimo. For more details, visit the Hygraph security features page.
Source: Hygraph Security

Support & Troubleshooting

What support options are available if I need help with the Hygraph-Aprimo integration?

Hygraph offers 24/7 support via chat, email, and phone. You can also access real-time troubleshooting through the Intercom chat, join the community Slack channel (here), and consult extensive documentation and video tutorials. Enterprise customers receive a dedicated Customer Success Manager for personalized guidance.
Source: Hygraph Documentation

Help teams manage content creation and approval in a clear and structured way
Hygraph
Docs
You are currently reading the Studio Docs. If you were looking for the Classic Docs check here

#Connect your Hygraph project to Aprimo

Aprimo is an AI-powered content operations platform that allows you to organize, store, retrieve, and distribute digital assets in a centralized and structured manner.

#What you can do with the Hygraph-Aprimo integration

With this app you can manage, measure, and monitor your digital assets right within your Hygraph UI.

#Prerequisites to use this integration

  • You must have a Hygraph account. If you don't have one, you can create one here.
  • You must have a Hygraph project with at least one model.
  • You must have an Aprimo account. If you don't have one yet, you can book a demo here.
  • You must get the following information from your Aprimo account and have it at hand for installation: Tenant name, Client ID, Client secret.

#Install the Aprimo app

Click here to install the Aprimo app on Hygraph, then follow these steps:

  1. Use the dropdowns to select which project and environment you want to install the app in, then click on Install app.
  2. The permissions pop-up will display. Click on Authorize app to continue. You will be redirected to the configuration screen.
  3. Fill in the Tenant name, Client ID, Client secret fields with the information your copied from your Aprimo account.
  4. Click on Save config settings to finalize the installation process. A pop-up notification on the bottom right corner of the screen will indicate that the changes have been saved.

#Add the Aprimo field to your model

  1. Navigate to the Schema builder.
  2. Select the model that you want to add the Aprimo field to and click on it.
  3. Select the Aprimo field from the Add fields right sidebar.
  4. Complete the Display name field; this will autocomplete the API ID field. Optionally, you can also add a Description.
  5. This screen also allows you to control different properties of your Aprimo field: you can allow multiple values, or you can localize the field, by selecting the checkboxes in the Field options section.
  6. Click Add to save.

#Use Aprimo in your Hygraph project

  1. Navigate to the Content editor.

  2. Select the view that you configured the Aprimo field for.

  3. Click on the + Add entry button or, alternatively, edit an existing entry by clicking on the pencil icon.

  4. Locate the Aprimo section of the screen and click on Add Aprimo asset. If you haven't logged into Aprimo, you may need to enter your login credentials to continue. This opens a new screen where you can select one or more of you existing assets, depending on field configuration.

  5. Select the asset you want by clicking on it. If your Aprimo field is configured for multiple assets, you can use the checkboxes to select the assets you want. Click Select on the top-right corner of the screen to add the selected assets to the content entry.

  6. After selecting the asset(s) you want and returning to the content entry, your selection will display on the list. You can optionally use the six-dots handlebar to drag and drop the assets to organize them in the order you want.

  7. Finally, click Save or Save & Publish - depending on your workflow - to save your entry.

#Aprimo image renditions

If you Aprimo field is configured to allow only one value, clicking on Add Aprimo asset will still display the selection screen, but there will be a diference in how the process follows.

Aprimo image renditionsAprimo image renditions

Instead of using checkboxes to select the image you want, you will click on an image, and you will be taken to a second selection screen where you can select from a variety of image renditions.

Select a rendition and then click Select to add the image to your content entry.

#Troubleshooting

#I can't view my images

If you cannot view your images in the picker screen, make sure that the images in your Aprimo account have public links.

Aprimo public linksAprimo public links

To create a public link:

  1. Go to Drafts in your Aprimo account
  2. Select the image you want to give public links to
  3. Scroll down to the Public links section of the screen and click Create public link...
  4. Use the checkboxes to select the renditions you want to make available and click Create

#Resources