シナリオ: デジタル・ツイン・モデルへのJSONスキーマ検証の追加

デジタル・ツイン・モデルがDTDL仕様v3を使用していることを示す、必要なデジタル・ツイン・モデル・コンテキスト: dtmi:dtdl:context;3

検証拡張を定義するには、デジタル・ツイン・モデルの作成またはデジタル・ツイン・モデルの更新時に、検証拡張を@contextのDTMI URI値に追加します。デジタル・ツイン・モデルは、これらの検証ブロックを読み取って、受信デバイス・データに検証ルールを適用します。検証ルールに失敗したデータはすべて拒否されます。正規化データおよび拒否データは、IoTデータベース・スキーマ内にあります。

{
  "@context": [
    "dtmi:dtdl:context;3",
    "dtmi:com:oracle:dtdl:extension:validation;1"
  ],
  ...
  }

次のコード・スニペットをデジタル・ツイン・モデルの例として使用します。サポートされている検証プロパティおよびルールの完全なリストは、DTMI検証拡張機能リファレンスを参照してください。

センサーは、最初の正常な読み取りの前にそのステータスを報告することがあります。このモデルでは、読取りが成功するまでlastSuccessTimeを省略できます。ヘルス・オブジェクトには、引き続きerrorCount、staleおよびstateが必要です。

{
  "@context": [
    "dtmi:dtdl:context;3",
    "dtmi:com:oracle:dtdl:extension:validation;1"
  ],
  "@id": "dtmi:com:example:SensorHealth;1",
  "@type": "Interface",
  "displayName": "Sensor Health",
  "contents": [
    {
      "@type": ["Telemetry", "Validated"],
      "name": "health",
      "schema": {
        "@type": "Object",
        "fields": [
          { "name": "errorCount", "schema": "integer" },
          { "name": "lastSuccessTime", "schema": "dateTime" },
          { "name": "stale", "schema": "boolean" },
          { "name": "state", "schema": "string" }
        ],
        "required": ["errorCount", "stale", "state"]
      }
    }
  ]
}

次のhealth値は、オプションのフィールドを省略し、オブジェクトのフィールド要件を満たします。デジタル・ツイン・アダプタを使用して、デバイス・ペイロードをこのコンテンツにマップします。

{
  "errorCount": 0,
  "stale": true,
  "state": "initializing"
}

読取りに成功すると、値にlastSuccessTimeを含めることができます。

{
  "errorCount": 0,
  "lastSuccessTime": "2026-09-24T12:00:00Z",
  "stale": false,
  "state": "ready"
}

stateを省略すると、requiredにリストされているため、この要件は失敗します。"lastSuccessTime": nullの送信は、そのフィールドを省略する代わりにはなりません。オブジェクト・スキーマからrequiredプロパティを削除すると、宣言された4つのフィールドがすべて再度必要になります。

これにより、他のヘルス情報を必須にしながら、読取りが成功したタイムスタンプの発明を回避できます。ルールについては、「必須およびオプションのオブジェクトフィールド」を参照してください。

このスキーマは、検証拡張を持つモデル内でValidatedコタイプを持つコンテンツに使用します。外部オブジェクトにはstatusが必要ですが、locationを省略できます。locationが存在する場合、そのリストにはsiteおよびbuildingが必要です。roomはオプションのままです。

{
  "@type": "Object",
  "fields": [
    { "name": "status", "schema": "string" },
    {
      "name": "location",
      "schema": {
        "@type": "Object",
        "fields": [
          { "name": "site", "schema": "string" },
          { "name": "building", "schema": "string" },
          { "name": "room", "schema": "string" }
        ],
        "required": ["site", "building"]
      }
    }
  ],
  "required": ["status"]
}

値は、ネストされたオブジェクト全体を省略できます。

{"status": "ready"}

または、ネストされたObjectをオプション・ルームなしで指定できます。

{
  "status": "ready",
  "location": { "site": "example-campus", "building": "A" }
}

buildingのない指定された場所は、ネストされた要件を満たしていません。外部オブジェクトにフィールドをリストしても、ネストされたオブジェクト内のフィールドは制御されません。配列要素およびマップ値のオブジェクトは、この同じ独立検証ルールに従います。

デジタルツインモデルのこのコードスニペットは、950.0から1050.0までのセンサーからの圧力を有効にする方法を示し、0.1の倍数である必要があります。

{
  "@context": [
    "dtmi:dtdl:context;3",
    "dtmi:com:oracle:dtdl:extension:validation;1"
  ],
  "@id": "dtmi:com:example:Sensor;1",
  "@type": "Interface",
  "displayName": "Example Sensor",
  "contents": [
    {
      "@type": ["Telemetry", "Validated"],
      "name": "pressure",
      "schema": "double",
      "displayName": "Pressure",
      "minimum": 950.0,
      "maximum": 1050.0,
      "multipleOf": 0.1
    }
  ]
  }

この例では、特定の文字列パターンに従ってシリアル番号を検証します。この例では、文字列パターンは、受信シリアル番号値が一致する必要がある正規表現です。シリアル番号の値は「SN- 」で始まり、その後に4から8文字の大文字(A-Z)または数字(0-9)が続く必要があり、次の前後に何も許可されません。

{
  "@type": ["Property", "Validated"],
  "name": "serialNumber",
  "schema": "string",
  "pattern": "^SN-[A-Z0-9]{4,8}$"
  }

この例では、値がdouble、整数、および0から360の度、および0.1の増分であることを検証します。

{
  "@type": ["Telemetry", "Validated"],
  "name": "angle",
  "schema": "double",
  "minimum": 0.0,
  "maximum": 360.0,
  "multipleOf": 0.1
}