Aperçu
Un code de champ est un identifiant alphanumérique court pour les champs qui peuvent être utilisés dans les formules et l'API.
Utilisation des codes dans les formules
Lorsque vous utilisez l'éditeur de formules, vous pouvez voir la valeur du code des champs disponibles, ce qui permet d'identifier le champ à utiliser pour les formules respectives. Par conséquent, il est fortement recommandé de remplir le champ Code, en particulier lorsque vous travaillez avec l'API.
Par exemple, vous pouvez référencer des formulaires avec ou sans champs de code, la différence ressemblerait à ceci :
- Utilisation des champs de code :
CONCAT(Rightsholder.first_name, "-", middle_name, "-", Rightsholder.last_name)
- Sans champs de code :
CONCAT( clchw8tm7t8nb0ua.[First name], "-", [Middle name], "-", clchw8tm7t8nb0ua.[Last name])
Pour plus d'informations, consultez Utilisation de l'éditeur de formules.
Utilisation des codes dans l'API
L'attribution de codes de champ facilite également l'utilisation de l'API. Vous pouvez utiliser le code de champ, plutôt que l'ID de 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 pouvez ajouter un nouvel enregistrement au formulaire Rightsholder ci-dessus à l'aide de 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