Champ clé

Cet article a été traduit de l'anglais par IA et peut contenir des erreurs. Vos commentaires nous aideront à l'améliorer.

Aperçu

La propriété "Clé" d'un champ a de multiples objectifs, notamment l'étiquetage des enregistrements dans l'interface utilisateur, l'application de l'unicité des enregistrements lors de la saisie des données et l'aide aux utilisateurs pour rechercher les enregistrements liés lors de la saisie des données pour un champ de référence. Vous pouvez définir les champs clés dans les cartes de champ sous "Paramètres".

Comportement

Les champs clés dans ActivityInfo sont utilisés pour les fonctions suivantes :

  • Un moyen d'étiqueter les enregistrements dans l'interface utilisateur
  • Appliquer l'unicité des enregistrements lors de la saisie des données
  • Rechercher les enregistrements liés lors de la saisie des données
  • Faire correspondre les enregistrements liés lors de l'importation
  • Faire correspondre les enregistrements existants à mettre à jour lors de l'importation
  • Indiquer à quels champs les verrous basés sur la date s'appliquent

Étiquetage des enregistrements

Lors de la sélection ou de la suppression d'enregistrements, les enregistrements sont étiquetés dans l'interface utilisateur à l'aide des valeurs suivantes (énumérées par ordre de préférence du système) :

  1. Libellé d'enregistrement, s'il est défini dans le formulaire
  2. Concaténation des valeurs des champs clés, si des champs clés sont définis dans le formulaire
  3. Premier champ de texte défini dans le formulaire
  4. ID d'enregistrement, si aucun champ de texte n'est défini. Chaque enregistrement dans ActivityInfo se voit automatiquement attribuer un ID d'enregistrement unique, généré automatiquement, qui ne change jamais. L'ID d'enregistrement est utilisé pour stocker la relation entre deux enregistrements et est essentiel pour préserver l'intégrité référentielle, mais il n'est pas très convivial.

Les ID d'enregistrement sont normalement masqués à l'utilisateur, mais vous pouvez les afficher dans la vue Formulaire en cliquant sur "Sélectionner les colonnes", puis en cochant "ID d'enregistrement" :

Si aucun libellé d'enregistrement n'est défini, le champ clé est utilisé. Si aucun champ clé n'est spécifié, l'ID d'enregistrement est utilisé pour étiqueter l'enregistrement. Ce n'est probablement pas ce que vous voulez.

Ce que les utilisateurs voient lorsqu'aucun libellé d'enregistrement ou champ clé n'est défini
Ce que les utilisateurs voient lorsqu'aucun libellé d'enregistrement ou champ clé n'est défini

Pour une meilleure lisibilité, nous vous recommandons de Spécifier un libellé d'enregistrement.

Application de l'unicité

ActivityInfo ne permet pas d'ajouter des enregistrements avec le même champ clé.

S'il existe plusieurs champs clés, la combinaison des valeurs des champs clés doit être unique. Par exemple, si vous avez deux champs clés "Prénom" et "Nom", alors "John Smith" et "John Smith" sont considérés comme des doublons, mais "John Brown" et "John Smith" et "Bill Smith" sont des combinaisons différentes et peuvent tous être ajoutés au formulaire.

Si vous essayez d'ajouter un enregistrement avec la même combinaison de champs clés, un message d'erreur s'affiche :

La vérification des doublons nécessite l'accès aux enregistrements existants. Si deux utilisateurs travaillent hors ligne et sont déconnectés d'Internet, il est possible pour eux d'ajouter des enregistrements en double. Les deux copies des enregistrements sont synchronisées avec le serveur lorsque les utilisateurs se connectent.

Recherche d'enregistrements dans les champs de référence

Lorsque vous ajoutez un champ de référence à un autre formulaire, les champs clés sont utilisés par défaut pour afficher la liste des enregistrements parmi lesquels choisir.

Si vous désignez plusieurs champs comme champs clés, ActivityInfo fournit un ensemble de listes déroulantes en cascade.

Par défaut, les champs clés sont utilisés pour rechercher des valeurs dans un formulaire. Vous pouvez également sélectionner les champs que vous souhaitez inclure dans une recherche ou ajouter vos propres formules personnalisées.

Lors de la conception d'un formulaire, vous pouvez configurer les champs d'un formulaire de référence qui peuvent être utiles pour la recherche. Il peut s'agir ou non de champs clés, ou simplement d'un sous-ensemble de champs clés.

Section des champs de recherche.png
Section des champs de recherche.png

Pour plus d'informations sur les champs de recherche, consultez Champ de référence.

Étiquetage des valeurs de référence dans la vue Tableau

Lorsque vous visualisez un formulaire avec un champ de référence dans la vue Tableau, les valeurs des champs clés sont utilisées pour étiqueter l'enregistrement associé.

Champs clés et verrous de plage de dates

Lorsque vous ajoutez un verrou de plage de dates, il s'applique uniquement aux formulaires qui ont un champ de type date désigné comme champ clé. Ceci comprend :

  • Date
  • Mois
  • Semaine
  • Quinzaine

Dans de nombreux cas, vous pouvez souhaiter appliquer un verrou basé sur une date qui n'est pas un champ clé. Dans ce cas, vous devez plutôt utiliser un verrou basé sur des règles.

Champs clés optionnels

Le premier champ clé d'un formulaire est "Obligatoire" par défaut.

Cependant, les champs clés suivants peuvent être facultatifs. Cela peut être utile si un champ fait partie de l'identifiant unique d'un enregistrement, mais seulement une partie du temps.

Types de champs pris en charge

Les types de champs suivants peuvent être désignés comme champs clés :

  • Numéro de série
  • Quinzaine
  • Code barre
  • Date
  • Utilisateur
  • Référence
  • Mois
  • Texte
  • Semaine
  • Quinzaine
  • Sélection unique

Limites

Chaque formulaire peut avoir un maximum de 10 champs clés.

Un champ de numéro de série est toujours le seul champ clé. Un champ de numéro de série ne peut pas être combiné avec d'autres champs clés.

Exemple

Le tableau suivant fournit quelques exemples de formulaires et de choix courants pour les champs clés.

Formulaire Champ(s) clé(s) Remarques
Province Nom (Texte)
Territoire

Nom (Texte)

Province (Référence à la province)

Distribution d'articles non alimentaires

Date de distribution (Date)

Lieu (Référence au village)

À moins que votre programme ne prévoie d'effectuer plusieurs distributions au même endroit le même jour, ces deux champs sont de bonnes clés naturelles.
Bénéficiaire Adresse électronique (Texte) Un e-mail serait une bonne clé naturelle si votre assistance est fournie par voie numérique, car on peut s'attendre à ce que tous les bénéficiaires aient une adresse e-mail.
Bénéficiaire

Prénom (Texte)

Nom (Texte)

Date de naissance (Texte)

Dans de nombreux cas, vous aurez besoin d'une combinaison de champs clés pour identifier les bénéficiaires.
Activité

Type d'activité (Sélection unique)

Date de l'activité (Date)
Partenaire (Référence au partenaire)

Élément suivant
Champ Point géographique