Bereich lesen (Read Range)

UiPath.Excel.Activities.ExcelReadRange

Reads the value of an Excel range and stores it in a DataTable variable. If the range isn't specified, the whole spreadsheet is read. If the range is specified as a cell, the whole spreadsheet starting from that cell is read. Can only be used in the Excel Application Scope or Use Excel File activities.

Hinweis:

Wegen einer Software-Einschränkung werden beim Lesen von Zellen mit Währungsformat nur maximal 4 Dezimalstellen abgerufen.

Eigenschaften

Allgemein

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

Eingabe

• Bereich (Range)- Der Bereich, den Sie lesen möchten. Wenn der Bereich nicht angegeben ist, wird die gesamte Tabellenkalkulation gelesen. Wenn der Bereich als Zelle angegeben ist, wird die gesamte Tabellenkalkulation beginnend mit dieser Zelle gelesen. Nur Variablen vom Typ Zeichenfolge (String) und Zeichenfolgen werden unterstützt.
• SheetName - The name of the sheet in which the range that you want to read is. By default, this is filled in with "Sheet1." Only String variables and strings are supported.

Sonstiges

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

Optionen

• KopfzeilenHinzufügen (AddHeaders) - Bei Auswahl werden die Spaltenkopfzeilen der angegebenen Tabellenkalkulation auch extrahiert. Standardmäßig ist dieses Auswahlfeld ausgewählt (auf Wahr (True) gesetzt).
• 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.

Hinweis:

Durch Markieren des Kontrollfelds Format beibehalten ) können bei großen Bereichen Leistungsprobleme auftreten. Dies geschieht, weil nach Markieren dieses Kontrollfelds die Zeilen einzeln gelesen werden anstatt in einem Schritt.

• FilterVerwenden (UseFilter) - Bei Auswahl liest die Aktivität nicht den gefilterten Inhalt aus dem angegebenen Bereich. Standardmäßig ist dieses Auswahlfeld nicht ausgewählt, wodurch der gesamte Bereich gelesen wird, unabhängig davon, ob einige Informationen gefiltert wurden.

Ausgabe

• Datentabelle (DataTable) - Speichert die Daten, die aus dem angegebenen Excel-Bereich in einer DataTable-Variablen extrahiert wurden. Nur DataTable-Variablen werden unterstützt.

Verwendungsbeispiel der „Read Range“-Aktivität

Hier sehen Sie, wie die Aktivität Read Range in einem Beispiel verwendet wird, das mehrere Aktivitäten enthält.

To exemplify how to use this activity, we have built an automation project which also includes a Read Range activity.

Sie können das Beispiel unter Tabellenfunktionenüberprüfen und herunterladen