Skip to main content

Form task

Use the Form task step to have a user or a group fill in a form – text, numbers, dates, choices, records, and tables with several rows – and continue with what they entered. The flow waits until the task is completed – for hours or days if need be. How users, groups, the inbox and the waiting work is described in AutoFlow Tasks.

Typical use cases:

  • A new customer is created from an incoming e-mail; someone from sales adds the payment terms, the salesperson and the credit limit before the flow posts the customer.
  • A purchase invoice arrives without an order; the buyer enters the cost center, the project and a comment, with the invoice PDF shown next to the form.
  • A service report needs its lines: the technician enters the parts used, one row each, and a For each loop creates the item journal lines.

Configure the step​

Description​

The step's label on the canvas – and the subject of the task in the inbox, so name it like the task: Complete customer data.

Instructions​

What the person should fill in, and why – shown above the form. SmartFields are resolved when the task is created.

Assign to, Assignee, Due date​

As for the Selection task: a User or a Task group, the user name or group code (or a SmartField that holds it), and an optional due date or SmartDate. Completing a form task needs an AutoFlow Tasks seat, just like a selection task.

Sections​

Optional. A section groups fields under a heading:

SettingMeaning
Captionthe heading on the task card
Namehow the flow refers to the section; filled in from the caption if you leave it empty
KindNormal – fields one below the other; Repeater – a table the person fills in row by row
Rows fromrepeater only: a list (records or values, for example the results of Find records) – one prefilled row per entry
Add/remove rowsrepeater only: whether the person may add and delete rows; off, the prefilled rows stay as they are

Fields without a section go into a section without a heading at the top of the form.

Fields​

One row per field:

SettingMeaning
Sectionthe section's name; empty = the section at the top
Captionthe label on the task card
Namethe name of the field's output – letters and digits, at most 20 characters; filled in from the caption if you leave it empty
TypeText, Multi-line text, Yes/No, Whole number, Decimal, Date, Date and time, Dropdown or Record
Requiredthe task can only be completed once the field is filled in
PrefillSmartText the field starts with. In a repeater it starts with the section's Rows from, for example {{find_results.Name}}, and is resolved for every row
Valuesdropdown only: the values to choose from, separated by ; or line breaks. An entry that is a SmartField holding a list – for example {{parser_codes}} – adds every value of the list
Own valuesdropdown only: the person may also type a value that is not in the list
Table, Filterrecord only: the table to choose from, and an optional filter on its fields (values may be SmartFields)

A Record field offers the records of its table that match the filter – at most 1,000, looked up when the task is created. The person finds one by typing part of its number or name. To prefill it, use a SmartField that holds a record, such as {{trigger_customer}}.

Preview form​

Preview form shows the form as the person who gets the task will see it – the instructions, the sections and the preview. Try the fields and click Check entries to see whether they would complete the form; nothing is saved. Values from earlier steps and rows from lists are not known yet while you configure the flow; they are filled in when the task is created.

Preview​

Optional. A preview next to the form that follows what the person enters:

  • HTML – HTML with SmartFields. Besides earlier steps' outputs, the form's own fields can be used, named the way later steps see them: {{<step>_<field>}}, for example {{form_customer.Name}} for a record field. A repeater's rows can be shown too – loop over them with {#for {{form_lines}} #}…{{form_lines.item}}…{#endfor#}. Outside a loop, {{form_lines.item}} is the first row; {{form_linesCount}} is the number of rows. While you configure the step, the form's own fields are offered in the SmartField panel and the SmartField picker like the outputs of earlier steps – a repeater with its columns.
  • Document – a reference to an incoming document attachment or an AutoFlow document. It can be one of the form's own record fields, so the preview shows the document the person chose.

An example of a preview that lists a repeater's rows:

<h3>Order for {{form_customer.Name}}</h3>
<table>
{#for {{form_lines}} #}
<tr><td>{{form_lines.item}}</td><td>{{form_lines.quantity}}</td></tr>
{#endfor#}
</table>
<p>{{form_linesCount}} lines</p>

The HTML editor closes tags as you type and indents inside them; Format (or Shift+Alt+F) lays the whole HTML out neatly, {#for#} and {#if#} blocks included.

The task card​

The card shows the instructions, then the sections with their fields and, if configured, the preview to the right. A repeater is a table; with Add/remove rows, + Add row adds a row and ✕ deletes one. Complete checks the required fields first and marks the ones that are empty. A date or number that cannot be read, a dropdown value that is not offered (unless own values are allowed) or a record that is not in the list is refused with a message, and the card stays open.

Opened from the inbox, the card is narrower and shows the preview below the form; Open large shows the preview in the full-size viewer.

Drafts​

A form does not have to be filled in at one go. Save draft keeps what was entered so far – even with required fields still empty – and the task stays open. Closing the card saves the changes as a draft, too. Whoever opens the task next continues from there: the same person later, or a colleague the task was reassigned or delegated to. The status line says who saved the draft and when. Completing the form removes the draft.

Outputs​

OutputContent
<field>every field of a normal section, by its name: a record field is a reference to the chosen record; everything else is a value – true/false, 12, 1.25, 2026-11-02, 2026-11-02T09:30:00
<section>every repeater: its rows – <section> is the first, <section>[0], <section>[1], … are all of them. Each row has the columns as fields, for example {{form_lines.quantity}}
<section>Counthow many rows the repeater has
completedBywho completed the task
taska reference to the task itself

To work with the rows, loop over <section> with a For each loop and read the current row with Read task repeater – its outputs are the columns, ready to pick.