Table Função

Aplica-se a: Aplicativos do Canvas Fluxos do Copilot Studio Desktop Aplicativos orientados por modelos Funções do Power Platform CLI Dataverse

Cria uma tabela temporária.

Descrição

A Table função cria uma tabela a partir de uma lista de argumentos de registros ou tabelas.

As colunas da tabela de resultados são a união de todas as colunas de todos os registos e tabelas de argumentos. O valor blank é adicionado a qualquer coluna para a qual um registo não inclua um valor.

Uma tabela é um valor no Power Apps, tal como uma cadeia ou um número. Pode especificar uma tabela como um argumento para uma função e as funções podem devolver uma tabela como um resultado. Table não cria uma tabela permanente. Em vez disso, devolve uma tabela temporária constituída pelos respetivos argumentos. Pode especificar esta tabela temporária como um argumento para outra função, visualizá-la numa galeria ou incorporá-la noutra tabela. Para obter mais informações, consulte trabalhar com tabelas.

Também pode criar uma tabela de coluna única com a sintaxe [ valor1, valor2,... ].

Sintaxe

Table( RecordOrTable1 [, RecordOrTable2, ... ] )

• RecordOrTables - Obrigatório. Os registos ou a tabela a adicionar à tabela de resultados. Se for fornecida uma tabela, os registos da tabela são adicionados à tabela resultante como se tivessem sido adicionados individualmente.

Table( Dinâmico )

• Dinâmico - Obrigatório. Valor dinâmico que representa uma tabela ou matriz. Os valores aceitáveis dependem do fornecedor sem tipo. Para JSON, espera-se que o valor dinâmico seja uma matriz JSON. Independentemente do tipo de conteúdo da matriz Untyped, a tabela resultante é uma tabela de coluna única de valores dinâmicos.

Exemplos

• Defina a propriedade Items de uma caixa de listagem para esta fórmula:

  Table( {Color: "red"}, {Color: "green"}, {Color: "blue" } )
  

  A caixa de listagem apresenta cada cor como uma opção.

• Adicione uma galeria de texto e defina a respetiva propriedade Items para esta função:
  

  Table( {Item: "Violin123", Location:"France", Owner:"Fabrikam"}, {Item:"Violin456", Location:"Chile"} )
  

  A galeria apresenta dois registos que contêm o nome e a localização de um item. Apenas um registo contém o nome do proprietário.

• Esta fórmula combina tamanhos padrão com tamanhos alargados numa única tabela

  Table( { Value: "XS" }, [ "S", "M", "L" ], { Value: "XL" } )