Utilisation du AEM Sidekick

​ ​ Le sidekick d’AEM fournit aux auteurs de contenu une barre d’outils offrant des options contextuelles afin qu’ils puissent modifier, prévisualiser et publier leur contenu directement à partir des pages de votre site web.

Ce document explique comment utiliser le sidekick.

Installation

Consultez le document Installation du AEM Sidekick pour savoir comment installer et configurer le sidekick.

Utiliser Sidekick

Le sidekick peut être appelé dans les contextes suivants :

Pour utiliser l’extension sidekick, accédez à une URL associée à votre projet. Il peut s’agir de l’une des options suivantes :

Vous pouvez basculer l’extension du sidekick en cliquant sur l’icône Adobe Experience Cloud située en regard de la barre d’adresse. Si vous utilisez le signet d’applet, cliquez sur celui-ci dans la barre d’outils de votre navigateur.

Ajout de projets

L’ajout de projets à la configuration du sidekick est facultatif dans la plupart des cas d’utilisation. Le sidekick peut détecter automatiquement si une URL est associée à votre projet. Si vous souhaitez que le sidekick reconnaisse également les domaines personnalisés, tels que le domaine de production de votre projet, vous devez conserver le projet dans votre configuration sidekick en cliquant sur l’icône + sur la droite.

Sélecteur d’environnement

^{Sélecteur d’environnement sur un sidekick dans les documents Google.}

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

Prévisualisation

Cette option permet d’accéder à l’environnement de prévisualisation, qui reflète les dernières modifications apportées à la page rendue à partir du document source. Vous pouvez également envoyer des URL d’aperçu aux parties prenantes afin qu’elles puissent consulter votre contenu avant qu’il ne soit publié. Notez que cette option n’est activée que si le contenu que vous regardez a été prévisualisé auparavant.

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

En direct

Cette option n’est disponible que s’il n’existe pas encore d’environnement de production. Il affiche le contenu publié et sert de support (et d’origine) pour l’environnement de production de votre projet. Notez que cette option n’est activée que si le contenu que vous regardez a déjà été publié.

L’URL active semble presque identique à l’URL d’aperçu, la seule différence se trouvant dans le domaine de premier niveau : https://main--repo--org.hlx.live/path

Production

Cette option vous permet d’accéder à l’environnement de production, qui est le site web public de votre projet. Notez que cette option peut ne pas être disponible pendant l’étape de développement de votre projet ou parce que le contenu n’a pas encore été publié.

Cet environnement peut être un réseau de diffusion de contenu tiers ou "amener votre propre". En fonction de la configuration du projet, le nouveau contenu ne peut apparaître qu’après un délai.

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

Actions

Il existe un certain nombre d’actions que vous pouvez effectuer sur votre contenu en utilisant facilement la barre d’outils du sidekick. Les actions qui n’ont pas été exécutées depuis la dernière modification du contenu sont signalées par un indicateur orange.

Prévisualisation

\ ^{L’action d’aperçu sur un sidekick dans les documents Google.}

Aperçu est l’action prédominante dans l’éditeur. Il (re) génère la page d’aperçu en fonction du document actif et l’ouvre dans un onglet distinct.

Modifier

La variable Modifier est disponible dans les trois environnements. Il ouvre l’éditeur en ligne du document source de la page active dans une fenêtre distincte.

^{Le sidekick dans un environnement de prévisualisation.}

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

Recharger

La variable Recharger est disponible uniquement dans l’environnement d’aperçu. Il peut être utilisé pour forcer l’actualisation du contenu, par exemple si l’éditeur et l’aperçu s’ouvrent côte à côte lors de l’utilisation du contenu. L’action est identique au Aperçu dans l’éditeur.

Publier

La variable Publier est disponible dans les trois environnements et rend la version d’aperçu actuelle de la page disponible dans les environnements en ligne et de production.

^{Le sidekick dans un environnement en ligne.}

Les visiteurs de votre site web destiné au public ne pourront pas afficher les modifications tant qu’ils ne seront pas publiés.

Actions en bloc

Ouvrez le sidekick dans Google Drive ou Microsoft SharePoint et sélectionnez un ou plusieurs fichiers à prévisualiser et publier en bloc, puis copiez facilement leurs URL. Vous pouvez également utiliser cette fonction pour prévisualiser et publier des médias tels que SVG ou PDF fichiers .

Adobe continue d’étendre la prise en charge des formats de fichiers qui peuvent être publiés directement à partir de votre source de contenu (SharePoint ou GDrive) en fonction des considérations d’utilisation et de sécurité les plus courantes. Actuellement, les formats pris en charge sont les suivants : PDF, SVG, JPG, PNG.

Les formats à envisager pour l’ajout sont les suivants : XML, MP4 ainsi que brutes DOCX, XLSX, PPTX sans transformation.

Limitation : dans Microsoft SharePoint, les sélections plus volumineuses (plus de 60) peuvent ne pas être entièrement exposées au sidekick et doivent donc être divisées en badges plus petits.

Aperçu en bloc

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

^{Aperçu en bloc dans Google Drive.}

Publication en bloc

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

^{Publication en bloc dans Google Drive.}

Copier les URL

Utilisez cette fonction pour copier les URL de prévisualisation, d’activation ou de production d’un ou de plusieurs fichiers.

Annulation de la publication de contenu

Si vous devez supprimer du contenu de votre site web, la première chose à faire est de supprimer, renommer ou déplacer le document source sous-jacent dans Google Docs ou OneDrive.

Pour une page sans document source (c’est-à-dire qu’elle a été renommée ou déplacée), le sidekick affiche les deux actions suivantes lorsqu’il est appelé dans l’environnement d’aperçu.

Remarque : Si vous êtes connecté au sidekick, vous pouvez ignorer la suppression du document source sous-jacent et simplement maintenir enfoncée la balise Alt (Windows) ou Option (Mac) pour afficher la Supprimer et Dépublier actions.

^{Le sidekick sur une page d’aperçu sans document source.}

Supprimer

La variable Supprimer Cette action supprime définitivement la page de tous les environnements, en la dépubliant implicitement.

Dépublier

Ceci Dépublier L’action annule la publication de la page, tout en la conservant dans l’environnement d’aperçu à des fins de référence.

Voir le document Création et publication de contenu pour plus d’informations sur la suppression de contenu.

Attention : les actions Supprimer et Annuler la publication ne peuvent pas être annulées. Vérifiez deux fois l’URL et le contenu de la page pour vous assurer qu’il est vraiment acceptable de supprimer et/ou d’annuler la publication d’une page. Le document source a peut-être été déplacé accidentellement et n’a pas besoin d’être supprimé.

Partage du Sidekick

Vous pouvez partager la configuration du sidekick pour votre projet en cliquant sur le symbole de partage en haut à droite. Cette opération copiera une URL de partage dans le presse-papiers et vous permettra de la coller dans un DM ou un courrier électronique à un collègue. L’URL de partage permettra au destinataire d’installer facilement le sidekick pour votre projet.

Voir le document Installation du AEM Sidekick pour plus d’informations.

Personnalisation du Sidekick

Si vous êtes un développeur, vous pouvez personnaliser le sidekick ; pour votre projet.

Bibliothèques tierces