رسم أخطاء التحويل والتحذيرات

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

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

التحذيرات العامة

geometryWarning

وصف geometryWarning

يحدث الـgeometryWarningعندما يحتوي الرسم على كيان غير صالح. الكيان الغير صالح هو كيان لا يتوافق مع القيود الهندسية. أمثلة على كيان غير صالح هي مضلع يتقاطع ذاتيا أو PolyLine مفتوح في طبقة تدعم الهندسة المغلقة فقط.

خدمة التحويل لا يمكنها إنشاء ميزة خريطة من كيان غير صالح وبدلا من ذلك تتجاهلها.

أمثلة geometryWarning

  • تعرض الصورتان التاليتان أمثلة على المضلعات المتقاطعة ذاتيا.

    Example of a self-intersecting polygon, example one.

    Example of a self-intersecting polygon, example two.

  • تظهر الصورة التالية PolyLine مفتوحة. افترض أن الطبقة تقوم بدعم الهندسة المغلقة فقط.

    Example of an open PolyLine

طريقة تصحيح التحريك الهندسي

فحصgeometryWarningلكل كيان للتحقق من أنه يتبع قيود هندسية.

unexpectedGeometryInLayer

وصف لـ unexpectedGeometryInLayer

يحدث تحذيرغير متوقع لـ unexpectedGeometryInLayer عندما يحتوي الرسم على هندسة غير متوافقة مع نوع الهندسة المتوقع لطبقة معينة. عندما تقوم خدمة التحويل بإرجاع تحذير غير متوقع لGeometryInLayer ، فإنها تتجاهل تلك الهندسة.

مثال على unexpectedGeometryInLayer

تظهر الصورة التالية PolyLine مفتوحة. افترض أن الطبقة تقوم بدعم الهندسة المغلقة فقط.

Example of an open PolyLine

طريقة تصحيح غير unexpectedGeometryInLayer

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

unsupportedFeatureRepresentation

وصف لـ unsupportedFeatureRepresentation

يحدث unsupportedFeatureRepresentation عندما يحتوي الرسم على نوع كيان غير معتمد.

مثال على unsupportedFeatureRepresentation

تظهر الصورة التالية نوع كيان غير معتمد ككائن نص متعدد الأسطر على طبقة تسمية.

Example of a multi-line text object on label layer

طريقة تصحيح unsupportedFeatureRepresentation

تأكد من احتواء ملفات DWG على أنواع الكيانات المدعومة فقط. يتم سرد الأنواع المدعومة ضمن قسم متطلبات ملفات الرسم في مقالة متطلبات حزمة الرسم.

automaticRepairPerformed

وصف automaticRepairPerformed

يحدث تحذير automaticRepairPerformed عندما تقوم خدمة التحويل تلقائيا بتصحيح هندسة غير صالحة.

أمثلة لـ automaticRepairPerformed

  • توضح الصورة التالية طريقة تصحيح خدمة التحويل لمضلع ذاتي التقاطع إلى هندسة صالحة.

    Example of a self-intersecting polygon repaired

  • تظهر الصورة التالية خدمة التحويل تقطع الذروة الأولى والأخيرة من PolyLine مفتوح لإنشاء PolyLine مغلق، حيث كانت الذروة الأولى والأخيرة أقل من 1 مم.

    Example of a snapped PolyLine

  • توضح الصورة التالية كيفية إصلاح خدمة التحويل متعددة الخطوط المفتوحة في طبقة تدعم PolyLines المغلقة فقط. لتجنب تجاهل PolyLines المفتوحة، جمعتها الخدمة في PolyLine واحد مغلق.

    Example of open Polylines combined into a single closed PolyLine

طريقة تصحيح automaticRepairPerformed

لتصحيح تحذيرautomaticRepairPerformed، اتخذ الإجراءات الآتية:

  1. فحص هندسة كل تحذير ونص التحذير المحدد.
  2. حدد ما إذا كان التصحيح الآلي صحيحًا.
  3. إذا كان التصحيح صحيحًا، فقم بمتابعة. وإلا، فانتقل إلى ملف التصميم وقم بحل التحذير يدويا.

تلميح

لمنع تحذير في المستقبل، قم بإجراء تغييرات على الرسم الأصلي بحيث يطابق الرسم الأصلي الرسم الذي تم تصحيحه.

تحذيرات بيان التطبيق

redundantAttribution

وصف redundantAttribution

يحدث تحذير redundantAttribution عندما يحتوي البيان على خصائص عنصر زائدة عن الحاجة أو متعارضة.

أمثلة لـ redundantAttribution

  • يحتوي مثال JSON التالي على كائنين أو أكثر unitProperties بنفس name.

    "unitProperties": [
        {
            "unitName": "L1-100",
            "categoryName": "room.office"
        },
        {
            "unitName": "L1-101",
            "categoryName": "room.office"
        },
        {
            "unitName": "L1-101",
            "categoryName": "room.office"
        }
    ]
    
  • في القصاصة البرمجية JSON التالية، يكون لكائنين أو أكثر zoneProperties نفس name.

     "zoneProperties": [
        {
            "zoneName": "Assembly Area 1",
            "categoryName": "zone.assembly"
        },
        {
            "zoneName": "Assembly Area 2",
            "categoryName": "zone.assembly"
        },
        {
            "zoneName": "Assembly Area 2",
            "categoryName": "zone.assembly"
        }
    

طريقة تصحيح redundantAttribution

لتصحيح التحذير *redundantAttribution، قم بإزالة خصائص الكائن المكررة أو المتعارضة.

manifestWarning

وصف ال manifestWarning

يحدث manifestWarningعند احتواء البيان على عناصر unitProperties أو zoneProperties غير المستخدمة أثناء التحويل.

أمثلة لـ manifestWarning

  • يحتوي البيان علىunitPropertiesعنصر معunitNameالذي لا يحتوي على تسمية مطابقة في طبقةunitLabel.

  • يحتوي البيان علىzonePropertiesعنصر معzoneNameالذي لا يحتوي على تسمية مطابقة في طبقةzoneLabel.

طريقة تصحيح manifestWarning

لتصحيحmanifestWarning، قم بإزالة العنصر أوunitPropertiesالغير مستخدم zoneProperties من البيان، أو أضف تسمية وحدة/ منطقة إلى الرسم بحيث يتم استخدام عنصر الخصائص أثناء التحويل.

التحذيرات المتعلقة بالجدار

wallOutsideLevel

وصف الـ wallOutsideLevel

يحدث تحذيرwallOutsideLevel عندم احتواء الرسم على هندسة جدار خارج حدود مخطط تفصيلي للمستوى.

المثال على wallOutsideLevel

  • تظهر الصورة التالية جدارا داخليا، باللون الأحمر، خارج حدود المستوى الأصفر.

    Example of interior wall outside the level boundary

  • تُظهر الصورة الآتية جدارًا خارجيًا باللون الأحمر خارج حدود المستوى الأصفر.

    Example of exterior wall outside the level boundary

طريقة تصحيح wallOutsideLevel

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

التحذيرات المتعلقة بالوحدة

unitOutsideLevel

وصف لـ unitOutsideLevel

يحدث التحذيرwallOutsideLevel عند احتواء الرسم على هندسة جدار خارج حدود مخطط تفصيلي للمستوى.

مثال على الـ unitOutsideLevel

في الصورة الآتية، تتجاوز هندسة الوحدة، باللون الأحمر، حدود المستوى الأصفر.

Example of unit exceeding the level boundary

طريقة تصحيح unitOutsideLevel

لتصحيح التحذيرunitOutsideLevel، قم بتوسيع حد المستوى ليشمل جميع الوحدات. أو عدل هندسة الوحدة لتلائم حدود المستوى.

partiallyOverlappingUnit

وصف partiallyOverlappingUnit

يحدث التحذيرpartiallyOverlappingUnitعندما يحتوي الرسم على هندسة وحدة متداخلة جزئيا على هندسة وحدة أخرى. تقوم خدمة التحويل بتجاهل الوحدات المتداخلة.

مثال على السيناريوهات partiallyOverlappingUnit

في الصورة الآتية، يتم تمييز الوحدة المتراكبة باللون الأحمر. UNIT110وHALLWAYيتم تجاهلها.

Example of overlapping units

طريقة تصحيح partiallyOverlappingUnit

لتصحيح التحذيرpartiallyOverlappingUnit، أعد رسم كل وحدة متداخلة جزئيا بحيث لا تتداخل مع أي وحدات أخرى.

التحذيرات المعلقة بالباب

doorOutsideLevel

وصف الـ doorOutsideLevel

يحدث التحذيرdoorOutsideLevel عند احتواء الرسم على هندسة جدار خارج حدود مخطط تفصيلي للمستوى.

مثال على الـ doorOutsideLevel

في الصورة الآتية، تتداخل هندسة الباب، المميزة باللون الأحمر، مع حد المستوى الأصفر.

Example of a door overlapping a level boundary

طريقة تصحيح doorOutsideLevel

لتصحيح التحذيرdoorOutsideLevel، أعد رسم هندسة الباب بحيث تكون داخل حدود المستوى.

التحذيرات المتعلقة بالمنطقة

zoneWarning

وصف zoneWarning

تحدث zoneWarningعندما لا تحتوي المنطقة على تسمية. تتجاهل خدمة التحويل منطقة ليست مصنفة

مثال على الـ zoneWarning

تعرض الصورة الآتية منطقة لا تحتوي على تسمية.

Example of a zone doesn't contain a label

طريقة تصحيح zoneWarning

لتصحيح الـzoneWarning، تحقق من أن كل منطقة تحتوي على تسمية واحدة.

التحذيرات المتعلقة بالتسمية

labelWarning

وصف الـ labelWarning

يحدث الـlabelWarningعندما يحتوي الرسم على ميزة تسميات غامضة أو متناقضة.

يحدث الـlabelWarning بسبب سبب واحد أو أكثر من الأسباب الآتية:

  • تسمية الوحدة ليست في أي وحدات.
  • تسمية المنطقة غير موجودة في أية مناطق.
  • توجد تسمية المنطقة في منطقتين أو أكثر.

مثال على الـ labelWarning

تعرض الصورة التالية التسمية داخل منطقتين.

Example of a label inside two zones

طريقة تصحيح labelWarning

لتصحيح الـlabelWarning، تأكد من:

  • كافة تسميات الوحدات داخل الوحدات.
  • كافة تسميات المنطقة داخل المناطق.
  • كافة تسميات المنطقة في منطقة واحدة فقط.

أخطاء حزمة الرسم

invalidArchiveFormat

وصف invalidArchiveFormat

يحدث الخطأinvalidArchiveFormatعندما تكون حزمة الرسم بتنسيق أرشيف غير صحيح مثل GZIP أو 7-Zip. يتم دعم تنسيق أرشيف ZIP فقط.

يحدث خطأ التنسيق الأرشفي غير صالح أيضا إذا كان أرشيف ZIP فارغا.

طريقة تصحيح invalidArchiveFormat

لتصحيح الخطأinvalidArchiveFormat، تحقق مما يلي:

  • ينتهي اسم ملف الأرشيف الخاص بك في.zip.
  • يحتوي أرشيف ZIP على بيانات.
  • يمكن فتح أرشيف ZIP الخاص بك.

invalidUserData

وصف invalidUserData

يحدث الخطأinvalidUserDataعندما تكون خدمة التحويل غير قادرة على قراءة كائن بيانات مستخدم من التخزين.

مثال على سيناريو invalidUserData

لقد حاولت تحميل حزمة رسم باستخدام معلمة غير صحيحة udid .

طريقة تصحيح invalidUserData

لتصحيح الخطأinvalidUserData، تحقق مما يلي:

  • لقد قدمت تصحيحاudidللحزمة المحملة.
  • تم تمكين خرائط Azure Creator لحساب خرائط Azure الذي استخدمته لتحميل حزمة الرسم.
  • يحتوي طلب واجهة برمجة التطبيقات إلى خدمة التحويل على مفتاح الاشتراك في حساب خرائط Azure الذي استخدمته لتحميل حزمة الرسم.

dwgError

وصف الـ dwgError

dwgErrorعندما تحتوي حزمة الرسم على مشكلة في ملف DWG واحد أو أكثر في أرشيف ZIP المحمل.

يحدثdwgErrorعند احتواء حزمة الرسم على ملف DWG لا يمكن فتحه لأنه غير صالح أو تالف.

  • ملف DWG ليس رسم تنسيق للملف AutoCAD DWG صالحًا.
  • ملف DWG غير صالح.
  • يسرد ملف DWG في ملفmanifest.json، ولكنه مفقود من أرشيف ZIP.

طريقة تصحيح dwgError

لتصحيحdwgError، قم بفحص الملفmanifest.jsonوتأكد من ما يلي:

  • كافة ملفات DWG في أرشيف ZIP هي رسومات صالحة بتنسيق AutoCAD DWG، افتح كل ملف في AutoCAD. إزالة أو تصحيح جميع الرسومات غير الصالحة.
  • تتطابق قائمة ملفات DWG فيmanifest.json ملفات DWG في أرشيف ZIP.

أخطاء بيان التجميع

invalidJsonFormat

وصف invalidJsonFormat

يحدث الخطأinvalidJsonFormatعندما لا يمكن قراءة ملف manifest.json.

ليس من الممكن قراءة _manifest.json_file بسبب أخطاء في تنسيق JSON أو بناء الجملة. لمعرفة المزيد حول كيفية تنسيق JSON وبناء الجملة، راجع تنسيق تبادل البيانات JavaScript Object Notation (JSON).

طريقة تصحيح invalidJsonFormat

لتصحيح الخطأ invalidJsonFormat، استخدم أداة تحليل JSON للكشف عن أي أخطاء JSON وحلها.

missingRequiredField

وصف الـ missingRequiredField

يحدث الخطأmissingRequiredFieldعندما يفتقد ملف manifest.json إلى البيانات المطلوبة.

طريقة تصحيح missingRequiredField

لتصحيح الخطأmissingRequiredField، تحقق من أن البيان يحتوي على كافة الخصائص المطلوبة. للحصول على قائمة كاملة بكائن البيان المطلوب، راجع قسم البيان في متطلبات حزمة الرسم.

missingManifest

وصف missingManifest

يحدث الخطأmissingManifestعندما يكون ملفmanifest.jsonمفقودا من أرشيف ZIP.

يحدث الخطأmissingManifestبسبب واحد أو أكثر من الأسباب التالية:

  • ملفmanifest.jsonيوجد به خطأ إملائي.
  • الـmanifest.jsonمفقود.
  • لا يوجدmanifest.jsonداخل الدليل الجذر للأرشيف ZIP.

طريقة تصحيح missingManifest

لتصحيح الخطأmissingManifest، تأكد من أن الأرشيف يحتوي على ملف يسمىmanifest.jsonعلى المستوى الجذر لأرشيف ZIP.

conflict

وصف الـ conflict

يحدث الخطأ conflict عندما يحتوي ملف manifest.json على معلومات متعارضة.

مثال على سيناريو conflict

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

"buildingLevels":
{
    "levels": [
        {
            "levelName": "Ground",
            "ordinal": 0,
            "filename": "./Level_0.dwg"
        },
        {
            "levelName": "Parking",
            "ordinal": 0,
            "filename": "./Level_P.dwg"
        }
    ]
}

طريقة تصحيح conflict

لتصحيح الخطأconflict، افحص manifest.json وأزل أي معلومات متعارضة.

invalidGeoreference

وصف الـ invalidGeoreference

يحدث الخطأinvalidGeoreference عندما يحتوي ملف manifest.json على مرجع جغرافي غير صالح.

يحدث الخطأmissingManifestبسبب واحد أو أكثر من الأسباب الأتية:

  • يرجع المستخدم georeferencing إلى قيمة خط الطول أو خط الطول خارج النطاق.
  • يشير المستخدم georeferencing إلى قيمة دوران خارج النطاق.

مثال لسيناريو invalidGeoreference

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

"georeference"
{
    "lat": 88.0,
    "lon": -122.132600,
    "angle": 0
},

طريقة تصحيح invalidGeoreference

لتصحيح الخطأinvalidGeoreference، تحقق من أن القيم المرجعة جغرافيا ضمن النطاق.

هام

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

أخطاء الجدار

wallErrors

وصف الـ wallError

يحدث الخطأwallErrorعندما يحتوي الرسم على خطأ في أثناء محاولة إنشاء ميزة جدار.

مثال لسيناريو wallError

تعرض الصورة الآتية ميزة جدار لا تتداخل مع أي وحدات.

Example of Wall feature that doesn't overlap any units

طريقة تصحيح wallError

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

الأخطاء المتعلقة بالاختراق العمودي

verticalPenetrationError

Description for verticalPenetrationError

يحدثverticalPenetrationErrorعند احتواء الرسم على ميزة اختراق عمودي غامضة.

يحدثverticalPenetrationErrorبسبب واحد أو أكثر من الأسباب التالية:

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

مثال سيناريو لـ verticalPenetrationError

تظهر الصورة التالية منطقة اختراق عمودي مع عدم وجود مناطق اختراق عمودي متداخلة على المستويات أعلىها أو أسفلها.

Example of a vertical penetration 1

تُظهر الصورة الآنية منطقة اختراق رأسية تتداخل مع أكثر من منطقة اختراق رأسية على مستوى مجاور.

Example of a vertical penetration 2

طريقة تصحيح verticalPenetrationError

لتصحيح الخطأverticalPenetrationError، اقرأ بشأن طريقة استخدام ميزة اختراق عمودي في مقالةمتطلبات حزمة الرسم.

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