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



