Record.TransformFields

Sintaxe

Record.TransformFields(record as record, transformOperations as list, optional missingField as nullable number) as record

Sobre

Retorna um registro após aplicar as transformações especificadas na lista transformOperations para record. Um ou mais campos podem ser transformados em um determinado momento.

Caso um único campo esteja sendo transformado, espera-se que transformOperations seja uma lista com dois itens. O primeiro item em transformOperations especifica um nome de campo e o segundo item em transformOperations especifica a função a ser usada para a transformação. Por exemplo, {"Quantity", Number.FromText}

No caso de vários campos estarem sendo transformados, espera-se que transformOperations seja uma lista de listas, em que cada lista interna é um par de nome de campo e operação de transformação. Por exemplo, {{"Quantity",Number.FromText},{"UnitPrice", Number.FromText}}

Exemplo 1

Converte o campo "Price" em número.

Usage

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

Saída

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

Exemplo 2

Converte os campos "OrderID" e "Price" em números.

Usage

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

Saída

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