İçeriğe atla
Son haberler
Revit’te Scope Box görünürlüğü: Görünümlerde nasıl kontrol edilir?Revit Automation API ile bağlı modelleri içeren projeleri işlemeBlender’da gerçekçi hareket bulanıklığı: shutter ayarları ve iş akışıRhino’da Flow ve FlowAlongSrf: Eğri ve yüzey boyunca geometri eşlemeBlender’da panoramik kamera kullanımı: 360°, VR ve kubbe projeksiyonuBlender Geometry Nodes Raycast Node ile yüzey ve çarpışma verisi alınAfter Night There Is Nothing: Sharjah’ta üç kubbeli yerleştirmeArchicad 29’da Graphic Override Rules: Kural oluşturma rehberiGemma 4 ile mimari görsel analizi: Python’da kurulum ve uygulamaBlender Bevel Modifier ile kontrollü ve tahribatsız kenar pahı oluşturma
EğitimlerRevitOMARevit Automation API

Revit Automation API ile bağlı modelleri içeren projeleri işleme

Bu rehber, Revit Cloud Worksharing projelerinin ZIP mi yoksa tek RVT dosyası mı olarak indirileceğini belirlemeyi ve bağlı modelleri Automation API iş akışına aktarmayı anlatıyor.

Bağlı yapı kütleleriyle temsil edilen bulut tabanlı BIM iş akışıAI görsel
Temsilî görsel; yapay zekâ ile üretildi.Görsel: 3dsınıfı / FCA AI
KaydetPaylaş0

Kısaca

  1. Bir Revit Cloud Worksharing modelinde birleşik tasarım olup olmadığını `isCompositeDesign` alanından kontrol edin.
  2. `isCompositeDesign` true ise indirme, ana model ile bağlı RVT dosyalarını içeren bir ZIP paketi olabilir.
  3. 7 Şubat 2025 ve sonrasında yayımlanan dosyalar için bağlı modelleri almak üzere GET linked Revit files çağrısı kullanılabiliyor.
  4. Eski iş akışında ZIP girdisi `zip: true`, ZIP içindeki ana modelin adı ise `pathInZip` alanıyla belirtiliyor.

Bu rehberde ne öğreneceksiniz?

Revit Cloud Worksharing üzerinden yayımlanan bir dosyanın neden bazen tek bir RVT yerine ZIP olarak indirildiğini ve bu tasarımın Automation API iş akışına nasıl aktarılacağını adım adım inceleyeceğiz. Temel ayrım, modelin birleşik tasarım olup olmadığıdır: host dosyasıyla birlikte bağlı RVT modelleri de pakette bulunabilir. Bu nedenle otomasyon görevi hazırlanırken yalnızca dosya uzantısına bakmak yeterli olmaz; dosya sürümünün API yanıtındaki bilgileri de kontrol etmek gerekir.

Rehber, Autodesk Platform Services belgelerinde tarif edilen API alanları ve iki ayrı iş akışı üzerinden ilerliyor. Eski ve yeni yöntem arasındaki tarih eşiği 7 Şubat 2025’tir. Buradaki amaç, API çağrılarının bütün kimlik doğrulama ve uygulama kurulum adımlarını anlatmak değil; elinizdeki model bilgisini yorumlayıp doğru girdi biçimini seçmektir.

Gereksinimler

  • Revit Cloud Worksharing projesine ve dosya bilgilerini okuyabileceğiniz Autodesk Platform Services API erişimine sahip olun. Kaynaklardaki örnek, proje ve dosya sürümü bilgilerini API çağrılarıyla inceliyor.

  • Automation API ile çalışmak için kaynaklarda belirtilen etkin Forge deneme sürümü veya abonelik koşulunu göz önünde bulundurun. İlgili kaynakta fiyatlandırma ayrıntıları için ayrı bir sayfaya yönlendirme var; burada güncel fiyat belirtilmiyor.

  • İşleyeceğiniz modelin yayımlanma tarihini ve dosya sürümü yanıtındaki attributes.extension ile attributes.data alanlarını kontrol edebilin.

  • Bu iş akışı için Revit masaüstü kurulumunun şart olduğu sonucuna varmayın: Autodesk’in Revit Automation API açıklaması, Revit veritabanı API’sine masaüstü Revit kurulumu olmadan erişimden söz ediyor. Ancak bu, API erişimi veya gerekli proje girdileri olmadığı anlamına gelmez.

  • Kaynaklarda belirli bir Revit sürüm numarası, güncel abonelik fiyatı ya da baştan sona kimlik doğrulama kurulumu verilmediğinden bu bilgiler burada varsayılmıyor.

    Adım adım: tasarımı tanıma ve göreve hazırlama

    1. Dosyanın Revit Cloud Worksharing modelini temsil edip etmediğini doğrulayın. Proje içeriği, dosya öğesi veya sürümler için yapılan API çağrılarının yanıtında attributes.extension.type alanını inceleyin. Değer versions:autodesk.bim360:C4RModel ise kaynak, bu dosyanın Revit Cloud Worksharing modeli olduğunu belirtiyor. Bu kontrol, birleşik tasarım bilgisini doğru bağlamda yorumlamak için ilk adımdır.

    2. Birleşik tasarım bayrağını okuyun. Aynı sürüm yanıtında attributes.data.isCompositeDesign alanını bulun. Değer true olduğunda model birleşik tasarım olarak işaretlenir; indirme, host modeli ve bağlı RVT dosyalarını içeren bir ZIP paketi olabilir. Değer false ise kaynak, host ve bağlı dosyaların son sürümleri yayımlandığında tek bir RVT dosyası alınacağını belirtiyor.

    3. Ana modelin adını belirleyin. Birleşik tasarımda attributes.data.compositeParentFile alanı host Revit dosyasının adını verir. Bu değer, özellikle ZIP içindeki ana modeli seçmeniz gereken eski iş akışında kullanılır. Alanın içeriğini dosya adı olarak değerlendirin; API’den gelen değerin yerine kendi tahmininizi koymayın.

    4. Yayımlanma tarihini 7 Şubat 2025 eşiğine göre değerlendirin. Kaynakta, bu tarihten önce yayımlanmış modeller için eski yöntemin; bu tarihte veya sonrasında yayımlananlar için yeni yöntemin kullanılması anlatılıyor. Kararı dosyanın attributes.createTime değeri üzerinden verin. Tarihi kontrol etmeden bütün modeller için aynı girdi biçimini uygulamak, iş öğesinin beklediği dosyayla gerçek girdinin uyuşmamasına yol açabilir.

    5. Eski iş akışında ZIP girdisini tanımlayın. Dosya 7 Şubat 2025’ten önce yayımlanmışsa ve birleşik tasarım içeriyorsa, iş öğesinin inputFile ayarlarında zip değerini true yapın. pathInZip alanına ise compositeParentFile içindeki host dosya adını verin. Böylece görev ZIP paketini girdi olarak alırken içinden hangi RVT dosyasının işleneceği de belirtilir. Kaynak, bu yöntemi örnek bir DXF dışa aktarma görevi üzerinden gösteriyor; buradaki mantık, seçilen etkinliğin girdi beklentisine göre uygulanmalı.

    6. Yeni iş akışında host ve bağlı dosyaları birlikte alın. 7 Şubat 2025 ve sonrasında yayımlanan dosyalar için GET linked Revit files çağrısı, host model ile yayımlanmamış bağlı RVT dosyalarını döndürebilir. Yanıtta host dosyası ve linkedFiles sonuçlarını kontrol edin; model adlarını, sürüm bilgilerini ve yayımlanma durumlarını gözden geçirin. Ardından bu çağrının sağladığı imzalı URL’leri iş öğesinin girdilerine aktarın. Kaynağın örneği host için Published, bağlı dosya için NotPublished durumunu gösteriyor; bu durumlar, host ile bağlı dosyanın aynı yayımlanma durumunda olmayabileceğini anlamaya yardımcı olur.

    7. Görevi çalıştırmadan önce girdi yapısını doğrulayın. Eski yöntemde ZIP ve ZIP içindeki host adı; yeni yöntemde ise GET linked Revit files yanıtındaki host ve bağlı dosya adresleri kullanılır. Bu iki yaklaşımı tek bir yapıymış gibi karıştırmayın. İş öğesinin etkinliğinin beklediği girdilerle API’den alınan dosyaların eşleştiğini kontrol edin.

    Sık yapılan hatalar

    Bir ZIP indirilmesini dosyanın bozuk olduğu şeklinde yorumlamak, yayımlanmamış bağlı modellerin bulunduğu durumlarda yanıltıcı olabilir. Önce isCompositeDesign alanını ve host adını inceleyin. Diğer bir hata, isCompositeDesign değerini kontrol etmeden her dosya için zip: true kullanmaktır; birleşik olmayan modelde bu ayar beklenen tek RVT girdisiyle uyuşmayabilir.

    Yayımlanma tarihi de gözden kaçırılmamalı. Kaynağa göre 7 Şubat 2025 öncesindeki dosyalar eski yöntemle, eşik tarih ve sonrasındakiler ise GET linked Revit files yaklaşımıyla ele alınıyor. Son olarak, compositeParentFile değerinin yerine rastgele bir dosya adı yazmayın ve yeni yöntemde yalnızca host modeli alıp bağlı dosyaları atlamayın.

    Mimarlık ve görselleştirme iş akışına etkisi

    Bu ayrım, Revit verisini bulutta otomatik dışa aktaran, inceleyen veya raporlayan ekipler için önem taşıyor. Bir projedeki bağlı modellerin tümü aynı anda yayımlanmamış olabilir; bu nedenle tek RVT bekleyen bir otomasyon, bileşik girdiyi doğru ele almadığında eksik veriyle çalışabilir. Model bilgilerini önceden kontrol etmek, otomasyonun doğru dosya kümesini işlemesine yardımcı olur.

    Mimarlık ofisleri ve BIM ekipleri için asıl dikkat noktası donanım değil, API erişimi, abonelik koşulu ve dosya girdisinin doğru yapılandırılmasıdır. Görselleştirme ekipleri ise dışa aktarma veya model analizi gibi tekrarlanan işlerde bu akıştan yararlanabilir; ancak kaynaklar belirli bir render yazılımı uyumluluğu, işlem süresi ya da maliyet bilgisi vermiyor. Üretim hattına geçmeden önce kullanılan etkinlik ve dosya yapısıyla küçük bir doğrulama çalışması yapmak yerinde olur.

    Sonraki adımlar

    Autodesk’in Revit API geliştirici kaynaklarında başlangıç kılavuzları, kod örnekleri ve topluluk desteği listeleniyor. Önce dosya sürümü yanıtından model türü, birleşik tasarım bayrağı ve host adı değerlerini doğrulayın. Ardından yayımlanma tarihine uygun yöntemi seçip iş öğesinin girdisini test edin. İş akışını genişletirken kaynaklarda belirtilen Revit verisini çıkarma ve değiştirme, otomatik raporlama ve dokümantasyon üretme gibi kullanım alanlarını değerlendirebilirsiniz.

    Kaynak ve lisans

    Bu rehber Autodesk Platform Services’in Revit API genel bakışı, Automation API duyurusu ve birleşik Revit tasarımlarını işleme kılavuzu temel alınarak hazırlanmıştır. Üç kaynak da açık erişimlidir (lisans=serbest); içerik Türkçe olarak uyarlanmıştır.

    Sık sorulan sorular

    Revit Automation API’de bir dosyanın birleşik tasarım olduğu nasıl anlaşılır?

    Dosya sürümünün `attributes.data.isCompositeDesign` alanını kontrol edin. Değer `true` ise tasarım birleşik olarak işaretlenir ve indirme host ile bağlı RVT dosyalarını içeren bir ZIP olabilir.

    Revit bağlı modellerini Automation API’ye aktarmak için hangi yöntem kullanılır?

    7 Şubat 2025 ve sonrasında yayımlanan dosyalar için GET linked Revit files çağrısı host ve bağlı dosyaları sağlayabilir. Bu yanıttaki imzalı URL’ler iş öğesi girdilerine aktarılır.

    Revit Automation API için Revit masaüstü kurulumu gerekiyor mu?

    Autodesk’in Revit Automation API açıklamasına göre Revit veritabanı API’sine masaüstü Revit kurulumu olmadan erişilebiliyor. Kaynaklarda API erişimi ve abonelik koşulları ayrıca belirtiliyor.

    Kaynaklar

    3 kaynak
    A
    aps.autodesk.comaps.autodesk.com/developer/overview/revit
    Özet
    A
    aps.autodesk.comaps.autodesk.com/blog/design-automation-api-revit-inventor-3ds-max-now-available
    Özet
    A
    aps.autodesk.comaps.autodesk.com/blog/make-composite-revit-design-work-revit-automation-api
    Özet

    Kaynak metinler yeniden yayımlanmaz; kısa alıntılar tırnak içinde verilir, geri kalanı özgün özet ve yorumdur.

    3dsınıfı yorumu
    3dEditörün değerlendirmesi

    Türkiye’deki ofisler için bu yaklaşımın en pratik katkısı, bağlı modellerin yayımlanma durumundan kaynaklanan beklenmedik ZIP girdilerini otomasyon başlamadan fark ettirmesi. Özellikle düzenli dışa aktarma ve model analizi yapan ekiplerde, doğru girdi biçimini seçmek yeniden deneme ve elle dosya ayıklama ihtiyacını azaltabilir.

    Yatırım kararında öncelik güçlü donanımdan önce API erişimi, abonelik koşulları ve mevcut iş akışının uyumudur. Kaynaklar güncel fiyatı ve işlem maliyetini vermediği için ofislerin kendi kullanım senaryolarını küçük bir testle değerlendirmesi gerekir. Öğrenciler için de bu, bağlı Revit modellerinin bulut otomasyonuna nasıl taşındığını öğrenmek adına yararlı bir örnek; fakat belirli yazılım sürümü uyumluluğu ayrıca doğrulanmalı.

    Bu habere tepkin ne?

    Yorumlar 0

    İlk yorumu sen yazKendi test sonuçlarını ya da sorunu paylaş.
    +

    İlgili haberler