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 (Range) in einem Arbeitsblatt (SheetName) 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 im A1-Stil ein (z. B. „A1:A5“). Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte.
• Blattname - Der Name des Blatts, aus dem Daten gelesen werden. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
• Arbeitsmappe - Die DriveItem , deren Daten gelesen werden. Dieses Objekt kann mit der Aktivität Find Files and Folders abgerufen werden. Verwenden Sie die Ausgabeeigenschaftsvariable aus den Aktivitäten Dateien und Ordner suchen (Erste oder Ergebnisse) oder Arbeitsmappe erstellen (Arbeitsmappe). Wenn Sie die Ausgabeeigenschaft Ergebnisse aus der Aktivität Find Files and Folders verwenden, geben Sie das Element im Array an, das 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

• Header hinzufügen – Wenn diese Option ausgewählt ist, wird die erste Zeile des Bereichs sd-Spaltenheader in der Datentabelle hinzugefügt. Dieses Feld unterstützt nur boolesche Werte.
• Value Type - The type of data that is read from the document. Use the drop-down list to select one of the three options:
  • Values - Default. Retrieves the coded value (i.e., backend) of the cells in the row. This might differ from the format value shown in the Excel worksheet (e.g., if the cell displays 23.00 in the worksheet, the coded value returned is 23).
  • Formulas - Retrieves the formula of the specified cell only (e.g., =SUM(A1,B1)). If you select Formulas and the specified cell doesn't contain a formula, the returned value defaults to Values.
  • Text - Retrieves the Excel worksheet value of the cell (e.g., if the cell displays 23.00 in the worksheet, the text value returned is 23.00).

Ausgabe

• Datentabelle – 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 Inhalte der Datentabelle abzurufen, verwenden Sie eine Aktivität mit einer DataTable -Eingabeeigenschaft (z. B. Output Data Table, For Each Row, Append to CSV, usw.).

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. Dateien und Ordner suchen, Arbeitsmappe erstellen, Element kopieren).
4. Add the Read Range activity inside the Microsoft Office 365 Scope activity.
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.