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 kolaylaştırır ve profesyonel bir programcı olmayanlar için bile erişilebilir hale getirir, ayrıca farklı sistemlerin entegrasyon sürecini önemli ölçüde hızlandırır:

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

Kendi ilk 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 kendine özgü bir amacı 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 Sekme Oluşturma: Yeni bir sekme eklemek için + butonuna 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: 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: Sekmeye sağ tıklayın ve açılan menüden Delete seçeneğini seçin. Önemli verileri kaybetmemek için dikkatli olun.
• Sekmeleri Devre Dışı Bırakma: Aynı açılır menüde Disable seçeneği, sekmenin akışını silmeden devre dışı bırakır. Devre dışı bırakılan sekmenin seçeneği Enable olarak adlandırılır — bu, akışı geri açar. JSON şemasında bu durum, sekmenin disabled alanında saklanır.

Ö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 bağlayabilir 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 hat 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ı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 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 veri ekleyen 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ını görüntülemek için kullanılır. Panelde iki sekme vardır: Debug — akış mesajları ve Configuration.

• Mesajları Görüntüleme: Veri akışını başlattığınızda, Debug düğümü mesajları Debug sekmesine gönderir. Bu, akışınızda neler olduğunu görmenize ve verilerin doğruluğunu kontrol etmenize yardımcı olur.
• Mesajları Filtreleme: Mesajların üstündeki liste, hangi mesajların gösterileceğini değiştirir: all nodes — tüm düğümlerden, current workflow — yalnızca mevcut sekmedeki düğümlerden. Bu, farklı Debug düğümlerinden gelen çok sayıda çıkış veriniz olduğunda kullanışlıdır.
• Debug Penceresini Temizleme: Eski mesajları silmek ve yeni verilere odaklanmak için filtre yanındaki çarpı simgesine tıklayın.

Örnek: Function düğümünü hesaplamalar yapmak için kullanıyorsanız, akışın sonunda verilerinizi doğru bir şekilde işleyip işlemediğini kontrol etmek için 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 kazanır 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 listedeki bir örnekten içe aktarmanızı sağlar. Daha fazla bilgi için İçe Aktarma bölümüne göz atabilirsiniz.

---

Girdi Şeması ve Düğümler Arasında Şemanın Aktarılması

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

Eğer alanın açıklaması API açıklamasında varsa, anahtarın yanında görüntülenecektir. Bu açıklamalar, Mustache şablonları yazarken kod editörü 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, Output Example (JSON) alanından oluşturulur. Bu alan, gerçek Function kodu çalıştırılmadan akışı çağırırken test verisi olarak da kullanılır.
• Admin API — şema, API açıklamasındaki metodun açıklamasından alınır. Execute butonuna tıkladığınızda, şema gerçek API yanıtı ile güncellenir. API açıklamasıyla örtüşen alanlar, metin açıklamalarını korur.
• Http Request — başlangıçta şema yoktur. Şema, Execute butonuna tıkladıktan sonra gerçek yanıt alınarak ortaya çıkar.

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ü, yol boyunca verileri iletmiyorsa ancak Output Example (JSON) alanı doldurulmuşsa, bu değer test verisi 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 butonuyla güncellendiğinde otomatik olarak çağrılır. Bu, her zaman güncel veri şemasına sahip olmanızı sağlar ve manuel başlatma gerektirmez.