معالجة النماذج المرتبطة في Revit Automation API: دليل خطوة بخطوة

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

من المشكلات التي قد تواجهك عند ربط نموذج Revit بمهمة أتمتة سحابية تنزيل حزمة ZIP بدلًا من ملف RVT واحد كما هو متوقع. ولا يعني ذلك دائمًا حدوث خطأ في التنزيل: فوفقًا لدليل Autodesk، إذا لم تكن الملفات المرتبطة بنموذج Revit Cloud Worksharing منشورة بالحالة الحديثة نفسها للنموذج الرئيسي، فقد تتضمن حزمة التنزيل ملف RVT الرئيسي وملفات RVT المرتبطة معًا.

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

تشير Autodesk إلى إمكانية استخدام Revit API لأتمتة المهام المتكررة وتوسيع وظائف Revit. وتتيح Revit Automation API تنفيذ عمليات مثل إنشاء بيانات Revit وفحصها وتعديلها من خلال تطبيقات وخدمات سحابية. ويركز هذا المثال على نقل ملف Revit إلى عنصر عمل الأتمتة بالطريقة الصحيحة.

المتطلبات والتحضير

يتطلب سير العمل تطبيقًا قادرًا على التعامل مع واجهات Autodesk Platform Services (APS) API، وإمكانية الاستعلام عن معلومات الملفات والإصدارات، وملفات النماذج المراد نقلها إلى عنصر العمل. تسرد صفحة API لدى Autodesk أدلة المطورين ومجموعات SDK وأمثلة التعليمات البرمجية ومصادر دعم المجتمع. وتدعم Revit Automation API إنشاء تطبيقات سحابية تتيح الوصول إلى Revit DB API من دون الحاجة إلى تثبيت Revit على جهاز مكتبي.

يذكر إعلان قديم عن Automation API ضمن مصادر المعلومات وجود اشتراك Forge ساري أو حساب تجريبي. لا تؤكد هذه المعلومة شروط الأسعار أو الوصول الحالية؛ لذا تحقق من أحدث مصادر APS بشأن الأسعار ومتطلبات الحساب قبل بدء التطبيق. كما لا تحدد الوثائق إصدارًا بعينه من Revit لهذه العملية.

جهّز العناصر التالية قبل البدء:

• سجل الملف أو الإصدار على APS لنموذج Revit Cloud Worksharing المراد معالجته.

• بيانات الوصول اللازمة لإجراء استدعاءات API موثّقة.

• أداة تتيح لك التحقق من تاريخ النشر وخصائص إصدار الملف.

• معلومات السجل التي توضح تاريخ نشر النموذج واسم الملف الرئيسي.

خطوة بخطوة: حدّد نوع النموذج ومسار نقله

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

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

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

4. اختر الطريقة بحسب تاريخ النشر. إذا نُشر الملف قبل 7 فبراير 2025، فيمكن استخدام طريقة Autodesk القديمة: اضبط قيمة zip على true لملف الإدخال في عنصر العمل، واجعل قيمة pathInZip اسم ملف النموذج الرئيسي. وبذلك تحدد مسار الملف الرئيسي الذي سيفتحه Revit عند نقل حزمة ZIP إلى مهمة الأتمتة.

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

6. تحقق من مدخلات عنصر العمل. إذا اخترت الطريقة القديمة، فتأكد من صحة إعداد ZIP وقيمة pathInZip. أما في الطريقة الجديدة، فتحقق من نقل الملفات المرتبطة التي يعيدها الاستدعاء إلى جانب النموذج الرئيسي. يستخدم مثال Autodesk عناوين URL موقّعة لهذه الملفات؛ لذا استخدم القيم الحالية الواردة في استجابة استدعاء API الخاص بك، بدلًا من نسخ عناوين URL من نص المثال.

أخطاء شائعة

• اعتبار ZIP ملفًا تالفًا تلقائيًا: قد يكون الحصول على ZIP أمرًا متوقعًا إذا لم تُنشر النماذج المرتبطة بأحدث إصداراتها.

• الخلط بين نوع النموذج وحالة التصميم المركّب: تحدد قيمة C4RModel نوع الملف بوصفه Cloud Worksharing، بينما يوضح isCompositeDesign ما إذا كان التصميم مركّبًا. أجرِ الفحصين معًا.

• اختيار ملف RVT الرئيسي بالتخمين: استخرج اسم الملف الصحيح داخل ZIP من الحقل compositeParentFile.

• تجاهل التمييز بحسب التاريخ: يحدد الدليل مساري نقل مختلفين للملفات المنشورة قبل 7 فبراير 2025 وبعده.

• استخدام روابط الوصول المؤقتة الواردة في المثال: عناوين URL الموقّعة في المصدر جزء من استجابة نموذجية. استخدم الروابط التي يعيدها استدعاؤك الخاص.

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

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

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

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

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

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

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