Bereich lesen (Read Range)

Aktivität Bereich lesen (Read Range), die einen Bereich von Zellen aus einer LibeOffice-Tabellenkalkulationstabelle in eine Datentabelle liest.

UiPath.LibreOfficeCalc.Activities.ReadRange

Hinweis:

Das Aktivitätspaket LireOffice Activ ist in der Vorschau verfügbar.

Beschreibung

Liest einen Zellbereich aus der angegebenen Tabellenkalkulation in eine DataTable ein.

Diese Aktivität liest einen Bereich von Zellen aus einer LibreOffice Tabelle und gibt die Daten als System.Data.DataTable zurück. Sie können den Bereich in A1-Notation angeben, z. B. A1:C10, oder leer lassen, um den gesamten verwendeten Bereich zu lesen.

Im Wertemodus behält jede Zelle in der resultierenden Datentabelle den Typ bei, den sie in der Kalkulationstabelle hat, sodass eine einzelne Spalte Werte verschiedener Typen enthalten kann und leere Zellen als DBNull zurückgegeben werden.

Hinweis:

Dieses Paket erfordert die Installation von LibreOffice und wird unter Windows x64 oder macOS 13.3 oder höher auf Apple Silicon ausgeführt.

Projektkompatibilität

Windows | Plattformübergreifend

Konfiguration

Sie können die Aktivität und ihre Eigenschaften wie folgt konfigurieren:

• Dateipfad – Der Pfad zur Kalkulationstabellendatei (.ods, .xlsx, .csv). Das Feld akzeptiert auch eine Dateiressource über die Option Ressourcendatei verwenden im Plus-Menü, die dieses Feld durch Ressourcendatei ersetzt. Wenn die Aktivität in einem Use Spreadsheet Document- Scope platziert wird, wird dieses Feld durch Kalkulationstabellendokument ersetzt, das an das vom Scope geöffnete Dokument gebunden ist.
• Blatt – Der Name des Blatts, aus dem gelesen werden soll, z. B. Sheet1. In dem Feld werden die in der ausgewählten Datei gefundenen Blätter aufgelistet und Sie können auch einen Namen oder einen Ausdruck eingeben.
• Bereich - Der zu lesende Zellbereich in der A1-Notation. Unterstützt Rechtecke, z. B. A1:C10, einzelne Zellen, z. B. C3, ganze Spalten, z. B. A:C, und ganze Zeilen, z. B. 1:8. Wenn leer, wird der gesamte verwendete Bereich gelesen.
• Hat Header – Gibt an, ob die erste Zeile im Bereich eine Headerzeile ist. Wählen Sie True oder False aus. Standardmäßig ist diese Option auf True festgelegt. Wenn False festgelegt ist, wird jede Spalte nach der Kalkulationstabellenspalte benannt, aus der sie stammt, gefolgt von der Startspalte des Bereichs. Beim Lesen B1:D5 werden beispielsweise die Spalten Column B, Column C und Column D erzeugt.

Hinweis:

Weitere Informationen zu den Plus-Menüoptionen finden Sie unter Entwerfen von Automatisierungen.

Eigenschaften-Panel

Optionen

• Was gelesen werden soll – Gibt an, was von den Zellen zurückgegeben werden soll. Wählen Sie eine der folgenden Optionen aus:
  • Werte – Gibt die berechneten Zellenergebnisse zurück. Formeln werden ausgewertet. Dies ist die Standardoption.
  • Formel und Werte – Gibt die Formel für Zellen, die eine enthalten, und den Wert für alle anderen Zellen zurück. In diesem Modus wird jede Zelle als Text zurückgegeben, wobei die Formeln genau so beibehalten werden, wie sie in der Kalkulationstabelle geschrieben sind, z. B. =SUM(A1:A5).
• Kennwort – Das Kennwort zum Öffnen einer kennwortgeschützten Tabellendatei. Für ungeschützte Dateien leer lassen.

Ausgabe

• Lesebereich – Die Datentabelle, die die aus dem Bereich gelesenen Daten enthält.