Show last authors
1 {{content/}}
2
3
4 {{figure image="Invite0.PNG" clear="h1"}}
5 Open the form menu and select //Publish// to open the dialog with the //Invite// option.
6 {{/figure}}
7
8 == Overview ==
9
10 This feature lets you create multiple form records at once, with data taken from a [[CSV data source>>doc:Formcycle.UserInterface.Data.Sources]]. Optionally, you can also send send an invitation email for each form record with a link to the newly created form record. The CSV data source with all information that should be used can be selected in the invitation dialog. The number of invitations that can be created at once depends on the [[license>>doc:Formcycle.SystemSettings.UserInterface.License]].
11
12 When you click the send button to start, a form record is created for each selected row in the data source. If configured, the form is prefilled with the data from the data source. Then, the form record is put into the chosen [[target state>>doc:Formcycle.Designer.Workflow.States]]. Once the form record was created successfully, an email is sent to the email in the current row of the data source. The email may contain a link to the created form record that lets the recipient open the form, edit it and submit it. As the link contain a generated UUID, nobody without the link can open or view the form record.
13
14 == Configuration ==
15
16 To start, you need at least one [[CSV data source>>doc:Formcycle.UserInterface.Data.Sources]] in the backend. We recommend you to use a header for each column, as that makes it easier to identify what each column represents. The invitation can be configured via various required and optional settings. The dialog is divided into four parts:
17
18 === Data source ===
19
20 {{figure image="Invite_1.PNG"}}
21 A new form records is created for each row of the selected data source. Optionally, you can prefill the form with the data from the data source or send emails.
22 {{/figure}}
23
24 ; Data source (.csv)
25 : All existing [[CSV data sources>>doc:Formcycle.UserInterface.Data.Sources]] are listed here. Select the data source which you would like to use.
26 {{info}}Please note that when the data source is changed, some settings (e.g. the //E-mail to// field) will be reset to a default value.{{/info}}
27 ; From (row)
28 : By default, all rows from the data source are used. If you only want to use a subset of row, select the starting row here.
29 ; Number of entries
30 : By default, all rows from the data source are used. If you only want to use a subset of row, select the numbers of rows here. The maximum number may be restricted by your license.
31
32 Once you have selected a data source, a preview of the selected range of rows is shown below. The preview only shows the first and last selected row.
33
34 === Email configuration ===
35
36 {{figure image="Invite_2.PNG"}}
37 You can send an email for each newly created form record. Use the variable //[%$FORM_INVITE_LINK%]// to insert a link to the form.
38 {{/figure}}
39
40 ; Send an invitation email to each person in the above data source
41 : Activate this option to send an email for each created form record. The email address is taken from one of the columns of each row of the data source, see below.
42 ; Email to (column in data source)
43 : Select the column of the data source that contains the email addresses.
44 ; Email from
45 : Specify the sender address of the email.
46 ; Sender name
47 : Specify the name of the sender of the email.
48 ; Subject
49 : Specify the subject of the invitation email.
50 ; Message
51 : The main message (body) of the email. This should contain a link to the form record. You can insert it the link with the following [[variable>>doc:Formcycle.UserInterface.Variables.WebHome]] //[%$FORM_INVITE_LINK%]//.
52
53 === Prefill form ===
54
55 {{figure image="Invite_3.PNG"}}
56 The form may be prefilled with data from the data source. For example, you could enter the email address of the recipient into a form field.
57 {{/figure}}
58
59 ; Prefill form fields
60 : Activate this option to prefill the newly created form record with the data from the data source.
61 ; Data mapping table
62 : Here you can choose a value for each form field. Select the form field to prefill in the first column. Enter the value for the form field in the second column. To insert a value from the data source, use a [[variable>>doc:Formcycle.UserInterface.Variables]] with the following format:
63
64 * //[%$data.COLUMNNAME%]// (if the CSV data source has named headers), or
65 * //[%$data.col1%]// (if it does not have named header).
66
67 : If you decide later you do not want to prefill a certain form field, click the {{icon name="trash"/}} recycle bin icon to delete the mapping.
68
69 === Target state ===
70
71 {{figure image="Invite_4.PNG"}}
72 When no target state is set, the newly created form records are shown as //saved// in the inbox.
73 {{/figure}}
74
75 If required, you can select an initial [[state>>doc:Formcycle.Designer.Workflow.States]] for the form record. In case you do not select a state here, the newly created form record will only marked as //saved// in the [[inbox>>doc:Formcycle.Inbox.WebHome]].
76
77 ; Assign a target state to all form records created without error.
78 : Activate this option and select a state for the form record that is used when the form record was created successfully.
79 ; Assign a target state to all form records created unsuccessfully.
80 : Activate this option and select a state for the form record that is used when the an error occurred while the form record was created.
Copyright 2000-2021