İlk entegrasyonunuzu kurmadan önce mesaj, body ve route kavramlarını tanımanız yeterli. Bu kısa rehberde bir değerin akışta nasıl değiştiğini göreceksiniz. Okumak için proje oluşturmanız veya bir dış sisteme bağlanmanız gerekmez.
Mesaj, body ve route
- Mesaj / Message, işlenen veridir. Bir sipariş isteği, dosya içeriği veya kuyruktan gelen kayıt olabilir.
- Body / Gövde, mesajın asıl içeriğidir. İlk örneğimizde
Lunexmetnidir. - Route / Akış, mesajın nereden geldiğini ve hangi adımlardan geçtiğini tanımlar. Adımlar sırayla veriyi okuyabilir, değiştirebilir veya başka bir sisteme gönderebilir.
Akış dosyası işlemlerin tarifidir. Run ile çalışan uygulama bu tarifi gelen her mesaja uygular. Bir dosyayı kaydetmek, mesajı çalıştırmak veya sonucun Monitor’a kaydedilmesi ayrı işlemlerdir.
Bir adım mesajı nasıl değiştirir?
Lunex metninden bir selamlama üreten akışı düşünün:
| Adım | Yaptığı iş | Adımdan sonraki body |
|---|---|---|
Set Body, Constant = Lunex | İlk metni hazırlar. | Lunex |
Set Body, Simple = Merhaba ${body} | O andaki body’yi okuyup önüne selamlama ekler. | Merhaba Lunex |
| Logger | Sonucu çalışma günlüğüne yazar. | Merhaba Lunex |
Set Body, hesapladığı sonucu yeni body olarak kaydeder. Sonraki adım bu yeni değeri okur. Logger ise bu örnekte içeriği değiştirmez.
Constant, yazdığınız değeri aynen kullanır. Simple, ${body} gibi ifadelerle mesajdaki değeri okur. Merhaba ${body} metnini Constant alanına yazarsanız ${body} olduğu gibi kalır. Ekrandaki Language alanı bu seçimi, Expression alanı ise ifadeyi belirtir.
Bu tablo mesajın değişimini anlatır. Uygulamada tam bir akış oluşturmak için sıradaki ilk entegrasyon rehberini kullanın; dosyanın tamamı ve her kontrol adımı oradadır.
Body dışında hangi alanlar var?
Bir siparişin içeriğini değiştirirken sipariş numarasını ayrıca saklamak isteyebilirsiniz. Alanların kısa ayrımı şöyledir:
| Alan | Kullanım amacı | Yazma adımı |
|---|---|---|
| Body | İşlenen asıl içerik. | Set Body |
| Header | Mesaja eşlik eden bilgi; örneğin ülke kodu. | Set Header |
| Exchange property | Aynı işleme ait bilgi; örneğin izleme için iş referansı. | Set Property |
| Variable | Hesaplamanızda daha sonra kullanacağınız ara değer. | Set Variable |
Exchange, mesajın işlenmesi sırasında bu alanları ve hata bilgisini tutan çalışma bağlamıdır; ayrıca oluşturmanız gerekmez. Header, property ve variable birbirinden ayrıdır. Birine değer yazmak diğerini doldurmaz.
İlk entegrasyonda yalnız Set Body ve Set Property kullanacaksınız. İş referansını property’ye yazıp aynı değeri Message Monitor → Application ID ile bulacaksınız. Diğer alanların ayrıntılarını ihtiyaç duyduğunuzda öğrenebilirsiniz.
Şimdi ilk mesajınızı çalıştırın
İlk entegrasyonunuz sizi boş projeden Run, Log ve Message Monitor sonucuna götürür. Dış servis, veritabanı veya API anahtarı gerekmez. Başarı ölçütü, log’daki iş referansı ile Monitor’daki tamamlanmış mesajın eşleşmesidir.
İlk sonucu gördükten sonra mesaj ve veri başvurusunda şu sorulara dönebilirsiniz:
- JSON metni ile nesne arasındaki fark nedir?
- Body, header, property ve variable nasıl okunur?
- Değişkenler ne kadar yaşar; yapılandırma ayarlarından nasıl ayrılır?
- Lunex örneğini simülasyonda adım adım nasıl karşılaştırırım?