Record.ReorderFields

Syntaxe

Record.ReorderFields(
    record as record,
    fieldOrder as list,
    optional missingField as nullable number
) as record

À propos

Réorganise les champs d’un enregistrement pour qu’ils correspondent à l’ordre d’une liste de noms de champs.

• record: enregistrement contenant les champs à réorganiser.
• fieldOrder: liste contenant le nouvel ordre des champs à appliquer à l’enregistrement. Les valeurs de champ sont conservées et les champs non répertoriés dans ce paramètre sont laissés dans leurs positions d’origine.
• missingField: spécifie l’action attendue pour les valeurs manquantes dans une ligne qui contient moins de champs que prévu. Les valeurs suivantes sont valides :
  • MissingField.Error: (Valeur par défaut) Indique que les champs manquants doivent entraîner une erreur. Si aucune valeur n’est entrée pour le missingField paramètre, cette valeur est utilisée.
  • MissingField.Ignore: indique que les champs manquants doivent être ignorés.
  • MissingField.UseNull: indique que les champs manquants doivent être inclus en tant que null valeurs.

Exemple 1

Réorganisez certains champs de l’enregistrement.

Utilisation

Record.ReorderFields(
    [CustomerID = 1, OrderID = 1, Item = "Fishing rod", Price = 100.0],
    {"OrderID", "CustomerID"}
)

Sortie

[OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0]

Exemple 2

Réorganisez certains des champs de l’enregistrement et incluez null pour tous les champs manquants.

Utilisation

let
    Source = [CustomerID = 3, First Name = "Paul", Phone = "543-7890", Purchase = "Fishing Rod"],
    reorderedRecord = Record.ReorderFields(
        Source, 
        {"Purchase", "Last Name", "First Name"}, 
        MissingField.UseNull
    )
in
    reorderedRecord

Sortie

[CustomerID = 3, Purchase = "Fishing Rod", Phone = "543-7890", Last Name = null, First Name = "Paul"]