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.