Wiki source code of Steckbrief


Show last authors
1 {{content/}}
2
3 The //Form summary// function allows you to create an overview of the most important properties of a form. {{formcycle/}} creates this summary as a PDF document.
4
5 {{figure image="myforms-export-summary-en.png" clear="h1"}}
6 The form summary gives you a quick overview of the form, such as its form elements and workflow configuration. You may also use a template to customize the layout.
7 {{/figure}}
8
9 == Creating a form summary ==
10
11 You can create a summary of a form in the export option. The export option is available in the //My forms// menu (button to the right of the form card) or in the {{designer/}} (more button at the top). This brings up a dialog with the following options:
12
13 ; Language
14 : Select the language for the summary. For example, the summary contains a table with all form elements. The text in the header of this table depends on the chosen language.
15 ; Export template
16 : Template to be used for generating the summary. When no template is selected, the default template included in {{formcycle/}} is used.
17
18 == Using templates ==
19
20 A .doc or .docx file can be used as a template. It must be uploaded either as a [[client>>doc:Formcycle.UserInterface.FilesAndTemplates.Files]] or [[form file>>doc:Formcycle.UserInterface.MyForms.Files]]. First select whether you would like to use a client file or a form file, then select the file to be used.
21
22 == Creating templates ==
23
24 Form summary templates are Word documents that may contain certain form control elements. These control elements are replaced by {{formcycle/}} with the corresponding content – similarly to the [[workflow action Word Fill>>doc:Formcycle.Designer.Workflow.Actions.FillWordDocument.WebHome]]. Otherwise, you are free to customize the content and layout document as required.
25
26 Please note that you need to enable the developer tools in Word to insert or edit form fields. See [[Preparing a Word document>>Formcycle.Designer.Workflow.Actions.FillWordDocument.PreparationWord]] for more details.
27
28 === Content placeholders (form control elements) ===
29
30 The following placeholders are available and can be used to insert various form details into the generated form summary. The placeholder must be inserted as the name of a form control element.
31
32 {{table dataTypeAlpha="0-1" preSort="0-asc" colWidth="-600"}}
33 |=Content|=Placeholder code|=Description and notes
34 |Form title|form_title|Inserts the title (name) of the form.
35 |Preview image of the form|form_preview_image.b64img(450)|Inserts a preview image of the form. Optionally, you may pass the desired width and height in pixels, e.g. {{code language="none"}}form_preview_image.b64img(579~|410){{/code}} (width 579, height 410). When only a width ({{code language="none"}}form_preview_image.b64img(579){{/code}}) or height ({{code language="none"}}form_preview_image.b64img(~|410){{/code}}) is given, the image will be scaled and retain its original aspect ratio.
36 |Form description|form_description|
37 |Number of elements|elements_count|The number of form elements in the form.
38 |Last update|form_update|Date of the last update.
39 |Link to form|form_link.url()|Link to open the form on the master server.
40 {{/table}}
41
42 === Content placeholders (MergeField) ===
43
44 {{figure image="Word_MergeField_english.PNG" clear="h1"}}
45 MergeFields can be added in Word via Insert..Quick Parts..Fields.
46 {{/figure}}
47
48 To insert the following content, the corresponding placeholder must be entered in the Word document as merge field. After inserting a placeholder in a MergeField, it will appear as «//PLACEHOLDER//». The following placeholders may be used and are replaced when the form summary is created:
49
50
51
52 {{table dataTypeAlpha="0-1" preSort="0-asc" colWidth="--600"}}
53 |=Content|=Placeholder|=Description and notes
54 |Workflow|form_workflow_html|An overview of all states and actions present in the current workflow configuration.
55 |Used data sources|form_datasource_html|An overview of all data sources used by the form and its (select) elements.
56 |List of used elements|form_elements_html|An overview of all form elements, including their name, label, alias, (data) type, attributes, and whether they are required fields. This width of the generated table is rather large – we recommend you use this placeholder on a page in landscape format.
57
58 {{/table}}
59
60
61
62
63
64 To insert the following content, the corresponding placeholder must be entered directly in the Word document as plain text (without form control element). The following placeholders may be used and are replaced when the form summary is created:
65
66
67 === Default templates ===
68
69 If no custom template is selected, {{formcycle/}} uses a default Word template to create the form summary. You can download the default template below - it can serve as a starting point for your own templates:
70
71 [[English Word template>>attach:FormPortraitExporterDefaultTemplate_en.docx||rel="__blank"]]
72 [[German Word template>>attach:FormPortraitExporterDefaultTemplate_de.docx||rel="__blank"]]
73 [[Dutch Word template>>attach:FormPortraitExporterDefaultTemplate_nl.docx||rel="__blank"]]