List multi-selection input

A list multi-selection input control is used when it should be possible to choose more than one record in a list. It can also be left with no chosen value.

If a barcode scanner is employed in a list multi-selection input, the Flow Client will search the data source for a record where the Key field matches the scanned value and select the corresponding line in the list. If no match is found, the Flow Client will attempt to match the scanned value with the other fields in the data source and select the first line where a match is found.

  • Target Variable The name of the new variable(s) to store the selected records. The output variable type will be a table.

  • Source

    • Variable - Select the table that will serve as the data source for the list.

    • Expression - Write the FlowScript expression that will serve as the data source for the list. You can add conditions based on target variables for controls within the User step. If variables within the user step are used in the condition, ensure that Allow Dependencies is set to true for the user step. The user step must allow dependencies for this functionality to work properly.

      Example:

      {customer where CompanyId = selectedCompany}
  • Default Selection Utilize FlowScript to perform a default selection of values. Example:

    {objectStatus = 3}
  • Prompt The label to be displayed at the top of the list.

  • Large Text Enter text and variables to be displayed in the list (this can be left empty, but note that either large or small text needs to be configured to show something in the list). Use {} to access a list of available variables from the source table.

  • Small Text Enter text and variables to be displayed in the list (this can be left empty, but please note that either large or small text needs to be configured to show something in the list). Use {} to access a list of available variables from the source table.

  • Image Enter the variable containing binary files (JPEG, PNG, or WEBP) for images to be displayed in the list.

  • Group Rows By If the list should be grouped, select a column from the source table to group the list by. Set to "None" not to group the list.

  • Item Style Utilize a case statement to determine the color that the columns should have. Example:

    {case
        when Id = '1' then '#15A9E1'
        when Id = '2' then RGB(146,147,149)
        when Id = ‘3' then 'YELLOW'
        else '' 
    end}

    Colors: Set the color using the FlowScript RGB function followed by the RGB code or use a HEX code for the color. Additionally, you can use predefined colors from the fixed color palette: GREEN, RED, YELLOW, BLUE, and PURPLE.

  • Inline Option

    Configure whether the list should open directly in the user step or not.

    • Automatically - the list is open or closed depending on size and user step content, see List selection and list multi-selection.

    • Open - the list will always open inline.

    • Closed - the list will always be closed in the user step and the user must click to open it.

  • Show Automatically If set to True, the list will open directly when the user enters the user step (only in mobile clients). This allows the user to select from the list immediately without having to manually open the list, thereby enhancing the user-friendliness of the app.

  • Condition To Hide

    Specify the condition that must be fulfilled for the control to be hidden. If left unspecified, the control will remain visible in the user step. Note that when controls are hidden, empty variables will be generated unless default values or pre-defined data exist.

  • Reloading

    The control behavior at reloading, see User step reloading.

Last updated