評価と効果のエラー

このページでは、Automate の使用時に発生する可能性がある一般的なエラーのカテゴリーについて説明します。

評価エラー

基になるデータの問題により、自動化の評価に失敗することがあります。自動化は自動的に再試行されますが、エラーによっては手動での対応が必要になる場合があります。たとえば、監視対象のオブジェクトタイプが削除されると、そのタイプを使用する自動化の評価に失敗します。

自動化の同期ずれ

自動化では、保存済みの探索への参照を使用して入力を定義できます。この参照は動的ではなく、自動化が保存された時点の探索の状態に基づいて保存されます。探索が変更されても、自動化を更新しない限り、自動化は探索の以前の状態を使用して評価を続けます。この場合、自動化に警告バナーが表示されます。

スナップショットの有効期限切れエラー

大規模なオブジェクトセットを使用する自動化を手動で実行すると、スナップショットの有効期限切れエラーが発生する場合があります。これは、基になるデータのスナップショットの有効期限が切れるまでに処理できないほど、オブジェクトセットが大きい場合に発生します。

未処理のオブジェクトが大量にある場合にスナップショットの有効期限切れエラーを回避するには、関数ベースのオブジェクトセットを使用して、処理可能なサイズのバッチに分けて処理します。

1. 処理が必要なオブジェクトのうち、最も古いものから N 個を返す関数を作成します。
2. この関数を呼び出す、関数により生成されたオブジェクトセットを使用するように自動化を設定します。
3. 適切なバッチサイズで自動化を手動で繰り返し実行し、実行のたびに完了を待ちます。
4. 未処理のオブジェクト数が上限を下回るまで（通常は100,000個未満）、手動での実行を続けます。
5. 未処理のオブジェクト数が処理可能な規模になれば、通常の条件ベースの自動化で、オブジェクトが到着するたびに処理できます。

手動実行および関数により生成されたオブジェクトセットについて、詳しくはこちらをご覧ください。

権限

自動化の評価には、所有者または受信者の権限が使用されます。これにより、条件の評価とその後の効果には、自動化の評価時にユーザーがアクセスできるデータが常に反映されます。ユーザーにオブジェクトタイプ、保存済みの探索、または自動化を閲覧する権限がない場合、評価が正常に完了する代わりに、権限に関するエラーメッセージが表示されることがあります。

自動化とその関連リソースは、共有のプロジェクトに保存することを強く推奨します。自動化の範囲とログの閲覧について、詳しくはこちらをご覧ください。

効果の失敗とフォールバック効果

効果の失敗に適切に対処するために、アクション、ロジック、関数の効果にフォールバック効果を設定できます。フォールバック効果は主要な効果が失敗したときに実行され、通知の送信、失敗のログ記録、代替ワークフローの開始を行えます。

失敗の伝播

失敗がどのように伝播するかは、効果の実行設定によって異なります。

• 逐次実行： 効果が失敗すると、その後に続く効果は実行されません。フォールバックが成功すると失敗は処理されますが、後続の効果の実行は再開されません。この動作はオブジェクトごとに適用されます。成功したオブジェクトは後続の効果の処理に進み、失敗したオブジェクトはフォールバックで停止します。
• 並列実行： 効果は独立して実行されます。1つの効果の失敗が、ほかの効果に影響することはありません。

アクション効果のエラー

条件の評価が正常に完了した後でも、アクション効果の実行に失敗する場合があります。この失敗には、次のようなさまざまな原因が考えられます。

• アクションのロジックが変更され、自動化に保存された入力設定と互換性がなくなっている。
• アクションの実行条件が満たされていない。
• アクションの基になる関数の実行時に失敗が発生している。

アクション効果が失敗すると、履歴タイムラインには、そのイベントで1つ以上のアクションの実行に失敗したことが、関連するエラーの詳細とともに表示されます。

オブジェクトごとの実行が有効な場合、エラーの原因として詳細に表示されるオブジェクト識別子は、失敗を引き起こした最初のリクエストに関連するオブジェクトを示します。伝播されずに表示されていない失敗が、ほかにも存在する可能性があります。

サイクルの検出

次のように定義された自動化について考えます。

• 自動化 A： 赤い車すべてからなるオブジェクトセットを監視します。新しい赤い車がオントロジーに追加されると、車の色を青に変更するアクションが起動します。
• 自動化 B： 青い車すべてからなるオブジェクトセットを監視します。新しい青い車がオントロジーに追加されると、車の色を赤に変更するアクションが起動します。

このような一連の自動化は、無限ループ、つまりサイクルを引き起こします。サイクルを引き起こすライブ自動化を自動的に検出して無効化するフレームワークが実装されています。

自動化によっては、サイクルの検出が望ましくない場合があります。最大50回のサイクルを許可するには、条件設定でサイクルを許可を選択します。このオプションは、ライブ監視が有効な場合にのみ利用可能です。

通知効果のエラー

条件の評価が正常に完了した後でも、通知の送信に失敗する場合があります。この場合、履歴イベントには、フォロワーに通知が送信されなかったことを示すタグが表示されます。追加の詳細には、エラー識別子、エラーメッセージ、および失敗を引き起こしたオブジェクトが含まれます。