条件

オブジェクトモニターの条件は、監視対象の新しいアクティビティをいつ検出して記録するかを定義します。しきい値条件は継続的な true または false のステータスを生成し、イベント条件は個別のイベントを生成します。条件にはいくつかのサブ条件を含めることができ、複数の入力オブジェクトセットを参照できます。オブジェクトモニターは、次の種類の条件をサポートしています。

イベント

イベント条件は、最も一般的な条件の種類です。イベント条件には、入力へのオブジェクトの追加や入力からの削除、およびメトリクスの増加や減少の条件が含まれます。各イベントは特定の時点で発生する個別のイベントです。そのため、アクティビティグラフでは点として表示されます。

以下の例では、イベント条件は単一の入力エクスプロレーションを使用し、そのエクスプロレーションで新しいオブジェクトが使用されるタイミングを確認します。オブジェクトは、新しく作成された場合や、入力を定義するフィルターに一致するように変更された場合に追加されることがあります。

一部のイベント条件では、しきい値サブ条件が必要になる場合があります。この場合、イベントを検出するには、主要条件とサブ条件の両方が true である必要があります。たとえば、しきい値サブ条件を使用して入力オブジェクトの件数の増加を検出できますが、入力セット内にすでに少なくとも N 個のオブジェクトが存在するという主要条件を満たしている場合に限られます。

しきい値

しきい値条件は入力に対して実行され、時間の経過に伴う true または false のステータスを生成します。どちらの方向でも、しきい値を越えるとアクティビティが記録されます。しきい値を使用する条件には、任意の数のネストされたサブ条件を含めることができます。

以下に、Object Monitors アプリケーションのしきい値条件の例を示します。この例では、Sales Opportunities のカスタムコホート全体の amount の合計が 10,000 より大きいかどうかを条件で確認します。

関数ベース

関数ベースの条件は、イベントルールやしきい値ルールのオプションでは対応できないものを含む、より複雑な条件定義を可能にするために設計されています。関数ベースの条件は、true または false のブール値を返す関数を定義して公開することで機能します。モニターが評価されるときに関数が呼び出され、レスポンスはその実行の結果を示す必要があります。ステータスが変化した場合は、イベントが記録されます。

関数は、監視対象のオブジェクトタイプの ObjectSet<> を受け取り、条件を満たしているかどうかを示すブール値を返す必要があります。Object Monitors で使用する関数の開発について詳しくはこちら。

以下の例では、関数を使用して、Sales Opportunity オブジェクトの入力セットについて、realized_amount の合計が expected_amount の合計より小さいかどうかを計算します。

@Function()
/**
 * この関数は、商談の集合の実現金額が、
 * すべての商談金額の合計より小さいかどうかを計算します。
 */
public async calculateOpportunityUnderRealized(opportunities: ObjectSet<SalesOpportunity>): Promise<boolean> {
    let amount = await opportunities.sum(o => o.amount)
    let amountRealized = await opportunities.sum(o => o.amountRealized)
    if (amount !== null && amountRealized !== null && amountRealized < amount) {
        return true
    } else {
        return false
    }
}