How-to guideGet a task done

Set up a lens for the Asset Picker

In an internal integration, the assets a user sees in the Asset Picker are defined by a lens: a managed asset view configured in Luma Admin. This guide explains how to set up a lens for the Asset Picker, and how to connect it to a CA template.

For how internal integrations use a lens, see How the Asset Picker integration works.

Set up the lens in Luma Admin

Before you begin, ensure you have the privileges to create lenses in Luma Admin.

Create a lens that contains only the assets appropriate for the field it will populate. The Asset Picker does not filter assets by type, so the lens itself must be limited to the asset type the integration expects. For example, if the Asset Picker populates an image field, the lens must contain only images; if it populates a video field, the lens must contain only videos.

Record the following values, which the integration needs in order to display the lens:

  • Domain.

  • Domain ID.

  • API key.

  • Lens ID.

These values map to the configuration you supply when you embed the Asset Picker. See Embed the Asset Picker for how they are used.

Connect the lens to a CA template

Before you begin, ensure you have SuperAdmin access in CA, or access to the CA Support team, to enable the required product toggle.

  1. Enable the CMP_assets product toggle at workspace level. SuperAdmins in CA can enable this; contact the CA Support team for the process.

  2. Link the CMP domain, populating the domain, domain ID, and API key fields.

    The domain must include https://, and only subdomain URLs work, for example subdomain.storyteq.com or subdomain.itgcanopy.com. The domain cannot contain a / after the main domain.

  3. Link one or more template fields to the lens.

    After saving the lens, refresh the page before you can access the CMP Asset Picker from the Create Form.

When a user opens the Asset Picker from the template, CA sends the domain, domain ID, API key, auth token, and lens ID to the Asset Picker, so it displays the assets in the linked lens.

Related pages