Bereich lesen (Read Range)

UiPath.MicrosoftOffice365.Activities.Excel.ReadRangeConnections

Beschreibung

Liest und speichert die Informationen aus einem angegebenen Excel-Arbeitsmappenzellenbereich zur Verwendung in anderen Aktivitäten, z. B. Write Range.

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-Verbindung – Die Verbindung für das Microsoft 365-Konto, das in der Aktivität verwendet werden soll.
• Arbeitsmappe – Die zu verwendende Excel-Arbeitsmappe. Die Methode zum Angeben des abzurufenden Ordners: Ordnerauswahl, ID eingeben, URL eingeben.

  • Option der Datei-/Ordnerauswahl : Klicken Sie auf den Ordner Symbol zum Durchsuchen von OneDrive- oder SharePoint-Dateien/-Ordnern und Auswählen einer Kalkulationstabelle. Diese Option akzeptiert Eingaben als IResource.

    • Verwenden Sie das Menü „Mehr anzeigen“ , um eine Variable zu verwenden, oder wählen Sie die Option Ordnerdaten neu laden aus, wenn Sie Ihre Ordner geändert haben und die neuesten Daten abrufen müssen.

  • Option ID eingeben :

    • Arbeitsmappen-ID – Die ID der Arbeitsmappe von Interesse. Dieses Feld unterstützt die Eingabe vom Typ String .
    • SharePoint-Websiteadresse – Die URL der SharePoint-Website, die die Datei oder den Ordner enthält. Dieses Feld unterstützt die Eingabe vom Typ String Öffnen Sie Ihre SharePoint-Website in einem Browser und kopieren Sie die URL, z. B. https://yourcompany.sharepoint.com/sites/ProductOfficial.
    • SharePoint-Dokumentbibliothek – Die Dokumentbibliothek innerhalb der angegebenen SharePoint-Website, die die Datei oder den Ordner enthält. Dieses Feld unterstützt die Eingabe vom Typ String . Öffnen Sie die Registerkarte Dokumente auf Ihrer SharePoint-Website und kopieren Sie die URL, z. B. https://yourcompany.sharepoint.com/sites/ProductOfficial/Shared%20Documents/Forms/AllItems.aspx.

  • Option URL eingeben:

    • Arbeitsmappen-URL – Die URL der Arbeitsmappe von Interesse. Dieses Feld unterstützt die Eingabe vom Typ String . Rufen Sie die URL ab, indem Sie die Datei in einem Browser öffnen.
• 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, einen BenanntenBereich oder einen Tabellennamen. 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.

Hinweis:

Einige Sonderzeichenkombinationen in der Eigenschaft Blatt-/Bereichsname können dazu führen, dass die Aktivität einen Fehler auslöst. Beispielsweise ist Sheet%Test eine gültige Eingabe, Sheet%44 jedoch nicht (%44 wird in D umgewandelt).

• Has headers - This property supports Boolean values. Set to True if the first row in the range represents a header row.

Zusätzliche Optionen

Eingabe

• What to read - The type of information that is read from the cell range: Values, Values and Formulas, Text.

Ausgabe

• Read Range – Verweis auf die von der Aktivität abgerufenen Informationen (gespeichert als DataTable-Variable), zur Verwendung in anderen Aktivitäten, z. B. Write Range.
• 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 Anforderungen-/Antwortbeschränkungen. Das Limit liegt bei 4 MB, also durchschnittlich 10.000 Zellen mit jeweils 20 Zeichen für Leseanforderungen und 4.000 Zellen mit jeweils 20 Zeichen für Schreibanforderungen. Weitere Informationen finden Sie unter Excel-Spezifikationen und -Grenzwerte.

Beispiel

Siehe auch:

• Excel Online-Aktivitäten
• Create Workbook
• Bereich löschen
• Schreibbereich (Write Range)