# APS Design Automation ile Revit eklentisini bulutta çalıştırma rehberi

Kaynak: https://3dsinifi.com/haber/aps-design-automation-ile-revit-eklentisini-bulutta · Kategori: İpuçları · Yayın: 22 Kasım 2026

> Autodesk’in APS Design Automation API v3 belgeleri, Revit eklentilerinin buluttaki kullanıcı arayüzü olmayan ortamda nasıl çalıştırılacağını anlatıyor. Bu rehber; eklentiyi hazırlama, Postman veya cURL ile istek gönderme ve önemli sınırlara dikkat etme adımlarını açıklıyor.

## Kısaca
- Revit walkthrough’u, mevcut bir eklentiyi Automation Service üzerinde çalıştırmaya odaklanıyor; eklenti geliştirmeyi öğretmiyor.
- Buluttaki Revit ortamında kullanıcı etkileşimi mümkün olmadığı için eklentinin arayüz referanslarının kaldırılması gerekiyor.
- Örnek süreç C# kodunda değişiklik gerektiriyor; C# konusunda deneyimi olmayanlar DeleteWalls.dll örnek eklentisiyle ikinci görevden başlayabiliyor.
- İstekler cURL ile gönderilebiliyor veya walkthrough için hazırlanmış Postman koleksiyonuyla yürütülebiliyor.

Autodesk Platform Services (APS) Design Automation API v3, Revit verilerini bulutta oluşturma, inceleme ve değiştirme iş akışlarına açıyor. Autodesk’in resmi Revit walkthrough’u, mevcut bir Revit eklentisini kullanıcı arayüzü bulunmayan Automation Service ortamında çalıştırmayı gösteriyor. Bu rehber, eklenti geliştirmekten ziyade hazır bir eklentiyi bulut çalıştırmasına hazırlama ve belgedeki istek akışını takip etme üzerine kurulu. Belgeler belirli bir Revit sürüm numarası, donanım gereksinimi veya fiyat vermiyor.

## Hangi işler buluta taşınabilir?

1. **Tekrarlanan işi belirleyin.** Önce Revit dosyalarında hangi işlemin sık tekrarlandığını veya çok sayıda modele uygulanacağını tanımlayın. APS belgeleri, Design Automation API’yi tekrarlayan ya da büyük ölçekli işlem yüklerinin servise aktarılabildiği bir yapı olarak açıklıyor. Revit tarafında örneklenen kullanım alanları; model oluşturma, model verisini inceleme, otomatik rapor üretme, mevcut modelleri şirket standartlarına göre değiştirme ve dokümantasyon hazırlama.

   Bu aşama, eklentinin gerçekten otomasyona uygun olup olmadığını anlamaya yarar. Bir işlem kullanıcı kararına veya ekrandaki bir kontrole dayanıyorsa, onu olduğu gibi bulut ortamına taşımak mümkün olmayabilir. Önce hangi girdilerin ve çıktının beklendiğini netleştirmek, eklentiyi hazırlarken kapsamı kontrol altında tutar.

2. **Var olan Revit eklentisini temel alın.** Walkthrough, eklentinin nasıl yazılacağını anlatmıyor; yalnızca onu Automation Service üzerinde çalıştırma sürecine odaklanıyor. Henüz eklenti yoksa bu rehber tek başına eklenti oluşturma kılavuzu olarak değerlendirilmemeli. Autodesk, eklenti geliştirme bilgisi için Revit Developer Center’a yönlendiriyor.

   Bu ayrım önemli: Bulut çalıştırması, eklenti geliştirme işinin yerine geçmiyor. Ofiste kullanılan bir eklentinin bulutta da çalışacağı varsayılmamalı; arayüz bağımlılıkları ve işlem akışı ayrıca ele alınmalı. İlk denemeyi tek ve açıkça tanımlanmış bir görevle sınırlamak, hangi hazırlıkların gerektiğini görmeyi kolaylaştırır.

## Eklentiyi bulut çalıştırmasına hazırlama

3. **Kullanıcı arayüzü bağımlılıklarını kaldırın.** Autodesk’e göre Automation Service üzerinde kullanıcı etkileşimi mümkün değil. Revit eklentileri genellikle kullanıcı arayüzüyle etkileşim kuracak biçimde tasarlandığından, bulutta çalıştırmadan önce arayüze yönelik tüm referansların eklentiden çıkarılması gerekiyor.

   Bunun nedeni, bulut ortamında bir kullanıcının ekrandaki pencereyi açıp seçim yapamaması veya bir onay düğmesine basamaması. Bu nedenle işlem, kullanıcıdan ara karar beklemeyen bir akışa dönüştürülmeli. Belgede bunun için Task 1, eklentiyi Automation API’ye uygun hâle getirme adımı olarak tanımlanıyor. Arayüz referanslarının kaldırılması da bu hazırlığın bir parçası.

4. **Gerekli kod değişikliğini değerlendirin.** Autodesk’in walkthrough’u, ilk görevde C# kodunun değiştirilmesini istiyor. C# konusunda yeterli deneyim yoksa belgede sunulan `DeleteWalls.dll` adlı Automation API’ye hazır örnek eklentiyle Task 2’den başlanabileceği belirtiliyor. Bu dosyanın adı, örnek eklentiyi tanımlıyor; onu farklı bir Revit işine uygun genel amaçlı araç olarak görmemek gerekir.

   Örneği kullanmak, istek gönderme aşamalarını izlemeye yardımcı olabilir; ancak gerçek projedeki eklentinin arayüz bağımlılıklarını veya işlem mantığını kendiliğinden çözmez. Kendi eklentisine geçildiğinde kod ve eklentinin yaptığı iş ayrıca kontrol edilmelidir. Belgeler belirli bir kod değişikliği listesi veya tüm eklentiler için geçerli bir dönüştürme reçetesi sunmuyor.

## İstekleri gönderme ve iş akışını izleme

5. **Walkthrough’un görev sırasını takip edin.** Revit walkthrough’u, eklentiyi Automation Service üzerinde yürütmek için gereken süreci adımlara ayırıyor. İlk görev yalnızca Visual Studio’da gerçekleştiriliyor; APS’ye istek göndermiyor. Bu nedenle Autodesk’in Postman koleksiyonunda Task 1 için bir grup bulunmuyor.

   Bu ayrıntı, Postman’da ilk görevi arayanların yanlış bir eksiklik izlenimine kapılmasını önler. Önce eklentinin uygun hâle getirilmesi, sonra servisle iletişim adımlarına geçilmesi hedefleniyor. Dokümandaki görev adları ve istek adları birbiriyle eşleştirilmiş; akışı takip ederken bu adlandırma, hangi isteğin hangi aşamaya ait olduğunu anlamaya yardımcı oluyor.

6. **Postman veya cURL kullanın.** Autodesk’in hazırladığı Postman koleksiyonu, walkthrough’da kullanılan HTTP isteklerini bir araya getiriyor. Koleksiyonda istekler görevlere göre gruplandırılmış; Postman kullanmak istemeyenler aynı walkthrough’u cURL ile takip edebiliyor. Postman, HTTP isteklerini göndermek için arayüzlü bir seçenek olarak tanıtılıyor.

   Ekipte istekleri elle göndermeyi tercih edenler cURL’ü, istekleri arayüz üzerinden yürütmeyi isteyenler Postman koleksiyonunu seçebilir. Burada önemli olan, örnek isteğin adını ve ait olduğu görevi birlikte izlemek. Kaynak metin, bu rehberde aktarılabilecek bir Revit sürüm uyumluluk tablosu veya her proje için geçerli istek parametreleri vermiyor; bu yüzden belgede olmayan değerleri varsaymak doğru olmaz.

7. **İşlemi buluttaki Revit ortamında çalıştırın.** APS, Automation API ile bulutta çalışan, kullanıcı arayüzü olmayan bir Revit sürümüne erişim sağlıyor. Belgede Revit DB API’ye masaüstüne Revit kurmadan erişilebildiği belirtiliyor. Bu yapı; model verisini oluşturma, çıkarma ve değiştirme gibi bulut tabanlı uygulama ve servislerin önünü açıyor.

   Bu noktada eklentinin hedeflediği işlemi, kullanılan girdiyi ve elde edilmesi beklenen sonucu proje gereksinimlerine göre kontrol edin. Bu son kontrol, Autodesk’in belirli bir doğrulama komutu sunduğu anlamına gelmiyor; otomasyonun ofis iş akışında güvenle kullanılabilmesi için uygulanabilecek bir proje pratiği. Kaynaklar, sonuçların nasıl indirileceğine ilişkin ayrıntılı bir yöntem veya belirli bir Revit sürümü belirtmiyor.

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

Revit modellerinde tekrar eden kontrol, veri çıkarma, raporlama ya da dokümantasyon adımları bulunan mimarlık ve iç mimarlık ekipleri bu yaklaşımı değerlendirebilir. Özellikle aynı türde işlemlerin birden çok modelde uygulanması, masaüstünde tek tek yürütülen görevlerin bulut otomasyonuna uygun olup olmadığını araştırmak için iyi bir başlangıç noktasıdır. Ancak kaynaklar belirli bir hız artışı veya zaman tasarrufu miktarı vermiyor.

Archviz ekipleri açısından doğrudan bir render özelliği tarif edilmiyor. Revit eklentisinin bulutta çalıştırılmasına odaklanan belgeler; render motoru, görsel kalite ayarı veya ekran kartı gereksinimi belirtmiyor. Bu nedenle kullanım alanını model verisi ve Revit eklenti işlemleriyle sınırlı değerlendirmek gerekir. Lisans ve ücret koşulları da burada açıklanmıyor; bulut iş akışına geçmeden önce ayrıca incelenmeli.

## Sık yapılan hatalar

- Kullanıcı arayüzüyle çalışan bir eklentiyi hiçbir değişiklik yapmadan Automation Service’e taşımak. Belgeler, arayüz referanslarının kaldırılmasını şart koşuyor.
- Walkthrough’u eklenti geliştirme eğitimi sanmak. Rehber, mevcut eklentiyi çalıştırmayı anlatıyor.
- Postman koleksiyonunda Task 1’i aramak. İlk görev Visual Studio’da gerçekleşiyor ve APS isteği göndermiyor.
- `DeleteWalls.dll` örneğini her proje için hazır çözüm olarak kabul etmek. Kaynakta bu, Task 2’den başlamaya yarayan belirli bir örnek eklenti olarak sunuluyor.
- Belgelerde yer almayan Revit sürümü, fiyat, donanım veya istek parametrelerini varsaymak. Bu konular kaynak metinlerde belirtilmiyor.

## Pro ipucu
Önce eklentinin kullanıcı arayüzüne bağlı tüm referanslarını belirleyip kaldırın; Automation Service üzerinde kullanıcı etkileşimi mümkün değildir.

## 3dsınıfı yorumu
Türkiye’deki mimarlık ve iç mimarlık ofisleri için APS Design Automation, özellikle aynı Revit işlemlerini tekrar tekrar yürüten ekiplerin incelemeye değer bulabileceği bir yaklaşım. Ancak asıl emek yalnızca isteği buluta göndermek değil; eklentiyi arayüz bağımlılıklarından arındırmak ve gerçek iş akışında doğru sonuç verdiğini kontrol etmek. Bu nedenle küçük, sınırları belli bir işlemle başlamak daha sağlıklı olur.

Belgelerde fiyat, lisans koşulu, Revit sürümü ve donanım gereksinimi açıklanmıyor; maliyet veya uyumluluk varsayımıyla karar verilmemeli. Ayrıca `DeleteWalls.dll` örneği, her ofisin eklentisinin yerine geçmez. Ekiplerin önce mevcut eklenti ve kod bilgisi ihtiyacını değerlendirmesi, ardından Postman ya da cURL ile resmi walkthrough’u takip etmesi pratik bir başlangıç sağlar.

## Kaynaklar
- [aps.autodesk.com](https://aps.autodesk.com/en/docs/design-automation/v3/developers_guide/overview/) (özet)
- [aps.autodesk.com](https://aps.autodesk.com/en/docs/design-automation/v3/developers_guide/revit/) (özet)

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