Create and Manage Execution Units

Real time execution allows multiple data editing flows to be executed sequentially through a webhook notification or API call. This allows you to execute the associated data editing flows through a single user action.

An "execution unit" refers to a unit consisting of multiple data editing flows which can be executed using one call. One real time execution is set for each kintone app that is called (kintone app: krewData execution unit = 1:1).

Real Time Execution Tab

To create an execution unit, open Real Time Execution tab of the Plug-in Settings page. Once an execution unit is created, you can do various operations in the list such as editing, cloning and deleting the units. 

1. Execution Unit

Item Description
① Add Execution Unit button Creates a new execution unit on clicking [+] iconAdd Execution Unit button.
② Registered flows for real time execution in your domain Indicates the total number of real time execution flows allowed by license and the number of flows in use. You can view the list of execution units and real time execution flows by clicking the Detail button.
In case you mistakenly delete the krewData app while having the real time execution flow configured, you can delete the registered real time execution flow from the list displayed on the real-time execution flow screen in the domain.
③ List of execution units Displays the list of created execution units with options to edit, clone or delete them.

2. Data Editing Flow

Data editing flows for real time execution can be created in the bottom section of Real Time Execution tab. Various operations can be performed on flows that are created such as editing, cloning, deletion etc.

Item Description
④ Add Data Editing Flow button Creates a new data editing flow on clicking [+] iconAdd Data Editing Flow button.
⑤ Use Flow of Schedule Execution Allows you to browse and add a data editing flow created in the Schedule Execution tab to execution unit by clicking Link icon. The data editing flow added by browsing cannot be edited in the Real Time Execution tab.
⑥ Copy Flow Allows you to copy data editing flow from an execution unit or Schedule Execution tab to the execution unit being edited by clicking Copy icon.
⑦ List of data editing flows Displays list of created data editing flows and allows you to perform operations such as re-ordering, editing, cloning and deletion of flows.
Steps to Create Execution Unit

Following are the steps to create execution units:

1.Set Default Log Output App

The log output app records the output of real time execution every time an execution unit is executed through Webhook or API call. Default log output app must be set before creating the execution unit.

(1) Click the Select App button of Default Log Output App on top right of the page.

(2) In Select App dialog, click Create New Log Output App and enter any app name to create a new log output app.

(3) Confirm that log output app created in the above step is selected and click OK.

  • The new log output app is created in the same space as the kerwData app.
  • The default log output app is automatically set as log output app for execution unit created in the following steps.
  • You can change the log output app from list of execution units.
  • If default log output app is changed, all the execution units created after that will have the changed log output app by default.
  • Execution logs are not recorded in log output app if "Add records" permission is not given to the user executing data editing flow. If a user other than "App creator" has to run the data editing flow, you need to grant "Add records" permission to that user.

2.Create Execution Unit

Execution Unit to execute data editing flows through Webhook notification or API can be created using "1. Execution Unit" located in upper part of the page.

(1) Add a new execution unit by clicking  [+] iconAdd Execution Unit button of the list.  

(2) Set each item of the list.

Item Description
Icon Rearrange icon You can drag to rearrange the data editing flow.
Execution Unit Displays name of the execution unit. You can click icon to rename.
Enable Displays the checkbox which in On state indicates that URL is published and real time execution is enabled. When checkbox is in Off state, the URL gets disabled and real time execution is not performed.
State

Shows the result of last execution.

icon:Success

icon:Fail
icon:Error in settings of execution unit. Please check the settings.

Calling App Allows to select input app (source app of Webhook notification or API call for recording information) to be used as parameter of real time execution.
Execution Method Displays method for executing the execution unit. Click the icon icon to select the execution method (either Webhook or API) and to regenerate the URL.
Log Output App Click icon icon of column header to set the default log output app.  If app name link is clicked after setting up, selected log output app gets displayed.

In newly created execution units, default log output app that was set in column header is automatically set. To output the execution logs to an app other than default log output app, click icon to select another log output app. Selected log output app gets displayed on clicking the link of app name.
Update DateTime Displays the date and time of last update in execution unit.
icon Delete icon Deletes the execution unit.
icon Clone icon Clones the execution unit.

3.Create Data Editing Flow

Data editing flows placed in execution units can be created in "2. Data Editing Flow" located in lower part of the page.

(1) Add a new data editing flow in execution unit by clicking the  [+] icon Add Data Editing Flow button of the list.

(2) Set each item of the list.

Item Description
Execution order When execution unit is executed, order of executing the data editing flows is displayed. When multiple data editing flows are placed, you can drag icon icon located on left hand side of the list to change the execution order.
icon Setting icon Navigates to the Flow Setting tab to configure the data editing flow.
Data Editing Flow Displays name of the data editing flow. You can click icon to rename the data editing flow.
Enable Displays the checkbox which in On state indicates that data editing flow is executed during real time execution. When checkbox is in Off state, data editing flow is not executed even if execution unit is executed.
State

Shows the result of latest execution.

icon:Success
icon:Fail
icon:Error in data editing flow. Please check the settings.

Start Time Displays the start time of previous execution.
End Time Displays the end time of previous execution.
Update DateTime Displays the date and time of last update in data editing flow.
icon Delete icon Deletes the data editing flow.
icon Clone icon Clones the data editing flow.
See Also