Aperçu
Un Code de Champ est un identifiant alphanumérique court pour les Champs qui peut être utilisé dans les Formules et l'API.
Utiliser les codes dans les Formules
Lorsque vous utilisez l'Éditeur de formule, vous pouvez voir la Valeur du Code des Champs disponibles, ce qui aide à identifier quel Champ utiliser pour les Formules respectives. Par conséquent, il est fortement recommandé de remplir le Champ Code, surtout lorsque vous travaillez avec l'API.
Par exemple, vous pourriez référencer des Formulaires avec ou sans Champs Code, la différence ressemblerait à quelque chose comme ceci :
- En utilisant les Champs Code :
CONCAT(Rightsholder.first_name, "-", middle_name, "-", Rightsholder.last_name) - Sans les Champs Code :
CONCAT( clchw8tm7t8nb0ua.[First name], "-", [Middle name], "-", clchw8tm7t8nb0ua.[Last name])
Pour plus d'informations, consultez Utiliser l'Éditeur de formule.
Utiliser les codes dans l'API
L'attribution de Codes de Champ facilite également le travail avec l'API. Vous pouvez utiliser le Code du Champ, plutôt que l'ID du Champ, par exemple, lors de la soumission de mises à jour via le processus décrit dans l'article API de mise à jour des enregistrements.
Par exemple, vous pourriez ajouter un nouvel Enregistrement au Formulaire 'Rightsholder' ci-dessus en utilisant la ligne de commande suivante :
curl -X POST https://www.activityinfo.org/resources/update \
-u anything:APITOKEN \
-H 'Content-type: application/json' \
--data-binary @- << EOF
{
"changes": [
{
"formId": "cdznrnclh1x8y8s7",
"recordId": "ci8l8aqlh1x8y8s8",
"fields": {
"first_name": "Kofi",
"last_name": "Annan"
}
]
}
EOF