دليل استكشاف الأخطاء وإصلاحها لـ IoT لتحديث الجهاز لاستيراد تحديثات الوكيل
يوفر هذا المستند خطوات استكشاف الأخطاء وإصلاحها وجدول رسائل الخطأ التي قد تواجهها عند استيراد تحديثات الوكيل إلى Device Update لـ IoT Hub.
رسائل خطأ
| رسالة الخطأ | كيفية استكشاف الأخطاء وإصلاحها |
|---|---|
| لم يتم العثور على بيان استيراد في هذا التحميل. ملحق الملف لبيانات الاستيراد هو importmanifest.json | يلزم بيان استيراد واحد على الأقل ليتم استيراد أي تحديث إلى Device Update لـ IoT Hub. قد يحتوي تحديث الخادم الوكيل على كلٍ من بيان استيراد أصلي وأيضاً عدد من بيانات الاستيراد الفرعية المُشار إليها من الأصل. أحد الأسباب المحتملة لهذا الخطأ هو أن لديك بيان (بيانات) استيراد صالح ولكن ليس لديهم الملحق .importmanifest.json في نهاية اسم الملف. هذا الملحق مطلوب لكي يتم التعرف على بيانات الاستيراد من خلال عملية الاستيراد في مدخل Microsoft Azure. إذا كان الملحق صحيحاً، فيجب عليك مراجعة schema كل بيان استيراد في التحديث الخاص بك للتعرف على أي مشكلات. تعرف على المزيد حول استيراد البيانات. |
| يفتقد هذا التحميل إلى البيان الرئيسي المطلوب. ملحق الملف لبيانات الاستيراد هو importmanifest.json | قد يحتوي تحديث الخادم الوكيل على بيان استيراد أصلي وأيضاً عدد من بيانات الاستيراد الفرعية المُشار إليها من الأصل. يجب تضمين البيان الرئيسي عند استيراد أي تحديثات فرعية، لأنه يحتوي على المعلومات المطلوبة حول هذه التحديثات التابعة. أحد الأسباب المحتملة لهذا الخطأ هو أن لديك بيان استيراد رئيسياً صالحاً ولكن لا يحتوي على الملحق importmanifest.json في نهاية اسم الملف. هذا الملحق مطلوب لكي يتم التعرف على بيانات الاستيراد من خلال عملية الاستيراد في مدخل Microsoft Azure. إذا كان الملحق صحيحاً، فيجب مراجعة مخطط بيان الاستيراد الأصلي للتعرف على أي مشكلات. تعرف على المزيد حول استيراد البيانات. |
| يحتوي هذا التحميل على [n] بيانات رئيسية. واحد فقط مسموح به. احذف البيانات التي لا تريد استخدامها وحاول التحميل مرة أخرى. | قد يحتوي تحديث الخادم الوكيل على بيان استيراد أصلي وأيضاً عدد من بيانات الاستيراد الفرعية المُشار إليها من الأصل. يمكن تضمين بيان رئيسي واحد فقط لتحديث معين، على الرغم من إمكانية وجود أي عدد من بيانات الاستيراد الفرعية. إذا رأيت هذا الخطأ مع قائمة بملفات بيان الاستيراد، فإن كلاً من هذه الملفات يحتوي على معلومات تشير إلى أنه بيان استيراد رئيسي. لمعالجة هذه المشكلة، حدد أولاً بيان الاستيراد الأصلي الذي يطابق التحديث الذي تستورده، ثم قم بإزالة أي بيان آخر بحيث يكون هناك بيان استيراد رئيسي واحد فقط. تعرف على المزيد حول استيراد البيانات. |
| يفتقد التحميل إلى واحد أو أكثر من البيانات التابعة المدرجة في الأصل ('parentimportfile.importmanifest.json'). إضافة البيانات الفرعية المطلوبة لمعرفات التحديث هذه | قد يحتوي تحديث الوكيل على بيان استيراد أصلي وأيضاً عدد من بيانات الاستيراد الفرعية. يتضمن بيان الاستيراد الأصلي مراجع لجميع بيانات الاستيراد الفرعية في التحديث الخاص بك. إذا رأيت هذا الخطأ، فإن بيان الاستيراد الرئيسي يشير إلى بيان استيراد فرعي لكل من معرّفات التحديث المدرجة، ولكن بيان (بيانات) الاستيراد الفرعي هذا ليس جزءاً من التحديث. لمعالجة هذه المشكلة، ستحتاج إلى إضافة كل من بيانات الاستيراد الفرعية هذه إلى التحديث الخاص بك، أو إزالة المراجع في بيان الاستيراد الأصلي. تعرف على المزيد حول استيراد البيانات. |
| يحتوي التحميل على ملف (ملفات) بيان تابع ('childmanifest.importmanifest.json') غير مدرجة في الأصل. احذفه وحاول مرة أخرى. | قد يحتوي تحديث الوكيل على بيان استيراد أصلي وأيضاً عدد من بيانات الاستيراد الفرعية. يتضمن بيان الاستيراد الأصلي مراجع لجميع بيانات الاستيراد الفرعية في التحديث الخاص بك. إذا رأيت هذا الخطأ، فإن كل بيان مدرج هو بيان استيراد فرعي موجود في التحديث ولكن لم تتم الإشارة إليه في بيان الاستيراد الأصلي. لمعالجة هذه المشكلة، ستحتاج إلى إزالة قوائم الاستيراد الفرعية هذه. أو يمكنك إضافة مراجع إليها في بيان الاستيراد الأصلي. تعرف على المزيد حول استيراد البيانات. |
| بعض ملفات التحديث المطلوبة كانت مفقودة. قم بتضمينهم، وحاول التحميل مرة أخرى. | قد يحتوي تحديث الوكيل على عدة بيانات استيراد، يشير كل منها إلى ملفات تحديث متعددة. إذا لم يتم تضمين أي من الملفات المشار إليها عند استيراد التحديث الخاص بك، فسترى هذا الخطأ. لمعالجة هذه المشكلة، ستحتاج إلى إضافة الملفات المفقودة، أو إزالة الإشارات إلى تلك الملفات من بيان الاستيراد الذي يتضمنها. تعرف على المزيد حول استيراد البيانات. |
| يحتوي التحميل على ملف واحد أو أكثر غير مدرج في البيان. احذف الملفات الإضافية وحاول التحميل مرة أخرى. | قد يحتوي تحديث الوكيل على عدة بيانات استيراد، يشير كل منها إلى ملفات تحديث متعددة. سترى هذا الخطأ إذا حاولت استيراد أي ملفات تحديث لم تتم الإشارة إليها في بيان الاستيراد. لمعالجة هذه المشكلة، قم بإزالة الملفات المدرجة في رسالة الخطأ. أو أضف مرجعاً لكل ملف إلى أحد قوائم الاستيراد الخاصة بك. تعرف على المزيد حول استيراد البيانات. |
| تحميل يحتوي على أسماء ملفات مكررة. احذف الملفات أو أعد تسميتها بحيث يكون كل اسم فريداً. | يمكن أن يحتوي التحديث على ملفات متعددة، ولكن يجب أن يكون لكل ملف اسم ملف فريد. إذا حاولت استيراد أي ملفات تحديث لها نفس الاسم، فسترى هذا الخطأ. لمعالجة هذه المشكلة، قم بإزالة أو إعادة تسمية الملفات المدرجة في رسالة الخطأ. إذا قمت بإعادة تسمية أي ملفات، فتأكد أيضاً من تغيير المرجع المرتبط لكل ملف في بيان الاستيراد المناسب. تعرف على المزيد حول استيراد البيانات. |
| لم يتم تنسيق بيان استيراد واحد أو أكثر بشكل صحيح. احذف الملف أو اضبط تركيبته وحاول مرة أخرى. | إذا رأيت هذا الخطأ، فهناك مشكلة في كيفية إنشاء بيان (بيانات) الاستيراد. لحل هذه المشكلة، راجع كل بيان استيراد مدرج وتحقق من عدم وجود مشكلات في schema. تعرف على المزيد حول استيراد البيانات. |