Bereich anfügen (Append Range)

UiPath.MicrosoftOffice365.Activities.Excel.AppendRange

Beschreibung

Verwendet die Microsoft Graph Update Range- API, um einen Bereich von Elementdaten (DataTable) in ein angegebenes Arbeitsblatt (SheetName) zu schreiben.

If the specified worksheet does not exist in the specified workbook, a new worksheet is created with the name you enter in the SheetName property. If the worksheet does exist, the DataTable is added to the last row/column of cells that contain data.

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. 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. Wenn das im Blattnamen angegebene Blatt vorhanden ist, wird die Datentabelle der letzten Zeile/Spalte von Zellen hinzugefügt, die Daten enthalten.
• Sheet Name - The name of the sheet to which the data is appended. If the name you enter in this property does not match a sheet name in the specified Workbook, a new sheet is created.
• 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 (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert. Dieses Feld unterstützt nur boolesche Werte.

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