Digital Twins モデル パーサーについて理解する

  • [アーティクル]

Digital Twins Definition Language (DTDL) については、DTDL の仕様に関する記事で説明されています。 ユーザーは、Digital Twins モデル パーサー NuGet パッケージを使用して、DTDL モデルを検証し、クエリを実行できます。 DTDL モデルは、複数のファイルで定義できます。

DTDL モデル パーサーをインストールする

パーサーは、ID が DTDLParser の NuGet.org で使用できます。 パーサーをインストールするには、Visual Studio や dotnet CLI などで互換性のある NuGet パッケージ マネージャーを使用してください。

dotnet add package DTDLParser

Note

この記事の執筆時点では、パーサーのバージョンは 1.0.52 です。

パーサーを使用してモデルを検証および検査する

DTDLParser は、次の用途に使用できるライブラリです。

  • 言語 v2 または v3 の仕様に従って、1 つ以上のモデルが有効かどうかを判断します。
  • 特定のモデリング エラーを特定します。
  • モデルの内容を検査します。

1 つのモデルは、JSON ファイルに記述されている 1 つ以上のインターフェイスで構成されている場合があります。 パーサーを使用して、モデルを定義するすべてのファイルを読み込み、ファイル間の参照を含め、すべてのファイル全体を検証できます。

DTDLParser for .NET リポジトリには、パーサーの使用方法を示す次のサンプルが含まれています。

  • DTDLParserResolveSample は、外部参照を使用してインターフェイスを解析し、クライアントを使用して依存関係を解決する方法を Azure.IoT.ModelsRepository 示しています。
  • DTDLParserJSInteropSample は、.NET JSInterop を使用して、ブラウザーで実行されている JavaScript の DTDL パーサーを使用する方法を示しています。

DTDLParser for .NET リポジトリには、パーサーを 使用してモデルを検証および検査する方法を示すチュートリアル のコレクションも含まれています。

次のステップ

この記事で確認したモデル パーサー API を使用すると、DTDL モデルに依存するタスクを自動化または検証する多くのシナリオが可能になります。 たとえば、モデル内の情報から UI を動的に構築できます。