# Concat - função de gráfico
Concat() é usado para combinar valores dos caracteres. A função retorna a concatenação de caracteres agregada de todos os valores da expressão avaliada em cada dimensão.
Concat({[SetExpression] [DISTINCT] [TOTAL [<fld{, fld}>]] string[, delimiter[, sort\_weight]])
Tipo de dados de retorno: Cadeia
Concatenar argumentos
| Argumento | Descrição |
| --- | --- |
| string | A expressão ou campo que contém a string a ser processada. |
| delimiter | Cada valor pode ser separado pelo caractere encontrado em delimiter. |
| sort\_weight | A ordem de concatenação pode ser determinada pelo valor de dimensão sort\_weight, caso esteja presente, com o caractere correspondente ao valor mais baixo aparecendo primeiro na concatenação Quando 0 é usado como o valor do argumento sort\_weight, a classificação não é aplicada à saída. Se o argumento sort\_weight for omitido, a função assume a classificação alfanumérica por padrão. |
| SetExpression | Por padrão, a função de agregação agregará um conjunto de registros possíveis definidos pela seleção. Um conjunto de registros alternativos pode ser definido por uma expressão de análise. |
| distinct | Se a palavra distinct aparecer antes da expressão, todas as duplicatas serão ignoradas. |
| TOTAL | Se a palavra TOTAL ocorrer antes dos argumentos da função, o cálculo é feito sobre todos os valores possíveis, dadas as seleções atuais, e não apenas sobre os pertinentes ao valor dimensional atual, isto é, desconsiderando as dimensões do gráfico. O qualificador TOTAL pode vir seguido de uma lista de um ou mais nomes de campos dentro de sinais de maior e menor que <fld>. Esses nomes de campos devem ser um subconjunto das variáveis de dimensões do gráfico.
[Definindo o escopo de agregação](https://help.qlik.com/pt-BR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/define-aggregation-scope.htm) |
Exemplos e resultados
| Exemplo | Resultado |
| --- | --- |
| `Concat(Team)` | A tabela é criada a partir das dimensões SalesGroup e Amount e das variações da medida Concat(Team). Ignorando o resultado total, observe que embora existam dados para oito valores de Team distribuídos para dois valores de SalesGroup, o único resultado da medida Concat(Team) que concatena mais de um valor de caracteres Team na tabela é a linha que contém a dimensão Amount 20000, que dá o resultado BetaGammaGamma. Isso ocorre porque existem três valores para Amount 20000 nos dados de entrada. Todos os demais resultados permanecem desconcatenados quando a medida é estendida para as dimensões, porque há apenas um valor de Team para cada combinação de SalesGroup e Amount. |
| `Concat(DISTINCT Team,', ')` | Beta, Gamma. porque o qualificador DISTINCT significa que o resultado Gamma duplicado é desconsiderado. Além disso, o argumento do delimitador é definido como uma vírgula seguida por um espaço. |
| `Concat (TOTAL Team)` | Todos os valores de string para todos os valores de Team são concatenados se o qualificador TOTAL for usado. Com a seleção de campo <SalesGroup> especificada, isso divide os resultados em dois valores da dimensão SalesGroup. Para SalesGroup East, os resultados são AlphaBetaDeltaGammaGamma. Para SalesGroup West, os resultados são EpsilonEtaThetaZeta. |
| `Concat (TOTAL Team,';', Amount)` | Ao adicionar o argumento para sort\_weight: Amount, os resultados são ordenados pelo valor da dimensão Amount. Os resultados tornam-se DeltaBetaGammaGammaAlpha e EtaEpsilonZEtaTheta. |
| `Concat(Team, '', 0)` | Com sort\_weight definido como 0, os resultados não são classificados. |
| `Concat(TOTAL Team, '', 0)` | Com sort\_weight definido como 0, os resultados não são classificados. Além disso, todos os valores de string para todos os valores de Team são concatenados, porque o qualificador TOTAL é usado. |
**Dados usados nos exemplos:**
`TeamData:
` `LOAD * inline [` `SalesGroup|Team|Date|Amount
` `East|Gamma|01/05/2013|20000
` `East|Gamma|02/05/2013|20000
` `West|Zeta|01/06/2013|19000
` `East|Alpha|01/07/2013|25000
` `East|Delta|01/08/2013|14000
` `West|Epsilon|01/09/2013|17000
` `West|Eta|01/10/2013|14000
` `East|Beta|01/11/2013|20000
` `West|Theta|01/12/2013|23000
` `] (delimiter is '|');`
Exemplo de dados em forma de tabela
| SalesGroup | Amount | Concat(Team) | Concat(TOTAL <SalesGroup> Team) | Concat(Team, ', ', 0) | Concat(TOTAL <SalesGroup> Team, '', 0) |
| --- | --- | --- | --- | --- | --- |
| East | 14000 | Delta | AlphaBetaDeltaGammaGamma | Delta | GammaGammaAlphaDeltaBeta |
| East | 20000 | BetaGammaGamma | AlphaBetaDeltaGammaGamma | GammaGammaBeta | GammaGammaAlphaDeltaBeta |
| East | 25000 | Alpha | AlphaBetaDeltaGammaGamma | Alpha | GammaGammaAlphaDeltaBeta |
| West | 14000 | Eta | EpsilonEtaThetaZeta | Eta | ZetaEpsilonEtaTheta |
| West | 17000 | Epsilon | EpsilonEtaThetaZeta | Epsilon | ZetaEpsilonEtaTheta |
| West | 19000 | Zeta | EpsilonEtaThetaZeta | Zeta | ZetaEpsilonEtaTheta |
| West | 23000 | Theta | EpsilonEtaThetaZeta | Theta | ZetaEpsilonEtaTheta |