Görevleri çalıştırma

Bir görevi düzenleyiciden başlatır, web uygulamasında ve ajanın ekranında canlı olarak takip edersiniz; her çalıştırmayı daha sonra Executions altında günlüğü, çıktıları ve başarısız olduysa nedenine ilişkin ayrıntılarla birlikte bulursunuz.

#Bir çalıştırma başlatma

Görevi düzenleyicide açın ve araç çubuğunda Run'a tıklayın. Görevin adını başlık olarak taşıyan Run iletişim kutusu açılır.

Not: Ajanlar kaydedilmiş görevi çalıştırır. Kaydedilmemiş değişiklikleriniz varsa önce kaydedin (Ctrl+S): düzenleyici size Save your changes first ile hatırlatır.

#Düzenleyici neyi çalıştırır

Düzenleyici, gösterdiği şeyi çalıştırır:

• local çalışma alanınızda çalıştırma, yerel kopyanızı kullanır (iletişim kutusunun başlığı (local copy) ile biter). runtask ile çağrılan görevler de, varsa yerel kopyalarınızı, yoksa genel sürümlerini kullanır.
• public çalışma alanında çalıştırma, geçerli genel sürümü kullanır.

Çalıştırmalar hangisinin çalıştığını kaydeder: geçmişte v3, Local copy of v3 veya Local copy (hiç gönderilmemiş bir görev için) görünür. Zamanlamalar her zaman genel sürümü çalıştırır. Bkz. Sürümler ve çalışma alanları.

#Ajanı seçme

Agent listesi şunları sunar:

• Any available agent (N online): çalıştırma ilk boştaki, çevrimiçi ve onaylı ajana gider.
• Belirli bir ajan. Her ajan durumunu gösterir; çevrimdışı, meşgul veya onaylanmamış (Not approved) ajanlar seçilemez.

Hiçbir ajan çevrimiçi değilken Run devre dışıdır ve iletişim kutusu No agent is online. Start the Botream Agent on a machine first. der. Ajanların nasıl seçildiği için bkz. Ajanlar.

Not: Ajan grupları zamanlamalar tarafından kullanılır. Run iletişim kutusundan başlatılan bir çalıştırma tek bir ajana veya herhangi bir uygun ajana gider.

#Girdileri doldurma

Görev girdiler bildiriyorsa (input --name:... --type:...), iletişim kutusu bunları türleriyle birlikte INPUTS altında listeler. Varsayılan değerler doldurulmuştur; varsayılanı olmayan zorunlu girdiler girilmelidir. Boolean girdiler Yes (true) ve No (false) seçeneklerini sunar.

input --name:invoiceDate --type:datetime --required:true
input --name:maxInvoices --type:number --default:50 --required:false

Başlatmak için Run'a tıklayın.

#Çalışırken

Düzenleyicinin üzerinde önce Starting the task… yazan küçük bir kart, ardından hangi görevin hangi ajanda çalıştığı geçen süreyle birlikte görünür:

• Cancel görevi ajanda durdurur.
• Watch the live log çalıştırma sayfasını açar.

Çalıştırma bittiğinde kart kapanır ve bir bildirim sonucu gösterir. Ajan makinesinde ilerleme penceresi geçerli komutu gösterir ve birinin çalıştırmayı duraklatmasına veya durdurmasına olanak tanır (bkz. Ajanlar).

İpucu: Daha sonraki bir komuttan başlamak için bir bloğun menüsündeki Run from here'ı, kesme noktalarında durmak için Debug'ı kullanın. Bkz. Hata ayıklama.

#Çalıştırma geçmişi

Executions her çalıştırmayı en yeniden başlayarak listeler ve canlı olarak güncellenir. Her satır şunları gösterir:

Listeyi Search tasks (görev adı), durum listesi (Any status) ve ajan listesi (Any agent) ile filtreleyin. Çalıştırmayı açmak için bir satıra tıklayın.

See all runs yetkisine sahip kullanıcılar (varsayılan olarak Admin ve Developer) tüm çalıştırmaları görür; diğer herkes yalnızca kendi başlattığı çalıştırmaları görür.

#Çalıştırma sayfası

Çalıştırma sayfası tek bir çalıştırmayı gösterir:

• Görev adı (Edit tasks yetkisine sahip kullanıcılar için göreve bir bağlantı), durum ve sürüm.
• Agent, Started (veya Waiting for the agent), Duration (çalışırken canlı) ve Started by.
• Inputs: çalıştırmanın aldığı değerler.
• Outputs: görev bittikten sonra görevin output değişkenlerinin değerleri.
• Pause / Resume: çalıştırma sürerken gösterilir. Duraklatılan bir çalıştırma bir sonraki komuttan önce bekler; durumu Paused olarak görünür, görev kendini duraklattıysa nedeniyle birlikte.
• Stop: çalıştırma sürerken gösterilir; çalıştırmayı ajanda durdurur. Çalıştırma Stopped olarak sona erer.

#Görevin içinden durdurma ve duraklatma

runtask'ın yanındaki üç komut, bir görevin çalıştırmaları durdurmasını veya duraklatmasını sağlar:

if --condition:"$orders.Count$ = 0"
    stoptask --message:"No orders today"
endif
pausetask --message:"Check the invoice in the ERP, then press Run" --timeout:600
stoptask --name:"Finance/Import" --output:stopped
pausetask --name:Export
resumetask --name:Export

Başka bir görevin çalıştırmalarını durdurmak, duraklatmak ve devam ettirmek, web uygulamasındaki Pause ve Resume gibi denetim kaydına yazılır.

#Canlı günlük

Görev çalışırken günlük akış hâlinde gelir. Her satır zamanı, düzeyi (DBG, INF, WRN, ERR), görevdeki satır numarasını (komutu görmek için üzerine gelin) ve mesajı gösterir.

• Düzeye göre filtreleyin: All, Info + (bilgi, uyarılar ve hatalar), Warnings, Errors veya Debug.
• Search in log yalnızca eşleşen satırları tutar.
• Follow en yeni satırı görünür tutar. Yukarı kaydırmak bunu duraklatır; sona geri dönmek için Follow'a (veya bitmiş bir çalıştırma için Latest'e) tıklayın.

Günlük, yüz binlerce satırlık çok uzun çalıştırmaları da kaldırır.

Not: Bir kasadan okunan parolalar günlük satırlarında, hata mesajlarında ve çıktılarda *** ile değiştirilir. Hata ayıklama satırları yalnızca Ayarlar bölümünde Keep debug log lines açıkken tutulur.

#Hata ayrıntıları

Hiçbir catch tarafından işlenmeyen bir hata bir çalıştırmayı sonlandırdığında, ajan o anda gördüklerini kaydeder. Çalıştırma sayfası şunları gösterir:

• Line numarası ve başarısız olan command ile birlikte hata mesajı.
• Hata türü: Business rule (görev tarafından throw ile fırlatılır: verileri veya süreci düzeltin, yeniden deneme işe yaramaz) veya System error (uygulama, ağ veya makine başarısız oldu: yeniden deneme işe yarayabilir). Bkz. Hata yönetimi.
• Screen when the task failed: ajanın tüm ekranının (tüm monitörler) bir görüntüsü. Tam boyutta görmek için üzerine tıklayın.
• Variables at the failure: görevin değişkenleri, ağaç biçiminde. Gizli değerler maskelenir, uzun değerler kısaltılır.

Bir runtask çağrısı içinde ayrıntılar, hatanın oluştuğu çağrılan göreve aittir.

#Yapay zekâ ile hata analizi

Başarısız bir çalıştırmada AI failure analysis ne olduğunu, olası nedeni ve nasıl düzeltileceğini açıklayabilir. Analyze with AI'a tıklayın; yanıt çalıştırmayla birlikte saklanır ve Analyze again bir kez daha sorar. Model hatayı, başarısız olan komutu, son günlük satırlarını ve değişkenleri, parolalar hariç tutularak alır; ekran görüntüsünü ise yalnızca bir yönetici izin verdiğinde alır. Bkz. Yapay zekâ özellikleri.

Uyarı: Yapay zekâ yanılabilir. Analize göre harekete geçmeden önce onu kontrol edin.

#Gösterge paneline genel bakış

Dashboard, oturum açtıktan sonraki ilk sayfadır ve canlı olarak güncellenir. Sağ üstten dönemi seçin: 7 days, 14 days veya 30 days.

#Selector health kartı

Kart, son çalıştırmalardaki öğe komutlarına ne olduğunu sayar:

• Steps healed: kendi kendini onarmanın benzer bir öğe kullandığı adımlar.
• Saved by fallbacks: bir yedek konumlayıcının bulduğu adımlar.
• Failures prevented: yalnızca bir öğe onarıldığı veya bir yedek konumlayıcı tarafından bulunduğu için tamamlanan çalıştırmalar.
• Drifting: öğesi yakalamadan bu yana değişmiş seçiciler. Bozulmadan önce onları yeniden yakalayın.
• Broken: öğesi en son çalıştırmalarında bulunamayan seçiciler.
• Healthy: öğesini yakalandığı gibi bulan öğe komutları.

Edit tasks yetkisine sahip kullanıcılar, tam Selector health sayfası için View report'a tıklayabilir. Bkz. Öğeleri güvenilir şekilde bulma.

User rolündeki kullanıcılar gösterge paneli rakamları yerine bir karşılama sayfası görür; bkz. Kullanıcılar ve roller.