Field Configuration

Field configuration lets you specify where the values for your fields (including dynamic parameters) should come from, as well as the format in which they appear. You can accept text entry from a user in a form, have the value come from a different component, generate a UUID, select values from a dropdown, etc. Field configuration plays a big part in the logic and operation of your internal tool.  


Note that for forms and pop-up forms, the pre-filled (default) values you set are still editable by a user before submitting. Hidden fields within forms, buttons, and dynamic buttons do not allow user entry (or editing), and in those cases, the pre-filled (default) values you set will be the value used. 


Example: You have a field “userID” which you have configured to be set to a generated UUID.

  • If this field was part of a form or pop-up form, the user would see the generated UUID in the form field and be allowed to edit that pre-filled value (if desired). 
  • If this field was part of the hidden fields in a form, or within a button/dynamic button, the generated UUID (pre-filled value) would be the value set - the user will not be able to edit it. 

Should this field be pre-filled?

This lets you specify where the value for each field should come from. Values must be valid for the field type (integer, string, etc). Options available are dependent on field type or component. 


No, have the user complete the field: This field will be left blank for the user to complete.

  • This option does not appear for buttons and for hidden fields within forms, as those components do not allow the user to manually enter in values.
  • If this field is a dynamic parameter, the value entered by the user will be passed along as the dynamic parameter’s value when calling the function.


Set a custom default value: You can input a value that this field will default to. 

  • For forms and pop-up forms, users can still edit the field to change the value away from the default if they wish. 
  • If the field is a dynamic parameter, the default value (or value edited by user, where permitted) will be passed along as the dynamic parameter’s value when calling the function. 


Pre-fill with a value from a component: You can also choose to get the field’s value from a different component: a filter component or a selected row of a table component. 

  • To get the value from a filter, select the name of the filter component → value. 
  • To get the value from a table, select the name of the table component → selected row → data → column name where the data should come from. When using this tool, users must select a row in the specified table to provide the value for this field. 
  • Note that for forms and pop-up forms, this pre-filled value can still be edited to a different value by the user before submission. 
  • If the field is a dynamic parameter, the value coming from the specified component will be passed along as the parameter value when calling the function (unless edited by a user in a form or pop-up form). 


Set a UUID: This will generate and set a new universally unique identifier as the default value for this field. 

  • This option only appears for certain data types. 
  • For forms and pop-up forms, this UUID can still be edited by the user, if desired. 
  • If this field is a dynamic parameter, this newly generated UUID will be passed along as the parameter value when calling the function (unless edited by a user in a form or pop-up form). 


Set (default) to null: This will leave the field as null (by default).

  • For forms and pop-up forms, users can still enter in a value instead of null (it only defaults to null).
  • If the field is a dynamic parameter, null will be the parameter value passed when calling the function (unless edited by a user in a form or pop-up form). 



Set date and time when form submitted or button clicked: This will set the default value to the current date and time when form is submitted or button is clicked.  

  • Only available for date-time field type. If using a dynamic parameter, make sure you set the dynamic parameter Type to “Date/Time”.  
  • This value can still be edited by the user in forms or pop-up form components. 
  • If the field is a dynamic parameter, the current date/time at submission will be the parameter value passed when calling the function (unless edited by a user in a form or pop-up form). 



What type of form field is this? 

You can specify the format in which your field will appear, like paragraph text or dropdown. The available options will change based on the field type. For example, a String field will have Single line text and Paragraph text options, whereas an integer field will have a Number option. Date/Time fields have their own format and this option will not appear for that field type. 


Additionally, components that do not allow the user to manually enter in values, like buttons or hidden fields in a form, will not show this option.  


Single line text: Select if the form field should be a single line. 


Paragraph text: Select if the form field should be long-form text (multiple lines). 


Number: Select if the form field should be a number. 


Dropdown: Select this to create a dropdown of values that the user can select. 

In the text box, enter in each option in the following format (on its own line): 

DisplayName, ValueSubmitted 

DisplayName is the name that the user will see in the dropdown and ValueSubmitted is the value submitted for this field. You’ll see a preview of your dropdown as you populate options. 


Radio button: Select this to create a set of radio buttons of values that the user can select. Follow the instructions for dropdown above to create your radio button options. 


Blank and null options

Allow this field to be blank: Null, undefined or empty strings are allowed as an input to this field. This applies whether the user leaves the field blank, the prefilled value from another component is blank, or the default value is left blank. 


Treat blank values as null: This will attempt to save empty strings as null values.