Text script

The result is a text.
All tags may be used except Image and Snippet.

Snippet script

The result is a composition of snippets.
In snippet scripts only Snippet and Condition may be used.

Image script

The result is an image.
In image scripts only Image and Condition may be used.

depth

Determines how often the script result is calculated. Generally, it is recommended to link to the Depth stored in the Global Configurations, which is 5 by default. If a script accesses the result of another script, depth must be at least 2. For each additional nested access depth must be increased by 1.

engine

Specifies the engine used for script interpretation/implementation. Only "XSL" is available as value.

version

Bestimmt die Scriptengine-Version, die zur Anwendung kommt. Standardmässig ist der Wert 2. Die Angabe dieser Version könnte auch auf Ebene CustomDataNode übersteuert werden. Die Angabe der Version ist in Bezug auf die Abwärtskompatibilität wichtig.

id

Id of the binding element that will be defined. The id must be unique. For better clarity in the template editor, the folder structure itself can be controlled: If an Id contains a dot, a folder is created from the word before the dot. OneOffixx puts the prefix "CustomElements." in front of each Id. This must be taken into account when accessing another script in a script.

version

Specifies the script engine version that will be used. A specification at CustomDataNode level overrides any version decleration at Script level.

bookmarkname

Allows to specify the name of the bookmark into which the corresponding snippets will be inserted in the template editor. This attribute is only considered in connection with snippets.

update

With true causes the snippet to update or not (false) depending on document parameter selections. This attribute is only considered in connection with snippets.

fixoutput

By setting fixoutput to true, an empty line break will be generated. Thanks to the attribute, the line will be output even if there is no content.

when

see Condition

notwhen

see Condition

id

Id of the field to be inserted

checkBoxActivatedSymbol

Definition of the character to be displayed when a checkbox is selected

checkBoxDeactivatedSymbol

Definition of the character to be output when a checkbox is not selected

linePrefix

Prefix character for each line of a list or multi-line text element

separator

Separator text to the next element or text to be displayed only if the following element provides content

showEmptyEndLines

Accepts all existing trailing empty lines: true/false (false is default)

showEmptyStartLines

Accepts all existing preceding empty lines: true/false (false is default)

textafter

Fixed text that always appears after the element. e.g. textafter=" USD"

textbefore

Fixed text that always appears before the element. e.g. textbefore="VAT: "

when

see Condition

notwhen

see Condition

Functions

fCase*

Defines whether the incoming text should be written upper or lower case: fCase="[upper/lower]". For Unicode characters there is an extension that works similarly: upperUnicode/lowerUnicode.

fFormattingDate*

Defines an explicit format for a DateTime element. In general, it is always associated with the formats present in the Global Translations:
fFormattingDate="{D[Configuration.DateFormat.WrittenOut]}, results in e.g. fFormattingDate="d. MMMM yyyy.

fFormattingNumber*

Defines an explicit format for phone numbers in a text field (e.g. in the Profile.User.Phone field).
fFormattingNumber="{D[Configuration.PhoneNumberFormat]}, results in e.g. fFormattingNumber="+00 00 000 00,41 Literals (see also http://openbook.galileocomputing.de/csharp/kap30.html):
# → digit placeholder
0 → digit placeholder (identical to # but here the character '0' is output if no number is present at this position)
' → text masking (text entered in single quotes is not interpreted and output as text)
\ → character masking (the next character is not interpreted and output as character)

fFormattingNumeric*

Defines an explicit format for numbers.
e.g. fFormattingNumeric="C3" (C=currency, 3=number of decimal places)

fReplace*

Defines whether a part of the text should be replaced.
e.g. fReplace="[existing string],[new string]"

fSelectLine*

Defines whether one or more lines should be selected from a multiline text.
e.g. fSelectLine="[start line],[end line]"

fSubstring*

Defines whether only a part of the text should be output.
e.g. fSubstring"[start character],[number of characters]"

fSubstringAfter*

Defines whether only the end (after a given string) of the text should be output. If the delimiter is not present the whole text will be output.
e.g. fSubstringAfter="[String]"

fSubstringAfterOrEmpty*

Defines whether only the end (after a given string) of the text should be output. If the delimiter is not present no text will be output.
e.g.fSubstringAfterOrEmpty="[String]"

fSubstringBefore*

Defines whether only the beginning (before a given string) of the text should be output. If the separator is not present the whole text will be output.
e.g. fSubstringBefore="[String]"

fSubstringBeforeOrEmpty*

Defines whether only the beginning (before a given string) of the text should be output. If the delimiter is not present no text will be output.
e.g. fSubstringBeforeOrEmpty="[String]"

fTrim*

Defines whether only a maximum number of characters should be output.
e.g. fTrim="[maximum number of characters],[mode],[placeholder]".
[mode] → place where text should be trimmed if overlength. Allowed values: left, right and middle
[Placeholder] → Placeholder text which will be inserted if an overlength is reached (e.g. "...").

fTrimURL*

Defines whether only part of a URL or file path should be output (see also fTrim). e.g. fTrimURL="[Kind],[Mode],[Number of folders]"
[Kind] → File or Folder, where File selects the filename and Folder the path without filename. For this reason the following options "Mode" and "Number of folders" are only available for Folder.
[Mode] → Location from which the number of desired folders should be displayed. Allowed values left and right
[Number of folders] → Number of folders to be displayed.

when

Condition in order for the included elements and texts are displayed. When specifying Ids (without text comparison operators, see below) it is checked if the OneOffixx element with the Id exists and has a content.
For 'or' links the character '|' is used, for 'and' links it is the '+' character.
A mixture of 'and' and 'or' conditions in the same when attribute is not allowed.
For ComboBox elements, the DisplayText is normally used. To access the Value, a $-character must be prepended: <Condition when="$DocParam.ComboBox1 = 'key1'">

CheckBox behavior:
The condition <Condition when="DocParam.CheckBox1" \> is met when the CheckBox has been selected. No comparison operator is needed.

Image behavior:
<Image when="Profile.Org.Logo" ... /> results in either an empty image or the actual image content if the inserted field is present in OneOffixx.

If you want to query whether certain image data is set or "empty" and just "select" an image, you have to go via a direct condition:
<CustomDataNode id="SelectImage">
   <Condition when="Profile. User.Sign">
      <Image id="Profile.User.Sign" />
   </Condition>
   <Condition when="Signer_0. Org.Logo">
      <Image id="Signer_0.Org.Logo" />
   </Condition>
   <Condition when="Signer_1. Org.Logo">
      <Image id="Signer_1.Org.Logo" />
   </Condition>
</CustomDataNode>

notwhen

Analogous to the when attribute, but inverted.

=

The content is compared 1:1.

~

The content is compared case-insensitively and without whitespace.

contains

Checks whether the content contains a certain string (at any position).

startsWith

Checks whether the content starts with certain characters.

length

Compare the number of characters

lengthBiggerThan

Checks whether the number of characters is larger.

lengthLowerThan

Checks whether the number of characters is smaller.

id

Id of the field to be inserted

type

"Text" or "Html" for a fixed content, where the content follows inside a CDATA tag inside the snippet tag: <snippet><![CDATA[Sample text]]></snippet>

when

see Condition

notwhen

see Condition

filter

There are the following filter criteria: "To", "Cc", "Bcc". If "To" is used, only the recipients selected with "To" will be applied.

includeSelected

Determines whether the currently selected contact is also displayed in the list or not: true [default]/false.

separator

Separator text that is always displayed between the elements

type

Determines the list type: always Recipient

id

Id of the field to be used as URI. As mentioned, a fixed link can also be specified as tag content

type

Link type – type of the link. Allowed are: Mailto, XingProfile, TwitterProfile, LinkedInProfile, FacebookProfile
With such a typed link, the general URL is added automatically and only the individual profile name or profile id needs to be specified.

text

Fixed text to be displayed (if different from the URI). It will only be displayed if no binding text is available.

bindingText

Id of the binding element to be displayed as link text

style

CSS style specifications for formatting the HTML link

styleName

Name of a non-built-in style of type "character". The layout template is ideally based on the "hyperlink" layout template.
If the layout template name contains characters that do not correspond to A-Z, a-z, 0-9, or -, they must be omitted.
Examples: protocolheading1$ → protocolheading1, $Ñ0t-Reço/mmen_d3d% → 0t-Reommend3d

when

see Condition

notwhen

see Condition

bindingImage

Id of the image to be displayed, e.g. Profile.User.ProfileImage
Images referenced here must be specified in the Profile data configuration.

imageSize

Height of the image, e.g. 1.8 cm
Must be set.
The width is calculated automatically.
Recommended units: cm, mm, px, pt, in (they are VML units of measure).

imageDataBase64

Data of the image in Base64 format

imageAltText

Alternative text, e.g. "Profile Image"

id

Id of the field to be inserted

when

see Condition

notwhen

see Condition