Funções Concat e Concatenate

Aplica-se a: Aplicações de tela Colunas de fórmula do Dataverse Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Platform CLI

Concatena cadeias individuais de texto e cadeias em tabelas.

Descrição

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

A função Concat concatena o resultado de uma fórmula aplicado a todos os registos de uma tabela, o que resulta numa cadeia única. 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)

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

Concatenate( Cadeia1 [, Cadeia2,...] )

• Cadeia(s) – 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:

• FirstName = "Jane"
• LastName = "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).

Função 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.

Concatene 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.

Função Concat

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 utilizou Concat com um separador, pode inverter a operação ao utilizar a função Split.

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.