[AEM Assets]{class="badge positive" title="van toepassing op AEM Assets)."}
Installatie en eigenschappen van Content Advisor content-advisor-installation-properties
Content Advisor is ook beschikbaar voor integratie met niet-Adobe (derde partij) toepassingen, waardoor de intelligente detectie van bedrijfsmiddelen verder gaat dan Adobe-toepassingen. Dezelfde uitgebreide functieset, zoals zoeken op basis van AI, contextbewuste aanbevelingen, korte detectie van campagnes, toegang tot dynamische media-uitvoeringen, detectie van inhoudsfragmenten, filters en metagegevens van elementen, wordt ondersteund in integratie van derden.
Vereisten prereqs
U moet de volgende communicatiemethoden gebruiken:
- De hosttoepassing wordt uitgevoerd op HTTPS.
- U kunt de toepassing niet uitvoeren op
localhost. Als u Content Advisor op uw lokale computer wilt integreren, moet u bijvoorbeeld een aangepast domein maken[https://<your_campany>.localhost.com:<port_number>]en dit aangepaste domein toevoegen in deredirectUrl list. - U kunt clientID configureren en toevoegen aan de omgevingsvariabele van de AEM Cloud-service met de respectievelijke
imsClientId. - De lijst van het werkingsgebied IMS moet in de omgevingsconfiguratie worden bepaald.
- De URL van de toepassing bevindt zich in de lijst van gewenste personen van de IMS-client voor het doorsturen van URL's.
- De IMS-aanmeldstroom wordt geconfigureerd en weergegeven met een pop-up in de webbrowser. Daarom moeten pop-ups worden ingeschakeld of toegestaan in de doelbrowser.
Gebruik de bovenstaande voorwaarden als u de IMS-verificatieworkflow van Content Advisor nodig hebt. Als u al bent geverifieerd met de IMS-workflow, kunt u in plaats daarvan de IMS-informatie toevoegen.
- Domeinnamen waarbij de integrerende toepassing wordt gehost.
- Na provisioning ontvangt uw organisatie
imsClientId,imsScopeen eenredirectUrldie overeenkomen met de gevraagde omgevingen die essentieel zijn voor de configuratie van Content Advisor. Zonder deze geldige eigenschappen kunt u de installatiestappen niet uitvoeren.
Installatie content-advisor-installation
De Adviseur van de inhoud is beschikbaar via zowel ESM CDN (bijvoorbeeld, esm.sh / kabel ) als UMD versie.
In browsers die {versie 0} gebruiken UMD (geadviseerd):
<script src="https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/assets-selectors.js"></script>
<script>
const { renderAssetSelector } = PureJSSelectors;
</script>
In browsers met import maps steun gebruikend versie van ESM CDN:
<script type="module">
import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
</script>
In Deno/de Federatie van de Module van het Pakket gebruikend versie van ESM CDN:
import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
Eigenschappen van Content Advisor content-advisor-propertiess
U kunt de eigenschappen van de Adviseur van de Inhoud gebruiken om de manier aan te passen de Adviseur van de Inhoud wordt teruggegeven. In de volgende tabel worden de eigenschappen weergegeven die u kunt gebruiken om Content Advisor aan te passen en te gebruiken.
true , wordt Content Advisor weergegeven in een linkerspoorweergave. Als deze is gemarkeerd met false , wordt de Content Advisor weergegeven in de modale weergave.imsOrg -toets is vereist om te verifiëren of de organisatie waartoe u toegang hebt, onder Adobe IMS valt of niet.imsToken is vereist als u een Adobe -toepassing voor de integratie gebruikt.apiKey is vereist als u een Adobe -toepassingsintegratie gebruikt.<Object>[{id: 'urn:234}, {id: 'urn:555'}] Een element moet bijvoorbeeld beschikbaar zijn in de huidige map. Als u een andere map moet gebruiken, geeft u ook een waarde op voor de eigenschap path .rail om de weergave per spoor van de viewer voor elementen in te schakelen.Object<{ id?: string, defaultMessage?: string, description?: string}>i18nSymbols -proxy. Als u een waarde door deze interface doorgeeft, overschrijft u de standaardvertalingen die worden geleverd en gebruikt u in plaats daarvan uw eigen vertaling. Om de opheffing uit te voeren, moet u een geldig 🔗 voorwerp van de Beschrijver van het Bericht tot de sleutel van i18nSymbols overgaan die u wilt met voeten treden.intl.locale . Bijvoorbeeld: intl={{ locale: "es-es" }}de gesteunde scènekoorden volgen ISO 639 - Codes voor de vertegenwoordiging van namen van taalnormen.
Lijst met ondersteunde landinstellingen: Engels - 'en-us' (standaard) Spaans - 'es-es' Duits - 'de-de' Frans - 'fr-fr' Italiaans - 'it-it' Japans - 'ja-jp' Koreaans - 'ko-kr' Portugees - 'pt-br' Chinees (traditioneel) - 'zh-cn' Chinees (Taiwan) - 'zh-tw'
Array<string>{allowList?: Object}default en express . Deze ondersteunt ook @react-spectrum/theme-express .Wordt aangeroepen met een array van elementen wanneer elementen worden geselecteerd en op de knop Select op het modale object wordt geklikt. Deze functie wordt alleen aangeroepen in de modale weergave. Gebruik voor de rasterweergave de functies handleAssetSelection of onDrop . Voorbeeld:
handleSelection=(assets: Element[])=> {…}
Zie selectie van activa voor details.
Wordt aangeroepen met een array van items wanneer de elementen worden geselecteerd of niet geselecteerd. Dit is handig wanneer u naar elementen wilt luisteren terwijl de gebruiker deze selecteert. Voorbeeld:
handleAssetSelection=(assets: Element[])=> {…}
Zie selectie van activa voor details.
Close in de modale weergave wordt gedrukt. Dit wordt alleen aangeroepen in de modal -weergave en wordt in rail -weergave genegeerd.single of multiple selectie van elementen tegelijk.Syntaxis:
aemTierType: "author" "delivery"Als bijvoorbeeld beide
["author","delivery"] worden gebruikt, worden opties voor zowel auteur als levering weergegeven met de repository switch.EXPIRED , EXPIRING_SOON of NOT_EXPIRED op basis van de vervaldatum van een element dat u opgeeft. Zie verlopen activa aanpassen. Bovendien, kunt u allowSelectionAndDrag gebruiken waarin de waarde van de functie of true of false kan zijn. Wanneer de waarde is ingesteld op false , kan het verlopen element niet worden geselecteerd of gesleept op het canvas.uploadConfig . Voeg een array van velden toe die u opgeeft om metagegevens van de gebruiker te verzamelen. Met deze eigenschap kunt u ook verborgen metagegevens gebruiken die automatisch aan een element worden toegewezen, maar die niet zichtbaar zijn voor de gebruiker.uploadConfig . Deze bestaat uit property en value . Property evenaart mapToProperty van het gebied dat van wordt overgegaan metadataSchema de waarvan waarde wordt bijgewerkt. Terwijl, value evenaart de nieuwe waarde als input wordt verstrekt."/content/dam"uploadConfig . Het doeluploadpad voor de bestanden die standaard de hoofdmap van de gegevensopslagruimte vormen.uploadConfig .(uploadInfo: UploadInfo) => void . Deze eigenschap is genest onder de eigenschap uploadConfig .sourceTypes gebruikt een array met de importbronnen die u wilt inschakelen. De ondersteunde bronnen zijn Onedrive en Dropbox. De syntaxis is { sourceTypes?: ImportSourceType[]; apiKey?: string; } . Bovendien is deze eigenschap genest onder de eigenschap uploadConfig .(uploadStats: UploadStats) => void . Bovendien is deze eigenschap genest onder de eigenschap uploadConfig .uploadConfig . Het is een callback functie die wordt gebruikt om het gedrag van te tonen upload wanneer een dossier wordt veranderd. De nieuwe array met bestanden die moeten worden geüpload en het brontype van de upload worden doorgegeven. Source-type kan null zijn in het geval van een fout. De syntaxis is (newFiles: File[], uploadType: UploadType) => void{ href: string; alt: string; } en deze eigenschap is bovendien genest onder de eigenschap uploadConfig .featureSet:[ ] wordt gebruikt om een bepaalde functionaliteit in of uit te schakelen in de toepassing Content Advisor. Om de component of een eigenschap toe te laten, kunt u een koordwaarde in de serie overgaan of de serie leeg verlaten om toegevoegde eigenschappen onbruikbaar te maken, en enkel de basisfunctionaliteit te hebben. Gebruik bijvoorbeeld de syntaxis featureSet:["upload"] als u uploadfunctionaliteit wilt inschakelen in de Content Advisor. Op dezelfde manier kunt u featureSet:["content-fragments"] gebruiken om Content Fragments in de Adviseur van de Inhoud toe te laten. Om veelvoudige eigenschappen samen te gebruiken, is de syntaxis featureSet:[ "upload", "content-fragments"].ImsAuthProps ims-auth-props
De ImsAuthProps -eigenschappen definiëren de verificatiegegevens en -stroom die de Content Advisor gebruikt om een imsToken -element te verkrijgen. Door deze eigenschappen te plaatsen, kunt u controleren hoe de authentificatiestroom zich zou moeten gedragen en luisteraars voor diverse authentificatiegebeurtenissen registreren.
imsClientIdimsScoperedirectUrlredirectUrl niet wordt opgegeven, gebruikt ImsAuthService de redirectUrl die wordt gebruikt om de imsClientId te registrerenmodalModetrue , wordt de verificatiestroom weergegeven in een pop-up. Indien ingesteld op false , wordt de verificatiestroom weergegeven in een volledige pagina die opnieuw wordt geladen. _Nota :_voor betere UX, kunt u deze waarde dynamisch controleren als de gebruiker browser pop-up gehandicapt heeft.onImsServiceInitializedservice , die een object is dat de Adobe IMS-service vertegenwoordigt. Zie ImsAuthService voor meer informatie.onAccessTokenReceivedimsToken wordt ontvangen van de Adobe IMS-verificatieservice. Deze functie heeft één parameter, imsToken, die een tekenreeks is die het toegangstoken vertegenwoordigt.onAccessTokenExpiredonErrorReceivedImsAuthService ims-auth-service
De ImsAuthService -klasse handelt de verificatiestroom voor de Content Advisor af. Het is verantwoordelijk voor het verkrijgen van een imsToken van de Adobe IMS-verificatieservice. De imsToken wordt gebruikt om de gebruiker te verifiëren en toegang tot de Adobe Experience Manager toe te staan als een Cloud Service Assets-opslagplaats. ImsAuthService gebruikt de ImsAuthProps eigenschappen om de authentificatiestroom te controleren en luisteraars voor diverse authentificatiegebeurtenissen te registreren. U kunt de geschikte registerAssetsSelectorsAuthService functie gebruiken om de ImsAuthService instantie met de Adviseur van de Inhoud te registreren. De volgende functies zijn beschikbaar voor de ImsAuthService -klasse. Nochtans, als u de registerAssetsSelectorsAuthService functie gebruikt, te hoeven u deze functies niet direct te roepen.
isSignedInUsergetImsTokenimsToken op voor de momenteel aangemelde gebruiker, die kan worden gebruikt om aanvragen voor andere services, zoals het genereren van asset_rendition, te verifiëren.signInImsAuthProps om verificatie weer te geven in een pop-up of een volledige pagina die opnieuw wordt geladensignOutrefreshTokencontentFragmentSelectorProps content-fragment-selector-properties
Met contentFragmentSelectorProps kunt u configureren hoe Inhoudsfragmenten worden benaderd en weergegeven in de Inhoudsadviseur. Door de functie voor inhoudfragmenten in de featureSet in te schakelen en de vereiste configuratie te bieden, kunt u selectie van inhoudsfragmenten naadloos naast elementen integreren. Op deze manier kunnen gebruikers door meerdere inhoudsfragmenten bladeren, deze doorzoeken en deze selecteren binnen dezelfde interface, zodat de inhoud op alle elementen en gestructureerde inhoud consistent kan worden geselecteerd.
const assetSelectorProps = {
featureSet: [
'upload', /* Include upload or other featureSet values to ensure no missing functionality */
'content-fragments', /* Content Fragments pill will be shown */
],
contentFragmentSelectorProps: {
/* Configures the Content Fragments Pill experience */
/* ...props @aem-sites/content-fragment-selector MFE supports */
}
}
<AssetSelector {...assetSelectorProps} />
In contentFragmentSelectorProps, kunt u om het even welke eigenschappen noemen beschikbaar bij de eigenschappen van de Selecteur van het Fragment van de Inhoud .
Voor informatie over hoe te om de Adviseur van de Inhoud met Angular te integreren, Reageer, en de toepassingen van JavaScript, verwijs naar de integratievoorbeelden van de Adviseur van de Inhoud .