باختصار
- يركز دليل Revit على تشغيل إضافة موجودة عبر Automation Service، ولا يعلّم كيفية تطوير الإضافات.
- بما أن التفاعل مع المستخدم غير ممكن في بيئة Revit السحابية، يجب إزالة مراجع واجهة المستخدم من الإضافة.
- يتطلب الإجراء النموذجي تعديلًا في كود C#؛ ويمكن لمن لا يملكون خبرة في C# البدء بالمهمة الثانية باستخدام الإضافة النموذجية DeleteWalls.dll.
- يمكن إرسال الطلبات باستخدام cURL أو تنفيذها عبر مجموعة Postman المُعدّة لهذا الدليل.
تتيح APS Design Automation API v3 من Autodesk Platform Services (APS) إنشاء بيانات Revit وفحصها وتعديلها في السحابة. يوضح دليل Revit الرسمي من Autodesk كيفية تشغيل إضافة Revit موجودة في بيئة Automation Service التي لا تتضمن واجهة مستخدم. ولا يركّز هذا الدليل على تطوير الإضافات، بل على تجهيز إضافة جاهزة للتشغيل السحابي واتباع تسلسل الطلبات الوارد في الوثائق. لا تحدد الوثائق رقم إصدار معينًا من Revit أو متطلبات الأجهزة أو الأسعار.
ما المهام التي يمكن نقلها إلى السحابة؟
حدّد المهام المتكررة. ابدأ بتحديد العملية التي تتكرر كثيرًا في ملفات Revit أو التي ستُطبّق على عدد كبير من النماذج. تشرح وثائق APS أن Design Automation API تتيح نقل أعباء العمل المتكررة أو واسعة النطاق إلى الخدمة. وتشمل الاستخدامات الموضحة على جانب Revit إنشاء النماذج، وفحص بياناتها، وإعداد التقارير تلقائيًا، وتعديل النماذج القائمة وفق معايير الشركة، وإعداد الوثائق.
تساعدك هذه الخطوة على تحديد مدى ملاءمة الإضافة للأتمتة. فإذا كانت العملية تعتمد على قرار من المستخدم أو على عنصر تحكم ظاهر على الشاشة، فقد لا يكون نقلها كما هي إلى السحابة ممكنًا. ويساعد تحديد المدخلات والمخرجات المطلوبة مسبقًا على ضبط نطاق العمل عند تجهيز الإضافة.
اعتمد على إضافة Revit موجودة. لا يشرح الدليل كيفية كتابة الإضافة، بل يركّز فقط على تشغيلها عبر Automation Service. وإذا لم تكن لديك إضافة بعد، فلا ينبغي اعتبار هذا الدليل مرجعًا مستقلًا لإنشائها. وتحيل Autodesk الراغبين في معرفة تطوير الإضافات إلى Revit Developer Center.
وهذا تمييز مهم: التشغيل السحابي لا يغني عن تطوير الإضافة. ولا ينبغي افتراض أن إضافة مستخدمة في المكتب ستعمل في السحابة أيضًا؛ إذ يجب التعامل بشكل منفصل مع اعتمادها على الواجهة وطريقة تنفيذها. ويسهّل البدء بمهمة واحدة واضحة النطاق معرفة التجهيزات المطلوبة.
تجهيز الإضافة للتشغيل السحابي
أزل الاعتماد على واجهة المستخدم. وفقًا لـ Autodesk، لا يمكن التفاعل مع المستخدم عبر Automation Service. وبما أن إضافات Revit مصممة عادةً للتفاعل مع واجهة المستخدم، يجب إزالة جميع المراجع المرتبطة بالواجهة من الإضافة قبل تشغيلها في السحابة.
والسبب هو أن المستخدم لن يتمكن في البيئة السحابية من فتح نافذة على الشاشة وإجراء اختيار، أو الضغط على زر تأكيد. لذلك يجب تحويل العملية إلى مسار لا ينتظر قرارات وسيطة من المستخدم. وتعرّف الوثائق Task 1 بأنها خطوة تهيئة الإضافة لتلائم Automation API. كما تُعد إزالة مراجع الواجهة جزءًا من هذا الإعداد.
قيّم التعديلات المطلوبة على الكود. يتطلب دليل Autodesk تعديل كود C# في المهمة الأولى. وإذا لم تكن لديك خبرة كافية في C#، فتشير الوثائق إلى إمكانية البدء من Task 2 باستخدام الإضافة النموذجية الجاهزة لـ Automation API المسماة
DeleteWalls.dll. يصف هذا الاسم الإضافة النموذجية؛ ولا ينبغي اعتبارها أداة عامة ملائمة تلقائيًا لمهمة أخرى في Revit.قد يساعد استخدام النموذج على اتباع خطوات إرسال الطلبات، لكنه لا يعالج تلقائيًا اعتماد الإضافة الفعلية في مشروعك على الواجهة أو منطقها التشغيلي. وعند الانتقال إلى إضافتك، ينبغي فحص الكود والوظيفة التي تنفذها الإضافة بصورة منفصلة. ولا تقدم الوثائق قائمة محددة بالتعديلات البرمجية أو وصفة تحويل صالحة لكل الإضافات.
إرسال الطلبات ومتابعة سير العمل
اتبع ترتيب مهام الدليل. يقسّم دليل Revit العملية المطلوبة لتشغيل الإضافة عبر Automation Service إلى خطوات. وتُنفذ المهمة الأولى في Visual Studio فقط، ولا ترسل طلبًا إلى APS. لذلك لا تتضمن مجموعة Postman من Autodesk مجموعة خاصة بـ Task 1.
تمنع هذه المعلومة من يفتشون عن المهمة الأولى في Postman من الاعتقاد خطأً بأن هناك جزءًا مفقودًا. فالهدف هو تهيئة الإضافة أولًا، ثم الانتقال إلى خطوات الاتصال بالخدمة. وقد وُفّقت أسماء المهام والطلبات في الوثيقة؛ لذا تساعد متابعة هذه التسميات على معرفة المرحلة التي ينتمي إليها كل طلب.
استخدم Postman أو cURL. تجمع مجموعة Postman التي أعدّتها Autodesk طلبات HTTP المستخدمة في الدليل. وتُنظّم الطلبات فيها حسب المهام، كما يمكن لمن لا يرغبون في استخدام Postman متابعة الدليل نفسه باستخدام cURL. ويُقدَّم Postman بوصفه خيارًا بواجهة رسومية لإرسال طلبات HTTP.
يمكن للفريق الذي يفضّل إرسال الطلبات يدويًا استخدام cURL، بينما يمكن لمن يريد تنفيذها عبر واجهة استخدام مجموعة Postman. والأهم هو متابعة اسم الطلب والمهمة المرتبطة به معًا. لا يقدم النص المصدر جدولًا لتوافق إصدارات Revit أو معلمات طلبات صالحة لكل مشروع؛ لذلك لا يصح افتراض قيم غير واردة في الوثائق.
شغّل العملية في بيئة Revit السحابية. تتيح APS عبر Automation API الوصول إلى إصدار من Revit يعمل في السحابة ولا يتضمن واجهة مستخدم. وتشير الوثائق إلى إمكانية الوصول إلى Revit DB API من دون تثبيت Revit على جهاز مكتبي. وتمهّد هذه البنية لتطبيقات وخدمات سحابية تُنشئ بيانات النماذج أو تستخرجها أو تعدّلها.
في هذه المرحلة، تحقّق من العملية التي تستهدفها الإضافة والمدخلات المستخدمة والنتيجة المتوقعة وفق متطلبات المشروع. ولا يعني هذا الفحص النهائي أن Autodesk توفر أمر تحقق محددًا؛ بل هو ممارسة عملية يمكن تطبيقها لضمان استخدام الأتمتة بأمان ضمن سير العمل المكتبي. ولا تذكر المصادر طريقة مفصلة لتنزيل النتائج أو إصدارًا محددًا من Revit.
أثر ذلك في سير عمل العمارة والتصوّر المعماري
يمكن لفرق العمارة والتصميم الداخلي التي تنفّذ مهامًا متكررة لفحص نماذج Revit أو استخراج البيانات أو إعداد التقارير أو الوثائق أن تدرس هذا النهج. ويُعد تكرار النوع نفسه من العمليات على عدة نماذج نقطة بداية جيدة لاستكشاف مدى ملاءمة المهام التي تُنفذ واحدة تلو الأخرى على أجهزة المكتب للأتمتة السحابية. لكن المصادر لا تحدد مقدارًا معينًا لتسريع العمل أو توفير الوقت.
ولا تصف الوثائق ميزة مباشرة لإنتاج التصيير لفرق archviz. فهي تركز على تشغيل إضافات Revit في السحابة، ولا تحدد محرك تصيير أو إعدادات جودة الصورة أو متطلبات بطاقة الرسومات. لذا ينبغي حصر الاستخدام في بيانات النماذج والعمليات التي تنفذها إضافات Revit. كما لا توضح هنا شروط الترخيص أو الرسوم، وينبغي التحقق منها بصورة منفصلة قبل الانتقال إلى سير عمل سحابي.
أخطاء شائعة
نقل إضافة تعتمد على واجهة المستخدم إلى Automation Service من دون أي تعديل. تشترط الوثائق إزالة مراجع الواجهة.
اعتبار الدليل دورة تدريبية على تطوير الإضافات. فهو يشرح تشغيل إضافة موجودة.
البحث عن Task 1 في مجموعة Postman. تُنفذ المهمة الأولى في Visual Studio ولا ترسل طلبًا إلى APS.
اعتبار
DeleteWalls.dllحلًا جاهزًا لكل مشروع. يقدمه المصدر بوصفه إضافة نموذجية محددة تتيح البدء من Task 2.افتراض إصدار Revit أو الأسعار أو الأجهزة أو معلمات الطلبات التي لا ترد في الوثائق. فهذه التفاصيل غير مذكورة في النصوص المصدرية.
المصادر
2 مصادرلا نعيد نشر نصوص المصادر؛ الاقتباسات القصيرة مشار إليها، وما تبقى ملخص وتعليق من إعدادنا.
بالنسبة إلى مكاتب العمارة والتصميم الداخلي في تركيا، قد تكون APS Design Automation جديرة بالدراسة، ولا سيما للفرق التي تنفذ عمليات Revit نفسها مرارًا. لكن الجهد الأساسي لا يقتصر على إرسال الطلب إلى السحابة؛ بل يشمل إزالة اعتماد الإضافة على الواجهة والتحقق من أنها تقدم نتائج صحيحة ضمن سير العمل الفعلي. لذلك من الأفضل البدء بعملية صغيرة ومحددة النطاق.
لا توضح الوثائق الأسعار أو شروط الترخيص أو إصدار Revit أو متطلبات الأجهزة؛ لذا لا ينبغي اتخاذ القرار بناءً على افتراضات تتعلق بالتكلفة أو التوافق. كما أن نموذج `DeleteWalls.dll` لا يحل محل إضافة كل مكتب. ومن الخطوات العملية أن تقيّم الفرق أولًا احتياجات الإضافة الحالية ومتطلبات معرفة الكود، ثم تتبع دليل Autodesk الرسمي باستخدام Postman أو cURL.
الأسئلة الشائعة
هل يمكن تشغيل إضافة Revit في السحابة باستخدام APS Design Automation؟
نعم. تتضمن وثائق APS Design Automation API v3 من Autodesk دليلًا لتشغيل إضافات Revit عبر Automation Service. ولا يمكن التفاعل مع المستخدم في البيئة السحابية.
ما الذي ينبغي فعله قبل تشغيل إضافة Revit عبر Automation Service؟
يجب إزالة المراجع المرتبطة بواجهة المستخدم من الإضافة. كما تتضمن خطوات Autodesk الإرشادية خطوة إعداد تتطلب تعديل كود C#.
هل يمكن إرسال طلبات Revit Automation API باستخدام Postman؟
نعم. تضم مجموعة Postman من Autodesk طلبات HTTP الواردة في الدليل، مقسّمة إلى مجموعات بحسب المهام. ويمكن أيضًا إرسال الطلبات باستخدام cURL.



