Görev Nedir?

API Integration modülünde, her bir sistem ya da uygulama ile yapılan entegrasyon işlemine görev (task) denilmektedir.

Apinizer, entegrasyonları mümkün mertebe API çağrımları ile yapmayı benimsediğinden API ile çağrılabilecek endpointlerin her biri için bir görev/bağlantı tipi tanımlamayı benimsememiştir.

Bu yüzden Apinizer üzerinde 14 farklı görev bulunmaktadır:


Görev seçiminin yapıldığı ekranın görseline aşağıda yer verilmiştir:


Görevlerdeki Ortak Alanlar

Görev oluşturulurken her tip için aynı olan bazı girdi ve çıktı alanları vardır. Bu bilgiler aşağıdaki görselde seçili alanlardır. 


Görevlerdeki ortak bilgilerin konfigürasyonu için kullanılan alanlar aşağıdaki tabloda görülmektedir.

AlanAçıklama

Bu Görevi Çalıştır

(Execute This Task For)

Bir önceki görevden üretilen sonucun, mevcut görev içinde nasıl çalıştırılacağı tipi seçilir. 

  • Bir Kere (Once): Mevcut görev bir kere çalıştırılır.
  • Döngü (Loop): Mevcut görev önceki görevden aldığı sonuç üzerinde belirtilecek olan tanımlama ile döngü şeklinde çalıştırılır. Bu yüzden, önceki görevin sonucuna ait veri tipi bir dizi (array) olmalıdır. Dizinin uzunluğu ne kadar ise mevcut görevde o kadar çalıştırılır.

()

Bu seçenek, görev çalışma tipi Döngü olarak seçildiyse aktifleşir.

Apinizer Söz Dizimi 

Bu alandaki kritik nokta değerin Apinizer'ın söz dizimine uygun yazılmasıdır. Bu kuralda dikkat edilmesi gereken 2 unsur vardır.

Söz Dizimi 1: Veriyi sorgulama

Söz dizilimi kuralları;

  • 2 tane süslü parantez ile açılıp kapanmalıdır.
  • Söz diziminin ilk bölümünde önceki görevin output anahtar adı verilir. Sonuna # işareti konulur.
  • Söz diziminin ikinci bölümününde output değerinin içinden alınacak değerin, veri tipine ait sorgulama diliyle (JSONPath, XPath) yazılmasıdır. 

Söz diziliminin formülüne bakalım;

{{onceki-görevin-output-adi#<bu-kısım-ya-JSONPath-ya-da-Xpath-formatında-yazılır>}}

  • Önceki görevlerden birinde centralRates adında bir sonuç üretilmektedir. Sonucun değerleri Merkez Bankasına ait kur bilgilerini içermektedir.
  • Bu sonucun içerdiği dizideki elemanları tek tek almak için XPath ile /Date/Currency sorgusu yazılmıştır.

{{centralRates#/Date/Currency}}

Söz Dizimi 2: Döngüdeki veriyi görev içinde kullanma

Söz dizimi ile veriden alınan elemanlar, görev içinde (mail gönderirken, veri tabanı ile işlem yaparken, script yazarken vs.) kullanılabilir. Kullanabilmek için de LOOP_VARIABLE adındaki değişken anahtarı ile referans verilmelidir.

Söz diziliminin formülüne bakalım;

{{LOOP_VARIABLE#<bu-kısım-ya-JSONPath-ya-da-Xpath-formatında-yazılır>}}

{{LOOP_VARIABLE#/Currency/Name/text()}}

Detaylı örnek kullanımı API Entegratör Senaryoları sayfalarında anlatılmaktadır.

İşlem başarısız olursa devam edin

(If the operation fails, then continue)

Bu seçenek, görev çalışma tipi Döngü olarak seçildiyse aktifleşir.

Döngüdeki eylemler yürütülürken bir hata meydana gelirse, görevin çalışmasına devam etme ya da hemen durdurulması gerektiği işlemi yönetilir.

Çıktı Anahtarları Liste butonu

(Output Keys)

Önceki görevlerde oluşturulan çıktı anahtarının listesi görülür. Böylelikle görev tanımı girdilerinde buradaki çıktı anahtarı kullanabilir. 

Çıktı Anahtarı

(Output Key)

Görev çalıştırıldığında oluşacak olan değerin atanacağı, değişken adı girilir. Bu görevden sonraki görevler, eğer bu görevin çıktısıyla işlem yapmak isterlerse bu alana girilen çıktı anahtarını kullanacaklardır .

  • Çıktı anahtarında boşluk bırakılmamalıdır.
  • Tanımlanan akışta çıktı anahtar isimleri tekil olmalıdır.

Ad

(Name)

Görevin adı yazılır. Bu bilgi, {{taskflow.name}} değişkeninin değeri olarak atanmaktadır. Dolayısıyla diğer girdi alanına bu değişken yazılıp çalıştığında ilgili çıktıda değişkenin değeri gözükecektir. 

Açıklama

(Description)

Görevin açıklaması yazılır.