OData Sender Connector
Ayarlanan zamanlayıcı işiyle (scheduler job) verilere adına göre erişin ve onları işleyin.
Gerekli Connector Özellikleri
- OData Version: OData sürümünün seçimi; uygulamanın ihtiyaçlarına, performans beklentilerine ve mevcut altyapıya bağlıdır. Farklı sürümler farklı özellik kümelerini destekler ve performans iyileştirmeleri sunar. Uygun sürümün seçilmesi; gereksinimlerin karşılanması, performansın artırılması ve gelecekteki güncellemelerle uyumluluğun sağlanması açısından kritik öneme sahiptir.
- OData v2.0: Temel CRUD işlemlerini ve RESTful API'leri destekler.
- OData v3.0: Gelişmiş veri işleme ve sorgulama yetenekleri sağlar.
- OData v4.0: En yeni ve en gelişmiş sorgu seçeneklerini ve performans iyileştirmelerini sunar.
-
HTTP Address: HTTP adresi alanı, OData adaptörü ile entegrasyon için hedeflenen OData servisinin adresini belirtmek üzere kullanılır. Bu adres, erişilecek OData servisinin URL'sini içerir. Örneğin, "http://example.com/odata" gibi bir URL, "example.com" sunucusundaki "odata" adlı bir OData servisine erişmek için kullanılabilir.
-
Authorization Type: İsteği yapan kullanıcının yetkili olup olmadığını belirlemek için kullanılan bir header türüdür. Bu header; isteği yapan tarafın kimliğini sunucuya doğrulamak için bir kullanıcı adı ve parola, bir API anahtarı veya başka kimlik doğrulama bilgileri içerebilir.
-
Authorization Name: Bu değişken, servislerde kullanılmak üzere önceden kaydedilmiş kullanıcı adı ve parola bilgilerini temsil eder. Her Authentication Resource Name, bir kullanıcıya veya uygulamaya ait kimlik doğrulama bilgilerini içerir.
-
Get Entities And Fields: Bu butona tıklandığında, HTTP Address ve Authorization alanlarını kullanarak bir bağlantı kurar ve entity'leri ile field'ları getirir.
-
Resource Path: Gelen verideki entity'lerden birinin seçilmesine olanak tanır ve sonraki işlemler bu seçilen entity içinde gerçekleştirilir.
-
Operation: Operation, veri kaynakları üzerinde belirli eylemler gerçekleştirmek için kullanılır. Bu eylemler genel olarak CRUD (Create, Read, Update, Delete) işlemleri olarak bilinir. OData sürümü v2.0 veya v3.0 olarak seçilirse, işlemler Query, Create, Update, Read, Delete, Patch ve Merge olarak seçilebilir. OData sürümü v4.0 seçilirse, işlemler Query, Create, Update ve Delete olarak seçilebilir.
-
Content Type: OData servisine bağlı olarak ATOM veya JSON content type seçilebilir.
-
Batch Processing: Batch Process özelliğini etkinleştirir. Batch processing (toplu işleme), belirli bir zaman aralığında yüksek hacimli verinin toplu olarak işlenmesini ifade eder. Büyük veri hacimlerini aynı anda işler. Veri boyutu bilinir ve sonludur. Veri birden fazla geçişte işlenir.
-
HTTP Timeout: Bir HTTP isteğinin belirtilen süre içinde yanıt almaması durumunda uygulanan bir zaman sınırını belirtir. Zaman aşımı süresi istek yapan taraf tarafından belirlenir ve genellikle saniye cinsinden ifade edilir.
-
Scheduler Cron: Bu değişken, tanımlanan OData servisinin çalışma aralığını ve sıklığını Cron formatında belirlemeye olanak tanır. Cron, görevleri belirli aralıklarla ya da belirli tarih ve saatlerde çalıştırmak üzere zamanlamak için kullanılır.
OData Version v2.0 veya v3.0 olarak ayarlandığında ve Operation olarak "Read" veya "Query" seçildiğinde.
Veya OData sürümü v4.0 olduğunda ve Operation olarak "Query" seçildiğinde, aşağıdaki alanlar görüntülenir.
-
Use Manual Query: Bu alan seçilirse, sorgunun hazırlanması tamamen kullanıcıya bırakılır. Seçilmezse, sorgu QueryOptions ve diğer alanlar kullanılarak daha kolay ve işlevsel bir şekilde hazırlanabilir.
-
Query Options: "Use Manual Query" alanı seçilirse, kullanıcı bu bölümde OData formatına uygun olarak istediği sorguyu yazabilir ve yazdığı sorgu HTTP isteğinin sonuna eklenir. "Use Manual Query" alanı seçilmezse, bu alan aşağıdaki "Select query fields" bölümünde gösterilen alanlara tıklanarak doldurulabilir.
-
Select Query Fields: Entity'ye ait field'ların bulunduğu yerdir. Burada seçilen her field QueryOptions'a eklenir ve işlemler bu field'lara göre gerçekleştirilir.
-
Skip: Skip değeri, bir OData sorgusunda kayıtları döndürmeye başlamadan önce atlanacak kayıt sayısını belirtir. Sayfalama (pagination) için kullanışlıdır; belirli sayıda kaydı atlamanıza ve sonuçların sonraki sayfalarını getirmenize olanak tanır.
-
Top: Top değeri, bir OData sorgusunda döndürülecek maksimum kayıt sayısını belirtir. Bir sorgu tarafından döndürülen kayıt sayısını sınırlamaya olanak tanır; özellikle büyük veri kümeleriyle çalışırken kullanışlıdır.
-
Count: Bir OData sorgusundaki Count değeri, sorgu kriterleriyle eşleşen toplam kayıt sayısının dahil edilip edilmeyeceğini belirtir. Tek tek kayıtların hepsini getirmeden kayıtların toplam sayısını elde etmek için kullanışlıdır.
-
Value: Bir OData sorgusundaki Value parametresi, ek metadata veya bağlam olmadan yalnızca entity'lerin property değerlerinin döndürülmesini belirtmek için kullanılır. Bu, entity'lerin yalnızca ham property değerlerine ihtiyaç duyduğunuzda ve ek bilgi istemediğinizde özellikle kullanışlıdır.
-
Query Filters - Add Filter: Add Filter butonu, bir sorguya özel bir filtre eklemek için kullanılır. "Filter", belirli koşulları karşılayan kayıtları seçmek için bir OData sorgusunda kullanılan bir parametredir ve sorgulanan veri kümesinin istenen veriyi getirmek üzere belirli kriterlere göre daraltılmasına olanak tanır.
-
Query Filters - Field: Entity'ye ait field'lar burada görüntülenir. Bir field seçip ona bir değer atayarak sorgu buna göre filtrelenir.
-
Query Filters - Filter Method: Burada görüntülenen filtreleme yöntemleri, OData sorgularında veri kümelerini belirli kriterlere göre daraltmak için kullanılır ve çeşitli koşullara göre kayıt seçmek için kullanışlıdır.
-
Query Filters - Value: Filtrelenecek field'ın değerinin belirtildiği alandır. Daha önce seçilen field'ın değeri buraya girilir.
-
Query Sort - Add Sort: Add Sort butonu, bir sorguya özel bir sıralama eklemek için kullanılır. Sort, bir OData sorgusunda döndürülen verinin belirli kriterlere göre sıralanmasına olanak tanır. Bu parametre, döndürülen verinin belirli property'lere göre artan ya da azalan olarak hangi sırada sıralanacağını belirler.
-
Query Sort - Field: Burada seçilen field'a göre sıralama yapılmasına olanak tanır.
-
Query Sort - Sort Method: Sıralamanın nasıl yapılacağını belirtir.
OData Version v2.0 ve v3.0 iken Operation Create, Update, Merge veya Patch seçildiğinde ve OData sürümü v4.0 iken Operation Update seçilirse, aşağıdaki alanlar görünür.
-
Key Value('Entity Key Value'): O entity'ye ait Key Value'yu bulur ve adını '' alanı içine tırnak içinde yazar. Bu noktada, değiştirmek istediğiniz değerin key value'su buraya yazılmalıdır. Örneğin, key value 'Country' ise, buraya Türkiye yazılır.
-
Fields: Select fields alanında seçilen field'lar buraya gelir ve güncellenecek field'ların "" tırnakları içine yeni değer yazılır.
"UserName": "Sam",
"FirstName": "White",
"Age":"25"
- Select Fields: Entity'ye ait field'lar buraya tek tek yazılır. Hangi field'ların güncellenmek istendiği tek tek seçilir. Field'lar seçildikten sonra, en üstteki fields alanına gelir.
Tüm OData sürümlerinde Operation Delete seçilirse, aşağıdaki alan görünür.
- Key Value('Entity Key Value'): O entity'ye ait Key Value'yu bulur ve adını '' alanı içine tırnak içinde yazar. Bu noktada, değiştirmek istediğiniz değerin key value'su buraya yazılmalıdır. Örneğin, key value 'Country' ise, buraya Türkiye yazılır.