Record.TransformFields
Returns a record after applying specified transformations.
Syntax
Record.TransformFields(
record as record,
transformOperations as list,
optional missingField as MissingField.Type
) as record
Remarks
Returns a record after applying transformations specified in list transformOperations
to record
. One or more fields may be transformed at a given time.
In the case of a single field being transformed,
transformOperations
is expected to be a list with two items. The first item in transformOperations
specifies a field name, and the second item in transformOperations
specifies the function to be used for transformation. For example, {"Quantity", Number.FromText}
In the case of a multiple fields being transformed,
transformOperations
is expected to be a list of lists, where each inner list is a pair of field name and transformation operation. For example, {{"Quantity",Number.FromText},{"UnitPrice", Number.FromText}}
Examples
Example #1
Convert "Price" field to number.
Record.TransformFields(
[OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = "100.0"],
{"Price", Number.FromText}
)
Result:
[OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100]
Example #2
Convert "OrderID" and "Price" fields to numbers.
Record.TransformFields(
[OrderID = "1", CustomerID = 1, Item = "Fishing rod", Price = "100.0"],
{{"OrderID", Number.FromText}, {"Price", Number.FromText}}
)
Result:
[OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100]
Category
Record.Transformations