Write Row

UiPath.MicrosoftOffice365.Activities.Excel.WriteRowConnections

Beschreibung

Schreibt eine Zeile in eine ausgewählte Excel-Datei unter Verwendung einer Arrayzeile oder einer Datenzeile. Sie können einzelne Felder den Zielspalten zuordnen, indem Sie die Option Einzelne Felder unter Datenzeile verwenden.

Scopes

Diese Aktivität erfordert die folgenden Scopes:

• Sites.ReadWrite.All

Projektkompatibilität

Windows | Plattformübergreifend

Konfiguration

• Microsoft Outlook 365-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.

  • Arbeitsmappenbeispiel – Die zu verwendende Arbeitsmappenvorlage. Das Feld ist sichtbar, nachdem Sie auf Arbeitsmappenvorlage verwenden geklickt haben. Durchsuchen Sie die OneDrive-Ordner und wählen Sie eine Arbeitsmappe aus. In Studio Desktop ist die Option über Mehr anzeigen verfügbar Schaltflächenmenü neben Bereichstyp. Weitere Informationen finden Sie unter Arbeiten mit Vorlagen.

  • 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 – Der Bereich, in den geschrieben werden soll. Sie können benutzerdefinierte Bereiche mit der vollständigen A1-Notation schreiben. Dieses Feld wird mit Informationen vorausgefüllt, die aus der ausgewählten Arbeitsmappe oder dem Arbeitsmappenbeispiel abgerufen wurden. 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 Felder aktualisieren aus, wenn Sie Ihre Arbeitsmappe geändert haben und die neuesten Daten abrufen müssen.

• Wie geschrieben wird – Gibt an, wie die Daten zum angegebenen Bereich hinzugefügt werden sollen. Die verfügbaren Optionen sind:

  • Überschreiben – Überschreibt alle vorherigen Daten, die vorhanden sind. Schreibt die Zeile an die genaue Stelle. Wenn ein Bereich mit mehreren Zellen ausgewählt ist, wird in die erste Zeile geschrieben.
    • Zeilenposition – Die Zeilenindexposition, an der die Aktivität die Zeile überschreibt. Der Index kann für die Iteration für die Bereichszeilen mit Read Range oder For Each Row verwendet werden. Beginnt bei 0.
  • Anfügen – Gibt an, wie die Daten zum angegebenen Bereich hinzugefügt werden sollen. Schreibt die Daten in der ersten gefundenen leeren Zeile und fügt eine neue Zeile ein, indem die Zellen nach unten verschoben werden.
  Hinweis:

  Das Anfügen von Daten unterstützt derzeit keine benannten Bereiche.

  • Einfügen – Fügt eine Zeile ein und schreibt in die neu eingefügte Zeile.
  Hinweis:

  Wenn Hat Header auf „True“ festgelegt ist, gilt die erste Zeile im Bereich als Header und die Zeilenposition 0 ist die nächste Zeile.

• Was geschrieben werden soll – Die Daten in einer Datentabelle, die in eine Arbeitsmappe geschrieben werden. Die verfügbaren Optionen sind:

  • Datenzeile – Eine Datenzeile als Eingabedaten verwenden.
  • ArrayZeile – Eine Array-Zeile als Eingabedaten verwenden.
  • Einzelne Felder – Ordnet Daten einzelnen Zielfeldern zu. Mit einzelnen Feldern schreiben Sie direkt in die angegebenen Spalten. Die nicht angegebenen Spalten werden nicht gelöscht und behalten die alten Daten bei.

• Zu schreibende Datenzeile / Zu schreibende Arrayzeile – Die Daten in einer Datenzeile oder ArrayZeile, die in die Arbeitsmappe geschrieben werden.

• Hat Header – Wenn diese Option ausgewählt ist, werden die Spaltenheader durch Lesen des Bereichsheaders generiert. Diese Eigenschaft unterstützt nur boolesche Werte. Die Standardoption ist Aus. Dieses Feld wird angezeigt, wenn Sie die Option Was geschrieben werden soll – Einzelne Felder auswählen.

• Einzelne Zielspalten verwalten – Wählen Sie zusätzliche Felder für das aktuelle Objekt aus. Dieses Feld wird angezeigt, wenn Sie die Option Was geschrieben werden soll – Einzelne Felder auswählen.

Hinweis:

Batching-API-Aufrufe werden für diese Aktivität unterstützt, wenn sie innerhalb von: For Each Email, For Each Row in Workbook, For Each File or Folder.

Bekannte Einschränkung

Ein Fehler tritt auf, wenn Sie Zeile schreiben/Bereich schreiben mit der Option Anfügen verwenden und der Zielbereich ein Blatt ist, das eine leere Tabelle am Anfang (mit keinen anderen Daten) enthält. Die Aktivität versucht, eine Zeile in das Blatt am Anfang der Tabelle einzufügen, aber die Graph-API gibt einen Fehler zurück.

Beispiel

Siehe auch:

• Excel Online-Aktivitäten
• Write Column
• Zelle schreiben (Write Cell)
• Add Sheet