{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"2"},"outline":{"value":"true"},"style":{"value":"default"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"6679b72e-9cc2-4031-87c3-b7521066aab9"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"708b972a-2b56-4d08-ac2d-501ccd6ee1b3"}},{"type":"rule"},{"type":"paragraph","content":[{"text":"This page introduces the ","type":"text"},{"text":"Fields","type":"text","marks":[{"type":"strong"}]},{"text":" document function. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Fields offer the option of making a template dynamic depending on the selected profile, its organisational data, forms fields and more.","type":"text"}]},{"type":"paragraph","content":[{"text":"For the sake of simplicity and to avoid misunderstandings, we will always refer to ","type":"text"},{"text":"fields","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"NOTE","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This page is a ","type":"text"},{"text":"supplement","type":"text","marks":[{"type":"strong"}]},{"text":" to the technical documentation. It explains how to do something and provides more detailed and explained examples than the technical documentation.","type":"text"},{"type":"hardBreak"},{"text":"On the contrary, the technical documentation explains how something is.","type":"text"}]},{"type":"paragraph","content":[{"text":"For a better understanding, we therefore recommend that you follow further links and read the relevant sections.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Attach fields document function in template editor","type":"text"}]},{"type":"paragraph","content":[{"text":"The Fields or Fields document function is added in the template editor by clicking on","type":"text"},{"type":"hardBreak"},{"text":"Document functions → Manage → + Add","type":"text","marks":[{"type":"em"}]},{"text":" in the Fields entry.","type":"text"}]},{"type":"paragraph","content":[{"text":"The standard configuration shows a few example fields","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \"[\" + $(\"Field01\") + \"] [\" + $(\"Field02\") + \"]\"\n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"These text fields should be deleted to start with:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":724,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1255,"id":"f9c4625a-891c-4fb9-9469-4168be08e18b","collection":"contentId-444563473","type":"file","height":799}}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Configure simple field and insert into template","type":"text"}]},{"type":"paragraph","content":[{"text":"We would like to insert a field greeting that displays the text ‘Lorem Ipsum’ in the Word template:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Click on the Editor button in the menu bar or use the key combination ","type":"text"},{"text":"Ctrl+E","type":"text","marks":[{"type":"code"}]},{"text":" to open the template in Word.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":770,"id":"a4b58695-2032-413d-8456-50a917adda6e","collection":"contentId-444563473","type":"file","height":152}}]},{"type":"paragraph","content":[{"text":"In the open Word template, open the primedocs ribbon and then click on the Bind field button.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":742,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1562,"id":"53174037-3161-47b4-aac1-6d078a66e75a","collection":"contentId-444563473","type":"file","height":182}}]},{"type":"paragraph","content":[{"text":"This opens the ‘Select field’ dialogue box. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Select ","type":"text"},{"text":"Greeting ","type":"text","marks":[{"type":"code"}]},{"text":"from the dropdown (in this case, ","type":"text"},{"text":"Greeting","type":"text","marks":[{"type":"code"}]},{"text":" is already preselected as it is the only available field).","type":"text"}]},{"type":"paragraph","content":[{"text":"Click on Insert.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":708,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1056,"id":"911bad6c-d87f-4e66-9e3f-6d348cfb0f64","collection":"contentId-444563473","type":"file","height":412}}]},{"type":"paragraph","content":[{"text":"The field is now inserted.","type":"text"}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"The Fields content controls are ","type":"text"},{"text":"blue","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":520,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":411,"id":"3c03ebfe-94e8-4c99-bd8d-bca05bef311c","collection":"contentId-444563473","type":"file","height":209}}]},{"type":"paragraph","content":[{"text":"Save the Word template.","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Since version 4.0.20093, you no longer have to close and reopen the editor to bind a newly created field :partying_face: The newly created field only needs to be saved in the editor for it to appear in the ‘Select field’ dialogue.","type":"text"}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Return to the template editor and click on ‘","type":"text"},{"text":"Test document","type":"text","marks":[{"type":"strong"}]},{"text":"’ or use ","type":"text"},{"text":"Ctrl+T","type":"text","marks":[{"type":"code"}]},{"text":". Now fill in all the parameters as if you were a user. The document is then generated in test mode.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"(","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PD/pages/19759120/Templating+Basics#Test-document"}},{"text":" )","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"The text ‘Lorem Ipsum’ is now displayed, which we have stored as the value in the field:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":750,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1137,"id":"23822920-ae6e-43db-b0e5-539452c42f0e","collection":"contentId-444563473","type":"file","height":418}}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Information about all field types","type":"text"}]},{"type":"paragraph","content":[{"text":"Before we go into more detail about the different field types, we recommend that you read the following pages of the ","type":"text"},{"text":"technical documentation","type":"text","marks":[{"type":"strong"}]},{"text":" carefully. They form the basis for the application examples that follow for each field type in this chapter:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Description of the document function: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/x/YQapAw"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Description for creating dynamic content using JavaScript (from here on ‘JS’): ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/x/AYCEGg"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Description of the concept request","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"We would particularly like to emphasise the importance of the following chapters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Description of all field types: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/61408865/Fields#Elements"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Which field type can be used in which Office application (Word, Outlook (web), PowerPoint and Excel): ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/61408865/Fields#Overview-of-field-type-per-Office-application"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Which field type requires which return type: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/444891137/Code#Return-value-of-field-types"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All primedocs functions that can be used in JS: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/444891137/Code#Functions"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"How to access which field type in JS: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/444891137/Code#Access-to-fields"}}]}]}]},{"type":"paragraph","content":[{"text":"The following information is supplementary:","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Typ Text","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The text field outputs unformatted text.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A JS function in the text field must have the return value ","type":"text"},{"text":"String","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The formatting must be applied in the Word template using styles - however, this is applied to the entire content in the content control.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If several styles need to be displayed in a field content control in Word, use the ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PD/pages/edit-v2/444563473?draftShareId=a7814e07-a3f0-40b6-8f71-61d0b98ee66a#Typ-FormattedText"}},{"text":" .","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"See the list of all primedocs functions: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/444891137/Code#Explanation-of-all-functions-per-API"}},{"text":" ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"In use","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"JS-Code","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"text":"\n

\n    function main() {\n      // Fields\n      let profileData = $('Profile.User.FirstName'); // Get profile data (implicit, like getText())\n      let field = $.getText('Forms.TextField'); // Get Forms field (a text field, explicitly with getText())\n      let formsField = $.getDateAsString('Forms.Date'); // Get Forms field (a date field)\n      let otherField = $.getText('Page'); // Get another field (must be present in the same config!)\n      \n      // Translations\n      let translation = $.translations.getText('Texts.Enclosures'); // Get unformatted text\n      \n      return $.joinNonEmpty(\"\\n\", profileData, field, formsField, otherField, \" \", translation);\n    }\n

\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Result in Word","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":221,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":221,"alt":"image-20240116-091531.png","id":"669ef71c-8cdb-4a46-98fd-abd0cc44cd69","collection":"contentId-444563473","type":"file","height":243}}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Typ FormattedText","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"TIP","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Read the technical documentation first: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/pages/resumedraft.action?draftId=511934473&draftShareId=cc5e663d-b237-406d-a5eb-8ae0e131ee35"}},{"text":" ","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The field of type FormattedText allows the insertion of formatted text in the following areas: ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Global translation of type Formatted text","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Text module of type Formatted Text","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FormattedText cannot contain tables, tables of contents, images or other complex Word content. WordContent fields are available for this purpose.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A FormattedText field can only return a FormattedText.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The formatting is provided in a global translation using HTML or saved in a FormattedText text module. FormattedText is therefore suitable for mapping more complex logic with different Word styles (often used in letterheads or for lists of inserts).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The most important JavaScript functions:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Code | Functions in detail per API ","type":"text","marks":[{"type":"backgroundColor","attrs":{"color":"#fedec8"}},{"type":"link","attrs":{"href":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/444891137/Code#Explanation-of-all-functions-per-API"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Code | formattedText API","type":"text","marks":[{"type":"backgroundColor","attrs":{"color":"#fedec8"}},{"type":"link","attrs":{"href":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/444891137/Code#formattedText-API"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/444891137/Code#translations-API"}},{"text":" ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FormattedText fields can also use the ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/444891137/Code#Builder-API"}},{"text":" . More on this below: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PD/pages/edit-v2/444563473?draftShareId=a7814e07-a3f0-40b6-8f71-61d0b98ee66a#Builder-(Advanced)"}},{"text":" .","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"FormattedTexts as global translation","type":"text"}]},{"type":"paragraph","content":[{"text":"The advantage of FormattedTexts in the global translations is that you do not have to create a text module but can create the text programmatically with ","type":"text"},{"text":"HTML ","type":"text","marks":[{"type":"strong"}]},{"text":"(see ","type":"text"},{"text":"examples","type":"text","marks":[{"type":"link","attrs":{"href":"https://primesoft-group.atlassian.net/wiki/spaces/PD/pages/edit-v2/444563473?draftShareId=a7814e07-a3f0-40b6-8f71-61d0b98ee66a#Beispiel"}}]},{"text":" below).","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples“Footer“","type":"text","marks":[{"type":"strong"}]}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"The FormattedText is created as a global translation of the type ‘FormattedText’.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Id of our example is ","type":"text"},{"text":"FormattedTexts.FooterBold","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":488,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":738,"alt":"image-20240116-095243.png","id":"b039b960-e636-4913-9b72-45c0d2e2322b","collection":"contentId-444563473","type":"file","height":347}}]},{"type":"paragraph","content":[{"text":"

","type":"text","marks":[{"type":"code"}]},{"text":": one paragraph","type":"text"}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":": bold","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Code","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Access to the global translation text module works like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n $.translations.getFormattedText(\"FormattedTexts.FooterBold\")\n","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Defined Word-Style","type":"text"}]},{"type":"paragraph","content":[{"text":"With the attribute ","type":"text"},{"text":"data-word-style-id","type":"text","marks":[{"type":"code"}]},{"text":" you specify which style a paragraph should have. This makes it possible to output several differently formatted paragraphs in one field. The attribute can also be used in ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"

","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"TIP","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Consult the ","type":"text"},{"text":"developer tools","type":"text","marks":[{"type":"link","attrs":{"href":"https://primesoft-group.atlassian.net/wiki/spaces/PD/pages/19759120/Templating+Basics#Developer-tools"}}]},{"text":" in a created document to find out the available Word styles and their StyleId. How to do this is described here: ","type":"text"},{"text":"Developer tools: Tabs in prioritised order","type":"text","marks":[{"type":"backgroundColor","attrs":{"color":"#fedec8"}}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Control structure (if)","type":"text"}]},{"type":"paragraph","content":[{"text":"A control structure checks whether a condition is fulfilled and outputs the content.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"{{#if bold}}\n

{{bold}}

\n{{/if}}\n{{#if normalbold}}\n

\n{{/if}}\n{{#if empty}}\n

\n{{/if}}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Loop (each)","type":"text"}]},{"type":"paragraph","content":[{"text":"A loop goes through a list and repeats the content for each element in the list.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"{{#each items}}\n

– {{this}}

\n{{/each}}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Field ‘","type":"text"},{"text":"Footer","type":"text","marks":[{"type":"em"}]},{"text":"’ with named parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"In the translation entry, you can create placeholders or parameters in paragraphs (","type":"text"},{"text":"

","type":"text","marks":[{"type":"code"}]},{"text":") in order to fill them with data. Which data is ultimately displayed in these placeholders is defined in the ","type":"text"},{"text":"field using named parameters","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/444891137/Code#Functions-with-named-parameters"}}]},{"text":" with the same name.","type":"text"}]},{"type":"paragraph","content":[{"text":"Definition in the global translations","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Global translation with Id: FormattedTexts.FooterBoldWithParams, with named parameters","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"

Autor: {{firstName}} {{lastName}}, {{function}}

","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"JS-Code","type":"text"}]},{"type":"paragraph","content":[{"text":"Gets the translation of type ","type":"text"},{"text":"FormattedText","type":"text","marks":[{"type":"code"}]},{"text":". Parameters are: Snippet ","type":"text"},{"text":"key","type":"text","marks":[{"type":"code"}]},{"text":" and a list of ","type":"text"},{"text":"named parameters","type":"text","marks":[{"type":"link","attrs":{"href":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/444891137/Code#Functions-with-named-parameters"}}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"text":"\n

$.translations.getFormattedText(\"FormattedTexts.FooterBoldWithParams\", {\n          firstName: $(\"Forms.FirstName\"), // Forms\n          lastName: lastName, // Variable\n          function: \"Doctor\" // Fixtext\n        })\n

\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Field “ReferenceNo”","type":"text"}]},{"type":"paragraph","content":[{"text":"Covers the following contents:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Named parameters","type":"text"},{"type":"emoji","attrs":{"id":"2714","text":"✔️","shortName":":heavy_check_mark:"}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Defined word style","type":"text"},{"type":"emoji","attrs":{"id":"2714","text":"✔️","shortName":":heavy_check_mark:"}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Control structure","type":"text"},{"type":"emoji","attrs":{"id":"2714","text":"✔️","shortName":":heavy_check_mark:"}}]}]}]},{"type":"paragraph","content":[{"text":"Global translation with Id","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"FormattedTexts.Paragraphs.BoldNormalHeader","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"{{#if bold}}\n

\n{{/if}}\n{{#if normal}}\n

\n{{/if}}","type":"text"}]},{"type":"paragraph","content":[{"text":"Field “ReferenceNo”","type":"text","marks":[{"type":"strong"}]},{"text":", which fetches the translation:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"text":"\n

$.translations.getFormattedText(\"FormattedTexts.Paragraphs.BoldNormalHeader\", {\n    bold: $.formattedText.fromText(\"Header_Step\"), // Referenz auf das Text-Field \"Header_Step\"\n    normal: $.formattedText.fromText($(\"Forms.ReferenzNr\")),\n  })

\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Result in Word","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":508,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":508,"id":"fe7788b0-5221-4bb4-bcf1-766cd9007a40","collection":"contentId-444563473","type":"file","height":316}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Field “EnclosuresBox”","type":"text"}]},{"type":"paragraph","content":[{"text":"Covers the following contents:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Defined word style","type":"text"},{"type":"emoji","attrs":{"id":"2714","text":"✔️","shortName":":heavy_check_mark:"}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Control structure","type":"text"},{"type":"emoji","attrs":{"id":"2714","text":"✔️","shortName":":heavy_check_mark:"}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Loop","type":"text"},{"type":"emoji","attrs":{"id":"2714","text":"✔️","shortName":":heavy_check_mark:"}}]}]}]},{"type":"paragraph","content":[{"text":"Global translation with Id","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"FormattedTexts.EnclosuresBox","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"{{#if enclosures}}\n

Beilagen

\n{{#each enclosures}}\n

– {{this}}

\n{{/each}}\n{{/if}}\n{{#if copies}}\n

Kopie an

\n{{#each copies}}\n

– {{this}}

\n{{/each}}\n{{/if}}\n{{#if empty}}\n

\n{{/if}}","type":"text"}]},{"type":"paragraph","content":[{"text":"Field “EnclosuresBox”","type":"text","marks":[{"type":"strong"}]},{"text":", that fetches the translation:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"text":"\n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Result in Word","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":267,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":267,"id":"c3329ce4-5df9-455f-9e2e-400055c2e9a0","collection":"contentId-444563473","type":"file","height":246}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"FormattedText as a Word content","type":"text"}]},{"type":"paragraph","content":[{"text":"As mentioned, text modules of the FormattedText type cannot save tables, images or other complex Word content. For this reason, a FormattedText is only created as a text module and retrieved into a field if it is a ","type":"text"},{"text":"paragraph with text","type":"text","marks":[{"type":"underline"}]},{"text":" that has ","type":"text"},{"text":"one or more styles","type":"text","marks":[{"type":"underline"}]},{"text":".","type":"text"}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"The FormattedText is stored as a text module of the type “Formatted text” and has a key.","type":"text"}]},{"type":"paragraph","content":[{"text":"The key of our example is ","type":"text"},{"text":"FooterFTSnippet","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":193,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":193,"alt":"image-20240116-094938.png","id":"95c82703-33ba-4957-9d6f-9cfab2aafa7a","collection":"contentId-444563473","type":"file","height":96}}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Code","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Accessing to the Word content works like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n $.snippets.getFormattedText(\"FooterFTSnippet\")\n","type":"text"}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Typ WordContent","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The WordContent field allows the dynamic insertion of multiple paragraphs into a template. Together with the Forms document function, more complex templates can be realised and several templates can be consolidated into one.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The paragraphs are either saved in a text module of the WordContent type (see HERE) or output programmatically (see Builder).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A WordContent field can only return WordContent.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The formatting is saved directly in WordContent text modules.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The most important JavaScript functions:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/444891137/Code#Explanation-of-all-functions-per-API"}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDT/pages/398131214/Code#wordContent-API"}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/444891137/Code#translations-API"}}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"WordContent fields can also use ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/444891137/Code#Builder-API"}},{"text":". More on this below: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PD/pages/edit-v2/444563473?draftShareId=a7814e07-a3f0-40b6-8f71-61d0b98ee66a#Builder-(Advanced)"}},{"text":".","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"WordContent-Field ","type":"text"},{"text":"Introduction","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n $.snippets.getWordContent('Introduction'); // Parameter is snippet key\n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"WordContent-Field ","type":"text"},{"text":"ContractTitles","type":"text","marks":[{"type":"em"}]},{"text":" with named parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"You can enter snippet placeholders or parameters in the text module. The data that is ultimately displayed in these placeholders is defined in the field using ","type":"text"},{"text":"named parameters","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/444891137/Code#Functions-with-named-parameters"}}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"with the same name:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n

$.snippets.getWordContent(\"Introduction\", {\n    dateToday: $(\"Forms.Date\"), // Placeholder is filled with Forms field\n    guests: $(\"Guests\")  } // filled with field\n  )

\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Create WordContent snippets","type":"text"}]},{"type":"paragraph","content":[{"text":"Before you can create a WordContent field, you need a WordContent text module: a ","type":"text"},{"text":"snippet of the type Word content","type":"text","marks":[{"type":"strong"}]},{"text":". The three most important points:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In order to store dynamic content (fields, forms, profile data), content control elements, so-called snippet placeholders, are inserted in the corresponding paragraph.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Like all other text modules, WordContent text modules are saved to the desired category in the snippet bar using drag'n'drop.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You need a key to use them in fields.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Insert snippet placeholder","type":"text"}]},{"type":"paragraph","content":[{"text":"So that dynamic text (from fields, forms fields or profile data) can be inserted into a WordContent snippet, we need content controls, so-called ","type":"text"},{"text":"snippet placeholders","type":"text","marks":[{"type":"strong"}]},{"text":". ","type":"text"}]},{"type":"paragraph","content":[{"text":"A text module placeholder can be inserted into a text section in the Word editor of a template, which is then saved as a WordContent text module.","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"The content controls of snippt placeholders are ","type":"text"},{"text":"yellow","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffc400"}}]},{"text":".","type":"text"},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#fff0b3"}}]}]}]},{"type":"paragraph","content":[{"text":"Procedure","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Place the cursor at the desired position in the text section.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the Insert snipet pplaceholder button in the primedocs ribbon.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the name of the placeholder and confirm by clicking on the Insert button.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A yellow content control is then inserted.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"WordContent","type":"text","marks":[{"type":"em"}]},{"text":"-save as a snippet","type":"text"}]},{"type":"paragraph","content":[{"text":"WordContent snippets are saved like all other snippet using drag'n'drop.","type":"text"},{"type":"hardBreak"},{"text":"Watch the demo or read the instructions with all the explanations:","type":"text"}]},{"type":"paragraph","content":[{"text":"Demo","type":"text","marks":[{"type":"strong"}]}]},{"type":"expand","attrs":{"title":"WordContent-Textbaustein abspeichern"},"content":[{"type":"mediaSingle","attrs":{"layout":"center","width":730,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1920,"alt":"SaveWordContentSnippet.mp4","id":"de27ce02-5726-48da-a561-87ef17a251d6","collection":"contentId-444563473","type":"file","height":1032}}]}]},{"type":"paragraph","content":[{"text":"Procedure","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Open the snippet bar by clicking on ","type":"text"},{"text":"snippet ","type":"text","marks":[{"type":"em"}]},{"text":"in the primedocs ribbon.","type":"text"}]},{"type":"paragraph","content":[{"text":"Select the text section and drag and drop it into the ","type":"text"},{"text":"Template snippet","type":"text","marks":[{"type":"em"}]},{"text":" folder in any category.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"ATTENTION","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Make sure that you are in administration mode, because WordContents can only be stored in the ","type":"text"},{"text":"template snippets","type":"text","marks":[{"type":"strong"}]},{"text":". The reason for this is that WordContents are a technical type of text module.","type":"text"}]},{"type":"paragraph","content":[{"text":"The template text modules are only visible to template administrators.","type":"text"}]},{"type":"paragraph","content":[{"text":"Users continue to save their personal text modules as classic OpenXml snippets.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Now customise the properties of the text module to be created:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The name is generated automatically. Adjust it if necessary.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the type ‘Word content’ (WordContent).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter a key (Key).","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"In Fields, only the ","type":"text"},{"text":"key","type":"text","marks":[{"type":"strong"}]},{"text":" of a WordContent is accessed.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Then confirm with OK.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Application example: Invitation","type":"text"}]},{"type":"paragraph","content":[{"text":"A department has several templates for an invitation. Although the invitation text is always the same, two values are different depending on the template. The text is therefore saved as a ","type":"text"},{"text":"WordContent snippet with snippet placeholders","type":"text","marks":[{"type":"underline"}]},{"text":" for greater flexibility.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following text should be displayed at the end of the created document:","type":"text"},{"type":"hardBreak"},{"text":"Invitation to the event ‘[event]’ on [date].","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"event ","type":"text","marks":[{"type":"em"}]},{"text":"and ","type":"text"},{"text":"date ","type":"text","marks":[{"type":"em"}]},{"text":"are dynamic content that we want to query from the user via forms and then display in the text.","type":"text"}]},{"type":"paragraph","content":[{"text":"For this application example, we need","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a snippet with the snippet placeholders and with key","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Forms fields that should later be in the snippet","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a WordContent field that fetches the snippet, fills the parameters with the Forms fields and is later used in the template","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Procedure","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a snippet of type WordContent:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Insert a snippet placeholder with the name EventName.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Insert a second snippet placeholder with the name EventDate.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1297,"id":"7b7e2664-d042-431d-b062-c8c2da757313","collection":"contentId-444563473","type":"file","height":459}}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in Word:","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":250,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":405,"id":"141aa0da-a3b4-42ad-8831-5f4e75a52ec4","collection":"contentId-444563473","type":"file","height":98}}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mark the text section and save it in the desired category:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"as type “Word content","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"set “Invitation” as the key.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":421,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":639,"id":"afc486db-fcc9-4219-8cf1-706a6daa3bd1","collection":"contentId-444563473","type":"file","height":597}},{"type":"caption","content":[{"text":"Properties of the created WordContent text module","type":"text"}]}]},{"type":"paragraph"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create Forms fields in Forms, see ","type":"text"},{"text":"Forms documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://primesoft-group.atlassian.net/wiki/x/SgapAw"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a text field for ","type":"text"},{"text":"EventName","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a date field for ","type":"text"},{"text":"EventDate","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a WordContent field and place it in the template:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The following code shows a WordContent field ","type":"text"},{"text":"InvitationSnippet","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The snippet with the ","type":"text"},{"text":"Invitation ","type":"text","marks":[{"type":"code"}]},{"text":"key is retrieved using the ","type":"text"},{"text":"getWordContent()","type":"text","marks":[{"type":"code"}]},{"text":" function of the Snippet API.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To fill the text module placeholders with content, the data is provided via the ","type":"text"},{"text":"EventName ","type":"text","marks":[{"type":"code"}]},{"text":"and ","type":"text"},{"text":"EventDate ","type":"text","marks":[{"type":"code"}]},{"text":"parameters. These can be filled with all types of text (fixed text, form fields, fields, user data, etc.).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Insert the previously created Forms fields into the parameters:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Forms field ","type":"text"},{"text":"Forms.EventName","type":"text","marks":[{"type":"code"}]},{"text":" is transferred to the snippet placeholder ","type":"text"},{"text":"EventName","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Forms field ","type":"text"},{"text":"Forms.EventDate","type":"text","marks":[{"type":"code"}]},{"text":" is transferred to the snippet placeholder ","type":"text"},{"text":"EventDate","type":"text","marks":[{"type":"em"}]},{"text":". We use the ","type":"text"},{"text":"getDateAsString()","type":"text","marks":[{"type":"code"}]},{"text":" function, as it is a date field that returns a date - but we need a string. More information here: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/edit-v2/444891137#Functions.1"}},{"text":" ","type":"text"},{"type":"hardBreak"}]}]}]}]},{"type":"listItem","content":[{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n

\n    // Snippet of type WordContent with two parameters \"EventName\" and \"EventDate\"\n    $.snippets.getWordContent('Invitation', { \n                              EventName: $('Forms.EventName'), \n                              EventDate: $.getDateAsString('Forms.EventDate') \n    });\n

\n","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Field ","type":"text"},{"text":"InvitationSnippet ","type":"text","marks":[{"type":"code"}]},{"text":"is then inserted into the Word template using the ","type":"text"},{"text":"Bind field","type":"text","marks":[{"type":"link","attrs":{"href":"https://primesoft-group.atlassian.net/wiki/spaces/PD/pages/19759120/Templating+Basics#Bind-field"}}]},{"text":" button in the document and the template is saved.","type":"text"}]},{"type":"paragraph","content":[{"text":"This is the result in Word when you ","type":"text"},{"text":"test the document","type":"text","marks":[{"type":"link","attrs":{"href":"https://primesoft-group.atlassian.net/wiki/spaces/PD/pages/19759120/Templating+Basics#Test-document"}}]},{"text":":","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1030,"id":"fab65c99-ec3a-4d34-9838-bce5dd119f42","collection":"contentId-444563473","type":"file","height":273}},{"type":"caption","content":[{"text":"Content in the WordContent field in the created document (left) and Forms dialogue (right)","type":"text"}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Builder (Advanced)","type":"text"}]},{"type":"paragraph","content":[{"text":"The Builder enables the assembly of Texts, FormattedTexts and WordContents in the sense of a modular system, in which each text, regardless of type, is strung together.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Builder API","type":"text","marks":[{"type":"strong"}]},{"text":" can be used in fields of type WordContent and FormattedText: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/edit-v2/444891137#Builder-API"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"FormattedText-Field ","type":"text"},{"text":"Footer ","type":"text","marks":[{"type":"em"}]},{"text":"with Builder","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"text":"\n

\n    function main() {\n      // Snippet of type FormattedText, parameter is snippet key\n      let ftSnippet =     $.snippets.getFormattedText(\"FooterFTSnippet\");\n      \n      // Translation of type FormattedText, parameter is Id of the translation entry\n      let ftTranslation = $.translations.getFormattedText(\"FormattedTexts.FooterBold\");\n      \n      // Translation of type FormattedText with three parameters ‘firstName’, ‘lastName’ and ‘function’\n      let lastName =      $(\"Forms.LastName\");\n      \n      // Translation of type FormattedText with parameter; parameter is snippet key and a list of parameters\n      let ftAdvanced =    $.translations.getFormattedText(\"FormattedTexts.FooterBoldWithParams\", {\n                            firstName: $(\"Forms.FirstName\"), // Forms\n                            lastName: lastName, // Variable\n                            function: \"Doctor\" // Fixtext\n                           });\n                           \n      // Goal: link all variables created above with Builder: Information about Builder below\n      return $.formattedText\n              .getBuilder()\n              .append(ftSnippet)\n              .append(ftTranslation)\n              .append(ftAdvanced)\n              .build();\n    }\n

\n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Result in Word","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":364,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":470,"alt":"image-20240116-094538.png","id":"3a844da2-d5c5-437f-88bb-4dccb448c777","collection":"contentId-444563473","type":"file","height":123}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"FormattedText-Field ","type":"text"},{"text":"HeaderContact ","type":"text","marks":[{"type":"em"}]},{"text":"with Builder","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"JS-Code","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n

\n    function main(){\n      function main(){\n      let job = $(\"Profile.User.Function\");\n      let name = $.joinNonEmpty(\" \", $(\"Profile.User.Title\"), $(\"Profile.User.FirstName\"), $(\"Profile.User.LastName\"));\n      let address = $(\"Forms.Address\");\n      let refCityDate = $.joinNonEmpty(\"\\n\",\n        $(\"RefNrForm\"),\n        $(\"Profile.User.Postal.City\") + \", \" + $.getDateAsString(\"Forms.Date\"));\n      // Builder\n      return $.formattedText.getBuilder()\n        .append($.translations.getFormattedText(\"FormattedTexts.Paragraphs.NormalBoldHeader\", {\n          bold: \"\", // bold erscheint danach nicht\n          normal: job }))\n        .append($.translations.getFormattedText(\"FormattedTexts.Paragraphs.BoldNormalHeader\", {\n          bold: name,\n          normal: address }))\n        .append($.translations.getFormattedText(\"FormattedTexts.Paragraphs.NormalBoldHeader\", {\n          bold: \"\", // bold erscheint danach nicht\n          normal: \"\\n\" + refCityDate + \"\\n\\n\" }))\n        .build();\n    }\n

\n   function main(){\n      let job = \"\\n\" + $(\"Profile.User.Function\");\n      let name = $.joinNonEmpty(\" \", $(\"Profile.User.Title\"), $(\"Profile.User.FirstName\"), $(\"Profile.User.LastName\"));\n      let addressSnippet = $.snippets.getWordContent(\"AddressSnippet\", {\n        address: $.wordContent.fromText(\"Forms.Address\");\n      });\n      let refCityDate = $.joinNonEmpty(\"\\n\",\n        $(\"RefNrForm\"),\n        $(\"Profile.User.Postal.City\") + \", \" + $.getDateAsString(\"Forms.Date\"));\n      let nameFT = $.translations.getFormattedText(\"FormattedTexts.Normal\", {\n          normal: name });\n          \n      // Builder\n      return $.wordContent.getBuilder()\n        .append($.wordContent.fromText(job))\n        .append($.wordContent.fromFormattedText(nameFT))\n        .append($.snippets.getWordContent(addressSnippet))\n        .append($.wordContent.fromText(\"\\n\" + refCityDate + \"\\n\\n\"))\n        .build();\n    }\n

\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Result in Word","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":222,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":222,"alt":"image-20240815-151146.png","id":"f36fc484-1dcd-4df6-b57a-5e8940667a6c","collection":"contentId-444563473","type":"file","height":223}}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Typ Date","type":"text"}]},{"type":"paragraph","content":[{"text":"See technical documentation: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/61408865/Fields#Date"}},{"text":" ","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"NOTE","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Please note: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/61408865/Fields#Overview-of-field-type-per-Office-application"}},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"The date appears in the format defined in Forms.","type":"text"}]},{"type":"paragraph","content":[{"text":"Click here for more information: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PD/pages/edit-v2/513114113?draftShareId=80b57d2b-c81a-47ab-b7c1-c74d27363d16#Datumsfunktionen-und-mit-Daten-rechnen"}},{"text":" ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Typ YesNo","type":"text"}]},{"type":"paragraph","content":[{"text":"See technical documentation: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/61408865/Fields#YesNo"}},{"text":" ","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The CheckBox content control cannot be inserted into templates: ","type":"text"},{"type":"hardBreak"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/61408865/Fields#Overview-of-field-type-per-Office-application"}},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"A field of type ","type":"text"},{"text":"YesNo","type":"text","marks":[{"type":"code"}]},{"text":" is currently used to use logic in several fields or to make the code clearer.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Simple example","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example, the following condition is checked: If the Forms field is not ","type":"text"},{"text":"null ","type":"text","marks":[{"type":"code"}]},{"text":"(i.e. if it exists), ","type":"text"},{"text":"true ","type":"text","marks":[{"type":"code"}]},{"text":"is output, otherwise ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n $(\"Forms.SignerMain\") !== null\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"More extensive example","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example, several conditions are checked:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n

\n    function main(){\n      let rr = $.translations.getText(\"Staff.RRFunction\"); // get global translation\n      return $(\"HasSignerMain\") ? ($(\"Forms.SignerMain.User.Function\") === rr ? true : false) : false;\n    }\n

\n","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$('HasSignerMain')","type":"text","marks":[{"type":"code"}]},{"text":" is first used to check whether there is a main signatory; the ","type":"text"},{"text":"HasSignerMain ","type":"text","marks":[{"type":"code"}]},{"text":"field returns ","type":"text"},{"text":"true ","type":"text","marks":[{"type":"code"}]},{"text":"or ","type":"text"},{"text":"false ","type":"text","marks":[{"type":"code"}]},{"text":"here.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"$('HasSignerMain')","type":"text","marks":[{"type":"code"}]},{"text":" returns ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", the system checks whether the user field ","type":"text"},{"text":"User.Function","type":"text","marks":[{"type":"code"}]},{"text":" contains the same value as the global translation ","type":"text"},{"text":"Staff.RRFunction","type":"text","marks":[{"type":"code"}]},{"text":". If this is the case, ","type":"text"},{"text":"true ","type":"text","marks":[{"type":"code"}]},{"text":"is returned.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In all other cases, false is returned.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"This means that ","type":"text"},{"text":"SignerIsRegierungsrat","type":"text","marks":[{"type":"code"}]},{"text":" returns ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":" if the user who created the document and is the main signatory is a member of the government.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Typ Picture","type":"text"}]},{"type":"paragraph","content":[{"text":"See technical documentation: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://primesoft-group.atlassian.net/wiki/spaces/PDTEN/pages/61408865/Fields#Picture"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Fields of type ","type":"text"},{"text":"Picture","type":"text","marks":[{"type":"code"}]},{"text":" can be used to bring images into a field. This can be done in two ways:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Via a reference to profile or organisation data","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Via an address to a file (asset)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get signature image of a signatory","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get the logo of an organisation","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get image from the files (asset)","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"

Browser not supported