次の方法で共有

JavaScript 用 Azure Model Parser クライアント ライブラリ - バージョン 1.0.0-beta.2

  • [アーティクル]

DTDL モデルを解析し、その構造が DTDL 仕様に準拠していることを検証するには、このライブラリを使用します。

Digital Twin Definition Language (DTDL) は、デジタル ツイン モデルを作成するための JSON-LD ベースのスキーマを定義します。 DTDL 仕様が進化すると、このパーサーは適宜更新されます。 Azure Digital Twins の重要な特性は、独自のボキャブラリを定義し、ビジネスの自己定義用語でツイン グラフを構築できることです。 この機能は、ユーザー提供のモデルを通じて提供されます。 モデルは、世界を説明するための名詞と考えることができます。

DTDL の詳細については 、こちらを参照してください。

はじめに

現在サポートされている環境

詳細については、Microsoft のサポート ポリシーを参照してください。

前提条件

なし

@azure/dtdl-parser パッケージのインストール

を使用して、JavaScript 用の Digital Twins Model Parser クライアント ライブラリを npmインストールします。

npm install @azure/dtdl-parser

パブリック DTDL モデル リポジトリにアクセスする

DTDL モデルをまだ作成していない場合は、公開されている DTDL モデルの完全なリポジトリにアクセスできます。Github: DTDL を使用したIoT プラグ アンド プレイ モデルのリポジトリ

ブラウザーのサポート

JavaScript バンドル

ブラウザーでこのクライアント ライブラリを使用するには、まず bundler を使用する必要があります。 これを行う方法の詳細については、 バンドルに関するドキュメントを参照してください。

主要な概念

DTDL パーサー

DTDL (Digital Twins Definition Language) は、デジタル ツイン プラグ アンド プラン デバイスのモデルと対話するためのコントラクトを定義します。 DTDL パーサーは、部分的に手動で記述され、DTDL スキーマ定義に基づいて部分的に生成される言語パーサーです。DTDL スキーマ定義に指定された文字列が DTDL 言語定義に準拠しているかどうかを検証できます。

モデルの DTDL の詳細については、ツイン モデルとその定義方法 (Azure Digital Twins](https://docs.microsoft.com/azure/digital-twins/concepts-models) を参照してください。

例

DTDL モデルを解析する

サンプル DTDL モデルを解析するには、既に記述したモデルから始めるか、パブリック DTDL データベースにあるモデルを使用します。 モデル リポジトリからサンプル モデルを取得してみましょう。

// example.js
async function main() {
  const client = new ModelsRepositoryClient();
  const dtmi = "dtmi:com:example:TemperatureController;1";
  const models = await client.getModels(dtmi);

  const modelParser = createParser(ModelParsingOption.PermitAnyTopLevelElement);
  modelParser.options = ModelParsingOption.PermitAnyTopLevelElement;
  Object.entries(models).forEach(([key, value]) => {
    console.log(`dtmi: ${key}`);
    const modelDict = await modelParser.parse([value]);
    Object.entries(modelDict).forEach(([key2, value2]) => {
      console.log(key2);
    });
  });
}

main().catch((err) => {
  console.error("The sample encountered an error:", err); 
});

トラブルシューティング

ログ記録

注: このパッケージは現在、Azure Logging をサポートしていませんが、GA リリースではサポートされます。

ログの記録を有効にすると、エラーに関する有用な情報を明らかにするのに役立つ場合があります。 HTTP 要求と応答のログを表示するには、環境変数 AZURE_LOG_LEVEL を info に設定します。 または、@azure/logger で setLogLevel を呼び出して、実行時にログ記録を有効にすることもできます。

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

ログを有効にする方法の詳細については、@azure/logger パッケージに関するドキュメントを参照してください。

次のステップ

クライアント ライブラリの使用方法を示す詳細な例については、 samples ディレクトリを参照してください。

共同作成

このライブラリに投稿する場合、コードをビルドしてテストする方法の詳細については、投稿ガイドを参照してください。

インプレッション数