Compartilhar via


Table Função

Aplica-se a: Aplicativos de tela Copilot Studio Desktop flui aplicativos baseados em modelo 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 registros de argumento e tabelas. Um valor em branco é adicionado a qualquer coluna para a qual um registro não inclui um valor.

Uma tabela é um valor no Power Apps, assim como uma cadeia de caracteres ou um número. Você pode especificar uma tabela como um argumento para uma função, e as funções podem retornar uma tabela como um resultado. Table não cria uma tabela permanente. Em vez disso, retorna uma tabela temporária composta por seus argumentos. Você pode especificar essa tabela temporária como um argumento para outra função, visualizá-la em uma galeria ou incorporá-la a outra tabela. Para obter mais informações, consulte Como trabalhar com tabelas.

Você também pode criar uma tabela de coluna única com a sintaxe [ value1, value2, ... ].

Sintaxe

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

  • RecordOrTables - Obrigatório. A tabela ou os registros a serem adicionados à tabela de resultados. Se uma tabela for fornecida, os registros da tabela serã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 provedor 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 como esta fórmula:

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

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

  • Adicione uma galeria de texto e defina sua propriedade Items como esta função:

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

    A galeria mostra dois registros e ambos contêm o nome e o local de um item. Somente um registro contém o nome do proprietário.

  • Esta fórmula integra tamanhos padrão com tamanhos estendidos em uma única tabela

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