Qısaca
- Revit Cloud Worksharing modelində birləşik dizaynın olub-olmadığını `isCompositeDesign` sahəsindən yoxlayın.
- `isCompositeDesign` true olarsa, endirilən fayl host modeli və bağlı RVT fayllarını ehtiva edən ZIP paketi ola bilər.
- 7 fevral 2025-ci ildə və ya daha sonra dərc olunan fayllar üçün bağlı modelləri əldə etmək məqsədilə GET linked Revit files çağırışından istifadə etmək mümkündür.
- Köhnə iş axınında ZIP girişi `zip: true`, ZIP daxilindəki host modelin adı isə `pathInZip` sahəsi ilə göstərilir.
Bu bələdçidə nə öyrənəcəksiniz?
Revit Cloud Worksharing vasitəsilə dərc edilmiş faylın niyə bəzən tək RVT əvəzinə ZIP kimi endirildiyini və bu dizaynın Automation API iş axınına necə ötürüləcəyini addım-addım nəzərdən keçirəcəyik. Əsas fərq modelin birləşik dizayn olub-olmamasıdır: host faylı ilə yanaşı bağlı RVT modelləri də paketdə yer ala bilər. Buna görə də avtomatlaşdırma tapşırığını hazırlayarkən yalnız fayl uzantısına baxmaq kifayət deyil; fayl versiyasının API cavabındakı məlumatları da yoxlamaq lazımdır.
Bələdçi Autodesk Platform Services sənədlərində təsvir olunan API sahələri və iki ayrı iş axını əsasında hazırlanıb. Köhnə və yeni üsullar arasındakı tarix həddi 7 fevral 2025-ci ildir. Məqsəd API çağırışlarının bütün autentifikasiya və tətbiq quraşdırma addımlarını izah etmək deyil; əlinizdəki model məlumatlarını şərh edib düzgün giriş formatını seçməkdir.
Tələblər
Revit Cloud Worksharing layihəsinə və fayl məlumatlarını oxumaq üçün Autodesk Platform Services API girişinə sahib olun. Mənbələrdəki nümunədə layihə və fayl versiyası məlumatları API çağırışları ilə yoxlanılır.
Automation API ilə işləmək üçün mənbələrdə göstərilən aktiv Forge sınaq versiyası və ya abunə şərtini nəzərə alın. Müvafiq mənbədə qiymət təfərrüatları üçün ayrıca səhifəyə keçid verilir; burada cari qiymət göstərilmir.
Emal edəcəyiniz modelin dərc tarixini və fayl versiyası cavabındakı
attributes.extensionvəattributes.datasahələrini yoxlaya bilməlisiniz.Bu iş axını üçün Revit masaüstü quraşdırmasının mütləq olduğu nəticəsinə gəlməyin: Autodesk-in Revit Automation API açıqlamasında Revit verilənlər bazası API-sinə masaüstü Revit quraşdırılmadan daxil olmaqdan bəhs edilir. Bununla belə, bu, API girişinə və ya tələb olunan layihə girişlərinə ehtiyac olmadığı demək deyil.
Mənbələrdə konkret Revit versiya nömrəsi, cari abunə qiyməti və ya başdan sona autentifikasiya quraşdırması göstərilmədiyindən bu məlumatlar burada fərz edilmir.
Addım-addım: dizaynı müəyyənləşdirmək və tapşırığı hazırlamaq
Faylın Revit Cloud Worksharing modelini təmsil etdiyini təsdiqləyin. Layihə məzmunu, fayl elementi və ya versiyalar üçün edilən API çağırışlarının cavabında
attributes.extension.typesahəsini yoxlayın. Dəyərversions:autodesk.bim360:C4RModelolarsa, mənbəyə görə bu fayl Revit Cloud Worksharing modelidir. Birləşik dizayn məlumatını düzgün kontekstdə şərh etmək üçün bu, ilk addımdır.Birləşik dizayn bayrağını oxuyun. Eyni versiya cavabında
attributes.data.isCompositeDesignsahəsini tapın. Dəyərtrueolduqda model birləşik dizayn kimi işarələnir; endirilən fayl host modeli və bağlı RVT fayllarını ehtiva edən ZIP paketi ola bilər. Dəyərfalseolarsa, mənbədə host və bağlı faylların ən son versiyaları dərc edildikdə tək RVT faylı alınacağı bildirilir.Host modelin adını müəyyənləşdirin. Birləşik dizaynda
attributes.data.compositeParentFilesahəsi host Revit faylının adını göstərir. Bu dəyər xüsusilə ZIP daxilindəki host modeli seçməli olduğunuz köhnə iş axınında istifadə edilir. Sahənin məzmununu fayl adı kimi qəbul edin; API-dən gələn dəyəri öz təxmininizlə əvəz etməyin.Dərc tarixini 7 fevral 2025-ci il həddinə əsasən qiymətləndirin. Mənbədə həmin tarixdən əvvəl dərc edilmiş modellər üçün köhnə üsuldan, həmin tarixdə və ya daha sonra dərc edilənlər üçün isə yeni üsuldan istifadə edilməsi izah olunur. Qərarı faylın
attributes.createTimedəyərinə əsasən verin. Tarixi yoxlamadan bütün modellərə eyni giriş formatını tətbiq etmək, tapşırığın gözlədiyi faylla faktiki girişin uyğun gəlməməsinə səbəb ola bilər.Köhnə iş axınında ZIP girişini təyin edin. Fayl 7 fevral 2025-ci ildən əvvəl dərc edilibsə və birləşik dizayn ehtiva edirsə, tapşırığın
inputFileparametrlərindəzipdəyərinitrueedin.pathInZipsahəsinə isəcompositeParentFiledaxilindəki host faylın adını yazın. Beləliklə, tapşırıq ZIP paketini giriş kimi qəbul edərkən, onun içindən hansı RVT faylının emal olunacağı da göstərilir. Mənbədə bu üsul nümunə DXF ixrac tapşırığı ilə nümayiş etdirilir; burada yanaşma seçilmiş fəaliyyətin giriş tələblərinə uyğun tətbiq edilməlidir.Yeni iş axınında host və bağlı faylları birlikdə əldə edin. 7 fevral 2025-ci ildə və ya daha sonra dərc edilmiş fayllar üçün GET linked Revit files çağırışı host modeli və dərc edilməmiş bağlı RVT fayllarını qaytara bilər. Cavabda host faylını və
linkedFilesnəticələrini yoxlayın; model adlarını, versiya məlumatlarını və dərc statuslarını nəzərdən keçirin. Daha sonra bu çağırışın təqdim etdiyi imzalı URL-ləri tapşırığın girişlərinə ötürün. Mənbədəki nümunədə host üçünPublished, bağlı fayl üçün isəNotPublishedstatusu göstərilir; bu statuslar host və bağlı faylın eyni dərc vəziyyətində olmaya biləcəyini anlamağa kömək edir.Tapşırığı işə salmazdan əvvəl giriş strukturunu yoxlayın. Köhnə üsulda ZIP və ZIP daxilindəki host adı; yeni üsulda isə GET linked Revit files cavabındakı host və bağlı fayl ünvanları istifadə olunur. Bu iki yanaşmanı vahid struktur kimi qarışdırmayın. Tapşırığın fəaliyyətinin gözlədiyi girişlərin API-dən alınan fayllarla uyğunluğunu yoxlayın.
Tez-tez buraxılan səhvlər
ZIP faylının endirilməsini modelin zədələnməsi kimi şərh etmək, dərc edilməmiş bağlı modellərin olduğu hallarda yanlış nəticəyə gətirə bilər. Əvvəlcə isCompositeDesign sahəsini və host adını yoxlayın. Digər bir səhv isCompositeDesign dəyərini yoxlamadan hər fayl üçün zip: true istifadə etməkdir; birləşik olmayan modeldə bu parametr gözlənilən tək RVT girişi ilə uyğun gəlməyə bilər.
Dərc tarixi də nəzərdən qaçırılmamalıdır. Mənbəyə əsasən, 7 fevral 2025-ci ildən əvvəlki fayllar köhnə üsulla, həmin tarix və ondan sonrakılar isə GET linked Revit files yanaşması ilə emal edilir. Nəhayət, compositeParentFile dəyərini təsadüfi fayl adı ilə əvəz etməyin və yeni üsulda yalnız host modelini əldə edib bağlı faylları kənarda qoymayın.
Memarlıq və vizuallaşdırma iş axınına təsiri
Bu fərq Revit məlumatlarını buludda avtomatik ixrac edən, yoxlayan və ya hesabat hazırlayan komandalar üçün vacibdir. Layihədəki bağlı modellərin hamısı eyni vaxtda dərc edilməmiş ola bilər; buna görə də tək RVT gözləyən avtomatlaşdırma birləşik girişi düzgün emal etmədikdə natamam məlumatla işləyə bilər. Model məlumatlarını əvvəlcədən yoxlamaq avtomatlaşdırmanın düzgün fayl dəstini emal etməsinə kömək edir.
Memarlıq ofisləri və BIM komandaları üçün əsas məqam avadanlıq deyil, API girişi, abunə şərtləri və fayl girişinin düzgün konfiqurasiya edilməsidir. Vizuallaşdırma komandaları ixrac və ya model təhlili kimi təkrarlanan işlərdə bu iş axınından yararlana bilər; lakin mənbələr konkret render proqramı uyğunluğu, emal müddəti və ya xərc barədə məlumat vermir. İstehsal xəttinə keçməzdən əvvəl istifadə olunan fəaliyyət və fayl strukturu ilə kiçik sınaq aparmaq məqsədəuyğundur.
Növbəti addımlar
Autodesk-in Revit API tərtibatçı resurslarında başlanğıc bələdçiləri, kod nümunələri və icma dəstəyi göstərilir. Əvvəlcə fayl versiyası cavabından model növünü, birləşik dizayn bayrağını və host adı dəyərlərini təsdiqləyin. Daha sonra dərc tarixinə uyğun üsulu seçib tapşırığın girişini sınaqdan keçirin. İş axınını genişləndirərkən mənbələrdə göstərilən Revit məlumatlarının çıxarılması və dəyişdirilməsi, avtomatik hesabatların və sənədlərin yaradılması kimi istifadə sahələrini nəzərdən keçirə bilərsiniz.
Mənbə və lisenziya
Bu bələdçi Autodesk Platform Services-in Revit API ümumi baxışı, Automation API elanı və birləşik Revit dizaynlarının emalı bələdçisi əsasında hazırlanıb. Hər üç mənbə açıqdır (lisenziya=sərbəst); məzmun Azərbaycan dilinə uyğunlaşdırılıb.
Mənbələr
3 mənbəMənbə mətnləri yenidən dərc edilmir; qısa sitatlar işarələnir, qalanı bizim xülasə və şərhimizdir.
Türkiyədəki ofislər üçün bu yanaşmanın ən praktik faydası bağlı modellərin dərc statusundan qaynaqlanan gözlənilməz ZIP girişlərini avtomatlaşdırma başlamazdan əvvəl üzə çıxarmasıdır. Xüsusilə müntəzəm ixrac və model təhlili aparan komandalar düzgün giriş formatını seçməklə təkrar cəhdlərə və faylları əl ilə çeşidləməyə daha az ehtiyac duya bilər.
İnvestisiya qərarında güclü avadanlıqdan əvvəl API girişi, abunə şərtləri və mövcud iş axınının uyğunluğu nəzərə alınmalıdır. Mənbələr cari qiymət və emal xərcləri barədə məlumat vermədiyindən ofislər öz istifadə ssenarilərini kiçik sınaqla qiymətləndirməlidir. Tələbələr üçün də bu, bağlı Revit modellərinin bulud avtomatlaşdırmasına necə ötürüldüyünü öyrənmək baxımından faydalı nümunədir; lakin konkret proqram versiyalarının uyğunluğu ayrıca yoxlanmalıdır.
Tez-tez verilən suallar
Revit Automation API-də faylın birləşik dizayn olduğu necə müəyyən edilir?
Fayl versiyasının `attributes.data.isCompositeDesign` sahəsini yoxlayın. Dəyər `true` olarsa, dizayn birləşik kimi işarələnir və endirilən fayl host və bağlı RVT fayllarını ehtiva edən ZIP ola bilər.
Revit bağlı modellərini Automation API-yə ötürmək üçün hansı üsuldan istifadə olunur?
7 fevral 2025-ci ildə və ya daha sonra dərc edilmiş fayllar üçün GET linked Revit files çağırışı host və bağlı faylları təmin edə bilər. Cavabdakı imzalı URL-lər tapşırığın girişlərinə ötürülür.
Revit Automation API üçün Revit masaüstü quraşdırması tələb olunurmu?
Autodesk-in Revit Automation API açıqlamasına görə, Revit verilənlər bazası API-sinə masaüstü Revit quraşdırılmadan daxil olmaq mümkündür. Mənbələrdə API girişi və abunə şərtləri ayrıca göstərilir.



