آخر الأخبار
رؤية Scope Box في Revit: كيفية التحكم بها في طرق العرض؟معالجة المشاريع ذات النماذج المرتبطة باستخدام Revit Automation APIضبابية الحركة الواقعية في Blender: إعدادات الغالق وسير العملفي Rhino: أمرا Flow وFlowAlongSrf لإسناد الهندسة إلى منحنى أو سطحاستخدام الكاميرا البانورامية في Blender: 360° والواقع الافتراضي وإسقاط القبةالحصول على بيانات السطح والتصادم باستخدام Raycast Node في BlenderAfter Night There Is Nothing: تركيب بثلاث قباب في الشارقةGraphic Override Rules في Archicad 29: دليل إنشاء القواعدتحليل الصور المعمارية باستخدام Gemma 4: الإعداد والتطبيق في Pythonإنشاء حواف مشطوفة ومضبوطة وغير تدميرية باستخدام Bevel Modifier في Blender
دروس تعليميةRevitOMARevit Automation API

معالجة المشاريع ذات النماذج المرتبطة باستخدام Revit Automation API

يشرح هذا الدليل كيفية تحديد ما إذا كانت مشاريع Revit Cloud Worksharing ستُنزل بصيغة ZIP أم كملف RVT واحد، وكيفية تمرير النماذج المرتبطة إلى سير عمل Automation API.

سير عمل BIM سحابي تمثّله كتل مبانٍ مرتبطةصورة بالذكاء الاصطناعي
صورة تعبيرية مولّدة بالذكاء الاصطناعي.الصورة: 3dsınıfı / FCA AI

باختصار

  1. تحقّق من الحقل `isCompositeDesign` لمعرفة ما إذا كان نموذج Revit Cloud Worksharing يتضمن تصميمًا مركّبًا.
  2. إذا كانت قيمة `isCompositeDesign` هي true، فقد يكون التنزيل حزمة ZIP تضم النموذج المضيف وملفات RVT المرتبطة.
  3. بالنسبة إلى الملفات المنشورة في 7 فبراير 2025 أو بعده، يمكن استخدام استدعاء GET linked Revit files لجلب النماذج المرتبطة.
  4. في سير العمل القديم، تُضبط قيمة إدخال ZIP على `zip: true`، ويُحدَّد اسم النموذج المضيف داخل ZIP باستخدام الحقل `pathInZip`.

ما الذي ستتعلمه في هذا الدليل؟

سنستعرض خطوة بخطوة سبب تنزيل ملف منشور عبر Revit Cloud Worksharing أحيانًا بصيغة ZIP بدلًا من ملف RVT واحد، وكيفية تمرير هذا التصميم إلى سير عمل Automation API. ويتمثل الفارق الأساسي في ما إذا كان النموذج تصميمًا مركّبًا؛ إذ قد تتضمن الحزمة ملفات RVT المرتبطة إلى جانب الملف المضيف. لذلك لا يكفي الاعتماد على امتداد الملف وحده عند إعداد مهمة الأتمتة، بل ينبغي أيضًا التحقق من المعلومات الواردة في استجابة API الخاصة بإصدار الملف.

يعتمد الدليل على حقول API وسيري عمل منفصلين موضّحين في وثائق Autodesk Platform Services. والحدّ الفاصل زمنيًا بين الطريقة القديمة والجديدة هو 7 فبراير 2025. لا يهدف هذا الدليل إلى شرح جميع خطوات المصادقة وإعداد التطبيق لاستدعاءات API، بل إلى تفسير معلومات النموذج المتاحة واختيار صيغة الإدخال المناسبة.

المتطلبات

  • احصل على إمكانية الوصول إلى مشروع Revit Cloud Worksharing وإلى Autodesk Platform Services API لقراءة معلومات الملفات. يفحص المثال الوارد في المصادر معلومات المشروع وإصدار الملف عبر استدعاءات API.

  • عند العمل باستخدام Automation API، ضع في الحسبان شروط النسخة التجريبية النشطة من Forge أو الاشتراك المذكورة في المصادر. يحيل المصدر المعني إلى صفحة منفصلة للاطلاع على تفاصيل الأسعار، لكنه لا يورد أسعارًا حديثة هنا.

  • تمكّن من التحقق من تاريخ نشر النموذج والحقلي attributes.extension وattributes.data في استجابة إصدار الملف.

  • لا تفترض أن تثبيت Revit على سطح المكتب شرط لهذا الإجراء: فتوضيح Autodesk بشأن Revit Automation API يشير إلى إمكانية الوصول إلى Revit Database API من دون تثبيت Revit على سطح المكتب. لكن هذا لا يعني الاستغناء عن إمكانية الوصول إلى API أو مدخلات المشروع المطلوبة.

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

خطوة بخطوة: التعرّف على التصميم وإعداد المهمة

  1. تحقّق مما إذا كان الملف يمثّل نموذج Revit Cloud Worksharing. افحص الحقل attributes.extension.type في استجابة استدعاءات API الخاصة بمحتوى المشروع أو عنصر الملف أو الإصدارات. إذا كانت القيمة versions:autodesk.bim360:C4RModel، فهذا يعني، بحسب المصدر، أن الملف نموذج Revit Cloud Worksharing. وهذه الخطوة الأولى لتفسير معلومات التصميم المركّب في سياقها الصحيح.

  2. اقرأ علامة التصميم المركّب. ابحث عن الحقل attributes.data.isCompositeDesign في استجابة الإصدار نفسها. إذا كانت القيمة true، فهذا يعني أن النموذج محدد على أنه تصميم مركّب؛ وقد يكون التنزيل حزمة ZIP تضم النموذج المضيف وملفات RVT المرتبطة. أما إذا كانت القيمة false، فيشير المصدر إلى الحصول على ملف RVT واحد عند نشر أحدث إصدارات الملفات المضيفة والمرتبطة.

  3. حدّد اسم النموذج المضيف. في التصميم المركّب، يعرض الحقل attributes.data.compositeParentFile اسم ملف Revit المضيف. وتُستخدم هذه القيمة خصوصًا في سير العمل القديم، عندما تحتاج إلى تحديد النموذج الرئيسي داخل ZIP. تعامل مع محتوى الحقل على أنه اسم الملف، ولا تستبدل القيمة الواردة من API بتخمين منك.

  4. قيّم تاريخ النشر وفقًا للحد الفاصل في 7 فبراير 2025. يشرح المصدر استخدام الطريقة القديمة للنماذج المنشورة قبل هذا التاريخ، والطريقة الجديدة للنماذج المنشورة في هذا التاريخ أو بعده. اتخذ القرار استنادًا إلى قيمة attributes.createTime للملف. قد يؤدي تطبيق صيغة إدخال واحدة على كل النماذج من دون التحقق من التاريخ إلى عدم تطابق الملف الذي تتوقعه مهمة المعالجة مع المدخل الفعلي.

  5. حدّد إدخال ZIP في سير العمل القديم. إذا نُشر الملف قبل 7 فبراير 2025 وكان يتضمن تصميمًا مركّبًا، فاضبط قيمة zip على true ضمن إعدادات inputFile لمهمة المعالجة. وفي الحقل pathInZip، أدخل اسم الملف المضيف الوارد في compositeParentFile. وهكذا تستخدم المهمة حزمة ZIP كمدخل، مع تحديد ملف RVT المطلوب معالجته داخلها. يعرض المصدر هذه الطريقة من خلال مهمة نموذجية لتصدير DXF؛ وينبغي تطبيق المنطق هنا بحسب متطلبات الإدخال للنشاط المحدد.

  6. اجلب النموذج المضيف والملفات المرتبطة معًا في سير العمل الجديد. بالنسبة إلى الملفات المنشورة في 7 فبراير 2025 أو بعده، يمكن لاستدعاء GET linked Revit files إرجاع النموذج المضيف وملفات RVT المرتبطة غير المنشورة. تحقّق من الملف المضيف ونتائج linkedFiles في الاستجابة، وراجع أسماء النماذج ومعلومات الإصدارات وحالات النشر. ثم مرّر عناوين URL الموقّعة التي يوفرها هذا الاستدعاء إلى مدخلات مهمة المعالجة. يعرض مثال المصدر حالة Published للملف المضيف وحالة NotPublished للملف المرتبط؛ وتساعد هذه الحالات على فهم أن الملف المضيف والملف المرتبط قد لا يكونان في حالة النشر نفسها.

  7. تحقّق من بنية الإدخال قبل تشغيل المهمة. تستخدم الطريقة القديمة ZIP واسم الملف المضيف داخله، بينما تستخدم الطريقة الجديدة عناوين الملفات المضيفة والمرتبطة الواردة في استجابة GET linked Revit files. لا تخلط بين النهجين كما لو كانا بنية واحدة. وتأكد من مطابقة الملفات الواردة من API للمدخلات التي يتوقعها نشاط مهمة المعالجة.

أخطاء شائعة

قد يكون تفسير تنزيل ملف ZIP على أنه دليل على تلف الملف مضللًا عندما توجد نماذج مرتبطة غير منشورة. تحقّق أولًا من الحقل isCompositeDesign ومن اسم النموذج المضيف. ومن الأخطاء الأخرى استخدام zip: true لكل ملف من دون التحقق من قيمة isCompositeDesign؛ فقد لا يتوافق هذا الإعداد مع إدخال RVT واحد متوقع في حالة النماذج غير المركّبة.

كذلك ينبغي عدم إغفال تاريخ النشر. فبحسب المصدر، تُعالج الملفات المنشورة قبل 7 فبراير 2025 بالطريقة القديمة، بينما تُعالج الملفات المنشورة في التاريخ الفاصل أو بعده باستخدام نهج GET linked Revit files. وأخيرًا، لا تكتب اسم ملف عشوائيًا بدلًا من قيمة compositeParentFile، ولا تكتفِ بجلب النموذج المضيف في الطريقة الجديدة مع تجاهل الملفات المرتبطة.

التأثير في سير عمل العمارة والتصوّر

هذا التمييز مهم للفرق التي تصدّر بيانات Revit أو تفحصها أو تُعدّ تقارير عنها تلقائيًا عبر السحابة. فقد لا تُنشر جميع النماذج المرتبطة في المشروع في الوقت نفسه؛ لذلك قد تعمل الأتمتة التي تتوقع ملف RVT واحدًا ببيانات ناقصة إذا لم تتعامل مع المدخل المركّب على نحو صحيح. ويساعد التحقق المسبق من معلومات النموذج على معالجة مجموعة الملفات الصحيحة عبر الأتمتة.

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

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

تتضمن موارد Autodesk للمطورين الخاصة بـ Revit API أدلة للمبتدئين وأمثلة برمجية ودعمًا من المجتمع. تحقّق أولًا من نوع النموذج وعلامة التصميم المركّب واسم النموذج المضيف في استجابة إصدار الملف. ثم اختر الطريقة المناسبة لتاريخ النشر واختبر مدخلات مهمة المعالجة. وعند توسيع سير العمل، يمكنك تقييم حالات الاستخدام المذكورة في المصادر، مثل استخراج بيانات Revit وتعديلها، وإعداد التقارير تلقائيًا، وإنشاء الوثائق.

المصدر والترخيص

أُعدّ هذا الدليل استنادًا إلى النظرة العامة على Revit API من Autodesk Platform Services، وإعلان Automation API، ودليل معالجة تصميمات Revit المركّبة. والمصادر الثلاثة متاحة للعموم (الترخيص=حر)؛ وقد جرى تكييف محتواها باللغة التركية.

المصادر

3 مصادر
A
aps.autodesk.comaps.autodesk.com/developer/overview/revit
ملخص
A
aps.autodesk.comaps.autodesk.com/blog/design-automation-api-revit-inventor-3ds-max-now-available
ملخص
A
aps.autodesk.comaps.autodesk.com/blog/make-composite-revit-design-work-revit-automation-api
ملخص

لا نعيد نشر نصوص المصادر؛ الاقتباسات القصيرة مشار إليها، وما تبقى ملخص وتعليق من إعدادنا.

رأي 3dsınıfı
3dتقييم المحرر

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

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

الأسئلة الشائعة

كيف يمكن معرفة ما إذا كان الملف تصميمًا مركّبًا في Revit Automation API؟

تحقّق من الحقل `attributes.data.isCompositeDesign` في إصدار الملف. إذا كانت القيمة `true`، فهذا يعني أن التصميم محدد على أنه مركّب، وقد يكون التنزيل ملف ZIP يضم النموذج المضيف وملفات RVT المرتبطة.

ما الطريقة المستخدمة لتمرير نماذج Revit المرتبطة إلى Automation API؟

بالنسبة إلى الملفات المنشورة في 7 فبراير 2025 أو بعده، يمكن لاستدعاء GET linked Revit files توفير النموذج المضيف والملفات المرتبطة. وتُمرّر عناوين URL الموقّعة الواردة في الاستجابة إلى مدخلات مهمة المعالجة.

هل يتطلب Revit Automation API تثبيت Revit على سطح المكتب؟

بحسب توضيح Autodesk بشأن Revit Automation API، يمكن الوصول إلى Revit Database API من دون تثبيت Revit على سطح المكتب. وتشير المصادر بشكل منفصل إلى شروط الوصول إلى API والاشتراك.

التعليقات والمنتدى باللغة التركية.شارك في النقاش
+

أخبار ذات صلة