Utiliser le sidekick AEM

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Edge Delivery Services

AEM Sidekick met à la disposition des auteurs de contenu une barre d’outils offrant des options contextuelles afin que vous puissiez modifier, prévisualiser et publier votre contenu directement à partir des pages de votre site web.

Installation

AEM Sidekick est disponible pour les navigateurs Chrome (qui incluent Microsoft Edge). Vous pouvez l’installer à partir de la boutique en ligne Chrome.

Première utilisation du Sidekick

Une fois installé, le Sidekick s’affiche sous la forme d’une barre d’outils survolant la partie inférieure de votre contenu dans le navigateur. Si elle ne s’affiche pas, cliquez sur l’icône Sidekick dans la barre d’outils du navigateur. Le Sidekick vous fournit divers outils et actions pour parcourir et publier votre contenu.

Si l’authentification pour les auteurs est activée pour votre site, vous devez d’abord cliquer sur Se connecter pour vous authentifier avant de pouvoir utiliser Sidekick.

Il n’est pas nécessaire de se connecter pour utiliser Sidekick afin de basculer entre les environnements et prévisualiser ou publier du contenu. Cependant, pour dépublier et supprimer des pages, vous devez vous connecter.

Ajout de votre projet

Le Sidekick peut détecter automatiquement si une URL appartient à votre projet. Si vous souhaitez que le Sidekick reconnaisse également les domaines personnalisés, tels que le domaine de production de votre projet, le domaine d’aperçu personnalisé ou le domaine dynamique personnalisé, vous devez ajouter le projet au Sidekick.

Pour ce faire, deux méthodes sont possibles :

À partir de vos documents sources

Accédez à n’importe quel document source associé à votre projet. Cliquez ensuite sur le menu contextuel (≡) dans le Sidekick et sélectionnez Ajouter ce projet.

À partir de l’URL du projet

Accédez à l’URL d’un projet (similaire à https://main--repo--owner.aem.page/), cliquez sur le menu contextuel (≡) dans le Sidekick, puis sélectionnez Ajouter ce projet.

Suppression de projets et migration

Vous pouvez supprimer des projets du Sidekick en suivant les mêmes étapes, mais en sélectionnant Supprimer ce projet dans le menu contextuel.

Si vous avez utilisé une version précédente du Sidekick, vous pouvez migrer vos projets configurés précédemment.

Activez la version précédente et la nouvelle version du Sidekick dans votre navigateur.
Cliquez avec le bouton droit sur l’icône du plug-in Sidekick dans la barre de menus de votre navigateur.
Sélectionnez Importer des projets depuis AEM Sidekick v6 dans le menu contextuel.

Utiliser le sidekick

Le Sidekick peut être appelé dans les cas suivants :

Dans les environnements de projet
Dans les éditeurs en ligne (selon la configuration de votre projet)
- Google Docs/Sheets
- Microsoft Word/Excel

Pour utiliser l’extension Sidekick, accédez à une URL associée à votre projet. Il peut s’agir de l’un des éléments suivants :

Un document Microsoft SharePoint ou Google (bureau uniquement)
Une URL de prévisualisation (le nom de domaine se terminant par .aem.page)
Une URL dynamique (le nom de domaine se terminant par .aem.live)
Une URL de production (le nom de domaine étant le nom d’hôte public de votre projet), une URL d’aperçu personnalisée ou une URL dynamique personnalisée
- Remarque : cela nécessite l’ajout du projet à votre configuration

Vous pouvez activer/désactiver l’extension Sidekick en cliquant sur l’icône Adobe Experience Cloud située en regard de la barre d’adresse de votre navigateur.

Mode Source

Lors de l’utilisation de la création basée sur des documents pour créer du contenu, le contenu passe de l’éditeur à travers différents environnements. Le sélecteur d’environnement vous permet de passer facilement d’un environnement à l’autre.

Lors de la modification de votre document et de la première utilisation du Sidekick, vous passez par défaut en mode Source. Cliquez sur le bouton Source pour afficher les environnements supplémentaires disponibles.

^{Sélecteur d’environnement sur un Sidekick dans Google Docs.}

En mode Source, l'action suivante est disponible.

Aperçu (re)génère la page d'aperçu à partir du document actif et l'ouvre dans un onglet séparé.

Mode Aperçu

L’environnement de prévisualisation reflète les dernières modifications de la page rendue à partir du document source. Les environnements de prévisualisation sont indiqués par un libellé bleu. Vous pouvez envoyer des URL d’aperçu aux parties prenantes afin qu’elles puissent réviser votre contenu avant sa publication. Notez que cette option n’est activée que si le contenu que vous consultez a déjà été prévisualisé.

L’URL d’aperçu suit le modèle https://branch--site--org.aem.page/path.

branch, site et org identifiez la source de contenu et la base de code à utiliser
/path correspond à l’emplacement du contenu dans Google Drive ou Microsoft SharePoint, à partir du dossier racine.
Un / à la fin d’un chemin d’accès fait référence au document d’index dans un dossier.

En mode Aperçu , les actions suivantes sont disponibles :

Modifier permet d’ouvrir la source de contenu pour la modifier.
Mise à jour est utilisé pour forcer une actualisation du contenu.
- Par exemple, si vous avez Source et Preview ouverts dans des onglets côte à côte lors de l’utilisation du contenu.
- L’effet est identique à l’action Aperçu dans l’éditeur.
La fonction Publier rend la version d’aperçu actuelle de la page disponible dans les environnements en ligne et de production.
- Les visiteurs et visiteuses de votre site web public ne pourront pas voir les modifications tant qu’elles ne seront pas publiées.

Mode réel

Le mode réel n’est disponible que s’il n’existe pas encore d’environnement de production. Il affiche le contenu publié et sert de remplacement à l’environnement de production de votre projet. Les environnements en ligne sont indiqués par un libellé vert. Notez que cette option n’est activée que si le contenu que vous consultez a déjà été publié.

L’URL active semble presque identique à l’URL de prévisualisation, la seule différence se trouvant dans le domaine de premier niveau : https://main--site--org.aem.live/path

En mode réel, les actions disponibles sont les suivantes :

Modifier permet d’ouvrir la source de contenu pour la modifier.
La fonction Publier rend la version d’aperçu actuelle de la page disponible dans les environnements en ligne et de production.
- Les visiteurs et visiteuses de votre site web public ne pourront pas voir les modifications tant qu’elles ne seront pas publiées.

Mode de production

Le mode Production vous mène à l’environnement de production, qui est le site web public de votre projet. Les environnements de production sont indiqués par un libellé vert.

Cette option peut ne pas être disponible pendant l’étape de développement de votre projet ou parce qu’aucun environnement de production n’a encore été configuré.
Cet environnement peut être un réseau CDN tiers ou « apportez votre propre » réseau CDN.

Si votre nom de domaine public est yourproject.com, l’URL de production est https://yourproject.com/path

L’action suivante est disponible en mode Production :

La fonction Publier rend la version d’aperçu actuelle de la page disponible dans les environnements en ligne et de production.
- Les visiteurs et visiteuses de votre site web public ne pourront pas voir les modifications tant qu’elles ne seront pas publiées.

Source

Si vous utilisez le Sidekick dans les environnements d’aperçu, de production ou en ligne, le sélecteur de sources propose également une option Ouvrir dans, qui permet d’ouvrir l’éditeur en ligne de la source de la page active (un document ou l’éditeur AEM) dans une fenêtre distincte.

Pour utiliser cette action, vous devez disposer d’un accès en lecture minimum au document dans Google Drive ou Microsoft SharePoint.

Actions en bloc

Ouvrez le Sidekick dans Google Drive ou Microsoft SharePoint et sélectionnez un ou plusieurs fichiers pour prévisualiser et publier en masse les fichiers et copier facilement leurs URL. Le Sidekick compte le nombre de fichiers sélectionnés et vous invite à confirmer toutes les actions en masse.

Le Sidekick fournit un état des actions en masse en cours.

Une fois les actions en masse terminées avec succès, le Sidekick devient vert et vous permet de copier les URL des fichiers concernés via le bouton Copier x URL ou de les prévisualiser via le bouton Ouvrir x URL.

Si une action en masse échoue, elle devient rouge et fournit des commentaires sur l’échec via le bouton Détails.

Vous pouvez également utiliser la fonction d’action en masse pour prévisualiser et publier des fichiers multimédias. Adobe continue d’étendre la prise en charge des formats de fichiers qui peuvent être publiés directement à partir de votre source de contenu (Microsoft SharePoint ou Google Drive) en fonction de considérations d’utilisation et de sécurité courantes. Actuellement, les formats pris en charge sont MP4, PDF, SVG, JPG et PNG. Pour en savoir plus sur les limites de taille de fichier , cliquez ici.

Limitation : dans Microsoft SharePoint, il se peut que des sélections volumineuses de plus de 60 fichiers ne soient pas disponibles pour Sidekick et doivent donc être divisées en badges plus petits.

Aperçu en bloc

La sélection de plusieurs documents dans Microsoft SharePoint ou GDrive vous permet de prévisualiser plusieurs documents en masse.

Publier en masse

La sélection de plusieurs documents dans Microsoft SharePoint ou GDrive vous permet de publier plusieurs documents en masse. Le Sidekick vous invite à confirmer avant d’effectuer des actions en bloc.

Copier les URL

Utilisez cette fonctionnalité pour copier les URL d’aperçu, de production ou en direct d’un ou de plusieurs fichiers.

Dépublication et suppression de contenu

Si vous n’avez plus besoin que le contenu soit publié, vous pouvez le dépublier et/ou le supprimer.

La dépublication du contenu supprimera la page de vos environnements d’exploitation et actifs, mais la conservera dans l’environnement d’aperçu pour référence ou republication ultérieure.
La suppression supprime définitivement le contenu de tous les environnements et dépublie implicitement ce contenu.

La dépublication et la suppression du contenu nécessitent que vous soyez connecté au Sidekick. Vous devez également affecter les rôles appropriés à votre utilisateur.

Pour dépublier, vous devez disposer du rôle publish.
Pour supprimer, vous devez avoir le rôle de publication ou author.

Étant donné que la dépublication et la suppression ne sont pas aussi courantes que la prévisualisation et la publication de contenu, ces options sont conservées derrière un menu représentant des points de suspension, affiché uniquement lorsque cela est approprié. Accédez à une page publiée ou à son aperçu, puis cliquez sur le bouton représentant des points de suspension dans le Sidekick pour afficher l’option Dépublier.

Vous pouvez uniquement supprimer des pages de l’environnement de prévisualisation. La suppression dépublie implicitement la page si elle a déjà été publiée.

Attention : les actions Supprimer et Dépublier ne peuvent pas être annulées. Vérifiez à nouveau l’URL et le contenu de la page pour vous assurer que la suppression et/ou la dépublication d’une page sont autorisées.

En raison du caractère définitif de la suppression des pages, vous devez confirmer la suppression en saisissant DELETE dans une boîte de dialogue.