Görev düzenleyici

Görev düzenleyici, bir görevi oluşturduğunuz, denetlediğiniz, çalıştırdığınız ve hatalarını ayıkladığınız yerdir: solda komut paleti, ortada blok ya da kod olarak görev, sağda ise seçili komutun özellikleri bulunur.

#Görevler ve klasörler

Otomasyonlarınızı görmek için Tasks sayfasını açın. Üstteki anahtar çalışma alanını seçer:

Çekme, yayınlama ve klonlama için Sürümler ve çalışma alanları sayfasına bakın.

• Soldaki FOLDERS görevleri düzenler. Başlığın yanındaki New folder düğmesi seçili klasörün içinde bir klasör oluşturur; bir klasörün menüsünde New subfolder, Rename ve Delete bulunur (yalnızca boş bir klasör silinebilir). All tasks tüm görevleri gösterir.
• New task bir Name, bir Description ve bir Folder ister. Yeni görevler yerel çalışma alanınızda başlar ve düzenleyicide açılır.
• Bir görevin menüsünde (⋯) çalışma alanı eylemleri, Edit details ve Delete bulunur. Edit details ayrıca görevin performans ayarlarını ve Self-healing seçimini (When an element is not found) içerir; bkz. Elementleri bulma.
• Bir görevi düzenleyicide açmak için üzerine tıklayın.

Not: Görevleri yalnızca Edit tasks yetkisine sahip kullanıcılar (varsayılan olarak Developer) oluşturup değiştirebilir. Genel sürüm düzenleyicide salt okunurdur; değiştirmek için görevi çekin.

#Düzenleyici yerleşimi

Panellerin kenarlarını sürükleyerek boyutlarını değiştirebilirsiniz. Ortadaki anahtarın altındaki satır, geçerli görünümün temel kısayollarını gösterir.

#Araç çubuğu

• Adın yanındaki çalışma alanı etiketleri neye baktığınızı belirtir: Public · v4 ve Read-only, Local · pulled from v4, Local · never pushed veya Local clone of v4. Pulled by, genel bir görevin kilidini kimin tuttuğunu gösterir.
• Bir düzenlemeden sonra Unsaved changes görünür; Not pushed, kaydedilmiş yerel kopyanızın genel sürümden farklı olduğu anlamına gelir.
• No problems, Problems veya To complete doğrulama durumunu özetler. Listeyi görmek için üzerine tıklayın; ilgili bloğa (sözdizimi hatalarında koda) gitmek için bir girdiye tıklayın.
• Undo ve Redo (Ctrl+Z, Ctrl+Y veya Ctrl+Shift+Z).
• Record, Chrome'da ve Windows programlarında yaptıklarınızı kaydeder; bkz. Kayıt. AI Task Generator bir açıklamadan komutlar yazar; bkz. Yapay zekâ özellikleri.
• History sürüm geçmişini açar, yanındaki karşılaştırma düğmesi sürümleri karşılaştırır; bkz. Sürümler ve çalışma alanları.
• Yanlarındaki dokümantasyon düğmesi görevin dokümantasyonunu açar (teknik açıklama, geliştirici notları, oluşturulan özet, PDF); bkz. Görev dokümantasyonu.
• Run görevi bir ajan üzerinde başlatır, Debug ise hata ayıklayıcıyla başlatır (Debug tasks yetkisi); bkz. Görevleri çalıştırma ve Hata ayıklama.
• Save (Ctrl+S) yerel kopyanızı kaydeder. Push onu bir sonraki genel sürüm olarak yayınlar.

Not: Kaydedilmemiş değişiklikleriniz varken Run ve Debug devre dışıdır: ajanlar kaydedilmiş yerel kopyayı (veya genel sürümü) çalıştırır, asla yalnızca tarayıcınızda bulunanı çalıştırmaz.

#Komut paleti

COMMANDS sekmesi tüm komutları gruplar halinde listeler (Variables, Condition, Loop, Flow Control, Error Handling, Wait & Delay, Messages & Logs, Web, Desktop, Data, Files & Folders, Email & API, Scripts & Programs, AI). Aynı anda tek bir grup açık olur; bir komutun ne yaptığını okumak için fareyle üzerine gelin.

• Search commands ada ve açıklamaya göre filtreler ve eşleşme içeren tüm grupları açar.
• Bir komutu seçili bloğun ardına eklemek için üzerine tıklayın (seçili bir bölüm varsa onun içine, hiçbir şey seçili değilse sona eklenir).
• Bir komutu tam istediğiniz yere bırakmak için sürükleyin; nereye düşeceğini mavi bir çizgi gösterir.
• Else if, Else, Catch ve Finally bölümleri If ve Try altında listelenir. Bir If veya Try bloğu seçiliyken bunlardan birine tıklayın ya da bloğun üzerine sürükleyin.

Salt okunur bir görevde paletin yerine bir not görünür: komut eklemek veya değiştirmek için görevi çekin.

#Klavyeyle komut ekleme (Ctrl+K)

Görev oluşturmanın en hızlı yolu: Ctrl+K'ye basın (ya da blokların üstündeki Add command), görevin ne yapacağını yazın ve Enter'a basın.

• Komutları ve eylemlerini adına, açıklamasına ve günlük sözcüklere göre bulur: excel read, click, type text, send email, for each, wait, approve kastettikleri komutu bulur. Her sözcük eşleşmelidir; en iyi eşleşmeler önce gelir.
• Bu şekilde bulunan bir eylem yeni blokta zaten seçili olur; örneğin Excel · Read, excel --action:read ekler.
• Enter seçili bloğun ardına ekler ve özelliklerini açar. Ctrl+Enter ekler ve kutuyu açık tutar; böylece art arda birkaç blok eklenir. ↑ ↓ seçer, Esc kapatır.
• Siz yazmadan önce kutu son kullandığınız komutları, ardından en sık kullanılanları listeler.
• Bölümler (Else if, Else, Catch, Finally) de bulunur ve seçili If veya Try bloğuna eklenir.

#Blok görünümü

Her komut; simgesi, adı ve parametrelerinin tek satırlık özetiyle bir karttır. Blok komutlarının (If, Loop, Try, Step) renkli bir kenarı vardır, içeriklerini girintili gösterir ve bir End … satırıyla biter. Her satırın solundaki numara, görev metnindeki satır numarasıdır: günlükler, hatalar ve hata ayıklayıcı bu numarayı kullanır.

• Bir bloğu üzerine tıklayarak seçin. Bir blok komutunun solundaki ok onu daraltır; daraltılmış bir blok kaç komut gizlediğini gösterir (bazılarında sorun varsa N inside da görünür).
• Blokları sürükleyerek taşıyın.
• Bir bloğun ⋯ menüsünde Run from here, Debug from here, Add breakpoint, Copy, Cut, Duplicate, Disable ve Delete bulunur; If bloğunda ayrıca Add else if ve Add else, Try bloğunda Add catch ve Add finally vardır.
• End if ve End try satırları, bloğun henüz sahip olmadığı bölümler için + Else if, + Else, + Catch ve + Finally seçeneklerini sunar.

#Birden fazla blok seçme

Birden fazla blok seçiliyken özellikler paneli Copy, Cut, Duplicate, Delete ve Disable/Enable düğmeleriyle birlikte N blocks selected gösterir; bunlardan birini sürüklemek hepsini taşır. İç içe bir blok her zaman üst bloğuyla birlikte taşınır ve kopyalanır.

#Metin olarak kopyalama ve yapıştırma

Kopyalama ve kesme, seçili blokları panoya görev metni olarak yerleştirir. Bunları başka bir göreve, Code görünümüne, bir sohbete veya bir destek kaydına yapıştırabilir, görev metnini de geri yapıştırabilirsiniz: blok görünümünde Ctrl+V komutları seçimin ardına ekler. Panoda geçerli komut yoksa düzenleyici bunu bildirir ve hiçbir şeyi değiştirmez.

#Komutları devre dışı bırakma

Ctrl+/ (veya blok menüsündeki ya da özellikler panelindeki Disable) seçili komutları kapatır. Devre dışı bir komut görevde kalır, gri ve Disabled rozetiyle gösterilir, ancak çalışmaz ve doğrulanmaz; devre dışı bir blok içindeki her şeyi de kapatır. Yeniden etkinleştirmek için Ctrl+/ tuşuna tekrar basın. Görev metninde devre dışı bir komut --disabled:true taşır.

log --message:"Only while testing" --disabled:true

#Adımlar

Bir Step, komutları "Portala giriş yap" gibi bir ad altında gruplar. Kendisi hiçbir şey yapmaz; içindeki komutlar sırayla çalışır. Uzun görevleri yapılandırmak için adımları kullanın: diğer bloklar gibi daraltılabilirler ve Run from here hem bir adımda hem de içindeki komutlarda çalışır.

step --description:"Log in to the portal"
    browser --action:open --url:"https://portal.example.com" --output:portal
    capture --browser:$portal$ --action:settext --dompath:"#user" --value:$login.Username$
endstep

#Kod görünümü

Code, aynı görevi sözdizimi vurgulama, öneriler ve hata işaretleriyle görev dilinde metin olarak gösterir. Görünümlerden birinde yapılan değişiklikler diğerinde de görünür.

• Öneriler siz yazarken görünür (--, : ve $ sonrasında da); Ctrl+Space ile istediğiniz zaman açabilirsiniz. Yardım için fareyle bir sözcüğün üzerine gelin.
• F2, imlecin bulunduğu yerde değişken listesini açar.
• F9 veya satır numaralarının solundaki kenar boşluğuna tıklama, o satırdaki komut üzerinde bir kesme noktası koyar veya kaldırır.

Metinde bir sözdizimi hatası olduğunda blok görünümü son geçerli sürümü bir uyarı ve Fix in code düğmesiyle gösterir; hata düzeltilene kadar kaydedemezsiniz.

#Özellikler paneli

Bir bloğu düzenlemek için seçin; PROPERTIES içinde düzenleyebilirsiniz. Başlık, komutun adını ve açıklamasını gösterir. Sağındaki ? düğmesi komutun dokümantasyonunu bir açılır pencerede gösterir: ne yaptığı, her eylemi ve parametreleri (bloğun kullandığı eylem used here ile işaretlenir) ve örnekler, komut başvurusundaki gibi. Catch veya Else gibi bir bölüm için ait olduğu bloğun dokümantasyonunu gösterir.

• Birden fazla biçimi olan komutlar bir Action veya Type listesiyle başlar; alttaki alanlar seçiminize göre değişir.
• Zorunlu alanlar önce gelir ve * ile işaretlenir. Nadiren ihtiyaç duyulan alanlar Optional settings (N) altındadır. Bir alanın yanındaki bilgi simgesi o alanı açıklar.
• If ve Try bloklarında else if, else, catch ve finally eklemek için bir Sections alanı bulunur. Bir bölümün (örneğin Catch) kendi özellikleri ve bir Remove … düğmesi vardır.
• Alttaki Duplicate, Disable ve Delete seçili blok üzerinde işlem yapar.
• Bir şeyi işaret eden alanlar bir düğme sunar: Capture (bir web veya masaüstü elementi ya da bir çapa), Choose (açık bir pencere), New (bir pencere değişkeni), Browse (ajan makinesindeki bir dosya veya klasör), Choose task (Run task için).

#Nesne özellikleri

Bir web veya masaüstü elementi üzerinde işlem yapan komutlarda bir Object properties tablosu bulunur: elementi yakaladığınızda alınan, elementin işaretlendiği ekran görüntüsü ve elementten okunan tüm özellikler. Element, işaretli özelliklerle bulunur; bunların tümü eşleşmelidir.

• Özellikleri işaretleyin veya işareti kaldırın; üstteki seçici bunlardan yeniden oluşturulur.
• İşaretli her değer, elementinkine eşit olmalıdır. Değişen kısımlar için * yazın; değeri joker karakterli yapar: Invoice* Invoice ile başlar, *total* total içerir, *.pdf .pdf ile biter. $variables$ da çalışır.
• Daha önce yapılmış görevler diğer karşılaştırmalarını (Contains, Starts with…) korur; bunlar özelliğin yanında bir etiket olarak görünür. Eşittir olarak karşılaştırmak için etiketi kapatın.
• Masaüstü elementleri için teknolojiyi yakalamadan önce Capture düğmesinin yanından seçin: Otomatik (UI Automation 3; öğeyi daha iyi gösterdiğinde UI Automation 2), UI Automation 3 (modern uygulamalar) veya UI Automation 2 (eski Win32 ve WinForms uygulamaları). Görev çalışırken element aynı teknolojiyle bulunur. Bkz. Masaüstü otomasyonu.
• Web elementleri için başka bir öznitelik adı (örneğin data-id) yazın ve Add düğmesine tıklayın.
• Seçiciyi elle düzenlerseniz tablo artık kullanılmaz; Use properties seçiciyi tablodan yeniden oluşturur.

Yedekler, çapalar ve kendi kendini onarma için Elementleri bulma sayfasına bakın.

#Run task eşlemeleri

Run task için görevi Choose task ile seçin. Ardından Mappings, görevin Inputs ve Outputs öğelerini listeler. Auto map, boş girdileri aynı adlı değişkenlerden doldurur ve çıktıları aynı adlı değişkenlere gönderir. Bkz. Değişkenler.

#Değişken ekleme

Değişken kabul eden her alanda Insert variable penceresini açan bir $ düğmesi bulunur (veya alanda F2 tuşuna basın):

• Aramak için yazın, ↑ ve ↓ ile gezinin ve eklemek için Enter tuşuna basın.
• Bir liste, sözlük, kayıt veya veri tablosu için bir parça seçmek üzere → tuşuna basın (veya üzerine tıklayın): One item, One key / field, One cell, One row (record) veya Number of items / Number of rows. Metin için Its length ekleyebilirsiniz. Başvuru sizin için oluşturulur; örneğin $items[0]$, $order.Total$ veya $table[2].Name$.
• New variable bir değişken tanımlar ve ekler. Aramanızla hiçbir şey eşleşmediğinde Create, arama metnini ad olarak önerir.

Bir alana $ yazmak da değişkenleri listeler; birini eklemek için Enter veya Tab tuşuna basın.

#Değişkenler paneli

VARIABLES sekmesi görevin tüm değişkenlerini türü ve başlangıç değeriyle birlikte INPUTS, OUTPUTS, VARIABLES, FROM COMMANDS (döngü değişkenleri ve komut çıktıları) ve BUILT-IN ($System$, bkz. Sistem değişkenleri) olarak gruplanmış şekilde listeler.

• Bir değişkene tıklayarak onu tanımlayan komutu seçin; düzenlemek için çift tıklayın.
• Bir değişkeni yeniden adlandırmak onu görevin her yerinde değiştirir.
• Add variable (+ düğmesi) Variable, Input veya Output, Name, Type ve başlangıç (veya varsayılan) değer içeren bir pencere açar. Tanım görevin en üstüne eklenir.

#Doğrulama

Düzenleyici siz çalışırken görevi denetler. Her blok kendi durumunu gösterir:

Hatalar veya boş zorunlu alanlar varken kaydedemezsiniz; araç çubuğundaki Problems veya To complete listesi sizi her birine götürür.

İpucu: Onarılmış bir blokta Apply, kullanılan elementin özelliklerini nesne özellikleri tablosuna yazar. Değişikliği korumak için görevi kaydedin (ve yayınlayın).

#Klavye kısayolları