Synchroniser les ressources en utilisant AEM

L'intégration de Showpad avec Adobe Experience Manager (AEM) permet aux marketeurs de distribuer instantanément du contenu à leurs équipes de vente tout en gardant AEM comme source unique de vérité pour la gestion du contenu. Le contenu est automatiquement synchronisé avec Showpad, optimisé pour une utilisation web et mobile, et suivi pour voir ce qui est utilisé—ou non.

En synchronisant le contenu, vous pouvez être assuré que tout le contenu dans Showpad est le plus récent et à jour sans avoir besoin de mettre à jour manuellement chaque ressource individuellement.

Le connecteur AEM de Showpad prend en charge un large éventail d'options de configuration pour s'adapter à votre architecture AEM, qu'elle soit sur site ou dans le cloud. Le connecteur permet la synchronisation du contenu à partir des niveaux Auteur et Éditeur d'AEM et peut être configuré en mode push uniquement, pull uniquement ou push et pull pour une réconciliation complète des actifs.

Caractéristiques principales

• Rationalisez votre gestion des ressources dans Showpad
• Utilisez AEM comme votre source unique de vérité
• Mapper les métadonnées des ressources AEM aux propriétés Showpad
• Continuez à télécharger les actifs directement sur le site Content Library selon les besoins.

Vous avez besoin de cela pour réussir

Note : Veuillez contacter votre Customer Success Manager pour obtenir l'accès au package du connecteur AEM.

Procédez étape par étape

Travaillez avec votre équipe Showpad locale pour planifier l'approche de synchronisation appropriée et obtenir la version pertinente du plug-in AEM. Une fois le plug-in ajouté à votre environnement AEM, l'intégration peut être configurée en suivant les étapes ci-dessous.

Installer l'application Showpad Adobe Experience Manager

Vous pouvez installer l'application Adobe Experience Manager depuis l'Admin App.

1. Cliquez sur l'icône d'engrenage pour ouvrir les Paramètres d'administration.
2. Dans la section Applications Showpad, sélectionnez Gérer les applications.
3. Cliquez sur Installer l'application.
4. Sélectionnez l'application Adobe Experience Manager à installer dans le menu Applications disponibles. Assurez-vous que la case à cocher Installer automatiquement la nouvelle version lorsqu'elle est disponible est activée.
5. Cliquez sur Installer.
6. Une fois l'application installée, vous devrez autoriser l'intégration.

Autoriser l'intégration

La première fois que vous ouvrez l'application Showpad Adobe Experience Manager, il vous sera demandé d'autoriser l'intégration pour permettre l'accès aux APIs concernées. Pour terminer ce processus, cliquez sur le bouton Autoriser.

Configurer l'intégration

Pour commencer, connectez-vous à Adobe Experience Manager.

1. Dans l'Admin App, cliquez sur l'icône d'engrenage.
2. Dans la section Applications Showpad, sélectionnez Adobe Experience Manager.
3. Cliquez sur le bouton Ajouter une nouvelle connexion.
4. Sélectionnez la Division Showpad et cliquez sur le bouton Connect to Adobe Experience Manager. Cela garantit que votre connexion sait à quelle Division synchroniser les ressources. Si vous n'avez pas plusieurs Divisions, la liste déroulante n'est pas affichée.
5. Sélectionnez votre approche pour synchroniser les ressources entre AEM et Showpad. La disposition du formulaire changera en fonction de la sélection que vous faites.
   • Push et Pull (recommandé) : Recevez des mises à jour push en temps quasi réel d'AEM concernant les ressources et les métadonnées avec une cohérence garantie grâce à des réconciliations pull régulières.
   • Push uniquement : Recevez des mises à jour d'actifs et de métadonnées en quasi temps réel envoyées depuis AEM vers Showpad.
   • Extraction uniquement : Showpad vérifiera régulièrement les mises à jour des ressources et des métadonnées dans Adobe Experience Manager selon un calendrier programmé.
6. Pour configurer une synchronisation push et pull :
   
   • Collez la clé API Push de Showpad dans la configuration d'Adobe Experience Manager
   • Saisissez le nom d'hôte d'Adobe Experience Manager où le plugin Showpad AEM est installé
   • Saisissez l'identifiant du locataire Adobe Experience Manager où le plugin AEM Showpad est installé.
   • Collez l'ID client pour configurer la synchronisation par extraction dans Adobe Experience Manager.
7. Pour configurer une synchronisation push :
   
   • Collez la clé API de Showpad dans la configuration d'Adobe Experience Manager.
   • Saisissez l'identifiant du locataire Adobe Experience Manager où le plugin AEM Showpad est installé.
8. Pour configurer une synchronisation par extraction :
   
   • Saisissez le nom d'hôte d'Adobe Experience Manager où le plugin Showpad Adobe Experience Manager est installé.
   • Copiez l'ID client pour configurer la synchronisation par extraction et collez-le dans Adobe Experience Manager.
   • Copiez la clé publique pour configurer la synchronisation par extraction et collez-la dans Adobe Experience Manager.
9. Faites correspondre la configuration de l'approche de flux d'actifs sélectionnée dans Showpad avec votre environnement AEM. Le panneau de configuration se trouve dans AEM > Outils > Showpad.
10. Cliquez sur Configurations.

11. Sélectionnez les boutons radio pour les flux appropriés, soit push, pull ou les deux, et collez les détails appropriés présentés à l'étape précédente dans la plateforme Showpad.

     

Sélectionnez « Ressources »

Dans cette étape, vous allez spécifier quels actifs AEM doivent être synchronisés d'AEM à Showpad.

La nature flexible de l'intégration Showpad AEM signifie que toutes les métadonnées d'actifs AEM existantes disponibles peuvent être utilisées comme filtre de synchronisation.
Pour utiliser le champ d'intégration « Out of the Box » ‘Sync to Showpad’ trouvé dans le volet des propriétés des actifs AEM sur l'onglet Showpad, collez fields.jcr:content/metadata/dc:showpadAsset dans le champ Clé et true dans le champ Valeur.

De plus, si vous ne synchronisez que des dossiers spécifiques d'AEM vers Showpad, configurez les chemins comme un filtre d'actifs en ajoutant fields.configPath au champ Key et le chemin vers votre dossier dans le champ Value, par exemple /content/dam/folderName

Des critères de synchronisation supplémentaires peuvent être ajoutés à la configuration en ajoutant des filtres avec les paires clé-valeur appropriées. Seuls les actifs répondant à tous les critères de filtrage seront synchronisés avec Showpad.

Facultativement, la section Exclusions vous permet de définir des types de fichiers spécifiques et des tags à exclure.
Types de fichiers ignorés - Voici une liste de types de fichiers qui ne seront jamais synchronisés (même si Showpad les prend en charge). Dans la liste déroulante, sélectionnez les types de fichiers que vous ne souhaitez pas synchroniser.

Tags ignorés - Voici une liste de tags qui ne seront jamais synchronisés (même s'ils existent dans Showpad). Entrez les tags qui ne doivent pas être créés ou assignés.

Cliquez sur le bouton Suivant.

Attributs de Cartographie

La cartographie des attributs détermine quels champs de métadonnées d'AEM sont mappés à quelles propriétés des ressources Showpad.

Le champ Nom est le seul attribut obligatoire qui doit être mappé. En option, vous pouvez mapper toutes les propriétés standard de Showpad directement à partir des métadonnées des ressources AEM - consultez le tableau de référence des propriétés ci-dessous qui détaille les valeurs des champs AEM pour les propriétés standard de Showpad.

Il est important de noter que les propriétés spécifiées dans le mappage sont contrôlées depuis la Source (AEM) et ne doivent pas être modifiées dans Showpad. Cela signifie qu'à chaque synchronisation d'un actif, sa valeur dans Showpad sera recalculée et écrasée par AEM. Toute modification apportée à une propriété dans Showpad sera perdue. Si vous souhaitez conserver le contrôle d'une certaine propriété dans la bibliothèque Showpad, ne la mappez pas dans la configuration de l'intégration.

Lorsque vous avez terminé la cartographie, cliquez sur le bouton Suivant.

Confirmer la Configuration

La dernière étape vous permet de revoir votre configuration et de spécifier la fréquence de synchronisation.

Cochez l'option Activé pour activer immédiatement la synchronisation lors de l'enregistrement. Si vous laissez cette option non sélectionnée, la synchronisation sera enregistrée dans un état désactivé, prête à être activée ultérieurement.

Cliquez sur le bouton de connexion Enregistrer.

Une fois enregistré, un aperçu de la configuration est affiché.

Des icônes sont disponibles pour vous permettre d'effectuer les actions suivantes :

• Activé - Vous pouvez activer ou désactiver la synchronisation en basculant l'interrupteur.
• Actualiser - Vous pouvez déclencher une resynchronisation immédiate de tous les actifs. Cette action n'affecte pas le calendrier de fréquence configuré.
• Dupliquer - Vous pouvez créer une nouvelle connexion pour une Division différente ou réutiliser la connexion avec des paramètres différents.
• Modifier - Vous pouvez modifier les paramètres de configuration.
• Supprimer - Vous pouvez supprimer la connexion.

Vous pouvez accéder à vos paramètres de configuration à tout moment via le tableau de bord. Veuillez vous référer à la section Tableau de bord pour plus d'informations.

Désigner les autorisations Showpad au niveau des ressources

Dans l'onglet Showpad d'AEM, vous aurez la possibilité d'appliquer certaines propriétés au niveau de la ressource.

Avec un fichier AEM ouvert, cliquez sur Propriétés et sélectionnez l'onglet Showpad.

Vous pouvez désormais sélectionner des propriétés spécifiques à Showpad dans la colonne des autorisations Showpad, qui peuvent être synchronisées avec vos ressources. Remarque : les tags ne seront synchronisés que s'ils sont ajoutés à une ressource.

Cliquez sur Enregistrer et fermer une fois que vous avez terminé.

Dashboard

Le tableau de bord AEM vous donnera un aperçu des actions se déroulant avec vos ressources.
À première vue, l'onglet Metrics affiche des statistiques sur le nombre total de fichiers actuellement synchronisés depuis AEM, la dernière synchronisation réussie et la dernière synchronisation échouée.
Le graphique ci-dessous montre combien d'actifs ont été créés, mis à jour et supprimés par la synchronisation dans une période donnée. Modifiez les plages de dates pour comparer les données et regrouper par mois, semaine, jour ou heure.

Dans l'onglet Événements, vous trouverez un aperçu des ressources synchronisées avec AEM avec des détails plus précis liés à la synchronisation, tels que le statut, l'opération, les horodatages, l'ID externe et la raison de l'échec. Vous pouvez rechercher une ressource spécifique, filtrer par plage de dates ou trier les résultats selon vos besoins. Vous pouvez également rechercher des événements échoués avec une raison particulière d'échec. Veuillez vérifier le menu déroulant pour voir tous les scénarios d'échec possibles qui pourraient survenir dans votre intégration.

Table de référence des propriétés

Voici une liste des champs d'intégration AEM prêts à l'emploi et leurs valeurs pour le mappage des attributs :