Schnellstart: Arbeiten mit Zeilen

Überblick

Der Zweck dieses Handbuchs besteht darin, Sie durch mehrere Beispiele für die Arbeit mit Zeilen in einem Blatt in Smartsheet zu führen. Wir verwenden die folgenden Aktivitäten:

• List Rows
• Get Row
• Get Attachment
• Update Rows

Mit diesem Arbeitsbeispiel können Sie eine Liste von Zeilen abrufen und dann diese Liste von Zeilen durchlaufen, indem Sie zuerst alle Anhänge für diese Zeile abrufen und dann einen Wert in dieser Zeile aktualisieren.

Nachdem Sie die Schritte in dieser Anleitung ausgeführt haben, verfügen Sie über eine Automatisierungs-Sequence, die Folgendes ausführt:

1. Stellt eine Verbindung mit Ihrer Smartsheet-Instanz (Smartsheet Scope) her.
2. Ruft eine Liste von Zeilen aus einem Blatt ab (List Rows).
3. Gehen Sie für jede abgerufene Zeile wie folgt vor:
4. Rufen Sie die Anhänge für diese Zeile ab (List Rows).
5. Lädt alle Anhänge in dieser Zeile herunter Get Attachment.
6. Aktualisiert den Wert dieser Zeile. Zeilen aktualisieren ( Update Rows) .

Für Element 4 oben könnten wir stattdessen ein Row[]-Objekt erstellen und einen einzelnen Update-Aufruf durchführen, aber für die Zwecke dieser Demo wird es einmal für jede Zeile aufgerufen, die wir aktualisieren möchten.

Unten sehen Sie einen Screenshot, wie unser Beispielblatt aussieht.

Um Ihre Blatt-ID zu erhalten, gehen Sie zu Datei->Eigenschaften und sehen Sie sich die BlattID an. Es sollte etwa 5903706102228868 aussehen.

Voraussetzungen

Bevor Sie beginnen:

1. Schließen Sie die Schritte zur Einrichtung von Smartsheet ab.
2. Ein lokaler Ordnerpfad, in den Anhänge heruntergeladen werden sollen.

Schritte

Erstellen Sie Ihr Projekt

1. Erstellen und geben Sie eine String -Variable für Ihren API-Token -Wert ein (z. B. apiToken).
2. Fügen Sie den Smartsheet Scope hinzu.
3. Wählen Sie für Authentifizierungstyp API-Tokenaus.
4. Geben Sie Ihre apiToken- Variable als Wert für den Wert des API-Zugriffstokens ein.

Erstellen und Festlegen von Variablen, die in mehreren Aktivitäten verwendet werden

1. Erstellen Sie eine Int64 -Variable für Ihren SheetId- Wert (z. B. SheetId), und geben Sie sie ein.
2. Erstellen und geben Sie eine String -Variable für Ihren Download-Pfad- Wert ein (z. B. downloadPath).

Rufen Sie eine Liste der Zeilen ab, für die wir Anhänge abrufen und auch aktualisieren möchten, und richten Sie eine für jede Schleife ein.

1. Fügen Sie die Aktivität List Rows hinzu.
2. Klicken Sie auf die Schaltfläche Konfigurieren in der Aktivität Listenzeilen .
3. Geben Sie im Feld Blatt-ID Ihre Blatt- ID in die Spalte Wert ein.
4. Erstellen Sie für das Feld Rowseine Row[] -Variable (z. B. rowsRetrieved).
5. Klicken Sie auf die Schaltfläche Fertig.
6. Fügen Sie eine „For Each“-Aktivität nach der „List Rows“-Aktivität hinzu.
7. Geben Sie für die Eigenschaft Values Ihre rowsRetrieved- Variable ein.
8. Verwenden Sie für die Eigenschaft Typargument Smartsheet.Api.Models.Row.
9. Fügen Sie im Textkörper der For Each-Aktivität eine List Rows- Aktivität hinzu.
10. Geben Sie für SheetId Ihre SheetId- Variable ein.
11. Geben Sie für RowId „item.Id.value“ ein.
12. Wählen Sie für Einschließen die Option „Anhänge“ aus.
13. Erstellen Sie für Roweine Row -Variable (z. B. rowRetrieved) und geben Sie sie ein.
    
    

    

    
    
    
    

    

    
    

Einrichten einer If-Bedingungsprüfung

1. Fügen Sie eine If*-Aktivität nach der Aktivität „ Get Row “ hinzu.
2. Verwenden Sie für die Bedingung den Wert „RowRetrieved.Attachments is Nothing“.
3. Fügen Sie im Abschnitt Else der If -Aktivität eine For Each -Aktivität hinzu
4. Legen Sie in der Aktivität For Each die folgenden Eigenschaften fest:
5. Legen Sie für Valuesden Wert auf rowRetrieved.Attachments fest (vorausgesetzt, Sie verwenden rowRetrieved als Ausgabevariable pro 7 Tage oben).
6. Legen Sie für TypeArgument „Smartsheet.Api.Model.Attachment“ fest.
7. Benennen Sie die ForEach-Variable von Element in Anhangum.

Laden Sie für jede Zeile mit einem Anhang den Anhang herunter und aktualisieren Sie einen Wert für diese Zeile

1. Fügen Sie eine Get Attach- Aktivität hinzu.
2. Geben Sie für SheetIddie Variable SheetId ein.
3. Geben Sie für AttachmentId„attachment.Id.Value“ ein.
4. Geben Sie für Download Folder Pathdie Variable downloadPath ein.
5. Fügen Sie nach der Aktivität „ Get Attachment “ eine „ Assign “-Aktivität hinzu
6. Erstellen Sie für Toeine Row -Variable (z. B. rowUpdate).
7. Erstellen Sie für Valueein neues Row -Objekt, und legen Sie es mit Code fest, der dem folgenden Muster ähnelt.

   New Row() With { 
   .Id = RowRetrieved.Id,
   .Cells = New List(Of Cell) From {
       New Cell() With {.Value = '100', .ColumnId = RowRetrieved.Cells(3).ColumnId}
       }
   }

   
   

   

   
   
8. Fügen Sie eine „ Update Rows “-Aktivität nach der „ Assign “-Aktivität hinzu.
9. Klicken Sie auf die Schaltfläche Konfigurieren .
10. Verwenden Sie für das Feld Blatt -ID die Variable „sheetId“ .
11. Klicken Sie für das Feld Zeilen auf die Link-Schaltfläche Zeile .
12. Klicken Sie auf die Schaltfläche Hinzufügen
13. Geben Sie die Variable rowUpdate ein , die Sie zuvor erstellt haben.
14. Klicken Sie auf die Schaltfläche Fertig .

Alles erledigt!

Weitere Informationen zu den Smartsheet-Aktivitäten (einschließlich Beispieleigenschaftseingaben/-ausgaben) finden Sie auf der Seite Aktivitäten . Dort finden Sie eine vollständige Aktivitätsliste und Links zu den Aktivitätsdetailseiten.

Sie können eine Kopie dieses Roboters unter dem folgenden Link herunterladen:

https://discourse-cloud-file-uploads.s3.dualstack.us-west-2.amazonaws.com/uipath/original/3X/2/8/28b17aad52194518cf0c4977635e8e381a68636d.zip