トランザクションの読み取り

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

トランザクションの読み取り

Matter is the reading of an Attribute from another Node, such as a temperature value from a sensor. In such Interactions, the first Action that must be performed is the Read Request Action. でノードを操作する際の最初のユースケースの一つ

読み取りトランザクションのオペレーションのシーケンス
図 1: 読み取りトランザクション

読み取りリクエストの操作

方向: イニシエータ -> ターゲット

このアクションでは、イニシエータがターゲットにクエリを実行して以下を提供します。

  • 属性リクエスト: ゼロ個以上のターゲットの属性のリスト。このリストは、ターゲットのリクエストされた属性への 0 個以上のパスで構成されます。
  • イベント リクエスト: ターゲットがリクエストしたイベントへのゼロ個以上のパスのリスト。

読み取りリクエスト アクションは、ターゲットで受信された後、リクエストされた情報を含むレポートデータ アクションを組み立てます。

データ操作に関するレポート

方向: ターゲット -> イニシエータ

このアクションでは、ターゲットは次のように応答します。

  • 属性レポート: 読み取りアクション リクエストでリクエストされた、ゼロ個以上の属性のリスト。
  • イベント レポート: 報告された 0 個以上のイベントのリスト。
  • 抑制レスポンス: このアクションに対するステータス レスポンスを抑制するかどうかを決定するフラグ。
  • 定期購入 ID: このレポートが定期購入取引の一部である場合は、定期購入トランザクションを識別するために使用される整数を含める必要があります。

ステータス対応アクション

方向: [Target] -> [Initiator] または [Initiator -> Target]

イニシエータが要求されたデータを受信すると、デフォルトでステータス応答アクションを生成する必要があります。このアクションはイニシエータから送信され、報告されたデータの受信を確認します。フラグの [Suppress Status Response] が設定されている場合、イニシエータはステータス レスポンス アクションを送信してはなりません。

ステータス レスポンス アクションがイニシエータによって送信されるか、Suppress Response フラグが有効にされたイニシエータがレポートデータ アクションを受信すると、読み取り/レポートクエリは終了します。

ステータス レスポンスのアクションに含まれる status フィールドには、オペレーションの成功を示すか、失敗コードが表示されます。

読み取り制限

読み取りリクエスト アクションとレポートデータ アクションは Unicast-only. Moreover, the Paths of these requests may not target a Group of Nodes. です。

ステータス レスポンス アクションは Unicast のみであり、グループキャストへのレスポンスとして生成することはできません。

サブスクリプション取引

定期購入取引のオペレーションのシーケンス
図 2: 定期購読の取引

購読リクエスト アクション

方向: イニシエータ -> ターゲット

イニシエータは、単一の読み取りリクエスト アクションに加えて、属性やイベントの定期的な更新をサブスクライブすることもできます。したがって、定期購入取引の後に定期的なデータ更新が行われると、同じレポートデータ アクションが生成されます。

サブスクリプションの操作では、2 つのノード間のリレーションが作成されます。ターゲットは定期的にイニシエータにレポートデータ アクションを生成します。開始者はサブスクライバー、ターゲットはパブリッシャーです。

購読リクエスト アクションの内容は次のとおりです。

  • 最小インターバル Floor: レポートの最小間隔
  • 最大間隔の間隔: レポートの最大間隔。
  • 属性レポート: 読み取りアクション リクエストでリクエストされたレポートされた属性(0 つ以上)のリスト。
  • イベント レポート: ゼロ件以上のイベントに関するレポート。

サブスクライブ リクエスト後、ターゲットはイニシエータに応答し、レポートデータ アクション(レポートされたデータの最初のバッチ: Primed Public Data を含む)を返します。

次に、イニシエータは、ターゲットに送信されたステータス レスポンス アクションで Report Data Action を確認します。ターゲットは、エラーを報告しないステータス レスポンス アクションを受信すると、サブスクライブ レスポンス アクションを送信します。

その後、ターゲットは交渉済みの間隔でレポートデータ アクションを定期的に送信し、サブスクリプションが失われるかキャンセルされるまでイニシエータはこれらのアクションに応答します。

購読レスポンス アクション

方向: ターゲット -> イニシエータ

これは、定期購入取引での最後のアクションであり、プロセスが終了します。次の内容が含まれます。

  • 定期購入 ID: 定期購入を識別する整数。
  • 最小間隔: 最終決定された最小レポート間隔。
  • 最大間隔: レポート間の最大間隔です。

定期購入の制限

  • 購読リクエスト アクションと購読レスポンス アクションは Unicast のみのアクションです。
  • サブスクリプションの操作内のすべてのレポートデータ アクションは、同じサブスクリプション ID を持つ必要があります。
  • サブスクライバーが、アクション間の最大交渉間隔内にレポートデータ アクションを受信しなかった場合、サブスクリプションが終了します。
  • 前述のルールに基づき、ニュース メディアは定期的なレポートデータ アクションの送信を停止するだけで、定期購入の操作を終了できます。
  • サブスクライバーは、レポートデータ アクションに INACTIVE_SUBSCRIPTION ステータス コードを返すことで、定期購入の操作を終了できます。