Ana içeriğe geç

Giriş

"Entegrasyonlar" modülü, API'leri ve çevrimiçi hizmetleri görsel programlama ile kolayca birleştirmenizi sağlar. Modül, uygulamalarınızın mantığını görsel olarak oluştururken düğüm bloklarını sürükleyip birleştirebileceğiniz kullanıcı dostu bir arayüz sunar. Bu, geliştirmeyi basitleştirir ve profesyonel bir programcı olmayanlar için bile erişilebilir hale getirir ve farklı sistemlerin entegrasyon sürecini önemli ölçüde hızlandırır:

Entegrasyonlar Modülünün Temel Arayüz Elemanları​

İlk akışlarınızı ve entegrasyonlarınızı oluşturmaya başlamadan önce, arayüzü anlamaya çalışalım. Temel elemanların nasıl çalıştığını anlamak, işinizi kolaylaştıracak ve daha hızlı adapte olmanıza yardımcı olacaktır.

1. Düğüm Paneli​

Sol panel, tüm mevcut düğümleri bulacağınız yerdir. Bu, veri akışlarınızı oluşturacağınız elemanlardır.

Bir düğümü kullanmak için, sadece onu çalışma alanına sürükleyin. Tüm düğümlerin kendi işlevleri vardır ve bireysel olarak ayarlanabilir.

Düğüm Örnekleri:

  • Inject: Verileri akışa manuel olarak göndermenizi sağlar.
  • Debug: Verileri ve mesajları hata ayıklama menüsüne gönderir.
  • Function: JavaScript'te özel kod yazmanıza olanak tanır.
  • Template: Metin veya HTML şablonları oluşturmak için kullanılır.

2. Sekmeler​

Sekmeler, çalışma alanının üzerinde yer alır ve farklı projeler veya veri akışları arasında geçiş yapmanıza olanak tanır. Bu, birden fazla entegrasyon üzerinde çalışıyorsanız veya mantığı birkaç akışa ayırmak istiyorsanız kullanışlıdır.

  • Yeni Sekmeler Oluşturma: Yeni bir sekme eklemek için + simgesine tıklayın. Her yeni sekme, ayrı bir veri akışını temsil eder ve projenizi daha iyi organize etmenize yardımcı olur.
  • Sekmeleri Yeniden Adlandırma: Bir sekmeyi yeniden adlandırmak için, adının üzerine çift tıklayın ve yeni bir isim girin. Bu, birçok sekmeniz olduğunda ve her birinin ne içerdiğini net bir şekilde anlamak istediğinizde özellikle faydalıdır.
  • Sekmeleri Silme: Artık ihtiyacınız olmayan bir sekmeyi silebilirsiniz. Ancak, önemli verileri kaybetmemek için dikkatli olun.

Örnek: Ödeme entegrasyonu üzerinde çalışıyorsanız, her hizmet için ayrı sekmeler oluşturabilirsiniz.

3. Çalışma Alanı​

Çalışma alanı, veri akışlarınızı oluşturduğunuz ve düzenlediğiniz arayüzün merkezi kısmıdır.

  • Düğüm Yerleştirme: Sol panelden bir düğümü sürüklediğinizde, çalışma alanında görünür. Burada onu hareket ettirebilir, diğer düğümlerle birleştirebilir ve akışınızın mantığını oluşturabilirsiniz.
  • Düğüm Bağlama: Düğüm bağlamak için, bir düğümün çıkışından diğerinin girişine bir çizgi sürükleyin. Böylece veriler bir düğümden diğerine akışta iletilecektir.
  • Akışları Yönetme: Çalışma alanı, karmaşık entegrasyonları ve mantığı organize etmeye yardımcı olan birden fazla veri akışı oluşturmanıza olanak tanır.

İpucu: Çalışma alanını, akışınızdaki tüm detayları görmek için fare veya dokunmatik panel ile yakınlaştırabilirsiniz.

4. Düğüm Düzenleme Formu​

Çalışma alanında bir düğüme çift tıkladığınızda, düğüm düzenleme formu açılır. Bu, düğümün davranışını ayarladığınız bir penceredir.

  • Ayar Alanları: Her düğümün düzenleyebileceğiniz kendi parametreleri vardır. Örneğin, Function düğümünde kod yazabilir ve düzenleyebilirsiniz.
  • Değişiklikleri Kaydetme: Düğümü düzenledikten sonra, değişiklikleri kaydetmek için Submit butonuna tıklayın.

Örnek: Function düğümünde, verileri dönüştüren JavaScript kodu yazabilirsiniz. Template düğümünde, dinamik olarak verileri yerleştiren bir şablon oluşturabilirsiniz.

5. Hata Ayıklama Paneli​

Hata ayıklama paneli sağda yer alır ve Debug düğümünden gelen çıkış verilerini ve mesajları görüntülemek için kullanılır.

  • Mesajları Görüntüleme: Veri akışını başlattığınızda, Debug düğümü mesajları Hata Ayıklama menüsüne gönderir. Bu, akışınızda neler olduğunu görmenize ve verilerin doğruluğunu kontrol etmenize yardımcı olur.
  • Mesajları Filtreleme: Sadece ihtiyaç duyduğunuz verileri görmek için mesajları filtreleyebilirsiniz. Bu, farklı Debug düğümlerinden gelen çok sayıda çıkış veriniz olduğunda kullanışlıdır.
  • Hata Ayıklama Penceresini Temizleme: Eski mesajları silmek ve yeni verilere odaklanmak için temizleme butonunu kullanın.

Örnek: Hesaplamalar yapmak için Function düğümünü kullanıyorsanız, verilerinizi doğru bir şekilde işleyip işlemediğini kontrol etmek için akışın sonuna bir Debug düğümü ekleyin.

6. Kontrol Butonları​

Tam Ekran Açma Butonu​

  • Bu buton, Entegrasyonlar modülünün arayüzünü tam ekran açmanızı sağlar; bu, karmaşık veri akışları üzerinde çalışırken veya projeyi büyük bir ekranda gösterirken faydalıdır.
  • Bu butona tıkladığınızda, düzenleme için daha fazla alan elde eder ve akışlarınızın tüm detaylarını daha iyi görebilirsiniz.

Yayınlama Butonu​

  • Bu, veri akışlarınızdaki tüm değişiklikleri kaydeden ve dağıtan ana butondur, böylece aktif hale gelirler. Düğüm eklediğiniz veya değiştirdiğinizde, ayarlarınızın çalışmaya başlaması için bu butona tıklamayı unutmayın.

İçe Aktarma Butonu​

  • Bu buton, mevcut bir şemayı JSON'dan veya listeden bir örnekten içe aktarmanızı sağlar. Daha fazla bilgi için İçe Aktarma bölümüne bakabilirsiniz.

Girdi Şeması ve Düğümler Arasında Şema Aktarımı​

Düğüm düzenleme formundaki her düğüm, akıştaki bir önceki düğümden gelen verilerin Girdi Şeması bloğunu gösterir. Şema, nesnelerin iç içe geçişini dikkate alarak "anahtar - tür" çiftleri şeklinde mevcut alanları gösterir.

Eğer alan açıklaması Swagger'dan alınmışsa, anahtarın yanında görüntülenecektir. Bu açıklamalar, Mustache şablonları yazarken kod editörü (Monaco) tarafından otomatik tamamlama ve ipuçları olarak da kullanılmaktadır.

Hangi Düğümler Şemayı Bir Sonraki Düğüme Aktarır​

Tüm düğümler şemayı aktaramaz. Bunu yapabilen düğümlerin listesi:

  • Function — şema, Çıktı Örneği (JSON) alanından oluşturulur. Bu alan, gerçek Function kodu çalıştırılmadan akışı çağırırken sahte veriler olarak da kullanılır.
  • Admin API — şema, Swagger'daki metod açıklamasından alınır. Execute butonuna tıkladığınızda, şema gerçek API yanıtı ile güncellenir. Swagger açıklamasıyla örtüşen alanlar, metin açıklamalarını korur.
  • Http Request — başlangıçta şema yoktur. Execute butonuna tıkladıktan sonra gerçek yanıttan alınarak şema oluşur.

Execute Butonu​

Admin API ve Http Request düğümleri, düzenleme formunda Execute butonunu destekler. Bu, akışın başlangıcından mevcut düğüme kadar tüm düğüm zincirini çalıştırır.

Özellikler:

  • Sunucu, son Publish durumuna göre akışı çalıştırır — test etmeden önce akışın yayımlandığından emin olun.
  • Eğer function düğümü yolda verileri iletmiyorsa ancak Çıktı Örneği (JSON) doldurulmuşsa, bu değer sahte veriler olarak kullanılır.
  • Başarılı bir yanıt alındığında, sonuç bir sonraki düğüme şema olarak iletilir.
  • Hata durumunda, şema bir sonraki düğüme iletilmez.

Salt Okunur Düğümlerin Otomatik Çağrılması​

Sadece okuma (GET) istekleri yapan tüm admin-api düğümleri, Entegrasyonlar sayfası açıldığında ve akışı Publish butonu ile güncellediğinizde otomatik olarak çağrılır. Bu, her zaman güncel bir veri şemasına sahip olmanızı sağlar ve manuel başlatma gerektirmez.