Veri komutları
excel · xml · json · csv · pdf · database
excel Excel
Excel çalışma kitaplarını okur ve yazar: .xlsx dosyalarını doğrudan (Excel'in kurulu olması gerekmez) ya da --engine:excel ile kurulu bir Microsoft Excel üzerinden (Excel'in açtığı her biçim, makrolar, veri yenileme, PDF'e aktarma).
İşlemler (--action)
--action:open
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--file zorunlu | metin | | Ajan makinesindeki bir dosya. |
--session zorunlu | metin | | Bu çalışma kitabının adı, sonraki excel komutları tarafından kullanılır |
--sheet | metin | | Etkinleştirilecek sayfa |
--create | true / false | false | Dosya yoksa oluştur |
--engine | şunlardan biri: file, excel | file | file: .xlsx dosyasının kendisini okur ve yazar (Excel gerekmez); excel: ajan makinesindeki Microsoft Excel'i kullanır (runmacro, refreshall, exportpdf ve autofit için gerekir; formülleri Excel hesaplar) |
--visible | true / false | true | --engine:excel ile: görev çalışırken Excel penceresini göster |
--action:readcell
| 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ı. |
--col zorunlu | herhangi bir değer | | |
--row zorunlu | sayı | | |
--output zorunlu | değişken adı | | Sonucu alan değişken |
Bir hücreye formül yerleştirir; readcell ardından hesaplanan değeri verir.
| 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ı. |
--col zorunlu | herhangi bir değer | | |
--row zorunlu | sayı | | |
--formula zorunlu | metin | | Bir Excel formülü, ör. =SUM(C2:C10) (hücreye olduğu gibi yazılır, Botream tarafından hesaplanmaz) |
--action:find
Bir değer içeren hücreler, yukarıdan aşağıya, kayıt olarak (Row, Column, ColumnLetter, Address, Value); hiç yoksa boş liste.
| 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ı. |
--value zorunlu | herhangi bir değer | | Aranacak değer (metin olarak, büyük/küçük harf yok sayılarak karşılaştırılır) |
--col | herhangi bir değer | | Yalnızca bu sütunda ara (harf veya sayı) |
--match | şunlardan biri: exact, contains | exact | |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:writecell
| 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ı. |
--col zorunlu | herhangi bir değer | | |
--row zorunlu | sayı | | |
--value zorunlu | herhangi bir değer | | |
--action:readrow
| 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ı. |
--row zorunlu | sayı | | |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:writerow
| 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ı. |
--row zorunlu | sayı | | |
--data zorunlu | $değişken$ | | |
--action:readcolumn
| 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ı. |
--col zorunlu | herhangi bir değer | | |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:readrange
Hücreler, sütunları ilk satır olan bir veri tablosu olarak; --header:false ile satırlardan oluşan bir liste (her biri bir değer listesi).
| 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ı. |
--range | metin | | ör. A1:D10; varsayılan olarak kullanılan aralık |
--header | true / false | true | İlk satır sütun adlarını içerir (satırlar kayıt olur) |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:writerange
--range'den başlayarak bir veri tablosu (önce sütun adlarıyla), kayıtlardan oluşan bir liste veya listelerden oluşan bir liste yazar.
| 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ı. |
--range zorunlu | metin | | Sol üst hücre, ör. A1 |
--data zorunlu | $değişken$ | | |
--header | true / false | true | Önce sütun adlarını yaz (kayıt satırları için) |
| 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ı. |
--range zorunlu | metin | | Hücre veya aralık, ör. B2 veya A1:D1 |
--bold | true / false | | |
--italic | true / false | | |
--fontsize | sayı | | |
--fontcolor | metin | | Onaltılık renk, ör. #FF0000 |
--backcolor | metin | | Onaltılık renk, ör. #FFFF00 |
--numberformat | metin | | ör. 0.00 veya dd.MM.yyyy |
--action:deleterow
| 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ı. |
--row zorunlu | sayı | | |
--action:insertrow
| 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ı. |
--row zorunlu | sayı | | |
--data | $değişken$ | | |
--action:getrowcount
| 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ı. |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:getcolumncount
| 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ı. |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:getsheets
| 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ı. |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:createsheet
| 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 zorunlu | metin | | |
--action:deletesheet
| 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 zorunlu | metin | | |
--action:activatesheet
| 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 zorunlu | metin | | |
--action:save
| 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ı. |
--action:saveas
| 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ı. |
--file zorunlu | metin | | Ajan makinesindeki bir dosya. |
--action:close
| 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ı. |
--save | true / false | false | Kapatmadan önce değişiklikleri kaydet |
--action:runmacro
Çalışma kitabının bir VBA makrosunu çalıştırır (--engine:excel gerekir); --output bir Function'ın döndürdüğünü alır.
| 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ı. |
--macro zorunlu | metin | | Makro, ör. Module1.FixFormats veya FixFormats |
--args | herhangi bir değer | | Makroya gönderilen değerler: bir liste değişkeni veya virgülle ayrılmış değerler |
--output | değişken adı | | Sonucu alan değişken |
--action:refreshall
Çalışma kitabındaki tüm veri bağlantılarını, sorguları ve pivot tabloları yeniler ve bitmelerini bekler (--engine:excel gerekir).
| 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ı. |
--action:exportpdf
Etkin sayfayı veya tüm çalışma kitabını PDF olarak kaydeder (--engine:excel gerekir).
| 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ı. |
--file zorunlu | metin | | Yazılacak PDF, ör. C:\Reports\Sales.pdf Ajan makinesindeki bir dosya. |
--scope | şunlardan biri: sheet, workbook | sheet | sheet: etkin sayfa; workbook: tüm sayfalar |
--action:autofit
Sütunları içerikleri kadar genişletir (--engine:excel gerekir).
| 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ı. |
--range | metin | | Sütunlar veya hücreler, ör. A:D; boşsa kullanılan aralık |
Örnekler
excel --action:open --file:"C:\data.xlsx" --session:Invoices --sheet:"Sheet1"
excel --action:readcell --session:Invoices --row:1 --col:2 --output:cellValue
excel --action:writecell --session:Invoices --row:1 --col:2 --value:"Updated"
excel --action:writeformula --session:Invoices --row:10 --col:C --formula:"=SUM(C2:C9)"
excel --action:find --session:Invoices --value:$orderNo$ --col:A --match:exact --output:cells
excel --action:readrow --session:Invoices --row:1 --output:rowData
excel --action:writerow --session:Invoices --row:1 --data:$rowRecord$
excel --action:readcolumn --session:Invoices --col:"A" --output:colData
excel --action:readrange --session:Invoices --range:"A1:D10" --output:tableData
excel --action:writerange --session:Invoices --range:"A1" --data:$dataTable$
excel --action:deleterow --session:Invoices --row:5
excel --action:insertrow --session:Invoices --row:3 --data:$rowRecord$
excel --action:getrowcount --session:Invoices --output:rowCount
excel --action:getcolumncount --session:Invoices --output:colCount
excel --action:createsheet --session:Invoices --sheet:"NewSheet"
excel --action:deletesheet --session:Invoices --sheet:"OldSheet"
excel --action:activatesheet --session:Invoices --sheet:"Sheet2"
excel --action:getsheets --session:Invoices --output:sheetList
excel --action:save --session:Invoices
excel --action:saveas --session:Invoices --file:"C:\output.xlsx"
excel --action:close --session:Invoices
excel --action:open --file:"C:\Reports\Sales.xlsm" --session:Sales --engine:excel --visible:false
excel --action:refreshall --session:Sales
excel --action:runmacro --session:Sales --macro:"Module1.FormatReport" --args:"2026, 10" --output:macroResult
excel --action:autofit --session:Sales --range:"A:F"
excel --action:exportpdf --session:Sales --file:"C:\Reports\Sales.pdf" --scope:workbook
excel --action:close --session:Sales --save:true
xml XML
XML belgelerini XPath ile okur ve düzenler.
İşlemler (--action)
--action:open
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--file zorunlu | metin | | Ajan makinesindeki bir dosya. |
--session zorunlu | metin | | Bu belgenin adı, sonraki xml komutları tarafından kullanılır |
--action:create
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Bu belgenin adı, sonraki xml komutları tarafından kullanılır |
--root | metin | | Kök element adı |
--text | metin | | Boş bir belge yerine yüklenecek XML metni |
--action:getvalue
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Belge açılırken verilen oturum adı Daha önce açılmış bir xml oturumunun adı. |
--xpath zorunlu | metin | | XPath, ör. /Orders/Order[@id="7"]/Total |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:setvalue
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Belge açılırken verilen oturum adı Daha önce açılmış bir xml oturumunun adı. |
--xpath zorunlu | metin | | XPath, ör. /Orders/Order[@id="7"]/Total |
--value zorunlu | herhangi bir değer | | |
--action:getattribute
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Belge açılırken verilen oturum adı Daha önce açılmış bir xml oturumunun adı. |
--xpath zorunlu | metin | | XPath, ör. /Orders/Order[@id="7"]/Total |
--attribute zorunlu | metin | | |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:setattribute
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Belge açılırken verilen oturum adı Daha önce açılmış bir xml oturumunun adı. |
--xpath zorunlu | metin | | XPath, ör. /Orders/Order[@id="7"]/Total |
--attribute zorunlu | metin | | |
--value zorunlu | herhangi bir değer | | |
--action:removeattribute
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Belge açılırken verilen oturum adı Daha önce açılmış bir xml oturumunun adı. |
--xpath zorunlu | metin | | XPath, ör. /Orders/Order[@id="7"]/Total |
--attribute zorunlu | metin | | |
--action:getnodes
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Belge açılırken verilen oturum adı Daha önce açılmış bir xml oturumunun adı. |
--xpath zorunlu | metin | | XPath, ör. /Orders/Order[@id="7"]/Total |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:count
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Belge açılırken verilen oturum adı Daha önce açılmış bir xml oturumunun adı. |
--xpath zorunlu | metin | | XPath, ör. /Orders/Order[@id="7"]/Total |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:addnode
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Belge açılırken verilen oturum adı Daha önce açılmış bir xml oturumunun adı. |
--xpath zorunlu | metin | | Üst elementin XPath'i |
--name zorunlu | metin | | Yeni element adı |
--value | herhangi bir değer | | |
--action:deletenode
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Belge açılırken verilen oturum adı Daha önce açılmış bir xml oturumunun adı. |
--xpath zorunlu | metin | | XPath, ör. /Orders/Order[@id="7"]/Total |
--action:getxml
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Belge açılırken verilen oturum adı Daha önce açılmış bir xml oturumunun adı. |
--xpath | metin | | Döndürülecek element; boşsa tüm belge |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:save
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Belge açılırken verilen oturum adı Daha önce açılmış bir xml oturumunun adı. |
--action:saveas
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Belge açılırken verilen oturum adı Daha önce açılmış bir xml oturumunun adı. |
--file zorunlu | metin | | Ajan makinesindeki bir dosya. |
--action:close
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Belge açılırken verilen oturum adı Daha önce açılmış bir xml oturumunun adı. |
--save | true / false | false | Kapatmadan önce değişiklikleri kaydet |
Örnekler
xml --action:open --file:"C:\orders.xml" --session:Orders
xml --action:create --session:Report --root:"Report"
xml --action:getvalue --session:Orders --xpath:"/Orders/Order[1]/Total" --output:total
xml --action:setvalue --session:Orders --xpath:"/Orders/Order[1]/Status" --value:"Shipped"
xml --action:getattribute --session:Orders --xpath:"/Orders/Order[1]" --attribute:"id" --output:orderId
xml --action:setattribute --session:Orders --xpath:"/Orders/Order[1]" --attribute:"checked" --value:"true"
xml --action:removeattribute --session:Orders --xpath:"/Orders/Order[1]" --attribute:"checked"
xml --action:getnodes --session:Orders --xpath:"/Orders/Order" --output:orders
xml --action:count --session:Orders --xpath:"/Orders/Order" --output:orderCount
xml --action:addnode --session:Report --xpath:"/Report" --name:"Line" --value:$total$
xml --action:deletenode --session:Orders --xpath:"/Orders/Order[@cancelled='true']"
xml --action:getxml --session:Report --output:reportXml
xml --action:save --session:Orders
xml --action:saveas --session:Report --file:"C:\report.xml"
xml --action:close --session:Orders
json JSON
JSON okur ve oluşturur, ör. bir web servisinin döndürdüğü veri (restapi --output:$response$ → $response.Json$). Yollar data.items[0].name biçimindedir.
İşlemler (--action)
--action:parse
JSON metnini bir nesneye veya listeye dönüştürür.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--text zorunlu | herhangi bir değer | | JSON metni veya onu içeren bir $variable$ |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:readfile
Bir .json dosyası okur.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--file zorunlu | metin | | Ajan makinesindeki bir dosya. |
--encoding | metin | utf-8 | |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:getvalue
Bir yoldaki değeri okur (nesne veya liste olduğu gibi kalır).
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--source zorunlu | herhangi bir değer | | JSON: bir değişken (ör. $response.Json$) veya JSON metni |
--path zorunlu | metin | | ör. data.items[0].name, items[$i$].price veya ["key with spaces"] |
--default | herhangi bir değer | | Yol yoksa veya null ise kullanılır; verilmezse eksik bir yol hatadır |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:setvalue
Bir değişkendeki bir yolun değerini ayarlar; yol üzerindeki eksik nesneler oluşturulur.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--name zorunlu | değişken adı | | JSON'u içeren değişken (yoksa oluşturulur) |
--path zorunlu | metin | | ör. data.items[0].name, items[$i$].price veya ["key with spaces"] |
--value zorunlu | herhangi bir değer | | |
--valuetype | şunlardan biri: auto, string, number, boolean, json | auto | auto: true/false, sayılar ve {…}/[…] kendi JSON türlerini alır; bir $variable$ türünü korur |
--action:remove
Bir yoldaki anahtarı veya liste öğesini kaldırır.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--name zorunlu | değişken adı | | JSON'u içeren değişken |
--path zorunlu | metin | | ör. data.items[0].name, items[$i$].price veya ["key with spaces"] |
--action:count
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--source zorunlu | herhangi bir değer | | JSON: bir değişken (ör. $response.Json$) veya JSON metni |
--path | metin | | ör. data.items[0].name, items[$i$].price veya ["key with spaces"]; boşsa JSON'un tamamı |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:keys
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--source zorunlu | herhangi bir değer | | JSON: bir değişken (ör. $response.Json$) veya JSON metni |
--path | metin | | ör. data.items[0].name, items[$i$].price veya ["key with spaces"]; boşsa JSON'un tamamı |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:todatatable
Bir nesne listesini veri tablosuna dönüştürür (ör. excel writerange veya loop için).
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--source zorunlu | herhangi bir değer | | JSON: bir değişken (ör. $response.Json$) veya JSON metni |
--path | metin | | ör. data.items[0].name, items[$i$].price veya ["key with spaces"]; boşsa JSON'un tamamı |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:stringify
Bir nesneyi veya listeyi JSON metnine dönüştürür (ör. bir istek gövdesi).
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--source zorunlu | herhangi bir değer | | JSON: bir değişken (ör. $response.Json$) veya JSON metni |
--indent | true / false | false | Çok satırlı, girintili metin |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:writefile
JSON'u bir dosyaya kaydeder.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--source zorunlu | herhangi bir değer | | JSON: bir değişken (ör. $response.Json$) veya JSON metni |
--file zorunlu | metin | | Ajan makinesindeki bir dosya. |
--indent | true / false | true | Çok satırlı, girintili metin |
--encoding | metin | utf-8 | |
csv CSV
CSV dosyalarını veri tablolarına okur ve veri tablolarını CSV olarak yazar. Her hücre metin olarak okunur.
İşlemler (--action)
--action:read
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--file zorunlu | metin | | Ajan makinesindeki bir dosya. |
--delimiter | metin | auto | auto virgül, noktalı virgül, sekme veya | karakterini bulur; ya da karakteri (veya adını: comma, semicolon, tab, pipe) verin |
--header | true / false | true | İlk satır sütun adlarını içerir; aksi halde adlar Column1, Column2… olur |
--encoding | metin | utf-8 | ör. utf-8 veya windows-1254 |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:write
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--data zorunlu | $değişken$ | | Bir veri tablosu (veya kayıt listesi) |
--file zorunlu | metin | | Ajan makinesindeki bir dosya. |
--delimiter | metin | , | Tek bir karakter (veya adı: comma, semicolon, tab, pipe) |
--header | true / false | true | Sütun adlarını ilk satır olarak yaz |
--encoding | metin | utf-8 | |
--append | true / false | false | Satırları mevcut bir dosyaya ekle (başlığı tekrarlanmaz) |
Örnekler
csv --action:read --file:"C:\Data\orders.csv" --output:orders
csv --action:read --file:"C:\Data\export.txt" --delimiter:tab --header:false --encoding:"windows-1254" --output:rows
csv --action:write --data:$orders$ --file:"C:\Out\orders.csv" --delimiter:";"
csv --action:write --data:$newRows$ --file:"C:\Out\orders.csv" --append:true
pdf PDF
PDF dosyalarının metnini okur ve sayfalarını birleştirir, böler veya ayıklar (PDF programı gerekmez). Taranmış sayfalar görüntüdür ve metin içermez.
İşlemler (--action)
--action:gettext
Belgenin veya bazı sayfalarının metni.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--file zorunlu | metin | | PDF dosyası Ajan makinesindeki bir dosya. |
--pages | metin | | Sayfa numaraları ve aralıkları, ör. 1-3,5 veya 4- (4. sayfadan sonuncuya); boşsa tüm sayfalar |
--password | metin | | Belge korumalıysa onu açan parola |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:getpagecount
Sayfa sayısı.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--file zorunlu | metin | | PDF dosyası Ajan makinesindeki bir dosya. |
--password | metin | | Belge korumalıysa onu açan parola |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:getinfo
PageCount, Title, Author, Subject, Keywords, Creator, Producer, CreatedDate, ModifiedDate ve IsEncrypted içeren bir kayıt.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--file zorunlu | metin | | PDF dosyası Ajan makinesindeki bir dosya. |
--password | metin | | Belge korumalıysa onu açan parola |
--output zorunlu | değişken adı | | Sonucu alan değişken |
--action:merge
PDF dosyalarını verilen sırayla tek bir dosyada birleştirir.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--files zorunlu | herhangi bir değer | | Bir liste değişkeni (ör. folder listfiles sonucu) veya virgülle ayrılmış yollar |
--destination zorunlu | metin | | Yazılacak PDF dosyası (varsa değiştirilir) Ajan makinesindeki bir dosya. |
Bir belgenin bazı sayfalarını verilen sırayla yeni bir PDF'e yazar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--file zorunlu | metin | | PDF dosyası Ajan makinesindeki bir dosya. |
--pages zorunlu | metin | | Sayfa numaraları ve aralıkları, ör. 1-3,5 veya 4- (4. sayfadan sonuncuya) |
--destination zorunlu | metin | | Yazılacak PDF dosyası (varsa değiştirilir) Ajan makinesindeki bir dosya. |
--password | metin | | Belge korumalıysa onu açan parola |
--action:split
Her sayfayı ayrı bir PDF'e yazar (<name>_1.pdf, <name>_2.pdf, …); --output dosya listesini alır.
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--file zorunlu | metin | | PDF dosyası Ajan makinesindeki bir dosya. |
--folder zorunlu | metin | | Sayfa dosyaları için klasör (yoksa oluşturulur) Ajan makinesindeki bir klasör. |
--password | metin | | Belge korumalıysa onu açan parola |
--output | değişken adı | | Sonucu alan değişken |
Örnekler
pdf --action:gettext --file:"C:\Invoices\2026-001.pdf" --output:text
pdf --action:gettext --file:$file.Path$ --pages:"1-3,5" --password:$pdfPassword$ --output:text
pdf --action:getpagecount --file:"C:\Invoices\2026-001.pdf" --output:pageCount
pdf --action:getinfo --file:"C:\Invoices\2026-001.pdf" --output:info
pdf --action:merge --files:$files$ --destination:"C:\Out\all.pdf"
pdf --action:merge --files:"C:\a.pdf, C:\b.pdf" --destination:"C:\Out\ab.pdf"
pdf --action:extractpages --file:"C:\report.pdf" --pages:"2-" --destination:"C:\Out\without-cover.pdf"
pdf --action:split --file:"C:\report.pdf" --folder:"C:\Out\pages" --output:pageFiles
database Database
Veritabanı sorguları çalıştırır; sonuçlar veri tablosu değişkenleri olarak saklanır.
Tüm türlerde geçerli parametreler
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--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:connect
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--provider zorunlu | şunlardan biri: sqlserver, mysql, postgresql, oracle, sqlite | | |
--connectionstring zorunlu | metin | | |
--session zorunlu | metin | | Bu bağlantının adı, sonraki database komutları tarafından kullanılır |
--action:disconnect
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Bağlanırken verilen oturum adı Daha önce açılmış bir database oturumunun adı. |
--action:query
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Bağlanırken verilen oturum adı Daha önce açılmış bir database oturumunun adı. |
--query zorunlu | metin | | |
--params | metin | | Virgülle ayrılmış name=value çiftleri, ör. id=$id$,status=active |
--output | değişken adı | | Sonucu alan değişken |
--action:execute
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Bağlanırken verilen oturum adı Daha önce açılmış bir database oturumunun adı. |
--query zorunlu | metin | | |
--params | metin | | Virgülle ayrılmış name=value çiftleri, ör. id=$id$,status=active |
--output | değişken adı | | Sonucu alan değişken |
--action:callprocedure
| Parametre | Değer | Varsayılan | Açıklama |
|---|
--session zorunlu | metin | | Bağlanırken verilen oturum adı Daha önce açılmış bir database oturumunun adı. |
--procedure zorunlu | metin | | |
--params | metin | | Virgülle ayrılmış name=value çiftleri, ör. id=$id$,status=active |
--output | değişken adı | | Sonucu alan değişken |
Örnekler
database --action:connect --provider:sqlserver --connectionstring:"Server=...;Database=...;" --session:Crm
database --action:query --session:Crm --query:"SELECT * FROM Users WHERE Status=@status" --params:"status=active" --output:resultTable
database --action:execute --session:Crm --query:"UPDATE Users SET Status=@status WHERE Id=@id" --params:"status=inactive,id=5" --output:affectedRows
database --action:callprocedure --session:Crm --procedure:"sp_ProcessOrder" --params:"orderId=123" --output:procResult
database --action:disconnect --session:Crm