[AEM Assets]{class="badge positive" title="Gilt für AEM Assets)."}
Installation und Eigenschaften von Content Advisor content-advisor-installation-properties
Content Advisor ist auch für die Integration mit Anwendungen anderer Anbieter als Adobe verfügbar, wodurch die intelligente Asset-Erkennung über Adobe-Anwendungen hinaus erweitert werden kann. Derselbe umfangreiche Funktionssatz, einschließlich KI-gestützter Suche, kontextabhängiger Empfehlungen, kurzbasierter Erkennung in Campaign, Zugriff auf Dynamic Media-Ausgabedarstellungen, Erkennung von Inhaltsfragmenten, Filtern und Asset-Metadaten, wird in Integrationen von Drittanbietern unterstützt.
Voraussetzungen prereqs
Sie müssen die folgenden Kommunikationsmethoden sicherstellen:
- Die Host-Anwendung wird unter HTTPS ausgeführt.
- Sie können die Anwendung nicht auf
localhostausführen. Wenn Sie Content Advisor auf Ihrem lokalen Computer integrieren möchten, müssen Sie eine benutzerdefinierte Domain erstellen, z. B.[https://<your_campany>.localhost.com:<port_number>], und diese benutzerdefinierte Domain demredirectUrl listhinzufügen. - Sie können die Client-ID konfigurieren und sie zur AEM Cloud Service-Umgebungsvariablen mit der entsprechenden
imsClientIdhinzufügen. - Die Liste der IMS-Bereiche muss in der Umgebungskonfiguration definiert werden.
- Die URL der Anwendung befindet sich in der Zulassungsliste der Umleitungs-URLs des IMS-Clients.
- Der IMS-Anmeldefluss wird mithilfe eines Popup-Fensters im Webbrowser konfiguriert und gerendert. Daher sollten Popup-Fenster im Ziel-Browser aktiviert oder zugelassen werden.
Verwenden Sie die oben genannten Voraussetzungen, wenn Sie den IMS-Authentifizierungs-Workflow von Content Advisor benötigen. Wenn Sie bereits mit dem IMS-Workflow authentifiziert sind, können Sie stattdessen die IMS-Informationen hinzufügen.
- Domain-Namen, auf denen die integrierende Anwendung gehostet wird.
- Nach der Bereitstellung erhält Ihr Unternehmen
imsClientId,imsScopeund eineredirectUrl, die den angeforderten Umgebungen entspricht, die für die Konfiguration von Content Advisor erforderlich sind. Ohne diese gültigen Eigenschaften können Sie die Installationsschritte nicht ausführen.
Installation content-advisor-installation
Der Inhaltsratgeber ist sowohl über die ESM CDN-Version (z. B. esm.sh/skypack) als auch über die UMD-Version verfügbar.
In Browsern mit UMD-Version (empfohlen):
<script src="https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/assets-selectors.js"></script>
<script>
const { renderAssetSelector } = PureJSSelectors;
</script>
In Browsern mit import maps-Unterstützung mit 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>
In der Deno/Webpack Module Federation mit ESM CDN-Version:
import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
Eigenschaften von Content Advisor content-advisor-propertiess
Mit den Eigenschaften von Content Advisor können Sie anpassen, wie der Content Advisor gerendert wird. In der folgenden Tabelle sind die Eigenschaften aufgeführt, mit denen Sie Content Advisor anpassen und verwenden können.
true markiert, wird der Inhaltsratgeber in der linken Leistenansicht gerendert. Wenn er als false markiert ist, wird der Content Advisor in der modalen Ansicht gerendert.imsOrg-Schlüssel ist erforderlich, damit authentifiziert wird, ob sich die Organisation, auf die Sie zugreifen, unter Adobe IMS befindet oder nicht.imsToken ist erforderlich, wenn Sie eine Adobe-Anwendung für die Integration verwenden.apiKey ist erforderlich, wenn Sie eine Integration mit einer Adobe-Anwendung verwenden.<Object>[{id: 'urn:234}, {id: 'urn:555'}] Ein Asset muss im aktuellen Verzeichnis verfügbar sein. Wenn Sie ein anderes Verzeichnis verwenden müssen, geben Sie auch einen Wert für die Eigenschaft path an.rail verwendet, um die Leistenansicht des Asset-Wählers zu aktivieren.Object<{ id?: string, defaultMessage?: string, description?: string}>i18nSymbols übergeben können. Wenn Sie über diese Schnittstelle einen Wert übergeben, werden die bereitgestellten Standardübersetzungen überschrieben und stattdessen Ihre eigenen verwendet. Um die Überschreibung vorzunehmen, müssen Sie ein gültiges Message Descriptor-Objekt an den Schlüssel von i18nSymbols übergeben, den Sie überschreiben möchten.intl.locale-Eigenschaft bereitstellen. Beispiel: intl={{ locale: "es-es" }}Die unterstützten Gebietsschema-Zeichenfolgen folgen den ISO 639 - Codes für die Darstellung von Namen von Sprachen.
Liste der unterstützten Gebietsschemata: Englisch: „en-us“ (Standard), Spanisch: „es-es“, Deutsch: „de-de“, Französisch: „fr-fr“, Italienisch: „it-it“, Japanisch: „ja-jp“, Koreanisch: „ko-kr“, Portugiesisch: „pt-br“, Chinesisch (Vereinfacht): „zh-cn“, Chinesisch (Taiwan): „zh-tw“
Array<string>{allowList?: Object}default und express ein Design auf die Content Advisor-Anwendung an. Zudem wird @react-spectrum/theme-express unterstützt.Wird mit einem Array von Asset-Elementen aufgerufen, wenn Assets ausgewählt sind und die Schaltfläche Select im Modal angeklickt wird. Diese Funktion wird nur in der modalen Ansicht aufgerufen. Verwenden Sie für die Leistenansicht die Funktionen handleAssetSelection oder onDrop. Zum Beispiel:
handleSelection=(assets: Asset[])=> {…}
Weitere Informationen finden Sie unter Auswahl von Assets.
Wird mit einem Array von Elementen aufgerufen, während die Assets ausgewählt oder deren Auswahl aufgehoben wird. Dies ist nützlich, wenn Sie auf Assets warten möchten, während die Benutzenden sie auswählen. Zum Beispiel:
handleAssetSelection=(assets: Asset[])=> {…}
Weitere Informationen finden Sie unter Auswahl von Assets.
Close-Schaltfläche in der modalen Ansicht gedrückt wird. Dies wird nur in der modal-Ansicht aufgerufen und in der rail-Ansicht nicht beachtet.single- oder multiple-Auswahl von Assets auf einmal.Syntax:
aemTierType: "author" "delivery"Wenn beispielsweise beide
["author","delivery"] verwendet werden, zeigt der Repository-Umschalter Optionen für Autor und Versand an.EXPIRED, EXPIRING_SOON oder NOT_EXPIRED zurück. Siehe Anpassen abgelaufener Assets. Darüber hinaus können Sie die Option allowSelectionAndDrag verwenden, in der der Wert der Funktion entweder true oder false sein kann. Wenn der Wert auf false festgelegt ist, kann das abgelaufene Asset weder ausgewählt noch auf die Arbeitsfläche gezogen werden.uploadConfig verschachtelt. Fügen Sie ein Array von Feldern hinzu, die Sie bereitstellen, um Metadaten von der Benutzerin oder dem Benutzer zu erfassen. Mit dieser Eigenschaft können Sie auch versteckte Metadaten verwenden, die einem Asset automatisch zugewiesen werden, für die Benutzerin bzw. den Benutzer jedoch nicht sichtbar sind.uploadConfig verschachtelt. Sie besteht aus property und value. Property entspricht der mapToProperty des Felds, das vom metadataSchema übergeben wird, dessen Wert aktualisiert wird. Dahingegen entsprichtvalue dem neuen Wert und wird als Eingabe bereitgestellt."/content/dam"uploadConfig verschachtelt. Der Ziel-Upload-Pfad für die Dateien, der standardmäßig auf den Stamm des Assets-Repositorys festgelegt ist.uploadConfig verschachtelt.(uploadInfo: UploadInfo) => void. Diese Eigenschaft ist mit der Eigenschaft uploadConfig verschachtelt.sourceTypes verwendet ein Array der Importquellen, die Sie aktivieren möchten. Die unterstützten Quellen sind Onedrive und Dropbox. Die Syntax lautet { sourceTypes?: ImportSourceType[]; apiKey?: string; }. Darüber hinaus ist diese Eigenschaft mit der Eigenschaft uploadConfig verschachtelt.(uploadStats: UploadStats) => void. Darüber hinaus ist diese Eigenschaft mit der Eigenschaft uploadConfig verschachtelt.uploadConfig verschachtelt. Es handelt sich dabei um eine Rückruffunktion, mit der das Verhalten des Uploads angezeigt wird, wenn eine Datei geändert wird. Sie gibt das neue Array der Dateien, die zum Hochladen ausstehen, und den Quelltyp des Uploads weiter. Der Quelltyp kann im Fehlerfall null sein. Die Syntax lautet (newFiles: File[], uploadType: UploadType) => void{ href: string; alt: string; }. Darüber hinaus ist diese Eigenschaft mit der Eigenschaft uploadConfig verschachtelt.featureSet:[ ]-Eigenschaft wird verwendet, um eine bestimmte Funktion in der Content Advisor-Anwendung zu aktivieren oder zu deaktivieren. Um die Komponente oder eine Funktion zu aktivieren, können Sie einen Zeichenfolgenwert im Array übergeben oder das Array leer lassen, um hinzugefügte Funktionen zu deaktivieren, und nur die Basisfunktion zu nutzen. Wenn Sie z. B. die Upload-Funktion im Content Advisor aktivieren möchten, verwenden Sie die featureSet:["upload"]. Ebenso können Sie featureSet:["content-fragments"] verwenden, um Inhaltsfragmente im Inhaltsratgeber zu aktivieren. Um mehrere Funktionen zusammen zu verwenden, lautet die Syntax featureSet:[„upload“, „content-fragments“].ImsAuthProps ims-auth-props
Die ImsAuthProps definieren die Authentifizierungsinformationen und den Fluss, den der Content Advisor zum Abrufen eines imsToken verwendet. Durch Festlegen dieser Eigenschaften können Sie steuern, wie sich der Authentifizierungsfluss verhält, und Listener für verschiedene Authentifizierungsereignisse registrieren.
imsClientIdimsScoperedirectUrlredirectUrl bereitgestellt wird, verwendet ImsAuthService die zum Registrieren der imsClientId verwendete redirectUrlmodalModetrue festgelegt ist, wird der Authentifizierungsfluss in einem Popup-Fenster angezeigt. Wenn false festgelegt ist, wird der Authentifizierungsfluss bei vollständigem Neuladen der Seite angezeigt. Hinweis::_Für ein besseres Anwendererlebnis können Sie diesen Wert dynamisch steuern, wenn Popup-Fenster des Browsers deaktiviert sind.onImsServiceInitializedservice, ein Objekt, das den Adobe IMS-Dienst darstellt. Siehe ImsAuthService für weitere Informationen.onAccessTokenReceivedimsToken vom Adobe IMS-Authentifizierungsdienst empfangen wird. Diese Funktion akzeptiert einen Parameter namens imsToken, eine Zeichenfolge, die das Zugriffstoken darstellt.onAccessTokenExpiredonErrorReceivedImsAuthService ims-auth-service
ImsAuthService Klasse verarbeitet den Authentifizierungsfluss für den Content Advisor. Sie ist für den Erhalt eines imsToken über den Adobe IMS-Authentifizierungsdienst verantwortlich. Das imsToken wird verwendet, um die Benutzerin oder den Benutzer zu authentifizieren und den Zugriff auf das Adobe Experience Manager as a Cloud Service Assets-Repository zu autorisieren. ImsAuthService verwendet die ImsAuthProps-Eigenschaften, um den Authentifizierungsfluss zu steuern und Listener für verschiedene Authentifizierungsereignisse zu registrieren. Sie können die praktische registerAssetsSelectorsAuthService verwenden, um die Instanz ImsAuthService beim Inhaltsratgeber zu registrieren. Die folgenden Funktionen sind in der ImsAuthService-Klasse verfügbar. Wenn Sie jedoch die Funktion registerAssetsSelectorsAuthService verwenden, müssen Sie diese Funktionen nicht direkt aufrufen.
isSignedInUsergetImsTokenimsToken für die derzeit angemeldete Person ab, das zum Authentifizieren von Anforderungen für andere Dienste wie zum Beispiel zum Generieren von Asset-Ausgabedarstellungen verwendet werden kann.signInImsAuthProps, um die Authentifizierung in einem Popup-Fenster oder beim vollständigem Neuladen einer Seite anzuzeigensignOutrefreshTokencontentFragmentSelectorProps content-fragment-selector-properties
Mit contentFragmentSelectorProps können Sie konfigurieren, wie der Zugriff auf und die Anzeige von Inhaltsfragmenten im Inhaltsratgeber erfolgt. Durch Aktivierung der Funktion für Inhaltsfragmente im featureSet und Bereitstellung der erforderlichen Konfiguration können Sie die Inhaltsfragmentauswahl nahtlos neben Assets integrieren. Dadurch können Benutzende Inhaltsfragmente in derselben einheitlichen Benutzeroberfläche durchsuchen, durchsuchen und auswählen, was eine konsistente Inhaltsauswahl für alle Assets und strukturierten Inhalte gewährleistet.
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 können Sie auf jede der verfügbaren Eigenschaften verweisen (Eigenschaften Inhaltsfragmentauswahl.
Informationen zur Integration von Content Advisor in Angular-, React- und JavaScript-Anwendungen finden Sie unter für die Integration von Content Advisor.