Item repeater

With Item repeater you can display the items of a variable list of an array and edit them in the output variable. Item repeater is only available in Hold In Kiosk.

  • Type: the type of the parameter.
  • (variable) key: the name of the variable that will contain the parameter value. The variable will be addressed in the workflow with this name. You can use dot notation if you want to group single variables into a single object. For example: customer.name, customer.address and customer.telephone will result in one variable customer that is an object with three fields name, address and telephone.
  • Label: the label in the KIOSK interface.
  • Help text: the help text that will appear next to the label.
  • Field options:
    • Required?: if you select this checkbox, the field must be filled in. This will be indicated by an asterisk next to the label in KIOSK.
  • Default: the default value. In this case it is the variable array where you want to repeat the items from.
Value Options
  • Edit: the button to enter the window where you can edit the parameters of the array you want to display in your form.
    • Type: the type of the parameter.
    • (variable) key: the name of the variable that contains the parameter value. For example: customer.name, customer.address and customer.telephone will result in one variable customer that is an object with three fields name, address and telephone.

      If you use an array of objects, it should be like this example: [{value: 8, name: "first"}, {value: 10, name: "second"}, {value: 12, name: "third"}, {value: 14, name: "last"}]. In the item settings, you need to define the parameter of the object you want to use, for example "value" or "name".

    • Label: the label in the KIOSK interface.
    • Help text: the help text that will appear next to the label.
    • Field options:
      • Required?: if you select this checkbox, the field must be filled in. This will be indicated by an asterisk next to the label in KIOSK.
      • Readonly: if you select this checkbox, the field is read only and cannot be filled in.
    Value Options
    • Default: the default value.
    • Text in background: the background text.
    • Pattern: a Regular expressions to force the user to use a specific pattern for the text.
      Note: You can use https://regex101.com as an online regex tester.
      Note: If the KIOSK user uses an expression that doesn't match the pattern, an error is displayed.
    • Pattern Error Message: the error that will be displayed when the text does not correspond to the pattern.
    Style
    • Background color: the background color of the field.
    • Font color: the font color of the text in the field.
Select Go back to return to the general parameters of Item repeater.

Style

  • Background color: the background color of the field.
  • Font color: the font color of the text in the field.

Example

You want to extract the separations of a file and display tinthem in a form in Hold in Kiosk. If needed, the user can change the name of the separations.

This is the workflow:
In Get Meta Data, the Variable name parameter is set to metadata. Consequently, if you run the workflow, the output of Get Meta Data would be something like this:
This means that CLOUDFLOW needs the following notation to extract the separations from the array in the output variable: ${metadata.output_color_space.colorants}.
To configure the form, follow these steps:
  1. Open the parameters in Hold in Kiosk.
  2. Select the pencil next to Kiosk parameters.
  3. Select Add new field and select Item repeater from the drop-down list.
  4. In Value Options > Default, enter ${metadata.output_color_space.colorants} to extract the variables in colorants from the output array.
  5. Select Edit to edit the parameters.
  6. In (variable) Key, enter name, since this is the variable in the array we need to address to extract the name of the separations.
  7. If needed, configure other parameter values such as Label, Help text, Text in background ...
  8. Select Save to save the form.
  9. Select Save to save the parameters in Hold In Kiosk.
  10. If you run the workflow, the result in the form in Hold In Kiosk would be something like this:
  11. If needed, the user can change the name of one or more the color. This will be saved in the output variable of Hold In Kiosk. For example, if the user changes keyline to diecut, this would be the result: