Revit Automation API’de bağlı modelleri işleme: adım adım rehber

Bu rehberde ne öğreneceksiniz?

Revit modelini bulut tabanlı bir otomasyon işine bağlarken karşılaşılan sorunlardan biri, beklenen tek RVT dosyası yerine bir ZIP paketi indirilmesidir. Bu durum her zaman indirme hatası anlamına gelmez: Autodesk’in rehberine göre, Revit Cloud Worksharing modelindeki bağlı dosyalar ana modelle aynı güncel yayımlama durumunda değilse indirme paketi ana RVT’yi ve bağlı RVT dosyalarını birlikte içerebilir.

Bu rehberde modelin Revit Cloud Worksharing dosyası olup olmadığını, bileşik tasarım olarak işaretlenip işaretlenmediğini ve hangi otomasyon yönteminin seçileceğini belirleyeceksiniz. Ayrıca yayımlanma tarihi 7 Şubat 2025’ten önce olan dosyalarla bu tarihte veya sonrasında yayımlanan dosyalar arasındaki iş akışı farkını ele alacağız.

Autodesk, Revit API’nin tekrarlanan görevleri otomatikleştirmek ve Revit işlevlerini genişletmek için kullanılabildiğini belirtiyor. Revit Automation API ise Revit verilerini oluşturma, inceleme ve değiştirme gibi işlemleri bulut tabanlı uygulama ve servislerle yürütmeye imkân tanıyor. Bu örnekte odak, Revit dosyasını doğru biçimde otomasyon iş öğesine aktarmak.

Gereksinimler ve hazırlık

İş akışı için Autodesk Platform Services (APS) API’leriyle çalışabilen bir uygulama, dosya ve sürüm bilgilerini sorgulama olanağı, ayrıca iş öğesine aktarılacak model dosyaları gerekir. Autodesk’in API sayfasında geliştirici kılavuzları, SDK’lar, örnek kodlar ve topluluk desteği kaynakları listeleniyor. Revit Automation API, Revit masaüstü kurulumuna ihtiyaç duymadan Revit DB API’sine erişebilen bulut tabanlı uygulamalar oluşturmayı destekliyor.

Kaynaklardaki eski Automation API duyurusunda geçerli Forge aboneliği veya deneme hesabından söz ediliyor. Bu bilgi güncel ücret ya da erişim koşullarını doğrulamıyor; fiyatlandırma ve hesap gereksinimlerini uygulamaya başlamadan önce APS’nin güncel kaynaklarından kontrol edin. Belgelerde bu işlem için belirli bir Revit sürümü de belirtilmiyor.

Başlamadan önce şunları hazır bulundurun:

• İşlenecek Revit Cloud Worksharing modelinin APS üzerindeki dosya veya sürüm kaydı.

• Kimlik doğrulaması yapılmış API çağrıları için gereken erişim bilgileri.

• Yayımlanma tarihini ve dosya sürümüne ait öznitelikleri kontrol edebileceğiniz bir araç.

• Modelin hangi tarihte yayımlandığını ve ana dosyanın adını gösteren kayıt bilgileri.

Adım adım: model türünü ve aktarım yolunu belirleyin

1. Dosyanın Revit Cloud Worksharing modelini tanıyıp tanımadığını kontrol edin. Autodesk’in rehberi, proje klasörünün içeriğini, öğe kaydını veya sürüm bilgisini döndüren API çağrılarında attributes.extension.type alanına bakılmasını öneriyor. Bu alandaki değer versions:autodesk.bim360:C4RModel ise dosya Revit Cloud Worksharing modeli olarak tanımlanıyor. Sadece dosya uzantısına bakarak karar vermek yerine sürüm verisini inceleyin.

2. Bileşik tasarım durumunu okuyun. Aynı sürüm kaydındaki attributes.data.isCompositeDesign alanı, modelin bileşik olup olmadığını gösterir. Değer true ise dosya bileşik Revit tasarımıdır; indirilen içerik ZIP olabilir ve paket ana modelle bağlantılı RVT’leri barındırabilir. Değer false ise Autodesk’in açıklamasına göre ana dosya ve bağlantıları son sürümleriyle yayımlanmıştır ve indirme tek bir RVT olarak alınabilir.

3. Ana model dosya adını belirleyin. Bileşik modelde attributes.data.compositeParentFile alanı ana Revit dosyasının adını verir. Bu bilgi, özellikle eski iş akışında ZIP içinden hangi dosyanın ana model olarak kullanılacağını belirtmek için gereklidir. Ana dosyanın adını tahmin etmeyin; sürüm kaydındaki değeri esas alın.

4. Yayımlanma tarihine göre yöntemi seçin. Dosya 7 Şubat 2025’ten önce yayımlandıysa Autodesk’in eski yöntemi kullanılabilir: iş öğesindeki giriş dosyası için zip değerini true yapın, pathInZip değerine de ana model dosya adını verin. Böylece otomasyon işine ZIP paketi aktarılırken Revit’in açacağı ana dosyanın yolu belirtilmiş olur.

5. 7 Şubat 2025 ve sonrasında yayımlanan model için yeni yöntemi izleyin. Bu tarihte veya sonrasında yayımlanmış bir dosyada Autodesk, GET linked Revit files çağrısıyla ana modeli ve yayımlanmamış bağlı RVT dosyalarını almayı öneriyor. Çağrının döndürdüğü ana model ve bağlantılı dosya bilgilerini iş öğesine aktarın. Eski ZIP yaklaşımını doğrudan uygulamak yerine bu tarihe göre belirlenen yöntemi kullanın.

6. İş öğesinin girdilerini doğrulayın. Eski yöntem seçildiyse ZIP ayarının ve pathInZip değerinin doğru olduğundan emin olun. Yeni yöntemde ise ana modelle birlikte çağrıdan dönen bağlı dosyaların da aktarıldığını kontrol edin. Autodesk örneğinde bu dosyalar için imzalı URL’ler kullanılıyor; URL’leri örnek metinden kopyalamak yerine kendi API çağrınızın yanıtındaki güncel değerleri kullanın.

Sık yapılan hatalar

• ZIP’i otomatik olarak bozuk dosya saymak: Bağlı modellerin güncel sürümleri yayımlanmamışsa ZIP alınması beklenen durum olabilir.

• Model türünü ve bileşik durumu karıştırmak: C4RModel değeri dosyanın Cloud Worksharing türünü tanımlar; isCompositeDesign ise tasarımın bileşik olup olmadığını gösterir. İki kontrolü birlikte yapın.

• Ana RVT’yi varsayımla seçmek: ZIP içindeki doğru dosya adını compositeParentFile alanından alın.

• Tarih ayrımını gözden kaçırmak: 7 Şubat 2025 öncesi ve sonrası yayımlanan dosyalar için rehber farklı aktarım yolları tarif ediyor.

• Örnekteki geçici erişim bağlantılarını kullanmak: Kaynaktaki imzalı URL’ler örnek yanıtın parçalarıdır. Kendi çağrınızdan gelen bağlantıları kullanın.

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

Bu yaklaşım, tekrar eden model inceleme, veri çıkarma, raporlama veya otomatik dokümantasyon adımlarını Revit tabanlı bulut iş akışlarına bağlayan ekipler için önem taşıyor. Autodesk’in belirttiği kullanım alanları arasında Revit verisini inceleme ve analiz etme, veriyi dışarı aktarma, özel Revit aileleri oluşturma ve dokümantasyonu otomatik üretme yer alıyor. Mimarlık ofisleri, iç mimarlık ekipleri ve BIM yöneticileri özellikle bağlantılı modellerin sürüm durumunu otomasyondan önce kontrol ederek yanlış veya eksik girdi riskini azaltabilir.

Görselleştirme ekipleri için de modelin ana dosya ve bağlantılarının birlikte aktarılması, otomasyonun beklenen proje verisiyle çalışmasını sağlar. Ancak bu rehber render performansı, donanım gereksinimi veya belirli bir görselleştirme yazılımıyla uyumluluk hakkında bilgi vermiyor. Uygulama öncesinde API erişim koşullarını, lisans durumunu ve kullanılan iş akışının Revit verileriyle uyumluluğunu doğrulayın.

Sonraki adımlar

İlk denemeyi kritik olmayan bir model üzerinde yapın. Dosyanın sürüm özniteliklerini kaydedin, yayımlanma tarihini doğrulayın ve tarih koşuluna uygun yöntemi seçin. Otomasyon çıktısında beklenen ana RVT’nin işlendiğini kontrol edin. Daha sonra Autodesk’in Revit API kılavuzlarına, başlangıç eğitimlerine ve kod örneklerine başvurarak iş akışını kendi veri çıkarma veya raporlama ihtiyacınıza uyarlayın.

Kaynak ve lisans

Bu rehber, Autodesk’in Revit Automation API ve Revit API sayfaları ile bileşik Revit tasarımlarını otomasyon iş öğelerine aktarmayı anlatan geliştirici yazısı temel alınarak Türkçeye uyarlanmıştır. Kaynakların tamamı Autodesk’in resmî geliştirici içerikleridir ve açık lisans kapsamında sunulmuştur.