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 conversão em outro tipo de dados em runtime, explicitamente ou implicitamente. 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 runtime.

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 dinâmico não pode ser usado diretamente. Você sempre precisa digitá-lo corretamente usando o construtor de tipo correspondente ou convertendo-o em um tipo específico com funções AsType e ParseJSON .

Os exemplos a seguir convertem o valor de uma variável dinâmica chamada DynValue.

Text(DynValue)

Value(DynValue)

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

Tipos de Registro

Você pode acessar campos em uma variável que representa um registro dinâmico usando a notação de ponto regular usada para registros. No entanto, a existência dos campos não será verificada até o runtime. Como resultado, também não haverá intellisense disponível. Se um campo não existir ou tiver um valor nulo subjacente, acessá-lo resultará em um 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. Caso seja um registro, você pode encadear a notação de ponto. Se algum campo na cadeia não existir, Blank() será retornado.

Os exemplos a seguir usam campos de uma variável dinâmica chamada DynRecord.

Text(DynRecord.StringField)

Value(DynRecord.Field.ChildField)

Caso um nome de campo consista em um nome de identificador inválido, por exemplo, quando os nomes dos campos começam com um número ou contêm caracteres inválidos, como um hífen, você pode colocar os nomes dos campos entre aspas simples:

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

Acesso dinâmico à coluna

Às vezes, os nomes das colunas em um registro serão dinâmicos. Use a função ColumnNames para determinar quais nomes de coluna estão disponíveis em um registro e, em seguida, use a função Column para recuperar 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 dinâmica pode conter uma matriz. Embora 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 do Dynamic. Funções como ForAll() e Index() não exigem que você crie primeiro uma função Table() e, como resultado, você não precisa usar o campo de coluna única Value,

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

Value( Index( UOArray, 2 ) )

Se a Dinâmica tiver sido convertida em uma Tabela() primeiro, a segunda linha na tabela de coluna única de resultado será uma Value coluna que contém a Dinâmica:

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

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

A Field coluna pode ser acessada diretamente da função Dynamic retornada 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 Dinâmico e, em seguida, acesse a Field coluna:

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

Para converter uma matriz de registros em uma tabela digitada, você pode usar a função ForAll() e converta cada campo individual.

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

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

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

Conversão em tabelas e registros tipados

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 interpretando as cadeias de caracteres 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