オブジェクトセット条件

事前定義されたオブジェクトセット内のオブジェクトデータが変更されると、自動化の効果を自動的にトリガーできます。

データソース： 変更は、元データセット、アクションタイプ、または外部アプリケーションから発生する場合があります。

評価の頻度： データの変更は通常、数分以内に検出されます。詳しくはこちら

効果の入力パラメーター： 一部のオブジェクトセット条件では、効果の入力パラメーターが公開されます。これらの変数を効果内で使用すると、自動化をトリガーしたオブジェクトにアクセスできます。

利用可能な条件

• セットに追加される： 新しいオブジェクトがセットに現れるとトリガーされます。
• セットから外れる： オブジェクトがセットから外れるとトリガーされます。
• セット内でオブジェクトが変更される： セット内のオブジェクトが変更されるとトリガーされます。
• すべてのオブジェクトで実行： 指定したオブジェクトセット内のすべてのオブジェクトに対して、効果を定期的に実行します。
• しきい値を超える： メトリクスのしきい値を超えた場合、または関数が true を返した場合にトリガーされます。
• メトリクスが変更される [サンセット]： 集計されたメトリクスが増加または減少するとトリガーされます。

オブジェクトセットの定義

ほとんどのオブジェクトセット条件の種類では、監視するオブジェクトセットを指定する必要があります。次の方法を使用できます。

• オブジェクトセットを動的に定義する
• 保存済みのオブジェクトセットを選択する
• オブジェクトセットを返す関数を選択する
  • 関数は、Automate のより高度な使い方を可能にする強力な構成要素です。

監視するオブジェクトセットを定義したら、プレビューを選択して、期待されるオブジェクトがオブジェクトセットに含まれていることを確認します。

オブジェクトセットを動的に定義する場合は、目的のオブジェクトタイプを選択し、必要に応じてフィルターを適用してセットを絞り込みます。たとえば、Support Ticket オブジェクトタイプ（下図）を「ステータス = オープン」で絞り込んで監視できます。フィルターを選択しない場合は、そのタイプのすべてのオブジェクトを監視します。オブジェクトタイプとフィルターの選択によって、オブジェクトセットをライブで監視できるか、スケジュールに従って監視できるかが決まります。詳しくはこちら。

関数により生成されたオブジェクトセット

次の例では、関数を使用して、ユーザーにリンクされたサポートチケットを返します。オブジェクトが追加されました条件で使用すると、新しいチケットがこのセットに追加されるたびに効果が実行されます。ここで使用するには、関数が ObjectSet<T> を返す必要があります。

評価中、この関数はシステムに対して1回実行され、さらにフォロワーごとに1回実行されます。

Copied!
1
2
3
4
5
6
7
8
9
/**
 * この関数は、ユーザーにリンクされたサポートチケットを返します
 */
@Function()
public getSupportTicketsLinkedToUsers(): ObjectSet<DemoTicket> {
    return Objects.search()
        .users()
        .searchAroundSupportTickets()
}

Automate で使用する関数の開発について詳しく確認し、このセクションの関数の例を参照してください。

条件タイプ

オブジェクトがセットに追加される

オブジェクトがセットに追加される条件は、事前定義したオブジェクトセットにオブジェクトが追加されるたびにトリガーされます。まず、上記のオブジェクトセットの定義に関するセクションに従って、オブジェクトセットを指定します。

オブジェクトセットのフィルターを指定した場合、新しいオブジェクトや、ほかのユーザーによるオブジェクトの編集によって、オブジェクトがセットに追加される条件がトリガーされることがあります。以下の例では、ステータスプロパティの値が Open のサポートチケットのオブジェクトセットを監視しています。この条件は、ステータスが Open の新しいサポートチケットオブジェクトが作成された場合、または既存のサポートチケットのステータスが Open に変わった場合の2通りでトリガーされる可能性があります。

オブジェクトセットにフィルターを指定しない場合、実質的にそのタイプのすべてのオブジェクトを監視することになります。つまり、まったく新しいオブジェクトがオントロジーに追加されたときにのみ、自動化がトリガーされます。

オブジェクトがセットに追加される条件は、条件をトリガーしたオブジェクトを効果の入力として提供します。これは、単一の「追加されたオブジェクト」、「追加されたオブジェクト」のオブジェクトセット、または「追加されたオブジェクト」のプロパティにできます。効果の入力の使用方法について詳しくはこちら。

対応する評価頻度：

• ライブ評価
• スケジュール評価

オブジェクトがセットから外れる

オブジェクトがセットから外れる条件は、事前定義したオブジェクトセットからオブジェクトが外れるたびにトリガーされます。まず、上記のオブジェクトセットの定義に関するセクションに従って、オブジェクトセットを指定します。

オブジェクトセットのフィルターを指定した場合、ユーザーによるオブジェクトの編集によって、オブジェクトがセットから外れる条件がトリガーされることがあります。たとえば、ステータスプロパティの値が Open のサポートチケットのオブジェクトセットを監視している場合、Open のチケットのステータスがほかのステータスに変わると、この条件がトリガーされます。

オントロジーから削除されたオブジェクトは、この条件をトリガーしません。

オブジェクトがセットから外れる条件は、条件をトリガーしたオブジェクトを効果の入力として提供します。これは、単一の「セットから外れるオブジェクト」、または「セットから外れるオブジェクト」のオブジェクトセットにできます。効果の入力の使用方法について詳しくはこちら。

対応する評価頻度：

• ライブ評価
• スケジュール評価

オブジェクトがセット内で変更される

オブジェクトがセット内で変更される条件は、事前定義したオブジェクトセット内のオブジェクトが変更されるたびにトリガーされます。この条件タイプを使用して、オブジェクトセット内の任意のプロパティ値の変更を監視します。特定の値への変更のみを監視する場合は、代わりにオブジェクトがセットに追加される条件を使用します。

まず、上記のオブジェクトセットの定義に関するセクションに従って、オブジェクトセットを指定します。その後、必要に応じて、監視する特定のプロパティを選択できます。プロパティを選択しない場合、監視対象のオブジェクトセット内でプロパティが変更されると、どのプロパティであっても自動化がトリガーされます。

さらに、追加されたオブジェクトを含めるとセットから外れるオブジェクトを含めるを指定できます。これらのオプションは、監視対象のオブジェクトセットに追加される（またはセットから外れる）オブジェクトの変更によって、自動化がトリガーされるかどうかを制御します。両方のオプションが無効の場合、すでにオブジェクトセットに含まれていて、変更後もオブジェクトセットに残るオブジェクトのみが自動化をトリガーします。

オブジェクトがセット内で変更される条件は、条件をトリガーした単一の「変更されたオブジェクト」、または「変更されたオブジェクト」のセットを効果の入力として提供します。効果の入力について詳しくはこちら。

対応する評価頻度：

• ライブ評価

以下の例では、場所が USA のサポートチケットのセット内で変更されるオブジェクトを監視しています。

• 追加されたオブジェクトを含める： 有効。 オブジェクトセットに追加されるオブジェクトは、変更されたと見なされます。そのため、場所が UK から USA に変わったサポートチケットは自動化をトリガーします。また、場所が USA の新しく作成されたチケットも自動化をトリガーします。
• セットから外れるオブジェクトを含める：無効。場所が変わる（たとえば、USA から UK に変わる）と同時にステータスプロパティが Open から Closed に変わるチケットは、オブジェクトがセットから外れるため、自動化をトリガーしません。
• 削除されたサポートチケットは、監視対象のオブジェクトセットに含まれなくなったため、自動化をトリガーしません。

すべてのオブジェクトに対して実行

すべてのオブジェクトに対して実行条件は、指定したオブジェクトセット内のすべてのオブジェクトに対して、効果を定期的に実行できます。この条件は、スケジュールと組み合わせて設定します。

この条件を使用する場合、「影響を受けるオブジェクト」パラメーターを設定して、任意の効果にオブジェクトを渡すことができます。この条件では、バッチサイズと並列化の設定が適用されます。バッチ処理が行われるため、関数やアクションのタイムアウトを回避しながら、大規模なオブジェクトセットに対して効果を実行できます。

対応する評価頻度：

• スケジュール評価
• 自動化依存の評価

しきい値を超える

しきい値を超える条件は、定義したすべてのチェックが true を返したときにトリガーされます。どちらの方向でも、しきい値をまたぐたびに効果がトリガーされ、アクティビティが記録されます。

Automate で定義したロジック、関数ベースのロジック、またはその両方で構成される条件を組み合わせることができます。

対応する評価頻度：

• スケジュール評価

Automate で定義したロジック

自動化のインターフェースでしきい値条件を定義するには、以下の手順に従います。

1. 条件設定セクションで、条件を追加を選択します。
2. 条件タイプとして条件を選択します。
3. メトリクスの入力として使用する保存済みオブジェクトセットを指定します。
4. メトリクスを選択ドロップダウンメニューで、比較するプロパティを選択します。
5. 比較演算子を選択します。
6. プロパティの比較対象となるメトリクスまたは固定値を選択します。

以下は、Automate のインターフェースでロジックを定義した、しきい値を超える条件の例です。この条件は、ニューヨークにあるすべての空気質センサーの最大値が 0.05 より小さいかどうかをチェックします。

関数ベースのロジック

インターフェースで定義する条件では対応できない複雑なシナリオには、関数ベースのロジック条件を使用します。関数ベースの条件は、ブール値（true または false）を返す関数を定義して公開することで機能します。評価時に関数が呼び出され、ステータスが変わるとイベントが記録されます。

Automate 向けの関数の開発について詳しくはこちら。

以下の関数の例は、空気質センサーの50%を超える数が異常かどうかを計算します。条件が満たされる場合、関数は true を返します。条件が満たされない場合、関数は false を返します。

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
/**
 * この関数は、渡された大気質センサーの50%超が異常とみなされるかどうかを計算します。
 * 一酸化炭素の値が `0.05` を超えると、センサーは異常とみなされます。
 */
@Function()
public async areMoreThanFiftyPercentOfSensorsUnhealthy (airQualitySensors: ObjectSet<automateExampleAirQualitySensor>): Promise<boolean> {
    const totalSensorCount = await airQualitySensors.count();
    const unhealthySensorCount = await airQualitySensors.filter(sensor => sensor.carbonMonoxide.range().gt(0.05)).count();
    if (totalSensorCount === null) {
        return false;
    }

    return ((unhealthySensorCount ?? 0) / totalSensorCount) > 0.5;
}

メトリクスが変化する [サンセット]

メトリクスが変化する条件は、事前に定義したオブジェクトセット内で、オブジェクトセットのメトリクスが変化するたびにトリガーされます。メトリクスの例として、セット内のオブジェクトの総件数や、オブジェクトの数値型のプロパティ値の平均などの集計値があります。まず、上記のオブジェクトセットの定義セクションに従ってオブジェクトセットを指定します。

監視するメトリクスのプロパティを選択します。

• オブジェクトセット内のオブジェクトの総件数、または
• 監視対象のオブジェクトセット全体における数値型のプロパティの集計値（平均、最大値、最小値、または合計）。

タイプを変更ドロップダウンメニューで、メトリクスの増加または減少のどちらを検知するかを選択します。たとえば、以下に示すように、ニューヨークのすべての大気質センサーにおける一酸化炭素の値の平均が増加するたびに、自動化をトリガーできます。

サポートされる評価頻度：

• スケジュールされた評価