Form File

1. Description

Component for dynamic pages (forms) of the Agent that displays a container for input/output files in the Workspace.

This component is present in flow types like:

  • Forms.

The block (Fig.1(1)) is used in space to build the Flow. The settings panel for this component opens (Fig.1(2)) when you click on the block.

Fig.1. Form file component

1.1. Form file block

The block consists of the following elements:

  1. The name of the component;
  2. in branch - receiving (connecting with the previous block) branch;
  3. out branch - outgoing (connecting with the following block) branch.

1.2. Form file settings panel

It consists of the following elements:

  1. Id;
  2. View;
  3. Break;
  4. Add limit.

1.2.1. Id

Here you enter the name* (unique within the Flow) – a service name that is not displayed on the page. It is used as a variable for further access to values.

1.2.2. View

It is designed to customize the view (Fig.2).

It consists of the following field:

  1. Initial value;
  2. Label;
  3. ;
  4. Readonly;
  5. Collapsible.

1.2.2.1. Initial value

If the Readonly switch is on:

A variable is called in the Initial value field, into which the attached files from the sheet are set.

You can set such a variable in the Get Email component in the Set variables element: enter attachments in the Value field, and enter the name of the variable that will be called here in the Key field.

For example, in the Get Email component, in the Set variables element, in the Value field attachments was entered, and Files was entered in the Key field. Then enter  ${Files} in the Initial value field.

If the Readonly switch is off:

A variable is called in the Initial value field, into which the files will be set for the sending message.

1.2.2.2. Label

Enter the text that will be displayed as a title above the files in this field (Fig.3.(1)). If the field is left empty, then the container will be without a title (Fig. 2).

You can enter a hint in this field. The tooltip will be displayed when you hover over the  icon (Fig.3.(2)).

The icon will not be displayed if the field is left blank (Fig. 2).

1.2.2.4. Readonly

- displays a container for input files in the Workspace (Fig.2).

Fig. 2. Container for input files in Workspace

Clicking on the button (Fig.2(1)) downloads the input file in ZIP format.

Clicking on the file name (Fig.2(3)) downloads it.

- displays the container for outgoing files in the Workspace (Fig.3).

Clicking on the button (Fig.3.(3)) opens a window for selecting a file to be attached.

Fig. 3. Container for outgoing files in Workspace

1.2.2.5. Collapsible

The switch is responsible for the ability to expand/collapse the block with files:

- the block with files is expanded by default without the ability to collapse (Fig.3);

- the block with files is collapsed by default. It is possible to expand/collapse the block (Fig.2(2)).

- expand the block with text;

- collapse a block with text.

1.2.3. Break

Responsible for the completion of the flow execution.

- initiates the end of the flow execution after the given component.

- the switch is in the off position.

1.2.4. Add limit

It is intended to determine the maximum number of passes through this component.

The failover branch appears in the edited component when the limit is set .

The failover branch will be used if more passes are passed through the component than entered in the Max field.

Clicking on the Add Limit button adds a Max field and a Delete limit button.

The number of possible passes is indicated in the Max field.

Clicking on the Delete limit button removes the limit and returns the Add limit button.

Fig. 3. Setting a limit