تحرير قالب جهاز موجود

  • مقالة
  • قراءة خلال 5 دقائق

تنطبق هذه المقالة على منشئي الحلول ومطوري الأجهزة.

يتضمن قالب الجهاز نموذجا يصف كيفية تفاعل الجهاز مع IoT Central. يحدد هذا النموذج إمكانيات الجهاز وكيفية تفاعل IoT Central معهم. يمكن للأجهزة إرسال القياس عن بعد وقيم الخصائص إلى IoT Central ، ويمكن ل IoT Central إرسال تحديثات الخصائص والأوامر إلى الجهاز. يستخدم IoT Central أيضا النموذج لتحديد التفاعلات مع ميزات IoT Central مثل الوظائف والقواعد والصادرات.

قد تؤثر التغييرات التي يتم إدخالها على النموذج في قالب الجهاز على التطبيق بأكمله، بما في ذلك أي أجهزة متصلة. قد تؤدي التغييرات التي يتم إدخالها على إمكانية مستخدمة من جانب القواعد أو التصدير أو مجموعات الأجهزة أو الوظائف إلى سلوكها بشكل غير متوقع أو عدم عملها على الإطلاق. على سبيل المثال، إذا أزلت تعريف بيانات تتبع الاستخدام من قالب:

  • لم يعد IoT Central قادرا على شرح هذه القيمة. يعرض IoT Central بيانات الجهاز التي لا يمكنه تفسيرها على أنها بيانات غير نموذجية على صفحة بيانات Raw الخاصة بالجهاز.
  • لم يعد IoT Central يتضمن القيمة في أية تصديرات للبيانات.

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

لمعرفة المزيد حول قوالب الأجهزة وكيفية إنشائها، راجع ما هي قوالب الأجهزة؟وإعداد قالب جهاز.

إنشاء قالب لجهاز

تعتبر التغييرات الإضافية، مثل إضافة إمكانية أو واجهة إلى نموذج، تغييرات بدون تعطل العمل. يمكنك إجراء تغييرات إضافية على النموذج في أي مرحلة من مراحل دورة حياة التطوير.

تتضمن التغييرات القاطعة إزالة أجزاء من النموذج أو تغيير اسم الإمكانية أو نوع المخطط. قد تتسبب هذه التغييرات في عرض رسائل الخطأ والتوقف عن العمل في ميزات التطبيق مثل القواعد أو التصديرات أو لوحات المعلومات.

في مراحل تطوير الجهاز المبكرة، بينما لا تزال تصمم النموذج وتجري اختباره، هناك تغافل أكبر لإجراء تغييرات مباشرة على نموذج جهازك. قبل توصيل أجهزة الإنتاج بقالب الجهاز، يمكنك تحرير قالب الجهاز مباشرة. يطبق IoT Central هذه التغييرات تلقائيا على الأجهزة عند نشر قالب الجهاز.

بعد إرفاق أجهزة الإنتاج بقالب جهاز، قيّم تأثير أي تغييرات قبل تحرير قالب جهاز. يجب ألا تجري تغييرات جذرية على قالب جهاز قيد الإنتاج. لإجراء مثل هذه التغييرات، أنشئ إصدار جديد من قالب الجهاز. اختبر قالب الجهاز الجديد ثم رحل أجهزة الإنتاج إلى القالب الجديد في وقت توقف مجدول.

تحديث قالب جهاز IoT Edge

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

لمعرفة المزيد، راجع بيانات نشر IoT Edge وقوالب أجهزة IoT Central.

تحرير الإجراءات ونشرها

الإجراءات التالية مفيدة عند تحرير قالب الجهاز:

  • حفظ. عند تغيير جزء من قالب الجهاز، يؤدي حفظ التغييرات إلى إنشاء مسودة بإمكانك الرجوع إليها. لا تؤثر هذه التغييرات حتى الآن على الأجهزة المتصلة. لن تحفظ التغييرات على أي أجهزة تم إنشاؤها من هذا القالب حتى تنشرها.
  • ⁧⁩النشر⁧⁩. عند نشر قالب الجهاز، فإنه يطبق أية تغييرات حفظت على مثيلات الجهاز الموجودة. تستخدم مثيلات الجهاز التي أنشئت حديثا أحدث قالب منشور بشكل دائم.
  • إصدار قالب. عند إصدار قالب الجهاز، فإنه ينشئ قالبا جديدا مع كافة التغييرات المحفوظة الأخيرة. لا تتأثر مثيلات الأجهزة الموجودة بالتغييرات التي أجريت على إصدار جديد. لمعرفة المزيد، راجع إصدار قالب جهاز.
  • إصدار واجهة. عند إصدارك للواجهة، فإنها تنشئ واجهة جديدة مع كافة أحدث الإمكانات المحفوظة. يمكنك إعادة استخدام الواجهة في مواقع متعددة داخل قالب. لهذا السبب تم إجراء تغيير على مرجع واحد إلى واجهة تغيير كافة الأماكن في القالب الذي يستخدم الواجهة. عند إصدار واجهة، يتغير هذا السلوك لأن الإصدار الجديد الآن يعتبر واجهة منفصلة. لمعرفة المزيد، راجع إصدار واجهة.
  • ترحيل جهاز. عند ترحيل جهاز، يتبادل مثيل الجهاز من قالب جهاز إلى آخر. يمكن أن يترتب على ترحيل الجهاز إلى حدوث فترة قصيرة أثناء معالجة IoT Central للتغييرات. لمعرفة المزيد، راجع ترحيل جهاز عبر الإصدارات.

رقم الإصدار

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

يعرض المقتطف التالي طراز الجهاز لجهاز ترموستات. يحتوي طراز الجهاز على واجهة واحدة. يمكنك رؤية رقم الإصدار ، 1في نهاية الحقل@id .

{
  "@context": "dtmi:dtdl:context;2",
  "@id": "dtmi:com:example:Thermostat;1",
  "@type": "Interface",
  "displayName": "Thermostat",
  "description": "Reports current temperature and provides desired temperature control.",
  "contents": [
    // ...
  ]
}

لعرض هذه المعلومات في واجهة مستخدم IoT المركزية، حدد عرض الهوية في محرر قوالب الجهاز:

View the identity of an interface to see the version number

إصدار قالب جهاز

لإصدار قالب الجهاز:

  1. انتقل إلى صفحة قوالب الأجهزة .
  2. حدد قالب الجهاز الذي تريد إصداره.
  3. حدد الإصدار في أعلى الصفحة وامنح القالب اسما جديدا. يقترح IoT Central اسما جديدا يمكنك تحريره.
  4. حدد "Create".

الآن قمت بإنشاء قالب جديد بمعرف فريد غير متصل بأي أجهزة موجودة.

إصدار الواجهة

لإصدار الواجهة:

  1. انتقل إلى صفحة قوالب الأجهزة .
  2. عين قالب الجهاز الذي لديك في وضع المسودة.
  3. حدد الواجهة المنشورة التي ترغب في إصدارها وتحريرها.
  4. حدد الإصدار في أعلى صفحة الواجهة.
  5. حدد "Create".

الآن أنشأت واجهة جديدة بمعرف فريد من نوعه ليست متزامنة مع إصدار الواجهة السابقة.

ترحيل جهاز من خلال الإصدارات

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

  1. انتقل إلى صفحة الأجهزة .

  2. حدد الجهاز الذي تريد ترحيله إلى إصدار آخر.

  3. اختر ترحيل:

    Choose the option to start migrating a device

  4. حدد قالب الجهاز بالإصدار الذي تريد ترحيل الجهاز إليه وحدد ترحيل.

تلميح

يمكنك استخدام مهمة لترحيل جميع الأجهزة في مجموعة أجهزة إلى قالب جهاز جديد في نفس الوقت.

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

إذا كنت مشغلا أو منشئ حلول، فإن الخطوة التالية المقترحة هي معرفة كيفية إدارة أجهزتك.

إذا كنت مطور أجهزة، فإن الخطوة التالية المقترحة هي القراءة عن أجهزة Azure IoT Edge وAzure IoT Central.