Read Range Workbook

UiPath.Excel.Activities.ReadRange

Liest den Wert eines Excel-Bereichs und speichert ihn in einer Variablen vom Typ DatenTabelle (DataTable). Wenn der Bereich nicht angegeben ist, wird die gesamte Tabellenkalkulation gelesen. Wenn der Bereich als Zelle angegeben ist, wird das gesamte Arbeitsblatt beginnend mit dieser Zelle gelesen.

Eigenschaften

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

Eingabe

• Bereich (Range)- Der Zellbereich, den Sie lesen möchten. Wenn der Wert nicht angegeben ist, wird die gesamte Tabellenkalkulation gelesen. Wenn der Bereich nur eine Zelle ist, wird die gesamte Tabellenkalkulation beginnend mit dieser Zelle gelesen. Nur Variablen vom Typ Zeichenfolge (String) und Zeichenfolgen werden unterstützt.

  Hinweis: Alle Strings müssen in Anführungsstriche gesetzt werden.
• ArbeitsblattName (SheetName) - Der Name des Arbeitsblatts, in dem der zu lesende Bereich ist. Standardmäßig mit „Sheet1“ befüllt. Nur Variablen vom Typ Zeichenfolge (String) und Zeichenfolgen werden unterstützt.
• DateiPfad (WorkbookPath) - Der vollständige Pfad der zu verwendenden Excel-Tabellenkalkulation. Wenn die zu verwendende Excel-Datei in einem Projektordner liegt, wird der relative Pfad verwendet. Nur Variablen vom Typ Zeichenfolge (String) und Zeichenfolgen werden unterstützt.
  Hinweis: Alternativ können Sie, anstatt den Pfad zur Datei anzugeben, die Laufzeitleistung verbessern, wenn Sie mehrere Arbeitsmappenaktivitäten mit derselben Datei verwenden, indem Sie das Projekt mit der Datei aus dem Data Manager verbinden und dann mit der Eigenschaft Arbeitsmappe darauf verweisen.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Ausgabe

• DatenTabelle (DataTable) - Speichert die aus einem angegebenen Excel-Bereich extrahierten Daten in einer Datentabellen-Variable. Nur Datentabellenvariablen werden unterstützt.

Optionen

• KopfzeilenHinzufügen (AddHeaders) - Bei Auswahl werden die Spaltenkopfzeilen der angegebenen Tabellenkalkulation auch extrahiert. Standardmäßig ist dieses Auswahlfeld nicht ausgewählt.
• Passwort (Password) - Das Passwort der Excel-Arbeitsmappe, falls erforderlich. Nur Variablen vom Typ Zeichenfolge (String) und Zeichenfolgen werden unterstützt.
• FormatErhalten – Wählen Sie diese Option aus, um die Werte zu lesen, während sie im Bereich angezeigt werden (z. B. Währung, Datum, Text). Die eigentliche Zahlenformatierung wird nicht beibehalten, nur die Art und Weise, wie Daten angezeigt werden. Standardmäßig ist diese Option nicht ausgewählt.

Verwenden der Arbeitsmappe

• Arbeitsmappe – Wählen Sie eine Arbeitsmappenressource aus dem Plus-Menü aus. Sie ist verfügbar, wenn Sie die Excel-Datei als Ressource hinzugefügt haben, indem Sie eine Verbindung zur Arbeitsmappe über den Data Manager hergestellt haben.

  Wenn eine Arbeitsmappenressource hinzugefügt und dann auf die Ressource in mehreren Arbeitsmappenaktivitäten verwiesen wird, wird die Datei nicht für jeden Vorgang neu in den Arbeitsspeicher geladen, was die Laufzeitleistung verbessert, insbesondere bei der Arbeit mit großen Dateien. Weitere Informationen finden Sie unter Verwenden des Data Managers.