Record.ReorderFields

Sintaksis

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

Tentang

Menyusun ulang bidang rekaman agar sesuai dengan urutan daftar nama bidang.

• record: Rekaman yang berisi bidang yang akan diurutkan ulang.
• fieldOrder: Daftar yang berisi urutan baru bidang yang akan diterapkan ke rekaman. Nilai bidang dipertahankan dan bidang yang tidak tercantum dalam parameter ini dibiarkan dalam posisi aslinya.
• missingField: Menentukan tindakan yang diharapkan untuk nilai yang hilang dalam baris yang berisi lebih sedikit bidang dari yang diharapkan. Nilai berikut ini valid:
  • MissingField.Error: (Default) Menunjukkan bahwa bidang yang hilang akan mengakibatkan kesalahan. Jika tidak ada nilai yang dimasukkan untuk missingField parameter , nilai ini digunakan.
  • MissingField.Ignore: Menunjukkan bahwa bidang yang hilang harus diabaikan.
  • MissingField.UseNull: Menunjukkan bahwa bidang yang hilang harus disertakan sebagai null nilai.

Contoh 1

Menyusun ulang beberapa bidang dalam rekaman.

Penggunaan

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

Hasil

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

Contoh 2

Urus ulang beberapa bidang dalam rekaman dan sertakan null untuk bidang yang hilang.

Penggunaan

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

Hasil

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