Record.ReorderFields

Syntax

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

Über uns

Sortiert die Felder eines Datensatzes neu an, um der Reihenfolge einer Liste von Feldnamen zu entsprechen.

• record: Der Datensatz, der die felder enthält, die neu angeordnet werden sollen.
• fieldOrder: Eine Liste, die die neue Reihenfolge der Felder enthält, die auf den Datensatz angewendet werden sollen. Feldwerte werden beibehalten, und Felder, die in diesem Parameter nicht aufgeführt sind, verbleiben an ihren ursprünglichen Positionen.
• missingField: Gibt die erwartete Aktion für fehlende Werte in einer Zeile an, die weniger Felder enthält als erwartet. Die folgenden Werte sind gültig:
  • MissingField.Error: (Standard) Gibt an, dass fehlende Felder zu einem Fehler führen sollen. Wenn kein Wert für den missingField Parameter eingegeben wird, wird dieser Wert verwendet.
  • MissingField.Ignore: Gibt an, dass fehlende Felder ignoriert werden sollen.
  • MissingField.UseNull: Gibt an, dass fehlende Felder als null Werte eingeschlossen werden sollen.

Beispiel 1

Ordnen Sie einige felder im Datensatz neu an.

Verwendung

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

Ausgabe

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

Beispiel 2

Ordnen Sie einige der Felder im Datensatz neu an, und fügen Sie null für fehlende Felder hinzu.

Verwendung

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

Ausgabe

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