U bekijkt help-inhoud voor de versie::

This article describes how to use the Smart Tags cloud service from within AEM.

You can integrate Adobe Experience Manager (AEM) with the Smart Content Service using Adobe I/O. Use this configuration to access the Smart Content Service from within AEM.

The article details out the following key tasks that are required to configure the Smart Content Service. At the back end, the AEM server authenticates your service credentials with the Adobe IO gateway before forwarding your request to the Smart Content Service.

  • Create a Smart Content Service configuration in AEM to generate a public key. Obtain public certificate for OAuth integration.
  • Create an integration in Adobe I/O and upload the generated public key.
  • Configure your AEM instance using the API key and other credentials from Adobe I/O.
  • Optionally, enable auto-tagging on asset upload.

Prerequisites

Before you can use the Smart Content Service, ensure the following to create an integration on Adobe I/O:

  • An Adobe ID account that has administrator privileges for the organization.
  • The Smart Content Service service is enabled for your organization.

Obtaining public certificate

A public certificate allows you to authenticate your profile on Adobe I/O.

  1. From the AEM user interface, tap the AEM logo, and go to Tools > Deployment > Cloud Services.

  2. In the Cloud Services page, tap/click Configure now under Assets Smart Tags.

  3. In the Create Configuration dialog, specify a title and name for the smart tags configuration, and the tap/click Create.

  4. In the AEM Smart Content Service dialog, use the values present in the following fields as is:

    Service URLhttps://mc.adobe.io/marketingcloud/smartcontent

    Authorization Serverhttps://ims-na1.adobelogin.com

    Leave the other fields blank and tap/click OK.

    aem_scs
  5. Tap/click Download Public Certificate for OAuth Integration, and download the public certificate file AEM-SmartTags.crt.

    download_link

Reconfigure when the certificate expires

When the certificate expires, it is no longer trusted. To add a new certificate, follow these steps.

  1. Log in your AEM deployment as an administrator. Click Tools > Security > Users.

  2. Locate and click dam-update-service user.

  3. Delete the existing similaritysearch keystore with the expired certificate.

  4. Navigate to Tools > Deployment > Cloud Services. Click Asset Smart Tags > Show Configuration > Available Configurations. Click the required configuration.

  5. To download a public certificate, click Download Public Certificate for OAuth Integration.

  6. Access https://console.adobe.io and navigate to the existing Smart Content Services on the Integrations page. Upload the new certificate. For more information, see the instructions in Create Adobe I/O integration.

Create Adobe I/O integration

To use Smart Content Service APIs, create an integration in Adobe I/O to generate API Key, Technical Account Id, Organization Id, and Client Secret.

  1. From the Integrations page, select your organization.

  2. Tap/click New Integration.

  3. On the Create a new integration page, select Access an API, and tap/click Continue.

  4. Under Experience Cloud, select Smart Content, and then tap/click Continue.

    smart_content
  5. In the next page, select New integration and tap/click Continue.

  6. In the Integration Details page,  specify a name for the integration gateway and add a description.

  7. Upload the public certificate file AEM-SmartTags.crt that you downloaded above.

  8. Tap/click Create Integration.

  9. To view integration information, tap/click Continue to integration details.

    integration_details

Configure Assets Smart Tags cloud service

To configure the integration, use the values of Technical Account ID, Organization Id, Client Secret, Authorization Server, and API key fields from the Adobe I/O integration. Creating a Smart Tags cloud configuration allows authentication of API requests from the AEM instance.

  1. From the AEM user interface, tap/click the AEM logo and navigate to Tools > Deployment > Cloud Service to open the Cloud Services console.

  2. Under the Assets Smart Tags, open the smart tags configuration you created above.

  3. In the AEM Smart Content Service dialog, use the prepopulated values for the Service URL and Authorization Server fields.

  4. For the fields API Key, Technical Account Id, Organization Id, and Client Secret, use the values generated above.

Enable smart tagging in the Update Asset workflow

  1. From the AEM user interface, tap/click the AEM logo, and go to Tools > Workflow > Models.

  2. From the Models page, select the DAM Update Asset workflow model.

  3. Tap/click Edit from the toolbar.

  4. Drag Smart Tag Asset Process (available under the DAM Workflow section) from side kick, and place it below the Process Thumbnails step.

    chlimage_1
  5. Open the step in edit mode. Under Advanced Settings, ensure that the Handler Advance option is selected.

    chlimage_1
  6. In the Arguments tab, select Ignore Errors if you want the workflow to complete even if the automatic tagging step fails.

    chlimage_1

    To tag assets when they are uploaded irrespective of whether smart tagging is enabled on folders, select Ignore Smart Tag Flag.

    chlimage_1
  7. Tap/click OK to close the process step, and then save the workflow.

Creating Oak indexes

If you upgrade from AEM 6.1 to AEM 6.3, you require to manually create oak indexes for smart tags. AEM 6.3 includes these indexes out of the box.

  1. Open the CRX repository.

  2. Navigate to the node /oak:index/damAssetLucene/indexRules/dam:Asset/properties.

  3. Using the index structure specified in the attached XML file as reference, create the following nodes and configure their properties as mentioned below:

    Downloaden

    • simsearchVersion
      • jcr: primaryType: nt:unstructured
      • name: jcr:content/metadata/simsearchVersion
      • nullCheckEnabled: true
      • propertyIndex: true
    • predictedTags
      • index: true
      • isRegexp: true
      • jcr:primaryType: nt:unstructured
      • name: jcr:content/metadata/predictedTags/*/name
      • propertyIndex: false
    • predictedTagsConfidence
      • index: true
      • isRegexp: true
      • jcr:primaryType: nt:unstructured
      • name: jcr:content/metadata/predictedTags/*/confidence
      • propertyIndex: false

     

    jcr:content/metadata/predictedTags/*/confidence
    jcr:content/metadata/predictedTags/*/confidence
    jcr:content/metadata/predictedTags/*/confidence
    jcr:content/metadata/predictedTags/*/confidence
  4. Navigate to /oak:index/ntBaseLucene/indexRules/nt:base/properties/, create a node damAutoTag, and configure its properties as mentioned below:

    • jcr:primaryType: nt:unstructured
    • name: jcr:content/autotag 
    • ordered: false
    • propertyIndex: true
    • type: Boolean
  5. Save the changes.

Dit werk is gelicentieerd onder de Creative Commons Naamsvermelding/Niet-commercieel/Gelijk delen 3.0 Unported-licentie  De voorwaarden van Creative Commons zijn niet van toepassing op Twitter™- en Facebook-berichten.

Juridische kennisgevingen   |   Online privacybeleid