Documentatie AEM as a Cloud Service Handboek

Integratie voor dynamische media met OpenAPI-mogelijkheden integrate-asset-selector-dynamic-media-open-apis

Last update: Mon Jun 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Van toepassing op:
Experience Manager as a Cloud Service

Gemaakt voor:

Beheerder
Gebruiker

Met de functie Asset Selector kunt u verschillende Adobe-toepassingen integreren, zodat deze naadloos kunnen samenwerken.

Vereisten prereqs-polaris

Gebruik de volgende voorwaarden als u Asset Selector integreert met Dynamic Media met OpenAPI-mogelijkheden:

Communicatiemethoden
Voor toegang tot Dynamic Media met OpenAPI-mogelijkheden hebt u licenties nodig voor:
- Assets repository (bijvoorbeeld Experience Manager Assets as a Cloud Service).
- AEM Dynamic Media.
Slechts goedgekeurde activazijn beschikbaar voor gebruik die merkconsistentie verzekeren.

Integratie voor dynamische media met OpenAPI-mogelijkheden adobe-app-integration-polaris

De integratie van Asset Selector met Dynamic Media OpenAPI-proces omvat verschillende stappen, zoals het maken van een aangepaste dynamische media-URL of het kiezen van de URL voor dynamische media, enz.

Asset Selector voor Dynamic Media integreren met OpenAPI-mogelijkheden integrate-dynamic-media

De eigenschappen rootPath en path mogen geen deel uitmaken van de Dynamic Media met OpenAPI-mogelijkheden. In plaats daarvan kunt u de eigenschap aemTierType configureren. Hier volgt de syntaxis van de configuratie:

aemTierType:[1: "delivery"]

Met deze configuratie kunt u alle goedgekeurde elementen weergeven zonder mappen of als een platte structuur. Voor meer informatie, navigeer aan aemTierType bezit onder de eigenschappen van de Selecteur van Activa.

Een URL voor dynamische levering maken op basis van goedgekeurde elementen create-dynamic-media-url

Nadat u Asset Selector hebt ingesteld, wordt een objectschema gebruikt om een URL voor dynamische levering te maken van de geselecteerde elementen.
Bijvoorbeeld een schema van één object van een array met objecten die wordt ontvangen bij de selectie van een element:

{
"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",
...
}

Alle geselecteerde elementen worden gedragen door de functie handleSelection die als een JSON-object fungeert. Bijvoorbeeld JsonObj . De dynamische leverings-URL wordt gemaakt door de onderstaande dragers te combineren:

Object

JSON

Host

assetJsonObj["repo:repositoryId"]

API-hoofdmap

/adobe/assets

asset-id

assetJsonObj["repo:assetId"]

seo-name

assetJsonObj["repo:name"].split(".").slice(0,-1).join(".")

format

.jpg

API-specificatie voor levering van goedgekeurde middelen approved-assets-delivery-api-specification

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

Wanneer

Host is https://delivery-pxxxxx-exxxxxx.adobe.com
API-hoofdmap is "/adobe/assets"
<asset-id> is element-id
as is het constante onderdeel van de open API-specificatie die aangeeft waarnaar het element moet worden verwezen
<seo-name> is de naam van een element
<format> is de uitvoerindeling
<image modification query parameters> wordt ondersteund door de API-specificatie voor levering van goedgekeurde middelen

Goedgekeurde middelen Oorspronkelijke leverings-API van de vertoning approved-assets-delivery-api

De dynamische leverings-URL heeft de volgende syntaxis:
https://<delivery-api-host>/adobe/assets/<asset-id>/original/as/<seo-name> , waarbij:

Host is https://delivery-pxxxxx-exxxxxx.adobe.com
API-hoofdmap voor originele uitvoering is "/adobe/assets"
<asset-id> is element-id
/original/as is het constante onderdeel van de open API-specificatie die aangeeft naar welke oorspronkelijke vertoning moet worden verwezen.
<seo-name> is naam van de activa die al dan niet een uitbreiding kunnen hebben

Gereed om dynamische URL voor levering te kiezen ready-to-pick-dynamic-delivery-url

Object

JSON

Host

assetJsonObj["repo:repositoryId"]

API-hoofdmap

/adobe/assets

asset-id

assetJsonObj["repo:assetId"]

seo-name

assetJsonObj["repo:name"]

Hieronder ziet u de twee manieren waarop u het JSON-object kunt doorlopen:

Dynamische levering url

Duimnagel: de duimnagels kunnen beelden zijn en de activa zijn PDF, video, beelden, etc. Hoewel u de hoogte- en breedtekenmerken van de miniatuur van een element kunt gebruiken als de dynamische uitvoering van het element.
De volgende set uitvoeringen kan worden gebruikt voor de PDF-elementen:
Als er eenmaal een PDF is geselecteerd in sidekick, wordt in de selectiecontext de onderstaande informatie weergegeven. Hieronder ziet u de manier waarop u het JSON-object kunt doorlopen:

U kunt naar selection[0].....selection[4] verwijzen voor de array van vertoningskoppelingen uit de bovenstaande schermafbeelding. De belangrijkste eigenschappen van een van de miniatuuruitvoeringen zijn bijvoorbeeld:

code language-none

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

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

In de bovenstaande schermafbeelding moet de bezorgings-URL van de oorspronkelijke PDF-uitvoering worden opgenomen in de doelervaring als PDF vereist is en niet de bijbehorende miniatuur. Bijvoorbeeld: https://delivery-pxxxxx-exxxxx.adobeaemcloud.com/adobe/assets/urn:aaid:aem:8560f3a1-d9cf-429d-a8b8-d81084a42d41/original/as/algorithm design.pdf

Video: u videospeler URL voor de videotypeactiva kunt gebruiken die ingebedde iFrame gebruiken. U kunt de volgende arrayuitvoeringen gebruiken in de doelervaring:

code language-none

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

{
    "height": 319,
    "width": 319,
    "href": "https://delivery-pxxxxx-exxxxx.adobeaemcloud.com/adobe/assets/urn:aaid:aem:2fdef732-a452-45a8-b58b-09df1a5173cd/as/DragDrop.2.jpg?width=319&height=319",
    "type": "image/webp"
}

Het codefragment in de bovenstaande schermafbeelding is een voorbeeld van een video-element. De array met uitvoeringen bevat koppelingen. selection[5] in het fragment is het voorbeeld van een afbeeldingsminiatuur die kan worden gebruikt als tijdelijke aanduiding voor een videominiatuur in de doelervaring. De selection[5] in de array van uitvoeringen is voor de videospeler. Dit dient een HTML en kan worden ingesteld als src van het iframe. De functie ondersteunt adaptieve bitsnelheidstreaming, dat wil zeggen, voor het web geoptimaliseerde levering van de video.

In het bovenstaande voorbeeld is de URL van de videospeler https://delivery-pxxxxx-exxxxx.adobeaemcloud.com/adobe/assets/urn:aaid:aem:2fdef732-a452-45a8-b58b-09df1a5173cd/play

Aangepaste filters configureren configure-custom-filters-dynamic-media-open-api

Met Asset Selector for Dynamic Media met OpenAPI-mogelijkheden kunt u aangepaste eigenschappen en de filters configureren op basis van deze eigenschappen. De eigenschap filterSchema wordt gebruikt om dergelijke eigenschappen te configureren. De aanpassing kan worden weergegeven als metadata.<metadata bucket>.<property name>. waartegen de filters kunnen worden geconfigureerd, waarbij:

metadata is de informatie van een element
embedded de statische parameter is die voor configuratie wordt gebruikt, en
<propertyname> is de filternaam die u configureert

Voor de configuratie worden eigenschappen die op jcr:content/metadata/ niveau worden bepaald blootgesteld als metadata.<metadata bucket>.<property name>. voor de filters die u wilt vormen.

In Asset Selector for Dynamic Media met OpenAPI-mogelijkheden wordt bijvoorbeeld een eigenschap op asset jcr:content/metadata/client_name:market omgezet in metadata.embedded.client_name:market voor filterconfiguratie.

Voor het ophalen van de naam moet een eenmalige activiteit worden uitgevoerd. Maak een onderzoek API vraag naar de activa en krijg de bezitsnaam (de emmer, hoofdzakelijk).

Gebruikersinterface voor Asset Selector voor Dynamic Media met OpenAPI-mogelijkheden interface-dynamic-media-open-api

Na de integratie met de Adobe Micro-Frontend Asset Selector kunt u de structuur van alle goedgekeurde middelen alleen zien in de gegevensopslagruimte van Experience Manager.

Dynamische Media met OpenAPI mogelijkheden UI

A: Verberg/toon paneel
B: Assets
C: Sorteren
D: Filters
E: De bar van het onderzoek
F: Het sorteren in stijgende of dalende orde
G: Cancel Selectie
H: Selecteer enige of veelvoudige activa

NOTE

Mappen worden alleen ondersteund wanneer verbinding wordt gemaakt met de opbergplaats voor auteurs en niet met Dynamic Media met de OpenAPI-opslagruimte.

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab