Bereich lesen (Read Range)

UiPath.GSuite.Activities.ReadRangeConnections

Beschreibung

Reads and saves the contents of the specified range so you can use them in activities such as Write Range.

Hinweis:

The Read Range activity is not available in API workflows.

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

Be aware of request or response limits when working with ranges. The limit stands at 4 MB. For example, on average 10,000 cells with 20 characters each for read requests, and 4,000 cells with 20 characters each for write requests.

Beispiel

Weitere Informationen finden Sie in den folgenden Ressourcen:

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