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

Kaynak: https://3dsinifi.com/haber/revit-automation-api-ile-bagli-modelleri-iceren-projeleri · Kategori: Eğitimler · Yayın: 22 Kasım 2026

> 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.

## Kısaca
- Bir Revit Cloud Worksharing modelinde birleşik tasarım olup olmadığını `isCompositeDesign` alanından kontrol edin.
- `isCompositeDesign` true ise indirme, ana model ile bağlı RVT dosyalarını içeren bir ZIP paketi olabilir.
- 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.
- 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.

## Pro ipucu
İş öğesini oluşturmadan önce `isCompositeDesign`, `compositeParentFile` ve `attributes.createTime` değerlerini aynı dosya sürümünden kontrol edin.

## 3dsınıfı yorumu
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ı.

## Kaynaklar
- [aps.autodesk.com](https://aps.autodesk.com/developer/overview/revit) (özet)
- [aps.autodesk.com](https://aps.autodesk.com/blog/design-automation-api-revit-inventor-3ds-max-now-available) (özet)
- [aps.autodesk.com](https://aps.autodesk.com/blog/make-composite-revit-design-work-revit-automation-api) (özet)

_Yapay zekâ ile yazıldı, kaynaklarla doğrulandı. © 3dsınıfı_
