Référence

Imaginez que vous gérez une boutique de vêtements en ligne. Pour chaque produit, vous voulez noter de quelle marque il s'agit. Si la même marque « Daily Wear » compte des dizaines de produits, vous ressaisissez à l'identique, pour chaque produit, le nom de la marque, son logo et son texte de présentation. Si le texte de présentation de la marque change, vous devez corriger ces dizaines d'entrées une par une.

La référence supprime cette répétition. Vous créez les informations de la marque une seule fois, à part, et chaque produit n'a plus qu'à se relier à cette marque. Ne pas ressaisir la même information à chaque fois, mais relier une information située à un seul endroit pour la réutiliser : voilà ce qu'est la référence. Corrigez le texte de présentation de la marque une fois, et la correction se répercute d'un coup sur tous les produits reliés à cette marque.

Cette page traite de ce qu'est la référence qui relie un Content à un autre Content, de ce qui se produit lorsque vous reliez, et de la manière dont les Content se rattachent les uns aux autres.

La différence entre pointer et recopier

Il y a deux façons d'envisager le fait de noter les informations de la marque pour chaque produit.

La première, c'est de recopier. À chaque création de produit, vous écrivez directement dans ce produit le nom de la marque « Daily Wear » et son texte de présentation. Pour 100 produits, le même texte est inscrit en 100 exemplaires. Si la présentation de la marque change, vous devez retrouver et corriger les 100 exemplaires, et si vous en oubliez ne serait-ce qu'un seul, une présentation différente apparaîtra selon le produit.

La seconde, c'est de pointer. Vous créez la marque « Daily Wear » à part, sous la forme d'un seul Content, et chaque produit se contente de pointer vers ce Content de marque. L'information se trouve à un seul endroit, dans la marque. Lorsque vous corrigez le texte de présentation à cet unique endroit, tous les produits qui pointent vers cette marque suivent la même nouvelle présentation.

La référence, c'est ce « pointage ». Le Field qui contient le lien s'appelle Content Reference dans le studio de contenu. Si vous placez un Field Content Reference dans le Content Type du produit, vous choisissez et reliez le Content de marque depuis ce champ. Par analogie, au lieu de recopier à la main les informations de la marque pour chaque produit, vous tracez une seule flèche qui dit « la marque de ce produit, c'est ce Daily Wear là-bas ».

La forme du lien

Lorsque vous reliez un produit et une marque, vous obtenez la forme suivante. Plusieurs produits sont reliés à un même endroit, la marque.

Produit « Mug isotherme en inox 500 ml »   ──relié──▶
Produit « Mini mug isotherme 350 ml »       ──relié──▶   Marque « Daily Wear »
Produit « Gourde pliable portable 600 ml »  ──relié──▶

La marque « Daily Wear » n'est créée qu'une seule fois, et le mug isotherme comme la gourde sont tous reliés à cet unique endroit. Lorsque vous corrigez le texte de présentation de la marque une fois dans le Content Daily Wear, les trois produits ci-dessus suivent tous la nouvelle présentation.

Le lien peut se faire non seulement entre des Content, mais aussi depuis un Content vers un Media (un fichier déposé, comme une image ou une vidéo). Attacher une photo principale à un produit en est un exemple. Cette page traite du cas où des Content sont reliés entre eux. La façon d'attacher un Media est traitée dans Media.

Ce qui suit le lien

Si vous reliez une marque à un produit, vous pouvez récupérer en même temps les informations de la marque reliée lorsque vous récupérez les informations du produit. Lorsque vous affichez à l'écran un produit de type mug, le nom et le texte de présentation de la marque « Daily Wear » reliée à ce produit suivent en une seule fois. Bien que vous n'ayez pas recopié les informations de la marque du côté du produit, c'est parce que le lien est suivi pour lire les valeurs à un seul endroit, dans la marque.

Vous n'avez donc qu'à placer les informations de la marque à un seul endroit, dans le Content de marque. Chaque fois que vous lisez le produit, les informations de la marque à cet instant suivent le lien. Si vous corrigez la marque, le contenu corrigé suit lors de la lecture suivante du produit.

Le format détaillé, indiquant jusqu'où récupérer en même temps un Content relié et avec quelle requête le récupérer, est traité dans la Référence d'API. Dans le studio de contenu, il vous suffit de relier.

Définir les types pouvant être reliés

Sur un Field Content Reference, vous pouvez imposer la restriction « ce champ ne peut être relié qu'à certains Content ». Pour le champ de marque d'un produit, il serait gênant qu'un Content quelconque puisse y entrer. En effet, il ne faut pas qu'un avis ou une annonce soit relié par erreur à la place de la marque.

Vous pouvez donc faire en sorte que ce champ ne puisse être relié qu'à des Content créés à partir du Content Type « marque ». De cette manière, les choix possibles dans le champ de marque se limitent aux marques, et les autres types de Content ne s'y relient pas. Vous pouvez aussi autoriser ensemble plusieurs Content Type pouvant être reliés. Par exemple, vous pouvez autoriser à la fois « marque » et « partenaire » dans un même champ, pour que l'un ou l'autre puisse y être relié.

Cette restriction se définit dans les paramètres détaillés du Field Content Reference. Dans Validations, activez Accepter uniquement le Content Type spécifié et choisissez « marque » comme Content Type à autoriser.

Cette restriction est vérifiée lors de l'enregistrement ou de la publication. Si vous reliez un Content qui n'est pas d'un Content Type autorisé, l'enregistrement est bloqué, et si un Content que vous aviez relié a été supprimé entre-temps et reste introuvable, la vérification le détecte également. C'est un dispositif qui empêche l'accumulation de liens mal établis.

Relier plusieurs éléments dans un même champ

Il suffit souvent de ne relier qu'une seule marque à un produit. Mais il arrive aussi que vous vouliez relier plusieurs éléments dans un même champ. Par exemple, dans un champ « produits à voir avec celui-ci », vous voulez rattacher plusieurs produits connexes.

Dans ce cas, vous réglez le Field Content Reference sur Utiliser comme type de liste. Vous pouvez alors relier plusieurs Content dans un même champ. Cela revient à relier le mug, la gourde et la bouteille isotherme dans le champ « produits à voir avec celui-ci ». Même en mode liste, vous pouvez imposer de la même manière la restriction des types pouvant être reliés.

Créer dans « produit » un champ de lien vers la marque

Pour qu'un produit puisse se relier à une marque, ajoutez un Field de type Content Reference au Content Type « produit ». La façon d'ajouter un Field est traitée dans Modélisation de Content. Dans l'écran où vous choisissez le type de Field, choisissez Content Reference, puis définissez sur « marque » le « type pouvant être relié » vu plus haut.

Comme il faut une cible à relier pour pouvoir établir le lien, préparez d'abord le côté marque au préalable.

1. Créez le Content Type « marque ». Vous y placez des Field comme le nom de la marque et son texte de présentation.
2. Créez un Content de marque « Daily Wear » avec le Content Type « marque ».
3. Ajoutez un Field Content Reference au Content Type « produit » et définissez sur « marque » le type pouvant être relié.
4. Ouvrez le produit « Mug isotherme en inox 500 ml » et appuyez sur Modifier.
5. Appuyez sur Ajouter Content Existant dans le champ de marque. La fenêtre Sélectionner Content s'ouvre.
6. Choisissez « Daily Wear » dans la liste et reliez-le.

Dans la fenêtre Sélectionner Content, seule « marque », définie comme type pouvant être relié, apparaît. La restriction imposée précédemment s'applique ici telle quelle.

Le produit mug est maintenant relié à la marque « Daily Wear ». Si vous choisissez aussi « Daily Wear » dans le même champ pour d'autres produits, plusieurs produits se relient ensemble à une même marque.

Ce qu'il faut savoir en manipulant les liens

Si le Content relié disparaît, la vérification le détecte. Si vous supprimez le Content de marque qu'un produit avait relié, le champ de marque du produit se retrouve à relier un Content devenu introuvable. Dans cet état, le produit est bloqué à la vérification lors de l'enregistrement ou de la publication. Il suffit de relier une autre marque, ou, si ce champ n'est pas obligatoire, de le vider puis de réessayer.

Relier ne signifie pas que les deux Content fusionnent en un seul. Le produit et la marque restent des Content distincts. Même si vous supprimez le produit, le Content de marque demeure, et même si vous corrigez la marque, le Content du produit lui-même reste inchangé. Ce qui change, ce sont uniquement les valeurs lues en même temps en suivant le lien.

Que faire ensuite

• Modélisation de Content : traite de la façon d'ajouter un Field Content Reference au Content Type « produit ».
• Media : traite de la façon d'attacher à un produit un Media comme une photo principale.
• États et publication : traite de l'étape qui consiste à publier un Content relié pour le rendre public à l'extérieur.
• Référence d'API : à consulter lorsque vous manipulez directement par programme le format de requête pour récupérer en même temps un Content relié et la structure de l'élément Refer qui contient le lien.