Déployer le connecteur Adobe Experience Manager Assets Microsoft 365 Copilot

Le connecteur Adobe Experience Manager (AEM) Assets Copilot intègre le contenu des ressources AEM dans l’écosystème Microsoft 365, ce qui permet à Copilot et Microsoft Search de faire apparaître les ressources publiées. Cet article décrit les étapes de déploiement et de personnalisation du connecteur.

Configuration requise

Avant de déployer le connecteur Adobe Experience Manager Assets, vérifiez que vous remplissez les conditions préalables suivantes :

• Vous devez être l’administrateur de recherche du locataire Microsoft 365 de votre organization.
• Vous disposez de l’URL de l’environnement de création adobe Experience Cloud instance de votre organization et de l’URL de l’environnement de publication :
  • Format de l’URL de l’auteur : https://author-p<PROGRAM_ID>-e<ENVIRONMENT_ID>.<REGION>.adobeaemcloud.com
  • Format d’URL de publication : https://publish-p<PROGRAM_ID>-e<ENVIRONMENT_ID>.<REGION>.adobeaemcloud.com
• Vous disposez d’un compte technique pour les ressources Adobe Experience Manager avec des informations d’identification permettant d’accéder aux ressources publiées et aux métadonnées. Ce compte est un compte sécurisé basé sur un service pour l’accès externe. Pour plus d’informations, consultez Génération de jetons d’accès pour les API côté serveur.

Déployer le connecteur

Pour ajouter le connecteur Adobe Experience Manager Assets pour votre organization :

1. Dans le Centre d’administration Microsoft 365, dans le volet gauche, choisissezConnecteursCopilot>.
2. Accédez à l’onglet Connecteurs , puis dans le volet gauche, choisissez Galerie.
3. Dans la liste des connecteurs disponibles, choisissez Ressources Adobe Experience Manager.

Définir le nom d’affichage

Le nom d’affichage identifie les références dans les réponses Copilot et agit comme un filtre source de contenu. Vous pouvez accepter le nom d’affichage par défaut ou le personnaliser avec un nom que les utilisateurs de votre organization reconnaissent.

Pour plus d’informations, consultez Améliorer la découverte copilote du contenu du connecteur.

Définir instance URL

Fournissez les URL d’environnement d’auteur et de publication pour vos ressources Adobe Experience Manager instance.

Choisir le type d’authentification

Le connecteur prend en charge l’authentification de compte technique pour Adobe Experience Cloud. Configurez le compte technique comme décrit dans Générer des jetons d’accès pour les API côté serveur.

Déploiement

Pour valider le connecteur avant le déploiement, utilisez un déploiement intermédiaire. Pour effectuer un déploiement sur un public limité, choisissez le bouton bascule en regard de Déploiement sur une audience limitée et spécifiez les utilisateurs et les groupes sur lesquels déployer le connecteur. Pour plus d’informations, consultez Déploiement intermédiaire pour les connecteurs Copilot.

Choisissez Créer pour déployer la connexion. Le connecteur commence immédiatement l’indexation des ressources publiées.

Le tableau suivant répertorie les valeurs par défaut qui sont définies.

Pour personnaliser ces valeurs, choisissez Configuration personnalisée. Pour plus d’informations, consultez Personnaliser les paramètres.

Après avoir créé votre connexion, vous pouvez consulter les status dans la section Connecteurs du Centre d’administration Microsoft 365.

Personnaliser les paramètres (facultatif)

Vous pouvez personnaliser les valeurs par défaut pour les paramètres du connecteur Adobe Experience Manager Assets. Pour personnaliser les paramètres, dans la page du connecteur dans le Centre d’administration, choisissez Configuration personnalisée. 

Personnaliser les paramètres utilisateur

Autorisations d’accès

Actuellement, seules les ressources publiées de vos ressources AEM sont indexées. Toutes les données indexées à l’aide du connecteur Adobe Experience Manager Assets Copilot sont visibles par tous les utilisateurs Microsoft 365 de votre locataire, à partir de Microsoft Search ou copilot.

Mappage de l’identité utilisateur

Le connecteur mappe les comptes d’utilisateur Adobe Experience Cloud aux identités Microsoft 365 (Microsoft Entra ID). Si les e-mails des utilisateurs Adobe Experience Cloud correspondent à leur nom d’utilisateur principal (UPN) d’ID Entra, ce mappage est automatique. Si elles diffèrent, vous pouvez fournir une règle de mappage pour mapper les identités dans Adobe Experience Cloud aux identités dans Microsoft 365. Les règles de mappage garantissent que le système fournit un signal d’activité approprié au contenu Adobe Experience Cloud dans les réponses.

Personnaliser les paramètres de contenu

Filtres d’ingestion de contenu

Les filtres d’ingestion de contenu vous permettent de contrôler les ressources indexées en définissant des règles d’inclusion et d’exclusion basées sur les chemins d’accès et les propriétés de métadonnées.

Vous pouvez choisir d’inclure ou d’exclure certains chemins de contenu.

Chemins de contenu qui doivent être extraits Seuls les chemins exacts sont pris en charge. Un chemin de contenu valide doit contenir au moins deux niveaux, avec /content comme chemin d’accès racine.

Chemins de contenu qui ne doivent pas être récupérés Prend uniquement en charge l’expression régulière Java d’entrée pour les chemins d’accès. Les chemins exclus sont prioritaires sur les chemins inclus.

Vous pouvez également définir des filtres d’ingestion en fonction de la valeur des propriétés de métadonnées, y compris les propriétés de métadonnées standard et personnalisées :

1. Entrez le chemin JSON de la propriété .
2. Sélectionnez un opérateur dans la liste déroulante (=, !=, In, Not In).
3. Entrez la valeur cible.

Pour rechercher et vérifier le chemin d’accès à la propriété, consultez API du Générateur de requêtes.

1. Ouvrez le débogueur du générateur de requêtes à l’adresse http://<host>:<port>/libs/cq/search/content/querydebug.html.

2. Entrez la requête suivante.

   p.limit=10  
   p.guessTotal=true  
   p.hits=full  
   type=dam:Asset  
   p.nodedepth=2  
   property=jcr:content/cq:lastReplicationAction  
   property.value=Activate
   

3. Choisissez rechercher.

4. Une fois les résultats retournés, choisissez le lien générateur de requêtes JSON pour afficher le contenu JSON avec toutes les propriétés.

   

5. Recherchez la propriété et le chemin JSON de la propriété. Par exemple, le chemin JSON de la propriété dc:format est hits.jcr:content.metadata.dc:format.

   

Opérateurs
L’opérateur définit le type de comparaison appliqué à une propriété pendant le filtrage du contenu. Les opérateurs pris en charge sont :

• =:Égale
• !=: n’est pas égal à
• In: correspond à n’importe quelle valeur d’une liste
• Not In: exclut toute valeur d’une liste

Valeurs cibles
Les valeurs cibles spécifient ce que la propriété doit correspondre.

Gérer les propriétés

Pour case activée propriétés standard disponibles à partir de vos ressources Adobe Experience Manager, affectez un schéma à la propriété (définissez si une propriété peut faire l’objet d’une recherche, si elle est interrogeable, récupérable ou refinable), modifiez l’étiquette sémantique et ajoutez un alias à la propriété. Les propriétés standard suivantes sont indexées par défaut.

Pour ajouter d’autres propriétés personnalisées :

1. Sélectionnez Ajouter une propriété.
2. Renseignez les champs suivants : a. Nom de la propriété b. Tapez c. Chemin d’accès JSON
3. Définissez le schéma (pouvant faire l’objet d’une recherche, interrogeable, récupérable ou refinable).

Personnaliser les intervalles de synchronisation

L’intervalle d’actualisation détermine la fréquence à laquelle vos données sont synchronisées entre la source de données et l’index du connecteur Adobe Experience Manager Assets. Les connecteurs Copilot utilisent deux types d’intervalles d’actualisation :

• Analyse complète : la valeur par défaut est tous les jours.
• Analyse incrémentielle : la valeur par défaut est toutes les 15 minutes.

Vous pouvez modifier les valeurs par défaut des intervalles d’actualisation. Pour plus d’informations, consultez Recommandations pour les paramètres de synchronisation.

Contenu connexe

• Vue d’ensemble du connecteur Adobe Experience Manager Assets
• Résoudre les problèmes liés au connecteur Adobe Experience Manager Assets