Lunex, farklı sistemler arasında veri alışverişini tasarlamak, çalıştırmak ve izlemek için kullanılan bir entegrasyon platformudur. Bir API’den gelen siparişi doğrulayabilir, mesajı dönüştürebilir, bir kuyruğa aktarabilir ve hedef sisteme ulaşıp ulaşmadığını izleyebilirsiniz. Akışın kaynak dosyaları, API sözleşmesi, bağlantı ayarları ve dağıtım tanımları bir proje içinde birlikte yönetilir.
Bu kılavuz; entegrasyon geliştiricileri, uygulama işletim ekipleri ve platform yöneticileri içindir. Ekrandaki İngilizce düğme ve alan adları aynen kullanılır; açıklamalar Türkçedir.
İlk kez kullanıyorsanız
Kısa kavram özeti ile mesaj, body ve akış adımlarını tanıyın. Bu kavramları biliyorsanız doğrudan ilk entegrasyona geçebilirsiniz.
Ardından ilk entegrasyonunuz ile boş bir proje oluşturun, bir mesaj çalıştırın ve aynı mesajı Monitor’da bulun. Bütün adımlar ve başarı kontrolleri tek rehberdedir; dış servis veya veritabanı hazırlamanız gerekmez. JSON türleri ve değişken kapsamları gibi ayrıntılar, ihtiyaç duyduğunuzda açabileceğiniz mesaj ve veri başvurusundadır.
Sonra ekranları ve çalışma düzenini tanıyın; hedefinize göre ilk API, simülasyon veya veritabanı bağlantısı ile devam edin.
Rolünüze göre okuma yolu
| Rolünüz | Önce okuyun |
|---|---|
| Entegrasyon geliştiricisi | Temel kavramlar → İlk entegrasyon → Projeler → Akış geliştirme → API yönetimi → Git |
| İşletim ve destek | Message Monitor → Hata inceleme → Kuyruklar → Sorun giderme |
| Platform yöneticisi | Mimari → Kurulum → Kimlik → Kaynaklar |
Yapmak istediğiniz işten başlayın
| İhtiyacınız | Rehber |
|---|---|
| Mesajın ne olduğunu, body ve değişkenlerin nerede tutulduğunu anlamak | Temel kavramlar: mesaj ve veriyle çalışma |
| Projenin ne olduğunu, neyi izole ettiğini anlamak | Proje kavramı, mimari |
| Kendi Git depomuzu bağlamak; değişiklikleri sürümlemek | Git bağlantısı ve günlük kullanım |
| CPU ve RAM ayarlamak; uygulamayı çalıştırmak | Kaynaklar, çalıştırma ve dağıtım |
| Dev’de denediğim kodu commit edip paketlemek; üretimde yeni sürümü çalıştırmak | Geliştirmeden üretime |
| Run sonrası pod, pod olayları ve logu okumak | Deployment ve Log |
| Architecture grafiğini ve flow’un işlem sırasını anlamak | Architecture ekranı, akış sırası |
| Mesajı dönüştürmek, koşullu yönlendirmek, yeniden kullanılabilir adım hazırlamak | Akış geliştirme, bileşenler |
| Split, Choice, Filter, Aggregate veya Loop kullanmak | Temel EIP’ler |
| Sağ paneli, Simple ifadelerini ve Groovy script’lerini öğrenmek | Sağ panel, dil seçimi |
| REST servisinin nasıl çalıştığını ve isteğin nereye gittiğini anlamak | REST ve HTTP temelleri |
| API oluşturmak; operation’ı bir route’a bağlamak | API oluşturma, operation ve route |
| Gövdeli bir API’yi doğru ve hatalı girdilerle uçtan uca denemek | Uygulamalı sipariş API’si |
| OpenAPI sözleşmesini içe almak, paylaşmak ve destek sınırlarını öğrenmek | OpenAPI desteği |
| Hazır API projesini indirip değiştirerek öğrenmek | Üç örnek proje, ortak hata modeli |
| İstek/yanıt yapısını ve doğrulama kurallarını tanımlamak | Şemalar ve doğrulama |
| API erişimini korumak ve yayın adresini açmak | API güvenliği, yayınlama ve test |
| İş numarasıyla mesaj bulmak veya yeni arama alanı eklemek | Application ID, arama alanları |
| Hatanın hangi adımda oluştuğunu görmek | Çalıştırmayı inceleme, hata yönetimi |
| Mesajı kuyrukta saklamak, birikme ve başarısız teslimatı yönetmek | Artemis ve mesajlaşma, kuyruk yönetimi, dead letter’lar |
| Dış servise, veritabanına veya SAP sistemine bağlanmak | Bağlantılar, SAP bağlantısı |
| Siparişleri veritabanına kaydetmek, okumak ve hata halinde geri almak | Veritabanı rehberi |
| Kullanıcıları, Keycloak’u veya kurumsal OIDC girişini ayarlamak | Kimlik ve yetkiler |
| Platformu kurmak ve ortak ayarlarını yönetmek | Kurulum, yönetim |
Bir siparişin yaşam döngüsü
Örneğin bir mağaza sistemi siparişini HTTP üzerinden gönderir. Lunex’teki API işlemi gelen mesajı bir route’a iletir. Route, gerekli alanları doğrular, hedef sistemin beklediği yapıya dönüştürür ve mesajı doğrudan hedefe ya da bir kuyruğa gönderir. İş numarası Application ID olarak kaydedilirse işletim ekibi aynı siparişi Message Monitor’da bulabilir.
Bu örnekte API, route ve kuyruk farklı sorumluluklar taşır: API çağrı sözleşmesini, route işleme adımlarını, kuyruk bekleyen mesajları yönetir. Kavramlar sözlüğü bu terimleri birlikte açıklar.
Kılavuzu kullanma
Soldaki konu başlığına tıklayarak sayfasını açın; yanındaki ok ile alt başlıkları
genişletin. Klavyede yukarı/aşağı oklarla konular arasında, sağ/sol oklarla alt
başlıklarda gezinin; Enter ile sayfayı açın. Yardımda ara alanında Git,
Application ID veya veritabanına bağlanamıyorum gibi bir ifade kullanın.
Arama sonuçlarının altında konunun bulunduğu bölüm görünür. Bu sayfada
bağlantıları makalenin ilgili bölümüne götürür. Dar ekranlarda konu listesini
üstteki menü düğmesinden açın.
Kod örneklerini kopyalama düğmesiyle alabilirsiniz. example.com, örnek kullanıcılar ve örnek iş numaraları açıklama amaçlıdır; kendi ortamınıza göre değiştirin. Ekran görüntülerine tıklayarak tam boyutta açabilirsiniz. Uygulamadaki Account → Help rehberi yeni sekmede açar.