Bereich lesen (Read Range)

UiPath.MicrosoftOffice365.Activities.Excel.ReadRange

Beschreibung

Verwendet die Get Range-API von Microsoft Graph, um Werte aus einem angegebenen Bereich von Elementen (Bereich) in einem Arbeitsblatt (Blattname) einer Arbeitsmappe (Arbeitsmappe) abzurufen. Nach Abrufen des Bereichs der Elementdaten, gibt die Aktivität die Werte in eine DataTable (Datentabelle) aus.

Scopes

Diese Aktivität erfordert die folgenden Scopes:

• Sites.Read.All

ODER

• Sites.ReadWrite.All

Projektkompatibilität

Windows – Legacy | Windows

Konfiguration

Eigenschaften

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.

Eingabe

• Bereich - Der Bereich der zu lesenden Zellen. Wenn kein Bereich angegeben ist, wird das gesamte Blatt gelesen. Geben Sie Ihren Zellbereich in A1-Notation ein (z. B. „A1:A5“). Diese Eigenschaft unterstützt String -Variablen und zeichenfolgenformatierte Werte.
• Blattname - Der Name des Blatts, aus dem Daten gelesen werden. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
• Arbeitsmappe - Das DriveItem , dessen Daten gelesen werden. Dieses Objekt kann mit der Aktivität Find Files And Folders abgerufen werden. Verwenden Sie die Ausgabeeigenschaftsvariable aus den Aktivitäten Find Files and Folders (First oder Results) oder Create Workbook (Workbook). Wenn Sie die Ausgabeeigenschaft Ergebnisse aus der Aktivität Find Files and Folders verwenden, müssen Sie angeben, welches Element im Array Sie verwenden möchten (z. B. myWorkbooks(0)).

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert. Dieses Feld unterstützt nur boolesche Werte.

Optionen

• Kopfzeilen hinzufügen – Wenndiese Option ausgewählt ist, werden der ersten Zeile aus dem Bereich sd-Spaltenkopfzeilen in der DataTablehinzugefügt. Dieses Feld unterstützt boolesche Werte.

• Werttyp – Der Datentyp, der aus dem Dokument gelesen wird. Verwenden Sie die Dropdownliste, um eine der drei Optionen auszuwählen:

  • Werte – Standard. Ruft den codierten Wert (d. h. das Back-End) der Zellen in der Zeile ab. Dies kann sich vom Formatwert unterscheiden, der im Excel-Arbeitsblatt angezeigt wird (z. B. wenn die Zelle im Arbeitsblatt 23,00 anzeigt, ist der zurückgegebene codierte Wert 23).
  • Formeln – Ruft nur die Formel der angegebenen Zelle ab (z. B. =SUMME(A1,B1)). Wenn Sie Formeln auswählen und die angegebene Zelle keine Formel enthält, ist der zurückgegebene Wert standardmäßig Values.
  • Text – Ruft den Excel-Arbeitsblattwert der Zelle ab (wenn die Zelle z. B. 23,00 im Arbeitsblatt anzeigt, ist der zurückgegebene Textwert 23,00).

Ausgabe

• Datentabelle (DataTable ) - Das Ergebnis des Lesevorgangs. Dieses Feld unterstützt nur DataTable -Variablen. Erforderlich, wenn Sie die Ausgabedaten in nachfolgenden Aktivitäten verwenden möchten. Um die Datentabelleninhalte abzurufen , verwenden Sie eine Aktivität mit einer DataTable -Eingabeeigenschaft (z. B. Output Data Table, For Each Row, Append to CSVusw.).

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Führen Sie die Schritte aus.
2. Fügen Sie die Aktivität Microsoft Office 365 Scope zu Ihrem Projekt hinzu.
3. Fügen Sie eine Aktivität hinzu, oder führen Sie einen externen Prozess aus, der ein DriveItem -Objekt ausgibt (z. B. Find Files and Folders, Create Workbook, Copy Item).
4. Fügen Sie die Aktivität Read Range innerhalb der Aktivität Microsoft Office 365 Scope hinzu.
5. Geben Sie Werte für die Eingabeeigenschaften ein.
6. Erstellen und geben Sie die Variable DataTable für die Output-Eigenschaft ein.

7. Führen Sie die Aktivität aus.

   • Ihre Eingabeeigenschaftswerte werden an die GetRange-API gesendet.
   • Die API gibt den Wert DataTable an Ihre Ausgabeeigenschaftsvariable zurück.