For the sake of simplicity, this documentation uses the term "extended bindings" for this document function.

Extended bindings make it possible to influence the document structure via XSLT. Compared to the document function "Scripts", extended bindings are able to change not only the text content but also other attributes such as text color, size of applied style, etc. They offer many possibilities, however, they are challenging to implement and maintain and have a higher loading time than documents without extended bindings. Therefore, extended bindings should be used sparingly and if possible not at all.

Tags

General Tags

Formatting container tags

Operators

Data access

Extended bindings can be used to access and use data in the same way as scripts. The data is stored in a variable.

Example of a variable:

Example of accessing a text field in the Document Parameter:

_{The "DocParam" prefix is not mandatory. However, the OneOffixx conventions dictate that fields in the Document Parameter must be provided with this prefix.}

Example of accessing a CheckBox in the Document Parameter:

_{The "DocParam" prefix is not mandatory. However, the OneOffixx conventions dictate that fields in the Document Parameter must be provided with this prefix.}

Example of accessing a ComboBox:

_{The "DocParam" prefix is not mandatory. However, the OneOffixx conventions dictate that fields in the Document Parameter must be provided with this prefix.}

Example of accessing a script:

_{Unlike accessing the document parameter, the prefix 'CustomElements' is mandatory here.}

Functionalities

Normalize space

The function "Normalize-Space()" cleans up variables, input fields, etc. That means, if there should be a space in a field by mistake, it will be considered as empty.

_{The above variable contains the content of the subject field from the document parameter, cleaned from redundant spaces..}

If

The "If" function offers the possibility to make actions dependent on conditions.

_{The above template checks if the subject field in the Document Parameter is not empty. If it is, the value is output, otherwise nothing happens.}

Choose

The function "Choose" is an extension of the function If. It offers the additional possibility to make a statement if the condition does not apply. For this the tags When and Otherwise are used. What is between the When tags will be executed if the condition is true. What is between the Otherwise tags will be executed if the condition is not true.

_{The above template checks if the subject field in the Document Parameter is not empty. If it is, the value will be output. If the subject field is empty, the information text "Subject is empty" is output.}

Substring

The function "Substring" is divided into two sub-functions; there are Substring-before and Substring-after. One passes to the template a string (text) and a character (character) at which the text is to be separated.

_{*The first template outputs everything that comes before the "@" in the email. The second template outputs everything after the "@".}

Concat

The Concat function is the opposite of the Substring function: it concatenates strings.

_{The template above creates an email address from the first name and last name, a dot is placed between the first name and last name, and "@example.com" is added after the last name.}

Examples

Recipient with shipping method

The shipping type and the recipient have different style information, moreover the shipping type is an optional input. If it is desired that the recipient moves up one line if the dispatch type is not filled in, this must be solved with an extended binding. The usual scripts cannot use different style information in one script.

Open

Example of a recipient with and without shipping method

Dynamic tables

Tables with static number of rows and columns but optional display of rows and columns are another example for the use of extended bindings. Whether a row or column is displayed can be defined in the document parameter using a CheckBox.

Open

Example of a table with dynamically displayed rows / columns