WEX Bileşeni Nedir?

WEX; üçüncü parti sunuculara veri gönderen ve veri alan güvenli bir veri değişim katmanıdır. WEX katmanı üzerinde çalışan REST, Web Servis veya EDI ile geliştirilmiş olan componentlere WEX bileşeni denir.

Yol: Kontrol Paneli > System > Dev Tools > Wex

WEX üzerinde çalışabilen coldfusion componentleri ve coldfusion sayfaları WEX'in bileşenlerini oluşturur. Bir WEX bileşeni teknik olarak iki modda çalışarak gelen verileri işler ve sonuçlar üretir.

Component modu

İlk mod bir coldfusion componenti olarak çalışmayı hedefler. Bu modda hedeflenen yöntem birden fazla fonksiyoneliteyi bir arada kullanmaktır. Bilindiği gibi her WEX bir eşsiz isimle çağrılır. Bu çağrı bir bileşen için yapılandırılmış ise ardından fonksiyon adı da eklenerek ilgili fonksiyona dallanmayı sağlar. Böylece tek WEX kaydı üzerinden birden fazla fonksiyon çalışmış olur.

Document modu

İkinci mod bir coldfusion page üzerinde yapılan WEX kaydını kapsar. Coldfusion page tüm requesti ve response kendi üzerinde yürütülebilir. Ancak birden fazla fonksiyon için uygun değildir. Eğer gelen veri aşırı kompleks ve/veya çıktı olarak doküman (html vb) döndürmek gerekiyor ise direkt request ve response işlemek gerekebilir. Bu durumda coldfusion page kullanmak pratik bir çözüm olabilir.

WEX Oluşturma

WEX bileşeni kaydetmek için Dev Tools modülüne girerek WEX başlığından ilerlemek yeterlidir. Listeleme sayfasında mevcut WEX'ler yer alır. "+" butonuyla yeni WEX'ler yaratılabilir. 

Aşağıdaki ekranda bir WEX bileşeni olarak çalışan Wutabakat (Mutabakat) vardır. Wutabakat; cari hesap mutabakatı yapmak üzere ilgili cari hesaba borç-alacak sonucu gönderen, geri bildirim alan ve bu geri bildirime göre işlemler yapan bir eklentidir ve WEX bileşeni olarak çalışır.

WEX kaydı yapılırken özellikle dikkat edilmesi gereken alanlar

• Type: WEX'in işlem yönünü belirler. Bir WEX veri alarak işlem yapmayı mı hedeflemekte yoksa başka bir sisteme WEX'den veri göndermeyi mi hedeflemekte, import ya da export seçimi yapılır.
• Rest Name: WEX'in eşsiz çağrı ismidir. Bu isim ile WEX url formatında çağrılar yapar.
• Authentication: Yetkilendirme seviyesini sağlar. Public ve Private olmak üzere iki seviye vardır. Public seviyesinde şifresiz WEX erişimi sağlanır. Private ise veri gönderilen sunucuya domain, IP, kullanıcı adı ve şifresi ile bağlanır. Ek olarak abone yönetimine bağlı olarak erişim sağlanabilir. 
• Time Plan: On Demand, her çağrı karşılığında çalışması sağlanan servisler için uygundur. Periodic seçeneği WEX in belirli periodlarla dış bir sisteme bağlanarak veri iletişimini sağlar (iki yönlü çalışır).
• File Path: WEX endpoint dosyasının sanal dosya yolunu belirtir (Workcube ana dizininden itibaren)

Diğer alanlar WO kaydı ile aynı şekilde yapılmaktadır. WO ile ilgili detaylı bilgi edinmek için "WO - Workcube Objects nedir?" dokümanımızı inceleyebilirsiniz. 

Dikkat!: Lucee alt yapısında çalışan sistemlerde WEX üzerinden veri çekerken URL sonunda "/" olması gerekir. Slash olmadığı takdirde WEX tetiklenmez. (wex.cfm/, wex/ vb.) Wex fonksiyonlarında verilen linklerde "/" konulması unutulmamalıdır.