Spalte lesen (Read Column)

UiPath.MicrosoftOffice365.Activities.Excel.ReadColumn

Beschreibung

Verwendet die Get Range- API von Microsoft Graph, um Zellwerte aus einer angegebenen Spalte (StartingCell) in einem Arbeitsblatt (SheetName) abzurufen.

After retrieving the cell value, the activity returns the column value in an Object[] (Column).

Scopes

Diese Aktivität erfordert die folgenden Scopes:

• Files.ReadWrite

ODER

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

• Blattname - Der Name des Blatts, aus dem Daten gelesen werden. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
• Startzelle – Die Adresse der Startzelle der Spalte. Alle zusammenhängenden Zellen darunter werden zurückgegeben. Geben Sie die Adresse einer einzelnen Zelle im A1-Stil ein. Diese Eigenschaft unterstützt keinen Zellbereich (z. B. „A1:A5“). 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

• 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

• Column - The values of the column as an array of objects. This field supports only Object[] variables. Required if you plan to use the output data in subsequent activities.

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 Column activity inside the Microsoft Office 365 Scope activity.
5. Geben Sie Werte für die Eingabeeigenschaften ein.
6. Erstellen und geben Sie die Variable Object[] 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 Object[] an Ihre Ausgabeeigenschaftsvariable zurück.