[AEM Assets]{class="badge positive" title="Si applica ad AEM Assets)."}
Installazione e proprietà di Content Advisor content-advisor-installation-properties
Content Advisor è inoltre disponibile per l'integrazione con applicazioni non Adobe (di terze parti), estendendo l'individuazione intelligente delle risorse oltre le applicazioni Adobe. Lo stesso set di funzioni avanzate, tra cui ricerca basata sull’intelligenza artificiale, consigli in base al contesto, individuazione basata su resoconto della campagna, accesso alle rappresentazioni Dynamic Media, individuazione dei frammenti di contenuto, filtri e metadati di risorse, è supportato nelle integrazioni di terze parti.
Prerequisiti prereqs
Devi accertarti di utilizzare i seguenti metodi di comunicazione:
- L’applicazione host è in esecuzione su HTTPS.
- Non è possibile eseguire l’applicazione su
localhost. Se si desidera integrare Contenuto verificato nel computer locale, è necessario creare un dominio personalizzato, ad esempio[https://<your_campany>.localhost.com:<port_number>], e aggiungere il dominio personalizzato inredirectUrl list. - Puoi configurare e aggiungere clientID nella variabile di ambiente di AEM Cloud Services con il rispettivo
imsClientId. - L’elenco degli ambiti IMS deve essere definito nella configurazione dell’ambiente.
- L’URL dell’applicazione si trova nell’elenco Consentiti degli URL di reindirizzamento del client IMS.
- Il flusso di accesso IMS viene configurato e renderizzato utilizzando un pop-up sul browser web. Pertanto, i popup devono essere abilitati o consentiti nel browser di destinazione.
Utilizzare i prerequisiti di cui sopra se è necessario il flusso di lavoro di autenticazione IMS di Content Advisor. In alternativa, se hai già effettuato l’autenticazione con il flusso di lavoro IMS, puoi aggiungere le informazioni IMS.
- Nomi di dominio in cui è ospitata l’applicazione di integrazione.
- Dopo il provisioning, all'organizzazione verranno forniti
imsClientId,imsScopee unredirectUrlcorrispondenti agli ambienti richiesti che sono essenziali per la configurazione di Content Advisor. Senza tali proprietà valide, non è possibile eseguire i passaggi di installazione.
Installazione content-advisor-installation
Contenuto verificato è disponibile tramite CDN ESM (ad esempio, esm.sh/skypack) e versione UMD.
Nei browser che utilizzano la versione UMD (scelta consigliata):
<script src="https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/assets-selectors.js"></script>
<script>
const { renderAssetSelector } = PureJSSelectors;
</script>
Nei browser con supporto di import maps che utilizzano la versione ESM CDN:
<script type="module">
import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
</script>
Nella federazione di moduli Deno/Webpack utilizzando la versione ESM CDN:
import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
Proprietà di Contenuto verificato content-advisor-propertiess
È possibile utilizzare le proprietà di Contenuto verificato per personalizzare il rendering di Contenuto verificato. Nella tabella seguente sono elencate le proprietà che è possibile utilizzare per personalizzare e utilizzare Contenuto verificato.
true, Contenuto verificato viene visualizzato in una barra a sinistra. Se è contrassegnato false, il rendering di Contenuto verificato viene eseguito nella visualizzazione modale.imsOrg è necessaria per autenticare se l'organizzazione a cui si accede è in Adobe IMS o meno.imsToken è obbligatorio se si utilizza un'applicazione Adobe per l'integrazione.apiKey è richiesto se si utilizza un'integrazione dell'applicazione Adobe.<Object>[{id: 'urn:234}, {id: 'urn:555'}] Deve essere disponibile una risorsa nella directory corrente. Se devi utilizzare una directory diversa, specifica anche un valore per la proprietà path.rail per abilitare la visualizzazione della barra del visualizzatore risorse.Object<{ id?: string, defaultMessage?: string, description?: string}>i18nSymbols. Il passaggio di un valore tramite questa interfaccia sostituisce le traduzioni predefinite fornite e utilizza le tue. Per eseguire la sostituzione, è necessario passare un oggetto valido del Descrittore del messaggio alla chiave di i18nSymbols che desideri sostituire.intl.locale. Ad esempio: intl={{ locale: "es-es" }}Le stringhe delle impostazioni internazionali supportate seguono ISO 639 - Codici per la rappresentazione dei nomi degli standard delle lingue.
Elenco delle lingue supportate: inglese - 'en-us' (impostazione predefinita) spagnolo - 'es-es' tedesco - 'de-de' francese - 'fr-fr' italiano - 'it-it' giapponese - 'ja-jp' coreano - 'ko-kr' portoghese - 'pt-br' cinese (tradizionale) - 'zh-cn' cinese (Taiwan) - 'zh-tw'
Array<string>{allowList?: Object}default e express. Supporta anche @react-spectrum/theme-express.Richiamata con un array di elementi di risorse quando queste sono selezionate e si fa clic sul pulsante Select nel modale. Questa funzione viene richiamata solo nella vista modale. Per la visualizzazione della barra, utilizza le funzioni handleAssetSelection o onDrop. Esempio:
handleSelection=(risorse: risorsa[])=> {…}
Per informazioni dettagliate, consulta selezione di risorse.
Richiamata con un array di elementi durante la selezione o la deselezione delle risorse. Questa funzione è utile quando si desidera ascoltare le risorse selezionate dall’utente. Esempio:
handleAssetSelection=(risorse: risorsa[])=> {…}
Per informazioni dettagliate, consulta selezione di risorse.
Close nella vista modale. Questa è chiamata solo nella vista modal e ignorata nella vista rail.single o multiple di risorse alla volta.Sintassi:
aemTierType: "author" "delivery"Ad esempio, se vengono utilizzati entrambi
["author","delivery"], il commutatore dell'archivio visualizza le opzioni sia per l'authoring che per la consegna.EXPIRED, EXPIRING_SOON o NOT_EXPIRED in base alla data di scadenza di una risorsa fornita. Consulta personalizzare le risorse scadute. È inoltre possibile utilizzare allowSelectionAndDrag in cui il valore della funzione può essere true o false. Quando il valore è impostato su false, la risorsa scaduta non può essere selezionata o trascinata nell'area di lavoro.uploadConfig. Aggiungi un array di campi fornito per raccogliere i metadati dall’utente. Utilizzando questa proprietà, puoi anche utilizzare metadati nascosti che vengono assegnati automaticamente a una risorsa ma non sono visibili all’utente.uploadConfig. È costituito da property e value. Property è uguale a mapToProperty del campo passato da metadataSchema il cui valore è in fase di aggiornamento. Mentre,value è uguale al nuovo valore fornito come input."/content/dam"uploadConfig. Percorso di caricamento di destinazione per i file che per impostazione predefinita sono nella directory principale dell’archivio delle risorse.uploadConfig.(uploadInfo: UploadInfo) => void. Questa proprietà è nidificata nella proprietà uploadConfig.sourceTypes utilizza un array delle origini di importazione che si desidera abilitare. Le origini supportate sono Onedrive e Dropbox. La sintassi è { sourceTypes?: ImportSourceType[]; apiKey?: string; }. Inoltre, questa proprietà è nidificata nella proprietà uploadConfig.(uploadStats: UploadStats) => void. Inoltre, questa proprietà è nidificata nella proprietà uploadConfig.uploadConfig. Si tratta di una funzione di callback utilizzata per mostrare il comportamento di caricamento quando un file viene modificato. Trasmette il nuovo array di file in attesa di caricamento e il tipo di origine del caricamento. Il tipo di Source può essere nullo in caso di errore. La sintassi è (newFiles: File[], uploadType: UploadType) => void{ href: string; alt: string; }. Inoltre, questa proprietà è nidificata sotto la proprietà uploadConfig.featureSet:[ ] viene utilizzata per abilitare o disabilitare una particolare funzionalità nell'applicazione Content Advisor. Per abilitare il componente o una funzione, puoi passare un valore stringa nell’array oppure lasciare vuoto l’array per disabilitare le funzioni aggiunte e disporre solo della funzionalità di base. Per abilitare ad esempio la funzionalità di caricamento in Contenuto verificato, utilizzare la sintassi featureSet:["upload"]. Analogamente, è possibile utilizzare featureSet:["content-fragments"] per abilitare i frammenti di contenuto in Contenuto verificato. Per utilizzare più funzionalità insieme, la sintassi è featureSet:["upload", "content-fragments"].ImsAuthProps ims-auth-props
Le proprietà ImsAuthProps definiscono le informazioni di autenticazione e il flusso utilizzati da Content Advisor per ottenere un imsToken. Impostando queste proprietà è possibile controllare il comportamento del flusso di autenticazione e registrare i listener per vari eventi di autenticazione.
imsClientIdimsScoperedirectUrlredirectUrl, ImsAuthService utilizza il redirectUrl utilizzato per registrare imsClientIdmodalModetrue, il flusso di autenticazione viene visualizzato in un popup. Se è impostato su false, il flusso di autenticazione viene visualizzato in un ricaricamento dell'intera pagina. _Note :_per una migliore interfaccia utente, è possibile controllare dinamicamente questo valore se la finestra popup del browser dell'utente è disabilitata.onImsServiceInitializedservice, che è un oggetto che rappresenta il servizio Adobe IMS. Per ulteriori dettagli, vedere ImsAuthService.onAccessTokenReceivedimsToken dal servizio di autenticazione Adobe IMS. Questa funzione accetta un parametro, imsToken, che è una stringa che rappresenta il token di accesso.onAccessTokenExpiredonErrorReceivedImsAuthService ims-auth-service
La classe ImsAuthService gestisce il flusso di autenticazione per Contenuto verificato. È responsabile dell'ottenimento di un imsToken dal servizio di autenticazione Adobe IMS. imsToken viene utilizzato per autenticare l'utente e autorizzare l'accesso a Adobe Experience Manager come archivio Assets Cloud Service. ImsAuthService utilizza le proprietà ImsAuthProps per controllare il flusso di autenticazione e registrare i listener per vari eventi di autenticazione. È possibile utilizzare la comoda funzione registerAssetsSelectorsAuthService per registrare l'istanza ImsAuthService con Contenuto verificato. Le seguenti funzioni sono disponibili nella classe ImsAuthService. Tuttavia, se si utilizza la funzione registerAssetsSelectorsAuthService, non è necessario chiamare queste funzioni direttamente.
isSignedInUsergetImsTokenimsToken per l'utente attualmente connesso, che può essere utilizzata per autenticare le richieste ad altri servizi, ad esempio per generare la _rappresentazione della risorsa.signInImsAuthProps per mostrare l'autenticazione in un popup o in un ricaricamento dell'intera paginasignOutrefreshTokencontentFragmentSelectorProps content-fragment-selector-properties
contentFragmentSelectorProps consente di configurare la modalità di accesso e visualizzazione dei frammenti di contenuto in Contenuto verificato. Attivando la funzione Frammenti di contenuto in featureSet e fornendo la configurazione richiesta, puoi integrare facilmente la selezione di Frammenti di contenuto insieme alle risorse. Questo consente agli utenti di sfogliare, cercare e selezionare Frammenti di contenuto all’interno della stessa interfaccia unificata, garantendo un’esperienza di selezione dei contenuti coerente tra risorse e contenuti strutturati.
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 è possibile indicare qualsiasi proprietà disponibile in Proprietà selettore frammento di contenuto.
Per informazioni su come integrare Content Advisor con le applicazioni Angular, React e JavaScript, vedere Esempi di integrazione di Content Advisor.