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).
2. Obtient une liste de lignes d'une feuille (Liste des lignes).
3. Pour chaque ligne récupérée, procédez comme suit :
4. Récupérez les pièces jointes de cette ligne (Lignes de la liste).
5. Télécharge toutes les pièces jointes sur cette ligne Obtenir la pièce jointe.
6. Met à jour la valeur de cette ligne.

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 la section 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 nouvelle variable String pour la valeur de votre jeton d'API (par exemple, apiToken).
2. Ajoutez l’ étendue Smartsheet.
3. Pour Type d’authentification, choisissez Jeton API.
4. Saisissez votre variable apiToken comme valeur de 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 nouvelle variable Int64 pour votre valeur SheetId (par exemple, SheetId).
2. Créez et entrez une nouvelle variable String pour la valeur de votre chemin de téléchargement (par exemple, téléchargerChemin).

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é Lister des lignes .

2. Cliquez sur le bouton Configurer dans l'activité Lister des lignes .

3. Pour le champ ID de feuille, saisissez votre ID de feuille dans la colonne Valeur.

4. Pour le champ Lignes, créez une variable Row[] (par exemple, lignesRécupérées.

5. Cliquez sur le bouton Terminé (Terminé).

6. Ajoutez une activité For Each après l’activité List Rows.

7. Pour la propriété Valeurs , saisissez votre variable lignesRécupérées .

8. Pour la propriété Saisir l’argument , utilisez Smartsheet.Api.Models.Row.

9. Dans le corps de l'activité For Each, ajoutez une activité List Rows .

10. Pour SheetId, saisissez votre variable SheetId .

11. Pour RowId , saisissez « élément.Id.value».

12. Pour Inclure , choisissez l'option « Pièces jointes».

13. Pour Ligne, créez et entrez une variable Row (par exemple, ligneRécupérée)

    

    

Configurer une vérification de condition Si

1. Ajoutez une activité Si* après l'activité Obtenir la ligne .
2. Pour la Condition, utilisez la valeur « LigneRécupérée.Pièces jointes n’est rien».
3. Dans la section Sinon de l'activité Si , ajoutez une activité de type Pour chaque .
4. Dans l’activité Pour chaque , définissez les propriétés suivantes:
5. Pour Values (Valeurs), définissez-le sur rowRetrieve.Attachments (en supposant que vous utilisez rowRetrieve comme variable de sortie par 7d ci-dessus).
6. Pour TypeArgument, définissez-le sur « Smartsheet.Api.Model.Attachment »
7. Renommez la variable ForEach de l'élément à la 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é Obtenir la pièce jointe .

2. Pour SheetId, saisissez votre variable SheetId .

3. Pour AttachmentId, saisissez « Attachment.Id.Value»

4. Pour Télécharger le chemin du dossier, saisissez votre variable téléchargerPath .

5. Ajoutez une activité Affecter sous l’activité Obtenir la pièce jointe

6. Pour À, créez une variable Row (par exemple, rowUpdate).

7. Pour Valeur, 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é Mettre à jour les lignes après l'activité Affecter .

9. Cliquez sur le bouton Configurer .

10. Pour le champ Id de la feuille , utilisez la variable SheetId .

11. Pour le champ Lignes , cliquez sur le bouton Lien de ligne .

12. Cliquez sur le bouton Ajouter .

13. Saisissez la variable de mise à jour de la ligne 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 pour obtenir une liste complète des activités et des liens vers les pages de détails de l'activité.

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