Bekleme ve Gecikme komutları
delay Delay
Çalışmayı belirli sayıda saniye veya milisaniye duraklatır.
Şunlardan en az birini verin: --seconds, --milliseconds.
Parametreler
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--seconds | sayı | Ne kadar bekleneceği, saniye cinsinden (kesirli olabilir, ör. 1.5); milisaniye için bunun yerine --milliseconds kullanın | |
--milliseconds | sayı | Ne kadar bekleneceği, milisaniye cinsinden (1000 = 1 saniye) |
Örnekler
delay --seconds:5
delay --milliseconds:500wait Wait
Bir şey olana kadar bekler: bir dosya oluşur, bir pencere kapanır, ekran değişir, bir element görünür… --timeout dolduğunda, --failontimeout:true değilse görev (bir uyarıyla) devam eder.
Tüm türlerde geçerli parametreler
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--timeout | sayı | 30 | Saniye cinsinden zaman aşımı |
--failontimeout | true / false | false | true: süre dolduğunda komut başarısız olur (en yakın catch ele alır); false: görev devam eder ve --output ne olduğunu bildirir |
--output | değişken adı | Bekleme başarılı olduğunda true, zaman aşımında false alır |
Türler (--type)
--type:fileexists
Dosya (veya joker karaktere uyan bir dosya) var olana kadar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--path zorunlu | metin | Dosya yolu; joker karakterlere izin verilir, ör. C:\Reports\*.xlsx (klasördeki uyan herhangi bir dosya) Ajan makinesindeki bir dosya. |
--type:filenotexists
Uyan hiçbir dosya kalmayana kadar (silinmiş veya taşınmış).
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--path zorunlu | metin | Dosya yolu; joker karakterlere izin verilir, ör. C:\Reports\*.xlsx (klasördeki uyan herhangi bir dosya) Ajan makinesindeki bir dosya. |
--type:folderexists
Klasör (veya uyan bir klasör) var olana kadar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--path zorunlu | metin | Klasör yolu; joker karakterlere izin verilir, ör. C:\Projects\2026* (uyan herhangi bir alt klasör) Ajan makinesindeki bir klasör. |
--type:foldernotexists
Uyan hiçbir klasör kalmayana kadar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--path zorunlu | metin | Klasör yolu; joker karakterlere izin verilir, ör. C:\Projects\2026* (uyan herhangi bir alt klasör) Ajan makinesindeki bir klasör. |
--type:windowexists
Pencere açık olana kadar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--window zorunlu | $değişken$ | window --action:open/attach ile alınan pencere veya bir set --type:window deseni |
--type:windownotexists
Pencere kapanana kadar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--window zorunlu | $değişken$ | window --action:open/attach ile alınan pencere veya bir set --type:window deseni |
--type:screenchange
Ekran (veya bir pencere ya da bunların bir alanı) değişene ya da değişmeyi durdurana kadar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--window | $değişken$ | İzlenecek pencere; boşsa tüm ekran. Mark area: ekranda bir dikdörtgen sürükleyin | |
--until | şunlardan biri: change, stable | change | change: farklı görünene kadar; stable: --stablefor saniye boyunca aynı kalana kadar |
--stablefor | sayı | 2 | --until:stable ile, hiçbir değişiklik olmadan geçmesi gereken saniye |
--x | sayı | 0 | İzlenecek alan: pencereye (veya ekrana) göre sol kenar |
--y | sayı | 0 | İzlenecek alan: pencereye (veya ekrana) göre üst kenar |
--width | sayı | İzlenecek alan: piksel cinsinden genişlik (boşsa tüm pencere) | |
--height | sayı | İzlenecek alan: piksel cinsinden yükseklik (boşsa tüm pencere) | |
--tolerance | sayı | 0 | Sayılmadan değişebilecek piksellerin yüzdesi, ör. 1 yanıp sönen bir imleci veya saati yok sayar |
--type:desktopelement
Masaüstü elementi görünene kadar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--window zorunlu | $değişken$ | window --action:open/attach ile alınan pencere veya bir set --type:window deseni | |
--by zorunlu | şunlardan biri: automationid, name, classname, xpath, index | ||
--target zorunlu | metin | Tanımlayıcı değeri | |
--properties | metin | Yakalanan elementin nesne özellikleri. İşaretli her özellik eşleşmelidir; seçici bunlardan oluşturulur | |
--anchor | metin | Yakında bulunan ve değişmeyen bir element, ör. name=Amount, automationid=lblTotal, classname=Static veya bir XPath; --target için birden çok eşleşme varsa ona en yakın olan kullanılır | |
--anchorposition | şunlardan biri: near, right, left, below, above | near | Elementin çapaya göre konumu: o taraftaki en yakın eşleşme kullanılır |
--fallback | metin | İlki hiçbir şey bulamadığında denenecek diğer seçiciler, " || " ile ayrılır. Özellikler tablosundaki alternatifler bunlardan sonra otomatik olarak denenir |
--type:desktopelementgone
Masaüstü elementi kaybolana kadar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--window zorunlu | $değişken$ | window --action:open/attach ile alınan pencere veya bir set --type:window deseni | |
--by zorunlu | şunlardan biri: automationid, name, classname, xpath, index | ||
--target zorunlu | metin | Tanımlayıcı değeri | |
--properties | metin | Yakalanan elementin nesne özellikleri. İşaretli her özellik eşleşmelidir; seçici bunlardan oluşturulur | |
--anchor | metin | Yakında bulunan ve değişmeyen bir element, ör. name=Amount, automationid=lblTotal, classname=Static veya bir XPath; --target için birden çok eşleşme varsa ona en yakın olan kullanılır | |
--anchorposition | şunlardan biri: near, right, left, below, above | near | Elementin çapaya göre konumu: o taraftaki en yakın eşleşme kullanılır |
--fallback | metin | İlki hiçbir şey bulamadığında denenecek diğer seçiciler, " || " ile ayrılır. Özellikler tablosundaki alternatifler bunlardan sonra otomatik olarak denenir |
--type:element
Web elementi görünür olana kadar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--browser | $değişken$ | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) | |
--dompath zorunlu | metin | XPath veya CSS seçici | |
--frame | metin | Elementin bulunduğu iframe'in seçicisi, ör. #payment; iç içe çerçeveler outer >> inner şeklinde. Boşsa sayfanın kendisi | |
--properties | metin | Yakalanan elementin nesne özellikleri. İşaretli her özellik eşleşmelidir; seçici bunlardan oluşturulur | |
--anchor | metin | Yakında bulunan ve değişmeyen bir elementin (etiket, başlık) seçicisi; --dompath için birden çok eşleşme varsa ona en yakın olan kullanılır | |
--anchorposition | şunlardan biri: near, right, left, below, above | near | Elementin çapaya göre konumu: o taraftaki en yakın eşleşme kullanılır |
--fallback | metin | İlki hiçbir şey bulamadığında denenecek diğer seçiciler, " || " ile ayrılır. Özellikler tablosundaki alternatifler bunlardan sonra otomatik olarak denenir |
--type:elementgone
Web elementi gizlenene veya sayfadan kaldırılana kadar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--browser | $değişken$ | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) | |
--dompath zorunlu | metin | XPath veya CSS seçici | |
--frame | metin | Elementin bulunduğu iframe'in seçicisi, ör. #payment; iç içe çerçeveler outer >> inner şeklinde. Boşsa sayfanın kendisi | |
--properties | metin | Yakalanan elementin nesne özellikleri. İşaretli her özellik eşleşmelidir; seçici bunlardan oluşturulur | |
--anchor | metin | Yakında bulunan ve değişmeyen bir elementin (etiket, başlık) seçicisi; --dompath için birden çok eşleşme varsa ona en yakın olan kullanılır | |
--anchorposition | şunlardan biri: near, right, left, below, above | near | Elementin çapaya göre konumu: o taraftaki en yakın eşleşme kullanılır |
--fallback | metin | İlki hiçbir şey bulamadığında denenecek diğer seçiciler, " || " ile ayrılır. Özellikler tablosundaki alternatifler bunlardan sonra otomatik olarak denenir |
--type:image
Resim ekranda (veya pencerede) görünene kadar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--image zorunlu | metin | Aranacak resim: ekranda işaretleyin (Capture) veya ajan makinesindeki bir .png/.jpg/.bmp dosyası | |
--window | $değişken$ | Yalnızca bu pencerede ara (önce öne getirilir); boşsa tüm ekran | |
--similarity | sayı | 90 | Bir noktanın yüzde olarak ne kadar benzer olması gerektiği (50–100). Düşük değer biraz değişmiş resimleri de bulur (renkler, yumuşatma); yüksek değer benzerlerini önler |
--type:imagegone
Resim ekrandan kaybolana kadar (bir yükleme simgesi, "Lütfen bekleyin" şeridi).
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--image zorunlu | metin | Aranacak resim: ekranda işaretleyin (Capture) veya ajan makinesindeki bir .png/.jpg/.bmp dosyası | |
--window | $değişken$ | Yalnızca bu pencerede ara (önce öne getirilir); boşsa tüm ekran | |
--similarity | sayı | 90 | Bir noktanın yüzde olarak ne kadar benzer olması gerektiği (50–100). Düşük değer biraz değişmiş resimleri de bulur (renkler, yumuşatma); yüksek değer benzerlerini önler |
--type:pageload
Web sayfası yüklenene kadar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--browser | $değişken$ | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) |
--type:url
Sayfa URL'si eşleşene kadar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--browser | $değişken$ | browser --action:open --output ile alınan tarayıcı (varsayılan: en son kullanılan sayfa) | |
--value zorunlu | metin | URL deseni (joker karakterlere izin verilir) |
Örnekler
wait --type:fileexists --path:"C:\In\report-*.xlsx" --timeout:120
wait --type:filenotexists --path:"C:\In\~$report.xlsx" --output:closed
wait --type:windowexists --window:$erp$
wait --type:windownotexists --window:$progress$ --timeout:300
wait --type:screenchange --window:$erp$ --x:0 --y:40 --width:800 --height:500
wait --type:screenchange --until:stable --stablefor:3 --tolerance:1
wait --type:desktopelement --window:$erp$ --by:name --target:Save
wait --type:desktopelementgone --window:$erp$ --by:name --target:Loading
wait --type:element --dompath:"//div[@id='loaded']" --timeout:30
wait --type:elementgone --browser:$web$ --dompath:".spinner"
wait --type:image --image:"C:\Pictures\ok-button.png" --window:$citrix$ --timeout:60
wait --type:imagegone --image:"C:\Pictures\spinner.png" --similarity:85 --timeout:120
wait --type:pageload --timeout:60
wait --type:url --value:"*dashboard*" --timeout:30