バッチワークフローの作成と管理

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

1. このページの内容

バッチワークフローを使用して、大きなタスクを効率的に小さなバッチに分割し、オフピーク時間に処理する方法を説明します。

バッチワークフローを作成する前に、こちらのページでバッチワークフローの概要を確認してください。

2. 提供状況

バッチワークフロー機能

Creator の有料プランでのみ利用でき、プランごとに使用できるバッチブロック数に上限があります
スーパー管理者、管理者、開発者のみが作成・有効化・管理でき、その他のユーザーは、繰り返しタスクの自動実行の恩恵を受けることができます
すべてのデータセンターで利用できます

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つ以上のバッチが失敗した場合、そのバッチのみがロールバックされ、バッチワークフローは残りのバッチの実行を継続します。そのブロックの失敗メッセージはログで確認できます。
バッチワークフローは、バッチサイズ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未満である必要があります。
getUrl()およびpostUrl()タスクは現在サポートされていません。
グローバル変数に値を代入することはできませんが、infoステートメントを使用して参照することはできます。
範囲指定での取得および削除の各操作は、最大 5,000 件のデータまでに制限されています。
次の Deluge 操作は、バッチワークフローではサポートされません。