Add a Create Form

Use the create form type as the primary input source for a module (that is, the data submitted on a create form is new to Tonkean). In most cases, the submission of a create form starts a module workflow, with the subsequent actions and triggers in the module parsing and using that form data as needed.

  1. From the module builder screen, select the Forms button on the module builder toolbar. The Forms panel displays.

    select_forms_tab.png
  2. In the upper right of the Forms panel, select + New, then select Create Form. The Create Form screen displays, with the Settings tab selected by default.

    select_new_create_form.png

    The Create Form screen is divided into two parts: the configuration panel on the left and the preview panel on the right. As you build and customize your form in the left panel, view the preview panel to get a real-time look at how the form will display.

    create_form_overview.png
  3. Select the title or pencil icon, blue_edit_pencil.png, and enter a descriptive name for the form. The form name must be unique.

    create_form_add_name_png.png
  4. Enter a Form Subtitle and Form Description, if desired. In addition to entering text manually, you can select from existing fields by selecting the insert field button, insert_field.png.These fields can be helpful when building complex forms or where users are completing a long series of sequential forms.

    create_form_subtitle_and_description.png

    Select the toggle below the Form Description field to collapse the description by default.

  5. Enter a Form Description Label, if desired.

    create_form_description_label.png
  6. Depending on the connected Communication Sources, you have the option to define a command that opens the form in a messaging application (Slack or Microsoft Teams, for example). Define that command in the Form Communication Integration Commands field, if relevant.

    1. Select the communication source dropdown to select the application.

      create_form_comm_chan_command_1.png
    2. Enter a command. The command following /tonk must be unique and cannot contain any spaces (for example, /tonk hiring-updates).

      create_form_comm_chan_command_2.png

      You can check what /tonk commands are available in your connected Slack instance by enter /tonk without any additional parameters.

  7. Configure the visual theme and design of the form as it appears in a web browser.

    create_form_web_theme_design.png

The create form is now configured and you can proceed to add the form questions.

Add Form Questions

The process for adding questions to a form varies slightly depending on whether it's a create or update form, and further within the three types of update form (Update Fields, Collect Inner Items, and Upload Files). However, the general workflow is shared by all forms. The steps below walk explain the most common process.

For detailed instructions and considerations for adding questions for the other types of update forms, see the relevant topics:

  1. At the top of the Form screen, select the Builder tab. The Form Questions section displays.

    form_select_builder_tab.png

    Below the Forms Questions section are two columns:

    • Question Title - The question as it appears to the user completing the form.

      We recommend including a value for Question Title, though it's not required. If you don't include a value, Tonkean automatically generates a title in format Created by {Name of user} using '{Form name}' ({Created At (Timezone of user)}), where the user is the person who completed the form.

    • Store value in field - The field where the value entered by the user is stored. The default field value for the first question is "Title", which is a required field that acts as a unique identifier for the item.

      We recommend requiring users to enter their name or unique email address for this field to ensure the item identifier is unique.

    form_builder_fill_in_fields.png
  2. Enter a question in the Question Title field as it should display to the user completing the form.

    form_builder_question_title.png
  3. Select the Store value in field dropdown and select from available fields to store the question value in.

    form_builder_store_in_field.png
    1. Any of the default fields can be used to store form answers, but, depending on your use case, we generally recommend creating a new field to store the answer to each form question. To do this, select New Manual Field from the Store value in field dropdown. The Field Settings screen displays.

      form_builder_create_new_field.png
    2. Create the appropriate field to store the expected value from the form question. See Manual Fields for detailed setup and configuration instructions.

  4. Select the options icon, three_dots.png, to configure any additional options, if desired. This is also where you can delete questions.

    form_builder_question_config.png
  5. Review your form in the preview panel as you work. Select the Preview On dropdown to preview the form on all formats where it might display:

    form_builder_preview_on_dropdown.png

    When finished, select Close in the top right.