Définition des champs XDM dans l’interface utilisateur

Le Schema Editor de l’interface utilisateur Adobe Experience Platform vous permet de définir vos propres champs dans les classes et mixins de modèle de données d’expérience personnalisés (XDM). Ce guide décrit les étapes de définition des champs XDM dans l’interface utilisateur, y compris les options de configuration disponibles pour chaque type de champ.

Conditions préalables

Ce guide nécessite une bonne compréhension de XDM System. Pour une présentation du rôle de XDM dans l'écosystème Experience Platform, voir Présentation de XDM et les bases de la composition du schéma pour savoir comment les classes et les mixins contribuent aux schémas XDM.

Bien que ce guide ne soit pas obligatoire, il est recommandé de suivre également le tutoriel sur la composition d'un schéma dans l'interface utilisateur pour vous familiariser avec les diverses fonctionnalités du Schema Editor.

Sélectionnez une ressource à laquelle ajouter des champs à

Pour définir de nouveaux champs XDM dans l'interface utilisateur, vous devez d'abord ouvrir un schéma dans Schema Editor. Selon les schémas actuellement disponibles dans Schema Library, vous pouvez choisir de créer un nouveau schéma ou sélectionner un schéma existant à modifier.

Une fois que Schema Editor est ouvert, utilisez le rail de gauche pour sélectionner la classe ou le mixin pour lequel vous souhaitez définir des champs. Si la ressource est une ressource personnalisée définie par votre organisation, les contrôles permettant d’ajouter ou de modifier des champs s’affichent dans la trame. Ces commandes s’affichent en regard du nom du schéma, ainsi que des champs de type objet définis sous la classe ou le mixin sélectionnés.

REMARQUE

Si la classe ou le mixin que vous sélectionnez est une ressource principale fournie par Adobe, il ne peut pas être modifié et les commandes affichées ci-dessus ne s'affichent donc pas. Si le schéma auquel vous souhaitez ajouter des champs est basé sur une classe XDM de base et ne contient aucun mixin personnalisé, vous pouvez créer un mixin à ajouter au schéma.

Pour ajouter un nouveau champ à la ressource, sélectionnez l'icône plus (+) en regard du nom du schéma dans le canevas ou en regard du champ de type d'objet sous lequel vous souhaitez définir le champ.

Définir un champ pour une ressource

Après avoir sélectionné l'icône plus (+), un nouveau champ apparaît dans le canevas, situé dans un objet de niveau racine qui porte l'espace de noms de votre ID de client unique (comme _tenantId dans l'exemple ci-dessous). Tous les champs ajoutés à un schéma par le biais de classes personnalisées et de mixins sont automatiquement placés dans cet espace de nommage afin d’éviter les conflits avec d’autres champs à partir des classes et mixins fournis par l’Adobe.

Dans le rail de droite sous Propriétés de champ, vous pouvez configurer les détails des nouveaux champs. Les informations suivantes sont requises pour chaque champ :

Propriété de champ Description
Nom du champ Nom unique et descriptif du champ. Notez que le nom du champ ne peut pas être modifié une fois le schéma enregistré.

Le nom devrait idéalement être écrit en cave à chameau. Il peut contenir des caractères alphanumériques, des tirets ou des traits de soulignement, mais ne peut pas début avec un trait de soulignement.
  • Correct : fieldName
  • Acceptable: field_name2, Field-Name, field-name_3
  • Incorrect : _fieldName
Nom d’affichage Nom convivial du champ.
Type Type de données que le champ contiendra. Dans ce menu déroulant, vous pouvez sélectionner l'un des types scalaires standard pris en charge par XDM, ou l'un des types de données à champs multiples qui ont été précédemment définis dans Schema Registry.

Vous pouvez également sélectionner Recherche de type avancé pour rechercher et filtrer les types de données existants et identifier plus facilement le type souhaité.

Vous pouvez également fournir au champ une Description lisible par l'utilisateur afin de fournir un contexte plus précis quant au cas d'utilisation prévu pour le champ.

REMARQUE

Selon le type que vous avez sélectionné pour le champ, d'autres contrôles de configuration peuvent apparaître dans le rail de droite. Pour plus d’informations sur ces contrôles, voir la section propriétés de champ spécifiques au type.

Le rail droit fournit également des cases à cocher pour la désignation de types de champs spéciaux. Pour plus d'informations, consultez la section sur les types de champs spéciaux.

Une fois le champ configuré, sélectionnez Appliquer.

Le canevas se met à jour pour afficher le nom et le type du champ. Le rail droit liste désormais le chemin d’accès du champ en plus de ses autres propriétés.

Vous pouvez continuer à suivre les étapes ci-dessus pour ajouter d’autres champs au schéma. Une fois le schéma enregistré, sa classe de base et ses mixins sont également enregistrés si des modifications ont été apportées.

REMARQUE

Toute modification apportée aux mixins ou à la classe d'un schéma sera répercutée dans tous les autres schémas qui les utilisent.

Propriétés de champ spécifiques au type

Lors de la définition d’un nouveau champ, d’autres options de configuration peuvent s’afficher dans le rail de droite selon le Type que vous avez choisi pour le champ. Le tableau suivant présente les propriétés de champs supplémentaires ainsi que leurs types compatibles :

Propriété de champ Types compatibles Description
Valeur par défaut Chaîne, Doublon, Long, Entier, Short, , Octet, Booléen][ Valeur par défaut qui sera affectée à ce champ si aucune autre valeur n’est fournie lors de l’assimilation. Cette valeur doit être conforme au type sélectionné dans le champ.
Modèle Chaîne Expression régulière à laquelle la valeur de ce champ doit se conformer pour être acceptée lors de l'assimilation.
Format Chaîne Effectuez une sélection dans une liste de formats prédéfinis pour les chaînes auxquelles la valeur doit se conformer. Les formats disponibles sont les suivants :
Longueur minimale Chaîne Nombre minimum de caractères que doit contenir la chaîne pour que la valeur soit acceptée lors de l’assimilation.
Longueur maximale Chaîne Nombre maximal de caractères que doit contenir la chaîne pour que la valeur soit acceptée lors de l’assimilation.
Valeur minimale Double Valeur minimale pour que le Doublon soit accepté lors de l'assimilation. Si la valeur assimilée correspond exactement à celle saisie ici, la valeur est acceptée. Lors de l'utilisation de cette contrainte, la contrainte "Valeur minimale exclusive" doit rester vide.
Valeur maximale Doublon Valeur maximale pour le Doublon à accepter lors de l’assimilation. Si la valeur assimilée correspond exactement à celle saisie ici, la valeur est acceptée. Lors de l'utilisation de cette contrainte, la contrainte "Valeur maximale exclusive" doit rester vide.
Valeur minimale exclusive Doublon Valeur maximale pour le Doublon à accepter lors de l’assimilation. Si la valeur assimilée correspond exactement à celle saisie ici, elle est rejetée. Lors de l'utilisation de cette contrainte, la contrainte "Valeur minimale" (non exclusive) doit rester vide.
Valeur maximale exclusive Doublon Valeur maximale pour le Doublon à accepter lors de l’assimilation. Si la valeur assimilée correspond exactement à celle saisie ici, elle est rejetée. Lors de l'utilisation de cette contrainte, la contrainte "Valeur maximale" (non exclusive) doit rester vide.

Types de champ spéciaux

Le rail droit fournit plusieurs cases à cocher pour la désignation de rôles spéciaux pour le champ sélectionné. Les cas d’utilisation de certaines de ces options impliquent des considérations importantes concernant votre stratégie de modélisation des données et la manière dont vous envisagez d’utiliser les services de plateforme en aval.

Pour en savoir plus sur ces types spéciaux, consultez la documentation suivante :

Bien que techniquement non un type de champ spécial, il est également recommandé de consulter le guide sur la définition de champs de type objet pour en savoir plus sur la définition de sous-champs imbriqués si votre schéma se structure.

Étapes suivantes

Ce guide fournit un aperçu de la manière de définir les champs XDM dans l’interface utilisateur. Rappelez-vous que les champs ne peuvent être ajoutés aux schémas qu'à l'aide de classes et de mixins. Pour en savoir plus sur la gestion de ces ressources dans l’interface utilisateur, consultez les guides sur la création et la modification de classes et mixins.

Pour plus d'informations sur les fonctionnalités de l'espace de travail Schémas, consultez la présentation de l'espace de travail Schémas.

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free