Weak reference
Une référence faible (weak reference) est une propriété (contenu) qui pointe vers un autre contenu du référentiel, comme l’image d’un article, la page vers laquelle renvoie un bouton ou le fichier joint à une fiche produit. Le contenu ne copie pas sa cible, il la désigne. Si la cible est supprimée, le lien ne mène plus nulle part.
Définition et fonctionnement
La réutilisation des contenus repose sur la référence plutôt que sur la copie. Une image mise à jour dans la médiathèque change partout où elle est référencée. Un bouton qui pointe vers une page continue de fonctionner si la page change de titre. Dans Content Editor, ces liens se renseignent au moyen de sélecteurs (image, fichier, page, contenu) plutôt que par une adresse tapée à la main.
Le terme vient de JCR (Java Content Repository), la norme de stockage sur laquelle repose le référentiel de Jahia (Content Repository). Une référence est dite "faible" parce qu’elle n’empêche pas la suppression de sa cible. La documentation Academy indique que le sélecteur affiche alors la mention "Content not found". Les développeurs déclarent ces propriétés dans la définition de type de contenu, par exemple avec le type weakreference limité aux fichiers.
Documentation Academy : personnaliser les sélecteurs de Content Editor
La référence faible et la référence de contenu : les différences
La référence faible est une propriété à l’intérieur d’un contenu. La référence de contenu (content reference) est un contenu à part entière, placé dans une page pour y faire apparaître un autre contenu.
| Notion | Ce qui la distingue |
|---|---|
| Référence de contenu | Un contenu d’un type particulier qui pointe vers un contenu source, à la manière d’un alias ou d’un lien symbolique. Il s’insère dans une page comme un composant. |
| Sélecteur (Content Editor) | Le sélecteur (image, fichier, page, contenu) est le champ qui sert à renseigner une référence faible. La référence est la valeur enregistrée, le sélecteur l’outil de saisie. |
| Propriété (contenu) | La référence faible est un type de propriété parmi d’autres, au même titre qu’un texte ou une date. |
La référence faible en pratique
Le visuel d’une campagne est utilisé sur des dizaines de pages et d’articles, chaque fois par une référence vers le même fichier de la médiathèque. Quand la marque livre une nouvelle version, l’équipe remplace le fichier une fois. Une fois le nouveau fichier publié, toutes les pages affichent la nouvelle image sans qu’on ait à les rouvrir.
Revers de la médaille, les contenus qui référencent un fichier ou une page perdent leur cible s’il est supprimé. Vérifiez donc où il est utilisé avant de le supprimer.
Questions fréquentes
Que se passe-t-il si le contenu visé par une référence est supprimé ?
Une référence faible n’empêche pas la suppression de sa cible. Une fois la cible supprimée, la référence ne mène plus nulle part et le sélecteur affiche "Content not found" dans Content Editor. Côté site, c’est la vue du contenu qui doit gérer ce cas proprement, par exemple en masquant l’image absente plutôt qu’en affichant une erreur.
Qui décide des contenus qu’une référence faible peut viser ?
Les développeurs, dans la définition du type de contenu. C’est là qu’une propriété est déclarée comme référence faible, avec au besoin une limite sur ce qu’elle peut viser, par exemple les seuls fichiers. Pour l’équipe éditoriale, c’est un sujet de cadrage. Il s’agit de décider quels champs pointent vers la médiathèque, lesquels vers des pages et lesquels doivent rester du texte libre.
Ressources sur ce terme
Pour aller plus loin
Développer une plateforme DXP avec la meilleure UX pour les utilisateurs métiers
Consulter la ressource