تحرير قالب الجهاز
يتضمن قالب الجهاز نموذجا يصف كيفية تفاعل الجهاز مع IoT Central. يحدد هذا النموذج إمكانيات الجهاز وكيفية تفاعل IoT Central معهم. يمكن للأجهزة إرسال قيم القياس عن بعد والخصائص إلى IoT Central، ويمكن ل IoT Central إرسال تحديثات الخصائص والأوامر إلى جهاز. يستخدم IoT Central أيضا النموذج لتحديد التفاعلات مع ميزات IoT Central مثل الوظائف والقواعد والصادرات.
قد تؤثر التغييرات التي يتم إدخالها على النموذج في قالب الجهاز على التطبيق بأكمله، بما في ذلك أي أجهزة متصلة. قد تؤدي التغييرات التي يتم إجراؤها على إمكانية تستخدمها القواعد أو عمليات التصدير أو مجموعات الأجهزة أو الوظائف إلى سلوكها بشكل غير متوقع أو عدم عملها على الإطلاق. على سبيل المثال، إذا أزلت تعريف بيانات تتبع الاستخدام من قالب:
- لم يعد IoT Central قادرا على شرح هذه القيمة. يعرض IoT Central بيانات الجهاز التي لا يمكنه تفسيرها على أنها بيانات غير محذودة على صفحة البيانات الأولية للجهاز.
- لم يعد IoT Central يتضمن القيمة في أية تصديرات للبيانات.
لمساعدتك على تجنب أي عواقب غير مقصودة من تحرير قالب جهاز، تتضمن هذه المقالة توصيات استنادا إلى مرحلة دورة حياة التطوير الحالية. بشكل عام، كلما كنت في وقت سابق في دورة حياة التطوير، كلما كنت أكثر تسامحا مع تغييرات قالب الجهاز.
لمعرفة المزيد حول قوالب الأجهزة وكيفية إنشاء قالب، راجع ما هي قوالب الأجهزة؟ وإعداد قالب جهاز.
لمعرفة كيفية إدارة قوالب الأجهزة باستخدام واجهة برمجة تطبيقات REST ل IoT Central، راجع كيفية استخدام واجهة برمجة تطبيقات REST ل IoT Central لإدارة قوالب الأجهزة.
إنشاء قالب لجهاز
التغييرات المضافة، مثل إضافة إمكانية أو واجهة إلى نموذج هي تغييرات غير منكسرة. يمكنك إجراء تغييرات إضافية على النموذج في أي مرحلة من مراحل دورة حياة التطوير.
تتضمن التغييرات القاطعة إزالة أجزاء من النموذج أو تغيير اسم الإمكانية أو نوع المخطط. قد تتسبب هذه التغييرات في عرض رسائل الخطأ والتوقف عن العمل في ميزات التطبيق مثل القواعد أو التصديرات أو لوحات المعلومات.
في مراحل تطوير الجهاز المبكرة، بينما لا تزال تصمم النموذج وتجري اختباره، هناك تغافل أكبر لإجراء تغييرات مباشرة على نموذج جهازك. قبل توصيل أجهزة الإنتاج بقالب الجهاز، يمكنك تحرير قالب الجهاز مباشرة. يطبق IoT Central هذه التغييرات تلقائيا على الأجهزة عند نشر قالب الجهاز.
بعد إرفاق أجهزة الإنتاج بقالب جهاز، قيّم تأثير أي تغييرات قبل تحرير قالب جهاز. يجب عدم إجراء تغييرات فاصلة على قالب جهاز في الإنتاج. لإجراء مثل هذه التغييرات، أنشئ إصدار جديد من قالب الجهاز. اختبر قالب الجهاز الجديد ثم رحل أجهزة الإنتاج إلى القالب الجديد في وقت توقف مجدول.
تحديث قالب جهاز IoT Edge
بالنسبة لجهاز IoT Edge، يجمع النموذج القدرات حسب الوحدات النمطية التي تتوافق مع وحدات IoT Edge التي تعمل على الجهاز. بيان النشر هو مستند JSON منفصل يخبر جهاز 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 Central، حدد عرض الهوية في محرر قالب الجهاز:
إصدار قالب جهاز
لإصدار قالب الجهاز:
- انتقل إلى صفحة قوالب الجهاز.
- حدد قالب الجهاز الذي تريد إصداره.
- حدد Version في أعلى الصفحة وامنح القالب اسما جديدا. يقترح IoT Central اسما جديدا يمكنك تحريره.
- حدد إنشاء.
الآن قمت بإنشاء قالب جديد بمعرف فريد غير متصل بأي أجهزة موجودة.
إصدار الواجهة
لإصدار الواجهة:
- انتقل إلى صفحة قوالب الجهاز.
- عين قالب الجهاز الذي لديك في وضع المسودة.
- حدد الواجهة المنشورة التي ترغب في إصدارها وتحريرها.
- حدد Version في أعلى صفحة الواجهة.
- حدد إنشاء.
الآن أنشأت واجهة جديدة بمعرف فريد من نوعه ليست متزامنة مع إصدار الواجهة السابقة.
ترحيل جهاز من خلال الإصدارات
بإمكانك إنشاء إصدارات متعددة من قالب الجهاز. مع مرور الوقت، سيكون لديك العديد من الأجهزة المتصلة باستخدام قوالب الأجهزة تلك. بإمكانك ترحيل الأجهزة من إصدار واحد من قالب الجهاز إلى إصدار آخر. توضح الخطوات التالية كيفية ترحيل الجهاز:
انتقل إلى صفحة الأجهزة .
حدد الجهاز الذي تريد ترحيله إلى إصدار آخر.
اختر ترحيل:
حدد قالب الجهاز الذي يحتوي على الإصدار الذي تريد ترحيل الجهاز إليه وحدد ترحيل.
تلميح
يمكنك استخدام مهمة لترحيل جميع الأجهزة في مجموعة أجهزة إلى قالب جهاز جديد في نفس الوقت.