Skip to main content

Record.RenameFields

Applies rename(s) from a list in the form { old, new }.

Syntax​

Record.RenameFields(
    record as record,
    renames as list,
    optional missingField as MissingField.Type
) as record

Remarks​

Returns a record after renaming fields in the input record to the new field names specified in list renames. For multiple renames, a nested list can be used ({ {old1, new1}, {old2, new2} }.

Examples​

Example #1​

Rename the field "UnitPrice" to "Price" from the record.

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

Result:

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

Example #2​

Rename the fields "UnitPrice" to "Price" and "OrderNum" to "OrderID" from the record.

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

Result:

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

Category​

Record.Transformations