Pustaka klien Azure Model Parser untuk JavaScript - versi 1.0.0-beta.2

Gunakan pustaka ini untuk mengurai model DTDL Anda dan memvalidasi strukturnya sesuai dengan spesifikasi DTDL.

Digital Twin Definition Language (DTDL) mendefinisikan skema berbasis JSON-LD untuk membuat model Digital Twin. Seiring berkembangnya spesifikasi DTDL, pengurai ini akan diperbarui sesuai dengan itu. Karakteristik utama Azure Digital Twins adalah kemampuan untuk menentukan kosakata Anda sendiri dan membangun grafik kembar dalam istilah bisnis yang ditentukan sendiri. Kemampuan ini disediakan melalui model yang disediakan pengguna. Anda dapat menganggap model sebagai kata benda dalam deskripsi dunia.

Pelajari selengkapnya tentang DTDL di sini.

Memulai

Lingkungan yang didukung saat ini

• Versi LTS dari Node.js
• Safari, Chrome, Edge, dan Firefox versi terbaru.

Lihat kebijakan dukungan kami untuk detail selengkapnya.

Prasyarat

Tidak ada.

Pasang paket @azure/dtdl-parser

Instal pustaka klien Digital Twins Model Parser untuk JavaScript dengan npm:

npm install @azure/dtdl-parser

Mengakses Repositori Model DTDL Publik

Jika Anda belum menulis model DTDL, Anda dapat mengakses repositori lengkap model DTDL yang tersedia untuk umum di sini: Github: Repositori model IoT Plug and Play menggunakan DTDL

Dukungan browser

Bundel JavaScript

Untuk menggunakan pustaka klien ini di browser, pertama-tama Anda perlu menggunakan bunder. Untuk detail tentang cara melakukan ini, silakan lihat dokumentasi bundling kami.

Konsep utama

Pengurai DTDL

DTDL (Digital Twins Definition Language) mendefinisikan kontrak untuk berinteraksi dengan model perangkat Digital Twin Plug and Plan. DTDL Parser adalah pengurai bahasa yang sebagian ditulis tangan, sebagian dihasilkan berdasarkan definisi skema DTDL, yang dapat memvalidasi apakah string yang disediakan sesuai dengan definisi bahasa DTDL.

Anda dapat mempelajari selengkapnya tentang DTDL untuk model dengan membaca "Pelajari tentang model kembar dan cara menentukannya di (Azure Digital Twins](https://docs.microsoft.com/azure/digital-twins/concepts-models)

Contoh

Mengurai Model DTDL

Untuk mengurai contoh model DTDL, mulailah dengan model yang telah Anda tulis atau gunakan yang terletak di database DTDL publik. Mari kita ambil model sampel dari repositori model:

// 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); 
});

Pemecahan Masalah

Pencatatan

CATATAN: Paket ini saat ini tidak mendukung Pengelogan Azure, tetapi akan memiliki dukungan oleh rilis GA.

Mengaktifkan pengelogan dapat membantu menemukan informasi yang berguna tentang kegagalan. Untuk melihat log permintaan dan respons HTTP, atur variabel lingkungan AZURE_LOG_LEVEL ke info. Atau, pengelogan dapat diaktifkan saat runtime dengan memanggil setLogLevel di @azure/logger:

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

setLogLevel("info");

Untuk instruksi lebih rinci tentang cara mengaktifkan log, Anda dapat melihat dokumen paket @azure/pencatat.

Langkah berikutnya

Silakan lihat direktori sampel untuk contoh terperinci yang menunjukkan cara menggunakan pustaka klien.

Berkontribusi

Jika Anda ingin berkontribusi pada pustaka ini, baca panduan berkontribusi untuk mempelajari selengkapnya tentang cara membuat dan menguji kode.

Proyek terkait

• Microsoft Azure SDK untuk Javascript