Changes for page Formular

From version 1.1
edited by jdr
on 30.07.2021, 14:58
Change comment: There is no comment for this version
To version 1.11
edited by jdr
on 30.07.2021, 17:00
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -29,90 +29,87 @@
29 29  
30 30  == Action bar ==
31 31  
32 -{{figure image="designer_topbar_en_62.png" width="300"}}
33 -The action bar on the top lets you save the form or see a preview of the current form. Click on more to access advanced options such as creating a database query.
32 +{{figure image="designer_topbar_en.png" width="300"}}
33 +The action bar at the top contains actions for saving the form or displaying a preview. More advanced actions are available via the //More// button, such as creating a database source.
34 34  {{/figure}}
35 35  
36 -You can find the action bar at the top of the {{designer/}}:
36 +The action bar at the top contains actions related to the form:
37 37  
38 -; {{ficon name="content-save-all"/}}Save
39 -: Save the current version of the form. This also updates the form immediately: all user who open the form link from now on will see the form as you saved it. You can also use the keyboard shortcut ctrl + s.
40 -; {{ficon name="workflow-fill"/}}Workflow
41 -: View or edit the workflow of the form. The workflow controls what happens after a form was submitted. For example, you can send emails or create PDF documents. See also [[workflow processing>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.WebHome]].
42 -; {{ficon name="share-variant"/}}Publish
43 -: This offers you several options for including the form in your web page. This ranges from a simple standalone link to more complex integrations such as Typo3 and WordPress. See also [[the publish form menu>>doc:Formcycle.UserInterface.MyForms.Publish.WebHome]].
44 -; {{ficon name="play1"/}}Preview
45 -: Open a preview of the current form in a new window. Even when you did not save the form yet, this always shows you the form as you see it in the {{designer/}}. This lets you try out the form first before you save it. Especially useful when you made the form dynamic with conditions for when to hide or show some form elements.
38 +; {{ficon name="content-save-all"/}} Save
39 +: This button can be used to save the current state of the form. The formula will be updated so that the saved state appears when the form is opened. It can also be saved directly using the keyboard shortcut //Ctrl+S//.
40 +; {{ficon name="properties"/}} Elements
41 +: This displays an overview of all form elements in tabular form. Hereby an overview of all elements and their properties can be gained quickly. It is also possible to export this element overview as a CSV or Excel file.
42 +; {{ficon name="share-variant"/}} Publish
43 +: This button provides various options for integrating the form. This ranges from a simple link to call the form, to integration into a web page, to integration into Typo3 and WordPress. See [[the Publish form menu>>doc:Formcycle.UserInterface.MyForms.Publish.WebHome]] for more information on this.
44 +; {{ficon name="undo"/}} Undo
45 +: This button is used to undo the last change made to the form.
46 +; {{ficon name="refresh"/}} Redo
47 +: This button is used to reapply the last change that was undone.
48 +; {{ficon name="play-circle-outline1"/}} Open
49 +: Opens the form in a new tab, unlike the preview mode, the saved form will be opened, i.e. unsaved changes will not be available.
50 +; {{ficon name="play1"/}} Preview
51 +: This button can be used to open a preview of the form. In the preview the form can be tried out. This is especially useful if the form has been designed dynamically, for example by showing and hiding elements under certain conditions.
46 46  
47 -The //More// button lets you access several advanced settings. Most of these settings are also available in the [[form overview page>>doc:Formcycle.UserInterface.MyForms.WebHome]]. The following settings are available:
53 +There are also more advanced settings under the //More// button. Most of these settings can also be made in the [[the form overview>>doc:Formcycle.UserInterface.MyForms.WebHome]]. There are the following menu items:
48 48  
49 -; {{ficon name="play1"/}} Open
50 -: {{html}} {{/html}}
51 -:; {{ficon name="play1"/}} In preview mode
52 -:: Open a preview of the current form in a new window. Even when you did not save the form yet, this always shows you the form as you see it in the {{designer/}}. This lets you try out the form first before you save it. Especially useful when you made the form dynamic with conditions for when to hide or show some form elements.
53 -:; {{ficon name="play1"/}} In live mode
54 -:: Open the form in a new window. In contrast to preview mode, this will the open the form as it is saved in the system. Unsaved changes will not be present.
55 -
56 -; {{ficon name="properties"/}} Element overview
57 -: Opens a new window with a list of all form elements in the current form. This lets you quickly get an overview off all elements and its properties. You can also export the list as a CSV or excel file.
58 -; {{ficon name="lock-open-outline"/}} Lock / unlock
59 -: When many users are working in the system, you may run into troubles when multiple users attempt to edit a form simultaneously. Edits made by one user could be overwritten by another user.
60 -To prevent this from happening, you can lock the form. When a form is locked, all other users are receive a warning when they attempt to save the form
61 -; {{ficon name="lock-open-outline"/}} Files
62 -: Lets you upload arbitrary files. Should be used for files that are required only for this form. For files shared by multiple forms, upload it as a [[client resource>>doc:Formcycle.UserInterface.FilesAndTemplates.Files]]. See also [[form resource files>>doc:Formcycle.UserInterface.MyForms.Files]].
63 -; {{ficon name="user-doi"/}} Double opt-in
64 -: If necessary, lets you setup a double opt-in process for the form. When a user enters some data and submits the form, they are sent an email and are asked to confirm their submission. Until they do, the submitted data is not processed further in any way. See also [[double opt-in>>doc:Formcycle.UserInterface.MyForms.DoubleOptIn.WebHome]].
55 +; {{ficon name="formycle-form"/}} Form
56 +: This opens the form tab in the designer and the form can be configured.
57 +; {{ficon name="workflow-fill"/}} Workflow
58 +: This opens the workflow tab in the designer and the workflow of the form can be configured. The workflow controls what happens after the form has been submitted. For example, emails can be sent or PDF form can be generated here. See [[Workflow>>doc:Formcycle.Designer.Workflow.WebHome]] for more information.
59 +; {{ficon name="content-save-settings"/}} Files
60 +: Here files can be uploaded, which are only needed for this form. See also [[Files>>doc:Formcycle.UserInterface.MyForms.Files]]
65 65  ; {{ficon name="user"/}} Access
66 -: Here you can change several settings related to form permissions. For example, you can add a password for opening the form, or change which user groups may edit the form. See also [[access settings>>doc:Formcycle.UserInterface.MyForms.Access]].
67 -; {{ficon name="inbox"/}} Inbox
68 -: Lets you change the [[inbox>>doc:Formcycle.Inbox.WebHome]] for submitted forms. You can also modify which columns are show in the form-specific inbox. See also [[inbox settings>>doc:Formcycle.UserInterface.MyForms.Inbox]].
62 +: This menu item contains various settings for form permissions. For example, you can set whether the form should only be accessible with a password or which user groups are allowed to edit the form. See also [[Access Settings>>doc:Formcycle.UserInterface.MyForms.Access]].
63 +; {{ficon name="inbox"/}} Mailbox
64 +: Here you can set in which mailbox sent forms are to be found in the [[Inbox>>doc:Formcycle.Inbox.WebHome]]. Furthermore, it is also possible to specify which values of form elements are displayed in the mailbox. See also [[Inbox settings>>doc:Formcycle.UserInterface.MyForms.Inbox]].
69 69  ; {{ficon name="table-large"/}} Data table
70 -: The data table is an advanced options that allows you to create your own database table for submitted form data. See also [[data table settings>>doc:Formcycle.UserInterface.MyForms.DataTables]].
66 +: The data table is an advanced facility and allows you to create your own database tables for form data. See also [[DataTable>>doc:Formcycle.UserInterface.MyForms.DataTables]].
71 71  ; {{ficon name="clock-outline"/}} Versions
72 -: A list of all versions of the form. You can add a version and delete or export existing versions. See also [[form versions>>doc:Formcycle.UserInterface.MyForms.Versions]].
68 +: All versions of the form can be viewed and managed here. It is also possible to create a new version or export existing ones. See also [[Form versions>>doc:Formcycle.UserInterface.MyForms.Versions]].
73 73  ; {{ficon name="information-outline"/}} Info
74 -: An overview with some technical details for the form, such as its ID or the date when it was created.
70 +: Short overview of some technical information about the form, like its ID or creation date.
75 75  
76 -; {{icon name="download"/}} Export {{version major="6" minor="2" patch="0"/}}
77 -: {{html}} {{/html}}
78 -:; {{ficon name="shredder"/}} Word / PDF Export
79 -:: The form can be exported here as a static Word or PDF document. See also [[Word / PDF Export>>doc:Formcycle.UserInterface.MyForms.Export.Blank]].
80 -:; {{ficon name="shredder"/}} Form summary
81 -:: A profile with an overview of the most important properties of a form can be created here. See also [[Form summary>>doc:Formcycle.UserInterface.MyForms.Export.Summary]].
72 +; {{ficon name="date"/}} Schedules
73 +: Here schedules can be created and edited. See also [[Appointment Management>>doc:Formcycle.UserInterface.Appointments.WebHome]]
82 82  
83 -; {{ficon name="date"/}} Schedules {{version major="6" minor="5" patch="0"/}}
84 -: Schedules can be created and edited here. See also [[Appointment managment>>doc:Formcycle.UserInterface.Appointments.WebHome]].
85 -
86 -; {{ficon name="file-blank"/}} Templates {{version major="6" minor="6" patch="0"/}}
75 +; {{ficon name="file-blank"/}} Templates
87 87  : {{html}} {{/html}}
88 -:; {{ficon name="file-css-blank"/}} Design (CSS)
89 -:: CSS templates can be configured here, which offer the possibility to define global //CSS// rules that can be used by all forms. See also [[Design (CSS)>>doc:Formcycle.UserInterface.FilesAndTemplates.Design.WebHome]].
90 -:; {{ficon name="file-html-blank"/}} HTML
91 -:: HTML templates for [[response pages>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.ResponsePage.WebHome]], [[privacy policy>>doc:Formcycle.FormDesigner.FormElements.Footer||anchor="HPrivacypolicy"]] or the [[imprint>>doc:Formcycle.FormDesigner.FormElements.Footer||anchor="HImprint"]] can be created and edited here. See also [[HTML templates>>doc:Formcycle.UserInterface.FilesAndTemplates.HTML.WebHome]].
77 +:; {{ficon name="file-css-blank"/}} CSS templates
78 +:: CSS templates can be set up here, which provide the ability to define global //CSS// rules that can be used by all forms. See also [[CSS-Templates>>doc:Formcycle.UserInterface.FilesAndTemplates.Design.WebHome]]
79 +:; {{ficon name="file-html-blank"/}} HTML templates
80 +:: HTML templates can be created and edited here, for example for [[Closing Pages>>doc:Formcycle.Designer.Workflow.Actions.HtmlResponsePage]], [[Privacy Statement>>doc:Formcycle.Designer.Form.FormElements.Footer||anchor="HDrpfschutzerklE4rung"]] or the [[Imprint>>doc:Formcycle.Designer.Form.FormElements.Footer||anchor="HImpressum"]]. See also [[HTML templates>>doc:Formcycle.UserInterface.FilesAndTemplates.HTML.WebHome]]
92 92  
93 -; {{ficon name="database"/}} Data sources
82 +; {{ficon name="database"/}} Sources
94 94  : {{html}} {{/html}}
95 95  :; {{ficon name="database-search"/}} Database queries
96 -:: Here you can view or edit SQL queries for custom databases. See also [[database queries>>doc:Formcycle.UserInterface.Data.DBQueries]].
85 +:: New queries to SQL databases can be set up here. See also [[database-queries>>doc:Formcycle.UserInterface.Data.DBQueries]].
97 97  :; {{ficon name="account-search"/}} LDAP queries
98 -:: Here you can view or edit LDAP queries for custom active directories. See also [[LDAP-Abfragen>>doc:Formcycle.UserInterface.Data.LDAPQueries]].
99 -:; {{ficon name="table-large"/}} Sources
100 -:: Add a datasource with static CSV, XML or JSON data, such as a list of city names or ZIP codes. It is possible to import EXCEL files as well. You can then use this data in the form, such as with [[select elements>>doc:.FormElements.Selection]]. See also [[Sources>>doc:Formcycle.UserInterface.Data.Sources]].
87 +:: New queries can be set up here using LDAP. See also [[LDAP queries>>doc:Formcycle.UserInterface.Data.LDAPQueries]].
88 +:; {{ficon name="table-large"/}} Data sources
89 +:: Static data sources can be stored here, such as lists of cities or postal codes. These lists can then also be used in the form, for example as selection options of [[selection fields>>doc:Formcycle.Designer.Form.FormElements.Selection]]. See also [[source>>doc:Formcycle.UserInterface.Data.Sources]]
101 101  
102 102  ; {{ficon name="lan-connect"/}} Connections
103 103  : {{html}} {{/html}}
104 -:; {{ficon name="database-gear"/}} Database connections
105 -:: To run a database query, you first need to configure a connection to a database. This menu entry lets you do that. See also [[database connections>>doc:Formcycle.UserInterface.Data.DBConnections]].
106 -:; {{ficon name="user"/}} LDAP connection
107 -:: To run an LDAP query, you first need to configure a connection to an active directory. This menu entry lets you do that. See also [[LDAP connections>>doc:Formcycle.UserInterface.Data.LDAPConnections]].
93 +:; {{ficon name="database-gear"/}} DB connections
94 +:: Before database queries can be set up, a connection to the corresponding database must be established. This can be done via this menu item. See also [[DB Connections>>doc:Formcycle.UserInterface.Data.DBConnections]].
95 +:; {{ficon name="user"/}} LDAP connections.
96 +:: Before LDAP queries can be set up, a connection to the appropriate LDAP server or AD must be set up. This can be done via this menu item. See also [[LDAP Connections>>doc:Formcycle.UserInterface.Data.LDAPConnections]]
108 108  
109 -; {{ficon name="action-download-file"/}} Local backups
98 +; {{icon name="plus"/}} Counter
99 +: Here [[Counter>>Formcycle.UserInterface.Data.Counter]] can be created and configured. These can be used, for example, by the [[Modify Counter>>doc:Formcycle.Designer.Workflow.Actions.ModifyCounter]] action in the workflow.
100 +
101 +; {{icon name="download"/}} Export
110 110  : {{html}} {{/html}}
111 -:; {{ficon name="folder"/}} Load local backup
112 -:: Download the current form as file to your computer. You can use this as an additional backup mechanism, or to share forms with other people. Please note that this only exports the form itself, not the workflow or upload files. To export the entire form with the workflow and all files,[[use the form export>>doc:Formcycle.UserInterface.MyForms.Export.WebHome]].
113 -:; {{ficon name="download-network"/}} Save local backup
114 -:: Upload a form saved on your computer. This replaces the current content of the {{designer/}} with the form you select here.
103 +:; {{ficon name="shredder"/}} Form Export
104 +:: Here you can export a web form or workflow as a JSON file.
105 +:; {{ficon name="shredder"/}} Word / PDF export
106 +:: Here the form can be exported as a static Word or PDF document. See also [[Word / PDF export>>doc:Formcycle.UserInterface.MyForms.Export.Blank]]
107 +:; {{ficon name="shredder"/}} Form summary
108 +:: Here you can create a profile with an overview of the most important properties of a form. See also [[form summary>>doc:Formcycle.UserInterface.MyForms.Export.Summary]]
115 115  
110 +; {{icon name="upload"/}} Import
111 +: Here a web form or workflow can be imported as a JSON file.
112 +
116 116  == Form preview ==
117 117  
118 118  Die Formularvorschau in der Mitte ist der Hauptteil des {{designer case="gen"/}}. Hier ist das Formular immer so zu sehen, wie es auch später aussieht. Formularelemente können direkt von der Elementleiste links in das Formular gezogen werden. Alle Änderungen an den Eigenschaften des Formulars im Eigenschaftsbereich rechts haben sofort Auswirkung auf die Formularvorschau.
... ... @@ -150,7 +150,7 @@
150 150  ; Advanced
151 151  : Available only when a form element is selected: Contains some less common properties, such as user group and state-based restrictions or HTML attributes. See also the [[element properties>>doc:.ElementProperties.WebHome]] and [[the list of form elements>>doc:.FormElements.WebHome]].
152 152  ; Form
153 -: This tab is always and lets you edit the settings of the current form, such as its name, width, or layout. See also [[form properties>>doc:Formcycle.FormDesigner.FormProperties]].
150 +: This tab is always and lets you edit the settings of the current form, such as its name, width, or layout. See also [[form properties>>doc:Formcycle.Designer.Form.FormProperties]].
154 154  ; Default
155 155  : Available only when a form element is selected: Contains the default settings for each element type. When you place a new element in the form, the new elements gets these properties. For example, you could change the default settings so that all input fields are required fields by default.
156 156  
... ... @@ -165,13 +165,13 @@
165 165  This is an advanced section that lets you customize your form even further. Click on the arrow [[image:designer_south_pane_expander.png]] to the bottom of the {{designer/}} to open it. This section consists of four different tabs:
166 166  
167 167  ; JavaScript tab
168 -: Write your own custom JavaScript logic to make the form work the way you want. The JavaScript you write in this tab is run automatically once the form is done loading, ie. [[when the document is ready>>url:https://api.jquery.com/ready/||target="_blank"]]. All JavaScript files uploaded as a [[form resource >>doc:Formcycle.UserInterface.MyForms.Files]] are included automatically in the form (but are run as soon as possible, if necessary, wait for the document to finish loading). Depending on your use case, you may want to extract some parts of your JavaScript into a separate files, especially utility functions and libraries that do not need the DOM to be loaded fully. This cleans up your JavaScript code and makes it easier to understand. For more in-depth details, see the [[JavaScript tab>>doc:Formcycle.FormDesigner.CodingPanel.WebHome]].
165 +: Write your own custom JavaScript logic to make the form work the way you want. The JavaScript you write in this tab is run automatically once the form is done loading, ie. [[when the document is ready>>url:https://api.jquery.com/ready/||target="_blank"]]. All JavaScript files uploaded as a [[form resource >>doc:Formcycle.UserInterface.MyForms.Files]] are included automatically in the form (but are run as soon as possible, if necessary, wait for the document to finish loading). Depending on your use case, you may want to extract some parts of your JavaScript into a separate files, especially utility functions and libraries that do not need the DOM to be loaded fully. This cleans up your JavaScript code and makes it easier to understand. For more in-depth details, see the [[JavaScript tab>>doc:Formcycle.Designer.Form.CodingPanel.WebHome]].
169 169  ; CSS tab
170 -: Customize the layout and look of your form by adding your own hand-crafted CSS. As with JavaScript, you can also upload CSS files as a form resource, these are loaded automatically as well. See also the help page on the [[CSS tab>>doc:Formcycle.FormDesigner.CodingPanel.CSSTab.WebHome]].
167 +: Customize the layout and look of your form by adding your own hand-crafted CSS. As with JavaScript, you can also upload CSS files as a form resource, these are loaded automatically as well. See also the help page on the [[CSS tab>>doc:Formcycle.Designer.Form.CodingPanel.CSSTab.WebHome]].
171 171  ; Metadata
172 -: The text you enter in this tab is included in the HTML header of the form. This lets you, among other things, add your own meta attributes for search engine optimization. Or you can include some additional script, CSS or font files. See also the [[meta tab>>doc:Formcycle.FormDesigner.CodingPanel.MetaTab]].
169 +: The text you enter in this tab is included in the HTML header of the form. This lets you, among other things, add your own meta attributes for search engine optimization. Or you can include some additional script, CSS or font files. See also the [[meta tab>>doc:Formcycle.Designer.Form.CodingPanel.MetaTab]].
173 173  ; Variables
174 -: Variables are hidden input fields added to the form. Often they are used with JavaScript to store the result of certain computations and make these available for further processing. See also the [[variables tab>>doc:Formcycle.FormDesigner.CodingPanel.VariablesTab]].
171 +: Variables are hidden input fields added to the form. Often they are used with JavaScript to store the result of certain computations and make these available for further processing. See also the [[variables tab>>doc:Formcycle.Designer.Form.CodingPanel.VariablesTab]].
175 175  
176 176  == Language and version ==
177 177  
... ... @@ -179,5 +179,5 @@
179 179  
180 180  You can find the language and version settings to the bottom right of the {{designer/}}:
181 181  
182 -* The default language of the form is what you enter when you first create the form. Form elements have got many properties, some of which are functional, such as whether it is a required field. Some properties are language-dependent, such as the label text or the placeholder. You can translate these language-dependent properties into different languages to make your form international. To do so, click on the language in the toolbar at the bottom and switch to the language you would like to edit. This hides all functional properties and only shows those properties that need to be translated. see also [[internationalization>>doc:Formcycle.FormDesigner.Internationalization]].
179 +* The default language of the form is what you enter when you first create the form. Form elements have got many properties, some of which are functional, such as whether it is a required field. Some properties are language-dependent, such as the label text or the placeholder. You can translate these language-dependent properties into different languages to make your form international. To do so, click on the language in the toolbar at the bottom and switch to the language you would like to edit. This hides all functional properties and only shows those properties that need to be translated. see also [[internationalization>>doc:Formcycle.Designer.Form.Internationalization]].
183 183  * Each time you save the form, the system creates a backup automatically. Click on the version in the toolbar at the bottom to switch to an older backup version of the form.