# Concat Fields

## ![](/files/g14WEn6qPuzpvf02iond) Concat Fields

### Description <a href="#description" id="description"></a>

The Concat Fields transform concatenates multiple fields into one target field. Type in a target field name which always creates a new field. You can optionally use a Separator field or Enclosure between fields and add the fields or free text you would like to concatenate in order.

| Hop Engine | <sup>✓</sup> |
| ---------- | ------------ |
| Spark      | <sup>✓</sup> |
| Flink      | <sup>✓</sup> |
| Dataflow   | <sup>✓</sup> |

### Options

#### General

| Option                                  | Description                                                                                                                                                                             |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Transform name                          | Name of the transform.                                                                                                                                                                  |
| Target Field Name                       | The name of the target field (String type)                                                                                                                                              |
| Length of Target Field                  | The length of the string type (setting the meta-data of the String type, this is also used by the Fast Data Dump option for performance optimization)                                   |
| Separator                               | Specify the character that separates the fields in a single line of text. Typically this is ; or a tab.                                                                                 |
| Enclosure                               | A pair of strings can enclose some fields. This allows separator characters in fields. The enclosure string is optional.                                                                |
| Force enclosure?                        | Force adding the enclosing character before and after each field that is added to the concatenated string.                                                                              |
| Remove concatenated fields from output? | If checked, the fields that were used to create the concatenated field (specified in `Target Field Name`) will be removed from the output and wil not be available in later transforms. |

#### Fields Tab

This is identical to the fields tab option of the Text File Output transform and has the same functionality.

| Option        | Description                                                                                                                                                                                                                                                       |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name          | The name of the field.                                                                                                                                                                                                                                            |
| Type          | Type of the field can be either String, Date or Number.                                                                                                                                                                                                           |
| Format        | The format mask to convert with. See Number Formats for a complete description of format symbols.                                                                                                                                                                 |
| Length        | <p>The length option depends on the field type follows:</p><ul><li>Number - Total number of significant figures in a number</li><li>String - total length of string</li><li>Date - length of printed output of the string (e.g. 4 only gives back year)</li></ul> |
| Precision     | <p>The precision option depends on the field type as follows:</p><ul><li>Number - Number of floating point digits</li><li>String - unused</li><li>Date - unused</li></ul>                                                                                         |
| Currency      | Symbol used to represent currencies like $10,000.00 or E5.000,00                                                                                                                                                                                                  |
| Decimal       | A decimal point can be a "." (10,000.00) or "," (5.000,00)                                                                                                                                                                                                        |
| Group         | A grouping can be a "," (10,000.00) or "." (5.000,00)                                                                                                                                                                                                             |
| Trim type     | The trimming method to apply on the string. Trimming only works when there is no field length given.                                                                                                                                                              |
| Null          | If the value of the field is null, insert this string into the textfile                                                                                                                                                                                           |
| Get           | Click to retrieve the list of fields from the input fields stream(s)                                                                                                                                                                                              |
| Minimal width | Alter the options in the fields tab in such a way that the resulting width of lines in the text file is minimal. So instead of save 0000001, we write 1, etc. String fields will no longer be padded to their specified length.                                   |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.primeur.com/data-shaper-1.21/knowing-the-data-shaper-designer/pipelines/transforms/concatfields.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
