[AEM Assets]{class="badge positive" title="S’applique à AEM Assets)."}
Installation et propriétés du gestionnaire d’accès content-advisor-installation-properties
Content Advisor peut également être intégré à des applications non Adobe (tierces), ce qui permet d’étendre la découverte intelligente des ressources au-delà des applications Adobe. Le même ensemble riche de fonctionnalités, notamment la recherche optimisée par l’IA, les recommandations contextuelles, la découverte basée sur des résumés de campagne, l’accès aux rendus Dynamic Media, la découverte de fragments de contenu, les filtres et les métadonnées de ressource, est pris en charge dans les intégrations tierces.
Prérequis prereqs
Vous devez vous assurer que les méthodes de communication suivantes sont disponibles :
- L’application hôte s’exécute sur HTTPS.
- Vous ne pouvez pas exécuter l’application sur
localhost. Si vous souhaitez intégrer le gestionnaire d’accès sur votre ordinateur local, vous devez créer un domaine personnalisé, par exemple[https://<your_campany>.localhost.com:<port_number>], et l’ajouter dans leredirectUrl list. - Vous pouvez configurer et ajouter des clientID dans la variable d’environnement Cloud Service AEM avec les
imsClientIdcorrespondants. - La liste des portées IMS doit être définie dans la configuration de l’environnement.
- L’URL de l’application se trouve dans la liste autorisée d’URL de redirection du client IMS.
- Le flux de connexion IMS est configuré et rendu à l’aide d’une fenêtre contextuelle sur le navigateur web. Par conséquent, les fenêtres contextuelles doivent être activées ou autorisées sur le navigateur cible.
Utilisez les conditions préalables ci-dessus si vous avez besoin du workflow d’authentification IMS du gestionnaire de contenu. Si votre authentification est déjà effective avec le workflow IMS, vous pouvez également ajouter les informations IMS à la place.
- Noms de domaine dans lesquels l’application d’intégration est hébergée.
- Après la mise en service, votre entreprise recevra
imsClientId,imsScopeet unredirectUrlcorrespondant aux environnements demandés qui sont essentiels à la configuration du gestionnaire de contenu. Sans ces propriétés valides, vous ne pouvez pas exécuter les étapes d’installation.
Installation content-advisor-installation
Le gestionnaire de contenu est disponible via le réseau CDN ESM (par exemple, esm.sh/skypack) et la version UMD.
Dans les navigateurs utilisant la version UMD (recommandé) :
<script src="https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/assets-selectors.js"></script>
<script>
const { renderAssetSelector } = PureJSSelectors;
</script>
Dans les navigateurs avec la prise en charge import maps à l’aide de la version du réseau CDN ESM :
<script type="module">
import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
</script>
Dans la fédération de modules Deno/Webpack à l’aide de la version du réseau CDN ESM :
import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
Propriétés du gestionnaire de contenu content-advisor-propertiess
Vous pouvez utiliser les propriétés de la fonction de conseil pour personnaliser son rendu. Le tableau suivant répertorie les propriétés que vous pouvez utiliser pour personnaliser et utiliser la fonction de conseil sur le contenu.
true, le gestionnaire d’accès s’affiche dans un rail à gauche. S’il est marqué false, le gestionnaire d’accès est rendu en mode modal.imsOrg est requise pour vous authentifier, que l’organisation à laquelle vous accédez se trouve sous Adobe IMS ou non.imsToken est obligatoire si vous utilisez une application Adobe pour l’intégration.apiKey est obligatoire si vous utilisez une intégration d’application Adobe.<Object>[{id: 'urn:234}, {id: 'urn:555'}]. Une ressource doit être disponible dans le répertoire actuel. Si vous devez utiliser un autre répertoire, saisissez également une valeur pour la propriété path.rail propriété pour activer la vue de rail de la visionneuse de ressources.Object<{ id?: string, defaultMessage?: string, description?: string}>i18nSymbols. Le transfert d’une valeur par le biais de cette interface remplace les traductions fournies par défaut par les vôtres. Pour effectuer le remplacement, vous devez transmettre un objet Descripteur de message valide à la clé de i18nSymbols que vous voulez remplacer.intl.locale. Par exemple : intl={{ locale: "es-es" }}Les chaînes de paramètres régionaux prises en charge suivent la norme ISO 639 - Codes pour la représentation des noms des normes linguistiques.
Liste des paramètres régionaux pris en charge : anglais (en-us, par défaut), espagnol (es-es), allemand (de-de), français (fr-fr), italien (it-it), japonais (ja-jp), coréen (ko-kr), portugais (pt-br), chinois (traditionnel, zh-cn), chinois (Taïwan, zh-tw).
Array<string>{allowList?: Object}default et express. Il prend également en charge les @react-spectrum/theme-express.Appelée avec un tableau d’éléments de ressource lorsque des ressources sont sélectionnées et que vous cliquez sur le bouton Select en mode modal. Cette fonction est uniquement appelée en mode modal. En mode rail, utilisez les fonctions handleAssetSelection ou onDrop. Exemple :
handleSelection=(assets: Asset[])=> {…}
Pour plus d’informations, consultez la section sélection de ressources.
Appelée avec un tableau d’éléments lorsque les ressources sont sélectionnées ou désélectionnées. Cela s’avère utile si vous souhaitez écouter les ressources lorsque l’utilisateur ou l’utilisatrice les sélectionne. Exemple :
handleAssetSelection=(assets: Asset[])=> {…}
Pour plus d’informations, consultez la section sélection de ressources.
Close en mode modal. Cette fonction est uniquement appelée en mode modal et n’est pas prise en compte en mode rail.single ou multiple de ressources à la fois.Syntaxe :
aemTierType: "author" "delivery"Par exemple, si les deux
["author","delivery"] sont utilisées, le sélecteur de référentiels affiche des options pour l’auteur et la diffusion.EXPIRED, des EXPIRING_SOON ou des NOT_EXPIRED en fonction de la date d’expiration d’une ressource que vous fournissez. Voir Personnalisation des ressources expirées . De plus, vous pouvez utiliser allowSelectionAndDrag dans lequel la valeur de la fonction peut être true ou false. Lorsque la valeur est définie sur false, la ressource expirée ne peut pas être sélectionnée ni glissée-déplacée sur la zone de travail.uploadConfig propriété . Ajoutez un tableau de champs que vous fournissez pour collecter les métadonnées de l’utilisateur. Cette propriété vous permet également d’utiliser des métadonnées masquées qui sont automatiquement affectées à une ressource, mais ne sont pas visibles par l’utilisateur.uploadConfig propriété . Il se compose de property et de value. Property est égal à mapToProperty du champ transmis à partir du metadataSchema dont la valeur est mise à jour. Tandis que value est égal à , la nouvelle valeur est fournie en tant qu’entrée."/content/dam"uploadConfig propriété . Le chemin de chargement cible pour les fichiers qui sont par défaut la racine du référentiel de ressources.uploadConfig propriété .(uploadInfo: UploadInfo) => void. Cette propriété est imbriquée sous uploadConfig propriété .sourceTypes utilise un tableau des sources d’importation que vous souhaitez activer. Les sources prises en charge sont Onedrive et Dropbox. La syntaxe est { sourceTypes?: ImportSourceType[]; apiKey?: string; }. De plus, cette propriété est imbriquée sous uploadConfig propriété .(uploadStats: UploadStats) => void. De plus, cette propriété est imbriquée sous uploadConfig propriété .uploadConfig propriété . Il s’agit d’une fonction de rappel utilisée pour afficher le comportement d’un chargement lorsqu’un fichier est modifié. Il transmet le nouveau tableau de fichiers en attente de chargement et le type de source du chargement. Le type Source peut être nul en cas d'erreur. La syntaxe est (newFiles: File[], uploadType: UploadType) => void{ href: string; alt: string; }. De plus, cette propriété est imbriquée sous uploadConfig propriété .featureSet:[ ] permet d’activer ou de désactiver une fonctionnalité particulière dans l’application du gestionnaire d’accès. Pour activer le composant ou une fonctionnalité, vous pouvez transmettre une valeur de chaîne dans le tableau ou laisser le tableau vide pour désactiver les fonctionnalités ajoutées et simplement avoir la fonctionnalité de base. Par exemple, si vous souhaitez activer la fonctionnalité de chargement dans le gestionnaire d’accès, utilisez la syntaxe featureSet:["upload"]. De même, vous pouvez utiliser featureSet:["content-fragments"] pour activer les fragments de contenu dans le gestionnaire d’accès. Pour utiliser plusieurs fonctionnalités ensemble, la syntaxe est featureSet:[« upload », « content-fragments »].ImsAuthProps ims-auth-props
Les propriétés ImsAuthProps définissent les informations d’authentification et le flux que le gestionnaire d’accès utilise pour obtenir une imsToken. En définissant ces propriétés, vous pouvez contrôler le comportement du flux d’authentification et enregistrer des écouteurs pour divers événements d’authentification.
imsClientIdimsScoperedirectUrlredirectUrl n’est fourni, ImsAuthService utilise redirectUrl pour enregistrer les imsClientIdmodalModetrue, le flux d’authentification s’affiche dans un pop-up. S’il est défini sur false, le flux d’authentification s’affiche lors d’un rechargement complet de la page. _Remarque :_pour une meilleure expérience utilisateur, vous pouvez contrôler dynamiquement cette valeur si le pop-up du navigateur est désactivé.onImsServiceInitializedservice, qui est un objet représentant le service Adobe IMS. Voir ImsAuthService pour plus d’informations.onAccessTokenReceivedimsToken est reçu du service d’authentification Adobe IMS. Cette fonction accepte un paramètre, imsToken, qui est une chaîne représentant le jeton d’accès.onAccessTokenExpiredonErrorReceivedImsAuthService ims-auth-service
ImsAuthService classe gère le flux d’authentification du gestionnaire d’accès. Il est chargé d’obtenir un imsToken du service d’authentification Adobe IMS. Le imsToken permet d’authentifier l’utilisateur et d’autoriser l’accès au référentiel Adobe Experience Manager as a Cloud Service Assets. ImsAuthService utilise les propriétés ImsAuthProps pour contrôler le flux d’authentification et enregistrer des écouteurs pour divers événements d’authentification. Vous pouvez utiliser la fonction de registerAssetsSelectorsAuthService pratique pour enregistrer l’instance ImsAuthService auprès du gestionnaire d’accès. Les fonctions suivantes sont disponibles dans la classe ImsAuthService. Cependant, si vous utilisez la fonction registerAssetsSelectorsAuthService, vous n’avez pas besoin d’appeler directement ces fonctions.
isSignedInUsergetImsTokenimsToken d’authentification de l’utilisateur actuellement connecté, qui peut être utilisé pour authentifier des requêtes à d’autres services, tels que la génération du _rendu de ressource.signInImsAuthProps pour afficher l’authentification dans un pop-up ou un rechargement complet de la pagesignOutrefreshTokencontentFragmentSelectorProps content-fragment-selector-properties
contentFragmentSelectorProps permet de configurer l’accès aux fragments de contenu et leur affichage dans la fonction de conseil sur le contenu. En activant la fonctionnalité de fragments de contenu dans le featureSet et en fournissant la configuration requise, vous pouvez intégrer facilement la sélection de fragments de contenu aux ressources. Cela permet aux utilisateurs et utilisatrices de parcourir, rechercher et sélectionner des fragments de contenu dans la même interface unifiée, assurant ainsi une expérience de sélection de contenu cohérente entre les ressources et le contenu structuré.
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} />
Dans contentFragmentSelectorProps, vous pouvez mentionner l’une des propriétés disponibles dans Propriétés du sélecteur de fragment de contenu.
Pour plus d’informations sur l’intégration de la fonction de conseil sur les contenus avec les applications Angular, React et JavaScript, consultez les exemples d’intégration de la fonction de conseil sur les contenus Content Advisor.