Integrering av Dynamic Media med OpenAPI-funktioner integrate-asset-selector-dynamic-media-open-apis

Med resursväljaren kan du integrera med olika Adobe-program så att de kan fungera tillsammans sömlöst.

Förutsättningar prereqs-polaris

Använd följande förutsättningar om du integrerar resursväljare med Dynamic Media med OpenAPI-funktioner:

  • Kommunikationsmetoder

  • För att få tillgång till Dynamic Media med OpenAPI-funktioner måste du ha licenser för:

    • Assets-arkiv (till exempel Experience Manager Assets as a Cloud Service).
    • AEM Dynamic Media.
  • Endast godkända resurser är tillgängliga för användning för att säkerställa varumärkets enhetlighet.

Integrering av Dynamic Media med OpenAPI-funktioner adobe-app-integration-polaris

Integreringen av resursväljaren med Dynamic Media OpenAPI-processen omfattar olika steg som skapar en anpassad URL för dynamiska media eller är klar att välja URL för dynamiska media osv.

Integrera resursväljare för Dynamic Media med OpenAPI-funktioner integrate-dynamic-media

Egenskaperna rootPath och path ska inte ingå i Dynamic Media med OpenAPI-funktioner. I stället kan du konfigurera egenskapen aemTierType. Här följer syntaxen för konfiguration:

aemTierType:[1: "delivery"]

Med den här konfigurationen kan du visa alla godkända resurser utan mappar eller som en platt struktur. Mer information får du om du går till egenskapen aemTierType under Resursväljarens egenskaper.

Skapa en dynamisk leverans-URL från godkända resurser create-dynamic-media-url

När du har konfigurerat resursväljaren används ett objektschema för att skapa en dynamisk leverans-URL från de valda resurserna.
Ett schema med ett objekt från en array med objekt som tas emot när en resurs väljs:

{
"dc:format": "image/jpeg",
"repo:assetId": "urn:aaid:aem:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"repo:name": "image-7.jpg",
"repo:repositoryId": "delivery-pxxxx-exxxxxx.adobe.com",
...
}

Alla markerade resurser bärs av funktionen handleSelection som fungerar som ett JSON-objekt. Exempel: JsonObj. Den dynamiska leverans-URL:en skapas genom att följande bärare kombineras:

Objekt
JSON
Värd
assetJsonObj["repo:repositoryId"]
API-rot
/adobe/dynamicmedia/deliver
asset-id
assetJsonObj["repo:assetId"]
seo-name
assetJsonObj["repo:name"].split(".").slice(0,-1).join(".")
format
.jpg

Godkänd specifikation för tillgångsleverans-API approved-assets-delivery-api-specification

URL:
https://<delivery-api-host>/adobe/dynamicmedia/deliver/<asset-id>/<seo-name>.<format>?<image-modification-query-parameters>

Var,

  • Värddatorn är https://delivery-pxxxxx-exxxxxx.adobe.com
  • API-roten är "/adobe/dynamicmedia/deliver"
  • <asset-id> är tillgångsidentifierare
  • <seo-name> är namnet på en resurs
  • <format> är utdataformatet
  • <image modification query parameters> som stöd av den godkända resursens leverans-API-specifikation

Godkänt API för tillgångsleverans approved-assets-delivery-api

Den dynamiska leverans-URL:en har följande syntax:
https://<delivery-api-host>/adobe/assets/deliver/<asset-id>/<seo-name>, där,

  • Värddatorn är https://delivery-pxxxxx-exxxxxx.adobe.com
  • API-roten för ursprunglig återgivningsleverans är "/adobe/assets/deliver"
  • <asset-id> är tillgångsidentifierare
  • <seo-name> är namnet på resursen som kan ha ett tillägg eller inte

Redo att välja dynamisk leverans-URL ready-to-pick-dynamic-delivery-url

Alla markerade resurser bärs av funktionen handleSelection som fungerar som ett JSON-objekt. Exempel: JsonObj. Den dynamiska leverans-URL:en skapas genom att följande bärare kombineras:

Objekt
JSON
Värd
assetJsonObj["repo:repositoryId"]
API-rot
/adobe/assets/deliver
asset-id
assetJsonObj["repo:assetId"]
seo-name
assetJsonObj["repo:name"]

Nedan visas två sätt att gå igenom JSON-objektet:

Dynamisk leverans-URL

  • Miniatyrbild: Miniatyrbilder kan vara bilder och resurser kan vara PDF, video, bilder och så vidare. Även om du kan använda attributen height och width för en resurs miniatyrbild som dynamisk leveransåtergivning.
    Följande uppsättning återgivningar kan användas för resurser av typen PDF:
    När du har valt en PDF-fil i en sidospark visas nedanstående information i urvalssammanhanget. Här nedan beskrivs hur du går igenom JSON-objektet:

    Du kan referera till selection[0].....selection[4] för arrayen med återgivningslänk från skärmbilden ovan. Nyckelegenskaperna för en av miniatyrbildsrenderingarna är till exempel:

    code language-none
    {
        "height": 319,
        "width": 319,
        "href": "https://delivery-pxxxxx-exxxxx-cmstg.adobeaemcloud.com/adobe/assets/urn:aaid:aem:8560f3a1-d9cf-429d-a8b8-d81084a42d41/as/algorithm design.jpg?accept-experimental=1&width=319&height=319&preferwebp=true",
        "type": "image/webp"
    }
    

På skärmbilden ovan måste leveransadressen för den ursprungliga återgivningen i PDF införlivas i målupplevelsen om PDF krävs och inte i miniatyrbilden. Exempel: https://delivery-pxxxxx-exxxxx-cmstg.adobeaemcloud.com/adobe/assets/urn:aaid:aem:8560f3a1-d9cf-429d-a8b8-d81084a42d41/original/as/algorithm design.pdf?accept-experimental=1

  • Video: Du kan använda videospelarens URL för videomaterialet som använder en inbäddad iFrame. Du kan använda följande arrayåtergivningar i målupplevelsen:

    code language-none
    {
        "height": 319,
        "width": 319,
        "href": "https://delivery-pxxxxx-exxxxx-cmstg.adobeaemcloud.com/adobe/assets/urn:aaid:aem:2fdef732-a452-45a8-b58b-09df1a5173cd/as/asDragDrop.2.jpg?accept-experimental=1&width=319&height=319&preferwebp=true",
        "type": "image/webp"
    }
    

    Du kan referera till selection[0].....selection[4] för arrayen med återgivningslänk från skärmbilden ovan. Nyckelegenskaperna för en av miniatyrbildsrenderingarna är till exempel:

    Kodfragmentet i skärmbilden ovan är ett exempel på en videoresurs. Den innehåller en array med återgivningslänkar. selection[5] i utdraget är ett exempel på en miniatyrbild som kan användas som platshållare för videominiatyrbilden i målupplevelsen. selection[5] i återgivningens array är för videospelaren. Detta fungerar som HTML och kan anges som src för iframe. Den stöder strömning med adaptiv bithastighet, som är webboptimerad leverans av videon.

    I exemplet ovan är videospelarens URL https://delivery-pxxxxx-exxxxx-cmstg.adobeaemcloud.com/adobe/assets/urn:aaid:aem:2fdef732-a452-45a8-b58b-09df1a5173cd/play?accept-experimental=1

Konfigurera anpassade filter configure-custom-filters-dynamic-media-open-api

Med resursväljaren för Dynamic Media med OpenAPI-funktioner kan du konfigurera anpassade egenskaper och de filter som baseras på dem. Egenskapen filterSchema används för att konfigurera sådana egenskaper. Anpassningen kan visas som metadata.<metadata bucket>.<property name>. som filtren kan konfigureras mot, där,

  • metadata är information om en resurs
  • embedded är den statiska parametern som används för konfiguration, och
  • <propertyname> är det filternamn som du konfigurerar

Egenskaper som definieras på jcr:content/metadata/-nivå visas som metadata.<metadata bucket>.<property name>. för de filter som du vill konfigurera för konfigurationen.

I Resursväljaren för Dynamic Media med OpenAPI-funktioner konverteras till exempel en egenskap på asset jcr:content/metadata/client_name:market till metadata.embedded.client_name:market för filterkonfiguration.

En engångsaktivitet måste göras för att hämta namnet. Gör ett söknings-API-anrop för resursen och hämta egenskapsnamnet (i stort sett).

Användargränssnitt för resursväljare för Dynamic Media med OpenAPI-funktioner interface-dynamic-media-open-api

Efter integrering med Adobe Micro-Frontend Asset Selector kan du bara se resursstrukturen för alla godkända resurser som är tillgängliga i resurskatalogen för Experience Manager.

Dynamic Media med OpenAPI-funktioner, användargränssnitt

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab