Kısaca
- APS Automation Service, Revit’in başsız bir sürümüne erişim sağlıyor.
- Bulutta çalıştırılacak eklentilerde kullanıcı arayüzüne bağlı referansların kaldırılması gerekiyor.
- Hazırlık adımı C# kodunda değişiklik gerektiriyor; C# deneyimi olmayanlar hazır DeleteWalls.dll ile Task 2’den başlayabiliyor.
- HTTP istekleri, resmî walkthrough’a göre cURL ya da Postman koleksiyonuyla gönderilebiliyor.
Autodesk’in APS Design Automation API v3 belgeleri, Revit eklentilerini Automation Service üzerinde çalıştırmak isteyen geliştiriciler için adım adım bir walkthrough sunuyor. Bu rehber, mevcut bir eklentiyi bulut ortamında çalışacak hâle getirmeye ve gerekli HTTP isteklerini Postman ya da cURL ile izlemeye odaklanıyor. APS, Revit’in başsız bir sürümünü bulutta sunuyor ve Revit DB API’ye erişim sağlıyor. Böylece model verisi oluşturma, inceleme ve değiştirme gibi işler masaüstü Revit kurulumu olmadan yürütülebiliyor.
Başlamadan önce kapsamı belirleyin
Otomatikleştirilecek işi tanımlayın. Autodesk, Automation API ile Revit verisi üreten, çıkaran ve değiştiren bulut uygulamaları geliştirilebildiğini belirtiyor. Belgelerde özel Revit aileleri oluşturma, model kurulumunu otomatikleştirme, model verisini analiz etme, rapor hazırlama, mevcut modelleri şirket standartlarına göre değiştirme ve dokümantasyon oluşturma örnekleri yer alıyor. Önce eklentinin bu işlerden hangisini yapacağı belirlenmeli.
Walkthrough’un sınırlarını dikkate alın. Bu doküman, Revit eklentisini baştan yazma sürecini değil, mevcut bir eklentiyi Automation Service’te çalıştırma akışını anlatıyor. Eklenti geliştirmeye yönelik ayrı kaynak olarak Autodesk’in Revit Developer Center’ına yönlendiriyor. Geliştirme ile bulutta çalıştırma aşamalarını ayrı ele almak, rehberdeki adımları doğru yorumlamayı kolaylaştırır.
Masaüstü arayüzünün kullanılacağını varsaymayın. Automation Service’te kullanıcı etkileşimi desteklenmiyor. Dolayısıyla Revit arayüzüyle iletişim kuran kısımları bulunan bir eklentinin buluta alınmadan önce bu bağımlılıklardan arındırılması gerekiyor. Eklentinin kullanıcıdan seçim veya onay beklediği adımlar varsa, bunların otomasyon ortamında nasıl ele alınacağı ayrıca düşünülmeli. Resmî walkthrough’un açıkça belirttiği temel hazırlık koşulu, arayüz referanslarının çıkarılması.
Revit eklentisini Automation API’ye hazırlayın
Arayüz referanslarını kaldırın. Walkthrough’un ilk görevi, Revit eklentisini Automation API ile çalışmaya uygun hâle getirmek. Bu işlem C# kodunda değişiklik yapılmasını ve kullanıcı arayüzüne yönelik referansların temizlenmesini gerektiriyor. Servis kullanıcı etkileşimine izin vermediğinden, arayüze bağlı işlevleri olduğu gibi bırakmak eklentinin çalışma biçimiyle bulut ortamının sınırlarını uyuşmaz hâle getirebilir.
C# yeterliliğine göre ilerleme yolunu seçin. C# bilgisi olan geliştiriciler, walkthrough’un ilk görevindeki hazırlık adımlarını izleyebilir. Bu aşamada mevcut eklentinin arayüzle ilişkili kısımları ayıklanarak buluttaki çalıştırma düzenine uyarlanır. Rehber genel bir eklenti geliştirme eğitimi vermediğinden, burada belgelerde bulunmayan kod örnekleri veya uygulama ayrıntıları eklenmiyor.
Hazır örnekten yararlanın. C# konusunda deneyimi olmayanlar, Autodesk’in sunduğu
DeleteWalls.dlldosyasını indirerek ilk görevi atlayıp Task 2’den devam edebilir. Bu, servis üzerinde eklenti çalıştırma adımlarını örnek bir dosyayla takip etme olanağı verir. Ancak hazır DLL’nin bulunması, farklı bir eklentinin de değişiklik yapılmadan çalışacağı anlamına gelmez; her eklentinin arayüz bağımlılıkları ayrıca değerlendirilmelidir.
İstekleri Postman veya cURL ile gönderin
Walkthrough’daki görev sırasını izleyin. Rehber, Automation Service üzerinde eklenti çalıştırma sürecinde kullanılan HTTP isteklerini açıklıyor. Postman tercih edenler, Autodesk’in bağlantısını verdiği APS tutorial koleksiyonunu içe aktarabilir. Koleksiyondaki istekler görevlere göre gruplandırılmış; istek adları da walkthrough’daki adımlarla eşleştirilmiş. Diğer seçenek ise aynı istekleri cURL üzerinden göndermek.
Task 1’in koleksiyonda bulunmadığını unutmayın. Eklentiyi hazırlama görevi Visual Studio’da yapılıyor ve APS’ye HTTP isteği göndermiyor. Bu nedenle Postman koleksiyonunda Task 1 için bir grup bulunmuyor. Eklenti hazırlığı tamamlandıktan sonra koleksiyondaki ilgili görevlerle devam edilebilir.
Görev ve istek adlarını karşılaştırın. Koleksiyondaki gruplar ve istekler walkthrough’daki adımlarla aynı adları taşıdığı için, her isteğin süreçteki yerini takip etmek mümkün. Önce eklentinin hazırlık aşamasının tamamlandığını doğrulayın, ardından belgede verilen sırayla ilerleyin. Kaynak walkthrough’da açıklanmayan kimlik doğrulama, dosya yükleme veya çalıştırma parametreleri için bu rehbere ek komutlar eklenmiyor.
Mimarlık ve görselleştirme iş akışlarına etkisi
Revit’te yinelenen model işlemlerini, standart kontrollerini veya rapor üretimini otomatikleştirmek isteyen mimarlık ve iç mimarlık ofisleri, eklentilerini bulutta çalıştırma seçeneğini değerlendirebilir. Autodesk’in açıklamasına göre Automation API, Revit DB API üzerinden model verisi oluşturma, çıkarma ve değiştirme iş akışlarına erişim sağlıyor. Bu, tekrarlı görevleri masaüstü kullanımından ayırmak isteyen ekipler için anlamlı olabilir. Ancak kaynaklar işlem süresi, kapasite, ücret veya performans konusunda sayısal bilgi vermiyor.
Archviz ekipleri model verisini inceleme ve otomatik işleme tarafındaki olası kullanım alanlarına bakabilir; fakat walkthrough belirli render motorlarının uyumluluğunu ya da render ayarlarını açıklamıyor. Bu nedenle bulutta Revit eklentisi çalıştırma olanağını, belirli bir görselleştirme aracının desteklendiği şeklinde yorumlamamak gerekir. Belgelerde yerel donanım gereksinimi, lisans ve ücret koşulları da belirtilmiyor. Uygulamaya geçmeden önce bu noktalar ayrıca doğrulanmalı.
Sık yapılan hatalar
Arayüz bağımlılığı olan eklentiyi hazırlıksız çalıştırmak: Automation Service’te kullanıcı etkileşimi bulunmadığından arayüz referansları kaldırılmalı.
Walkthrough’u eklenti geliştirme eğitimi olarak görmek: Rehber, mevcut eklentiyi bulutta çalıştırma sürecini anlatıyor.
Task 1’i Postman koleksiyonunda aramak: Hazırlık Visual Studio’da yapıldığı için bu görev koleksiyonda yer almıyor.
Örnek DLL’yi bütün eklentiler için hazır çözüm saymak:
DeleteWalls.dllbaşlangıç örneği olarak sunuluyor; başka bir eklentinin buluta uygunluğu ayrıca hazırlanmalı.
APS Design Automation API v3 Revit walkthrough’unu izlerken temel sıra; eklentinin arayüz bağımlılıklarını kaldırmak, C# ile hazırlamak veya hazır örnekten başlamak ve ardından HTTP isteklerini Postman ya da cURL ile takip etmektir. Rehberin kapsamı dışındaki uyumluluk, maliyet ve performans ayrıntıları için ayrıca doğrulama yapmak gerekir.
Sık sorulan sorular
Revit eklentisi APS Automation Service’te kullanıcı arayüzü kullanabilir mi?
Hayır. Autodesk’in walkthrough’una göre Automation Service’te kullanıcı etkileşimi mümkün değil. Eklenti çalıştırılmadan önce arayüz referanslarının kaldırılması gerekiyor.
Revit eklentisini APS üzerinden çalıştırmak için C# bilmek şart mı?
Hazırlık görevi C# kodunda değişiklik gerektiriyor. C# deneyimi olmayanlar, Autodesk’in sunduğu DeleteWalls.dll ile Task 2’den başlayabilir.
APS Revit walkthrough’unda Postman koleksiyonu nasıl kullanılıyor?
Koleksiyon, istekleri görevlere göre gruplandırıyor ve adları walkthrough’daki adımlarla eşleştiriyor. Eklentiyi hazırlama işi Visual Studio’da yapıldığından Task 1 koleksiyonda bulunmuyor.
Kaynaklar
2 kaynakKaynak metinler yeniden yayımlanmaz; kısa alıntılar tırnak içinde verilir, geri kalanı özgün özet ve yorumdur.
Türkiye’deki mimarlık ve iç mimarlık ofisleri için bu yaklaşımın pratik değeri, tekrarlanan Revit işlemlerini bulut tabanlı bir akışa taşıma olanağı sunması. Model verisi analizi, standart kontrolü ve raporlama gibi işler için değerlendirilebilir; ancak eklentinin arayüz bağımlılıklarının önceden ayıklanması gerekiyor.
Karar öncesinde lisans ve ücret koşullarını ayrıca araştırmak önemli; resmî belgeler maliyet, kapasite veya donanım gereksinimlerini açıklamıyor. Render uyumluluğu da walkthrough’un kapsamı dışında. Ofislerin önce sınırlı bir iş akışını sınaması ve kullandıkları eklentinin bulut ortamına uygunluğunu doğrulaması yerinde olur.




Yorumlar 0