Record.ReorderFields

Syntax

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

Om

Ändrar ordning på fälten i en post så att de matchar ordningen på en lista med fältnamn.

• record: Posten som innehåller fälten som ska ordnas om.
• fieldOrder: En lista som innehåller den nya ordningen för fälten som ska tillämpas på posten. Fältvärden behålls och fält som inte anges i den här parametern finns kvar i sina ursprungliga positioner.
• missingField: Anger den förväntade åtgärden för saknade värden i en rad som innehåller färre fält än förväntat. Följande värden är giltiga:
  • MissingField.Error: (Standard) Anger att fält som saknas ska resultera i ett fel. Om inget värde anges för parametern missingField används det här värdet.
  • MissingField.Ignore: Anger att fält som saknas ska ignoreras.
  • MissingField.UseNull: Anger att fält som saknas ska inkluderas som null värden.

Exempel 1

Ändra ordning på några av fälten i posten.

Användning

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

Resultat

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

Exempel 2

Ändra ordning på några av fälten i posten och inkludera null för eventuella fält som saknas.

Användning

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

Resultat

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