Bereich lesen (Read Range)

UiPath.Excel.Activities.ExcelReadRange

Liest den Text aus einer Excel-Zelle und speichert ihn in einer DataTable-Variable. Ist der Bereich nicht angegeben, wird das ganze Kalkulationsblatt gelesen. Ist der Bereich als Zelle angegeben, wird das ganze Kalkulationsblatt beginnend mit der Zelle gelesen. Kann nur in den Aktivitäten Excel Application Scope oder Use Excel File verwendet werden.

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.
• 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.

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 FormatErhalten 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 – 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.

Um die Verwendung dieser Aktivität zu veranschaulichen, haben wir ein Automatisierungsprojekt erstellt, das auch eine Read Range-Aktivität enthält.

Sie können das Beispiel hierüberprüfen und herunterladen