Döngü komutları
loop Loop
İçindeki komutları tekrarlar.
Blok komutu: loop … endloop.
Tüm türlerde geçerli parametreler
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--measure | true / false | false | Performans raporu için her turu kaydet: başlangıç, bitiş, robot, birimler, insan süresine karşı robot süresi (Administration → Performance) |
--unitcount | sayı | 1 | Ölçülen turlar: bir turun işlediği iş işlemleri (ör. toplu işteki faturalar) |
--humanseconds | sayı | Ölçülen turlar: bir kişinin bu işin bir birimi için ihtiyaç duyduğu saniye | |
--businessunit | metin | Ölçülen turlar: raporlanacak iş birimi (boşsa görevin birimi) |
Türler (--type)
--type:range
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--from zorunlu | sayı | ||
--to zorunlu | sayı | ||
--step | sayı | 1 | |
--variable zorunlu | değişken adı | Geçerli sayı: --from, sonra --from + --step… --to değerine kadar |
--type:times
İçindeki komutları belirli sayıda çalıştırır (0 veya daha az: hiç çalıştırmaz).
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--times zorunlu | sayı | Kaç kez, ör. 5 veya $count$ | |
--index | değişken adı | Turun sırasını alan değişken, 0'dan başlar (ilk öğe 0'dır, $list[0]$ gibi) |
--type:list
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--list zorunlu | $değişken$ | ||
--variable zorunlu | değişken adı | ||
--index | değişken adı | Turun sırasını alan değişken, 0'dan başlar (ilk öğe 0'dır, $list[0]$ gibi) |
--type:datatable
Bir veri tablosu değişkeninin her satırı için bir kez çalışır (ör. capture --action:gettable, database --action:query veya csv --action:read sonucu).
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--table zorunlu | $değişken$ | Veri tablosu değişkeni | |
--variable zorunlu | değişken adı | Geçerli satır: $row.Column$ | |
--index | değişken adı | Turun sırasını alan değişken, 0'dan başlar (ilk öğe 0'dır, $list[0]$ gibi) |
--type:condition
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--condition zorunlu | koşul | ||
--check | şunlardan biri: before, after | before | before: koşul her turdan önce kontrol edilir (içerik hiç çalışmayabilir); after: içerik önce bir kez çalışır ve koşul her turdan sonra kontrol edilir (do-while) |
--type:excelrows
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--session zorunlu | metin | Çalışma kitabı açılırken verilen oturum adı Daha önce açılmış bir excel oturumunun adı. | |
--sheet | metin | Varsayılan olarak etkin sayfa | |
--header | true / false | true | İlk satır sütun adlarını içerir |
--variable zorunlu | değişken adı | ||
--index | değişken adı | Turun sırasını alan değişken, 0'dan başlar (ilk öğe 0'dır, $list[0]$ gibi) |
--type:eachfile
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--folder zorunlu | metin | Ajan makinesindeki bir klasör. | |
--filter | metin | *.* | |
--subfolder | true / false | false | Alt klasörleri dahil et |
--variable zorunlu | değişken adı | ||
--index | değişken adı | Turun sırasını alan değişken, 0'dan başlar (ilk öğe 0'dır, $list[0]$ gibi) |
--type:eachfolder
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--folder zorunlu | metin | Ajan makinesindeki bir klasör. | |
--subfolder | true / false | false | Alt klasörleri dahil et |
--variable zorunlu | değişken adı | ||
--index | değişken adı | Turun sırasını alan değişken, 0'dan başlar (ilk öğe 0'dır, $list[0]$ gibi) |
--type:queue
Kuyruk boşalana kadar her turda bir tane olmak üzere kuyruktan iş öğeleri alır: turu normal biten öğe tamamlanır, turu başarısız olan öğe başarısız olarak işaretlenir (ve kuyruk izin verdiği sürece daha sonra yeniden denenir); döngü sonraki öğeyle devam eder.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--queue zorunlu | metin | İş kuyruğunun adı (Queues sayfası) | |
--variable zorunlu | değişken adı | İş öğesi: $item.Data.Field$, $item.Reference$, $item.Id$, $item.Attempt$ | |
--index | değişken adı | Turun sırasını alan değişken, 0'dan başlar (ilk öğe 0'dır, $list[0]$ gibi) |
--type:mail
Bir posta kutusu klasöründe filtrelere uyan her e-posta için bir kez çalışır, en yeniden başlayarak. Mesajlar döngü başlarken okunur (mail --action:read gibi); içeride mail --action:saveattachments, move, markread veya delete --id:$msg.Id$ o anki mesaj üzerinde çalışır.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--server zorunlu | metin | IMAP sunucusu, ör. imap.gmail.com veya outlook.office365.com | |
--port | sayı | 993 | TLS için 993 (olağan), STARTTLS veya şifresiz için 143 |
--vault | metin | Posta hesabını tutan kasa (Kasalar sayfası); --credential bu durumda içindeki kimlik bilgisinin adıdır | |
--credential zorunlu | herhangi bir değer | Posta hesabı: --vault içindeki bir kimlik bilgisinin adı (Kasalar sayfasında tutulan kullanıcı adı ve parolası) veya bir kimlik bilgisi değişkeni ($cred$). Gmail, Outlook.com ve Yahoo uygulama şifresi ister; --authtype:oauth2 ile kimlik bilgisi uygulama kaydıdır (client id / client secret) | |
--security | şunlardan biri: auto, ssl, starttls, none | auto | auto: 465/993 portlarında TLS, diğer portlarda sunucu sunuyorsa STARTTLS (parola asla şifrelenmeden gönderilmez); ssl: baştan TLS; starttls: TLS'ye geçmek zorunludur; none: şifresiz (yalnızca iç sunucular) |
--ssl | true / false | --security parametresinin eski biçimi: false = none, true = TLS veya STARTTLS (ikisi de ayarlıysa --security geçerlidir) | |
--timeout | sayı | 60 | Vazgeçmeden önce posta sunucusunun bekleneceği saniye |
--ignoresslerrors | true / false | false | Her sunucu sertifikasını kabul et (kendinden imzalı sertifikalı iç sunucular); genel sunucular için false bırakın |
--authtype | şunlardan biri: password, oauth2 | password | oauth2: parolayla oturum açmanın kapalı olduğu posta kutuları için uygulama kaydıyla Microsoft 365 oturum açma (IMAP.AccessAsApp / SMTP.SendAsApp) |
--tenant | metin | oauth2: Microsoft 365 dizini, ör. contoso.onmicrosoft.com veya kimliği | |
--mailbox | metin | oauth2: posta kutusu kullanılan adres (send: boşsa --from adresi) | |
--folder | metin | INBOX | Posta klasörü, ör. INBOX veya Processed (mail --action:folders bunları listeler) |
--unread | true / false | true | Yalnızca okunmamış mesajlar |
--from | metin | Yalnızca göndereni bunu içeren mesajlar | |
--to | metin | Yalnızca alıcıları bunu içeren mesajlar | |
--subject | metin | Yalnızca konusu bunu içeren mesajlar | |
--body | metin | Yalnızca metni bunu içeren mesajlar | |
--since | herhangi bir değer | Yalnızca bu tarihte veya sonrasında alınan mesajlar | |
--before | herhangi bir değer | Yalnızca bu tarihten önce alınan mesajlar | |
--hasattachments | true / false | true: yalnızca ekli mesajlar; false: yalnızca eksiz mesajlar | |
--max | sayı | 50 | En fazla bu kadar mesaj |
--markread | true / false | false | Döngü başlarken (turlar çalışmadan önce) tüm mesajları okundu olarak işaretle |
--variable zorunlu | değişken adı | O anki mesaj: $msg.Subject$, $msg.From$, $msg.FromName$, $msg.To$, $msg.Cc$, $msg.Date$, $msg.Body$, $msg.HtmlBody$, $msg.IsRead$, $msg.Attachments$, $msg.Id$ | |
--index | değişken adı | Turun sırasını alan değişken, 0'dan başlar (ilk öğe 0'dır, $list[0]$ gibi) |
Örnekler
loop --type:range --from:1 --to:10 --step:1 --variable:i
log --message:"Index: $i$"
endlooploop --type:list --list:$myList$ --variable:item
log --message:"Item: $item$"
endlooploop --type:condition --condition:$counter$<100
number --action:increment --name:counter --by:1
endloopbreak Break
Geçerli döngüden çıkar.
continue Continue
Döngünün sonraki yinelemesine geçer.