Zeilen kopieren
Kopiert die Werte mindestens einer bestimmten Zeile von einer Tabelle in eine andere.
Verfügbarkeit von Befehlen: IBM RPA SaaS und IBM RPA (lokal)
Scriptsyntax
Die proprietäre Scriptsprache von IBM RPA hat eine ähnliche Syntax wie andere Programmiersprachen. Die Scriptsyntax definiert die Syntax des Befehls in der Scriptdatei. Sie können diese Syntax im Modus Script von IBM RPA Studioverwenden.
copyRows --target(DataTable) [--orderby(String)] [--indexes(List<Numeric>)] [--where(String)] --dataTable(DataTable) (Boolean)=success (Numeric)=changedrowscount
Eingabeparameter
Die folgende Tabelle zeigt die Liste der in diesem Befehl verfügbaren Eingabeparameter. In der Tabelle wird der Parametername angezeigt, wenn Sie im Scriptmodus von IBM RPA Studiound der entsprechenden Bezeichnung für den Designermodus arbeiten.
| Designer-Modusbeschriftung | Name des Scriptmodus | Erforderlich | Akzeptierte Variablentypen | Beschreibung |
|---|---|---|---|---|
| Ziel | target |
Required |
Data Table |
Datentabelle, die die kopierten Zeilen aus der Quellendatentabelle empfangen soll. |
| Sortieren nach | orderby |
Optional |
Text |
Geben Sie den Typ der verwendeten Sortierung ein. Geben Sie den Namen der Spalte gefolgt von der Sortiermethode "ASC" oder "DESC" ein. Sie können mehrere Sortierungen für verschiedene Spalten der Tabelle wie folgt eingeben: Company ASC, City DESC. |
| Indizes | indexes |
Optional |
List<Number>, List<Text>, Number |
Position der zu kopierenden Zeile. |
| Dabei gilt Folgendes: | where |
Optional |
Text |
Text, der für die Suche nach einem bestimmten Wert in einer Tabellenzelle verantwortlich ist. Sie können den Text verwenden, der primitive Daten wie Numericoder eine Sammlung des Typs Numeric oder String enthält.Verwenden Sie die Syntax auf der Basis der Sprachstandards von LINQ C#  . |
| Quelle | dataTable |
Required |
Data Table |
Quellendatentabelle mit der Zeile, die kopiert werden soll. |
Ausgabeparameter
| Designer-Modusbeschriftung | Name des Scriptmodus | Akzeptierte Variablentypen | Beschreibung |
|---|---|---|---|
| Erfolg | success |
Boolean |
Gibt True zurück, wenn die Zeile erfolgreich kopiert wurde. Andernfalls wird False zurückgegeben. |
| Kopierte Zeilen | changedrowscount |
Number |
Anzahl der kopierten Zeilen. |
Beispiel:
Mit dem Befehl Zeilen kopieren können Sie die erste Zeile einer Datentabelle in eine andere kopieren. Öffnen Sie anschließend die Excel-Datei, um die kopierte Zeile anzuzeigen.
defVar --name excelFile --type Excel
defVar --name tableExcel --type DataTable
defVar --name emptyExcelFile --type Excel
defVar --name emptyExcelTable --type DataTable
defVar --name numberCopyLines --type Numeric
defVar --name resultCopy --type Boolean
// Enter a filled data table in the file parameter.
excelOpen --file tableFiled excelFile=value
excelGetTable --file ${excelFile} --getfirstsheet --entiretable --hasheaders tableExcel=value
// Table without values, only with header.
// Enter an empty data table in the file parameter.
excelOpen --file "tableEmpty.xlsx" emptyExcelFile=value
excelGetTable --file ${emptyExcelFile} --getfirstsheet --entiretable --hasheaders emptyExcelTable=value
copyRows --target ${emptyExcelTable} --indexes 1 --dataTable ${tableExcel} desc" numberCopyLines=changedrowscount resultCopy=success
logMessage --message "Success: ${resultCopy}\r\nCopied Lines: ${numberCopyLines}" --type "Info"
excelClose --file ${excelFile}
excelClose --file ${emptyExcelFile} --save
// The above example returns the following output:
// Success: True
// Rows Copied: 1
Einschränkungen
Sie müssen einen Wert für den Parameter indexes oder den Parameter where eingeben. Sie dürfen jedoch nicht beide gleichzeitig verwenden.