Revit Automation API-də əlaqəli modelləri emal etmək: addım-addım bələdçi

Bu bələdçidə nə öyrənəcəksiniz?

Revit modelini bulud əsaslı avtomatlaşdırma tapşırığına qoşarkən rast gəlinən problemlərdən biri gözlənilən tək RVT faylı əvəzinə ZIP paketi endirilməsidir. Bu, həmişə endirmə xətası demək deyil: Autodesk-in bələdçisinə görə, Revit Cloud Worksharing modelindəki əlaqəli fayllar əsas modellə eyni aktual dərc vəziyyətində deyilsə, endirilən paketdə əsas RVT və əlaqəli RVT faylları birlikdə ola bilər.

Bu bələdçidə modelin Revit Cloud Worksharing faylı olub-olmadığını, mürəkkəb dizayn kimi işarələnib-işarələnmədiyini və hansı avtomatlaşdırma üsulunun seçilməli olduğunu müəyyənləşdirəcəksiniz. Həmçinin dərc olunma tarixi 7 fevral 2025-dən əvvəl olan fayllarla həmin tarixdə və ya ondan sonra dərc edilən faylların iş axınındakı fərqlərinə baxacağıq.

Autodesk bildirir ki, Revit API təkrarlanan tapşırıqları avtomatlaşdırmaq və Revit funksiyalarını genişləndirmək üçün istifadə oluna bilər. Revit Automation API isə Revit məlumatlarının yaradılması, yoxlanması və dəyişdirilməsi kimi əməliyyatları bulud əsaslı tətbiq və xidmətlər vasitəsilə yerinə yetirməyə imkan verir. Bu nümunədə məqsəd Revit faylını avtomatlaşdırma iş tapşırığına düzgün şəkildə daxil etməkdir.

Tələblər və hazırlıq

İş axını üçün Autodesk Platform Services (APS) API-ləri ilə işləyə bilən tətbiq, fayl və versiya məlumatlarını sorğulamaq imkanı, həmçinin iş tapşırığına əlavə ediləcək model faylları lazımdır. Autodesk-in API səhifəsində tərtibatçı bələdçiləri, SDK-lar, nümunə kodlar və icma dəstəyi resursları sadalanır. Revit Automation API, Revit-in masaüstü quraşdırılmasına ehtiyac olmadan Revit DB API-yə çıxışı olan bulud əsaslı tətbiqlər yaratmağa imkan verir.

Automation API haqqında köhnə elanda Autodesk qüvvədə olan Forge abunəliyindən və ya sınaq hesabından bəhs edir. Bu məlumat cari ödəniş və ya giriş şərtlərini təsdiqləmir; işə başlamazdan əvvəl qiymətləri və hesab tələblərini APS-in aktual resurslarından yoxlayın. Sənədlərdə bu əməliyyat üçün konkret Revit versiyası da göstərilmir.

İşə başlamazdan əvvəl aşağıdakıları hazırlayın:

• Emal ediləcək Revit Cloud Worksharing modelinin APS-dəki fayl və ya versiya qeydi.

• Kimliyi təsdiqlənmiş API çağırışları üçün tələb olunan giriş məlumatları.

• Dərc olunma tarixini və fayl versiyasının atributlarını yoxlamaq üçün alət.

• Modelin nə vaxt dərc olunduğunu və əsas faylın adını göstərən qeyd məlumatları.

Addım-addım: model növünü və ötürmə üsulunu müəyyənləşdirin

1. Faylın Revit Cloud Worksharing modeli olub-olmadığını yoxlayın. Autodesk-in bələdçisi layihə qovluğunun məzmununu, element qeydini və ya versiya məlumatını qaytaran API çağırışlarında attributes.extension.type sahəsinə baxmağı tövsiyə edir. Bu sahənin dəyəri versions:autodesk.bim360:C4RModel olarsa, fayl Revit Cloud Worksharing modeli kimi müəyyən edilir. Yalnız fayl uzantısına əsaslanmaq əvəzinə versiya məlumatlarını yoxlayın.

2. Mürəkkəb dizayn vəziyyətini oxuyun. Eyni versiya qeydindəki attributes.data.isCompositeDesign sahəsi modelin mürəkkəb olub-olmadığını göstərir. Dəyər true olarsa, fayl mürəkkəb Revit dizaynıdır; endirilən məzmun ZIP ola bilər və paketdə əsas modelə bağlı RVT faylları yerləşə bilər. Dəyər false olarsa, Autodesk-in izahına görə, əsas fayl və əlaqələri ən son versiyaları ilə dərc edilib və endirmə tək RVT kimi əldə oluna bilər.

3. Əsas modelin fayl adını müəyyən edin. Mürəkkəb modeldə attributes.data.compositeParentFile sahəsi əsas Revit faylının adını verir. Bu məlumat, xüsusilə köhnə iş axınında ZIP-dən hansı faylın əsas model kimi istifadə olunacağını göstərmək üçün lazımdır. Əsas faylın adını təxmin etməyin; versiya qeydindəki dəyərə əsaslanın.

4. Dərc olunma tarixinə uyğun üsulu seçin. Fayl 7 fevral 2025-dən əvvəl dərc edilibsə, Autodesk-in köhnə üsulundan istifadə etmək olar: iş tapşırığındakı giriş faylı üçün zip dəyərini true edin, pathInZip dəyərinə isə əsas model faylının adını verin. Beləliklə, avtomatlaşdırma işinə ZIP paketi ötürülərkən Revit-in açacağı əsas faylın yolu göstərilir.

5. 7 fevral 2025-də və ya ondan sonra dərc edilmiş model üçün yeni üsuldan istifadə edin. Bu tarixdə və ya ondan sonra dərc edilən fayl üçün Autodesk GET linked Revit files çağırışı ilə əsas modeli və dərc olunmamış əlaqəli RVT fayllarını əldə etməyi tövsiyə edir. Çağırışın qaytardığı əsas model və əlaqəli faylların məlumatlarını iş tapşırığına əlavə edin. Köhnə ZIP yanaşmasını birbaşa tətbiq etmək əvəzinə, tarixə uyğun üsuldan istifadə edin.

6. İş tapşırığının giriş məlumatlarını yoxlayın. Köhnə üsul seçilibsə, ZIP parametrinin və pathInZip dəyərinin düzgün olduğuna əmin olun. Yeni üsulda isə çağırışdan qaytarılan əlaqəli faylların əsas modellə birlikdə ötürüldüyünü yoxlayın. Autodesk nümunəsində bu fayllar üçün imzalı URL-lərdən istifadə olunur; URL-ləri nümunə mətnindən köçürmək əvəzinə, öz API çağırışınızın cavabındakı aktual dəyərlərdən istifadə edin.

Tez-tez edilən səhvlər

• ZIP-i avtomatik olaraq zədələnmiş fayl hesab etmək: Əlaqəli modellərin aktual versiyaları dərc olunmayıbsa, ZIP əldə edilməsi gözlənilən hal ola bilər.

• Model növünü mürəkkəb dizayn vəziyyəti ilə qarışdırmaq: C4RModel dəyəri faylın Cloud Worksharing növünü müəyyən edir; isCompositeDesign isə dizaynın mürəkkəb olub-olmadığını göstərir. Hər iki yoxlamanı aparın.

• Əsas RVT-ni təxminlə seçmək: ZIP-dəki düzgün fayl adını compositeParentFile sahəsindən götürün.

• Tarix fərqini nəzərdən qaçırmaq: Bələdçi 7 fevral 2025-dən əvvəl və sonra dərc edilmiş fayllar üçün fərqli ötürmə üsulları təqdim edir.

• Nümunədəki müvəqqəti giriş bağlantılarından istifadə etmək: Mənbədəki imzalı URL-lər nümunə cavabın hissələridir. Öz API çağırışınızdan gələn bağlantılardan istifadə edin.

Memarlıq və vizuallaşdırma iş axınlarına təsiri

Bu yanaşma təkrarlanan model yoxlaması, məlumat çıxarılması, hesabat və ya avtomatik sənədləşdirmə addımlarını Revit əsaslı bulud iş axınlarına qoşan komandalar üçün əhəmiyyətlidir. Autodesk-in göstərdiyi istifadə sahələrinə Revit məlumatlarını yoxlamaq və təhlil etmək, məlumatları ixrac etmək, xüsusi Revit ailələri yaratmaq və sənədləşdirməni avtomatik hazırlamaq daxildir. Memarlıq büroları, interyer dizaynı komandaları və BIM menecerləri avtomatlaşdırmadan əvvəl əlaqəli modellərin versiya vəziyyətini yoxlamaqla yanlış və ya natamam giriş riskini azalda bilərlər.

Vizuallaşdırma komandaları üçün də əsas fayl və əlaqəli modellərin birlikdə ötürülməsi avtomatlaşdırmanın gözlənilən layihə məlumatları ilə işləməsini təmin edir. Bununla belə, bu bələdçidə render performansı, avadanlıq tələbləri və ya konkret vizuallaşdırma proqramı ilə uyğunluq barədə məlumat verilmir. Tətbiq etməzdən əvvəl API-yə giriş şərtlərini, lisenziya vəziyyətini və istifadə olunan iş axınının Revit məlumatları ilə uyğunluğunu yoxlayın.

Növbəti addımlar

İlk sınağı kritik olmayan model üzərində aparın. Faylın versiya atributlarını qeyd edin, dərc olunma tarixini təsdiqləyin və tarix şərtinə uyğun üsulu seçin. Avtomatlaşdırma nəticəsində gözlənilən əsas RVT-nin emal edildiyini yoxlayın. Daha sonra iş axınını məlumat çıxarma və ya hesabat ehtiyaclarınıza uyğunlaşdırmaq üçün Autodesk-in Revit API bələdçilərindən, başlanğıc təlimlərindən və kod nümunələrindən yararlanın.

Mənbə və lisenziya

Bu bələdçi Autodesk-in Revit Automation API və Revit API səhifələri, eləcə də mürəkkəb Revit dizaynlarının avtomatlaşdırma iş tapşırıqlarına ötürülməsini izah edən tərtibatçı məqaləsi əsasında Azərbaycan dilinə uyğunlaşdırılıb. Bütün mənbələr Autodesk-in rəsmi tərtibatçı məzmunlarıdır və açıq lisenziya ilə təqdim olunur.