{"type":"doc","content":[{"type":"rule"},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"3"}},"macroMetadata":{"macroId":{"value":"3451b509bd78e6590907b32461f58529"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"57012272-cbf3-482f-8119-7988a484a14c"}},{"type":"rule"},{"type":"paragraph","content":[{"text":"In the document function \"Document Parameter\", the input mask that appears when generating a document can be configured.","type":"text"}]},{"type":"paragraph","content":[{"text":"The configuration can be roughly divided into three parts:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DataNodes: In the \"CustomContentSection\" the fields, so-called DataNode controls, are defined.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"View: In the \"View\" section, the appearance of the document parameters is defined.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DataSources: In \"DataSources\" database queries can be defined and the values can be used from the query.","type":"text"}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Basic structure","type":"text"}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"full-width"}}],"content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Basic structure","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Basic structure with DataSources","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"NOTE","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"If a basic setup is encountered where the Views control is missing: see ","type":"text"},{"text":"Legacy Configuration","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDTEN/pages/61407981"}}]},{"text":".","type":"text"}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"CustomContentSection","type":"text"}]},{"type":"paragraph","content":[{"text":"At the top of the \"DataNodes\" the controls are defined, which are accessed in the \"View\" in the lower part. ","type":"text"}]},{"type":"paragraph","content":[{"text":"In the View the appearance of the document parameter is defined. In the DataSources part, database queries can be defined, and the values from the query can be written to the controls defined under \"DataNodes\".","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Attributes in CustomContentSection:","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"wide","localId":"de4ad6fd-b268-403d-a1a0-f664af4105f0"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[224.0]},"content":[{"type":"paragraph","content":[{"text":"Attribute name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[736.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[224.0]},"content":[{"type":"paragraph","content":[{"text":"Name (Window name)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[736.0]},"content":[{"type":"paragraph","content":[{"text":"Here the name of the Document Parameter dialog window will be defined.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[224.0]},"content":[{"type":"paragraph","content":[{"text":"WindowWidth","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[736.0]},"content":[{"type":"paragraph","content":[{"text":"Here the window width in pixels can be defined. 1200 pixels should not be exceeded, because at this resolution the proper display of OneOffixx should be possible.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[224.0]},"content":[{"type":"paragraph","content":[{"text":"WindowHeight","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[736.0]},"content":[{"type":"paragraph","content":[{"text":"Here you can define the window height in pixels. 1200 pixels should not be exceeded, because at this resolution the proper display of OneOffixx should be possible. The value for ","type":"text"},{"text":"WindowHeigth","type":"text","marks":[{"type":"code"}]},{"text":" must be set (applies for use with and without views). If the content exceeds the defined WindowHeight, a scrollbar will be inserted automatically.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"In contrast to the configuration defined above, in the example below the values of the ","type":"text"},{"text":"WindowWidth","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"WindowHeight","type":"text","marks":[{"type":"code"}]},{"text":" attributes are swapped out to the ","type":"text"},{"text":"Global Configurations","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDTEN/pages/61407710"}}]},{"text":":","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"text":"\n\n \n \n \n \n \n [...]\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Thanks to this outsourcing to the ","type":"text"},{"text":"Global Configurations","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDTEN/pages/61407710"}}]},{"text":" it is ensured that the mentioned information only needs to be changed in one place. Consequently, changes are conveniently applied in all templates that have this link. If a different value needs to be set in the template than the one in the Global Configurations, a different value is simply written in the quotes.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"DataNodes","type":"text"}]},{"type":"paragraph","content":[{"text":"This section is about the configuration between ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":". Each DataNode defines a Document Parameter field that can be accessed in the editor, in scripts or via extended bindings. For each field that exists in the ","type":"text"},{"text":"Views","type":"text","marks":[{"type":"link","attrs":{"href":"#Views"}}]},{"text":", a DataNode must be created for reuse.","type":"text"}]},{"type":"paragraph","content":[{"text":"Basic structure of a DataNode:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Instead of \"control name\" the DataNodes below can be used. The ","type":"text"},{"text":"Id","type":"text","marks":[{"type":"strong"}]},{"text":" is mandatory in every control and is displayed in editor mode and needed afterwards for use in editor, scripts or extended bindings. The Id must not contain spaces and must be unique.","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"NOTE","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"If an Id is duplicated in the DataNodes (NOT in the view!), then the Document Parameter dialog cannot be opened.","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Basic attributes","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The following attributes can be inserted into any type of DataNode:","type":"text"}]},{"type":"table","attrs":{"layout":"wide","localId":"c432dc25-6f8b-4530-9ea1-21cfea63fe74"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[128.0]},"content":[{"type":"paragraph","content":[{"text":"Attribute name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[832.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[128.0]},"content":[{"type":"paragraph","content":[{"text":"Id","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[832.0]},"content":[{"type":"paragraph","content":[{"text":"Is mandatory in every control. It is needed to identify the field, to insert it into the document and for use in scripts or extended bindings. The id must not contain spaces and must be unique.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[128.0]},"content":[{"type":"paragraph","content":[{"text":"Label","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[832.0]},"content":[{"type":"paragraph","content":[{"text":"Label of the control in the OneOffixx function ","type":"text"},{"text":"Quick Check","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDTEN/pages/61407955"}}]},{"text":" panel in Word. The ","type":"text"},{"text":"Tracked","type":"text","marks":[{"type":"code"}]},{"text":" attribute is required.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[128.0]},"content":[{"type":"paragraph","content":[{"text":"Tooltip","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[832.0]},"content":[{"type":"paragraph","content":[{"text":"Hint displayed when the user hovers over it, e.g. ","type":"text"},{"text":"Subject for the letter","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"Overridden by ValidationMessage if set.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[128.0]},"content":[{"type":"paragraph","content":[{"text":"Tracked","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[832.0]},"content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Quick Check","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDTEN/pages/61407955"}}]},{"text":" is activated with the ","type":"text"},{"text":"Tracked","type":"text","marks":[{"type":"code"}]},{"text":". If the value is set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", the field will be displayed to the user in the separate panel. If the content of the control is empty, the field will be displayed red in the panel and green after editing.","type":"text"}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Text","type":"text"}]},{"type":"paragraph","content":[{"text":"Inserted in Word as a Plain Text Content Control. In the view, the Text control can be used to reference a TextBox, a RadioButton, a ComboBox, or a CheckBox. Depending on which of the below controls is used, something different will appear in Word in the text box:","type":"text"}]},{"type":"table","attrs":{"layout":"wide","localId":"94fd2d80-8030-4d27-be9b-ecbc288c860a"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"Defined in the View","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[767.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"TextBox","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[767.0]},"content":[{"type":"paragraph","content":[{"text":"The text entered in the Document Parameter appears in the content control.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"RadioButton","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[767.0]},"content":[{"type":"paragraph","content":[{"text":"Only suitable for scripts and extended bindings; the content control will not be filled.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"CheckBox","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[767.0]},"content":[{"type":"paragraph","content":[{"text":"Only suitable for scripts and extended bindings; the content control will display true (CheckBox enabled) or false (CheckBox disabled).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"ComboBox","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[767.0]},"content":[{"type":"paragraph","content":[{"text":"In the content control is filled what was defined in the ","type":"text"},{"text":"Label","type":"text","marks":[{"type":"code"}]},{"text":" attribute in the view.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Simpel:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Erweitert:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"Einladung","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Content","type":"text"}]},{"type":"paragraph","content":[{"text":"If something is written in between the start and end tag, the entered text is already in the text field when the document is generated. In the extended example e.g. ","type":"text"},{"text":"Invitation","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Attributes for text controls","type":"text"}]},{"type":"table","attrs":{"layout":"wide","localId":"30de0a25-6394-4f98-9846-c5aa61e772e3"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[155.0]},"content":[{"type":"paragraph","content":[{"text":"Attribute name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[805.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[155.0]},"content":[{"type":"paragraph","content":[{"text":"Regex","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[805.0]},"content":[{"type":"paragraph","content":[{"text":"The attribute allows to define a regex (.NET syntax) that must find at least one match in the entered text. Attention: if the whole text must match or if there must be only exactly one 'match', this must be defined by the regex expression.","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Regex=\"[0-9]+\" forces that at least one character of the input text must be a digit. For example, \"Hello 205\" is a valid input.","type":"text"}]},{"type":"paragraph","content":[{"text":"Regex=\"^[0-9]+$\" forces that all characters of the input text must be digits and that at least one digit must be present. (^ matches the beginning of the input text and $ matches the end)","type":"text"},{"type":"hardBreak"},{"text":"Online tool to create regex","type":"text","marks":[{"type":"link","attrs":{"href":"http://regexr.com/"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[155.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[805.0]},"content":[{"type":"paragraph","content":[{"text":"It defines whether the field may be left empty (","type":"text"},{"text":"Required=\"false\"","type":"text","marks":[{"type":"code"}]},{"text":" or not set) or whether the field must be filled in (","type":"text"},{"text":"Required=\"true\"","type":"text","marks":[{"type":"code"}]},{"text":"). As long as the text field is not filled in, the OK button for confirming the input in the Document Parameter remains grayed out and is not clickable. As soon as the required characters are filled in the text field, the OK button can be clicked.","type":"text"},{"type":"hardBreak"},{"text":"The ","type":"text"},{"text":"Required","type":"text","marks":[{"type":"code"}]},{"text":" attribute is overridden by the validation (","type":"text"},{"text":"Regex","type":"text","marks":[{"type":"code"}]},{"text":" attribute) if one is set.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[155.0]},"content":[{"type":"paragraph","content":[{"text":"ValidationMessage","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[805.0]},"content":[{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"Required=\"true\"","type":"text","marks":[{"type":"code"}]},{"text":" or a validation regex is set, ValidationMessage allows a custom error message if validation fails. It will be displayed as soon as the mouse pointer hovers over the red exclamation mark on the right side of the text field. If ValidationMessage is not set, a default message will be displayed in case of a mismatch.","type":"text"}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"DateTime","type":"text"}]},{"type":"paragraph","content":[{"text":"Becomes a Date Picker Content Control in Word with calendar selection, and is also displayed that way in the Document Parameter.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph","content":[{"text":"Simpel:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph","content":[{"text":"Erweitert - fixes Datum vorausgewählt","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"2022-08-15","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph","content":[{"text":"Erweitert - heute + 2 Tage (übermorgen) als vorausgewähltes Datum","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Content","type":"text"}]},{"type":"paragraph","content":[{"text":"If the date is set between the start and end day, it is preselected when opened, such as ","type":"text"},{"text":"2022-08-15","type":"text","marks":[{"type":"code"}]},{"text":" for Thursday, August 15, 2022. If the content is empty, the current date is preselected in each case.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Attribute für DateTime-Elemente","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"913b068a-4ecd-49a6-addb-e7bd7911d700"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"Attribute name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[664.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"Calendar","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[664.0]},"content":[{"type":"paragraph","content":[{"text":"It sets the format of the calendar. Default is \"Gregor\". It is not mandatory to set this attribute.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"Format","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[664.0]},"content":[{"type":"paragraph","content":[{"text":"Definition of the date format e.g. \"dd MM yyyy\" for \"02.06.2016\", ","type":"text"},{"text":"List of date formats","type":"text","marks":[{"type":"link","attrs":{"href":"https://msdn.microsoft.com/de-de/library/8kb3ddd4(v=vs.110).aspx"}}]},{"text":". There are several date formats stored in the Global Translations base configuration that can be accessed.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"Offset","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[664.0]},"content":[{"type":"paragraph","content":[{"text":"Here you can use days to calculate the date ahead, starting from the current date, e.g. using ","type":"text"},{"text":"+2","type":"text","marks":[{"type":"code"}]},{"text":", which means \"today in 2 days\". Another possibility: ","type":"text"},{"text":"-2","type":"text","marks":[{"type":"code"}]},{"text":" for \"today 2 days ago\".","type":"text"},{"type":"hardBreak"},{"text":"This attribute has no effect if a fixed date is preselected via the control content.","type":"text"}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"CheckBox","type":"text"}]},{"type":"paragraph","content":[{"text":"Inserted in Word as a check box content control and is for a yes/no selection.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Simpel:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Erweitert:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"true","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Content","type":"text"}]},{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":" is set between the start and end tags, the CheckBox is already checked when generating.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Attribute für CheckBox-Elemente","type":"text"}]},{"type":"table","attrs":{"layout":"wide","localId":"be477b56-8889-4a07-a8c2-4e1abf713ccf"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[152.0]},"content":[{"type":"paragraph","content":[{"text":"Attribute name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[808.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[152.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[808.0]},"content":[{"type":"paragraph","content":[{"text":"It defines whether the field may be left empty (Required=\"false\" or not set) or whether the field must be filled in (Required=\"true\"). As long as the text field is not filled in, the OK button for confirming the entries in the Document Parameter remains grayed out and is not clickable. As soon as the required characters are filled in the text field, the OK button can be clicked.","type":"text"},{"type":"hardBreak"},{"text":"The ","type":"text"},{"text":"Required","type":"text","marks":[{"type":"code"}]},{"text":" attribute is overridden by the validation (","type":"text"},{"text":"Regex","type":"text","marks":[{"type":"code"}]},{"text":" attribute) if one is set.","type":"text"}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"ComboBox","type":"text"}]},{"type":"paragraph","content":[{"text":"Is inserted into Word as a combo box content control, also called a dropdown. It is for choosing between given values (any input is allowed in Word).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Simpel:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Erweitert:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Content","type":"text"}]},{"type":"paragraph","content":[{"text":"Item","type":"text","marks":[{"type":"code"}]},{"text":" controls can be defined as content. Each item is available to the user as an entry in the combo box. The ","type":"text"},{"text":"Value","type":"text","marks":[{"type":"code"}]},{"text":" of the item is accessed in scripts.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Attribute des ","type":"text"},{"text":"Item","type":"text","marks":[{"type":"code"}]},{"text":"-Elements","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DisplayText","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Display text in Document Parameter dialog and combo box content controls in Word.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generally applies as content of this OneOffixx field, such as when accessed in scripts with ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Used in scripts for conditions when there is ","type":"text"},{"text":"no","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"$","type":"text","marks":[{"type":"code"}]},{"text":" character in front of the id.","type":"text"},{"type":"hardBreak"},{"text":"So in the above example, ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is true.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Value","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Must not be empty – it must contain at least one character. It should not contain spaces or special characters as Word does not accept them.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Used in scripts for conditions when there is a ","type":"text"},{"text":"$","type":"text","marks":[{"type":"code"}]},{"text":" character in front of the Id.","type":"text"},{"type":"hardBreak"},{"text":"In the example above, ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is thus true.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Attribute für ComboBox-Elemente","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"7e1d51f1-764b-4cfc-a996-822d8094ec08"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.0]},"content":[{"type":"paragraph","content":[{"text":"Attribute name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[626.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.0]},"content":[{"type":"paragraph","content":[{"text":"IsEditable","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[626.0]},"content":[{"type":"paragraph"},{"type":"paragraph","content":[{"text":"If set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", the user can also make any entry to the fixed entries. Otherwise the user can only choose between the existing entries.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.0]},"content":[{"type":"paragraph","content":[{"text":"IsSearchEnabled","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[626.0]},"content":[{"type":"paragraph","content":[{"text":"If set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", the user can search for existing entries by keyboard input in the combo box.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.0]},"content":[{"type":"paragraph","content":[{"text":"SelectedValue","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[626.0]},"content":[{"type":"paragraph","content":[{"text":"Determines which item is preselected in the combo box. The ","type":"text"},{"text":"Value","type":"text","marks":[{"type":"code"}]},{"text":" must be entered from the ","type":"text"},{"text":"Item","type":"text","marks":[{"type":"code"}]},{"text":" control, e.g. ","type":"text"},{"text":"employeeAnniversary","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Collection","type":"text"}]},{"type":"paragraph","content":[{"text":"The Collection-DataNode is a function extension of the ComboBox. As the name suggests, a Collection is a collection of values. The difference between the collection of values in a Collection and values in a ComboBox is that the Collection can store complex data structures, while the ComboBox only allows a simple Key → Value mapping. Example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n 1234\n John1\n Doe1\n 0001234567\n Team leader\n \n \n 2234\n John2\n Doe2\n 0003214567\n CFO\n \n \n 4321\n John3\n Doe3\n 0001234876\n CEO\n \n [...]\n \n [...]\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"A collection contains any number of elements, which in turn contain any number of text controls. These text controls are uniquely identified with an id. A Collection serves as the data basis for a ComboBox.","type":"text"}]},{"type":"paragraph","content":[{"text":"Since the Collection stores several values per entries, a corresponding mapping possibility for these values is still needed. For storing the values, the already known DataNodes (in the CustomContentSection) are defined according to the known scheme:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"The naming can be chosen as desired. In this example, the Id was used as a prefix for the sake of clarity. Thus, based on this collection and the DataNodes, the following ComboBox can be defined in the Views:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"The id of the ComboBox is identical to that of the Collection. As with other DataNodes, this establishes the connection between the defined DataNode and the corresponding view element. The ","type":"text"},{"text":"CollectionLabelMember","type":"text","marks":[{"type":"strong"}]},{"text":" specifies which text control of the elements in the Collection should be displayed in the ComboBox for selection, in this example the name of the employee. The ComboBox is displayed in the dialog as follows:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":186,"id":"571fc5bc-cff7-4b84-890c-e146dfd107aa","collection":"contentId-61407823","type":"file","height":120}}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"CollectionSelectionMap","type":"text","marks":[{"type":"strong"}]},{"text":" defines which text of the selected element from the collection (source) is written to which DataNode (target). If an item is selected, the values of the selected item are written to the DataNodes according to the defined CollectionSelectionMap and can then be used according to the known scheme.","type":"text"}]},{"type":"paragraph","content":[{"text":"The complete configuration now looks like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n\t \n\t \n\t \n \n \n \n \n 1234\n John1\n Doe1\n 0001234567\n Team leader\n \n \n 2234\n John2\n Doe2\n 0003214567\n CFO\n \n \n 4321\n John3\n Doe3\n 0001234876\n CEO\n \n \n \n \n \n \n \n Title\n {[DocParam.DefaultImage]}\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n