Record.ReorderFields

Sintaxe

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

Sobre nós

Reordena os campos de um registro para corresponder à ordem de uma lista de nomes de campos.

• record: O registo que contém os campos a reordenar.
• fieldOrder: Uma lista que contém a nova ordem dos campos a aplicar ao registo. Os valores de campo são mantidos e os campos não listados neste parâmetro são deixados em suas posições originais.
• missingField: Especifica a ação esperada para valores ausentes em uma linha que contém menos campos do que o esperado. Os seguintes valores são válidos:
  • MissingField.Error: (Padrão) Indica que campos ausentes devem resultar em um erro. Se nenhum valor for inserido para o missingField parâmetro, esse valor será usado.
  • MissingField.Ignore: Indica que os campos ausentes devem ser ignorados.
  • MissingField.UseNull: Indica que os campos em falta devem ser incluídos como null valores.

Exemplo 1

Reorganize alguns dos campos do registo.

Utilização

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

Saída

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

Exemplo 2

Reordene alguns dos campos no registo e inclua null para quaisquer campos em falta.

Utilização

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

Saída

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