Schreibbereich (Write Range)

UiPath.MicrosoftOffice365.Activities.Excel.WriteRange

Beschreibung

Verwendet die Microsoft Graph Update Range- API, um einen Bereich von Zelldaten (DataTable) beginnend mit einer bestimmten Zelle (Starting Cell) in einem Arbeitsblatt (SheetName) der angegebenen Arbeitsmappe (Workbook) zu schreiben.

Scopes

Diese Aktivität erfordert die folgenden Scopes:

• Files.ReadWrite

ODER

• Files.ReadWrite.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

• Datentabelle – Die einzufügende Tabelle. Dieses Feld unterstützt nur DataTable -Variablen. Um die Variable DataTable abzurufen, erstellen Sie eine Tabelle mit der Aktivität Build Data Table oder Generate Data Table und verwenden Sie deren Ausgabeeigenschaftsvariable.
• Blattname - Der Name des Blatts, in das Daten geschrieben werden. Dieser Wert muss mit dem Namen eines vorhandenen Arbeitsblatts übereinstimmen, andernfalls wird ein ItemNotFound- Fehler ausgelöst. Diese Aktivität erstellt kein neues Blatt, wenn sie den in dieser Eigenschaft angegebenen Namen nicht finden kann. Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte.
• Startzelle – Die Adresse, unter die die linke obere Zelle der Tabelle geschrieben wird. 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.
• Arbeitsmappe – Das DriveItem des zu ändernden Dokuments. 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 - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert. Dieses Feld unterstützt nur boolesche Werte.

Optionen

• HeaderEinschließen – Wenn diese Option ausgewählt ist, werden die Header der Datentabelle auch in die Arbeitsmappe eingefügt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist True.

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. Fügen Sie eine Aktivität hinzu, die ein DataTable -Objekt ausgibt (z. B. Build Data Table, Generate Data Table).
5. Add the Write Range activity inside the Microsoft Office 365 Scope activity.
6. Geben Sie Werte für die Eingabeeigenschaften ein.
7. Führen Sie die Aktivität aus.
   • Ihre Eingabeeigenschaftswerte werden an die UpdateRange -API gesendet.