関数の効果

関数の効果を使用すると、自動化がトリガーされたときや回復したときに、関数を自動的に実行できます。関数では、データの分析、入力の変換、計算結果の返却を行うカスタム計算ロジックを実装できます。戻り値の型がオントロジー編集の関数は、関数の効果の一部としてその編集を適用することはできません。編集を適用するには、関数ベースのアクションを使用する必要があります。

設定

関数の効果を設定するには、自動化の設定ウィザードを開きます。効果ページで関数の効果を追加すると、関数の効果の設定ページに移動します。デフォルトで1個の関数がすでに追加されており、未設定と表示されます。

まず、この未設定の関数で、実行する関数を検索して選択します。次に、関数のバージョンを指定します。安定バージョン（バージョン 1.0.0 以降）では、互換性のあるバージョンへの自動アップグレードをオンにできます。これにより、プレリリースではないバージョンが、次のメジャーバージョンに達するまで自動的にアップグレードされます。そのため、対応するより新しい関数のバージョンが利用可能になると、自動化で使用できるようになります。

関数を選択すると、選択した関数の必須パラメーターと任意のパラメーターがインターフェースに表示されます。

関数をさらに追加するには、関数を追加を選択します。別のタブが追加され、新しいアクションを設定できます。

非同期実行

関数の効果は非同期で実行されます。非同期実行がサポートされている場合、自動化は関数の実行を送信し、関数の完了を同期的に待つのではなく、結果をポーリングします。これは、計算にかなりの時間がかかる可能性のある長時間実行の関数に使用できます。関数は最大4時間実行できます。

非同期実行をサポートしていない種類の関数は、同期的に実行されます。

エラー処理

再試行戦略を含め、失敗した関数を処理する方法を複数設定できます。利用可能な再試行戦略は次のとおりです。

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

ジッターの量も設定できます。ジッターとは、同時に再試行されることを防ぐために、再試行間の遅延時間に加える変動です。ジッターは次の方法で指定できます。

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

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

権限

関数は自動化の所有者に関連付けられます。つまり、関数は自動化の所有者に代わって実行されます。関数を設定する所有者には、その関数を実行するために必要な権限が必要です。