Définition des champs XDM dans l’interface utilisateur

L’ Schema Editor de l’interface utilisateur de Adobe Experience Platform vous permet de définir vos propres champs dans les classes XDM (Experience Data Model) personnalisées et les groupes de champs de schéma. 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 compréhension pratique du système XDM. Reportez-vous à la présentation XDM pour une présentation du rôle de XDM dans l’écosystème Experience Platform et aux principes de base de la composition des schémas pour apprendre comment les classes et les groupes de champs contribuent aux champs des 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 différentes fonctionnalités de Schema Editor.

Sélectionner une ressource à laquelle ajouter des champs select-resource

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

Une fois que vous avez ouvert l’élément Schema Editor, les commandes permettant d’ajouter des champs s’affichent dans la zone de travail. Ces commandes s’affichent en regard du nom du schéma, ainsi que des champs de type objet qui ont été définis sous la classe ou le groupe de champs sélectionné.

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

Selon que vous ajoutez directement un champ à un schéma ou à sa classe constituante et à ses groupes de champs, les étapes requises pour ajouter le champ varient. Le reste de ce document se concentre sur la configuration des propriétés d’un champ, quel que soit l’endroit où ce champ apparaît dans le schéma. Pour plus d’informations sur les différentes manières d’ajouter des champs à un schéma, reportez-vous aux sections suivantes du guide de l’interface utilisateur des schémas :

Définition des propriétés d’un champ define

Après avoir sélectionné l’icône plus (+) , un espace réservé Champ sans titre s’affiche dans la zone de travail.

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

Vous pouvez également choisir de fournir une description et des notes pour chaque champ. Utilisez le champ Description pour ajouter du contexte et décrire la fonctionnalité du type de données de carte. Cela contribue à la maintenabilité et à la lisibilité de la mise en oeuvre. Vous pouvez également ajouter des notes pour compléter la description initiale. Cela devrait offrir des informations plus granulaires et spécifiques pour aider les développeurs à comprendre, gérer et utiliser efficacement la carte dans le contexte du code base. |

Une fois que vous avez terminé de configurer le champ, sélectionnez Apply.

Le canevas se met à jour pour afficher le champ nouvellement ajouté, situé dans un espace de noms d’objet associé à votre identifiant de tenant unique (illustré par _tenantId dans l’exemple ci-dessous). Tous les champs personnalisés ajoutés à un schéma sont automatiquement placés dans cet espace de noms afin d’éviter tout conflit avec d’autres champs provenant de classes et de groupes de champs fournis par l’Adobe. Le rail de droite répertorie 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 groupes de champs sont également enregistrés si des modifications leur ont été apportées.

Propriétés de champ spécifiques à un type type-specific-properties

Lors de la définition d’un nouveau champ, d’autres options de configuration peuvent s’afficher dans le rail de droite en fonction du type que vous avez choisi pour le champ. Le tableau suivant décrit ces propriétés de champ supplémentaires, ainsi que leurs types compatibles :

Propriété du champ

Types compatibles

Description

Type de valeur de carte

Carte

La propriété Type de valeur de carte apparaît uniquement dans l’interface utilisateur si vous sélectionnez la valeur de carte dans les options de liste déroulante Type. Vous pouvez choisir entre les types de valeurs Chaîne et Entier pour la carte.
{width="100" modal="regular"}
Remarque : tous les types de données de mappage créés par le biais de l’API qui ne sont pas de type Chaîne ou Entier sont affichés sous la forme d’un type de données 'Complex'. Vous ne pouvez pas créer de types de données 'Complex' via l’interface utilisateur.

Modèle

Chaîne

Une expression régulière à laquelle la valeur de ce champ doit être conforme pour être acceptée lors de l’ingestion.

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 :

• date-time
• email
• hostname
• ipv4
• ipv6
• uri
• uri-reference
• url-template
• json-pointer

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’ingestion.

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’ingestion.

Valeur minimale

Double

Valeur minimale à accepter lors de l’ingestion. Si la valeur ingérée correspond exactement à celle saisie ici, la valeur est acceptée. Lors de l’utilisation de cette contrainte, la contrainte "Valeur minimale exclusive" doit être laissée vide.

Valeur maximale

Double

Valeur maximale que la Double doit être acceptée lors de l’ingestion. Si la valeur ingérée correspond exactement à celle saisie ici, la valeur est acceptée. Lors de l’utilisation de cette contrainte, la contrainte "Valeur maximale exclusive" doit être laissée vide.

Valeur minimale exclusive

Double

Valeur maximale que la Double doit être acceptée lors de l’ingestion. Si la valeur ingérée correspond exactement à celle saisie ici, la valeur est rejetée. Lors de l’utilisation de cette contrainte, la contrainte "Minimum value" (non exclusive) doit être laissée vide.

Valeur maximale exclusive

Double

Valeur maximale que la Double doit être acceptée lors de l’ingestion. Si la valeur ingérée correspond exactement à celle saisie ici, la valeur est rejetée. Lors de l’utilisation de cette contrainte, la contrainte "Maximum value" (non exclusive) doit être laissée vide.

Types de champ spéciaux special

Le rail de droite comporte plusieurs cases à cocher pour la désignation des 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 Platform 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 des champs de type objet pour en savoir plus sur la définition de sous-champs imbriqués dans vos structures de schéma.

Étapes suivantes

Ce guide fournit un aperçu de la définition des champs XDM dans l’interface utilisateur. N’oubliez pas que les champs ne peuvent être ajoutés qu’aux schémas par l’utilisation de classes et de groupes de champs. Pour en savoir plus sur la gestion de ces ressources dans l’interface utilisateur, consultez les guides sur la création et la modification des classes et des groupes de champs.

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