Appels de l’éditeur universel calls
Découvrez les différents types d’appels effectués sur votre application par l’éditeur universel pour vous aider lors du débogage.
Vue d’ensemble overview
L’éditeur universel communique avec votre application instrumentée par le biais d’une série d’appels définis. Cette opération est transparente pour et n’a aucun effet sur l’expérience de l’utilisateur final.
Toutefois, pour le développeur, comprendre ces appels et ce qu’ils font peut s’avérer utile lors du débogage de votre application lors de l’utilisation de l’éditeur universel. Si vous avez instrumenté votre application et qu’elle ne se comporte pas comme prévu, il peut être utile d’ouvrir l’onglet Réseau des outils de développement de votre navigateur et d’examiner les appels lorsque vous modifiez le contenu de votre application.
- La payload de l’appel contient des détails sur ce qui est mis à jour par l’éditeur, y compris l’identification de ce qui doit être mis à jour et comment le mettre à jour.
- La réponse comprend des détails sur ce qui a été mis à jour exactement par le service d’éditeur. Cela facilite l’actualisation du contenu dans l’éditeur. Dans certains cas, comme lors d’un appel
move
, la page entière doit être actualisée.
Une fois l’appel terminé avec succès, les événements sont déclenchés et incluent la payload de la requête et de la réponse, qui peut être personnalisée pour votre propre application. Consultez le document Événements de l’éditeur universel pour plus d’informations.
Vous trouverez ci-dessous une liste des types d’appels que l’éditeur universel effectue à votre application avec des exemples de payloads et de réponses.
Mettre à jour update
Un appel update
se produit lorsque vous modifiez du contenu dans votre application à l’aide de l’éditeur universel. La update
conserve les modifications.
Sa payload comprend des détails sur les éléments à écrire dans le JCR.
resource
: chemin JCR à mettre à jourprop
: propriété JCR en cours de mise à jourtype
: type de valeur JCR de la propriété mise à jourvalue
: les données mises à jour
code language-json |
---|
|
code language-json |
---|
|
Détails details
Un appel details
se produit lors du chargement de votre application dans l’éditeur universel pour récupérer le contenu de l’application.
Sa payload inclut les données à rendre, ainsi que des détails sur ce que les données représentent (le schéma) afin qu’elles puissent être rendues dans l’éditeur universel.
- Pour un composant, l’éditeur universel récupère uniquement un objet
data
, puisque le schéma des données est défini dans l’application. - Pour les fragments de contenu, l’éditeur universel récupère également un objet
schema
, car le modèle de fragment de contenu est défini dans le JCR.
code language-json |
---|
|
code language-json |
---|
|
Ajouter add
Un appel add
se produit lorsque vous placez un nouveau composant dans votre application à l’aide de l’éditeur universel.
Sa payload comprend un objet path
contenant l’emplacement où le contenu doit être ajouté.
Elle comprend également un objet content
avec des objets supplémentaires pour les détails spécifiques aux points d’entrée du contenu à stocker pour chaque module externe. Par exemple, si votre application est basée sur le contenu d’AEM et de Magento, la payload contient un objet de données pour chaque système.
code language-json |
---|
|
code language-json |
---|
|
Déplacer move
Un appel move
se produit lorsque vous déplacez un composant dans votre application à l’aide de l’éditeur universel.
Sa payload comprend un objet from
définissant l’emplacement du composant et un objet to
définissant l’emplacement où il a été déplacé.
code language-json |
---|
|
code language-json |
---|
|
Supprimez remove
Un appel remove
se produit lorsque vous supprimez un composant dans votre application à l’aide de l’éditeur universel.
Sa payload inclut le chemin d’accès de l’objet supprimé.
code language-json |
---|
|
code language-json |
---|
|
Publication publish
Un appel publish
se produit lorsque vous cliquez sur le bouton Publish dans l’éditeur universel pour publier le contenu que vous avez modifié.
L’éditeur universel effectue une itération sur le contenu et génère une liste de références qui doivent également être publiées.
code language-json |
---|
|
code language-json |
---|
|