Concat() is used to combine string values. The script function returns the aggregated string concatenation of all values of the expression iterated over a number of records as defined by a group by clause.
Syntax:
Return data type: string
Arguments:
The expression or field containing the string to be processed.
| Argument | Description |
|---|---|
| string |
The expression or field containing the string to be processed. |
| delimiter | Each value may be separated by the string found in delimiter. |
| sort-weight |
The order of concatenation may be determined by the value of the dimension sort-weight, if present, with the string corresponding to the lowest value appearing first in the concatenation. |
| distinct | If the word distinct occurs before the expression, all duplicates are disregarded. |
Examples and results:
Add the example script to your document and run it. Then add, at least, the fields listed in the results column to a sheet in your document to see the result.
| Example | Result field | Result value |
|---|---|---|
|
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 '|');
Concat1: LOAD SalesGroup,Concat(Team) as TeamConcat1 Resident TeamData Group By SalesGroup; |
SalesGroup East West |
TeamConcat1 AlphaBetaDeltaGammaGamma EpsilonEtaThetaZeta |
|
Given that the TeamData table is loaded as in the previous example: LOAD SalesGroup,Concat(distinct Team,'-') as TeamConcat2 Resident TeamData Group By SalesGroup; |
SalesGroup East West |
TeamConcat2 Alpha-Beta-Delta-Gamma Epsilon-Eta-Theta-Zeta |
|
Given that the TeamData table is loaded as in the previous example: LOAD SalesGroup,Concat(distinct Team,'-',Amount) as TeamConcat2 Resident TeamData Group By SalesGroup; |
Because the argument for sort-weight is added, the results are ordered by the value of the dimension Amount. | |
|
SalesGroup East West |
TeamConcat2 Delta-Beta-Gamma-Alpha Eta-Epsilon-Zeta-Theta |
|
