Masaüstü komutları
window · desktop · sendkeys · mouse · screenshot · ocr · image · clipboard
window Window
Uygulama pencerelerini yönetir.
İşlemler (--action)
--action:open
Bir programı başlatır ve penceresini bir değişkene bağlar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--path zorunlu | metin | | Program, ör. notepad.exe veya C:\Apps\erp.exe Ajan makinesindeki bir dosya. |
--arguments | metin | | |
--title | metin | | Beklenecek pencerenin başlığı (joker karakterler); başka bir program açan başlatıcılar için |
--timeout | sayı | 30 | Saniye cinsinden zaman aşımı |
--output zorunlu | değişken adı | | Bu pencere için değişken; masaüstü komutları onu --window:$name$ ile hedefler |
--action:attach
Zaten açık olan bir pencereyi bir değişkene bağlar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--title | metin | | Pencere başlığı (joker karakterler: *Invoice*) |
--path | metin | | Program (joker karakterler), ör. erp.exe Ajan makinesindeki bir dosya. |
--timeout | sayı | 30 | Saniye cinsinden zaman aşımı |
--output zorunlu | değişken adı | | Bu pencere için değişken; masaüstü komutları onu --window:$name$ ile hedefler |
--action:activate
| 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 |
--action:close
| 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 |
--action:maximize
| 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 |
--action:minimize
| 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 |
--action:restore
| 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 |
--action:resize
| 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 |
--width zorunlu | sayı | | |
--height zorunlu | sayı | | |
--action:move
| 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 |
--x zorunlu | sayı | | |
--y zorunlu | sayı | | |
--action:exists
| 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 |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:wait
| 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 |
--timeout | sayı | 30 | Saniye cinsinden zaman aşımı |
--action:getproperty
| 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 |
--property zorunlu | metin | | Pencere özelliği |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:list
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--output zorunlu | değişken adı | | Sonucu alan değişken |
Örnekler
window --action:activate --window:$notepadWin$
window --action:wait --window:$notepadWin$ --timeout:30
window --action:exists --window:$notepadWin$ --output:isOpen
window --action:close --window:$notepadWin$
window --action:maximize --window:$notepadWin$
window --action:minimize --window:$notepadWin$
window --action:restore --window:$notepadWin$
window --action:resize --window:$notepadWin$ --width:800 --height:600
window --action:move --window:$notepadWin$ --x:100 --y:100
window --action:list --output:allWindows
window --action:open --path:"notepad.exe" --output:editor
window --action:attach --title:"*Invoice*" --path:"erp.exe" --output:erp
desktop --action:settext --window:$editor$ --by:classname --target:"Edit" --value:"Hello"
desktop Desktop
Windows UI Automation aracılığıyla masaüstü arayüz elementleriyle etkileşim kurar.
Tüm türlerde geçerli parametreler
| 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 |
--timeout | sayı | 30 | Saniye cinsinden zaman aşımı |
--retry | sayı | | Yeniden deneme sayısı. Belirtilmezse ekran ve dosya komutları geçici bir sorundan (hâlâ yüklenen bir sayfa, örtülü bir öğe, kilitli bir dosya) sonra bir kez daha dener; 0 bunu kapatır |
--retryinterval | sayı | 1 | Yeniden denemeler arasındaki saniye |
İşlemler (--action)
--action:click
Başka parametre yok.
--action:doubleclick
Başka parametre yok.
--action:rightclick
Başka parametre yok.
--action:clear
Başka parametre yok.
--action:check
Başka parametre yok.
--action:uncheck
Başka parametre yok.
--action:hover
Başka parametre yok.
--action:focus
Başka parametre yok.
--action:expandcollapse
Başka parametre yok.
--action:waitfor
Başka parametre yok.
--action:settext
Bir alanın metnini değiştirir (eski adı: type).
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--value zorunlu | metin | | |
--action:appendtext
Bir alanda zaten bulunan metnin sonuna metin ekler.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--value zorunlu | metin | | |
--action:select
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--value zorunlu | metin | | |
--action:getproperty
Elementin bir özelliğini, bir durumunu (enabled, checked, visible), seçili öğesini veya konumunu okur.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--property zorunlu | metin | | Element özelliği |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:setproperty
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--property zorunlu | metin | | Yalnızca value ayarlanabilir |
--value zorunlu | metin | | |
--action:exists
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:getchildren
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--output zorunlu | değişken adı | | Sonucu alan değişken |
Örnekler
desktop --action:click --window:$notepadWin$ --by:automationid --target:"btnSave"
desktop --action:settext --window:$notepadWin$ --by:name --target:"Text Editor" --value:"Hello World"
desktop --action:getproperty --window:$notepadWin$ --by:automationid --target:"statusBar" --property:value --output:statusText
desktop --action:exists --window:$notepadWin$ --by:name --target:"Save" --output:saveExists
sendkeys Send keys
Bir pencereye metin ve özel tuşlar yazar. Özel tuşlar köşeli parantez içinde yazılır: [ENTER], [TAB], [CTRL+C].
Parametreler
| 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 |
--keys zorunlu | tuşlar | | Yazılacak metin; özel tuşlar köşeli parantez içinde, ör. Hello[ENTER] veya [CTRL+A]. Düz bir [ için [[ kullanın |
--interval | sayı | 0 | Tuş vuruşları arasındaki milisaniye cinsinden gecikme |
--activate | true / false | true | Önce pencereyi öne getir |
mouse Mouse
Fareyle piksel konumlarında tıklar, hareket ettirir, sürükler ve kaydırır: elementleri yakalanamayan programlar için (uzak masaüstleri, çizimler). Çalıştığı yerde Capture'ı tercih edin; düzen değiştiğinde konumlar bozulur.
Tüm türlerde geçerli parametreler
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--window | $değişken$ | | Konumlar öne getirilen bu pencerenin sol üst köşesinden sayılır; boşsa ekranın köşesinden |
İşlemler (--action)
--action:click
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--x | sayı | | Soldan piksel; boşsa işaretçinin bulunduğu yer. Pick: ekrandaki noktaya tıklayın |
--y | sayı | | Üstten piksel |
--action:doubleclick
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--x | sayı | | Soldan piksel; boşsa işaretçinin bulunduğu yer. Pick: ekrandaki noktaya tıklayın |
--y | sayı | | Üstten piksel |
--action:rightclick
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--x | sayı | | Soldan piksel; boşsa işaretçinin bulunduğu yer. Pick: ekrandaki noktaya tıklayın |
--y | sayı | | Üstten piksel |
--action:middleclick
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--x | sayı | | Soldan piksel; boşsa işaretçinin bulunduğu yer. Pick: ekrandaki noktaya tıklayın |
--y | sayı | | Üstten piksel |
--action:move
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--x zorunlu | sayı | | Soldan piksel. Pick: ekrandaki noktaya tıklayın |
--y zorunlu | sayı | | Üstten piksel |
--action:drag
Sol düğmeye x,y konumunda basar, tox,toy konumuna taşır ve bırakır.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--x zorunlu | sayı | | Basılacak yer. Pick: ekrandaki noktaya tıklayın |
--y zorunlu | sayı | | |
--tox zorunlu | sayı | | Bırakılacak yer. Pick: ekrandaki noktaya tıklayın |
--toy zorunlu | sayı | | |
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--amount zorunlu | sayı | | Tekerlek adımları: pozitif yukarı, negatif aşağı kaydırır |
--x | sayı | | Bu konumun üzerinde kaydır; boşsa işaretçinin bulunduğu yer. Pick: ekrandaki noktaya tıklayın |
--y | sayı | | |
--action:getposition
İşaretçinin konumu, X ve Y içeren bir kayıt olarak.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--output zorunlu | değişken adı | | Sonucu alan değişken |
Örnekler
mouse --action:click --x:420 --y:310
mouse --action:doubleclick --window:$erp$ --x:120 --y:80
mouse --action:rightclick
mouse --action:drag --window:$erp$ --x:100 --y:200 --tox:400 --toy:200
mouse --action:scroll --amount:-3
mouse --action:move --x:10 --y:10
mouse --action:getposition --output:pos
screenshot Screenshot
Ekranın, bir pencerenin veya bunların bir alanının resmini kaydeder, ör. bir şeyler ters gittiğinde kanıt olarak.
Parametreler
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--file zorunlu | metin | | Yazılacak resim: .png, .jpg veya .bmp Ajan makinesindeki bir dosya. |
--window | $değişken$ | | Görüntüsü alınacak pencere (önce öne getirilir); boşsa tüm ekran. Mark area: ekranda bir dikdörtgen sürükleyin |
--x | sayı | 0 | Alan: pencereye (veya ekrana) göre sol kenar |
--y | sayı | 0 | Alan: pencereye (veya ekrana) göre üst kenar |
--width | sayı | | Alan: piksel cinsinden genişlik (boşsa tüm pencere) |
--height | sayı | | Alan: piksel cinsinden yükseklik (boşsa tüm pencere) |
--output | değişken adı | | Kaydedilen dosyanın yolunu alan değişken |
Örnekler
screenshot --file:"C:\Shots\error-$orderNo$.png"
screenshot --file:"C:\Shots\erp.jpg" --window:$erp$ --x:0 --y:40 --width:800 --height:500 --output:saved
ocr OCR
Windows'un yerleşik OCR özelliğiyle ekrandan veya bir resimden metin okur: elementlerin yakalanamadığı uygulamalar ve taramalar için (terminaller, Citrix, görüntüler).
Tüm türlerde geçerli parametreler
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--window | $değişken$ | | Okunacak pencere; boşsa tüm ekran (--file ile kullanılmaz). Mark area: ekranda bir dikdörtgen sürükleyin |
--x | sayı | 0 | Alan: pencereye (veya ekrana) göre sol kenar |
--y | sayı | 0 | Alan: pencereye (veya ekrana) göre üst kenar |
--width | sayı | | Alan: piksel cinsinden genişlik (boşsa tüm pencere) |
--height | sayı | | Alan: piksel cinsinden yükseklik (boşsa tüm pencere) |
--file | metin | | Ekran yerine bir resim dosyası (.png, .jpg, .bmp, .tif) oku Ajan makinesindeki bir dosya. |
--language | metin | | Windows'ta yüklü OCR dili, ör. tr, en, de; boşsa Windows görüntüleme dilleri |
İşlemler (--action)
--action:read
Tüm metin, satırlar satır sonlarıyla ayrılmış olarak.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:readlines
Her satır konumuyla birlikte: Text, X, Y, Width, Height, CenterX, CenterY.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:find
Bir metnin konumu: Found ve konumu içeren bir kayıt (mouse --x:$pos.CenterX$ --y:$pos.CenterY$ ile tıklayın).
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--text zorunlu | metin | | Aranacak metin (satırın bir parçası, büyük/küçük harf önemsiz) |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:languages
Ajan makinesinde yüklü OCR dilleri.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--output zorunlu | değişken adı | | Sonucu alan değişken |
Örnekler
ocr --action:read --window:$terminal$ --x:0 --y:60 --width:900 --height:400 --language:tr --output:screenText
ocr --action:readlines --window:$erp$ --output:lines
ocr --action:find --window:$erp$ --text:"Toplam" --output:pos
mouse --action:click --window:$erp$ --x:$pos.CenterX$ --y:$pos.CenterY$
ocr --action:read --file:"C:\Scans\invoice.png" --output:scanText
ocr --action:languages --output:installed
image Image
Ekranda bir resmi (bir düğme, bir simge, bir logo) bulur ve ona tıklar ya da nerede olduğunu söyler: öğeleri yakalanamayan ekranlar için (Citrix ve uzak masaüstleri, canvas uygulamaları, oyunlar).
Tüm türlerde geçerli parametreler
| 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 |
--timeout | sayı | | Resim için beklenecek saniye (varsayılan 10; exists: 0, beklemez) |
İşlemler (--action)
--action:find
Resmin nerede olduğu: Found, X, Y, Width, Height, CenterX, CenterY ve Similarity içeren bir record (zamanında görünmediyse Found false).
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:exists
Resim ekrandaysa true.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:click
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--offsetx | sayı | 0 | Resim merkezinin sağındaki piksel (negatif: sol) |
--offsety | sayı | 0 | Resim merkezinin altındaki piksel (negatif: üst) |
--action:doubleclick
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--offsetx | sayı | 0 | Resim merkezinin sağındaki piksel (negatif: sol) |
--offsety | sayı | 0 | Resim merkezinin altındaki piksel (negatif: üst) |
--action:rightclick
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--offsetx | sayı | 0 | Resim merkezinin sağındaki piksel (negatif: sol) |
--offsety | sayı | 0 | Resim merkezinin altındaki piksel (negatif: üst) |
--action:hover
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--offsetx | sayı | 0 | Resim merkezinin sağındaki piksel (negatif: sol) |
--offsety | sayı | 0 | Resim merkezinin altındaki piksel (negatif: üst) |
--action:waitvanish
Resim ekrandan kaybolana kadar bekler (bir yükleniyor simgesi, bir "Please wait" bandı); --timeout sonrasında başarısız olur.
Başka parametre yok.
Örnekler
image --action:click --image:4f1d2c3b-aaaa-4bbb-8ccc-123456789abc --window:$citrix$ --offsetx:-10
image --action:find --image:"C:\Pictures\approve.png" --similarity:85 --timeout:20 --output:pos
image --action:waitvanish --image:<id> --timeout:60
clipboard Clipboard
Windows panosundaki metni okur ve yazar, ör. sendkeys [CTRL+C] sonrasında.
İşlemler (--action)
--action:settext
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--text zorunlu | herhangi bir değer | | |
--action:gettext
Panodaki metin (metin yoksa boş).
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:clear
Başka parametre yok.
Örnekler
clipboard --action:settext --text:$orderNo$
clipboard --action:gettext --output:copied
clipboard --action:clear