Record.ReorderFields

Синтаксис

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

О нас

Переупорядочение полей записи в соответствии с порядком списка имен полей.

• record: запись, содержащая поля для переупорядочения.
• fieldOrder: список, содержащий новый порядок полей, применяемых к записи. Значения полей сохраняются, а поля, не перечисленные в этом параметре, остаются в исходных позициях.
• missingField: указывает ожидаемое действие для отсутствующих значений в строке, содержащей меньше полей, чем ожидалось. Допустимы следующие значения:
  • MissingField.Error: (по умолчанию) Указывает, что отсутствующие поля должны привести к ошибке. Если для параметра не введено никакого missingField значения, это значение используется.
  • MissingField.Ignore: указывает, что отсутствующие поля должны игнорироваться.
  • MissingField.UseNull: указывает, что отсутствующие поля должны быть включены в качестве null значений.

Пример 1

Изменить порядок некоторых полей в записи.

Использование

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

выход

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

Пример 2

Пересортируйте несколько полей в записи и включите null для каждого отсутствующего поля.

Использование

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

выход

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