Record.ReorderFields

Syntax

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

O

Zmení poradie polí záznamu tak, aby zodpovedali poradiu zoznamu názvov polí.

• record: Záznam obsahujúci polia, ktoré sa majú zmeniť.
• fieldOrder: Zoznam obsahujúci nové poradie polí, ktoré sa majú použiť v zázname. Hodnoty polí sú zachované a polia, ktoré nie sú uvedené v tomto parametri, sú ponechané na pôvodnej pozícii.
• missingField: Určuje očakávanú akciu pre chýbajúce hodnoty v riadku, ktorý obsahuje menej polí, než sa očakávalo. Nasledujúce hodnoty sú platné:
  • MissingField.Error: (Predvolené) Označuje, že chýbajúce polia by mali mať za následok chybu. Ak pre missingField parameter nie je zadaná žiadna hodnota, použije sa táto hodnota.
  • MissingField.Ignore: Označuje, že chýbajúce polia sa majú ignorovať.
  • MissingField.UseNull: Označuje, že chýbajúce polia by sa mali zahrnúť ako null hodnoty.

Príklad č. 1

Zmeňte poradie niektorých polí v zázname.

používania

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

výstupu

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

Príklad č. 2

Zmeňte poradie niektorých polí v zázname a zahrňte null všetky chýbajúce polia.

používania

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

výstupu

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