Partager via

Fonction LISTOFFIELDS ER

  • Article

La fonction LISTOFFIELDS renvoie une valeur Liste des enregistrements créée en fonction de la structure de l’argument spécifié du type Énumération ou Conteneur (enregistrement).

Syntaxe 1

LISTOFFIELDS (path)

Syntaxe 2

LISTOFFIELDS (path, language)

Arguments

path : Référence de source de données

Chemin d’accès de référence valide d’une source de données de l’un des types de données suivants :

  • Énumération du modèle
  • Énumération de format
  • Énumération des applications
  • Conteneur (enregistrement)

language : Chaîne

Texte qui représente un code de langue.

Valeurs de retour

Liste d’enregistrements

Liste des enregistrements résultante.

Notes d’utilisation

La liste créée comprend des enregistrements avec les champs suivants :

  • Nom (type de données Chaîne)
  • Étiquette (type de données Chaîne)
  • Description (type de données Chaîne)
  • IsTranslated (type de données Booléen)

Si l’argument path fait référence à une source de données de type Conteneur (enregistrement), pour chaque champ de l’enregistrement de conteneur référencé, un nouvel enregistrement est ajouté à la liste qui est créée. Pour chaque enregistrement créé, le champ Nom renvoie le nom du champ de l’enregistrement de conteneur référencé pour lequel l’enregistrement en cours a été créé.

Si l’argument path fait référence à une source de données de l’un des types Énumération, pour chaque valeur d’énumération de l’énumération référencée, un nouvel enregistrement est ajouté à la liste qui est créée. Pour chaque enregistrement créé, le champ Nom renvoie la valeur de l’énumération référencée pour laquelle l’enregistrement en cours a été créé, le champ Description renvoie la description de cette énumération et le champ Étiquette renvoie l’étiquette de cette énumération.

Au moment de l’exécution, lorsque la syntaxe 1 est utilisée, les champs Étiquette et Description doivent renvoyer des valeurs basées sur les paramètres de langue du format d’états électroniques (ER) en cours d’exécution :

  • Si les étiquettes et les descriptions de la langue demandée sont disponibles, les champs Étiquette et Description renvoient des valeurs basées sur cette langue, et le champ IsTranslated renvoie True.
  • Si les étiquettes et les descriptions de la langue demandée ne sont pas disponibles, les champs Étiquette et Description renvoient des valeurs basées sur la langue EN-US par défaut, et le champ IsTranslated renvoie False.

Au moment de l’exécution, lorsque la syntaxe 2 est utilisée, les champs Étiquette et Description doivent renvoyer des valeurs basées sur la langue définie comme deuxième argument de la fonction appelée :

  • Si les étiquettes et les descriptions de la langue demandée sont disponibles, les champs Étiquette et Description renvoient des valeurs basées sur cette langue, et le champ IsTranslated renvoie True.
  • Si les étiquettes et les descriptions de la langue demandé ne sont pas disponibles, les champs Étiquette et Description renvoient des valeurs basées sur la langue EN-US, et le champ IsTranslated renvoie False.

Exemple 1

Dans l’illustration suivante, une énumération est présentée dans un modèle de données ER.

Énumération dans un modèle

Les détails suivants sont illustrés dans le graphique ci-dessous :

  • L’énumération du modèle est insérée dans un état comme source de données.
  • Une expression ER utilise l’énumération de modèle comme paramètre de la fonction LISTOFFIELDS.
  • Une source de données du type Liste d’enregistrements est insérée dans un état à l’aide de l’expression ER créée.

Formats

L’exemple suivant montre les éléments de format ER liés à la source de données du type Liste d’enregistrements créée à l’aide de la fonction LISTOFFIELDS.

Concepteur de format

L’illustration suivante présente le résultat de l’exécution du format conçu.

Sortie du format

Note

Selon les paramètres de langue configurés pour les éléments de format FILE et FOLDER parents, le texte traduit pour les étiquettes et les descriptions est renseigné dans la sortie du format ER.

Exemple 2

Vous utilisez le type de source de données Champ calculé pour configurer les sources de données enumType_de et enumType_deCH pour l’énumération du modèle de données enumType :

  • enumType_de = LISTOFFIELDS (enumType, "de")
  • enumType_deCH = LISTOFFIELDS (enumType, "de-CH")

Dans ce cas, vous pouvez utiliser l’expression suivante pour obtenir l’étiquette de la valeur d’énumération en allemand suisse, si la traduction est disponible. Si la traduction suisse-allemande n’est pas disponible, l’étiquette est en allemand.

IF (NOT (enumType_deCH.IsTranslated), enumType_de.Label, enumType_deCH.Label)

Ressources supplémentaires

Fonctions de liste