実行単位を実行するためには、ご利用のkintone環境のログイン名とパスワードを設定する必要があります。

kintoneアカウントの設定を行うには、「設定ファイル」タブの左側のメニューから「ユーザー情報」を選択します。

データ編集フローの実行時、または実行単位の登録時にkintoneアカウントが設定されていない場合、「ユーザー情報」画面が表示されてkintoneアカウントの設定が求められます。

ユーザー情報の入力後に［アカウントの確認］をクリックし、入力したユーザー情報が正しいことを確認して下さい。

ユーザー情報が正しいことを確認した後に、［アプリを更新］をクリックし、ユーザー情報を保存します。

IPアドレス制限を設定している環境での利用

IPアドレス制限を設定しているkintone環境でデータ編集フローを実行する場合は、ご利用環境の設定に応じてユーザー情報にBasic認証、またはセキュアアクセス設定に関する情報を設定してください。

なお、IPアドレス制限の設定内容、およびBasic認証、またはセキュアアクセス設定の有無によって、データ編集フローを実行できる場合とできない場合があります。詳細については「IPアドレス制限を設定している環境」を参照してください。

実行単位をAPIにより実行するための設定手順は以下の通りです

1. 「実行方法」列のをクリックして実行方法の設定ダイアログを開き、以下の操作を行います。
   
   1. 「実行方法」で「API」を選択
   2. 「同時実行の動作」を選択（要求をキャンセル／実行を待機）。各設定の動作詳細は「排他制御」を参照してください。
   3. URLをコピー
   4. ［OK］ボタンをクリック
2. 実行単位の「有効」列のチェックボックスをオンに設定し、プラグイン設定画面で「アプリを更新」します。

   「有効」列のチェックボックスをオンに設定することによりURLが有効化され、リアルタイム実行を行うことができます。チェックボックスがオフの場合、APIリクエストは失敗し、実行単位は実行されません。

3. 任意実行APIを使用し、kintoneアプリのカスタマイズ、または外部アプリケーションの作成を行います。任意実行APIの詳細については「APIリファレンス」を参照してください。
4. カスタマイズを行ったkintoneアプリ、または外部アプリケーションで、任意実行APIを実行する操作を行います。
   任意実行APIが実行され、設定したURLの実行単位が実行されます。

実行単位をkrewSheet連携により実行するための設定手順は以下の通りです

1. 「実行方法」列のをクリックして実行方法の設定ダイアログを開き、以下の操作を行います。
   
   1. 「実行方法」で「krewSheet連携」を選択
   2. 「同時実行の動作」を選択（要求をキャンセル／実行を待機）。各設定の動作詳細は「排他制御」を参照してください。
   3. URLをコピー
   4. ［OK］ボタンをクリック
2. 実行単位の「有効」列のチェックボックスをオンに設定し、プラグイン設定画面で「アプリを更新」します。

   「有効」列のチェックボックスをオンに設定することによりURLが有効化され、リアルタイム実行を行うことができます。チェックボックスがオフの場合、krewSheetからのリアルタイム実行要求は失敗し、実行単位は実行されません。

3. 実行単位の「呼び出し元アプリ」に設定したkrewSheetでkrewData連携の設定を行います。krewSheetの設定手順の詳細については、krewSheetヘルプ「krewData連携の設定」を参照してください。
4. krewData連携を設定したkrewSheetの一覧画面で、リアルタイム実行を要求する操作を行います。
   krewSheetからリアルタイム実行要求が送信され、設定したURLの実行単位が実行されます。

実行単位に追加した各データ編集フローは、フロー作成エリアの［実行］ボタンをクリックすることで、個別に手動で実行することができます。

即時実行およびプレビューで使用するパラメータの設定

データ編集フロー作成している途中や確認のために実行したい場合、パラメータへ仮の値を設定して、フローを実行したりプレビューで処理結果を確認することができます。

1. フロー設定画面右上のパラメータ設定アイコンをクリックし、設定画面を開きます。

2. パラメータ設定画面で即時実行時にパラメータを設定するフィールドを選択し、値を設定します。

実行方法がWebhook、またはAPIの場合

実行方法がkrewSheet連携の場合

リアルタイム実行では、実行時に実行単位に含まれるデータ編集フロー全体をロックし、他のリアルタイム実行による同一の実行単位の呼び出しを制御します。

• 実行単位の設定において「同時実行時の動作」を「要求をキャンセル」に設定している場合、他のユーザーが実行中の実行単位を実行すると即座にエラーになります
  
• 実行単位の設定において「同時実行時の動作」を「実行を待機」に設定している場合、他のユーザーが実行中の実行単位を実行すると、実行単位の終了を待って実行を開始します
  
• 実行単位の設定において「同時実行時の動作」を「実行を待機」に設定している場合、他のユーザーが実行中の実行単位が終了するのを待機するが、一定時間を経過するとタイムアウトエラーになります
  

Webhookやイベント処理によるAPI実行でリアルタイム実行を行った際に、排他制御やタイムアウト、その他の理由によりリアルタイム実行がエラーになった場合はデータ編集フローが実行されず、出力アプリへのレコード追加／更新が行われません。

排他制御によりエラーになった場合の例

       

• ユーザー１が更新したレコード情報をもとに実行単位１を実行。フロー１の実行結果が出力アプリに反映される
• ユーザー２が起動したリアルタイム実行はエラーによりフロー１が実行されず、出力アプリにユーザー２の更新が反映されない