Bereich lesen (Read Range)

UiPath.GSuite.Activities.ReadRangeConnections

Beschreibung

Liest und speichert den Inhalt des angegebenen Bereichs, sodass Sie ihn in Aktivitäten wie Write Range verwenden können.

Hinweis:

Die Aktivität Read Range ist in API-Workflows nicht verfügbar.

Scopes

Diese Aktivität erfordert die folgenden Scopes:

• https://www.googleapis.com/auth/drive.readonly

ODER

• https://www.googleapis.com/auth/spreadsheets.readonly

ODER

• https://www.googleapis.com/auth/spreadsheets

ODER

• https://www.googleapis.com/auth/drive

Projektkompatibilität

Windows | Plattformübergreifend

Konfiguration

• Google Sheets-Verbindung – Die Verbindung für das Google Workspace-Konto, das in der Aktivität verwendet werden soll.

• Kalkulationstabelle – Wählen Sie die Kalkulationstabelle aus, aus der gelesen werden soll, oder verwenden Sie eine Variable/URL oder ID, und definieren Sie eine Kalkulationstabelle mit den Bereichsspalten. Mit einer Vorlage kann die Aktivität die Bereiche und Spalten generieren. Klicken Sie auf den Ordner Symbol zum Durchsuchen von Google Drive-Ordnern und Auswählen einer Kalkulationstabelle. Diese Option akzeptiert Eingaben als IResource. Verwenden Sie das Schaltflächenmenü Mehr anzeigen, um zum Modus Variable verwenden oder URL- oder ID- Eingabe (String) zu wechseln.

  • Wenn Sie Variable verwenden auswählen, können Sie die Ausgabevariable aus anderen Aktivitäten verwenden, z. B. Create Spreadsheet.
  • Kalkulationstabellen-URL – Die URL oder ID der gewünschten Kalkulationstabelle. Dieses Feld ist verfügbar, wenn URL oder ID als Eingabemodus ausgewählt ist. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte. Weitere Informationen finden Sie unter Abrufen von Kalkulationstabellen-IDs.
  • Beispiel einer Kalkulationstabelle – Die zu verwendende Kalkulationstabellenvorlage. Das Feld ist sichtbar, nachdem Sie auf Kalkulationstabellenvorlage verwenden geklickt haben. Durchsuchen Sie die Google Drive-Ordner und wählen Sie eine Kalkulationstabelle aus. In Studio Desktop ist die Option über das Schaltflächenmenü Mehr anzeigen neben Bereich verfügbar. Weitere Informationen finden Sie unter Arbeiten mit Vorlagen.
  • Wählen Sie die Option Dateidaten neu laden aus, wenn Sie Ihre Ordner geändert haben und die neuesten Daten abrufen müssen.

• Bereich – Wählen Sie nach dem Konfigurieren der Arbeitsmappe den Bereich aus, aus dem gelesen werden soll. Dieses Feld wird mit Informationen vorausgefüllt, die aus der ausgewählten Arbeitsmappe oder dem Arbeitsmappenbeispiel abgerufen wurden. Sie können auch einen benutzerdefinierten Bereich hinzufügen, z. B. Sheet!1C5:F10 oder einen BenanntenBereich, z. B. Clients. Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte.

  • Wählen Sie die Option Bereiche aktualisieren aus, wenn Sie Ihre Blätter geändert haben und die neuesten Daten abrufen müssen.
  • Wählen Sie die Option Tabelle aktualisieren aus, wenn Sie Ihre Arbeitsmappe geändert haben und die neuesten Daten abrufen müssen.

• Kopfzeilen einbeziehen – Gibt an, ob die erste Zeile im Bereich eine Kopfzeile darstellt. Dieses Eigenschaft unterstützt nur boolesche Werte.

• Was gelesen werden soll – Gibt den Typ des zu lesenden Werts an. Die verfügbaren Optionen sind Werte, Werte und Formeln sowie Text.

Zusätzliche Optionen

Ausgabe

• Lesebereich – Die Bereichsinformationen, die in einer DataTable -Variablen gespeichert sind.
• Informationen lesen – Details des ausgewählten Bereichs, gespeichert in einer RangeInformation -Variablen.

Bekannte Einschränkungen für Anforderungen

Beachten Sie bei der Arbeit mit Bereichen die Grenzwerte für Anforderungen oder Antworten. Das Limit liegt bei 4 MB. Zum Beispiel durchschnittlich 10.000 Zellen mit jeweils 20 Zeichen für Leseanforderungen und 4.000 Zellen mit jeweils 20 Zeichen für Schreibanforderungen.

Beispiel

Weitere Informationen finden Sie in den folgenden Ressourcen:

• Google Tabellen-Aktivitäten
• Schreibbereich (Write Range)
• Create Spreadsheet
• For Each Row in Spreadsheet