Share via

فهم محلل نموذج التوائم الرقمية

  • مقالة

يتم وصف لغة تعريف التوائم الرقمية (DTDL) في مواصفات DTDL. يمكن للمستخدمين استخدام حزمة Digital Twins Model Parser NuGet للتحقق من صحة نموذج DTDL والاستعلام عنه. قد يتم تعريف نموذج DTDL في ملفات متعددة.

تثبيت محلل نموذج DTDL

يتوفر المحلل في NuGet.org بالمعرف: DTDLParser. لتثبيت المحلل، استخدم أي مدير حزمة NuGet متوافق مثل مدير في Visual Studio أو في dotnet CLI.

dotnet add package DTDLParser

إشعار

في وقت كتابة هذا التقرير، يكون إصدار المحلل هو 1.0.52.

استخدام المحلل للتحقق من صحة نموذج وفحصه

DTDLParser هي مكتبة يمكنك استخدامها من أجل:

  • تحديد ما إذا كان نموذج واحد أو أكثر صالحا وفقا لمواصفات اللغة v2 أو v3.
  • تحديد أخطاء نمذجة محددة.
  • فحص محتويات النموذج.

يمكن أن يتكون النموذج من واجهة واحدة أو أكثر من الواجهات الموضحة في ملفات JSON. يمكنك استخدام المحلل لتحميل جميع الملفات التي تحدد نموذجا ثم التحقق من صحة جميع الملفات ككل، بما في ذلك أي مراجع بين الملفات.

يتضمن مستودع DTDLParser ل .NET العينات التالية التي توضح استخدام المحلل:

  • DTDLParserResolveSample يوضح كيفية تحليل واجهة مع مراجع خارجية، وحل التبعيات باستخدام Azure.IoT.ModelsRepository العميل.
  • DTDLParserJSInteropSample يوضح كيفية استخدام محلل DTDL من JavaScript الذي يعمل في المتصفح، باستخدام .NET JSInterop.

يتضمن مستودع DTDLParser ل .NET أيضا مجموعة من البرامج التعليمية التي توضح لك كيفية استخدام المحلل للتحقق من صحة النماذج وفحصها.

الخطوات التالية

تمكن واجهة برمجة تطبيقات محلل النموذج التي تمت مراجعتها في هذه المقالة العديد من السيناريوهات من أتمتة المهام التي تعتمد على نماذج DTDL أو التحقق من صحتها. على سبيل المثال، يمكنك إنشاء واجهة مستخدم ديناميكيا من المعلومات الموجودة في النموذج.