Tetikleyiciler

Bir tetikleyici, bir şey olduğunda bir görevi başlatır; tıpkı bir zamanlamanın belirli bir zamanda yaptığı gibi:

Zamanlamalar gibi tetikleyiciler de görevin genel sürümünü, tetikleyiciyi oluşturan kullanıcı adına çalıştırır (o kullanıcının kasa erişimi geçerlidir). Bir tetikleyicinin başlattığı çalıştırmalar, çalıştırma sayfalarında Started by altında tetikleyicinin adını gösterir.

#Görevdeki olay

Olayın ayrıntıları göreve trigger girdisi olarak, bir record şeklinde ulaşır. Kullanmak için bu girdiyi tanımlayın:

input --name:trigger --type:record --required:false
log --message:"New file: $trigger.Path$"

Bir postanın Id değeri mail komutuyla kullanılabilir; örneğin eklerini kaydetmek için:

input --name:trigger --type:record --required:false
mail --action:saveattachments --server:imap.company.com --credential:$mailbox$ --id:$trigger.Id$ --destination:C:\In\$trigger.Id$

Tetikleyici, görevin diğer girdilerine de sabit değerler verebilir (tetikleyici formunda INPUTS altında).

#Tetikleyici oluşturma

Triggers sayfasını açın (Manage triggers yetkisi, varsayılan olarak Developer) ve New trigger'a tıklayın. Görevi neyin başlatacağını seçin, ardından doldurun:

#File tetikleyicileri

Yeni bir dosya tamamlandığında gönderilir: açılabildiğinde ve boyutu artık büyümediğinde. Böylece büyük bir kopyalama görevi yarıda başlatmaz. Henüz var olmayan bir klasör her 30 saniyede bir yeniden aranır; bu arada tetikleyici sorunu gösterir.

#Mail tetikleyicileri

Koşula uyan her okunmamış posta görevi bir kez başlatır ve okundu olarak işaretlenir. Postalar en eskiden başlayarak, her denetimde en fazla 20 tane alınır. Oturum açma sorunları tetikleyicide gösterilir (her denetimde değil, bir kez).

#Webhook tetikleyicileri

Bir webhook tetikleyicisi oluşturulduğunda Botream, adresini ve bir token değerini bir kez gösterir. Diğer sistemler onu POST ile çağırır:

curl -X POST "https://rpa-server/api/hooks/12" \
  -H "X-Botream-Token: <token>" \
  -H "Content-Type: application/json" \
  -d "{\"orderNo\": \"A-17\"}"

• Token, X-Botream-Token başlığında veya adreste ?token= olarak gönderilir. Yanlış veya eksik token, tetikleyici yokmuş gibi 404 döndürür.
• Yanıt 202 ve {"status": "Started", "executionId": "1042"} ya da hiçbir ajan boş değilse "Queued" olur; kapatılmış bir tetikleyici 409 döndürür.
• Tetikleyici menüsündeki New token token'ı değiştirir; eskisi hemen çalışmaz olur.
• Adres oturum açma gerektirmez. Onu yalnızca çağıracak sistemlerle, tercihen HTTPS üzerinden paylaşın.

#Hotkey tetikleyicileri

Key combination alanına tıklayın ve tuşlara basın, örneğin Ctrl+Shift+F9. Bir kombinasyon Ctrl, Alt, Shift veya Win içermelidir; F tuşları, Pause ve Print Screen tek başına kullanılabilir. Bir ajanın iki hotkey tetikleyicisi aynı kombinasyonu paylaşamaz ve başka bir programın tuttuğu bir kombinasyon reddedilir (tetikleyici nedenini gösterir).

Hotkey'ler, ajan makinesinde biri oturum açmışken ve Botream Agent tepsi uygulaması çalışırken çalışır.

#Ajan meşgul olduğunda

Bir ajan aynı anda bir görev çalıştırır. Boş ajan bulamayan bir olay sunucuda bekler ve tetikleyici, bekleyen olay sayısıyla birlikte Waiting for an agent gösterir. Sunucu birkaç saniyede bir, en eski olaydan başlayarak yeniden dener. Olaylar en fazla bir saat (ve tetikleyici başına en fazla 1.000 olay) bekler; sonra bırakılır ve tetikleyici bunu belirtir.

Bir ajanın sunucuya ulaşamadığı sırada fark ettiği olaylar ajanda bekler ve bağlantı yeniden kurulduğunda gönderilir (en fazla bir saat).

#Triggers sayfası

Her tetikleyici neyi dinlediğini, ajanı, Last event durumunu (çalıştırmaya bağlantıyla Started, Waiting for an agent veya üzerine gelindiğinde nedeniyle Problem), kaç çalıştırma başlattığını ve bir Active anahtarını gösterir. Tetikleyicileri oluşturmak, değiştirmek, silmek ve token yenilemek denetim kaydına yazılır.