Concat e Concatenate funções

Função	Aplica-se a
Concat	Aplicativos de tela Copilot Studio Fluxos de ambiente de trabalho Aplicações orientadas por modelos Funções do Power Platform CLI Dataverse Power Pages
Concatenate	Aplicativos do Canvas Fluxos do Copilot Studio Desktop Colunas de fórmulas Dataverse Aplicações orientadas por modelos CLI da Power Platform Funções Dataverse Páginas de energia

Concatena cadeias individuais de texto e cadeias em tabelas.

Descrição

A Concatenate função concatena uma mistura de cadeias de caracteres individuais e uma tabela de cadeia de caracteres de coluna única. Quando utiliza esta função com cadeias individuais, é equivalente a utilizar o operador&.

A Concat função concatena o resultado de uma fórmula aplicada em todos os registros de uma tabela, resultando em uma única cadeia de caracteres. Utilize esta função para resumir as cadeias de uma tabela, tal como a função Sum o faz para os números.

Os atuais campos do registo em processamento estão disponíveis na fórmula. Utilize o operador ThisRecord ou simplesmente campos de referência pelo nome, como com qualquer outro valor. O operador As também pode ser usado para nomear o registo que está a ser processado, o que pode ajudar a tornar a sua fórmula mais fácil de compreender e tornar os registos aninhados acessíveis. Para mais informações, consulte os exemplos abaixo e trabalhar com o âmbito de registo.

Utilize a função Split ou a função MatchAll para dividir uma cadeia numa tabela de subcadeias.

Sintaxe

Concat( Tabela, Fórmula, separador)

• Tabela - Obrigatório. Tabela a ser utilizada.
• Fórmula - Obrigatório. Fórmula a aplicar aos registos da tabela.
• Separador - Opcional. Um valor de texto a inserir entre linhas concatenadas da tabela.

Concatenate( String1 [, String2, ...] )

• strings - obrigatório. Combinação de cadeias individuais ou uma tabela de coluna única de cadeias.

Exemplos

Os exemplos nesta secção utilizam estas variáveis globais:

• Nome = "Jane"
• Sobrenome = "Doe"
• Produtos =

Para criar estas variáveis globais numa aplicação, introduza um controlo Button e defina a respetiva propriedade OnSelect com esta fórmula:

Set( FirstName, "Jane" ); Set( LastName, "Doe" );
Set( Products,
    Table(
        { Name: "Violin", Type: "String" },
        { Name: "Cello", Type: "String" },
        { Name: "Trumpet", Type: "Wind" }
    )
)

Selecione o botão (ao clicar nele enquanto mantém premida a tecla Alt).

Concatenate e o operador &

Para estes exemplos, defina a propriedade Text e um controlo Label para uma fórmula a partir da primeira coluna da tabela seguinte.

Concatenate com uma tabela de coluna única

Para este exemplo, adicione um controlo Gallery vertical em branco, defina a respetiva propriedade Items como a fórmula na tabela seguinte e, em seguida, adicione uma etiqueta no modelo de galeria.

Concat Função

Para estes exemplos, defina a propriedade Text de uma etiqueta como uma fórmula a partir da primeira coluna da tabela seguinte.

Split e MatchAll

Se você usou Concat com um separador, você pode reverter a operação usando a função Dividir .

Para estes exemplos, adicione uma galeria vertical em branco, defina a respetiva propriedade Items como uma fórmula na tabela seguinte e, em seguida, adicione uma etiqueta no modelo de galeria.