Write Row

UiPath.MicrosoftOffice365.Activities.Excel.WriteRowConnections

Beschreibung

Schreiben Sie eine Zeile in eine ausgewählte Excel-Datei mithilfe einer Arrayzeile oder einer Datenzeile. Sie können einzelne Felder 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 für die Datei-/Ordnerauswahl : Klicken Sie auf den Ordner auf das Symbol, um die OneDrive- oder SharePoint-Dateien/-Ordner zu durchsuchen und eine Kalkulationstabelle auszuwählen. 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 in 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. Folgende Optionen stehen zur Verfügung:
  • Ü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 die erste gefundene leere 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 DataTable, die in eine Arbeitsmappe geschrieben werden. Folgende Optionen stehen zur Verfügung:
  • Datenzeile – Verwenden Sie eine Datenzeile als Eingabedaten.
  • Arrayzeile – Verwenden Sie eine Arrayzeile als Eingabedaten.
  • 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:

Das Batching von API-Aufrufen wird für diese Aktivität unterstützt, wenn sie verwendet werden in: 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 ( Write Row ) mit der Option Anfügen verwenden und der Zielbereich ist ein Arbeitsblatt, das am Anfang eine leere Tabelle (ohne andere 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