Ajanlar

Ajan, görevlerinizi çalıştıran bir Windows makinesidir: Botream Agent bu makineyi Botream Server'a bağlar, bir çalıştırmanın komutlarını alır ve günlüğü ile sonucu geri bildirir.

#Bir ajan nasıl çalışır

Her makinenin tek bir ajan kimliği vardır. Botream Agent iki bölümden oluşur:

Bir iş istasyonunda tepsi uygulamasından çıktığınızda, uygulama bir sonraki oturum açılışına kadar kapalı kalır. Gözetimsiz bir robot makinesinde ise Windows hizmeti uygulamayı her zaman yeniden başlatır ve Windows, kurulum sırasında seçilen robot hesabıyla otomatik olarak oturum açar.

Ajan her 30 saniyede bir sinyal (heartbeat) gönderir. Bağlantı koparsa kendiliğinden yeniden bağlanır; başarısız her denemeden sonra biraz daha uzun bekler (en fazla bir dakika).

Bir ajan kurmak için Ajanı kurma sayfasına bakın.

#Tepsi uygulaması

Bildirim alanındaki Botream simgesi bağlantı durumunu gösterir:

Menüsünü açmak için simgeye sağ tıklayın. İlk satır geçerli durumu gösterir (örneğin Connected, Running görev adı, Waiting for administrator approval veya Refused: neden). Altında şunlar bulunur:

• Open dashboard: ajanın gösterge paneli penceresini açar (simgeye sol tıklamak da aynı işi yapar).
• View logs: gösterge panelini Logs sekmesinde açar.
• Settings: sunucu adresi, ajan adı ve kayıt belirteci.
• Reconnect: sunucuya hemen yeniden bağlanır.
• Exit: tepsi uygulamasını kapatır.

Ajan onay beklediğinde veya sunucu onu reddettiğinde (örneğin reddedildiği ya da devre dışı bırakıldığı için veya belirteç yanlış olduğunda), Windows nedeniyle birlikte bir kez bildirim gösterir.

#Gösterge paneli penceresi

Overview sekmesi şunları gösterir:

• Reconnect ve Settings düğmeleriyle birlikte bağlantı durumu.
• CURRENT TASK: şu anda çalışan görev ve ne kadar süredir çalıştığı, bir Stop düğmesiyle birlikte. Hiçbir şey çalışmıyorsa Idle — waiting for tasks yazar.
• THIS AGENT: ad, sunucu, makine, IP adresi, Windows sürümü ve ajan sürümü.
• RECENT RUNS: ajan başladığından beri yapılan çalıştırmalar; sonuçları, zamanları ve süreleriyle birlikte. Hatasını görmek için başarısız bir çalıştırmanın üzerine gelin.

#Ajan etkinlik günlüğü

Gösterge panelinin Logs sekmesi, ajanın başladığından beri yaptıklarını listeler: bağlantılar, çalıştırmalar ve bunların günlük satırları. Günlüğü panoya kopyalamak için (örneğin desteğe göndermek üzere) Copy'yi, listeyi boşaltmak için Clear'ı kullanın.

İpucu: Her çalıştırmanın tam günlüğü sunucuda da saklanır. Web uygulamasında Executions bölümünden açın; bkz. Görevleri çalıştırma.

#Ajan ayarları

Settings penceresinde üç alan vardır:

• Server address: Botream Server'ın adresi, örneğin http://rpa-server:3000.
• Agent name: web uygulamasında bir görevin nerede çalışacağını seçerken gösterilir. Her makinenin kendine ait bir adı olmalıdır.
• Registration token: Administration → Agents → Install an agent → Show token bölümündeki paylaşılan gizli anahtar.

Save and connect'e tıklayın. Ajanın Windows hizmeti olarak kurulduğu bir makinede bunlar makine ayarlarıdır: düzenlemek için Change as administrator'a tıklayın. Çalışan tepsi uygulaması değişikliği yeniden başlatma gerektirmeden algılar.

Alanların altındaki Language (Türkçe arayüzde Dil), tepsi uygulamasının dilini belirler (menüsü, pencereleri, ilerleme paneli, iletişim kutuları ve kayıt çubuğu): Automatic (Windows language) (Otomatik (Windows dili)) Türkçe bir Windows'ta Türkçe, diğerlerinde İngilizce gösterir; isterseniz English veya Türkçe seçin. Bu seçim oturum açmış Windows kullanıcısına aittir; bu nedenle makine ayarlarının kullanıldığı bir makinede de her kullanıcı kendi dilini değiştirebilir. Seçim hemen kaydedilir ve tepsi uygulaması bir sonraki başlatılışında kullanılır: tepsi menüsünden Exit (Çıkış) öğesini seçin ve Botream Agent'ı yeniden başlatın. Günlük satırları ve sunucunun bildirdiği nedenler İngilizce kalır.

#Bir çalıştırmayı makinede izleme

Ajanın ekranına bakan herkes bir çalıştırmayı takip edebilir:

• İlerleme penceresi: sağ altta, odağı hiçbir zaman almayan küçük bir pencere. Durumu, görev adını, geçen süreyi, geçerli komutu ve bulunulan satırı (örneğin Line 12 of 40) bir ilerleme çubuğuyla gösterir. Pencereyi başlığından sürükleyebilirsiniz; kapatma düğmesi, görev çalışmaya devam ederken pencereyi gizler.
• Öndeki pencere: her öğe eyleminden önce, eylemin yapıldığı pencere — sayfanın sekmesi seçili tarayıcı ya da masaüstü programı — öne gelir (simge durumundaysa geri getirilir). Arka planda (headless) çalışan tarayıcıların penceresi yoktur., her öğe eyleminden (tıklama, yazma, seçme…) önce bir işaretçi öğeye gider ve eylemin adıyla etiketlenmiş turuncu bir çerçeve (örneğin Click veya Type) öğeyi yaklaşık bir saniye boyunca işaretler.
• Masaüstü eylemleri: her öğe eyleminden önce fare işaretçisi öğeye gider ve turuncu bir çerçeve öğeyi kısa bir süre çevreler.

İlerleme penceresi çalıştırma biter bitmez kapanır. Sonuç, çalıştırmayı başlatan web uygulamasında ve tepsi uygulamasının son çalıştırmalar listesinde görünür.

#Duraklatma, sürdürme ve durdurma

İlerleme penceresinde iki düğme vardır:

• Pause, çalıştırmayı bir sonraki komuttan önce bekletir. Çalışmakta olan komut (örneğin bir bekleme) önce tamamlanır. Ardından düğmede Run yazar: devam etmek için ona tıklayın.
• Stop task çalıştırmayı iptal eder. Çalıştırma Stopped olarak sona erer.

Duraklatma, makineye kısa bir süre ihtiyaç duyduğunuzda veya bir adımı yakından izlemek istediğinizde kullanışlıdır.

#Kayıt ve onay

Bir ajan, geçerli bir kayıt belirteciyle ilk kez bağlandığında kendini kaydeder. Bundan sonra ne olacağı Require approval for new agents ayarına bağlıdır (bkz. Ayarlar):

• Off (varsayılan): yeni ajan hemen görev çalıştırabilir.
• On: ajan Waiting for approval durumunda kaydedilir ve bir yönetici onaylayana kadar hiçbir şey çalıştırmaz. Tepsi uygulaması kehribar renkli bir simgeyle Waiting for administrator approval gösterir.

#Ajanları onaylama ve kullanımdan kaldırma

Yöneticiler ajanları Administration → Agents altında yönetir. Bir başlık kaç ajanın onay beklediğini bildirir ve Agents sekmesi bu sayıyı bir rozetle gösterir.

Tablo her ajanı makine adı ve IP adresi, Status, Groups, Version, Runs (çalıştırma sayısı) ve Last seen ile listeler. Satırdaki Approve düğmesini veya eylemler menüsünü kullanın:

Her onay, reddetme, etkinleştirme ve devre dışı bırakma denetim kaydına işlenir.

Not: Sunucu daha yeni bir ajan yükleyicisi sunduğunda Version sütununda Update to sürüm gösterilir. Kurulu ajanlar, Ayarlar bölümünde Update agents automatically kapalı olmadığı sürece, hiçbir görev çalışmıyorken kendilerini günceller. Bkz. Yükseltme ve yedekleme.

#Ajan durumları

Gösterge paneli, her ajan için aynı canlı durumu, meşgul olduğu çalıştırmaya giden bir bağlantıyla birlikte gösterir.

#Ajan grupları

Bir grup, bir zamanlamanın birkaç ajandan hangisi boştaysa onda çalışmasını sağlar. Administration → Agents → Groups'u açın ve New group'a tıklayın:

• Name, örneğin Finance robots.
• Description: bu ajanların ne için kullanıldığı.
• Agents: üyeler. Bir ajan birden fazla gruba ait olabilir.

Bir grubu hedefleyen zamanlama, grubun ilk boştaki, çevrimiçi ve onaylı üyesinde çalışır. Zamanlamalar hâlâ bir grubu kullanırken o grubu silemezsiniz; bir grubu silmek hiçbir zaman ajanlarını kaldırmaz. Bkz. Zamanlamalar.

#Aynı anda tek çalıştırma

Bir ajan aynı anda tek bir çalıştırma yürütür. Meşgul bir ajanda başlatılan bir çalıştırma, Agent 'FINANCE-PC-01' is already running a task gibi bir mesajla reddedilir.

Bir ajan çalıştırma sırasında bağlantısını kaybederse, sunucu o çalıştırmayı Failed olarak işaretler. Ajanın bir iş kuyruğundan aldığı iş öğeleri kuyruğa geri döner.

#Bir çalıştırma ajanını nasıl seçer

Çalıştırmalar kuyruğa alınmaz: uygun bir ajan boşta olmadığında, elle başlatılan bir çalıştırma reddedilir (örneğin All online agents are busy) ve zamanlanmış bir çalıştırma Skipped olarak kaydedilip bir sonraki zamanında yeniden denenir.