Personnaliser une entité

Introduction

Data Service contient des champs intégrés au système. Lorsque vous créez une nouvelle entité, un ensemble de champs par défaut est automatiquement créé. Vous pouvez néanmoins personnaliser les entités que vous avez définies en ajoutant des champs spécifiques.

Types de champ

Vous pouvez créer les champs des types de champs suivants.

Texte (Text) : ce champ peut être utilisé pour stocker une petite quantité de texte.
Nombre(Number) : ce champ peut être utilisé pour stocker une valeur numérique. Les valeurs numériques peuvent être positives ou négatives. Vous devez spécifier le nombre de décimales que vous souhaitez utiliser.
Oui/Non (Yes/No) : ce champ permet de choisir entre une valeur Ouiou Non .
Date-Heure (Date-Time): ce champ sert à stocker une valeur qui contient une date et une heure. Les sélecteurs de date peuvent être utilisés pour sélectionner une date et une heure.
Relation(Relationship) : ce champ permet de créer une relation entre deux entités.
Ensemble de choix (Choice Set) : ce champ permet de stocker une liste de valeurs énumérées à partir de laquelle une ou plusieurs valeurs peuvent être sélectionnées.
Fichier: ce champ permet de stocker un fichier.
Numérotation automatique (Auto-number) : ce champ permet d'augmenter automatiquement les index des enregistrements.

Remarque : Chaque type de champ nécessite différents détails qui doivent être spécifiés. Veuillez consulter la page spécifique sous Types de champs d' entité (Entity Field Types) pour en savoir plus.

Créer des champs

Pour ajouter des champs à vos données d'entité :

Dans la liste Entités (Entities), sélectionnez l'entité pour laquelle vous souhaitez ajouter un champ. L'onglet Champs (Fields) s'affiche avec la liste des champs définis pour l'entité.
Cliquez sur Créer un nouveau champ (Create New Field). L'assistant Créer un champ ( Create Field) s'ouvre.
Saisissez un Nom d' affichage (Display Name) pour le nouveau champ. Le nom d'affichage est le nom affiché lorsque vous importez l'entité dans Studio. Ce champ peut être modifié après la création de l'entité.
Saisissez un nom pour le nouveau champ. Le nom peut être alphanumérique, mais il doit commencer par une lettre. Il doit contenir entre 3 et 30 caractères.

Remarque :
Le champ Nom (Name) est automatiquement renseigné avec la même valeur que celle fournie pour le Nom d' affichage (Display Name). Vous ne pouvez modifier sa valeur que lors du processus de création de l'entité. Une fois l'entité créée, le champ Nom (Name) ne peut pas être modifié.
Sélectionnez le type de champ à l'aide de la liste déroulante.
Pour obliger les utilisateurs à fournir une valeur pour le champ, cochez la case Obligatoire (Required).
Pour appliquer des valeurs uniques aux enregistrements de champ, cochez la case Valeurs uniques uniquement .

Important :
L'option est disponible pour les types de champ Texte ( Text ) et Nombre (Number).

Si nécessaire, utilisez le nombre maximal de décimales configurées pour les nombres. Sinon, Data Service arrondit le nombre à la valeur maximale de décimales, provoquant un échec d'unicité. Par exemple, si vous définissez une précision de trois décimales et des valeurs d'entrée telles que 3.015 et 3.0148, cette dernière valeur est arrondie à 3.015, ce qui entraîne des échecs d'unicité.

L'option est insensible à la casse, ce qui signifie que "Unique Value" et "unique VALUE" sont identifiés comme des doublons.

Cliquez sur Plus de détails ( More details ) pour configurer les propriétés d'enregistrement de champ facultatives, telles que :

Option	Description
Longueur maximale	Pour les champs de texte , définissez le nombre maximum de caractères qu'un utilisateur peut fournir. Par défaut, 200 caractères maximum sont autorisés.
Valeur maximale	Pour les champs Nombre (Number), définissez la valeur maximale qu'un utilisateur peut fournir. La valeur maximale par défaut est `1,000,000,000,000`.
Valeur minimale	Pour les champs Nombre (Number), définissez la valeur minimale qu'un utilisateur peut fournir. La valeur maximale par défaut est `-1,000,000,000,000`.
Décimales	Pour les champs Nombre (Number), définissez le nombre de chiffres décimaux qu'un utilisateur peut fournir. La valeur par défaut est `2`, ce qui autorise les nombres avec deux chiffres après la virgule, tels que `23,45`.
Valeur par défaut	Définissez une valeur par défaut au cas où les utilisateurs ne fourniraient pas de données.
Description	Ajoutez une description pour le champ.
Accès au champ en fonction du rôle	Sélectionnez cette option pour restreindre l’accès aux données en accordant des autorisations explicites.

Facultativement, pour garder l'assistant Créer un champ (Create Field ) ouvert, cochez la case Créer un autre (Create another). Cela vous aide à créer plusieurs champs dans l'entité sélectionnée plus rapidement, car il ignore l'étape 2 de cette procédure.
Cliquez sur Enregistrer (Save).

Le nouveau champ s'affiche dans la liste Champs (Fields).

Mise à jour des champs

Pour mettre à jour les champs que vous avez créés, procédez comme suit :

Remarque :

Vous ne pouvez pas mettre à jour les champs intégrés au système.
Vous ne pouvez modifier ni le Nom ni le Type des champs personnalisés.

Dans l'onglet Champs (Fields), pointez le curseur de la souris sur le champ que vous souhaitez modifier.
Cliquez sur l'icône Modifier le champ (Edit Field) correspondant à l'élément. Celle-ci se trouve sur le côté droit.
Le panneau Modifier un champ (Edit Field) s'affiche. Appliquez les mises à jour.

Remarque :
Si le champ a été créé avec l'option Valeurs uniques uniquement (Unique values only ) activée, vous pouvez la désactiver, autorisant à nouveau les doublons. Sachez que si vous décochez la case Valeurs uniques uniquement (Unique values only ), vous ne pourrez pas la sélectionner à nouveau ultérieurement.
Cliquez sur Enregistrer (Save).

Supprimer des champs

Pour supprimer les champs que vous avez créés, suivez les étapes ci-dessous :

Remarque: Vous ne pouvez pas supprimer les champs intégrés au système.

Dans l'onglet Champs (Fields), pointez le curseur de la souris sur le champ que vous souhaitez supprimer.
Cliquez sur le menu Options supplémentaires ( More options ) à la fin de la ligne du champ, puis sélectionnez Supprimer ( Delete).
Pour activer le bouton Supprimer (Delete), entrez le nom d'affichage du champ dans la boîte de dialogue Supprimer le champ ( Delete Field) .
Cliquez sur Supprimer (Delete) pour confirmer votre action.

Activer ou désactiver l'accès aux champs en fonction du rôle

L'accès au champ en fonction du rôle (Role based field access) peut être utilisé pour restreindre l'accès aux données. Il est possible d'activer l'accès au champ en fonction du rôle (Role based field access) pour les champs personnalisés uniquement, mais pas pour les champs intégrés au système.

Une fois l'option d'accès au champ en fonction du rôle activée pour un champ, les rôles doivent être mis à jour afin d'accorder aux utilisateurs des autorisations explicites d'accès au champ. Voir Gérer l'accès pour plus d'informations.

Remarque : Les rôles standard n'auront plus accès aux données des champs activés dans le cadre de l'accès aux champs en fonction du rôle. Les utilisateurs qui ont besoin d'accéder à ces données devront se voir attribuer un rôle personnalisé qui accorde des autorisations d'accès aux données sur le terrain.

Dans l'onglet Champs (Fields), pointez le curseur de la souris sur le champ pour lequel vous souhaitez activer (ou désactiver) l'accès au champ en fonction du rôle.
Cliquez sur le menu Options supplémentaires ( More options ) à la fin de la ligne du champ, puis sélectionnez l'option Activer l'accès au champ en fonction du rôle ( Enable role based field access ) (ou l'option Désactiver l'accès au champ en fonction du rôle (Disable role based field access)) dans le menu.
Cliquez sur Activer (Enable) [ou Désactiver (Disable)] pour confirmer l'action.

Un message de confirmation s’affiche. Voir illustration ci-dessous.

Attention : Lorsque vous activez Accès au champ en fonction du rôle (Role base field access) pour un champ, tous les utilisateurs auxquels des rôles existants sont attribués et qui ne fournissent pas d'autorisations au niveau du champ n'auront plus accès aux données du champ.
Cliquez sur Gérer les rôles (Manage Roles) pour ouvrir l'onglet Rôles (Roles) de la page Gestion des utilisateurs (User Management). Ici, vous pouvez mettre à jour les rôles personnalisés pour accorder des autorisations relatives à l'accès au champ.