Valores dinâmicos

Dinâmico é um tipo de dados no Power Fx que pode conter qualquer estrutura de dados, complexa ou simples. Ele não pode ser usado diretamente e convertido para outro tipo de dados em tempo de execução, explícita ou implicitamente. Os campos de registros em um valor dinâmico podem ser acessados usando a notação de ponto, e a existência de campos só é verificada em tempo de execução.

Há duas maneiras de criar um valor Dinâmico :

• Usando a função ParseJSON.
• Usando um conector que retorna um tipo "dinâmico".

Tipos Simples

O valor de uma variável que contém um valor Dynamic não pode ser usado diretamente. Você sempre tem que digitá-lo corretamente usando o construtor de tipo correspondente ou convertendo-o em um tipo específico com as funções AsType e ParseJSON .

Os exemplos a seguir convertem o valor de uma variável Dynamic chamada DynValue.

Text(DynValue)

Value(DynValue)

A tabela a seguir lista os tipos de dados e as funções correspondentes para converter Dynamic para esse tipo de dados.

Tipos de Registo

Você pode acessar campos em uma variável que representa um registro dinâmico usando a notação de pontos regular usada para registros. No entanto, a existência de campos só será verificado em runtime. Como resultado, Intellisense também não está disponível. Se um campo não existir ou tiver um valor null subjacente, aceder-lhe resultará num valor Blank().

Cada campo no registro também é do tipo Dinâmico e precisa ser digitado corretamente. O campo pode ser um registro dinâmico de tipo simples. No caso de ser um registo, pode encadear a notação de ponto. Se qualquer campo na cadeia não existir, é obtido Blank().

Os exemplos a seguir usam campos de uma variável Dynamic chamada DynRecord.

Text(DynRecord.StringField)

Value(DynRecord.Field.ChildField)

Caso um nome de campo seja composto por um nome de identificador inválido, por exemplo, quando os nomes de campo começam por um número ou contêm carateres inválidos, como um hífen, pode colocar os nomes de campo entre plicas:

dynamic.'01'
dynamic.'my-field'

Acesso a colunas dinâmicas

Por vezes, os nomes de colunas num registro serão dinâmicos. Use a função ColumnNames para determinar que nomes de coluna estão disponíveis num registo e, em seguida, use a função Column para obter o valor de uma coluna nomeada.

Por exemplo,

LettersUsed = ParseJSON( "{ ""d"": 2, ""p"": 3 }" );

Concat( ColumnNames( LettersUsed ) As Names, Names.Value, ", " )
// returns "d, p"

Sum( ForAll( ColumnNames( LettersUsed ) As Names, Column( LettersUsed, Names.Value ) ), Value )
// returns 5

Matrizes

Uma variável Dynamic pode conter uma matriz. Mesmo que a matriz possa ser uma matriz de registros ou uma matriz de tipos simples, converter a matriz dinâmica em uma tabela usando a função Table() sempre resultará em uma tabela de coluna única de Dynamic. Funções como ForAll() e Index() não necessitam que crie primeiro uma Table() e, como resultado, não necessitam que utilize o campo Value de coluna única.

Por exemplo, para obter o segundo número em uma matriz de Dinâmico contendo valores numéricos ( [1, 2, 3] ), a fórmula a seguir pode ser usada para recuperar a segunda linha da tabela e converter a coluna em um número:

Value( Index( UOArray, 2 ) )

Se o Dynamic foi convertido em um Table() primeiro, a segunda linha na tabela de coluna única do resultado é uma Value coluna contendo o Dynamic:

Value( Index( Table( UOArray ), 2 ).Value )

Para uma matriz de registos que tenha uma coluna de texto denominada Field, aplica-se a mesma lógica. O Dynamic pode ser acessado diretamente, ou se o uso da função Table() resultará em uma tabela de coluna única de Dynamic.

A Field coluna pode ser acessada diretamente do Dynamic retornado pela função Index( ).

Text( Index( UORecordArray, 2 ).Field )

Ao usar a função Table(), primeiro recupere a coluna de coluna Value única para obter o Dynamic e, em seguida, acesse a Field coluna:

Text( Index( Table( UORecordArray ), 2 ).Value.Field )

Para converter uma matriz de registos numa tabela com tipo, pode utilizar a função ForAll() e converter cada campo individual.

ForAll( UORecordArray, { FirstField: Value(ThisRecord.FirstField), SecondField: Text(ThisRecord.SecondField) } )

Se o Dinâmico for convertido pela primeira vez em uma tabela, novamente, a tabela de coluna única resultante de Dinâmico exigirá que você use a Value coluna para obter os campos.

ForAll( Table(UORecordArray), { FirstField: Value(ThisRecord.Value.FirstField), SecondField: Text(ThisRecord.Value.SecondField) } )

Converter em registos e tabelas com tipo

Em vez de converter cada valor simples individualmente, as funções ParseJSON,IsType e AsType podem ser usadas para converter um Dynamic em um objeto digitado em massa. Use a função Type para criar um tipo que mapeará a estrutura dinâmica para uma estrutura tipada.

Por exemplo, aqui estamos a interpretar as cadeias JSON como valores de data e hora, sem a necessidade de chamar a função DateTimeValue:

Eclipse = ParseJSON( "{ ""Start"": ""2026-08-12T18:26:00.000Z"", ""End"": ""2026-08-12T18:33:00.000Z"" }",
                     Type( { Start: DateTime, End: DateTime } ) );

DateDiff( Eclipse.Start, Eclipse.End, TimeUnit.Minutes )
// 7