تحرير قالب جهاز

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

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

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

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

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

لمعرفة كيفية إدارة قوالب الأجهزة باستخدام واجهة برمجة تطبيقات IoT Central REST، راجع كيفية استخدام واجهة برمجة تطبيقات IoT Central REST لإدارة قوالب الأجهزة.

تعديل قالب جهاز

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

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

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

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

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

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

1. انتقل إلى عقدة الوحدات النمطية في قالب الجهاز.
2. في صفحة ملخص الوحدات النمطية ، حدد استيراد الوحدات النمطية من البيان.
3. حدد بيان التوزيع المناسب وحدد استيراد.

لمعرفة المزيد، راجع أجهزة 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، حدد تحرير الهوية في محرر قالب الجهاز:

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

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

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

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

إصدار واجهة

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

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

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

ترحيل جهاز عبر الإصدارات

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

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

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

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

   

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

تلميح

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