Record.TransformFields

Sintaxe

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

Sobre nós

Retorna um registro depois de aplicar as transformações especificadas na lista transformOperations a record. Um ou mais campos podem ser transformados num determinado momento.

No caso de um único campo ser 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 transformação. Por exemplo, {"Quantity", Number.FromText}

No caso de vários campos sendo transformados, espera-se que transformOperations seja uma lista de listas, onde 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

Converter o campo "Preço" em número.

Utilização

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

Output

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

Exemplo 2

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

Utilização

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

Output

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