مدخل إلى Revit API باستخدام Python: أدوات البداية وسير العمل الأول

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

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

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

المتطلبات والأدوات

الأدوات المستخدمة في درس Autodesk University هي RevitPythonShell وRevit Lookup وpyRevit. ويتوقع الدرس من المشاركين معرفة أساسية بـ Revit ومعرفة أولية بـ Python. ووفقًا لصفحة مطوري Revit API، توفر الواجهة المبنية على .NET وسيلة لأتمتة المهام المتكررة وتوسيع الوظائف الأساسية لـ Revit.

قبل البدء، تحقّق من النقاط التالية:

• تثبيت Revit المستخدم وملف المشروع.

• معرفة أساسية باستخدام Revit ومعرفة أولية بـ Python.

• معلومات التثبيت والتوافق الخاصة بـ RevitPythonShell وRevit Lookup وpyRevit مع إصدار Revit المستخدم.

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

مسار البدء خطوة بخطوة

1. ابدأ بفحص بيانات الغرفة في Revit. حدّد غرفة وراجع الحقول في لوحة Properties. وتورد وثيقة خصائص الغرف من Autodesk أمثلة مثل اسم الغرفة ورقمها ونوع الاستخدام والقسم وتشطيبات الجدران والسقف والأرضية. وتكون قيم المساحة والمحيط للقراءة فقط؛ كما يُشار إلى أن الحجم للقراءة فقط عند تفعيل حساب الحجوم. يساعدك فهم هذا الفرق على تحديد البيانات التي تريد قراءتها وما إذا كان هدفك تعديل بعضها.

2. صُغ محاولتك الأولى على أنها مسألة العثور على العناصر. ابدأ، مثلًا، بتعلّم كيفية فرز عناصر الغرف في المشروع وفق معيار محدد. ويعد درس Autodesk University جمع العناصر وتصفيتها باستخدام RevitPythonShell أحد أهداف التعلّم الأساسية. قبل كتابة أي كود، صِف بوضوح العناصر التي تريد تحديدها ومعنى شرط التصفية. ثم تحقّق من استدعاءات API الدقيقة في دليل المطورين وأمثلة الكود المقدمة من Autodesk.

3. أبقِ Revit Lookup ضمن قائمة أدوات الدرس. يذكر مصدر Autodesk University أن Revit Lookup من الأدوات المستخدمة أثناء الدرس، لكن الوصف المتاح لا يفصّل وظائف الأداة أو خطوات استخدامها. لذا، راجع وثائقها لمعرفة طريقة الاستخدام بدلًا من افتراض وظيفة فحص معينة أو مسار محدد في الواجهة. وهكذا لن تتعامل مع ميزة لم تؤكدها المصادر على أنها جزء مؤكد من مسار التعلّم.

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

5. حدّد هدفًا لحفظ أداة Python وإعادة استخدامها. يتضمن درس المبتدئين أيضًا حفظ أدوات Python واستخدامها ضمن أهداف التعلّم. ابدأ بتجربة صغيرة لمهمة واحدة، ثم قيّم حاجتك إلى إعادة استخدامها. يظهر pyRevit في قائمة أدوات الدرس، لكن النص المصدر لا يقدّم أمرًا محددًا أو مسار استخدام له. راجع الوثائق الحالية للأداة لمعرفة تفاصيل التثبيت والتطبيق.

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

أخطاء شائعة

• افتراض الإصدار: لا يحدد درس المبتدئين إصدارًا بعينه من Revit أو الأدوات. تحقّق من معلومات التثبيت والتوافق بشكل منفصل.

• الاعتقاد بإمكانية تعديل كل خصائص الغرفة: المساحة والمحيط للقراءة فقط. كما توصف قيمة الحجم بأنها للقراءة فقط عند تفعيل حساب الحجوم. تحقّق من طبيعة الخاصية قبل تنفيذ العملية.

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

• تجاوز موضوع Transactions: أدرج المعاملات ضمن خطة التعلّم عند تجربة تغييرات على النموذج. وتحقّق من طريقة التنفيذ الدقيقة في وثائق API.

• استنتاج وظائف لم تذكرها المصادر من أسماء الأدوات: ترد RevitPythonShell وRevit Lookup وpyRevit ضمن أدوات الدرس، لكن المصادر لا تشرح جميع وظائف كل أداة أو خطوات تثبيتها الحالية.

الخطوات التالية: سير العمل في العمارة والتصوّر المرئي

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

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

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

أُعد هذا الدليل بالاستناد إلى صفحة مطوري Revit API من Autodesk، ووثيقة خصائص الغرف في مساعدة Autodesk Revit 2025، ودرس Autodesk University بعنوان “Revit Programming for Beginners: Easily Access the Revit API Using Free Tools”. وتشير سجلات المصادر إلى أن حالة الترخيص «حرّة»؛ لكن لا تتوفر معلومات عن ترخيص محدد من Creative Commons، لذلك لا ندّعي وجود ترخيص مفتوح.