String Join

String Join is a gh-element that allows you to join values of different fields and the entered value into one string.

Functional Characteristics

This element is used to concatenate selected fields. For example, when the user enters his or her first and last name separately in different fields, this element will join them into one line. The String join element is very similar to the text element, so it can be used in the same ways.

Value Format

The string join does not contain any value until the Persistent Value option is disabled.

{
    "field_value": "Hello World"
}

Element Options

String join has two groups of settings. One of them configures its value and the second one configures the element.

Field Settings

This is the main settings group. It allows you to customize the field and contains standard and advanced options.

Persistent Value

As long as this function is not enabled, the join string does not save the generated value. So, it allows to save value in the field.

One Time Generation

This function allows you to fix the first generated value and display it in the application. This value can only be updated with the Update Button.

Expression Generator

The last group allows you to make an expression that join strings.

Field

This button allows to take the field whose value will be used in the expression. It also allows you to configure which part and how many characters of a given value are used.

Word

This button opens a popup window in which you can enter your own value to be used in the expression.

ID

This is the button that allows to select one of four values.

• Index number of item
• Current year
• Current month
• Current day of month

Concatenation

The concatenation button allows to enter the plus sign and connect all the parts of the expression.

Clear

This button allows to clear the full expression.

Clear Element

This button allows to clear one element of sign. It has '<' as a name.

Element Style

The string join element has quite standard set of style settings and only one interpretation type. The only additional setting is located in general group of settings.

General Settings

Almost all style settings are set by default instead of the only one.

Update Button

This is the button that allows you to update the value when One Time Generation is enabled.

Data Model

The data model of this element contains all its settings, including configuration options.

{
    "data_model": {
        "arguments": [{
            "word": "Hello World"
        },
        {
            "app_id": "28752",
            "field_id": "679043",
            "field_settings": {
                "count": 2,
                "display": "first_characters",
                "name": "first characters"
            }
        },
        {
            "type": "Current day of month"
        }],
        "expression": "WORD()+FIELD_STRING()+ITEM_INDEX()",
        "interpretation": [],
        "is_generate_once": 0,
        "is_persistent_value": 0,
        "tooltip": {
            "filter_valuesArray": ["string_join", "string_join"],
            "settings_file_id": "30233"
        }
    }
}

Filtration

This element can be filtered using filters that compare strings:

• Contains(or)
• Contains(and)
• Not contains(or)
• Not contains(and)
• Equals(or)
• Equals(and)
• Not equals(or)
• Not equals(and)
• Value

Interpretation

The current element has only two interpretation types.

Default

The default interpretation allows to display the result of the join.

Value

The last interpretation displays the raw value of the field.