Analytics Builder ブロックリファレンス

すべてのブロックの概要

次の表は、モデルエディタのパレットから選択できるすべてのブロックの簡単な説明をアルファベット順に示しています (自分で作成したカスタムブロックを除く)。

ブロック名	説明
アラーム入力	グループ内のデバイスから Alarm オブジェクトを受信し、タイムスタンプに基づいてそれらのオブジェクトを並べ替えます
アラーム出力	事前設定されたアラーム名とパラメーターを使用して、指定されたデバイス、アセット、またはトリガーデバイス用の新しい Alarm オブジェクトを作成します
AND	入力に対して論理「and」を実行します
平均値 (平均)	時間の経過に伴う値の平均を計算します
結合要素	選択したモードと接続された入力に基づいて出力を計算します
定数値	トリガー入力ポートが信号を受信したとき、または起動時に値を出力します
カウンター	合計入力数と繰り返された入力数を示します
Cron Timer	cron のような定期タイマー構文に基づいて信号出力を送信します
超過数カウンター	指定された方向のしきい値交差の数を検出してカウントします
差分	連続する入力値の差を計算します
相違	接続された入力間の絶対差と符号付きの差を計算します
方向検出	入力値の方向が変化したかどうかを検出します
個別統計	離散入力値の合計、カウント、平均（平均）、標準偏差、最小値と最大値の統計を生成します
持続時間	設定した開始時刻からの経過時間を計測します
イベント入力	グループ内のデバイスから Event オブジェクトを受信し、タイムスタンプに基づいてそれらのオブジェクトを並べ替えます
イベント出力	指定されたデバイス、アセット、またはトリガーデバイスの新しい Event オブジェクトを作成します
式	式を評価して、算術計算、論理計算、または文字列操作を実行します
プロパティの抽出	入力値から指定されたプロパティを抽出し、指定された型に変換します
ベース N から	基数 N の文字列を float に変換します
ゲート	ゲートが開いていて有効になっていない限り、入力が出力に送られるのをブロックします
ジオフェンス	入力値を定義されたジオフェンス値と比較して、デバイスがジオフェンス内にあるかどうか、およびデバイスがジオフェンスに出入りしたかどうかを検出します
勾配	値の加重線形回帰勾配を計算します
グループ統計	ブロックが入力値を受け取ったグループ内のすべてのデバイスにわたって定期的な集計値を生成します
インテグラル	時間の経過に伴う入力値の積分を計算します
KPI	値を KPI (主要業績評価指標) またはデバイスのデータポイントと比較します
ラッチ値	ブロックが有効になっている間に受信した最新の入力値をラッチします
限度	定義された上限値と下限値の範囲内に収まる値を出力します
Machine Learning	(非推奨) 入力データをスコアリングする指定された機械学習モデルを呼び出します
管理対象オブジェクト入力	グループ内の 1 つまたは複数のデバイスから ManagedObject オブジェクトを受信します
管理対象オブジェクト出力	指定されたデバイス、アセット、またはトリガーデバイスの ManagedObject オブジェクトを更新します
測定入力	グループ内のデバイスから Measurement オブジェクトを受信し、タイムスタンプに基づいて並べ替えます
測定出力	指定されたデバイス、アセット、またはトリガーデバイスの新しい Measurement オブジェクトを作成します
最小値 / 最大値	時間の経過に伴う値の最小値と最大値を計算します
不足データ	設定された時間の間入力が発生しなかった場合に出力を生成します
NOT	入力に対して論理「not」を実行します
操作入力	グループ内のデバイスから Operation オブジェクトを受信します
操作出力	指定されたデバイス、アセット、またはトリガーデバイスの新しい Operation オブジェクトを作成します
OR	入力に対して論理「OR」を実行します
位置入力	グループ内のデバイスから Event オブジェクトを受信し、c8y_Position フラグメントを Value オブジェクトに抽出します
パルス	非パルス入力をパルス出力に変換します
範囲	入力値を定義された範囲の下限値および上限値と比較して、入力が範囲内か範囲外か、または範囲を超えているかどうかを検出します
範囲参照	入力値が含まれる範囲を検索します
丸め	選択可能なルールを使用して、入力を指定された小数点以下の桁数または整数に丸めます
セレクター	どの入力ポートが true 値を持つかに応じてパラメーター値を出力し、最小値が優先されます
電子メールの送信	指定された電子メールアドレスに電子メールを送信します
SMS を送信	指定した電話番号に SMS (ショートメッセージサービス) を送信します
プロパティの設定	入力ポートの値から設定されたプロパティを使用してパルスを出力します
標準偏差	時間の経過に伴う値の標準偏差と分散を計算します
スイッチ	指定された入力から値を出力するか、サーキットブレーカーとして機能します
テキストの代替	テキストテンプレート内のハッシュと中括弧でマークされた識別子 (#{name} など) を、入力値の対応するエントリに置き換えます
しきい値	入力値を定義されたしきい値と比較して、入力がしきい値に違反しているかどうか、またはしきい値を超えているかどうかを検出します
時間遅延	指定された時間だけ入力を遅らせます
ベース N へ	float を基数 N の文字列に変換します
切り替え	オプションの遅延を使用して、セット信号とリセット信号に基づいて 2 つのパルス入力をブール出力に変換します

入力

このカテゴリには、次のブロックが含まれます。

ブロック名	説明
アラーム入力	グループ内のデバイスから Alarm オブジェクトを受信し、タイムスタンプに基づいてそれらのオブジェクトを並べ替えます
イベント入力	グループ内のデバイスから Event オブジェクトを受信し、タイムスタンプに基づいてそれらのオブジェクトを並べ替えます
マネージドオブジェクト入力	グループ内の 1 つまたは複数のデバイスから ManagedObject オブジェクトを受信します
測定入力	グループ内のデバイスから Measurement オブジェクトを受信し、タイムスタンプに基づいて並べ替えます
操作入力	グループ内のデバイスから Operation オブジェクトを受信します
位置入力	グループ内のデバイスから Event オブジェクトを受信し、c8y_Position フラグメントを Value オブジェクトに抽出します

アラーム入力

apama.analyticskit.blocks.cumulocity.AlarmInput

グループ内の 1 つまたは複数のデバイスから Alarm オブジェクトを受信し、タイムスタンプに基づいてそれらのオブジェクトを並べ替えます。

「アラームステータス」パラメーターが「アクティブ」の場合、「タイムスタンプを無視」パラメーターが設定されていない限り、アラームはタイムスタンプに基づいて並べ替えられます (古すぎる場合は削除されます)。それ以外の場合、データは受信時に処理されます。

ブロックの入力ストリームを定義するパラメーターは、「入力ソース」と「アラームタイプ」です。このブロックが別のモデルのアラーム出力ブロックと同じ「入力ソース」および「アラームタイプ」パラメーターで構成されている場合、各ブロックが Alarm オブジェクトの同じストリームを参照するため、モデル間の接続が形成されます。

注: シミュレーションモードで実行する場合、アラームの作成時間のみが保存されるため、アラームのステータスはアクティブである必要があります。

パラメーター

名前	説明	タイプ	注釈
アラームタイプ	ブロックが監視するアラームのタイプ	string
入力ソース	アラームの受信元のデバイスまたはデバイスのグループを定義しますこれは、単一のデバイス、またはデバイスのグループを参照または含むオブジェクトの場合があります。	any
重大度	アラームの重大度。指定しない場合、ブロックはすべてのアラーム重大度を監視します	オプション - 次のいずれか 1 つクリティカルメジャーマイナー警告	オプション
アラームステータス	アラームのステータス。指定しない場合、ブロックはあらゆるステータスのアラームを監視します	オプション - 次のいずれか 1 つアクティブ了承しましたクリア済み	オプション
通知モード	新しいアラーム、更新されたアラーム、またはすべてのアラームのみが処理されるように、アラームイベントをフィルタリングします。デフォルトでは、すべてのアラームが処理されます	オプション - 次のいずれか 1 つすべてアップデートのみ新しいアラームのみ	デフォルト: すべて
タイムスタンプを無視	これを選択すると、受信アラームのタイムスタンプが無視されます。注: シミュレーションモードで実行する場合、履歴入力データが使用されるため、タイムスタンプは無視されません	boolean	デフォルト: False

出力ポートの詳細

名前	説明	タイプ
アラーム	追加のプロパティを使用して、受信した各 Alarm オブジェクトのパルス出力を生成します	pulse

イベント入力

apama.analyticskit.blocks.cumulocity.DeviceEventInput

グループ内のデバイスから Event オブジェクトを受信し、タイムスタンプに基づいてそれらのオブジェクトを並べ替えます。

「タイムスタンプを無視」パラメーターが設定されている場合、ブロックはイベントのタイムスタンプを無視し、受信したイベントを処理します。それ以外の場合は、古いイベントを削除します。

ブロックの入力ストリームを定義するパラメーターは、「入力ソース」と「イベント型」です。このブロックが別のモデルのイベント出力ブロックと同じ「入力ソース」および「イベント型」パラメーターで構成されている場合、各ブロックが Event オブジェクトの同じストリームを参照するため、モデル間の接続が形成されます。

注: シミュレーションモードで実行する場合、履歴入力データが使用されるため、タイムスタンプは無視されません。

注: Event オブジェクトの変更履歴は保持されないため、インベントリから元のオブジェクトを取得することはできません。このため、この入力ブロックタイプを含むモデルは、シミュレーションモードでは本番モードとは異なる動作をする可能性があります。

パラメーター

名前	説明	タイプ	注釈
入力ソース	イベントの受信元のデバイスまたはデバイスのグループを定義しますこれは、単一のデバイス、またはデバイスのグループを参照または含むオブジェクトの場合があります。	any
イベントタイプ	ブロックが監視するイベント型	string
通知モード	新しいイベント、更新されたイベント、またはすべてのイベントのみが処理されるように、イベントをフィルタリングします。デフォルトでは、すべてのイベントが処理されます	オプション - 次のいずれか 1 つすべてアップデートのみ新しいイベントのみ	デフォルト: すべて
タイムスタンプを無視	これを選択すると、受信イベントのタイムスタンプが無視されます。注: シミュレーションモードで実行する場合、履歴入力データが使用されるため、タイムスタンプは無視されません	boolean	デフォルト: False

出力ポートの詳細

名前	説明	タイプ
イベント	追加のプロパティを使用して、受信した各 Event オブジェクトのパルス出力を生成します	pulse

マネージドオブジェクト入力

apama.analyticskit.blocks.cumulocity.ManagedObjectInput

グループ内の 1 つまたは複数のデバイスから ManagedObject オブジェクトを受信します。

ブロックは、受信した ManagedObject オブジェクトを並べ替えず、受信したとおりに処理します。プロパティ名パラメーターが指定されている場合、指定されたプロパティの値が最後の出力以降変更されていない場合、同じ ManagedObject オブジェクトの他のプロパティが変更された場合でも、ブロックは新しい出力を生成しません。

ブロックからの「値」出力には、プロパティ名パラメーターで指定されたプロパティを含む、ManagedObject オブジェクトのすべてのプロパティが含まれます。プロパティ値には、プロパティの抽出ブロックを使用してアクセスできます。

string、boolean、または float 型の値を持つプロパティには、プロパティの抽出ブロックでプロパティの名前を指定することでアクセスできます。たとえば、プロパティの名前が ap_State の場合、プロパティの抽出ブロックのプロパティパスパラメーターの値として ap_State を指定します。

プロパティ値のタイプが JSON オブジェクトまたはシーケンスである場合、ネストされた値へのフルパスをプロパティの名前として指定することで、ネストされた値にアクセスできます。

たとえば、プロパティの名前が c8y_SpeedMeasurement で、値が { "Speed": { "value": 1234, "unit": "km/h" } } の場合 (JSON 形式) を入力し、プロパティの抽出ブロックのプロパティパスパラメーターの値として c8y_SpeedMeasurement.Speed.unit を指定して、単位の値を抽出します。

ManagedObject オブジェクトに関連付けられた位置データはすべて c8y_Position プロパティとして利用でき、プロパティの抽出ブロックを使用して抽出できます。

このブロックのプロパティ名パラメーターで指定されたプロパティの値が string、boolean、または float 型の場合、その値も次のようになります。これは、「値」出力ポートで直接利用でき、プロパティの抽出ブロック (式ブロックや相違ブロックなど) を使用せずに、その型の値を消費するブロックで直接消費できます。

ブロックの入力ストリームを定義するパラメーターは、「入力ソース」と「プロパティ名」です。

パラメーター

名前	説明	タイプ	注釈
入力ソース	管理対象オブジェクトの受信元のデバイスまたはデバイスのグループを定義しますこれは、単一のデバイス、またはデバイスのグループを参照または含むオブジェクトの場合があります。	any
プロパティ名	監視するプロパティの名前 ManagedObject オブジェクトにはこの名前のプロパティがなければなりません。そうでない場合は無視されます。設定されていない場合、オブジェクトはフィルタリングされません。更新のたびに、マネージドオブジェクトのすべてのプロパティを含むパルス出力が生成されます。	string	オプション
開始値のキャプチャ	モデル起動時の初期値を出力します	boolean	デフォルト: False

出力ポートの詳細

名前	説明	タイプ
値	受信した各 ManagedObject オブジェクトの出力を生成しますマネージドオブジェクトのすべてのプロパティは追加プロパティとして使用できます。プロパティの抽出ブロックを使用して、その値にアクセスできます。	any

測定入力

apama.analyticskit.blocks.cumulocity.DeviceMeasurementInput

グループ内のデバイスから Measurement オブジェクトを受信し、タイムスタンプに基づいて並べ替えます。

「タイムスタンプを無視」パラメーターが設定されている場合、ブロックはメジャーメントのタイムスタンプを無視し、メジャーメントを受信したときに処理します。それ以外の場合は、古いメジャーメントが削除されます。

入力にグループを使用する場合は、グループ内のデバイスを選択してフラグメントとシリーズを選択し、目的のグループに変更します。

ブロックの出力ストリームを定義するパラメーターは、「入力ソース」と「フラグメントとシリーズ」です。このブロックが別のモデルの測定出力ブロックと同じ「入力ソース」および「フラグメントとシリーズ」パラメーターで構成されている場合、各ブロックが Measurement の同じストリームを参照するため、モデル間の接続が形成されます。オブジェクト。

注: シミュレーションモードで実行する場合、履歴入力データが使用されるため、タイムスタンプは無視されません

パラメーター

名前	説明	タイプ	注釈
入力ソース	メジャーメントの受信元のデバイスまたはデバイスのグループを定義しますこれは、単一のデバイス、またはデバイスのグループを参照または含むオブジェクトの場合があります。	any
フラグメントおよびシリーズ	ブロックが監視するフラグメントこれには、選択したオブジェクト (デバイスまたはグループ) に関連付けられたメジャーメントのフラグメントとシリーズのみが表示されます。グループ内のデバイスのメジャーメントは、デバイスが選択されている場合にのみ表示されます (そのグループをソースとして使用するメジャーメントがある場合を除く)。たとえば、温度メジャーメントが摂氏で送信される場合、フラグメントは T であり、シリーズは C(Celsius) です。つまり、このパラメーターは T.C または T=>C として設定できます。	string
タイムスタンプを無視	選択すると、受信測定のタイムスタンプは無視されます。注: シミュレーションモードで実行する場合、履歴入力データが使用されるため、タイムスタンプは無視されません	boolean	デフォルト: False

出力ポートの詳細

名前	説明	タイプ
値	メジャーメントオブジェクトからの数値	float

操作入力

apama.analyticskit.blocks.cumulocity.OperationInput

グループ内のデバイスから Operation オブジェクトを受信します。

ブロックは、受信した Operation オブジェクトを並べ替えず、受信したとおりに操作を処理します。ブロックは、指定されたステータスまたはプロパティを持つ操作のみを処理するようにオプションで構成できます。

ブロックからの出力には、Operation オブジェクトのすべてのプロパティが含まれます。プロパティ値には、プロパティの抽出ブロックを使用してアクセスできます。

ブロックの入力ストリームを定義するパラメーターは入力ソースです。

注: Operation オブジェクトの変更履歴は保持されないため、インベントリから元のオブジェクトを取得することはできません。このため、この入力ブロックタイプを含むモデルは、シミュレーションモードでは本番モードとは異なる動作をする可能性があります。

パラメーター

名前	説明	タイプ	注釈
入力ソース	操作の受信元のデバイスまたはデバイスのグループを定義しますこれは、単一のデバイス、またはデバイスのグループを参照または含むオブジェクトの場合があります。	any
オペレーション名	ブロックが監視するオペレーションの名前指定した場合、Operation オブジェクトにはこの名前のプロパティがなければなりません。そうでない場合は無視されます。	string	オプション
操作ステータス	監視するステータス指定しない場合、ブロックはあらゆるステータスの操作を監視します。	オプション - 次のいずれか 1 つ成功しました失敗しました実行中保留中	オプション
通知モード	新しい操作のみ、更新された操作、またはすべての操作が処理されるように、操作イベントをフィルターします。デフォルトでは、すべての操作が処理されます	オプション - 次のいずれか 1 つすべてアップデートのみ新しい操作のみ	デフォルト: すべて

出力ポートの詳細

名前	説明	タイプ
オペレーション	受信した各 Operation オブジェクトに対してパルス出力を生成します Operation オブジェクトのすべてのプロパティは追加プロパティとして使用できます。プロパティの抽出ブロックを使用して、その値にアクセスできます。	pulse

位置入力

apama.analyticsbuilder.blocks.PositionInput

グループ内のデバイスから Event オブジェクトを受信し、c8y_Position フラグメントを Value オブジェクトに抽出します。

c8y_Position フラグメントが存在しない場合、イベントは無視されます。フラグメントに少なくとも有効な緯度と有効な経度が含まれていない場合、イベントは無視されます。プライマリ値パラメーターが高度に設定されており、フラグメントに高度が含まれていない場合、イベントは無視されます。緯度は -90 度から 90 度までの範囲にする必要があります。経度は -180 度から 180 度までの範囲にする必要があります。

出力 Value オブジェクトの主な値は、緯度、経度、または高度に設定できます。 c8y_Position フラグメントのすべてのメンバーが、Value オブジェクトのプロパティディクショナリに追加されます。

「タイムスタンプを無視」パラメーターが設定されている場合、ブロックはイベントのタイムスタンプを無視し、受信したメジャーメントを処理します。それ以外の場合は、イベントの順序を変更し、古いメジャーメントを削除します。

ブロックの入力ストリームを定義するパラメーターは、「入力ソース」であり、設定されている場合は「イベント型」です。

注: シミュレーションモードで実行する場合、履歴入力データが使用されるため、タイムスタンプは無視されません。

注: Event オブジェクトの変更履歴は保持されないため、インベントリから元のオブジェクトを取得することはできません。このため、この入力ブロックタイプを含むモデルは、シミュレーションモードでは本稼働モードとは異なる動作をする可能性があります。

パラメーター

名前	説明	タイプ	注釈
入力ソース	位置の受信元となるデバイスまたはデバイスのグループを定義しますこれは、単一のデバイス、またはデバイスのグループを参照または含むオブジェクトの場合があります。	any
イベントタイプ	ブロックが監視するイベント型。設定しないままにすると、タイプによるフィルタリングは行われません別のモデルからイベントを使用するには、このプロパティを設定する必要があります。	string	オプション
通知モード	新しいイベント、更新されたイベント、またはすべてのイベントのみが処理されるように、イベントイベントをフィルタリングしますデフォルトでは、すべてのイベントが処理されます。	オプション - 次のいずれか 1 つすべてアップデートのみ新しいイベントのみ	デフォルト: 新しいイベントのみ
タイムスタンプを無視	選択すると、受信測定のタイムスタンプは無視されます。注: シミュレーションモードで実行する場合、履歴入力データが使用されるため、タイムスタンプは無視されません	boolean	デフォルト: False
プライマリ値	ブロックによって出力される主な値: 緯度、経度、高度、または設定されていない場合は空	オプション - 次のいずれか 1 つ緯度経度高度	オプション

出力ポートの詳細

名前	説明	タイプ
位置	少なくとも緯度と経度を含むオブジェクト	any

出力

このカテゴリには、次のブロックが含まれます。

ブロック名	説明
アラーム出力	事前設定されたアラーム名とパラメーターを使用して、指定されたデバイス、アセット、またはトリガーデバイス用の新しい Alarm オブジェクトを作成します
イベント出力	指定されたデバイス、アセット、またはトリガーデバイスの新しい Event オブジェクトを作成します
マネージドオブジェクト出力	指定されたデバイス、アセット、またはトリガーデバイスの ManagedObject オブジェクトを更新します
測定出力	指定されたデバイス、アセット、またはトリガーデバイスの新しい Measurement オブジェクトを作成します
オペレーション出力	指定されたデバイス、アセット、またはトリガーデバイスの新しい Operation オブジェクトを作成します
電子メールの送信	指定された電子メールアドレスに電子メールを送信します

アラーム出力

apama.analyticskit.blocks.cumulocity.CreateAlarm

指定されたデバイス、アセット、または事前設定されたアラーム名とパラメーターを使用してトリガーデバイス用に新しい Alarm オブジェクトを作成します。

このブロックは同期出力を生成します。出力ストリームを定義するパラメーターは「出力先」と「アラームタイプ」です。

「アラームの作成」が繰り返し提供されると、アラームの数が増加します (アラームがクリアされていない限り)。重大度またはメッセージが変更された場合、カウントは増加せず、代わりに既存のアラームが変更されます。アラームが確認された場合、アラームのステータスは重大度が増加した場合にのみアクティブになります。既存のアラームを変更するたびにアラームを再アクティブ化するには、「常にアラームをアクティブ化」パラメーターを使用します。

アラーム出力ブロックのデフォルトの動作では、同期出力が生成されます。Analytics Builder フレームワークは、同期出力の生成時にループを引き起こす可能性のあるモデルを明示的に禁止します。ただし、非同期出力が生成される場合、そのような検証は無効になります。したがって、[非同期出力の作成] パラメーターを使用する場合は、特別な注意が必要です。これにより、モデルの実行中に (同じモデルまたは複数のモデルにわたって) 無限ループが発生し、パフォーマンスの低下やアプリケーションのメモリー不足につながる可能性があります。たとえば、モデルが特定のタイプのアラーム入力を消費し、同じデバイスに対して同じタイプのアラーム出力を生成すると、ループが発生する可能性があります。モデルによって生成された出力は、同じモデルによって入力として消費され、ループが発生します。

パラメーター

名前	説明	タイプ	注釈
出力先	アラームが関連付けられているデバイス (またはデバイスのグループを処理するモデルの場合は、デバイスまたはアセットをトリガー)。アセットは、クロスデバイス集計の送信にのみ使用できますモデルエディタはデバイス名を使用します。これは内部でデバイス識別子にマッピングされます。	any
アラームタイプ	このアラームのタイプを識別します（例: 「com_cumulocity_events_TamperEvent」）	string
メッセージ	アラームがトリガーされた場合に表示されるテキスト。メッセージはパラメーターまたは入力によって設定されます。両方が設定されていない場合は、モデル名が使用されます。両方を設定することはできません	string	オプション
重大度	アラームの重大度。重大度は、このパラメーターまたは入力ポートによって設定されます。いずれか 1 つだけを設定する必要があります	オプション - 次のいずれか 1 つクリティカルメジャーマイナー警告	オプション
パラメーターのフラグメント	このパラメーターが設定されている場合、プロパティ入力ポートの受信プロパティが、生成されたアラーム内のこのフラグメントに追加されます。これが設定されていない場合、プロパティはアラームパラメーターの最上位にコピーされます	string	オプション
非同期出力の作成	アラームの作成またはアラームのクリアを非同期で実行できるようにします非同期出力イベントは、ソースのタイムスタンプを持たず、プラットフォームから受信したときに別のモデルによってのみ時間非同期で使用できるイベントです。注意: アラーム出力ブロックのデフォルトの動作では、同期出力が生成されます。Analytics Builder フレームワークは、同期出力の生成時にループを引き起こす可能性のあるモデルを明示的に禁止します。ただし、非同期出力が生成されている場合、そのような検証は無効になります。したがって、「非同期出力の作成」パラメーターを使用する場合は、特別な注意が必要です。これにより、モデルの実行中に (同じモデルまたは複数のモデルにわたって) 無限ループが発生し、パフォーマンスの低下やアプリケーションのメモリー不足につながる可能性があります。たとえば、モデルがタイプ foo のアラーム入力を消費し、同じデバイスに対してタイプ foo のアラーム出力を生成すると、ループが発生する可能性があります。モデルによって生成された出力は、同じモデルによって入力として再び消費され、ループが発生します。	boolean	オプション
常にアラームをアクティブ化	これを選択すると、ブロックによって生成されるすべてのアラームがアクティブに設定されます。デフォルト (未選択) では、アラームが確認された場合、アラームは重大度が増加した場合にのみ再アクティブ化されます	boolean	オプション

入力ポートの詳細

名前	説明	タイプ
アラームの作成	信号を受信し、重大度の値が設定されている場合にアラームを作成します	pulse
アラームのクリア	信号を受信すると、既存のアラームのステータスをクリア済みに更新します	pulse
重大度	アラームの重大度 - 重大度値 (警告、マイナー、メジャー、クリティカル) またはクリア済みのいずれかにする必要があります	string
メッセージ	アラームのメッセージ	string
時間	アラームのタイムスタンプを設定します。接続されていない場合は、現在のモデル時間が使用されます	float
プロパティ	アラームに設定するプロパティ	any

イベント出力

apama.analyticskit.blocks.cumulocity.CreateEvent

指定されたデバイス、アセット、またはトリガーデバイスの新しい Event オブジェクトを作成します。

イベントのテキストは、テキスト入力入力ポートまたはメッセージパラメーターによって決まります。両方を設定しないでください。どちらも設定されていない場合は、モデル名がテキストとして使用されます。

このブロックは同期出力を生成します。ブロックの出力ストリームを定義するパラメーターは、「出力先」と「イベント型」です。

パラメーター

名前	説明	タイプ	注釈
出力先	イベントの送信先のデバイス (またはデバイスのグループを処理するモデルの場合は、デバイスまたはアセットをトリガー)。アセットは、クロスデバイス集計の送信にのみ使用できますモデルエディタは現在のデバイス名を使用します。これは内部でデバイス識別子にマッピングされます。	any
イベントタイプ	このイベントのタイプを識別します	string
メッセージ	イベントの作成時に表示されるテキストこれには、テキスト入力入力が接続されていないことが必要です。どちらも設定されていない場合は、モデル名がテキストとして使用されます。	string	オプション
パラメーターのフラグメント	このパラメーターが設定されている場合、プロパティ入力ポートの受信プロパティが、生成されたイベント内のこのフラグメントに追加されます。これが設定されていない場合、プロパティは Event パラメーターの最上位にコピーされます	string	オプション

入力ポートの詳細

名前	説明	タイプ
イベントの作成	シグナルを受信したときにイベントを作成します	pulse
テキスト入力	イベントのテキストを設定します。これを使用する場合、Message パラメーターを設定しないでください	string
時間	イベントのタイムスタンプを設定します。接続されていない場合は、現在のモデル時間が使用されます	float
プロパティ	イベントに設定するプロパティ	any

管理対象オブジェクト出力

apama.analyticskit.blocks.cumulocity.ManagedObjectOutput

指定されたデバイス、アセット、またはトリガーデバイスの ManagedObject オブジェクトを更新します。

プロパティ名パラメーターが設定されている場合、値入力ポート (または値が空の場合はそのプロパティ) を使用して、マネージドオブジェクトにそのプロパティが設定されます。

「プロパティ名」パラメーターが設定されていない場合、値入力ポートのすべてのプロパティがマネージドオブジェクトの更新に使用されます。

注: マネージドオブジェクトの次の参照プロパティは、このブロックを使用して更新できません:
childDeviceIds、childAssetIds、deviceParentIds、および assetParentIds

このブロックは、時間同期のモデル間通信には参加しません。単一モデルまたは複数のモデルで複数のブロックを使用して、同じデバイスの同じプロパティを更新できます。このブロックによりモデル間のサイクルが形成される可能性があるため、モデルが無限に周期的に実行されないよう注意する必要があります。

このブロックは非同期出力を生成します。ブロックの出力ストリームを定義するパラメーターは「出力先」です。

パラメーター

名前	説明	タイプ	注釈
出力先	マネージドオブジェクトが関連付けられているデバイス (またはデバイスのグループを処理するモデルの場合は、デバイスまたはアセットをトリガー)。アセットは、クロスデバイス集計の送信にのみ使用できますモデルエディタは現在のデバイス名を使用します。これは内部でデバイス識別子にマッピングされます。	any
プロパティ名	更新するプロパティの名前設定されていない場合、値入力ポートのプロパティはマネージドオブジェクトの最上位プロパティにマッピングされます。	string	オプション

入力ポートの詳細

名前	説明	タイプ
値	設定するプロパティの値	any
プロパティの更新	プロパティが更新されることを示します。接続されていない場合、値入力ポートからの新しい値ごとにプロパティが更新されます	pulse

測定出力

apama.analyticskit.blocks.cumulocity.CreateMeasurement

指定されたデバイス、アセット、またはトリガーデバイスの新しい Measurement オブジェクトを作成します。

このブロックは、値入力ポートの新しいメジャーメントを送信します。送信入力ポートが接続されている場合、このブロックは送信信号を受信したときにのみ出力を送信します。メジャーメントは現在のデバイスまたは指定されたデバイスに送信されます。

このブロックは同期出力を生成します。ブロックの出力ストリームを定義するパラメーターは、「出力先」、「フラグメント名」、「シリーズ名」です。

非有限値は無視されます。

パラメーター

名前	説明	タイプ	注釈
出力先	メジャーメントの送信先のデバイス (またはデバイスのグループ、トリガーデバイスまたはアセットを処理するモデルの場合)。アセットは、クロスデバイス集計の送信にのみ使用できますモデルエディタは現在のデバイス名を使用します。これは内部でデバイス識別子にマッピングされます。	any
フラグメント名	メジャーメント内のフラグメントの名前	string
シリーズ名	メジャーメント内のシリーズの名前	string
単位	メジャーメントの単位の名前 (「mm」や「ルクス」など)	string	オプション
パラメーターのフラグメント	このパラメーターが設定されている場合、プロパティ入力ポートの受信プロパティが、生成された Measurement 内のこのフラグメントに追加されます。これが設定されていない場合、プロパティは Measurement パラメーターの最上位にコピーされます	string	オプション

入力ポートの詳細

名前	説明	タイプ
値	送信されるメジャーメント	float
送信	新しいメジャーメントが作成されることを示します。接続されていない場合、新しい値を入力するたびにメジャーメントが作成されます	pulse
時間	測定のタイムスタンプを設定します。接続されていない場合は、現在のモデル時間が使用されます	float
プロパティ	測定に設定するプロパティ	any

操作出力

apama.analyticskit.blocks.cumulocity.CreateOperationStaticValue

指定されたデバイス、アセット、またはトリガーデバイス用に新しい Operation オブジェクトを作成します。

オペレーション名、パラメーター名、パラメーター値のいずれのパラメーターも設定されていない場合、オペレーションはプロパティ入力ポートを使用して Operation オブジェクトを設定します。

ブロックは、時間同期のモデル間通信には参加しません。複数のブロックを 1 つのモデルまたは複数のモデルで使用して、同じデバイスに対して新しい操作を作成できます。このブロックによりモデル間のサイクルが形成される可能性があるため、モデルが無限に周期的に実行されないよう注意する必要があります。

ブロックは非同期出力を生成します。ブロックの出力ストリームを定義するパラメーターは「出力先」です。

パラメーター

名前	説明	タイプ	注釈
出力先	操作が送信されるデバイス (またはデバイスのグループを処理するモデルの場合、デバイスまたはアセットをトリガー)。アセットは、クロスデバイス集計の送信にのみ使用できますモデルエディタはデバイス名を使用します。これは内部でデバイス識別子にマッピングされます。	any
操作名	Operation オブジェクトに作成するプロパティの名前	string	オプション
パラメーター名	操作のパラメーターの名前	string	オプション
パラメーター値	操作のパラメーターの値	string	オプション
説明	作成するオペレーションの説明	string	オプション

入力ポートの詳細

名前	説明	タイプ
操作の作成	シグナルを受信したときにオペレーションを作成します	pulse
プロパティ	操作に設定するプロパティ	any

電子メールの送信

apama.analyticskit.blocks.cumulocity.Send_Email

指定された電子メールアドレスに電子メールを送信します。

件名とテキストはそれぞれ、パラメーターまたは入力ポートを使用して、両方ではなく、いずれかを使用して指定する必要があります。

注: シミュレーションモードまたはテストモードで実行すると、ブロックは電子メールを送信する代わりに出力をログに記録します。

パラメーター

名前	説明	タイプ	注釈
件名	メールの件名	string	オプション
本文	メールのテキスト	string	オプション
返信先	メールの返信先アドレス	string	オプション
送信先	電子メールの受信者。カンマで区切られた 1 つ以上の電子メールアドレス	string	オプション
CC	(カーボンコピー) 電子メールのコピーを受信する受信者。カンマで区切られた 1 つ以上の電子メールアドレス	string	オプション
BCC	(ブラインドカーボンコピー) 電子メールのブラインドコピーを受信する受信者。カンマで区切られた 1 つ以上の電子メールアドレス。 To および CC にリストされている受信者は、BCC リストを表示できません	string	オプション

入力ポートの詳細

名前	説明	タイプ
送信	シグナルを受信すると電子メールを送信します	pulse
件名	メールの件名	string
本文	メールのテキスト	string

SMSを送信

apama.analyticskit.blocks.cumulocity.Send_SMS

指定した電話番号に SMS (ショートメッセージサービス) を送信します。

Send SMS 入力ポートが接続されている場合、このブロックは信号を受信すると、指定された電話番号に出力を送信します。

注: シミュレーションモードまたはテストモードで実行すると、ブロックは SMS を送信する代わりに出力をログに記録します。

パラメーター

名前	説明	タイプ	注釈
電話番号	SMS の送信先の電話番号	string
本文	SMS の内容。最大長は 160 文字です。 SMS テキスト入力ポートを使用する場合は、このパラメーターを指定しないでください	string	オプション

入力ポートの詳細

名前	説明	タイプ
SMS を送信	SMS の送信をトリガーします	pulse
SMS テキスト	SMS のコンテンツ。接続されていない場合は、Text パラメーターにコンテンツを指定します	string

ロジック

このカテゴリには、次のブロックが含まれます。

ブロック名	説明
AND	入力に対して論理「and」を実行します
NOT	入力に対して論理「not」を実行します
OR	入力に対して論理「or」を実行します

AND

apama.analyticskit.blocks.core.And

入力に対して論理「and」を実行します。

接続されているすべての入力が true の場合、出力は true になり、それ以外の場合は false になります。いずれかの入力が pulse タイプの場合、出力は pulse になります。 pulse 入力と boolean 入力の任意の組み合わせが有効です。一部の入力が接続されていない場合でも、ブロックは機能します。

入力ポートの詳細

名前	説明	タイプ
値 1	ブロックへの最初の入力値	boolean
値 2	ブロックへの 2 番目の入力値	boolean
値 3	ブロックへの 3 番目の入力値	boolean
値 4	ブロックへの 4 番目の入力値	boolean
値 5	ブロックへの 5 番目の入力値	boolean

出力ポートの詳細

名前	説明	タイプ
AND	入力の論理「and」	pulseOrBoolean(value1, value2, value3, value4, value5)

NOT

apama.analyticskit.blocks.core.Not

入力に対して論理「not」を実行します。

接続された入力が true の場合、出力は false になります。接続された入力が false の場合、出力は true になります。

入力ポートの詳細

名前	説明	タイプ
値	ブロックに値を入力します	boolean

出力ポートの詳細

名前	説明	タイプ
NOT	入力の論理「not」	boolean

OR

apama.analyticskit.blocks.core.Or

入力に対して論理「OR」を実行します。

接続された入力のいずれかが true の場合、出力は true になり、それ以外の場合は false になります。すべての入力が pulse タイプの場合、出力は pulse になります。入力は同じタイプである必要があります。一部の入力が接続されていない場合でも、ブロックは機能します。

入力ポートの詳細

名前	説明	タイプ
値 1	ブロックへの最初の入力値	boolean
値 2	ブロックへの 2 番目の入力値	boolean
値 3	ブロックへの 3 番目の入力値	boolean
値 4	ブロックへの 4 番目の入力値	boolean
値 5	ブロックへの 5 番目の入力値	boolean

出力ポートの詳細

名前	説明	タイプ
OR	入力の論理「or」	sameAsAll(value1, value2, value3, value4, value5)

計算

このカテゴリには、次のブロックが含まれます。

ブロック名	説明
超過数カウンター	指定された方向のしきい値交差の数を検出してカウントします
差分	連続する入力値の差を計算します
相違	接続された入力間の絶対差と符号付きの差を計算します
方向検出	入力値の方向が変化したかどうかを検出します
式	式を評価して、算術計算、論理計算、または文字列操作を実行します
ベース N から	基数 N の文字列を float に変換します
KPI	値を KPI (主要業績評価指標) またはデバイスのデータポイントと比較します
限度	定義された上限値と下限値の範囲内に収まる値を出力します
範囲	入力値を定義された範囲の下限値および上限値と比較して、入力が範囲内か範囲外か、または範囲を超えているかどうかを検出します
範囲参照	入力値が含まれる範囲を検索します
丸め	選択可能なルールを使用して、入力を指定された小数点以下の桁数または整数に丸めます
しきい値	入力値を定義されたしきい値と比較して、入力がしきい値に違反しているかどうか、またはしきい値を超えているかどうかを検出します
ベース N へ	float を基数 N の文字列に変換します

超過数カウンター

apama.analyticskit.blocks.core.CrossingCounter

指定された方向のしきい値交差の数を検出してカウントします。

超過は、しきい値の一方の側からもう一方の側への入力値の変化として定義されます (つまり、より小さいからより大きい、またはその逆)。

ブロックは、「ウィンドウ期間」パラメーターで指定された時間制限されたウィンドウにわたって動作できます。このパラメーターが指定されていない場合は、無制限のウィンドウが使用されます。リセット入力はウィンドウの内容をクリアします。

ウィンドウが設定されている場合、ブロックは 20 個のバケットのセットを使用するため、期限切れ値の時間は最も近いバケット間隔の近似値となります。

パラメーター

名前	説明	タイプ	注釈
しきい値	この値は入力値と比較されます	float	デフォルト: 0.5
方向	しきい値の交差をチェックする方向: 上方向、下方向、または両方向のいずれで交差を検出するか	オプション - 次のいずれか 1 つ上方向下方向両方
ウィンドウ期間 (秒)	存在する場合、値がウィンドウ内に保持される時間 (秒単位) これは有限の正の数でなければなりません	float	オプション

入力ポートの詳細

名前	説明	タイプ
値	交差を検出するための入力値	float
リセット	交差の数をリセットします	pulse
サンプル	現在の値の再評価を強制し、出力を送信します	boolean

出力ポートの詳細

名前	説明	タイプ
超過数	超過点の数	float
超過	超過が検出されるとパルスを送信します	pulse

差分

apama.analyticskit.blocks.core.Delta

連続する入力値の差を計算します。

ブロックは、少なくとも 2 つの入力値を取得した後に出力を生成します。

入力ポートの詳細

名前	説明	タイプ
値	差分を計算する値	float
リセット	ブロックの状態をリセットします	pulse

出力ポートの詳細

名前	説明	タイプ
差分値	差分値	float

相違

apama.analyticskit.blocks.core.Difference

接続された入力間の絶対差と符号付きの差を計算します。

両方の入力が値を受け取った場合にのみ出力を生成します。

入力ポートの詳細

名前	説明	タイプ
値 1	ブロックへの最初の入力	float
値 2	ブロックへの 2 番目の入力	float

出力ポートの詳細

名前	説明	タイプ
絶対的な相違	入力の絶対差	float
署名された相違	入力の符号付き差。値 1 の入力が値 2 の入力より大きい場合は正	float

方向検出

apama.analyticskit.blocks.core.DirectionDetector

入力値の方向が変化したかどうかを検出します。

方向の変化と最後の重要な変曲点を出力します。変化が定義されたヒステリシス値より小さい場合は、小さな変化は無視されます。同じ値を繰り返し入力しても無視されます。

パラメーター

名前	説明	タイプ	注釈
ヒステリシス	方向が変わった時点から入力値が定義されたヒステリシス値だけ変化する場合にのみ、方向の変化をカウントしますゼロ (すべての方向変化がカウントされることを意味する) または正の数値のいずれかでなければなりません	float	デフォルト: 0.0

入力ポートの詳細

名前	説明	タイプ
値	方向の変化を検出する数値	float
リセット	ブロックの状態をリセットします	pulse

出力ポートの詳細

名前	説明	タイプ
上向きの方向	入力値が上方向に変化する場合は true、それ以外の場合は false です	boolean
変曲点	ブロックによって検出された最後の変曲点	float

式

apama.analyticskit.blocks.core.Expression

式を評価して算術計算、論理計算、または文字列操作を実行します。

入力値が変更されると (使用中の入力がすべて受信されると)、パラメーターで指定された式が再計算されます。

式言語は EPL によく似ています (EPL リファレンス)、ただし、浮動小数点、整数、文字列、およびブール型に制限されます。すべての数値リテラルは、小数部分がない場合でも、float 型の値として扱われます。整数値は、floor() などの関数の結果としてのみ取得できます。 EPL と同様に、integer と float は式内で暗黙的に変換できません。式の結果が integer 値の場合、自動的に float に変換されます (精度が失われる可能性があります)。ブール値は、ブールリテラル true および false を使用して指定できます。ブールリテラルでは大文字と小文字が区別されないため、たとえば、TRUE と True が許可されます。文字列値は、文字列リテラルを二重引用符で囲むことによって指定できます (例: "my value")。特殊文字はバックスラッシュ (\) でエンコードされます。次の特殊文字 (エンコーディングも含む) が文字列リテラルでサポートされています。

二重引用符 - \"
バックスラッシュ - \\
改行 - \n
タブ - \t

入力の値は、input1、input2、input3、input4、および input5として使用できます。入力値のタイプは、float、string、boolean、および any です。サポートされている型の値には、論理演算子、関係演算子、数値演算子、等価演算子を使用できます。論理演算子では大文字と小文字が区別されないため、たとえば、AND や And が使用できます。を含む、float、integer、string、boolean 型の組み込みメソッドを呼び出すことができます。 x.abs() (x の絶対値)、x.pow(y) (x の < 乗) tt>y)、x.sin() (ラジアン単位の x のサイン)、x.round() (四捨五入) x を最も近い整数に変換します)、および s.ltrim() (文字列 s の先頭から空白を削除します)。サポートされている型の組み込み静的メソッドは、型名に続いてドット (.) とメソッド名を指定することで呼び出すことができます (例: float.max(input1, input2) ) (2 つの入力値のうち大きい方を見つけます)。サポートされている型の組み込み定数にアクセスするには、型名に続けてドット (.) と定数名を指定します (たとえば、float.E ( オイラー定数）。 any 型の値は、式を評価するために実行時に解凍されます。解凍後の値は、float、string、または boolean 型である必要があります。型チェッカーは検証フェーズ中に式を検証しようとしますが、これは any 型では常に可能であるとは限りません。そのため、式に any 型が含まれている場合、検証フェーズを通過したとしても、間違った型の変数が渡されたり、サポートされていない操作が実行されたりするため、実行時に失敗する可能性があります。組み込みメソッドと定数の完全なリストについては、API EPL (ApamaDoc) のリファレンスをご覧ください。。

例:

華氏を摂氏に変換します: (input1 - 32) * 5/9
日を秒に変換します: input1 * 86400
4 つの入力の平均: (input1 + input2 + input3 + input4) / 4
閾値比較: input1 > 3.1412 (ただし、Threshold ブロックもご覧ください)
直角三角形の斜辺を計算するピタゴラス: (input1.pow(2) + input2.pow(2)) .sqrt()
小数点以下 3 桁との比較: (input1 * 1000 - (input1 * 1000).fractionalPart()) = (input2 * 1000 - (input2 * 1000) .fractionalPart())
範囲チェック: input1 >= 1 および input1 <= 10
文字列比較: input1 = "私の値"
大きい値: float.max(input1, float.PI)
整数の除算の余り: input1.round() % input2.round()

パラメーター

名前	説明	タイプ	注釈
式	式 - EPL 式の文字列表現 EPL 式に似ていますが、上記のような違いがあります。	string

入力ポートの詳細

名前	説明	タイプ
input1	式の input1 として使用される最初の入力	any
input2	2 番目の入力。式の input2 として使用されます	any
input3	3 番目の入力。式の input3 として使用されます	any
input4	4 番目の入力。式の input4 として使用されます	any
input5	5 番目の入力。式の input5 として使用されます	any

出力ポートの詳細

名前	説明	タイプ
結果	式の結果	any

ベース N から

apama.analyticsbuilder.blocks.FromBaseN

基数 N の文字列を浮動小数点数に変換します。

入力文字列は、2 ～ 36 の任意の整数基数で指定できます。英語のアルファベットの文字は、10 を超える基数の数字として使用されます。一般的な基数は、2 (2 進数)、8 (8 進数)、10 (10 進数)、および 16 (16 進数)。変換される数値には基数を含めることができます。

任意の 2 つの塩基間の変換は、このブロックを To Base N ブロックと連結することで実現できます。

パラメーター

名前	説明	タイプ	注釈
入力ベース	2 ～ 36 の範囲の入力ストリームの基数	整数	デフォルト: 16
基数文字	基数点として使用する文字。ドットまたはカンマであることが期待されます	オプション - 次のいずれか 1 つドットカンマ	デフォルト: ドット

入力ポートの詳細

名前	説明	タイプ
ベース N	基数 N の文字列入力	string

出力ポートの詳細

名前	説明	タイプ
浮動小数点	数値出力	float

KPI

apama.analyticskit.blocks.cumulocity.KPI

値を KPI (主要業績評価指標) またはデバイスのデータポイントと比較します。

このブロックは、KPI 入力ポートまたはデータポイントを含むデバイスからのデータを使用します。単位、ラベル、赤と黄色の範囲を抽出します。出力は、値が KPI またはデータポイントで指定された赤または黄色の範囲内にあるかどうかを示します。

KPI 入力は、通常は KPI マネージドオブジェクトから、赤と黄色の範囲、単位、ラベルなどのプロパティを提供できます。デバイスに指定されたフラグメントおよびシリーズのデータポイントが含まれている場合、データポイントの値が KPI の値をオーバーライドします。

パラメーター

名前	説明	タイプ	注釈
入力ソース	データポイントを含むデバイスまたはデバイスのグループ。指定された場合、このデバイス (通常は測定ソースと同じデバイス) がチェックされ、指定されたフラグメントおよびシリーズのデータポイントが含まれているかどうかが確認されます。データポイントが含まれている場合は、ソースオブジェクトの赤と黄色の範囲値が KPI 値の代わりに使用されます。モデルエディタは、現在のデバイス名またはアセット名を使用します。これは内部でインベントリ識別子にマッピングされます	any	オプション
データポイントのフラグメントとシリーズ	このパラメーターは、[入力ソース] パラメーターが指定されている場合に指定する必要があります。ソースオブジェクトからのデータポイントを指定します。これは通常、測定ソースのフラグメントおよびシリーズと同じですデータポイントのフラグメントとシリーズは、fragment.series として指定する必要があります。	string	オプション
黄色の範囲の上限端は除外	設定すると、黄色の範囲の上限が排他的として扱われます	boolean	デフォルト: False
赤色の範囲の上限端は除外	設定すると、赤い範囲の上限が排他的として扱われます	boolean	デフォルト: False

入力ポートの詳細

名前	説明	タイプ
値	定義された範囲と比較する数値	float
KPI	c8y_Kpi プロパティを含むオブジェクト	pulse

出力ポートの詳細

名前	説明	タイプ
赤	値が赤色の範囲内にある場合 (赤色の範囲が定義されている場合)、true に設定されます	boolean
黄色	値が黄色の範囲にある場合 (黄色の範囲が定義されている場合)、true に設定されます	boolean
単位	データポイントからのユニット名	string
ラベル	データポイントからのラベル名	string

限度

apama.analyticsbuilder.blocks.Limit

定義された上限値と下限値の範囲内に保たれる値を出力します。

入力値は、出力が下限パラメーターと上限パラメーターで定義された境界を超えないように制限されます。入力がいずれかの制限に違反する場合、出力はパラメーター値に設定され、それ以外の場合は値が変更されずに渡されます。

いずれかの制限を指定することのみが必須です。この場合、入力は指定されたパラメーターの方向にのみ制限されます。

パラメーター

名前	説明	タイプ	注釈
上限	この値を超える入力があると、出力はこの値に制限されます	float	オプション
下限	この値を下回る入力があると、出力はこの値に制限されます	float	オプション

入力ポートの詳細

名前	説明	タイプ
値	入力値	float

出力ポートの詳細

名前	説明	タイプ
出力	下限パラメーターと上限パラメーターで定義された制限内にある場合の入力値。入力値がいずれかの制限パラメーターを超える場合、そのパラメーターの値に設定されます	float

入力ポートの詳細

名前	説明	タイプ
値 1	値 1 を入力します	any
値 2	値 2 を入力します	any
値 3	値 3 を入力します	any
値 4	値 4 を入力します	any
値 5	値 5 を入力します	any
値 6	値 6 を入力します	any
値 7	値 7 を入力します	any
値 8	値 8 を入力します	any
値 9	値 9 を入力します	any
値 10	値 10 を入力します	any

出力ポートの詳細

名前	説明	タイプ
出力 1	値 1 を出力します	any
出力 2	値 2 を出力します	any
出力 3	値 3 を出力します	any
出力 4	値 4 を出力します	any
出力 5	値 5 を出力します	any
出力 6	値 6 を出力します	any
出力 7	値 7 を出力します	any
出力 8	値 8 を出力します	any
出力 9	値 9 を出力します	any
出力 10	値 10 を出力します	any

範囲

apama.analyticsbuilder.blocks.Range

入力値を定義された範囲の下限値および上限値と比較して、入力が範囲内か範囲外か、または範囲を超えているかどうかを検出します。

デフォルトでは、範囲には下限範囲の値が含まれますが、上限範囲の値は含まれません。たとえば、下限範囲が 100、上限範囲が 200 の場合、100 ～ 199 のすべての値が範囲内になります。 200 は範囲外とみなされます。

定義された範囲を超えるとパルスが送信されます。つまり、範囲の下限または上限を超えた場合、または値が範囲内に入らずに範囲の下から範囲を超えた（またはその逆）場合です。

パラメーター

名前	説明	タイプ	注釈
下限範囲	範囲の下限値	float	オプション
下位範囲を含める	選択すると、下限範囲に等しい入力値が考慮され、範囲内か範囲外かを識別します。選択しない場合、下限範囲に等しい入力値は考慮されません	boolean	デフォルト: True
上限範囲	上限範囲の値	float	オプション
上限範囲を除外	これを選択すると、上限範囲に等しい入力値は、範囲内か範囲外かを識別するために考慮されません。選択されていない場合、そのような入力値は範囲内か範囲外かを識別するものとみなされます	boolean	デフォルト: True

入力ポートの詳細

名前	説明	タイプ
値	定義された範囲に対して検証する入力値	float
リセット	ブロックの状態をリセットします	pulse

出力ポートの詳細

名前	説明	タイプ
範囲外	入力値が定義された範囲内にない場合、true に設定されます	boolean
範囲内	入力値が定義された範囲内にある場合、true に設定されます	boolean
超過	範囲を超えるとパルスを送信します	pulse

範囲参照

apama.analyticskit.blocks.core.RangeLookup

入力値が含まれる範囲を検索します。

範囲は、一意の上限値の昇順リストを使用して定義されます。最初の範囲の下限は、[最小値] パラメーターの値によって異なります。後続の各範囲の下限は、前の範囲の上限によって定義されます。境界値と等しい入力値が属する範囲は、[上限を除く] パラメーターによって異なります。このブロックは、入力が含まれる範囲のマップされた値を出力するか、入力値がどの範囲にも入っていない場合は失敗フラグを出力します。

パラメーター

名前	説明	タイプ	注釈
最小値	最初の範囲 (最初の行) の下限。何も指定しない場合、負の無限大が最小値として扱われます	float	オプション
範囲	入力値を検索する範囲の上限の境界とマップされた値のペア、および入力値が範囲内にある場合に出力値として使用されるマップされた値< /スパン>	上限値とマップされた値のリスト
上限を除く	これを選択すると、行の上限に等しい入力値が次の行の範囲の一部とみなされます。選択されていない場合、そのような入力値は現在の行の範囲の一部とみなされます	boolean	デフォルト: True
タイプ	出力値に使用される型	オプション - 次のいずれか 1 つフロートブール値文字列	オプション

入力ポートの詳細

名前	説明	タイプ
値	範囲を求める入力値	float

出力ポートの詳細

名前	説明	タイプ
マッピング済み	一致する範囲のマップされた値	any
失敗	は、入力がどの範囲にも収まらない場合に true になります。それ以外の場合は false です	boolean

丸め

apama.analyticskit.blocks.core.Rounding

選択可能なルールを使用して、入力を指定された小数点以下の桁数または整数に丸めます。

数値を四捨五入するとは、ほぼ等しいがより短く単純な表現を持つ別の値に置き換えることを意味します。

使用できるルールは次のとおりです。

Up (または上限を取る、またはプラスの無限大に向かって丸める) は、入力を最も近いターゲット数値に切り上げます。
Down (または下限を取る、またはマイナス無限大に向かって丸める) は、入力を最も近いターゲット数値に切り下げます
Toward Zero (または切り捨てる、または無限大から離れる方向に丸める) は丸めます。
Nearest (または半分を切り上げる、または半分を正の無限大方向に丸める) は、最も近いターゲット数値に丸めます。最も近い 2 つのターゲット数値から等距離にある数値は常に切り上げられます。たとえば、値 23.5 は 24 に四捨五入されますが、-23.5 は -23 に四捨五入されます。
偶数または最近接は、最も近いターゲット数値に丸めます。 2 つの最も近いターゲット数値から等距離にある数値は、常に最も近い偶数のターゲットに丸められます。たとえば、0.5 は 0 に切り捨てられ、1.5 は 2 に切り上げられます。バンカーズ丸めとも呼ばれます< /li>

値は、最も近い「ターゲット数値」に丸められます。これは整数 (小数点以下の桁数が 0 の場合)、または指定された小数点以下の桁数に丸められます。小数点以下の桁数が負の場合、10 の累乗に丸められます。たとえば、小数点以下の桁数が 2 の場合、最も近い 0.01 (つまり、100 分の 1) に丸められます。小数点以下の桁数が -3 の場合、最も近い 1000 (つまり、1,000) に四捨五入されます。

パラメーター

名前	説明	タイプ	注釈
ルール	適用される丸めルール	オプション - 次のいずれか 1 つ上下ゼロに向かって最寄り偶数または最も近い
小数点数	入力を四捨五入する小数点以下の桁数	整数	デフォルト: 0

入力ポートの詳細

名前	説明	タイプ
値	四捨五入される入力値	float

出力ポートの詳細

名前	説明	タイプ
丸め値	指定された小数点以下の桁数または整数に四捨五入された入力値	float

しきい値

apama.analyticskit.blocks.core.Threshold

入力値を定義されたしきい値と比較して、入力がしきい値に違反しているかどうか、またはしきい値を超えているかどうかを検出します。

方向が「上」に設定され、入力値が定義されたしきい値より大きい場合、または方向が「下」に設定され、入力値が定義されたしきい値より小さい場合、違反が発生します。方向が「以上」に設定されており、入力値が定義されたしきい値以上の場合、または方向が「以下」に設定されており、入力値が以下の場合定義されたしきい値に達します。

定義されたしきい値を任意の方向から超えると、パルスが送信されます。

パラメーター

名前	説明	タイプ	注釈
しきい値	この値は入力値と比較されます	float
方向	調べる方向: 入力値が定義されたしきい値より上か、下か、または等しいか、または定義されたしきい値を超えているか	オプション - 次のいずれか 1 つ上以上より小さい以下超過	デフォルト: 上

入力ポートの詳細

名前	説明	タイプ
値	定義されたしきい値と比較する入力値	float
リセット	ブロックの状態をリセットします	pulse

出力ポートの詳細

名前	説明	タイプ
違反されたしきい値	しきい値に違反すると、true に設定されます	boolean
しきい値内	しきい値を超えていない場合、true に設定されます	boolean
超過したしきい値	しきい値を超えたときにパルスを送信します	pulse

ベース N へ

apama.analyticsbuilder.blocks.ToBaseN

float を基数 N の文字列に変換します。

出力文字列は、2 ～ 36 の任意の整数基数で指定できます。英語のアルファベットの文字は、10 を超える基数の数字として使用されます。一般的な基数は、2 (2 進数)、8 (8 進数)、10 (10 進数)、および 16 (16 進数)。変換される数値には基数を含めることができます。出力は、基数 16 桁の最大精度で計算されます。

任意の 2 つの塩基間の変換は、このブロックを From Base N ブロックと連結することで実現できます。

パラメーター

名前	説明	タイプ	注釈
出力ベース	2 ～ 36 の範囲の出力ストリームの基数	整数	デフォルト: 16
基数文字	基数点として使用する文字。ドットまたはカンマであることが期待されます	オプション - 次のいずれか 1 つドットカンマ	デフォルト: ドット

入力ポートの詳細

名前	説明	タイプ
浮動小数	数値入力	float

出力ポートの詳細

名前	説明	タイプ
ベース N	基数 N の文字列出力	string

集約

このカテゴリには、次のブロックが含まれます。

ブロック名	説明
平均値 (平均)	時間の経過に伴う値の平均を計算します
カウンター	合計入力数と繰り返された入力数を示します
個別統計	離散入力値の合計、カウント、平均（平均）、標準偏差、最小値と最大値の統計を生成します
勾配	値の加重線形回帰勾配を計算します
グループ統計	ブロックが入力値を受け取ったグループ内のすべてのデバイスにわたって定期的な集計値を生成します
インテグラル	時間の経過に伴う入力値の積分を計算します
最小値 / 最大値	時間の経過に伴う値の最小値と最大値を計算します
標準偏差	時間の経過に伴う値の標準偏差と分散を計算します

平均値 (平均)

apama.analyticskit.blocks.core.Mean

時間の経過に伴う値の平均を計算します。

このブロックは、不規則にサンプリングされた場合でも、連続値に適しています。入力またはサンプル間の時間は重要ですが、サンプル数は重要ではありません。このブロックは、たとえば、入力が定期的または不定期にサンプリングされる温度などの物理的特性である場合 (たとえば、温度の変化に応じてメジャーメントのみを生成する場合) に使用します。チケット販売など、測定数は重要ですが、測定間の時間は重要ではない独立した測定には、平均値 (平均) ブロックの代わりに個別統計ブロックを使用します。

平均は、入力の値の合計に、オプションのウィンドウ内で入力がその値に留まっていた時間を乗算し、ウィンドウ期間またはブロックの開始または最後にリセットされてからの時間のいずれか小さい方で割ったものとして定義されます。

ブロックは、「ウィンドウ期間」パラメーターで指定された時間制限されたウィンドウにわたって動作できます。このパラメーターが指定されていない場合、ブロックは無制限のウィンドウを使用します。リセット入力ポートはウィンドウの内容をクリアします。出力は、新しい入力に対して生成されます。または、「出力しきい値」パラメーターが設定されている場合は、出力が指定された出力しきい値を超えて変化した場合にのみ生成されます (これには、それ以上入力が発生しない場合、または古いエントリの期限切れによってのみ値が変化する場合も含まれます)。サンプル入力ポートを使用して、再評価を強制し、最新の値を生成できます。

このブロックからの出力の頻度とウィンドウ内の値の動作の詳細と例については、Analytics Builder ドキュメントの「値のタイプ」トピックもご覧ください。

ウィンドウが構成されている場合、ブロックは 20 個のバケットのセットを使用するため、期限切れ値はバケット全体の平均値の近似値になります。

注:平均値 (平均) ブロックは、個々のデバイスの平均を生成します。入力がデバイスのグループからのものである場合、平均はそのグループ内のデバイスごとに個別に生成されます。 (個々のデバイスではなく) グループ全体の集計値を計算して生成するには、グループ統計ブロックを使用します。

パラメーター

名前	説明	タイプ	注釈
ウィンドウ期間 (秒)	存在する場合、値がウィンドウ内に保持される時間 (秒単位) これは有限の正の数でなければなりません	float	オプション
出力しきい値	存在する場合、少なくともこの値だけ変化した時点で出力が送信されますこれは有限の正の数でなければなりません	float	オプション

入力ポートの詳細

名前	説明	タイプ
値	平均を計算する入力	float
リセット	ウィンドウの内容をクリアします	pulse
サンプル	現在の平均値の再評価を強制し、出力を送信します	pulse

出力ポートの詳細

名前	説明	タイプ
平均値	値にその値を維持する時間を乗算し、合計時間を割った値の合計	float

カウンター

apama.analyticskit.blocks.core.Counter

合計入力数と繰り返された入力数を示します。

2 つの連続する入力値の型が異なる場合、それらは繰り返し値として評価されません。2 つの値が互いに等しいかどうかに関する他のすべての評価は、EPL と同じルールに従います。詳細については、タイプをご覧ください。

入力ポートの詳細

名前	説明	タイプ
値	カウントされる入力	any
リセット	カウンターをリセットします	boolean

出力ポートの詳細

名前	説明	タイプ
カウント	すべての入力の合計数	float
数が同じ	同じ値が繰り返された入力の現在の数値を変更すると、これは 1 にリセットされます。	float

個別統計

apama.analyticsbuilder.blocks.DiscreteStatistics

離散入力値の合計、カウント、平均値 (平均)、標準偏差、最小値と最大値の統計を生成します。

このブロックは、サンプル (または入力) の数が重要である一方でサンプル間の時間は重要ではない、離散時間入力に適しています。平均値 (平均) ブロックと標準偏差ブロックは、温度メジャーメントなど、不規則にサンプリングされる可能性のある連続値に適しています。たとえば、各サンプルが販売されるチケットなどのトランザクションを表す場合は、このブロックを使用します。

サンプル入力ポートが接続されていない場合、すべての値がサンプリングされます。リセットと同じアクティブ化期間中に新しい値を受信した場合、その値はリセット後にサンプリングされます。それ以外の場合は無視されます。すべての値が使用されるため、標準偏差には一般的な公式 σ² = ∑(x - µ)² / N が使用されます。

サンプル入力端子が接続されている場合、ブロックはサンプル入力端子が信号を受信したときにのみデータをサンプリングします。この場合、サンプリング標準偏差には次の式が使用されますます。 σ² = ∑(x - µ)² / (N-1)。

リセット信号とサンプル信号が一緒に受信された場合、リセットが最初に処理されます。

入力ポートの詳細

名前	説明	タイプ
値	現在の値	float
サンプル	統計の生成に現在の値を使用します。接続しないままにすると、すべての値が使用されます	pulse
リセット	ブロックの状態をリセットします	pulse

出力ポートの詳細

名前	説明	タイプ
合計	サンプリングされた入力値の合計、∑x	float
数	サンプリングされた入力値の数、N	float
平均値	サンプリングされた入力値の平均値 (平均)、µ = ∑x / N	float
標準偏差	サンプリングされた入力値の標準偏差。サンプル入力ポートが接続されていない状態ですべての値がサンプリングされている場合は、一般的な標準偏差 σ² = ∑(x - µ)² / N が使用されます。それ以外の場合は、サンプリング標準偏差 σ² = ∑(x - µ)² / (N-1) が使用されます	float
最小値	サンプリングされた入力値の最小値	float
最大値	サンプリングされた入力値の最大値	float

勾配

apama.analyticskit.blocks.core.Gradient

値の重み付き線形回帰勾配を計算します。

勾配は、時間の経過に伴う値の変化率を測定します。正の勾配は入力値の増加を示し、負の勾配は入力値の減少を示します。勾配の大きさは変化の規模を表します。

ブロックは、「ウィンドウ期間」パラメーターで指定された時間制限されたウィンドウにわたって動作できます。このパラメーターが指定されていない場合、無制限のウィンドウが使用され、ブロックは 1 秒ごとに再評価され、1 秒のバケットが使用されます。ウィンドウが設定されている場合、ブロックは 20 個のバケットのセットを使用するため、期限切れ値の時間は最も近いバケット間隔の近似値となります。最初の勾配出力は、少なくとも 2 つのバケットが計算に利用できる場合にのみ生成されます。

リセット入力はウィンドウの内容をクリアします。サンプル入力を使用して再評価を強制し、最新の値を生成できます。

パラメーター

名前	説明	タイプ	注釈
ウィンドウ期間 (秒)	存在する場合、値がウィンドウ内に保持される時間 (秒単位) これは有限の正の数でなければなりません	float	オプション

入力ポートの詳細

名前	説明	タイプ
値	勾配を計算する入力値	float
リセット	ウィンドウの内容をクリアします	pulse
サンプル	現在の値の再評価を強制し、出力を送信します	pulse

出力ポートの詳細

名前	説明	タイプ
勾配	入力値の勾配	float

グループ統計

apama.analyticskit.blocks.core.GroupStatistics

ブロックが入力値を受け取ったグループ内のすべてのデバイスにわたって定期的な集計値を生成します。

このブロックは次の集計値を生成します。

最小
最大
デバイス数
平均
標準偏差
差異

ブロックは、「ウィンドウ期間」パラメーターで指定された時間制限されたウィンドウにわたって動作できます。このパラメーターが指定されていない場合、ブロックは無制限のウィンドウを使用します。出力は、「出力期間」パラメーターで指定されたとおりに定期的に生成されます。

ウィンドウが構成されている場合、ブロックは 20 個のバケットのセットを使用するため、期限切れ値は最も近いバケット間隔の近似値になります。

注: グループ統計ブロックは、(個々のデバイスではなく) グループ全体の集計値を計算して生成します。グループ内の個々のデバイスの集計を生成するには、平均値 (平均)、標準偏差、または最小/最大ブロックを使用します。グループ統計ブロックは、入力値を受信したデバイスのみを考慮します。

パラメーター

名前	説明	タイプ	注釈
ウィンドウ期間 (秒)	存在する場合、値がウィンドウ内に保持される時間 (秒単位) これは有限の正の数でなければなりません	float	オプション
出力期間 (秒)	各出力間の時間 (秒単位) これは有限の正の数でなければなりません	float	デフォルト: 5.0

入力ポートの詳細

名前	説明	タイプ
値	集計値を計算する入力値	float

出力ポートの詳細

名前	説明	タイプ
最小値	グループ内のすべてのデバイスにわたる最小の入力値 (負の無限大に最も近い値)	float
最大値	グループ内のすべてのデバイスにわたる最大の入力値（正の無限大に最も近い値）	float
デバイス数	これまでに入力値を受信したグループ内のデバイスの数	float
平均値	値にその値を維持する時間を乗算し、合計時間とデバイス数で割った値の合計	float
標準偏差	グループ内のすべてのデバイスにわたる入力値の標準偏差	float
差異	グループ内のすべてのデバイスにわたる入力値の分散	float

インテグラル

apama.analyticskit.blocks.core.Integral

時間の経過に伴う入力値の積分を計算します。

積分は、ブロックが開始されたか最後にリセットされてから、オプションのウィンドウ内で入力がその値に留まっていた時間を乗算した入力値の合計として定義されます。

ブロックは、「ウィンドウ期間」パラメーターで指定された時間制限されたウィンドウにわたって動作できます。このパラメーターが指定されていない場合は、無制限のウィンドウが使用されます。「リセット」入力はウィンドウの内容をクリアします。出力は、新しい入力に対して生成されます。または、「出力しきい値」パラメーターが設定されている場合は、出力が指定された出力しきい値を超えて変化した場合にのみ生成されます (これには、それ以上入力が発生しない場合、または古いエントリの期限切れによってのみ値が変化する場合も含まれます)。サンプル入力を使用して再評価を強制し、最新の値を生成できます。

ウィンドウが設定されている場合、ブロックは 20 個のバケットのセットを使用するため、期限切れ値はバケット全体の平均値の近似値となります。

パラメーター

名前	説明	タイプ	注釈
ウィンドウ期間 (秒)	存在する場合、値がウィンドウ内に保持される時間 (秒単位) これは有限の正の数でなければなりません	float	オプション
出力しきい値	存在する場合、少なくともこの値だけ変化した時点で出力が送信されますこれは有限の正の数でなければなりません	float	オプション

入力ポートの詳細

名前	説明	タイプ
値	積分を計算する入力	float
リセット	ウィンドウの内容をクリアします	pulse
サンプル	現在の積分値の再評価を強制し、出力を送信します	pulse

出力ポートの詳細

名前	説明	タイプ
整数値	値にその値が維持される時間を乗算した合計	float

最小値 / 最大値

apama.analyticskit.blocks.core.MinMax

時間の経過に伴う値の最小値と最大値を計算します。

最小値はウィンドウ内の入力値の最小値 (負の無限大に最も近い) として定義され、最大値はウィンドウ内の入力値の最大値 (正の無限大に最も近い) として定義されます。

ブロックは、「ウィンドウ期間」パラメーターで指定された時間制限されたウィンドウにわたって動作できます。このパラメーターが指定されていない場合、ブロックは無制限のウィンドウを使用します。Reset 入力はウィンドウの内容をクリアします。出力は、現在の最小値または最大値を超える新しい入力、または「ウィンドウ期間」パラメーターが設定されている場合は、以前の最小値または最大値の期限が切れたときに生成されます。

ウィンドウが構成されている場合、ブロックは 20 個のバケットのセットを使用するため、期限切れ値の時間は最も近いバケット間隔の近似値になります。

注: 最小/最大ブロックは、個々のデバイスの最小値と最大値を生成します。入力がデバイスのグループからのものである場合、これらの値はそのグループ内のデバイスごとに個別に生成されます。(個々のデバイスではなく) グループ全体の集計値を計算して生成するには、グループ統計ブロックを使用します。

パラメーター

名前	説明	タイプ	注釈
ウィンドウ期間 (秒)	存在する場合、値がウィンドウ内に保持される時間 (秒単位) これは有限の正の数でなければなりません	float	オプション

入力ポートの詳細

名前	説明	タイプ
値	最小値と最大値を計算する入力	float
リセット	ウィンドウの内容をクリアします	pulse

出力ポートの詳細

名前	説明	タイプ
最小値	ウィンドウ内の最小値 (負の無限大に最も近い値)	float
最大値	ウィンドウ内の最大値 (正の無限大に最も近い値)	float

標準偏差

apama.analyticskit.blocks.core.StandardDeviation

時間の経過に伴う値の標準偏差と分散を計算します。

このブロックは、不規則にサンプリングされた場合でも、連続値に適しています。入力またはサンプル間の時間は重要ですが、サンプル数は重要ではありません。このブロックは、たとえば、入力が定期的または不定期にサンプリングされる温度などの物理的特性である場合 (たとえば、温度の変化に応じてメジャーメントのみを生成する場合) に使用します。チケット販売など、測定数は重要ですが測定間の時間は重要ではない独立した測定には、標準偏差ブロックの代わりに個別統計ブロックを使用します。

標準偏差は、一連のデータ値の変動または分散の量を定量化するために使用される尺度です。標準偏差が低いことは、データポイントがセットの平均に近い傾向があることを示し、標準偏差が高いことは、データポイントがより広い範囲の値に分散していることを示します。

ブロックは、「ウィンドウ期間」パラメーターで指定された時間制限されたウィンドウにわたって動作できます。このパラメーターが指定されていない場合、ブロックは無制限のウィンドウを使用します。リセット入力ポートはウィンドウの内容をクリアします。サンプル入力ポートを使用して、再評価を強制し、最新の値を生成できます。出力は新しい入力に対して生成されます。または、「ウィンドウ期間」パラメーターが設定されている場合は、ウィンドウに追加される新しいバケットごとに出力が定期的に生成されます。

注: 標準偏差ブロックは、個々のデバイスの標準偏差と分散を生成します。入力がデバイスのグループからのものである場合、これらの値はそのグループ内のデバイスごとに個別に生成されます。(個々のデバイスではなく) グループ全体の集計値を計算して生成するには、グループ統計ブロックを使用します。

パラメーター

名前	説明	タイプ	注釈
ウィンドウ期間 (秒)	存在する場合、値がウィンドウ内に保持される時間 (秒単位) これは有限の正の数でなければなりません	float	オプション

入力ポートの詳細

名前	説明	タイプ
値	標準偏差と分散を計算する入力	float
リセット	ウィンドウの内容をクリアします	pulse
サンプル	現在の値の再評価を強制し、出力を送信します	pulse

出力ポートの詳細

名前	説明	タイプ
標準偏差	入力値の標準偏差	float
差異	入力値の分散	float

フロー操作

このカテゴリには、次のブロックが含まれます。

ブロック名	説明
結合要素	選択したモードと接続された入力に基づいて出力を計算します
ゲート	ゲートが開いていて有効になっていない限り、入力が出力に送られるのをブロックします
ラッチ値	ブロックが有効になっている間に受信した最新の入力値をラッチします
パルス	非パルス入力をパルス出力に変換します
セレクター	どの入力ポートが true 値を持つかに応じてパラメーター値を出力し、最小値が優先されます
スイッチ	指定された入力から値を出力するか、サーキットブレーカーとして機能します
時間遅延	指定された時間だけ入力を遅らせます

結合要素

apama.analyticskit.blocks.core.Combiner

選択したモードと接続された入力に基づいて出力を計算します。

利用可能なモードは次のとおりです。

最小値: 値を受け取った接続された入力の最小値を出力します。すべての数値リテラルは float 型として扱われます
最大値: 値を受け取った接続された入力の最大値を出力します。すべての数値リテラルは float 型として扱われます
平均値 (平均): 値を受け取った接続された入力の平均値 (平均) を出力します。すべての数値リテラルは float 型として扱われます
最新更新値: 最後に変更された値を出力します。1 回のアクティブ化で複数の値が変更される場合は、最も大きい番号の入力ポートが使用されます。たとえば、値 1 と値 2 が更新された値を取得した場合、値 2 が出力用に選択されます。入力は同じタイプである必要があります。最新変更モードを使用する場合、実際の値が変更されない場合、値は変更されたとはみなされません。たとえば、温度センサーで最新変更モードを使用すると、温度が最後に変更されたセンサー値が出力されます
最新の入力: 実際の値が変更されていない場合でも、最新の入力値を出力します。1 回のアクティブ化で複数の値が更新される場合は、最も大きい番号の入力ポートが使用されます。たとえば、さまざまな間隔で定期的に温度を測定するセンサーが多数あり、それらすべてのセンサーでブロックが受信した最新の温度を取得したい場合は、結合要素ブロックを最新入力モードで使用できます。これにより、センサーが同じ温度を測定して公開した場合でも、最新の公開温度が提供されます

パラメーター

名前	説明	タイプ	注釈
モード	選択されるモード	オプション - 次のいずれか 1 つ最低限最大値平均値 (平均) 最新更新値最新の入力

入力ポートの詳細

名前	説明	タイプ
値 1	ブロックへの最初の入力値	any
値 2	ブロックへの 2 番目の入力値	any
値 3	ブロックへの 3 番目の入力値	any
値 4	ブロックへの 4 番目の入力値	any
値 5	ブロックへの 5 番目の入力値	any

出力ポートの詳細

名前	説明	タイプ
組み合わされた値	計算された結合値	sameAsAll(value1, value2, value3, value4, value5)

ゲート

apama.analyticskit.blocks.core.Gate

ゲートが開いて有効になっていない限り、入力が出力に送られるのをブロックします。

Enable 入力が接続されている場合、ブロックは無効で開始されます。それ以外の場合、ブロックは常に有効になります。Open 入力が接続されている場合、ブロックは閉じて開始され、そうでない場合、ブロックは開き始めます。

パラメーター

名前

説明

タイプ

注釈

Null 値

ゲートが無効または閉じられている場合に出力値として使用する値

値の正確なタイプは、「Null 値型」パラメーターによって異なります。「Null 値型」パラメーターが指定されている場合、文字列値は指定されたタイプとして解析されます。「Null 値型」パラメーターが指定されておらず、値が float または boolean 値に解析可能な場合は、対応する値の型に解析されます。それ以外の場合は、文字列値として使用されます。

string

オプション

Null 値型

「Null 値」パラメーターで指定された値の型。指定した場合、null 値は指定された型に解析されます

オプション - 次のいずれか 1 つ

フロート
ブール値
文字列

オプション

閉鎖期間 (秒)

閉信号を受信したときにゲートを閉じる時間 (秒単位)

パラメーターが指定されていない場合、クローズ信号を受信した後、オープン信号を受信するまでゲートは閉じたままになります。パラメーターが指定されている場合、その時間が経過する前に別の開閉信号を受信しない限り、ゲートは指定された秒数後に自動的に開きます。開くときに、ゲートも有効になっている場合は、最新の入力値が出力として送信されます。

これは有限の正の数でなければなりません

float

オプション

入力ポートの詳細

名前	説明	タイプ
値	出力に渡す値	any
有効化	ゲートを有効にします。ゲートを常に有効にする場合は、このポートを未接続のままにしておきます	boolean
開く	ゲートを開きます。最初にゲートを開いたままにする場合は、このポートを未接続のままにしておきます	pulse
閉じる	ゲートを閉じます。「閉鎖期間」パラメーターが指定されている場合、ゲートは指定された秒数だけ閉じられます	pulse

出力ポートの詳細

名前	説明	タイプ
ゲート値	ゲートが開いていて有効な場合の入力値と同じです。それ以外の場合は、Null Value パラメーターで指定された値	入力(値)
アクティブ	パルスを出力します。ゲートがアクティブになるときに生成されます。ゲートが開いていて有効になっている場合、ゲートはアクティブになります	pulse
非アクティブ	パルスを出力します。ゲートが非アクティブになったときに生成されます。ゲートが閉じられているか無効になっている場合、ゲートは非アクティブになります	pulse

ラッチ値

apama.analyticskit.blocks.core.Latch

ブロックが有効になっている間に受信した最新の入力値をラッチします。

入力値が変化し、ブロックが有効になっている場合にのみ出力を生成します。「有効化」入力が接続されている場合、ブロックは無効で開始されます。そうでない場合、ブロックは常に有効になります。

入力ポートの詳細

名前	説明	タイプ
値	監視する入力値	any
有効化	ブロックを有効にします。ブロックを常に有効にする場合は、これを未接続のままにしておきます	boolean

出力ポートの詳細

名前	説明	タイプ
ラッチ値	入力値と同じ。ブロックが有効になっている間に入力が変更された場合にのみ生成されます	入力(値)
変更済み	パルスを出力します。ブロックが有効になっている間に入力が変更された場合にのみ生成されます	pulse
有効化	パルスを出力します。ブロックが有効になっているが、以前は無効になっていた場合に生成されます	pulse
無効	パルスを出力します。ブロックが無効になっているが、以前は有効になっていた場合に生成されます	pulse

パルス

apama.analyticskit.blocks.core.Pulse

非パルス入力をパルス出力に変換します。

これは、パルス値と非パルス値の両方を消費するブロック、および明示的な変換なしで入力値が非パルスとして扱われるブロックで便利です。

たとえば、OR ブロックに渡された数値は、ゼロ以外の場合は true として扱われます (Analytics Builder ドキュメントの「型変換」トピックで説明されています)。ただし、数値を Pulse ブロックに渡し、Pulse ブロックの出力を OR ブロックに接続すると、数値がパルスに変換され、OR ブロックがパルスを送信します。このブロックは、値が変化した場合 (デフォルトのパルス変換動作)、入力ごと、またはゼロ以外の値ごとにパルスを送信するように構成できます。

パラメーター

名前	説明	タイプ	注釈
モード	ブロックがパルスを送信するタイミングを制御します	オプション - 次のいずれか 1 つ値変更時入力時ゼロではない値の発生時	デフォルト: 値変更時

入力ポートの詳細

名前	説明	タイプ
値	パルスとして扱う入力	any

出力ポートの詳細

名前	説明	タイプ
パルス	入力値を換算した出力パルス値です	pulse

セレクター

apama.analyticsbuilder.blocks.Selector

どの入力ポートが true 値を持つかに応じてパラメーター値を出力し、最小値が優先されます。

このブロックのパラメーターを使用して、送信される出力値を指定します。パラメーター値のうちの 1 つだけが出力で送信されます。これは、対応する入力ポートが true 値を受信したときに送信されます。複数の入力ポートが true 値を受け取る場合、名前に最も小さい番号を持つ入力ポートが使用されます。たとえば、入力 1 は入力 2 よりも高い優先順位を持ちます。

すべての入力値が false の場合、No Input パラメーターで指定された値が送信されます。

例: 入力 1 は「高」、入力 2 は「中」、入力 3 は「低」、入力なしパラメーターの値は「オフ」です。どの入力ポートも true 値を受信しない場合は、出力値として「オフ」が送信されます。入力 2 ポートと入力 3 ポートの両方が true 値を受信し、入力 1 が false 値を受信した場合、出力値として「中」が送信されます。これは、入力 2 の優先順位が入力 3 よりも高いためです。

パラメーター

名前	説明	タイプ	注釈
入力 1	入力 1 ポートが true 値を受信したときに送信される出力	string
入力 2	入力 2 ポートが true 値を受信したときに送信される出力ですが、これが名前の中で最も小さい番号を持つポートである場合に限ります	string	オプション
入力 3	入力 3 ポートが true 値を受信したときに送信される出力ですが、これが名前の中で最も小さい番号を持つポートである場合に限ります	string	オプション
入力 4	入力 4 ポートが true 値を受信したときに送信される出力ですが、これが名前の中で最も小さい番号を持つポートである場合に限ります	string	オプション
入力 5	入力 5 ポートが true 値を受信したときに送信される出力ですが、これが名前の中で最も小さい番号を持つポートである場合に限ります	string	オプション
入力なし	true 値を持つ入力がない場合に送信される出力	string
タイプ	パラメーター値を解釈し、出力タイプを設定する方法タイプとして JSON が選択されている場合、すべての入力パラメーター値は同じタイプの有効な JSON 値である必要があります。これにより、セレクターブロックがプロパティを出力できるようになり、たとえばプロパティの設定ブロックと併用して、セレクターブロックのどの入力端子が有効になっているかに応じて、出力ブロックのさまざまなプロパティセットを生成できます。 [タイプ] パラメーターが選択されていない場合、出力値のタイプはすべての入力パラメーター値のタイプに基づいて設定されます。すべての値が true または false の場合、出力はブール値になります。すべての値が数値の場合、出力は浮動小数点値になります。それ以外の場合はすべて、出力は文字列値です。	オプション - 次のいずれか 1 つフロートブール値文字列 JSON	オプション

入力ポートの詳細

名前	説明	タイプ
入力 1	true の場合、入力 1 パラメーター値が送信されます	boolean
入力 2	true の場合（また、それより小さい番号の入力が true でない場合）、入力 2 パラメーター値が送信されます	boolean
入力 3	true の場合（また、それより小さい番号の入力が true でない場合）、入力 3 パラメーター値が送信されます	boolean
入力 4	true の場合（また、それより小さい番号の入力が true でない場合）、入力 4 パラメーター値が送信されます	boolean
入力 5	true の場合（また、それより小さい番号の入力が true でない場合）、入力 5 パラメーター値が送信されます	boolean

出力ポートの詳細

名前	説明	タイプ
出力	いずれかのパラメーターからの出力値	any

スイッチ

apama.analyticsbuilder.blocks.Switch

指定された入力から値を出力するか、サーキットブレーカーとして機能します。

[選択された入力] パラメーターが指定されている場合は、指定された入力が存在し、対応する入力ポートが接続されている必要があります。

[選択された入力] パラメーターが指定されていない場合、ブロックはサーキットブレーカーとして機能します。

入力には初期のデフォルト名を使用できます。ただし、よりわかりやすい名前に変更することもできます。入力名は一意である必要があるため、2 つの入力が同じ名前を共有することはできません。接続された入力はすべて同じタイプである必要があります。

想定されるユースケースは、[選択された入力] パラメーターがテンプレートパラメーターに設定され、モデルインスタンスごとに個別に設定して、どの入力が使用されるかを決定することです。

パラメーター

名前	説明	タイプ	注釈
選択された入力	出力を指定するには、5 つの入力名のいずれかを指定します。サーキットブレーカーとして機能するには、このパラメーターを空のままにします	string	オプション
入力1 の名前	ブロックへの最初の入力の名前	string	デフォルト: input1
入力2 の名前	ブロックへの 2 番目の入力の名前	string	デフォルト: input2
入力3 の名前	ブロックへの 3 番目の入力の名前	string	デフォルト: input3
入力4 の名前	ブロックへの 4 番目の入力の名前	string	デフォルト: input4
入力5 の名前	ブロックへの 5 番目の入力の名前	string	デフォルト: input5

入力ポートの詳細

名前	説明	タイプ
入力1	最初の入力	any
入力2	2 番目の入力	any
入力3	3 番目の入力	any
input4	4 番目の入力	any
input5	5 番目の入力	any

出力ポートの詳細

名前	説明	タイプ
スイッチ	指定された入力からの値、または [選択された入力] パラメーターが空の場合は値なし (サーキットブレーカー)	sameAsAll(input1, input2, input3, input4, input5)

時間遅延

apama.analyticskit.blocks.core.TimeDelay

指定された時間だけ入力を遅らせます。

パラメーター

名前	説明	タイプ	注釈
遅延時間 (秒)	入力が遅れる時間 (秒単位) これは有限の正の数でなければなりません	float

入力ポートの詳細

名前	説明	タイプ
値	遅延させる入力値	any

出力ポートの詳細

名前	説明	タイプ
遅延値	遅延された出力値	入力(値)

ユーティリティ

このカテゴリには、次のブロックが含まれます。

ブロック名	説明
定数値	トリガー入力ポートが信号を受信したとき、または起動時に値を出力します
Cron Timer	cron のような定期タイマー構文に基づいて信号出力を送信します
持続時間	設定した開始時刻からの経過時間を計測します
プロパティの抽出	入力値から指定されたプロパティを抽出し、指定された型に変換します
ジオフェンス	入力値を定義されたジオフェンス値と比較して、デバイスがジオフェンス内にあるかどうか、およびデバイスがジオフェンスに出入りしたかどうかを検出します
不足データ	設定された時間の間入力が発生しなかった場合に出力を生成します
プロパティの設定	入力ポートの値から設定されたプロパティを使用してパルスを出力します
テキストの代替	テキストテンプレート内のハッシュと中括弧でマークされた識別子 (#{name} など) を、入力値の対応するエントリに置き換えます
切り替え	オプションの遅延を使用して、セット信号とリセット信号に基づいて 2 つのパルス入力をブール出力に変換します

定数値

apama.analyticsbuilder.blocks.ConstantValue

トリガー入力ポートが信号を受信したとき、または起動時に値を出力します。

トリガー入力ポートを使用すると、トリガー入力が受信されるまで出力を遅らせることができます。トリガー入力端子が接続されていない場合、モデルがアクティブ化されたときにブロックは値を出力し、これによりさらなる処理がトリガーされる可能性があります。

値パラメーターは文字列または JSON 値として扱うことができます。JSON 文字列、数値、またはブール値の場合、それが出力のタイプになります。JSON オブジェクトの場合、出力はオブジェクトのプロパティを含むパルスになります。JSON 配列はオブジェクト内でのみ許可されます。

パラメーター

名前	説明	タイプ	注釈
値	出力する値	string
タイプ	Value パラメーターの解釈方法	オプション - 次のいずれか 1 つ文字列 JSON	デフォルト: JSON

入力ポートの詳細

名前	説明	タイプ
トリガー	接続されている場合は、このトリガーで出力を送信します	boolean

出力ポートの詳細

名前	説明	タイプ
出力	Value パラメーターからの出力値	any

Cron Timer

apama.analyticskit.blocks.core.CronTimer

cron のような定期タイマー構文に基づいて信号出力を送信します。

タイマーティック出力は、時間がパターンと一致するたびに送信されます。「タイムゾーン」パラメーターは、サポートされている任意のタイムゾーンに設定できる、大文字と小文字が区別される文字列です。他のパラメーターは、常に一致するようにアスタリスク (*) に設定することも、特定の時刻に起動するコンマ区切りの数値のリストに設定することも、数値の倍数ごとに起動するように「* / 数値」に設定することもできます。

例えば：

毎週水曜日の 20:30 にシグナルを送信するには:

曜日: 4
時間: 20
分: 30

5 秒ごとに信号を送信するには:

秒: * / 5

ヨーロッパ/ベルリンのタイムゾーンで信号を送信するには:

タイムゾーン: ヨーロッパ/ベルリン

「日付」パラメーターと「曜日」パラメーターは連携して動作し、両方が指定されている場合は、いずれかのパラメーターの一致によって出力がトリガーされます。たとえば、「日付」が 15 に設定され、「曜日」が 1 に設定されている場合、曜日に関係なく、毎月月曜日と 15 日に出力が行われます。

このブロックはシミュレーションモードではサポートされていません

パラメーター

名前	説明	タイプ	注釈
秒	シグナルをトリガーする秒数範囲: 0 ～ 59	string	デフォルト: 0
分	シグナルをトリガーする分範囲: 0 ～ 59	string	デフォルト: *
時間	シグナルをトリガーする時間範囲: 0 ～ 23	string	デフォルト: *
日付	シグナルをトリガーする月の日範囲: 1 ～ 31	string	デフォルト: *
月	シグナルをトリガーする月範囲: 1 ～ 12	string	デフォルト: *
曜日	シグナルをトリガーする曜日範囲: 0 (日曜日) ～ 6 (土曜日)	string	デフォルト: *
タイムゾーン	使用するタイムゾーン例: ヨーロッパ/ベルリン。完全なリストについては、サポートされているタイムゾーンをご覧くださいデフォルト値は空です。これは、プラットフォームのタイムゾーンが使用されることを意味します。	string	デフォルト:

出力ポートの詳細

名前	説明	タイプ
タイマーティック	cron パラメーターに基づいて各トリガー時間に送信されます	pulse

持続時間

apama.analyticskit.blocks.core.Duration

設定した開始時刻からの経過時間を計測します。

開始時間は、ブロックをアクティブにする開始信号によって設定されます。ブロックがすでにアクティブである場合、開始信号は無視され、既存の測定は影響を受けません。ブロックはリセット信号によって非アクティブ化され、定期的な出力も無効になります。

このブロックは、開始信号からの経過時間を秒単位で計測した浮動小数点出力を生成します。測定信号を受信したときにブロックが非アクティブである場合、出力として 0.0 が生成されます。

複数の信号を同時に受信した場合は、測定、リセット、スタートの順に処理されます。したがって、たとえば、測定信号とリセット信号が一緒に受信された場合、ブロックはまず現在の期間で出力を生成し、次にその状態をリセットします。この順序で入力を処理すると、ブロックの現在の状態が出力され、必要に応じて単一時間単位内でブロックを再起動できるようになります。

パラメーター

名前	説明	タイプ	注釈
定期的出力 (秒)	アクティブなブロックによって自動的に生成される出力間の時間 (秒単位)。設定されていない場合、出力は測定信号を受信したときにのみ生成されますこれは有限の正の数でなければなりません	float	オプション

入力ポートの詳細

名前	説明	タイプ
測定	ブロックがアクティブになってからの継続時間 (秒単位) の出力をトリガーします。ブロックが非アクティブな場合は、0.0 が出力されます	pulse
リセット	ブロックの状態を非アクティブ化し、リセットします	pulse
開始	ブロックをアクティブにします	pulse

出力ポートの詳細

名前	説明	タイプ
持続時間	開始信号を受信してからの時間（秒）	float

プロパティの抽出

apama.analyticskit.blocks.core.ExtractProperty

入力値から指定されたプロパティを抽出し、指定された型に変換します。

「プロパティパス」パラメーターによって指定される値入力の値は、文字列、数値、またはブール値である必要があります。

「プロパティパス」パラメーターの一部としてピリオド (.) を指定して、ディクショナリからネストされた値を抽出できます。

例: 入力が { "location" : { "city" : "Cambridge" } } (JSON 形式) の場合、location.city< を指定してその値を抽出できます。を「プロパティパス」パラメーターとして使用します。

また、「プロパティパス」パラメーターの一部として角括弧を指定して、シーケンスから特定の要素を抽出することもできます。

値がオブジェクトの場合、そのオブジェクトのプロパティは抽出値出力ポートのプロパティとして出力されます。

例: 入力が { "users" : [ { "age" : 40.375 } ] } (JSON 形式) の場合、「プロパティパス」パラメーターとして users[0].age を指定することでその値を抽出できます。

このブロックは、キーにピリオド (.) や角括弧などの特殊文字が含まれる辞書からのエントリの抽出をサポートしていません。また、角括弧を使用せずにシーケンスからエントリを抽出することはサポートされていません。たとえば、users.0.id は users[0].id と記述する必要があります。

文字列を float に変換する際、このブロックは空の文字列を解析できないものとしてではなく、値 0.0 として扱います。

パラメーター

名前	説明	タイプ	注釈
プロパティパス	入力値から抽出されるプロパティの名前またはパス。設定されていない場合、すべてのプロパティが出力されます	string	オプション
プロパティタイプ	プロパティ値の変換先の型。[プロパティ] に設定すると、抽出された値のプロパティを使用してパルスが出力されます	オプション - 次のいずれか 1 つ文字列ブール値フロートプロパティ	デフォルト: 文字列
ない場合はクリア	これを選択すると、「プロパティパス」パラメーターが指定されなかった場合、または値を指定された型に変換できない場合に、指定された型のデフォルト値が出力されます	boolean	デフォルト: False

入力ポートの詳細

名前	説明	タイプ
値	プロパティの抽出元となる入力値	any

出力ポートの詳細

名前	説明	タイプ
抽出された値	入力値から抽出された値	any

ジオフェンス

apama.analyticsbuilder.blocks.Geofence

入力値を定義されたジオフェンス値と比較して、デバイスがジオフェンス内にあるかどうか、およびデバイスがジオフェンスに出入りしたかどうかを検出します。

境界線自体はジオフェンスエリアの外側にあると見なされます。

パラメーター

名前	説明	タイプ	注釈
ジオフェンス	地球の表面上の領域を表す多角形国際日付変更線を超えることは(経度 +/- 180 度) はサポートされていないことにご注意ください。	シーケンス

入力ポートの詳細

名前	説明	タイプ
位置	経度 (lng) と緯度 (lat) のプロパティが抽出される入力値	any

出力ポートの詳細

名前	説明	タイプ
ジオフェンス内	デバイスが定義されたジオフェンス内にある場合、true に設定されます	boolean
進入したジオフェンス	デバイスが定義されたジオフェンスに入ったときに信号を送信します	pulse
退出したジオフェンス	デバイスが定義されたジオフェンスから出るときに信号を送信します	pulse

不足データ

apama.analyticskit.blocks.core.MissingData

設定された時間の間入力が発生しなかった場合に出力を生成します。

このブロックは、繰り返される同じ値の入力がカウントされない場合、オプションで値の変化がないことを検出することができます。

パラメーター

名前	説明	タイプ	注釈
繰り返し入力を無視する	選択すると、同じ値の入力は無視されます	boolean	デフォルト: False
持続時間 (秒)	ブロックが入力を待機する時間 (秒単位) これは有限の正の数でなければなりません	float

入力ポートの詳細

名前	説明	タイプ
値	有無を検出するデータ	any
リセット	ブロックの状態をリセットします - タイマーと以前の値をリセットします	pulse

出力ポートの詳細

名前	説明	タイプ
不足データ	データなし。指定された期間内に入力が受信されなかった場合は true、それ以外の場合は false	boolean

プロパティの設定

apama.analyticsbuilder.blocks.SetProperties

入力ポートの値から設定されたプロパティを使用してパルスを出力します。

プロパティ名はパラメーターから取得され、入力ポートからの値が取得されます。新しいプロパティは、受信した場合にのみ出力されます。少なくとも 1 つの入力が提供されるとすぐに出力が送信されます。

プロパティは、次の優先順位で出力に設定されます。

パラメーターを使用して明示的に指定されたプロパティ。入力がパルスの場合、その入力のプロパティを使用してオブジェクトとして扱われます。入力にプライマリ値 (パルスではない) がある場合は、そのプライマリ値が使用されます。代わりにプロパティを使用するには、「プロパティパス」パラメーターを設定せず、プロパティタイプパラメーターをプロパティに設定してプロパティの抽出ブロックを使用します。これにより、主な値がパルス (無視されます) に置き換えられ、プロパティが使用されます
対応するパラメーターセットを持たない入力ポートの値オブジェクトのプロパティ。これは、properties ディクショナリを直接マージしたものです。2 つのディクショナリに同じプロパティキーがある場合、最小の識別子を持つ入力ポートが優先されます。したがって、入力 1 の共有プロパティは、入力 2 以降のプロパティを上書きします
「マージ」入力ポートに提供される Value オブジェクトのプロパティは、いずれかによって上書きされない限り、保持されます。上記の操作の。オプションの「マージ」入力ポートを使用すると、別のブロックから一連のプロパティを連鎖したり補足したりできます

したがって、入力に設定されたプロパティは、より優先順位の高い入力上の同じ名前を持つプロパティによって上書きされるか、指定されたプロパティに対して入力が設定されている場合に上書きされます。

パラメーター

名前	説明	タイプ	注釈
プロパティ 1	入力ポート 1 からの値を使用して、出力に設定するプロパティ	string	オプション
プロパティ 2	入力ポート 2 からの値を使用して、出力に設定するプロパティ	string	オプション
プロパティ 3	入力ポート 3 からの値を使用して、出力に設定するプロパティ	string	オプション
プロパティ 4	入力ポート 4 からの値を使用して、出力に設定するプロパティ	string	オプション
プロパティ 5	入力ポート 5 からの値を使用して、出力に設定するプロパティ	string	オプション

入力ポートの詳細

名前	説明	タイプ
入力 1	パラメータープロパティ 1 のプロパティ名を使用して追加される値	any
入力 2	パラメータープロパティ 2 のプロパティ名を使用して追加される値	any
入力 3	パラメータープロパティ 3 のプロパティ名を使用して追加される値	any
入力 4	パラメータープロパティ 4 のプロパティ名を使用して追加される値	any
入力 5	パラメータープロパティ 5 のプロパティ名を使用して追加される値	any
マージ	指定されたプロパティとマージするソース。ここからのプロパティは、入力値で置き換えられずに出力に渡されます	any

出力ポートの詳細

名前	説明	タイプ
出力	追加のプロパティが指定された出力値	pulse

テキストの代替

apama.analyticsbuilder.blocks.TextSubstitution

テキストテンプレート内のハッシュと中括弧でマークされた識別子 (#{name} など) を、入力値の対応するエントリに置き換えます。

オブジェクトまたはソース入力ポートの少なくとも 1 つが接続されている必要があります。解決できない識別子は置換されません。

source. のプレフィックスが付いた識別子 (たとえば、#{source.name}) は、「ソース」入力ポートで受け取られた値で検索されます。たとえば、[ソース] 入力ポートで受け取られた値が { "name": "sample_name" } である場合、識別子 #{source.name} は sample_name に解決されます。

source. というプレフィックスが付いていない識別子は、オブジェクト入力ポートで受信した値内で検索されます。

ネストされた識別子は、ドット (.) で区切って指定できます。たとえば、オブジェクト入力ポートが値 { "address": { "street": { "name": "example_street" }}} を受け取った場合、識別子 #{address .street.name} は example_street に解決されます。

ドット(.) のあるキーはサポートされていません。「オブジェクト」入力ポート値が { "address.street": { "name": "example_street" }} 形式である場合、識別子 #{address.street.name} は address エントリ内に street を入れ子にすることを予期するため、example_street の値は解決できません。

integer、float、boolean、string などのプリミティブ値は直接代替されますが、複合値は代替の前に JSON 表現に変換されます。

integer、float、boolean、string などのプリミティブ値は直接代替されますが、複合値は代替の前に JSON 表現に変換されます。テキストtime (大文字と小文字を区別する) と値タイプ float を持つ識別子はすべて、タイムスタンプ値として解釈され、代替前に yyyy-MM-ddTHH:mm:ss.SSSZ 形式に変換されます。これは、次の構文を使用してオプションのパラメーターで変更できます: {time:param1="value1",param2="value2"}。パラメーター TZ="time_zone" を使用して別のタイムゾーンを指定したり、パラメーター FORMAT="format_string" を使用して別の形式を指定したりできます。たとえば、#{time:TZ="America/New_York",FORMAT="HH:mm:ssZ"} は、ニューヨークのタイムゾーンを指定し、形式は HH:mm:ssZ になります。タイムゾーンが認識されない場合は、モデルをアクティブ化できません。

注: 時刻の形式文字列には引用符 (") と中括弧 ({ と }) を含めることはできません。

ハッシュ (#) は、#{#} のようにエスケープすることでテキストテンプレートに指定できます。

詳細については、タイムゾーンのリストと有効な時刻形式文字列のリストをご覧ください。

パラメーター

名前	説明	タイプ	注釈
テキストテンプレート	#{name} などの識別子を入力ポートからの値に置き換えて出力を生成するために使用されるテキスト	string

入力ポートの詳細

名前	説明	タイプ
オブジェクト	source. というプレフィックスが付いていない識別子を置換するために使用されます。たとえば、#{name} または #{timestamp} です	any
ソース	source. というプレフィックスが付いた識別子の置換に使用されます。たとえば、#{source.name} です	any

出力ポートの詳細

名前	説明	タイプ
出力	テキストテンプレートからの置換を含む文字列	string

切り替え

apama.analyticskit.blocks.core.Toggle

2 つのパルス入力を、オプションで遅延を伴うセット信号とリセット信号に基づいたブール出力に変換します。

遅延がなければ、設定信号時に出力状態はtrue に変化し、リセット信号時には false に変化します。両方の信号が同時に受け取られた場合は、出力状態が切り替わります(信号がはじめて受け取られた場合は true に)。

遅延時間が指定されている場合、出力状態は遅延が適用された後にのみ true または false に変更されます。

信号が同時に受け取られた場合は、次の例外が適用されます:出力状態は、両方の遅延時間が同じであるか、指定されていない場合にのみ切り替わります。

パラメーター

名前

説明

タイプ

注釈

遅延設定 (秒)

設定された信号が処理されるまでの時間 (秒)

パラメーターが指定されていない場合、信号はすぐに処理されます。

これは有限の正の数でなければなりません

float

オプション

遅延のリセット (秒)

リセット信号が処理されるまでの時間 (秒)

パラメーターが指定されていない場合、信号はすぐに処理されます。

これは有限の正の数でなければなりません

float

オプション

入力ポートの詳細

名前	説明	タイプ
設定	出力を true に設定します。保留中の遅延セットまたはリセット信号は、新しい入力でキャンセルされます	pulse
リセット	出力を false に設定します。保留中の遅延セットまたはリセット信号は、新しい入力でキャンセルされます	pulse

出力ポートの詳細

名前	説明	タイプ
値	入力信号から生成された出力値	boolean