Démarrage rapide : Travailler avec des lignes

Vue d'ensemble (Overview)

L’objectif de ce guide est de vous expliquer plusieurs exemples d’utilisation des lignes d’une feuille dans Smartsheet. Nous utiliserons les activités suivantes :

• Répertorier des lignes
• Get Row
• Récupérer une pièce jointe
• Mettre à jour des lignes

Cet exemple de travail vous permet d'obtenir une liste de lignes, puis d'itérer cette liste de lignes, en obtenant d'abord les pièces jointes pour cette ligne, puis en mettant à jour une valeur dans cette ligne.

Une fois les étapes de ce guide terminées, vous disposerez d'une séquence d'automatisation qui effectuera les opérations suivantes :

1. Établit une connexion à votre instance Smartsheet ( Étendue Smartsheet (Smartsheet Scope)).
2. Obtient une liste de lignes d'une feuille (List Rows).
3. Pour chaque ligne récupérée, procédez comme suit :
4. Récupérez les pièces jointes de cette ligne (List Rows).
5. Télécharge toutes les pièces jointes sur cette ligne Obtenir la pièce jointe (Get Attachment).
6. Met à jour la valeur de cette ligne Update Rows.

Pour l'élément 4 ci-dessus, nous pourrions plutôt choisir de créer un objet Row[] et de passer un seul appel de mise à jour, mais pour les besoins de cette démo, nous l'appellerons une fois pour chaque ligne que nous voulons mettre à jour.

Vous trouverez ci-dessous une capture d'écran de notre exemple de feuille.

Pour obtenir votre ID de feuille, accédez à Fichier->Propriétés et consultez l'IDFeuille. Il devrait ressembler à 5903706102228868.

Prérequis

Avant de commencer :

1. Suivez les étapes de configuration de Smartsheet.
2. Un chemin de dossier local vers lequel télécharger les pièces jointes.

Étapes

Construisez votre projet

1. Créez et entrez une variable String pour la valeur de votre jeton API (par exemple, apiToken).
2. Ajoutez l ' étendue Smartsheet.
3. Pour Type d'authentification (Authentication Type), choisissez Jeton API ( API Token) .
4. Entrez votre variable apiToken comme valeur pour la valeur du jeton d'accès à l'API .

Créer et définir des variables qui seront utilisées dans plusieurs activités

1. Créez et entrez une variable Int64 pour votre valeur SheetId (par exemple, sheetId).
2. Créez et entrez une variable String pour la valeur de votre chemin de téléchargement (par exemple, downloadPath).

Obtenez une liste de lignes pour lesquelles nous voulons obtenir des pièces jointes et également mettre à jour, et configurez une boucle pour chaque.

1. Ajoutez l’activité List Rows .
2. Cliquez sur le bouton Configurer (Configure) à l’intérieur de l’activité Lister les lignes (List Rows) .
3. Pour le champ Sheet Id, saisissez votre sheetId dans la colonne Valeur (Value).
4. Pour le champ Lignes ( Rows), créez une variable Row[] (par exemple, rowsRetrieved).
5. Cliquez sur le bouton Terminé (Terminé).
6. Ajoutez une activité For Each après l’activité List Rows.
7. Pour la propriété Values , entrez votre variable rowsRetrieved .
8. Pour la propriété Type Argument (Type Argument), utilisez Smartsheet.Api.Models.Row.
9. Dans le corps de l'activité For Each, ajoutez une activité List Rows .
10. Pour SheetId, entrez votre variable sheetId .
11. Pour RowId, saisissez « item.Id.value ».
12. Pour Inclure , choisissez « Pièces jointes » comme option.
13. Pour Row, créez et entrez une variable Row (par exemple, rowRetrieved)
    
    

    

    
    
    
    

    

    
    

Configurer une vérification de condition Si

1. Ajoutez une activité If* après l’activité Get Row .
2. Pour la condition , utilisez la valeur « RowRetrieved.Attachments is Nothing ».
3. Dans la section Sinon ( Else ) de l’activité Si (If), ajoutez une activité For Each
4. Dans l’activité Pour chaque ( For Each ), définissez les propriétés suivantes :
5. Pour Values(Valeurs), définissez-la sur rowRetrieved.Attachments (en supposant que vous utilisiez rowRetrieved comme variable de sortie conformément à 7d ci-dessus).
6. Pour TypeArgument , définissez-le sur « Smartsheet.Api.Model.Attachment »
7. Renommez la variable PourChaque élément (élément) en pièce jointe.

Pour chaque ligne avec une pièce jointe, téléchargez la pièce jointe et mettez à jour une valeur sur cette ligne

1. Ajoutez une activité Get Attachment (Obtenir une pièce jointe).
2. Pour SheetId, entrez votre variable sheetId .
3. Pour AttachmentId, entrez "attachment.Id.Value"
4. Pour Chemin d'accès au dossier de téléchargement ( Download Folder Path), entrez votre variable downloadPath .
5. Ajouter une activité Assign (Assign ) après l'activité Get Attachment (Obtenir une pièce jointe)
6. Pour À, créez une variable Row (par exemple, rowUpdate).
7. Pour Value, créez un nouvel objet Row et définissez-le à l'aide d'un code similaire au modèle ci-dessous.

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

   
   

   

   
   
8. Ajoutez une activité Update Rows (Update Rows) après l’activité Assign .
9. Cliquez sur le bouton Configurer (Configure).
10. Pour le champ Sheet Id , utilisez la variable sheetId .
11. Pour le champ Lignes , cliquez sur le bouton Lien Ligne (Row) .
12. Cliquez sur le bouton Ajouter (Add)
13. Entrez la variable rowUpdate que vous avez créée précédemment.
14. Cliquez sur le bouton Terminé

Vous avez terminé !

Pour en savoir plus sur les activités Smartsheet (y compris des exemples d'entrées/sorties de propriétés), consultez la page Activités (Activities) pour obtenir une liste complète des activités et des liens vers les pages de détails des activités.

Vous pouvez télécharger une copie de ce robot sur le lien suivant :

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