レシピジョブ ​

レシピは、トリガーイベントを処理してアクションを実行するたびにジョブを作成します。各ジョブはそのトリガーイベントのデータを保持し、それに対してレシピのステップを実行します。

ジョブの履歴には、実行されたステップと、それらを通過したデータが表示されます。エラーによって完了が妨げられた任意のジョブを再実行できます。

ジョブレポートの表示 ​

ジョブレポートページには、レシピで処理されたすべてのジョブが記録されます。レシピを開き、そのジョブタブをクリックしてレポートを表示します。

ジョブレポートページ

クォータ ​

ジョブレポートには次のクォータが適用されます:

ジョブステータス ​

ジョブには次のステータスがあります:

ロングアクションにより、レシピの停止時にジョブが一時停止中または保留中のままになることがあります。

一時停止中のジョブ ​

ロングアクションを含むレシピは、実行時間が長くなることがあります。処理段階にあるジョブは、ユーザーがそのレシピを停止するとpausedになり、レシピを再起動すると再開されます。

ジョブの一時停止

レシピを編集して保存すると、レシピは新しいバージョンに移行しますが、一時停止中のジョブは開始時のバージョンで実行を続けます。この例では、レシピバージョン1で開始したジョブは、レシピが編集されて再起動された後でも、バージョン1で再開して完了します。

ジョブの再開

レシピの再開後、新しいジョブは新しいバージョンのレシピを使用して実行されます。この例では、新しいジョブはレシピバージョン3で開始します。

新しいジョブ

保留中のジョブ ​

ロングアクションが完了しておらず、待機中にユーザーがレシピを停止すると、ジョブは保留中のままになります。

レシピが30日間停止された状態になると、Workatoはすべての保留中ジョブを失敗にします。これには、呼び出し可能なレシピとレシピ関数からのネストされたジョブが含まれます。 Workatoはトリガーイベントを保持するため、失敗したジョブをジョブレポートから再実行して復元できます。

ジョブレポートをカスタマイズ ​

ジョブレポートをカスタマイズして、最大10個の追加列を表示できます。追加する列には、レシピで使用可能な任意のデータを含めることができます。たとえば、レシピが請求書を処理する場合、請求書ID、請求書金額、またはその他の関連する請求書データの列を含めるようにレポートをカスタマイズできます。

カスタムレポートを作成するには、次の手順を実行します:

カスタムジョブレポートの検証 ​

Workatoは、カスタムジョブレポートを保存する前に検証します。検証では、Formulaエラー、およびマスクされたデータピルや存在しないデータピルへの参照にフラグが付けられます。

データマスキングが有効なステップのデータピルは、カスタムジョブレポートで使用できません。 Formulaはジョブレポートエディター内でも直接検証されます。 Formulaエラーがあるジョブレポートを保存しても、レシピを開始できますが、エラーのあるデータはレポートから省略されます。

ジョブレポートをCSVファイルにエクスポート ​

ジョブレポートをCSVファイルにエクスポートできます。CSVファイルには、現在のフィルター設定に基づく最新の1,000行が含まれます。

ジョブレポートをエクスポートするには、次の手順を実行します:

ジョブレポートをCSVファイルにエクスポート

ジョブ詳細 ​

ジョブ詳細ページには、レシピ内の各ステップの入力データと出力データが表示されるため、発生した内容を追跡し、必要に応じてデバッグできます。

ジョブの詳細を表示するには、次の手順を実行します:

ジョブメタデータ ​

ジョブの詳細ページには、次のジョブメタデータが含まれます:

条件付きステップ ​

条件付きアクションを展開すると、単一の出力タブが表示されます。これにより、条件がtrueまたはfalseのどちらに評価されたかが示されます:

• trueの場合、ネストされたアクションが実行され、その詳細を表示できます。
• falseの場合、ネストされたアクションは実行されず、レシピは次に可能なアクションに進みます。実行されないアクションは条件未達として表示され、その詳細は表示できません。

繰り返しステップ ​

ジョブに表示される各 Repeat for each ループまたは Repeat while ループには、反復ナビゲーターが含まれます。任意の反復を選択して、その反復における入力、出力、およびループ内の各ステップのエラーを確認します。

ループ反復ナビゲーター

ナビゲーターには X of N iterations、たとえば 5 of 5 iterations と表示されます。 N はループが実行した反復回数です。条件またはエラーによってループが途中で停止した場合、設定された回数よりも少なくなります。

矢印を使用して反復を1回ずつ移動するか、特定の反復番号を入力します。範囲外の番号を入力すると、ナビゲーターは最も近い反復に移動します。

完了したジョブは、ループが正常完了したか未処理エラーで停止したかにかかわらず、最も深い入れ子ループの最後の反復が開きます。

入れ子になった各ループには、それぞれ専用の反復セレクターがあります。外側の反復を変更すると、その階層のすべてのステップが同期され、内側のループは最初の反復にリセットされます。

入れ子ループの反復ナビゲーター

ジョブには、その反復で実行されたステップのみが表示されます。

• この反復の一部ではないステップは、まったく表示されません。
• IF 条件および Handle errors ステップは、選択した反復で実行された場合にのみ表示されます。それぞれが独自の結果を示し、実行されたブランチだけが、その配下のステップを表示します。
• 他のループ反復では実行されたものの、選択した反復では実行されなかった IF ステップまたは Handle errors ステップは、引き継がれたデータを表示するのではなく、専用の空の状態として表示されます。

再試行を行う Handle errors ステップにはトライナビゲーターが表示され、たとえば再試行を2回に設定したステップでは 3 of 3 tries のように表示されます。このカウントには、最初の実行も含まれます。ナビゲーターを使用してトライを選択し、そのトライの入力、出力、およびエラーを確認します。

Handle errors トライナビゲーター

エラーのデバッグ ​

ジョブでエラーが発生して処理が停止すると、失敗したステップが強調表示されます。

ジョブエラー

ステップのデバッグタブを使用して、さらにトラブルシューティングできます。

最上位のエラードロップダウンメニューには、ジョブ内のすべての反復にわたるすべてのエラーが1か所に一覧表示されます。各エントリは、エラーが発生したステップと反復へのリンクになっており、次の情報を表示します。

エラードロップダウンメニューは、ループのないレシピを含むすべてのレシピで利用できます。エラードロップダウンメニューはページ分割されるため、複数の失敗があるジョブでも操作しやすくなります。

完了したジョブでは、エラードロップダウンメニューで最新のエラーが選択された状態で開きます。別のエラーを選択すると、そのステップと反復に移動します。

ジョブのエラードロップダウンメニュー

タイムアウト ​

ジョブはデフォルトで、アクティブ実行時間が90分を超えるとタイムアウトします。ワークスペース管理者は、カスタムクォータを設定できます。単一のステップもタイムアウトする場合があります。タイムアウトしたジョブのエラーメッセージには、原因に関する詳細が含まれます。

ジョブの再実行 ​

以前に完了したか失敗したかに関係なく、任意のジョブを再実行できます。 Workatoはトリガーイベントのデータを保存し、このトリガーイベントのコピーを使用してジョブを再実行します。

ジョブの再実行では、常に最新バージョンのレシピが使用されます。ジョブの前回実行後にレシピが変更されている場合、再実行では最新バージョンが使用されます。

詳細については、ジョブの再実行を参照してください。