{"id":29515,"date":"2021-08-11T13:40:58","date_gmt":"2021-08-11T12:40:58","guid":{"rendered":"https:\/\/multisite.korebots.com\/v9-0\/?p=29515"},"modified":"2021-08-12T18:41:12","modified_gmt":"2021-08-12T17:41:12","slug":"digital-form","status":"publish","type":"post","link":"https:\/\/multisite.korebots.com\/v9-0\/docs\/process-apps\/flow\/triggers\/digital-form\/","title":{"rendered":"Digital Form"},"content":{"rendered":"

A Digital Form helps you to collect the required data. It allows your users to enter the data you want to process a certain request. Digital Form triggers refer to the triggers that occur through the submission of a digital form. For example, let us consider an <\/span>employee expense report<\/span><\/i>. An employee has submitted an expense report of $1000. After the submission, the system fetches the user-related information through an API request and follows the approval process. In this scenario, the system uses the API request. The process flow of the Digital Form Trigger is explained below.<\/span><\/p>\n<\/div><\/div>

<\/div><\/div>

Configure Digital Form Trigger<\/strong><\/h4>\n
    \n
  1. After you log in to the Process App, it lands you on the <\/span>Flow <\/b>tab.<\/span><\/li>\n
  2. On the right pane, click <\/span>Digital Form<\/b> under <\/span>Triggers<\/b>.<\/span><\/li>\n
  3. On the <\/span>Digital Form Trigger <\/b>window, select <\/span>Create New Form<\/b> from the <\/span>Forms <\/b>drop-down list.<\/span><\/li>\n
  4. On the New Form dialog box, enter the following details:<\/span>\n
      \n
    1. Name – Enter a name for the digital form. For example, Expense Report<\/span><\/li>\n
    2. Display Name – Enter a display name to easily identify the name.<\/span><\/li>\n
    3. Description<\/span> – Enter a short description of the digital form<\/span><\/li>\n<\/ol>\n<\/li>\n
    4. Click <\/span>Create<\/b>.<\/span><\/li>\n
    5. On the <\/span>Digital Form Trigger <\/b>window, click <\/span>Add Access Control<\/b>. It lands you on the <\/span>Forms <\/b>page and you can add a component in the master form. You can only update <\/span>Read-only<\/span><\/i>, <\/span>Is-Visible<\/span><\/i>, and <\/span>Visibility <\/span><\/i>settings through access control.\u00a0<\/span><\/li>\n
    6. Under the <\/span>HTML to embed form<\/b> section, you can find the HTML code. Click <\/span>Copy <\/b>to copy the HTML code. You can use this <\/span>HTML iframe <\/span>code <\/span>to embed the trigger form in your website. This is needed only if<\/span> you <\/span>do not use the <\/span>portal <\/span><\/i>and the <\/span>process app<\/span><\/i> is for public access.<\/span><\/li>\n
    7. Click <\/span>Done<\/b>. You can find the trigger created on the Process Builder.<\/span><\/li>\n
    8. Start to build the flow by notifying the initiator (employee).<\/span><\/li>\n
    9. On the left pane, you can find the <\/span>Events <\/b>section. Drag and drop the <\/span>Notify <\/b>stencil from this section to the builder.\u00a0<\/span><\/li>\n
    10. Click the <\/span>Notify <\/b>stencil to open the Notify window.<\/span><\/li>\n
    11. On the Notify window, enter the following details:<\/span>\n
        \n
      1. Name – Enter a name for the notification message.<\/span><\/li>\n
      2. Delivery Mode – Select the mode of communication to notify the employee.<\/span><\/li>\n
      3. Recipients – Enter the email address of the employee to receive a notification. You can also use <\/span>context <\/span><\/i>or <\/span>variables<\/span><\/i> from the trigger.<\/span><\/li>\n
      4. Subject – Enter the subject for the notification email.<\/span><\/li>\n
      5. Compose Message – Enter the relevant text related to the notification. It also supports <\/span>context <\/span><\/i>and the <\/span>addition of variables<\/span><\/i> so that you can include them while composing the message.<\/span><\/li>\n<\/ol>\n<\/li>\n
      6. Close the Notify window.<\/span><\/li>\n
      7. Make an API request to fetch the Manager details of the initiator (employee).<\/span><\/li>\n
      8. On the left pane, you can find the <\/span>Integrations <\/b>section. Drag and drop the <\/span>Connect to API <\/b>stencil from this section to the builder.<\/span><\/li>\n
      9. Click the <\/span>Connect to API <\/b>stencil to open the Connect to API<\/span> window.<\/span><\/li>\n
      10. On the Connect to API<\/span> window, enter the following details:<\/span>\n
          \n
        1. Name – Enter the name of the API request.\u00a0<\/span><\/li>\n
        2. Type – Select the API request type: REST or SOAP<\/span><\/li>\n
        3. Integration Mode – Select the integration mode: Synchronous or Asynchronous.<\/span><\/li>\n
        4. URL: Click <\/span>Define Request<\/b> under the URL field.<\/span>\n
            \n
          1. On the <\/span>Define Request<\/b> page, enter the following details:<\/span>\n
              \n
            1. Request Type<\/b> – <\/span>GET<\/span><\/i><\/li>\n
            2. Request URL<\/b> – https:\/\/608fd39c38473400170203a8.mockapi.io\/api\/v1\/leaverequests (This is an example URL, not for business purposes)<\/span><\/li>\n
            3. This API does not require any Header Parameters.<\/span><\/li>\n
            4. Click the <\/span>Test Request<\/b> tab.<\/span><\/li>\n
            5. Click <\/span>Test<\/b> on the top-right of the page. Wait for the test to be completed and you get a <\/span>Status Code: 200<\/span><\/i>.<\/span><\/li>\n
            6. You can see an array of records returned by the API call. In the next step, values are parsed using JavaScript.<\/span><\/li>\n
            7. Click <\/span>Save<\/b> on the top-right of the page.<\/span><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n
            8. Close the Connect to API<\/span> window.<\/span><\/li>\n
            9. After the successful completion of the API request, the system fetches the Manager details and assigns the task (expense report approval).<\/span><\/li>\n
            10. On the left pane, you can find the <\/span>Tasks <\/b>section. Drag and drop the <\/span>Approval Task <\/b>stencil from this section to the builder.<\/span><\/li>\n
            11. Click the <\/span>Approval Task <\/b>stencil to open the Approval Task<\/span> window.<\/span><\/li>\n
            12. On the Approval Task window, enter the following details:<\/span>\n
                \n
              1. Name – Enter a name for the approval task.<\/span><\/li>\n
              2. Task Results – You can find <\/span>Approve <\/b>and <\/span>Reject <\/b>options. Choose to approve or reject the task. You can also rename these options or click <\/span>Add an Outcome<\/b> to add more options like <\/span>On-Hold<\/span><\/i>.<\/span><\/li>\n<\/ol>\n<\/li>\n
              3. Click the <\/span>Notifications <\/b>tab to configure the notification settings.<\/span><\/li>\n
              4. Select a <\/span>Delivery Mode<\/b> from the drop-down list: Bot or API or Email.<\/span><\/li>\n
              5. Under the <\/span>Response <\/b>section, select a <\/span>Get Response<\/span><\/i> option to send the Manager\u2019s response. These options differ based on the delivery mode selected. If the delivery mode is <\/span>email<\/span><\/i>, you can get responses through a form or email. If the delivery mode is <\/span>bot<\/span><\/i>, you can get responses through a form or conversational experience. If the delivery mode is <\/span>API<\/span><\/i>, you can get responses through APIs. In this example, the selected delivery mode is <\/span>email<\/span><\/i>.<\/span>\n
                  \n
                1. Get Response through a Form<\/b> – If selected, the<\/span> Form URL<\/span><\/i> will be inserted into the message composed in the <\/span>Compose Message<\/span><\/i> section.<\/span><\/li>\n
                2. Get Response through Email<\/b> – If selected, <\/span>Buttons <\/span><\/i>for the result outcomes are appended to the message composed in the <\/span>Compose Message<\/span><\/i> section.<\/span><\/li>\n<\/ol>\n<\/li>\n
                3. Under the <\/span>Compose Message<\/b> section, enter the following details:<\/span>\n
                    \n
                  1. Subject – Enter the subject for the response mail.<\/span><\/li>\n
                  2. Compose Message – Enter the details of the response message.<\/span><\/li>\n
                  3. Click <\/span>{..}<\/b> to add variables to the message. You can also use <\/span>Context <\/span><\/i>in the message.<\/span><\/li>\n<\/ol>\n<\/li>\n
                  4. Click the <\/span>Assignment <\/b>tab to configure the recipient settings. You can select any of the below options:<\/span>\n
                      \n
                    1. Single Recipient<\/b> – If selected, you can send the response to the recipient configured in this section.<\/span>\n
                        \n
                      1. Enter the recipient email address in the <\/span>Recipient ID<\/b> field.<\/span><\/li>\n<\/ol>\n<\/li>\n
                      2. Multiple Recipients<\/b> – If selected, you can send the response to multiple recipients configured in this section.<\/span>\n
                          \n
                        1. Enter recipient email addresses separated by a comma in the <\/span>Recipient ID<\/b> field.<\/span><\/li>\n
                        2. Under the <\/span>Assignment Logic<\/b> section, select an option:<\/span>\n
                            \n
                          1. Assign to All<\/b> – If selected, the system assigns the task to all recipients.<\/span><\/li>\n
                          2. Least Occupied<\/b> – If selected, the system assigns the task to the recipient with the least number of open tasks.<\/span><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n
                          3. Group <\/b>– If selected, you can send the response to a group. Only one of the recipients from the group can complete the task\u00a0<\/span>\n
                              \n
                            1. Enter the group email addresses separated by a comma in the <\/span>Group ID<\/b> field.<\/span><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n
                            2. Close the Approval Task<\/span> window.<\/span><\/li>\n
                            3. After assigning the task, the Manager can approve or reject the task. To perform this action, you need a logic stencil. You do not always need logic to perform this task, it depends on the use case. But, in this example, a logic stencil is used.<\/span><\/li>\n
                            4. On the left pane, you can find the <\/span>Logic <\/b>section. Drag and drop the <\/span>Split <\/b>stencil from this section to the builder.<\/span><\/li>\n
                            5. The Split stencil is added to the builder with two branches (Branch1 and Branch2).<\/span><\/li>\n
                            6. Click the <\/span>Split <\/b>stencil to open the Split window.<\/span><\/li>\n
                            7. On the Split window, enter the following details:<\/span>\n
                                \n
                              1. Name – Enter a name for the split action. For example, Manager Decision.<\/span><\/li>\n
                              2. Branches – Edit the branches (Branch1 and Branch2) as Approved and Rejected.<\/span><\/li>\n
                              3. Split Logic – Select any of the below options:<\/span>\n
                                  \n
                                1. Execute all Branches<\/b> – If selected, all branches are executed simultaneously.<\/span><\/li>\n
                                2. Execute on Condition <\/b>– If selected, you can define a condition in the <\/span>Define Condition<\/b> section below. You can define conditions based on <\/span>Process Fields, Context, <\/span><\/i>and <\/span>Process Context<\/span><\/i>. For example, let us select <\/span>Process Fields<\/span><\/i>.\u00a0<\/span>\n
                                    \n
                                  1. Under the <\/span>If <\/b>condition, <\/span>Select Field Value<\/b> and <\/span>Less than<\/b> from the respective drop-down lists. In the <\/span>Value <\/b>field, enter <\/span>$2000<\/span><\/i>.<\/span><\/li>\n
                                  2. From the <\/span>Go to Branch<\/b> drop-down list, select <\/span>Approved<\/b>.<\/span><\/li>\n
                                  3. In the <\/span>Add Else-If<\/b> section, select <\/span>Rejected <\/b>from the <\/span>Else Go To Branch<\/b> drop-down list.<\/span><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n
                                  4. Close the Split window.<\/span><\/li>\n
                                  5. The next step is to notify the employee about the status of the expense report. Drag and drop the <\/span>Notify <\/b>stencil below the <\/span>Approved <\/b>and <\/span>Rejected <\/b>branches on the builder.<\/span><\/li>\n
                                  6. Open the Notify stencil of <\/span>Approved <\/span><\/i>and <\/span>Rejected <\/span><\/i>branches and configure the notification details.<\/span><\/li>\n
                                  7. The final step is to end the process flow.\u00a0<\/span><\/li>\n
                                  8. On the left pane, you can find the <\/span>Logic <\/b>section. Drag and drop the <\/span>End <\/b>stencil from this section to the builder.<\/span><\/li>\n
                                  9. Click the <\/span>End <\/b>stencil to open the End window.<\/span><\/li>\n
                                  10. On the End window, select any of the below options:<\/span>\n
                                      \n
                                    1. End this Path – If selected, the system will end the current path and all other paths remain active.<\/span><\/li>\n
                                    2. Terminate all Paths – If selected, the system will terminate all active paths and end the process flow.<\/span><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/div><\/div>
                                      <\/div><\/div><\/div><\/div><\/div><\/div><\/section>\n","protected":false},"excerpt":{"rendered":"A Digital Form helps you to collect the required data. It allows your users to enter the data you want to process a certain request. Digital Form triggers refer to the triggers that occur through the submission of a digital form. For example, let us consider an employee expense report. An employee has submitted an...","protected":false},"author":12,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[144],"tags":[],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/posts\/29515"}],"collection":[{"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/comments?post=29515"}],"version-history":[{"count":3,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/posts\/29515\/revisions"}],"predecessor-version":[{"id":29755,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/posts\/29515\/revisions\/29755"}],"wp:attachment":[{"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/media?parent=29515"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/categories?post=29515"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/tags?post=29515"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}