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 „Get Attachment“ herunter.
6. Aktualisiert den Wert dieser Zeile 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 zum Smartsheet -Setup 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-Tokenwert ein (z. B. apiToken).
2. Fügen Sie den Smartsheet Scope hinzu.
3. Wählen Sie für den Authentifizierungstyp API-Token aus.
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 und geben Sie eine Int64 -Variable für Ihren SheetId- Wert ein (z. B. SheetId).
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 innerhalb der Aktivität List Rows .

3. Geben Sie für das Feld Blatt-ID Ihre Blatt-ID in die Spalte Wert ein.

4. Erstellen Sie für das Feld Zeilen eine Row[] -Variable (z. B. RowsRetrieve).

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 Werte Ihre RowsRetrieve- Variable ein.

8. Verwenden Sie für die Eigenschaft Argumenttyp Smartsheet.Api.Models.Row.

9. Fügen Sie im Textkörper der Aktivität For Each eine List Rows -Aktivität hinzu.

10. Geben Sie für SheetId Ihre SheetId- Variable ein.

11. Geben Sie für ZeilenID „item.Id.value“ ein.

12. Wählen Sie für Einschließen „Attachments“ als Option aus.

13. Erstellen und geben Sie für Row eine Row -Variable ein (z. B. RowRetrieve)

    

    

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 „RowRetrieve.Attachments istthing“.
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 es für Values auf RowRetrieve.Attachments fest (vorausgesetzt, Sie verwenden RowRetrieve als Ausgabevariable gemäß 7d oben).
6. Für TypeArgument auf „Smartsheet.Api.Model.Attachment“ festlegen
7. Benennen Sie die ForEach-Variable von Element in Anhang um.

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 Aktivität „Get Attachment“ hinzu.

2. Geben Sie für SheetId Ihre SheetId- Variable ein.

3. Geben Sie für AttachmentId "attachment.Id.Value" ein

4. Geben Sie für Download Folder Path Ihre DownloadPath- Variable ein.

5. Fügen Sie eine Assign- Aktivität nach der Aktivität Get Attachment hinzu

6. Erstellen Sie für To eine Row -Variable (z. B. RowUpdate).

7. Erstellen Sie für Value ein neues Row -Objekt und legen Sie es mithilfe von Code ähnlich dem folgenden Muster fest.

   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 Schaltfläche Zeilenlink .

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 Beispiele für die Ein- und Ausgabe von Eigenschaften), finden Sie auf der Seite Aktivitäten für eine vollständige Aktivitätsliste und Links zu den Seiten mit Aktivitätsdetails.

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