JavaScript için Azure Model Ayrıştırıcı istemci kitaplığı - sürüm 1.0.0-beta.2

DTDL modellerinizi ayrıştırmak ve yapılarının DTDL belirtimine uygun olduğunu doğrulamak için bu kitaplığı kullanın.

Dijital İkiz Tanım Dili (DTDL), Dijital İkiz modelleri oluşturmak için JSON-LD tabanlı bir şema tanımlar. DTDL belirtimi geliştikçe, bu ayrıştırıcı buna göre güncelleştirilir. Azure Digital Twins'in temel özelliklerinden biri, kendi kelime dağarcığınızı tanımlayıp işletmenizin kendi tanımladığı terimlerde ikiz grafınızı oluşturabilmektir. Bu özellik, kullanıcı tarafından sağlanan modeller aracılığıyla sağlanır. Modelleri dünyanızın bir tanımında isim olarak düşünebilirsiniz.

DTDL hakkında daha fazla bilgiyi burada bulabilirsiniz.

Başlarken

Şu anda desteklenen ortamlar

• Node.jsLTS sürümleri
• Safari, Chrome, Edge ve Firefox'un en son sürümleri.

Daha fazla ayrıntı için destek ilkemize bakın.

Önkoşullar

Yok.

@azure/dtdl-parser paketini yükleyin

ile npmJavaScript için Digital Twins Model Ayrıştırıcı istemci kitaplığını yükleyin:

npm install @azure/dtdl-parser

Genel DTDL Model Deposuna Erişme

Henüz bir DTDL modeli yazmadıysanız genel kullanıma açık DTDL modellerinin tam deposuna buradan erişebilirsiniz: Github: DTDL kullanan IoT Tak Çalıştır model deposu

Tarayıcı desteği

JavaScript Paketi

Bu istemci kitaplığını tarayıcıda kullanmak için önce bir paketleyici kullanmanız gerekir. Bunun nasıl yapılacağının ayrıntıları için lütfen paketleme belgelerimize bakın.

Önemli kavramlar

DTDL Ayrıştırıcısı

DTDL (Digital Twins Tanım Dili), Dijital İkiz Tak ve Plan cihazlarının modelleriyle etkileşime geçme anlaşması tanımlar. DTDL Ayrıştırıcısı, bir DTDL şema tanımına göre kısmen el ile yazılmış, kısmen oluşturulmuş bir langauge ayrıştırıcısıdır ve bu da sağlanan bir dizenin DTDL langauge tanımlarına uygun olup olmadığını doğrulayabilir.

Modeller için DTDL hakkında daha fazla bilgi edinmek için "İkiz modelleri hakkında bilgi edinin ve bunları nasıl tanımlayacağınızı öğrenin (Azure Digital Twins](https://docs.microsoft.com/azure/digital-twins/concepts-models)

Örnekler

DTDL Modelini Ayrıştırma

Örnek bir DTDL modelini ayrıştırmak için, önceden yazdığınız bir modelle başlayın veya genel DTDL veritabanında bulunan bir modeli kullanın. Şimdi modeller deposundan örnek bir model alalım:

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

Sorun giderme

Günlüğe Kaydetme

NOT: Bu paket şu anda Azure Günlüğü'ne sahip değildir, ancak GA sürümü tarafından desteklenecektir.

Günlüğün etkinleştirilmesi hatalarla ilgili yararlı bilgilerin ortaya çıkarılmasına yardımcı olabilir. HTTP isteklerinin ve yanıtlarının günlüğünü görmek için ortam değişkenini AZURE_LOG_LEVEL olarak infoayarlayın. Alternatif olarak, günlüğü çalışma zamanında içinde çağrılarak setLogLevel@azure/loggeretkinleştirilebilir:

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

setLogLevel("info");

Günlükleri etkinleştirme hakkında daha ayrıntılı yönergeler için @azure/günlükçü paketi belgelerine bakabilirsiniz.

Sonraki adımlar

İstemci kitaplıklarının nasıl kullanılacağını gösteren ayrıntılı örnekler için lütfen samples dizinine göz atın.

Katkıda bulunma

Bu kitaplığa katkıda bulunmak isterseniz, kodu derleme ve test etme hakkında daha fazla bilgi edinmek için lütfen katkıda bulunma kılavuzunu okuyun.

İlgili projeler

• Javascript için Microsoft Azure SDK