[AEM Assets]{class="badge positive" title="Gäller AEM Assets)."}
Installation och egenskaper för Content Advisor content-advisor-installation-properties
Content Advisor är också tillgängligt för integrering med andra program än Adobe (tredjepartsprogram), vilket gör att intelligent resursidentifiering kan användas även utanför Adobe-program. Samma omfattande funktionsuppsättning, inklusive AI-baserad sökning, kontextmedvetna rekommendationer, kampanjbaserad identifiering, åtkomst till dynamiska medierenderingar, identifiering av innehållsfragment, filter och metadata för mediefiler, stöds i tredjepartsintegrationer.
Förutsättningar prereqs
Du måste se till att följande kommunikationsmetoder används:
- Värdprogrammet körs på HTTPS.
- Du kan inte köra programmet på
localhost. Om du vill integrera Content Advisor på din lokala dator måste du skapa en anpassad domän, till exempel[https://<your_campany>.localhost.com:<port_number>], och lägga till den anpassade domänen iredirectUrl list. - Du kan konfigurera och lägga till clientID i AEM Cloud-tjänstmiljövariabeln med respektive
imsClientId. - Listan med IMS-scope måste definieras i miljökonfigurationen.
- Programmets URL finns i IMS-klientens tillåtelselista i omdirigerings-URL:er.
- Inloggningsflödet för IMS konfigureras och återges med hjälp av en popup-meny i webbläsaren. Därför bör popup-fönster vara aktiverade eller tillåtna i målwebbläsaren.
Använd ovanstående krav om du behöver arbetsflödet för IMS-autentisering i Content Advisor. Om du redan är autentiserad med IMS-arbetsflödet kan du lägga till IMS-informationen i stället.
- Domännamn där det integrerande programmet finns.
- Efter etableringen kommer din organisation att få
imsClientId,imsScopeoch enredirectUrlsom motsvarar de miljöer som efterfrågas och som är nödvändiga för konfigurationen av Content Advisor. Utan dessa giltiga egenskaper kan du inte köra installationsstegen.
Installation content-advisor-installation
Content Advisor är tillgängligt via både ESM CDN (till exempel version esm.sh/skypack) och version UMD.
I webbläsare som använder UMD-version (rekommenderas):
<script src="https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/assets-selectors.js"></script>
<script>
const { renderAssetSelector } = PureJSSelectors;
</script>
I webbläsare med import maps-stöd och ESM CDN-version:
<script type="module">
import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
</script>
I Deno/Webpack Module Federation med ESM CDN version:
import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
Egenskaper för Content Advisor content-advisor-propertiess
Du kan använda egenskaperna för Content Advisor för att anpassa hur Content Advisor återges. I följande tabell visas de egenskaper som du kan använda för att anpassa och använda Content Advisor.
true är markerat återges Content Advisor i den vänstra vyn. Om den är markerad som false återges Content Advisor i modal vy.imsOrg krävs för att autentisera om organisationen du försöker få åtkomst till är under Adobe IMS eller inte.imsToken krävs om du använder ett Adobe-program för integreringen.apiKey krävs om du använder en Adobe-programintegrering.<Object>[{id: 'urn:234}, {id: 'urn:555'}] En resurs måste till exempel vara tillgänglig i den aktuella katalogen. Om du behöver använda en annan katalog anger du även ett värde för egenskapen path.rail för att aktivera spårningsvisning av resursvyn.Object<{ id?: string, defaultMessage?: string, description?: string}>i18nSymbols-proppen. Om du skickar ett värde genom det här gränssnittet åsidosätts standardöversättningarna och i stället används dina egna. Om du vill utföra åsidosättningen måste du skicka ett giltigt Message Descriptor-objekt till nyckeln för i18nSymbols som du vill åsidosätta.intl.locale-utkastet. Till exempel: intl={{ locale: "es-es" }}De språksträngar som stöds följer ISO 639 - Codes för att representera namn på språkstandarder.
Lista över språkområden som stöds: Engelska - en-us (standard) spanska - es-es' German - de-de' French - fr-fr' Italian - it-it-it' Japanese - ja-jp' Korean - ko-kr' Portuguese - pt-br' Chinese (Traditional) - zh-cn' Chinese (Taiwan) - zh-tw
Array<string>{allowList?: Object}default och express. Det har även stöd för @react-spectrum/theme-express.Anropas med en array med tillgångsobjekt när resurser har valts och knappen Select på spärren klickas. Den här funktionen anropas bara i modal vy. Använd funktionerna handleAssetSelection eller onDrop för spårvyn. Exempel:
handleSelection=(assets: Resurs [])=> {…}
Mer information finns i Val av resurser.
Anropas med en array med objekt när resurserna markeras eller avmarkeras. Detta är användbart när du vill lyssna efter resurser när användaren väljer dem. Exempel:
handleAssetSelection=(assets: Resurs [])=> {…}
Mer information finns i Val av resurser.
Close i modal vy trycks ned. Detta anropas bara i vyn modal och ignoreras i vyn rail.single eller multiple urval av resurser åt gången.Syntax:
aemTierType: "author" "delivery"Om till exempel båda
["author","delivery"] används, visar databasväxlaren alternativ för både författare och leverans.EXPIRED, EXPIRING_SOON eller NOT_EXPIRED baserat på förfallodatumet för en resurs som du anger. Se anpassa utgångna resurser. Dessutom kan du använda allowSelectionAndDrag där värdet för funktionen antingen kan vara true eller false. När värdet är false kan resursen som har gått ut inte markeras eller dras på arbetsytan.uploadConfig. Lägg till en array med fält som du anger för att samla in metadata från användaren. Med den här egenskapen kan du även använda dolda metadata som tilldelas till en resurs automatiskt men inte är synliga för användaren.uploadConfig. Det består av property och value. Property är lika med mapToProperty för fältet som skickas från metadataSchema vars värde uppdateras. value är lika med det nya värdet som anges som indata."/content/dam"uploadConfig. Målets överföringssökväg för de filer som har standardvärdet root of the assets database.uploadConfig.(uploadInfo: UploadInfo) => void. Den här egenskapen är kapslad under egenskapen uploadConfig.sourceTypes använder en array med de importkällor som du vill aktivera. Källorna som stöds är Onedrive och Dropbox. Syntaxen är { sourceTypes?: ImportSourceType[]; apiKey?: string; }. Dessutom är den här egenskapen kapslad under egenskapen uploadConfig.(uploadStats: UploadStats) => void. Dessutom är den här egenskapen kapslad under egenskapen uploadConfig.uploadConfig. Det är en återanropsfunktion som används för att visa hur överföringen fungerar när en fil ändras. Den skickar den nya arrayen med filer som väntar på överföring och källtypen för överföringen. Source-typen kan vara null om fel uppstår. Syntaxen är (newFiles: File[], uploadType: UploadType) => void{ href: string; alt: string; }. Dessutom är den här egenskapen kapslad under egenskapen uploadConfig.featureSet:[ ] används för att aktivera eller inaktivera en viss funktion i Content Advisor-programmet. Om du vill aktivera komponenten eller en funktion kan du skicka ett strängvärde i arrayen eller lämna arrayen tom för att inaktivera tillagda funktioner, och bara ha basfunktionen. Om du till exempel vill aktivera överföringsfunktioner i Content Advisor använder du syntaxen featureSet:["upload"]. På samma sätt kan du använda featureSet:["content-fragments"] för att aktivera innehållsfragment i Content Advisor. Om du vill använda flera funktioner tillsammans är syntaxen featureSet:["upload", "content-fragments"].ImsAuthProps ims-auth-props
Egenskaperna ImsAuthProps definierar autentiseringsinformationen och det flöde som Content Advisor använder för att hämta en imsToken. Genom att ange dessa egenskaper kan du styra hur autentiseringsflödet ska fungera och registrera avlyssnare för olika autentiseringshändelser.
imsClientIdimsScoperedirectUrlredirectUrl inte anges använder ImsAuthService den redirectUrl som används för att registrera imsClientIdmodalModetrue visas autentiseringsflödet i ett popup-fönster. Om värdet är false visas autentiseringsflödet i en helsidesinläsning. _Note :_för bättre användargränssnitt, du kan dynamiskt styra det här värdet om användaren har webbläsarpopup-fönster inaktiverat.onImsServiceInitializedservice, som är ett objekt som representerar Adobe IMS-tjänsten. Mer information finns i ImsAuthService.onAccessTokenReceivedimsToken tas emot från Adobe IMS-autentiseringstjänsten. Den här funktionen tar en parameter, imsToken, som är en sträng som representerar åtkomsttoken.onAccessTokenExpiredonErrorReceivedImsAuthService ims-auth-service
Klassen ImsAuthService hanterar autentiseringsflödet för Content Advisor. Det ansvarar för att erhålla en imsToken från Adobe IMS-autentiseringstjänsten. imsToken används för att autentisera användaren och auktorisera åtkomst till Adobe Experience Manager som en Cloud Service Assets-databas. ImsAuthService använder egenskaperna ImsAuthProps för att styra autentiseringsflödet och registrera avlyssnare för olika autentiseringshändelser. Du kan använda den praktiska registerAssetsSelectorsAuthService-funktionen för att registrera ImsAuthService-instansen hos Content Advisor. Följande funktioner är tillgängliga för klassen ImsAuthService. Om du använder funktionen registerAssetsSelectorsAuthService behöver du inte anropa dessa funktioner direkt.
isSignedInUsergetImsTokenimsToken för den inloggade användaren, som kan användas för att autentisera begäranden till andra tjänster, som att generera resursåtergivning.signInImsAuthProps för att visa autentisering i antingen ett popup-fönster eller en helsidesinläsningsignOutrefreshTokencontentFragmentSelectorProps content-fragment-selector-properties
I contentFragmentSelectorProps kan du konfigurera hur innehållsfragment ska öppnas och visas i Content Advisor. Genom att aktivera funktionen för innehållsfragment i featureSet och tillhandahålla den konfiguration som krävs, kan du sömlöst integrera val av innehållsfragment tillsammans med resurser. Detta gör att användarna kan bläddra bland, söka efter och välja innehållsfragment i samma enhetliga gränssnitt, vilket ger ett enhetligt innehållsurval för olika resurser och strukturerat innehåll.
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} />
I contentFragmentSelectorProps kan du ange någon av de egenskaper som är tillgängliga i Egenskaper för innehållsfragmentväljare.
Mer information om hur du integrerar Content Advisor med Angular-, React- och JavaScript-program finns i Integreringsexempel för Content Advisor.