バッチワークフローの作成と管理
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
1. このページの内容
大きなタスクを小さなバッチに分割し、オフピーク時間にバッチワークフローを使って効率的に処理する方法を説明します。
バッチワークフローを作成する前に、バッチワークフローの概要についてはこちらのページを確認してください。
2. 提供状況
バッチワークフロー機能
3. バッチワークフローの設定
3.1 バッチワークフローの作成フロー
3.2 設定方法を見る
3.3 バッチワークフローを作成する手順
3.3.1 前提条件
- アプリケーション内に、バッチワークフローを設定する元となるフォームが必要です。
- バッチワークフローをいつトリガーするか、また処理するデータ量、つまり各バッチのサイズの目安を決めておく必要があります。
手順 1: バッチワークフローを作成する
1. ソリューションタブに移動し、対象のアプリケーションを開きます。
2. 上部のワークフローボタンをクリックして、ワークフローダッシュボードに移動します。
3. バッチワークフローを選択し、該当する以下のいずれかの手順に従います。
- 初めてバッチワークフローを作成する場合は、中央のバッチワークフローを作成をクリックします。
- すでにバッチワークフローを作成済みの場合は、右上の新しいバッチワークフローをクリックします。
4. 対象のフォームとワークフローのトリガータイミング（インポート時またはスケジュール時）を選択します。
- インポート時：このオプションを選択すると、設定したバッチワークフローはデータのインポートが正常に完了した後に実行されます。
- スケジュール時：このオプションを選択すると、設定したバッチワークフローは指定した日付と時刻に実行されます。
5. スケジュール時を選択した場合は、以下の手順に従います。それ以外の場合は手順 6に進みます。
メモ: 設定した日付の頻度が翌月以降に適用できない場合、その月のバッチワークフローの実行はスキップされます。たとえば、ワークフローを毎月 31 日に実行するよう設定した場合、31 日が存在しない月はワークフローがスキップされます。
- バッチワークフローを実行したい日付と時刻を選択します
- スケジュールの頻度を選択します。
6. バッチワークフローの名前を入力し、このワークフローの実行タイミングを指定します。
- 常にが既定で選択されています
- 条件を指定を選択し、必要な条件を設定します
7. バッチプロセスを作成をクリックします。ワークフロービルダー画面に移動します。
手順 2: バッチ実行中の設定
1. 新しいアクションを追加をクリックし、各バッチブロック内の各データに対して実行するアクションを追加します。
2. 必要なスクリプトを入力し、保存をクリックします。
ページ末尾の添付ファイルにサンプルスクリプトがあります。
3. 必要に応じてスクリプトを管理するには、Deluge スクリプトのプレビュー上にカーソルを合わせます。追加済みのスクリプトを削除するには、削除アイコンをクリックします。
バッチワークフローの実行中にスクリプトを編集または削除することは推奨されません。既存スクリプトの変更により、現在および今後のバッチブロックの実行が失敗する可能性があります。
手順 3: バッチ実行前の設定
以下の画面は、前の手順で詳細を入力した後のワークフロービルダーを示しています。
メモ: 実行前ブロックは、要件に応じて任意で設定できます。ただし、実行中ブロックで実行するスクリプトは必ず設定する必要があります。
1. バッチ実行前セクションの変数セクションを展開します。
2. 変数を管理をクリックします。右側から変数ペインがスライド表示されます。
3. 変数を追加をクリックします。
4. 表示されるポップアップでデータ型を選択し、変数名を入力して追加をクリックします。変数は変数セクションに追加されます。
5. + 変数を追加をクリックして、別の変数を追加します。変数は削除アイコンで削除できます。
6. 必要に応じて変数を管理するには、変数セクションにカーソルを合わせます。右側から変数ペインがスライド表示されます。
変数名の編集や、必要に応じた変数の追加・削除ができます。
メモ: 既存の変数については、データ型を変更できません。
7. 初期化セクションを展開し、新しい初期化を追加をクリックします。
8. バッチワークフローの実行が開始される前に実行する必要なスクリプトを入力します。
先ほど追加した変数をスクリプト内で使用することもできます。
- input。total_amount = 0;
- input。minimum_amount = 0;
9. スクリプトを編集するには、Deluge スクリプトのプレビュー上にカーソルを合わせ、編集アイコンをクリックします。追加済みのスクリプトを削除するには、削除アイコンをクリックします。
手順 4: バッチ実行後の設定
このセクションでは、完了時と失敗時の両方の処理を設定できます。
メモ: 実行後ブロックは、要件に応じて任意で設定できます。ただし、実行中ブロックで実行するスクリプトは必ず設定する必要があります。
1. 完了セクションを展開し、新しい完了スクリプトを追加をクリックします。
2. Deluge エディターに必要なスクリプトを入力し、保存をクリックします。
3. 同様に、新しい失敗スクリプトを追加をクリックして、バッチワークフローの実行が失敗した場合に実行するスクリプトを追加します。
4. ワークフロービルダー右上の完了をクリックします。作成したバッチワークフローは、バッチワークフロータブに一覧表示されます。
4. バッチワークフローを管理する
- ワークフロー名の横にあるボタンを切り替えることで、バッチワークフローを有効化/無効化できます。
- ワークフロービルダー内の任意のセクションに移動して編集するには、バッチ処理ペインに表示されている該当セクションをクリックします。
5. 注意事項
- 次のケースでバッチワークフローを設定できます — アプリケーションデータのインポートが正常に完了した後、または指定した時刻に実行する場合。
- 同じフォームに対して、条件が異なる、または同一の複数のバッチワークフローを作成できます。
- 1つのバッチブロック内のすべてのバッチは順次実行されます。
- アプリケーションログセクションから、バッチワークフロー実行のステータスを追跡できます。キューステータス、実行中の処理、完了ステータス（成功または失敗）に関する情報が提供されます。
- 最初の5件のバッチブロック失敗については、エラーログを表示でき、実行失敗の原因を把握できます。
- 1つ以上のバッチがブロック内で失敗した場合、その失敗したバッチのみロールバックされ、バッチワークフローは他のバッチの実行を継続します。そのブロックの失敗メッセージはログで確認できます。
- 15件連続でバッチが失敗すると、バッチワークフローは終了します。それまでに正常に完了したバッチはロールバックされません。
- 1日のバッチワークフロー上限に達した場合も、実行は終了します。
- バッチワークフローは、10、50、100、200、500、1000件単位のバッチサイズで実行できます。
- 1つのアカウントで、同時に最大100件のバッチワークフローを作成できます。
- ご利用の料金プランに応じて、1アカウントあたり1日に実行できるバッチブロックの回数には上限があります。
- 各バッチの実行タイムアウトは1分に設定されています。例として、バッチブロックのサイズを1000に設定した場合、その1000件のデータの実行タイムアウトは1分となります。
- 同様に、「前処理」「後処理」のバッチブロックのタイムアウトは、それぞれ30秒です。
6. 制限事項
-
ユーザーは、1つのバッチワークフロー内で最大5個の変数を作成できます。
-
1つのアカウントにつき、同時に実行できるバッチワークフローは（作成日を基準に）1件のみです。これにより、追加のバッチワークフローは実行待ちキューに入れられ、公平なリソース配分とシステムリソースの過負荷防止が保証されます。
Deluge の制限事項
-
バッチワークフローでは、'修正前' キーワードはサポートされていません。
-
Infoメッセージは50KBを超えることはできません。超えた場合、メッセージは切り捨てられます。
-
許可されるファイル添付の最大サイズは15 MBです。この制限を超える添付ファイルがある場合、メールは添付ファイルなしで送信されます。
-
指定したファイルのコンテンツを取得する、または必要なコンテンツを使用してファイルオブジェクトを作成する場合、対象ファイルのサイズは2 MB未満である必要があります。
-
次のグローバル変数に値を代入することはできません。ただし、infoステートメントを使用して参照することは可能です。
-
次の Deluge 操作は、バッチワークフローではサポートされていません。
メモ: 上記の制限は、バッチワークフローから呼び出される関数呼び出しにも適用されます。