Zeile lesen (Read Row)

UiPath.MicrosoftOffice365.Activities.Excel.ReadRowConnections

Beschreibung

Ruft die Werte von Zellen aus einer angegebenen Zeile (StartingCell) in einem Arbeitsblatt (Workbook) ( SheetName ) der Arbeitsmappe ( Workbook )ab.

Nach dem Abrufen der Daten aus allen Zellen in der Zeile gibt die Aktivität ein dynamisches DataRow zurück.

Scopes

Diese Aktivität erfordert die folgenden Scopes:

• Sites.Read.All

ODER

• Sites.ReadWrite.All

Projektkompatibilität

Windows | Plattformübergreifend

Konfiguration

• Microsoft OneDrive und SharePoint – Die Verbindung für das Microsoft 365-Konto, das in der Aktivität verwendet werden soll.
• Arbeitsmappe - Die DriveItem , deren Daten gelesen werden.
• Arbeitsmappenbeispiel – Wählen Sie eine Datei mit den gleichen Bereichen wie die Variablendatei aus. Dieses Feld wird sichtbar, wenn Sie Arbeitsmappenvorlage verwenden auswählen.
• Blatt - Der Name des Blatts, aus dem Daten gelesen werden. Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte.
• Zelle – Die Adresse der Startzelle der Zeile. Alle zusammenhängenden Zellen rechts davon werden zurückgegeben. Geben Sie die Adresse einer einzelnen Zelle in A1-Notation ein. Diese Eigenschaft unterstützt keinen Zellbereich (z. B. "A1:A5"). Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte.

Eingabe

• Werttyp – Der Typ der Daten, die aus dem Dokument gelesen werden. Verwenden Sie die Dropdownliste, um eine der folgenden 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).
  • Werte und Formeln ‑ Ruft nur die Werte und Formeln der angegebenen Zelle ab (z. B. =SUM(A1,B1)).
  • 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

• Zeile – Die Werte der Zeile als Array von Objekten. Dieses Feld unterstützt nur Object[] Variablen. Erforderlich, wenn Sie die Ausgabedaten in nachfolgenden Aktivitäten verwenden möchten.

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 Row 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 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.