レシピジョブ
アクティブなレシピがトリガーイベントを処理し、一連のアクションを実行すると、ジョブが作成されます。 各ジョブには一意のトリガーイベントが含まれ、そのデータに基づいてレシピロジックを実行します。 たとえば、データの有無に基づいてIf..Thenアクションを実行します。
ジョブは、Environment propertyまたはプロジェクトプロパティの値への変更を動的に検出して更新しません。 Environment propertyとプロジェクトプロパティの値は、設計上、ジョブ実行の開始時点で固定されます。 Environment propertyまたはプロジェクトプロパティの値に対して動的検出が必要な場合は、ルックアップ テーブルを使用できます。
Workatoは、実行されたステップや各ステップの入力データと出力データなど、ジョブの実行フローに関する詳細を提供します。 Workatoは、エラーによってジョブが完全に完了できない場合のジョブの再実行もサポートしています。
このガイドでは、以下について説明します。
ジョブレポートの表示
ジョブレポートページには、レシピで処理されたすべてのジョブが記録されます。 特定のレシピのジョブレポートページにアクセスするには、次の手順を実行します。
レポートの保持
ジョブレポートは、ワークスペースのデータリテンションポリシーに従ってデータを保持します。 データリテンション設定にアクセスするには、ワークスペース管理者>設定>データリテンションに移動します。
ジョブを表示する予定のレシピが含まれるワークスペースに移動します。
レシピをクリックし、ジョブタブをクリックします。 このページでは、次のアクションを実行できます:
制限
ジョブレポートには次の制限があります:
| 説明 | 制限 |
|---|---|
| ジョブレポート内の列の最大数 | 10 |
| ジョブレポートの列値の最大長 | 256文字 |
| 最大ジョブレポートサイズ | 5 KB |
ジョブレポートをカスタマイズ
ジョブレポートをカスタマイズして、最大10個の追加列を表示できます。 追加する列には、レシピで使用可能な任意のデータを含めることができます。 たとえば、レシピで請求書を処理する場合、レポートをカスタマイズして、Invoice ID、Invoice amount、またはその他の関連する請求書データの列を含めることができます。
ジョブレポートのエラー
カスタムジョブレポートのエラーにより、対応する列の値は空になりますが、レシピのランタイムには影響しません。 無効なジョブレポートのカスタマイズがある場合でも、レシピを実行できます。 詳細については、カスタムジョブレポートの検証セクションを参照してください。
カスタマイズは新しいジョブにのみ適用
ジョブレポートテーブルのカスタマイズは、変更の適用後に作成されたジョブにのみ適用されます。 完了したジョブには、これらの更新は反映されません。
ジョブレポートテーブルをカスタマイズすると、レシピ自体が変更され、新しいレシピバージョンが作成されます。 各ジョブは、当時アクティブだったレシピバージョンに基づいて、完了時にカスタムフィールドを計算して保存します。 この設計により正確なレポートが保証されますが、新しいカスタマイズが古いロジックと競合する可能性があるため、完了したジョブへの更新はできません。
カスタムレポートを作成するには、次の手順を実行します:
レシピがアクティブな場合は、ストップレシピをクリックします。 アクティブなレシピのカスタムレポートを作成または編集することはできません。
テーブルのヘッダー行にある•••(省略記号)をクリックし、ジョブレポートをカスタマイズを選択します。
ジョブレポートをカスタマイズボタン
レシピのステップのデータピルを使用して、ジョブレポートをカスタマイズページでレポートに列を追加します。
ジョブレポートをカスタマイズ
完了したら、変更を適用をクリックします。
スタートレシピをクリックしてレシピを再開します。
カスタムジョブレポートの検証
Workatoは、機密情報を保護しながら安全で正確なレポートを確保するために、カスタムジョブレポートを検証します。 カスタムジョブレポートの検証では、Formulaエラーや、マスクされたデータピルまたは存在しないデータピルへの参照などの問題を識別し、これらのエラーの解決に役立つ明確な警告を提供します。
データマスキングが有効なステップのデータピルは、カスタムジョブレポートで使用できません。 Formulaはジョブレポートエディター内でも直接検証されます。 Formulaエラーがあるジョブレポートを保存しても、レシピを開始できますが、エラーのあるデータはレポートから省略されます。
マスクされたステップの機密ではないデータピルをカスタムジョブレポートで使用するにはどうすればよいですか。
マスクされたステップの機密ではないデータピルをカスタムジョブレポートに含めるには、次の手順を実行します:
レシピエディターでレシピを開きます。
マスクされたステップの後に、Variables by Workatoの変数を作成アクションを追加します。
カスタムジョブレポートに含める予定の機密ではないデータピルの変数を作成するには、変数を追加をクリックします。
マスクされたステップの関連するデータピルを、変数を作成アクションの対応する入力フィールドにマッピングします。
含める予定の機密ではないデータピルごとに、ステップ3と4を繰り返します。
保存をクリックし、次に終了をクリックします。
ジョブタブに移動します。
テーブルのヘッダー行にある•••(省略記号)をクリックし、ジョブレポートをカスタマイズを選択します。
変数を作成ステップのデータピルを、対応する列にマッピングします。
変更を適用をクリックします。
ジョブレポートをCSVファイルにエクスポート
ジョブレポートをCSVファイルにエクスポートできます。CSVファイルには、現在のフィルター設定に基づく最新の1,000行が含まれます。 ジョブレポートをエクスポートするには、次の手順を実行します:
ジョブレポートをCSVファイルにエクスポートする予定のレシピをクリックします。
ジョブタブをクリックし、エクスポートする予定のジョブをクリックします。
テーブルの右上隅にある...(省略記号)をクリックし、ジョブレポートをエクスポートを選択します。
ジョブ履歴テーブルでフィルターを設定し、ジョブレポートをエクスポートボタンをクリックして、最新の1,000行を含むCSVファイルをダウンロードします。 CSVファイルには適用されたフィルターに従った行が含まれ、UIに表示されている列の順序と名前が保持されます。
ジョブレポートをCSVファイルにエクスポート
特定のジョブの詳細を表示
ジョブの詳細ページには、レシピ内の各ステップの入力データと出力データが表示され、必要に応じてジョブを検査してデバッグできます。
特定のジョブの詳細を表示するには、次の手順を実行します:
レシピをクリックして詳細ビューを開きます。
ジョブタブをクリックし、表示する予定のジョブをクリックして、次の内容を含むジョブの詳細ページを開きます:
ジョブメタデータとステータス
ジョブの詳細ページには、次のジョブメタデータが含まれます:
| 名前 | 説明 |
|---|---|
| ジョブID | ジョブのID。 |
| Job start time | ジョブが開始された時刻。 |
| レシピバージョン | ジョブが使用したレシピのバージョン。 |
| Status | ジョブのステータス。 詳細はこちら。 |
| 説明 | レシピの説明。 |
| Runtime user connection | レシピでランタイムユーザーコネクションを使用した場合、ジョブが使用した特定のコネクションが表示されます。 |
| 期間 | ジョブの完了にかかった時間。 |
| 使用されたタスク | ジョブが使用したタスクの合計数。 |
| Rerun # | ジョブの再実行番号。 |
ジョブステータス
ジョブには次のステータスがあります:
| 名前 | 説明 |
|---|---|
| 完了 | ジョブが正常に処理されたことを示します。
注: ジョブが完了と表示されても、想定どおりに処理されていない場合があります。 レシピが想定どおりに動作していることを確認するには、ジョブがレシピ内のステップをどのように処理したかを確認してください。 |
| 失敗 | ジョブがエラーのために終了したことを示します。 通常、エラーはアクションの実行失敗に起因します。 例: アプリに到達できない場合。
エラーが発生すると、ジョブは停止し、それ以降のステップは実行されません。 |
| 処理中 | ジョブがまだ処理中であることを示します。 |
| 一時停止 | ロングアクションを含むジョブが、レシピの停止時に一時停止されたことを示します。 一時停止中のジョブの詳細はこちら。 |
| 中止 | まれ。 レシピに保留中のジョブがあるものの、保留中のジョブが処理を完了できないようにレシピが変更されたことを示します。 |
一時停止中のジョブ
ロングアクションを含むレシピは、レシピによっては実行時間が長くなる場合があります。 処理中段階のジョブは、ユーザーがレシピを停止するとpausedになります。 一時停止中のジョブは、レシピが再開されると再開します。
ジョブを一時停止
レシピを編集して保存すると、新しいバージョンに移行します。 ただし、一時停止中のジョブは、開始時と同じレシピバージョンで再開します。 この例では、ジョブはレシピバージョン1で開始しました。 レシピが変更されて再開された後、ジョブは同じレシピバージョン1で再開して完了します。
ジョブを再開
レシピの再開後、新しいジョブは新しいバージョンのレシピを使用して実行されます。 この例では、新しいジョブはレシピバージョン3で開始します。
新しいジョブ
ジョブステップの詳細
特定のレシピステップに関する詳細を表示するには、次の手順を実行します:
条件付きステップ
条件付きアクションを展開すると、単一の出力タブが表示されます。 これにより、条件がtrueまたはfalseのどちらに評価されたかが示されます:
trueの場合、ネストされたアクションが実行され、その詳細を表示できます。falseの場合、ネストされたアクションは実行されず、レシピは次に可能なアクションに進みます。 実行されないアクションは条件未達として表示され、その詳細は表示できません。
繰り返しステップ
繰り返しステップを展開しても、すべての反復で実行されたステップは表示されません。
たとえば、繰り返しステップが10項目のリストを処理する場合、ジョブの詳細ページにはリスト内の最後の項目のみが表示されます。
同様に、繰り返しステップ内でエラーが発生した場合、ジョブの詳細には、その特定の反復で実行されたステップのみが表示され、それ以前の反復は表示されません。
ジョブエラー
ジョブでエラーが発生して処理が停止すると、失敗したステップが強調表示されます。
ジョブエラー
ステップのDebugタブを使用して、問題をさらにトラブルシューティングできます。
タイムアウト
ジョブまたは単一のステップの実行に時間がかかりすぎると、タイムアウトが発生します。 タイムアウトしたジョブのエラーメッセージには、タイムアウトの原因に関する詳細情報が含まれます。
ジョブはデフォルトで、アクティブ実行時間が90分を超えるとタイムアウトします。 ワークスペース管理者はカスタム制限を設定できます。
ロングアクションを使用
単一のステップの処理に時間がかかりすぎてレシピがタイムアウトする場合は、ロングアクションの使用を検討してください。 ロングアクションは、一括データを処理するための特殊なアクションです。
保留中のジョブ
ロングアクションが開始されたものの完了しない場合、保留中のジョブは待機状態のままになります。 これは、ロングアクションが待機状態のままで、ユーザーがレシピを停止した場合に発生することがあります。
レシピが30日間停止されている場合、Workatoはすべての保留中のジョブを失敗にします。 これには、呼び出し可能なレシピとレシピ関数からのネストされたジョブが含まれます。 Workatoはトリガーイベントを保持しているため、ジョブ履歴から再実行することで、失敗したジョブを復旧できます。
ジョブの繰り返し
以前に完了したか失敗したかに関係なく、任意のジョブを再実行できます。 Workatoはトリガーイベントのデータを保存し、このトリガーイベントのコピーを使用してジョブを再実行します。
ジョブの再実行では、常にレシピの最新バージョンが使用されます。 ジョブの前回実行後にレシピが変更されている場合、再実行では最新バージョンが使用されます。
詳細については、ジョブの再実行を参照してください。
Last updated:
ジョブレポートのカスタマイズ時のエラー
ジョブレポートカスタマイズエラーを強調表示する警告バナー