Logo Docs
Logo Docs

Opérateur . (point)

Accède à une ou plusieurs valeurs d’une ligne de table de données en utilisant l’identifiant de la colonne

Utilisation

ligne_table_de_données.nom_colonne OU ligne_table_de_données.( **code** )

Paramètres

ligne_table_de_données

(Requis) La ligne de la table de données à partir de laquelle extraire une valeur
nom_colonne

(Requis) L’identifiant de la colonne dont vous souhaitez extraire la valeur. Ne mettez pas de guillemets autour de celui-ci.
**code**

(Requis) Ce code est exécuté avec un accès rapide à chaque colonne de la ligne en utilisant son identifiant préfixé d’un point (.). Voir “Plus d’information” pour plus d’information.

Exemples

Exemple Résultat

DT_LOOKUP(“employés”, “prénom”, “Anna”).email

“[email protected]”

DT_LOOKUP(“employés”, “prénom”, “Anna”).(CONCAT(.prénom, “ “, .nom_de_famille, “ (“, .email, “)”))

“Anna Logwatch ([email protected])”

DT_LOOKUP(“employés”, “prénom”, “Anna”).(.prénom & “ “ & .nom_de_famille & “ (“ & .email & “)”)

“Anna Logwatch ([email protected])”

Plus d'information

Pour obtenir une ligne de table de données :

  • Utilisez DT_CHOICES avec @PICK_ONE_QUESTION ou @PICK_MANY_QUESTION
  • Utilisez DT_LOOKUP

DT_CHOICES

Voici un exemple avec un DT_CHOICES et @PICK_ONE_QUESTION :

<# @PICK_ONE_QUESTION(responsable,
label: "Responsable",
choix: DT_CHOICES("employés", CONCAT(.prénom, " ", .nom_de_famille))) #>

Si vous avez des questions, contactez : <# UPPER(responsable.prénom) #> à <# responsable.email #>.

Cela fournira des choix basés sur la table de données employés. Les choix affichés dans le formulaire seront le “prénom nom_de_famille”, tel que “Anna Logwatch”. Cela nécessite que la table de données ait une colonne avec l’identifiant prénom et nom_de_famille.

Lors de la génération du document, la valeur de la variable responsable (définie par le @PICK_ONE_QUESTION ci-dessus) sera la ligne entière de la table de données. Le point (.) est ensuite utilisé pour accéder aux bonnes colonnes.

Pour le choix “Anna Logwatch”, voici le résultat :

Si vous avez des questions, contactez : Anna à [email protected] #>.

Utiliser plusieurs valeurs

Utiliser une parenthèse juste après le point (.) offre un moyen rapide d’accéder à plusieurs valeurs de la ligne. C’est particulièrement utile avec DT_LOOKUP, puisque sinon, l’utilisation de DT_LOOKUP devrait être répétée pour chaque valeur requise, mais fonctionne également lorsqu’une ligne est définie dans une variable à l’aide de DT_CHOICES. Voici une comparaison pour DT_LOOKUP :

Contactez Anna à <# DT_LOOKUP("employés", "prénom", "Anna").email #> ou à <# DT_LOOKUP("employés", "prénom", "Anna").numéro_de_téléphone #>.

Peut être remplacé par (n’oubliez pas de fermer la parenthèse) :

Contactez Anna à <# DT_LOOKUP("employés", "prénom", "Anna").(CONCAT(.email, " ou au ", .numéro_de_téléphone)) #>.

Comme vous pouvez le voir, les valeurs des colonnes de la ligne sont accessibles en utilisant l’identifiant de la colonne préfixé d’un point (.).

Les deux exemples donneraient comme résultat :

Contactez Anna à [email protected] ou au 1-800-555-5542.

Vous pouvez également utiliser des variables régulières comme dans toute fonction, sans le point :

<# DT_LOOKUP("employés", "prénom", "Anna").(CONCAT(.email, IF(afficher_numéro_de_téléphone, CONCAT(" ou au ", .numéro_de_téléphone))) #>.

Voir aussi