Zelle lesen (Read Cell)

UiPath.MicrosoftOffice365.Activities.Excel.ReadCell

Beschreibung

Verwendet die Get Range- API von Microsoft Graph, um den Wert einer angegebenen Zelle (CellAddress) in einem Arbeitsblatt (SheetName) abzurufen.

After retrieving the cell value, the activity returns it as a String according to the selected value type (ValueType).

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

• Zelladresse – Die Adresse der Zelle, aus der Daten gelesen werden. 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.
• 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

• 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

• CellValue - The cell's contents. 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 Cell activity inside the Microsoft Office 365 Scope activity.
5. Geben Sie Werte für die Eingabeeigenschaften ein.
6. Erstellen und geben Sie die Variable String 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 String an Ihre Ausgabeeigenschaftsvariable zurück.