注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

アクション効果

アクション効果を使用すると、自動化がトリガーされたとき、または回復したときに、アクションを自動的に実行できます。

設定

アクション効果を設定するには、まず自動化の設定ウィザードを開きます。効果ページでアクション効果を追加すると、アクション効果の設定ページが開きます。設定済みアクションには、デフォルトですでに1個のアクションが追加されており、未設定と表示されます。

この未設定のアクションから、アクションの設定を開始できます。まず、実行するアクションを検索して選択します。インターフェースには、以下の画像に示すように、選択したアクションに必要なパラメーターが表示されます。パラメーターのデータ型がサポートされている場合は、インターフェースで値を直接指定できます。

さらにアクションを追加するには、アクションを追加を選択します。新しいアクションを設定するためのタブが追加されます。複数のアクションを設定した場合、実行順序は保証されません。アクションは任意の順序で実行される可能性があります。

効果の入力を使用するアクション効果

条件の効果の入力を使用する

利用可能な入力

一部のオブジェクトセット条件は、効果の入力を公開します。これらはアクション効果で使用できます。条件の効果の入力を使用するには、アクションパラメーターのデータ型が、公開された条件の効果の入力のデータ型と一致している必要があります。たとえば、条件が Alert オブジェクトタイプを監視する場合、アクションはオブジェクトタイプが Alert のオブジェクト参照パラメーターを受け取る必要があります。

以下の条件は、効果の入力を公開します。

以下の効果の入力を公開できます。

  • オブジェクトセット
  • オブジェクトリスト
  • 単一オブジェクト
  • プロパティ参照

以下の例では、オブジェクトがセットに追加される条件が、追加された Support Tickets を含む、タイプが Support Ticket のオブジェクトセットを効果の入力として公開しています。選択された Close Support Tickets アクションは、タイプが Support Ticket のオブジェクトセットパラメーターを受け取るため、条件の効果の入力「新しく追加されたサポートチケット」を選択できます。

効果の入力を使用するアクション効果

オブジェクトセットおよびオブジェクトリストの入力は、単一オブジェクトおよびプロパティ参照の入力と組み合わせることはできません。前者は一度に複数のオブジェクトを含み、後者は一度に1個のオブジェクトを含むためです。

実行モードを設定する

効果の入力を使用する場合、実行モードを設定して、オブジェクトとアクションのグループ化方法を決めることができます。利用可能な選択肢は、効果の入力が1個の「影響を受けるオブジェクト」を対象とするか(たとえば、単一オブジェクトやプロパティ参照の入力)、複数の「影響を受けるオブジェクト」を対象とするか(オブジェクトセットやオブジェクトリストの入力など)によって異なります。

単一オブジェクトおよびプロパティ参照の入力を使用すると、条件から渡されるオブジェクトごとに各アクションが1回実行されます。同時に実行されるアクション数を変更する並列化設定をカスタマイズすることで、アクションの実行を最適化できます。

アクション効果の並列化設定

オブジェクトセットおよびオブジェクトリストの入力を使用すると、一度に複数のオブジェクトに対してアクションが実行されます。実行モードを変更すると、アクションの実行ごとのオブジェクトのグループ化方法が変わります。オブジェクトをグループ化するには、以下の選択肢を利用できます。

  • すべてのオブジェクトに対して1回実行: 複数のオブジェクトによって条件が同時にトリガーされた場合、アクションが1回実行されるようにします。
  • オブジェクトのバッチごとに1回実行: 設定されたバッチサイズを上限としてオブジェクトをバッチに分割し、バッチごとにアクションを1回実行します。バッチサイズは最大数であり、最小数ではありません。自動化は、実行前に追加のオブジェクトを待たないため、バッチに含まれるオブジェクト数が設定されたサイズより少なくなる場合があります。この選択肢を使用すると、より大きな規模で実行できるように自動化を最適化できます。
  • オブジェクトのグループごとに1回実行: 条件のオブジェクトタイプにあるプロパティでオブジェクトをグループ化します。アクションがオブジェクトセットを受け取り、そのセット内のすべてのオブジェクトで特定のプロパティの値が同じであることを前提とする場合に、この選択肢を使用します。たとえば、アクションが Support Tickets のセットを受け取り、それらが同じ Category に属することを前提とする場合、Category プロパティでグループ化すると、一度に1つの Category に対してのみアクションが実行されます。グループ化は、プロパティ値の完全一致に基づきます。配列型のプロパティでは、同じグループにまとめるには、値とその順序が完全に一致している必要があります。
アクション効果の実行モード設定

エラー処理

再試行ポリシーを含め、失敗したアクションを処理する方法を複数設定できます。利用可能な再試行ポリシーには、以下があります。

  • 固定バックオフ: イベント間に固定の待機時間を設けて、自動的に再試行します。
  • 指数バックオフ: 再試行間の待機時間が指数関数的に増加します。

また、同時に再試行されることを防ぐために、再試行間の遅延時間を変動させる ジッター の量も設定できます。ジッターは、以下のいずれかで指定できます。

  • 再試行の遅延時間をランダムに変動させる係数。再試行の遅延時間ごとに、遅延時間のランダムに選択された割合に係数を掛け、その値を遅延時間に加算または減算します。たとえば、遅延時間が 100 ms、係数が 0.25 の場合、再試行の遅延時間は 75 ms から 125 ms の間になります。
  • 再試行の遅延時間をランダムに変動させる時間幅。再試行の遅延時間ごとに、時間幅のランダムに選択された割合を遅延時間に加算または減算します。たとえば、遅延時間が 100 ms、時間幅が 20 ms の場合、再試行の遅延時間は 80ms から 120ms の間になります。

再試行を伴うエラー処理

アクション効果の実行保証と、重複して実行される可能性への対処方法については、実行設定のドキュメントにある実行保証を参照してください。

フォールバック効果

主要なアクション効果の実行に失敗したときに、代替アクションを実行するフォールバック効果も設定できます。アクション効果の設定ページで、失敗の効果を追加を選択します。フォールバック効果は、元の効果の入力、エラー情報、自動化イベントIDにアクセスできます。

詳細については、フォールバック効果を参照してください。

アクションの表示設定

すべてのアクションが Automate での使用に適しているわけではありません。Ontology Manager でアクションタイプを設定した後、そのアクションを Automate で使用できないようにすることができます。アクションタイプを作成した後、アクションタイプリストからアクションタイプを選択して詳細を表示し、左側のパネルにあるセキュリティ & 実行条件タブに移動します。次に、フロントエンド利用者セクションを見つけ、Automate によるアクションの実行を許可するスイッチをオフにします。

Ontology Manager で Foundry Automate によるアクションの実行を無効にする

権限

アクションは、自動化の所有者に関連付けられます。つまり、アクションは自動化の所有者に代わって実行されます。そのため、アクションを設定する所有者は、そのアクションの実行条件を満たす必要があります。

アクションは特定のユーザー(自動化の所有者)に代わって実行されるため、関連付けられたユーザーアカウントが無効化または削除されると、アクションは実行されなくなります。