Bereich anfügen (Append Range)

UiPath.MicrosoftOffice365.Activities.Excel.AppendRange

Beschreibung

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

Wenn das angegebene Arbeitsblatt in der angegebenen Arbeitsmappe nicht vorhanden ist, wird ein neues Arbeitsblatt mit dem Namen erstellt, den Sie in die Eigenschaft SheetName eingeben . Wenn das Arbeitsblatt vorhanden ist, wird die DataTable der letzten Zeile/Spalte von Zellen hinzugefügt, die Daten enthalten.

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 in der letzten Zeile/Spalte der Zellen hinzugefügt, die Daten enthalten.
• Blattname - Der Name des Blatts, an das die Daten angehängt werden. Wenn der Name, den Sie in diese Eigenschaft eingeben, nicht mit einem Blattnamenin der angegebenen Arbeitsmappe übereinstimmt, wird ein neues Blatt erstellt.
• 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 Find Files And Folders (Erste oder Ergebnisse) oder Create Workbook (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. Find Files and Folders, Create Workbook, Copy Item).
4. Fügen Sie eine Aktivität hinzu, die ein DataTable -Objekt ausgibt (z. B. Build Data Table, Generate Data Table).
5. Fügen Sie die Aktivität Append Range innerhalb der Aktivität Microsoft Office 365 Scope hinzu.
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.