Informations de référence pour le module Smartsheet

Déclencheurs Smartsheet

Une fois l’intégration Smartsheet configurée, vous pouvez choisir des événements sur une feuille pour déclencher un flux de travail Bridge.

Sheet ID (ID de la feuille)

Identifiant ou nom de la feuille dont les événements doivent déclencher le flux de travail. Si vous saisissez le nom de la feuille, il sera remplacé par l’ID lorsque vous enregistrerez la configuration. Vous pouvez obtenir l’ID de la feuille en sélectionnant Fichier > Propriétés.

Le nom de la feuille doit être unique pour pouvoir être utilisé au lieu de son ID.

Event type (Type d’événement)

Il s’agit du type d’événement qui déclenchera le flux de travail.

Les événements pris en charge dans ce module sont les suivants :

• When Rows Are Created (Quand des lignes sont créées)
• When Rows Are Changed (Quand des lignes sont modifiées)
• When Rows Are Deleted (Quand des lignes sont supprimées)
• When Column Are Added (Quand des colonnes sont ajoutées)
• When Columns Are Deleted (Quand des colonnes sont supprimées)

• When Column Properties Are Changed (Quand les propriétés d’une colonne sont modifiées) 
   

  Cet événement fait référence au nom de la colonne.

• When Column Values Are Changed (Quand des valeurs de colonne sont modifiées)
• When Comments Are Added (Quand des commentaires sont ajoutés)
• When Attachments Are Added (Quand des pièces jointes sont ajoutées)

Column Name or ID (Nom ou ID de la colonne)

Identifiant ou le nom de la colonne qui doit déclencher le flux de travail. Si vous indiquez le nom de la colonne, il sera remplacé par l’ID lorsque vous enregistrerez la configuration.

Select Workflow (Sélectionner un flux de travail)

Nom du flux de travail qui sera déclenché.

Données du runtime du flux de travail

Lorsqu’un déclencheur est enregistré, il constitue un webhook dans Smartsheet. Chaque espace de travail enregistre un webhook et tous les événements entrants qui ont lieu dans cet espace de travail sont filtrés en fonction des différents déclencheurs définis.

Les événements entrants des webhooks Smartsheet seront soumis au runtime du flux de travail. Vous pouvez y faire référence dans les flux de travail en saisissant {{runtime}}. L’objet de l’événement contiendra l’ID de la feuille modifiée (si la mise à jour est due à l’intégration de Smartsheet) et les détails de l’événement ayant déclenché le flux de travail.

Exemple de runtime

L’événement sera différent pour chaque type d’événement de webhook :

• Le champ ID fait référence au type d’objet (dans l’exemple ci-dessus, l’élément objectType est une cellule). 
• L’élément eventType est créé ou mis à jour. 
• L’élément objectType peut être une ligne, une colonne, un commentaire, une pièce jointe ou une cellule. 

Vous pouvez voir des informations plus détaillées sur les types de données d’événement possibles dans la documentation sur l’API Smartsheet.

Add Column (Ajouter une colonne)

Utilisez ce module pour ajouter une colonne à une feuille.

Champs du module Add Column (Ajouter une colonne)

Vous pouvez utiliser des références de données dans tous ces champs.

Sheet (Feuille) 

Saisissez le nom ou l’ID de la feuille dans laquelle vous souhaitez ajouter une colonne.  

Column Name (Nom de la colonne) 

Saisissez l’en-tête de la colonne.

Position

Saisissez la valeur qui fait référence à la position d’une colonne dans une feuille.
 

La première colonne d’une feuille est 0.

Type 

Sélectionnez le type de colonne (par ex. Date, Contact List [Liste des contacts], Text/Number [Texte/Nombre], etc.).

• Colonnes Contact List (Liste des contacts) : fournissez les valeurs sous forme de tableau d’objets ou de référence à un tableau d’objets. Le format est entre crochets et chaque paire clé/valeur est entre accolades. Exemple : [{"nom": "John Smith", "e-mail":"john.smith@smartsheet.com"}, {"nom": "Joe Bloggs", "e-mail":"joe.bloggs@smartsheet.com"}]
• Colonnes Dropdown list (Liste déroulante) : vous pouvez ajouter les valeurs sous forme de tableau. Pour ce faire, saisissez les valeurs et appuyez sur la touche Entrée pour les séparer. Vous pouvez également les mettre en forme comme suit : [1, 2 “valeur” , “chaîne de valeur”]. Vous pouvez également fournir une référence à un tableau.

Column Description (Description de la colonne) 

Saisissez la description de la colonne.

Hide Column (Masquer la colonne) 

Sélectionnez cette option pour afficher les colonnes masquées.

Lock Column (Verrouiller la colonne)

Sélectionnez cette option pour afficher les colonnes verrouillées.

Une fois que Bridge aura exécuté le module Add a Column (Ajouter une colonne), ces informations seront disponibles dans la section runlog (journal d’exécution) :

• Data (Données) : tableau
  • Object (Objet)
    • ColumnID (IDColonne) : chaîne
    • Index 
      • Index ou position de la colonne 
      • Ce nombre commence à zéro
    • Primary (Principale) : renvoyé uniquement si la colonne est la colonne principale (valeur = True [Vrai])
    • Title (Intitulé) : nom de l’en-tête de la colonne
    • Type : l’option sélectionnée parmi ces types de colonnes :
      • ABSTRACT_DATETIME (EXTRAIT_DATES_HEURES)
      • CHECKBOX (CASE_À_COCHER)
      • CONTACT_LIST (LISTE_DES_CONTACTS)
      • DATE
      • DATETIME (DATES_HEURES)
      • DURATION (DURÉE)
      • MULTI_CONTACT_LIST (LISTE_CONTACTS_MULTIPLES)
      • MULTI_PICKLIST (LISTE_DE_SÉLECTION_MULTIPLE)
      • PICKLIST (LISTE_DE_SÉLECTION)
      • PREDECESSOR (PRÉCÉDENT)
      • TEXT_NUMBER (TEXTE_NOMBRE)
    • Validation : indique si la validation a été activée pour la colonne
    • Width (largeur) : affiche la largeur de la colonne en pixels
    • Version 
      • Lecture seule 
      • Le niveau du type de colonne 
      • Chaque élément du tableau est défini sur l’une des valeurs suivantes :
        • 0 : TEXT_NUMBER (TEXTE_NOMBRE), CONTACT_LIST (LISTE_DES_CONTACTS) ou PICKLIST (LISTE_DE_SÉLECTION)
        • 1 : MULTI_CONTACT_LIST (LISTE_CONTACTS_MULTIPLES)
        • 2 : MULTI_PICKLIST (LISTE_DE_SÉLECTION_MULTIPLE)

Add Comment To Row (Ajouter un commentaire à une ligne)

Ce module ajoute un commentaire ou répond à un commentaire existant sur une ligne d’une feuille. 

Champs du module Add Comment To Row (Ajouter un commentaire à une ligne)

Sheet (Feuille)

L’ID ou le nom unique de la feuille à modifier

Row ID (ID de la ligne) 

L’ID unique de la ligne à laquelle le commentaire sera ajouté

Reply To (Répondre à) 

L’ID d’un autre commentaire auquel répondra le nouveau commentaire
 

Ce paramètre est facultatif et sera ignoré s’il est laissé vide.

Message 

Le texte à ajouter comme nouveau commentaire ou nouvelle réponse

Données renvoyées par le module Add Comment To Row (Ajouter un commentaire à une ligne)

• Created At (Créé le)
• Created By (Créé par)
  • Email (E-mail)
  • Name (Nom)
• ID (de commentaire)
• Modified At (Modifié le)

Add Row (Ajouter une ligne)

Utilisez ce module pour ajouter une ligne à une feuille.

Champs du module Add Row (Ajouter une ligne)

• Sheet (Feuille) : l’ID ou le nom unique de la feuille à modifier. 
• Cells (Cellules) : utilisez cette section pour mapper les données ajoutées à la ligne sur les colonnes de la feuille.
  • Key (Clé) : le nom ou l’ID de la colonne
  • Value (Valeur) : les données que vous souhaitez ajouter dans la colonne, sur la ligne
• Advanced Cells (Cellules avancées) : utilisez cette section pour des mises à jour de cellules plus avancées
  • Column (Colonne) : le nom ou l’ID de la colonne
  • Type : le type de données des cellules (valeur, formule ou lien hypertexte)

  • Value (Valeur) : la valeur de la cellule
     

    Ce champ sera utilisé uniquement si l’élément Type est défini sur Value (Valeur).

  • Formula (Formule) : la formule à définir pour la cellule
     

    Ce champ sera utilisé uniquement si Type est défini sur Formula (Formule).

  • Hyperlink (Lien hypertexte) : le lien hypertexte à définir sur la cellule. Vous pouvez créer un lien vers une URL, une feuille ou un rapport.
     

    Ce champ sera utilisé uniquement si Type est défini sur Hyperlink (Lien hypertexte).

  • Override Validation (Écraser la validation) : indiquez si la cellule écrasera toute validation définie pour la colonne lors de la définition de la valeur. Vous pouvez sélectionner Default (Défaut) pour utiliser la valeur définie dans Advanced Options (Options avancées) (voir ci-dessous).
• Advanced Options (Options avancées)
  • Numeric Dates (Dates numériques) : indiquez si les valeurs de date doivent être traitées comme des horodatages Unix. Cela permet de définir des valeurs de date ainsi qu’un format de date dans la réponse. Lorsque ce paramètre n’est pas défini, les dates sont renvoyées dans le fuseau horaire UTC au format ISO-8601 (par exemple, AAAA-MM-JJTHH:MM:SS)
  • Locked (Verrouillée) : indiquez si la ligne doit être verrouillée
  • Expanded (Développée) : indiquez si la ligne doit être développée ou réduite
  • Override Validation (Écraser la validation) : définissez cette option si vous souhaitez ignorer par défaut la validation de toutes les cellules de la ligne Vous pouvez également la définir pour chaque cellule individuellement
  • Location (Position) : indiquez l’endroit où la ligne sera ajoutée à la feuille
    • Top (Haut) : ajoute la ligne en haut de la feuille
    • Bottom (Bas) : ajoute la ligne au bas de la feuille
    • Parent ID (ID parent) : ajoute la ligne en tant que ligne enfant à la ligne spécifiée. Par défaut, elle sera ajoutée en tant que première ligne enfant de la ligne parent. Si Bottom (Bas) est coché, elle sera ajoutée comme dernière ligne enfant
    • Sibling ID (ID sœur) : ajoute la ligne à la suite de la ligne spécifiée. Par défaut, elle sera ajoutée après la ligne sœur. Si Top (Haut) est coché, elle sera ajoutée au-dessus de la ligne sœur.

Données renvoyées par le module Add Row (Ajouter une ligne)

• Cells (Cellules)
  • Toutes les colonnes comprennent les éléments suivants :
    • Column ID (ID de la colonne)
    • Display Value (Afficher la valeur)
    • Value (Valeur)
• Created At (Créée le)
• Expanded (Développée)
• ID (de la nouvelle ligne)
• Locked (Verrouillée)
• Locked for User (Verouillée pour l’utilisateur)
• Modified At (Modifiée le)
• Row Number (Numéro de la ligne)
• Sheet ID (ID de la feuille) 

Copy Rows (Copier des lignes)

Vous trouverez ci-après la liste des champs disponibles dans le module. Vous pouvez utiliser des références de données dans tous ces champs.

• Source Sheet ID (ID de la feuille source) : l’ID de la feuille à partir de laquelle les lignes doivent être copiées
• Filter (Filtre) : un filtre Smartsheet sur la feuille source à mapper  
• Target Sheet ID (ID de la feuille cible) : l’ID de la feuille vers laquelle les lignes doivent être copiées 

Une fois que Bridge aura exécuté le module Copy Rows (Copier des lignes), ces informations seront disponibles dans la section runlog (journal d’exécution) : 

• Data (Données) :
  • destinationSheetId (IdFeuilleDestination) : il s’agit de l’ID de la feuille vers laquelle vous copiez votre ligne 
  • rowMappings (MappageLigne) : il s’agit d’une répartition des références pour les données déplacées
• State (État) : ce groupe fournit des détails sur la réussite ou l’échec de l’exécution
  • Code : il s’agit du code de réussite/d’erreur renvoyé par Smartsheet
  • Message : il s’agit d’un message, le cas échéant, renvoyé par Smartsheet. Par exemple, si aucun élément affecté n’a pu être trouvé, le message peut être défini sur « not found » (introuvable)
  • Status (Statut) : il s’agit du statut renvoyé par Smartsheet. Par exemple, si un élément affecté a été trouvé, le statut est défini sur « SUCCEEDED » (RÉUSSITE). Si aucun objet affecté n’a pu être trouvé, l’erreur est définie sur « FAILED » (ÉCHEC).

Deactivate Smartsheet User (Désactiver un utilisateur Smartsheet)

Ce module permet de désactiver automatiquement un utilisateur d’un compte d’organisation. Il ne fonctionnera correctement que s’il est configuré par les administrateurs système des organisations Entreprise. 

Champs du module

• User (Utilisateur) : saisissez l’adresse e-mail ou l’ID de l’utilisateur à désactiver 

Données de la réponse 

• Message : message de réussite ou d’erreur
• Code : 0 indique une réussite ; 3 indique une réussite partielle

Delete Row (Supprimer une ligne)

Utilisez ce module pour supprimer une ligne d’une feuille.

Champs du module Delete Row (Supprimer une ligne)

• Sheet (Feuille) : l’ID ou le nom unique de la feuille à modifier
• Row ID (ID de la ligne) : l’ID unique de la ligne qui sera supprimée

Le module Delete Row (Supprimer une ligne) ne renvoie aucune donnée.

Get Attachment (Obtenir une pièce jointe)

Ce module permet de récupérer une pièce jointe spécifique d’une feuille.

Champs du module Get Attachment (Obtenir une pièce jointe)

• Sheet (Feuille) : l’ID ou le nom unique de la feuille à modifier
• Attachment ID (ID de la pièce jointe) : l’ID unique de la pièce jointe associée à la feuille

Données renvoyées par le module Get Attachment (Obtenir une pièce jointe)

• Attachment Type (Type de pièce jointe)
• Created At (Créée le)
• Created By (Créé par)
  • Email (E-mail)
  • Nom
• ID (de la pièce jointe)
• Mime type (Type mime)
• Nom
• Parent ID (ID parent)
• Parent Type (Type parent)
• Size in Kb (Taille en Ko)
• URL
• URL Expires in Milliseconds (Expiration URL en millisecondes)

Get Column (Obtenir une colonne)

Avant d’ajouter le module Get Column (Obtenir une colonne), assurez-vous d’avoir appliqué le module List Columns (Répertorier les colonnes) au flux de travail. Pour créer une logique de réussite/d’échec, ajoutez un nouvel objet State (État) à l’une des branches.

Champs du module Get Column (Obtenir une colonne)

Vous pouvez utiliser des références de données dans tous ces champs.

Name (Nom) 
Saisissez le nom de l’état du groupe logique de branche. 

Sheet ID (ID de la feuille)
Saisissez le nom ou l’ID de la feuille dans laquelle se trouve la colonne que vous souhaitez extraire. 

Position
Saisissez la valeur qui fait référence à la position d’une colonne dans une feuille.
 

La première colonne d’une feuille est 0.

Column ID (ID de la colonne)
Saisissez l’ID de colonne enregistré dans la section runlog (journal d’exécution) du module List Columns (Répertorier les colonnes).

Une fois que Bridge aura exécuté le module Get Column (Obtenir une colonne), ces informations seront disponibles dans la section runlog (journal d’exécution) :

• Data (Données) : tableau
  • Object (Objet)
    • ColumnID (IDColonne) : chaîne
    • Index 
      • Index ou position de la colonne 
      • Ce nombre commence à zéro
    • Primary (Principale) : renvoyé uniquement si la colonne est la colonne principale (valeur = True [Vrai])
    • Title (Intitulé) : nom de l’en-tête de la colonne
    • Type : l’option sélectionnée parmi ces types de colonnes :
      • ABSTRACT_DATETIME (EXTRAIT_DATES_HEURES)
      • CHECKBOX (CASE_À_COCHER)
      • CONTACT_LIST (LISTE_DES_CONTACTS)
      • DATE
      • DATETIME (DATES_HEURES)
      • DURATION (DURÉE)
      • MULTI_CONTACT_LIST (LISTE_CONTACTS_MULTIPLES)
      • MULTI_PICKLIST (LISTE_DE_SÉLECTION_MULTIPLE)
      • PICKLIST (LISTE_DE_SÉLECTION)
      • PREDECESSOR (PRÉCÉDENT)
      • TEXT_NUMBER (TEXTE_NOMBRE)
    • Validation : indique si la validation a été activée pour la colonne
    • Width (largeur) : affiche la largeur de la colonne en pixels
    • Version 
      • Lecture seule 
      • Le niveau du type de colonne 
      • Chaque élément du tableau est défini sur l’une des valeurs suivantes :
        • 0 : TEXT_NUMBER (TEXTE_NOMBRE), CONTACT_LIST (LISTE_DES_CONTACTS) ou PICKLIST (LISTE_DE_SÉLECTION)
        • 1 : MULTI_CONTACT_LIST (LISTE_CONTACTS_MULTIPLES)
        • 2 : MULTI_PICKLIST (LISTE_DE_SÉLECTION_MULTIPLE)

Get Comment (Obtenir un commentaire)

Récupérez un commentaire ou une discussion spécifique à l’aide de son ID.

Champs du module Get Comment (Obtenir un commentaire)

• Sheet (Feuille) : l’ID ou le nom unique de la feuille à modifier.
• Comment ID (ID du commentaire) : l’ID unique du commentaire associé à la feuille. Vous pouvez également spécifier un ID de discussion, auquel cas le premier commentaire de la discussion sera renvoyé.
• Include Discussion (Inclure la discussion) : indique si vous souhaitez que la discussion soit également incluse dans la réponse. Cela se produira automatiquement si vous indiquez un ID de discussion.

Données renvoyées par le module Get Comment (Obtenir un commentaire)

• Comment (Commentaire)
  • Created At (Créé le)
  • Created By (Créé par)
    • Email (E-mail)
    • Nom
  • ID
  • Modified At (Modifié le)
  • Text (Texte)
• Discussion
  • Access level (Niveau d’accès)
  • Comment Count (Nombre de commentaires)
  • Comments (Commentaires)
    • Created At (Créé le)
    • Created By (Créé par)
      • Email (E-mail)
      • Nom
  • ID
  • Modified At (Modifié le)
  • Text (Texte)
  • Created By (Créée par)
  • Email (E-mail)
  • Nom
  • ID
  • Last Commented At (Date du dernier commentaire)
  • Last Commented User (Utilisateur du dernier commentaire)
    • Email (E-mail)
    • Nom
  • Parent ID (ID parent)
  • Parent Type (Type parent)
  • Titre

Get Report (Obtenir un rapport)

Ce module permet d’obtenir des détails à partir d’un rapport Smartsheet.

Champs du module Get Report (Obtenir un rapport)

• Report (Rapport) : l’ID ou le nom unique du rapport à modifier. 
• Filters (Filtres) : options permettant de filtrer les colonnes et les lignes qui seront renvoyées.
  • Page Number (Numéro de page) : utilisé pour obtenir des résultats par lots de pages. Spécifiez un numéro de page compris entre 1 et le nombre de pages disponibles (un nombre allant au-delà renverra la dernière page) pour obtenir une sous-section des résultats. Si vous ne la définissez pas, la valeur par défaut est 1.
  • Results Per Page (Résultats par page) : le nombre de résultats qui seront renvoyés en même temps. Si vous ne la définissez pas, la valeur par défaut est 100.
• Advanced Options (options avancées) :
  • Numeric Date (Date numérique) : indique si vous souhaitez que les valeurs de date soient renvoyées au format numérique, en millisecondes depuis l’heure UNIX (le 1er janvier 1970 à minuit, heure UTC).
  • Include Attachments (Inclure les pièces jointes) : inclut toutes les pièces jointes de la feuille et de la ligne.
  • Include Comments (Inclure les commentaires) : inclut l’ensemble des commentaires et discussions de la feuille et de la ligne.
  • Include Link In from Cell details (Inclure les détails de lien depuis une cellule) : inclut le statut, l’ID de ligne et l’ID de colonne provenant des détails de lien depuis une cellule.
  • Include Link In from Cell details (Inclure les détails de liens vers des cellules) : inclut le statut, l’ID de ligne et l’ID de colonne provenant des détails de liens vers des cellules.
  • Source : inclut des informations sur la source du rapport.
  • Source Sheets (Feuilles source) : inclut des informations sur les feuilles source.

Données renvoyées par le module Get Report (Obtenir un rapport)

• Access level (Niveau d’accès)
• Cell Image Upload Enabled (Chargement d’image de cellule activé)
• Columns (Colonnes) : toutes les colonnes sont incluses
  • Index
  • Sheet Name Column (Colonne de nom de feuille)
  • Title (Intitulé)
  • Type
  • Validation
  • Version
  • Virtual ID (ID virtuelle)
  • Width (Largeur)
• Created At (Créé le)
• Effective Attachment Options (Options des pièces jointes effectives : Evernote, Google Drive, File, Box.com, Dropbox, OneDrive, Egnyte, Link)
• Gantt Enabled (Gantt activé)
• ID
• Modified At (Modifiée le)
• Nom
• Permalink (Lien permanent)
• Read Only (Lecture seule)
• Rows (Lignes)
  • Access level (Niveau d’accès)
  • Cells (Cellules) : toutes les cellules sont incluses
    • Nom
      • Column ID (ID de la colonne)
      • Display Value (Afficher la valeur)
      • Value (Valeur)
      • Virtual Column ID (ID de la colonne virtuel)
  • Created At (Créée le)
  • Expanded (Développée)
  • ID
  • Modified At (Modifiée le)
  • Row Number (Numéro de ligne)
  • Sheet ID (ID de la feuille)
  • Sibling ID (ID de la ligne sœur)
  • Access level (Niveau d’accès)
  • Cells (Cellules)
    • Column ID (ID de la colonne)
    • Display Value (Afficher la valeur)
    • Value (Valeur)
    • Virtual Column ID (ID de la colonne virtuel)
  • Created At (Créée le)
    • Expanded (Développée)
    • ID
    • Modified At (Modifiée le)
    • Row Number (Numéro de ligne)
    • Sheet ID (ID de la feuille)
    • Sibling ID (ID de la ligne sœur)
  • Total Row Count (Nombre total de lignes)

Get Row (Obtenir une ligne)

Ce module permet de récupérer des détails à partir d’une ligne d’une feuille.

Champs du module Get Row (Obtenir une ligne)

• Sheet (Feuille) : l’ID ou le nom unique de la feuille.
• Row ID (ID de la ligne) : l’ID unique de la ligne.
• Advanced Options (Options avancées)
  • Numeric Date (Date numérique) : indique si vous souhaitez que les valeurs de date soient renvoyées au format numérique, en millisecondes depuis l’heure UNIX (le 1er janvier 1970 à minuit, heure UTC).
  • Include Attachments (Inclure les pièces jointes) : inclut toutes les pièces jointes de la ligne.
  • Include Comments (Inclure les commentaires) : inclut l’ensemble des commentaires et discussions de la ligne.
  • Include Columns (Inclure les colonnes) : inclut des informations sur toutes les colonnes de la feuille.
  • Include Link In from Cell details (Inclure les détails de lien depuis une cellule) : inclut le statut, l’ID de ligne et l’ID de colonne provenant des détails de lien depuis une cellule.
  • Include Link In from Cell details (Inclure les détails de liens vers des cellules) : inclut le statut, l’ID de ligne et l’ID de colonne provenant des détails de liens vers des cellules.
  • Include Row Permanent Link (Inclure le lien permanent de la ligne) : inclut un lien direct vers la ligne dans l’application Smartsheet.
  • Include Row Writer Information (Inclure des informations sur l’auteur de la ligne) : inclut des détails supplémentaires sur le créateur des lignes et sur la personne qui les a modifiées en dernier.
  • Exclude Empty Cells (Exclure les cellules vides) : exclut les cellules qui n’ont jamais contenu de données.

Données renvoyées par le module Get Row (Obtenir une ligne)

• Row (Ligne)
  • Cells (Cellules)
    • Nom
      • Column ID (ID de la colonne)
      • Display Value (Afficher la valeur)
      • Value (Valeur)
• Created At (Créée le)
• Expanded (Développée)
• ID
• Locked (Verrouillée)
• Locked for User (Verouillée pour l’utilisateur)
• Modified At (Modifiée le)
• Row Number (Numéro de ligne)
• Sheet ID (ID de la feuille)
• Version

Get Sheet (Obtenir une feuille)

Ce module permet d’obtenir des informations à partir d’une feuille entière dans Smartsheet.

Champs du module Get Sheet (Obtenir une feuille)

• Sheet (Feuille) : l’ID ou le nom unique de la feuille.
• Filters (Filtres)
  • Columns (Colonnes) : le nom ou l’ID des colonnes que vous souhaitez inclure dans la réponse. Si ce paramètre n’est pas défini, toutes les colonnes sont renvoyées. Les données de cellule renvoyées ne comprendront que les colonnes sélectionnées.
  • Row IDs (ID des lignes) : une liste d’ID pour les lignes qui doivent être incluses dans la demande.
  • Row Numbers (Numéros des lignes) : une liste des numéros des lignes qui doivent être incluses dans la demande. Les numéros de ligne inexistants seront ignorés.
  • Page Number (Numéro de page) : utilisé pour obtenir des résultats par lots de pages. Spécifiez un numéro de page compris entre 1 et le nombre de pages disponibles (un nombre allant au-delà renverra la dernière page) pour obtenir une sous-section des résultats. Si vous ne la définissez pas, la valeur par défaut est 1.
  • Results Per Page (Résultats par page) : le nombre de résultats qui seront renvoyés en même temps. Si vous ne la définissez pas, la valeur par défaut est 100.
• Advanced Options (Options avancées)
  • Numeric Date (Date numérique) : indique si vous souhaitez que les valeurs de date soient renvoyées au format numérique, en millisecondes depuis l’heure UNIX (le 1er janvier 1970 à minuit, heure UTC).
  • Include Attachments (Inclure les pièces jointes) : inclut toutes les pièces jointes de la feuille et de la ligne.
  • Include Comments (Inclure les commentaires) : inclut l’ensemble des commentaires et discussions de la feuille et de la ligne.
  • Include Link In from Cell details (Inclure les détails de lien depuis une cellule) : inclut le statut, l’ID de ligne et l’ID de colonne provenant des détails de lien depuis une cellule.
  • Include Link In from Cell details (Inclure les détails de liens vers des cellules) : inclut le statut, l’ID de ligne et l’ID de colonne provenant des détails de liens vers des cellules.
  • Include Row Permanent Link (Inclure le lien permanent de la ligne) : inclut un lien direct vers la ligne dans l’application Smartsheet.
  • Include Row Writer Information (Inclure des informations sur l’auteur de la ligne) : inclut des détails supplémentaires sur le créateur des lignes et sur la personne qui les a modifiées en dernier.
  • Exclude Empty Cells (Exclure les cellules vides) : exclut les cellules qui n’ont jamais contenu de données.
  • Owner Info (Information sur le propriétaire) : inclut des informations sur le propriétaire de la feuille.
  • Source : inclut des informations sur la source de la feuille.

Données renvoyées par le module Get Sheet (Obtenir une feuille)

• Access level (Niveau d’accès)
• Cell Image Upload Enabled (Chargement d’image de cellule activé)
• Columns (Colonnes)
  • ID
  • Index
  • Primary (Principale)
  • Title (Intitulé)
  • Type
  • Validation
  • Version
  • Width (Largeur)
• Created At (Créée le)
• Dependencies Enabled (Interdépendances activées)
• Effective Attachment Options (Options des pièces jointes effectives : File, Box.com, Evernote, Dropbox, Egnyte, OneDrive, Google Drive)
• Gantt Enabled (Gantt activé)
• Has Summary Fields (A des champs récapitulatifs)
• ID
• Modified At (Modifiée le)
• Nom
• Permalink (Lien permanent)
• Resource Management activée
• Rows (Lignes)
  • Cells (Cellules)
    • Column Name (Nom de la colonne)
      • Column ID (ID de la colonne)
      • Display Value (Afficher la valeur)
      • Value (Valeur)
    • Created At (Créée le)
    • Expanded (Développée)
    • ID
    • Modified At (Modifiée le)
    • Row Number (Numéro de ligne)
    • Total Row Count (Nombre total de lignes)
    • User Permissions (Autorisations d’utilisateur)
      • Summary Permissions (Récapitulatif des autorisations)
    • User Settings (Paramètres d’utilisateur)
      • Critical Path Enabled (Chemin critique activé)
      • Display Summary Tasks (Afficher le récapitulatif des tâches)
• Version

Get Update Request (Obtenir une demande d’actualisation)

Ce module fait office de jonction et affiche un chemin qui bifurque en fonction du résultat. Il y a trois résultats possibles :

• Update request found (Demande d’actualisation trouvée)
• Demande d’actualisation
• No sheet found (Feuille introuvable) 

Donnez un nom à ce module lorsque vous le faites glisser vers un flux de travail.

La bonne pratique à appliquer consiste à le nommer à partir du module.

Champs du module Get Update Request (Obtenir une demande d’actualisation)

Sheet ID or Name (ID ou nom de la feuille)

Dans ce champ, saisissez l’ID ou le nom de la feuille. 

Update Request ID (ID de la demande d’actualisation)

Dans ce champ, saisissez l’ID de la demande d’actualisation. 

Vous pouvez utiliser des références de données dans ces champs.

Une fois que Bridge aura exécuté le module Get Update Request (Obtenir une demande d’actualisation), ces informations seront disponibles dans la section runlog (journal d’exécution) : 

• Data (Données) :
  • ccSender (ccExpéditeur)
  • columnIds (IDcolonnes) : cela fournira un tableau des ID de colonne dans la demande d’actualisation.
  • createdAt (crééeLe) : date de création de la demande d’actualisation. 
  • id : l’ID de la demande d’actualisation. 
  • includeAttachments (inclurePiècesJointes) : indique si les pièces jointes étaient incluses dans la demande d’actualisation. 
  • includeComments (inclureCommentaires): indique si les commentaires étaient inclus dans la demande d’actualisation. 
  • message : le texte de la demande d’actualisation. 
  • modifiedAt (modifiéeLe) : date à laquelle la demande d’actualisation a été modifiée. 
  • recipients (destinataires) : utilisateurs ayant reçu la demande d’actualisation.
  • rowIds (IdLignes) : les ID des lignes incluses dans la demande d’actualisation. 
  • schedule (planning) : moment où la demande d’actualisation a été envoyée. 
  • sentBy (envoyéePar) : 
    • indique l’adresse e-mail et le nom de l’expéditeur, l’utilisateur qui a authentifié l’intégration de Smartsheet dans Bridge.
  • subject (objet) : la ligne d’objet de la demande d’actualisation. 
• State (État) : il s’agit du statut renvoyé par le module à partir de Smartsheet. 
  • Voici quelques exemples de libellés de statut que vous pourriez rencontrer :
  • Succeeded (Réussite) : le système a trouvé les informations.
  • Failed (Échec) : le système n’a pas trouvé les informations.

Get User (Obtenir l’utilisateur)

Obtenez les détails de l’utilisateur en fonction d’un e-mail ou d’un ID utilisateur et redirigez le flux de travail selon qu’un utilisateur est trouvé ou non.

Champs du module Get User (Obtenir l’utilisateur)

• Name (nom) : nom de la jonction.
• User (Utilisateur) : adresse e-mail ou ID de l’utilisateur.

Données renvoyées par le module Get User (Obtenir l’utilisateur)

En cas de réussite

• Account (Compte)
  • ID
  • Nom
• Alternate Emails (Adresses e-mail alternatives)
• Company (Société)
• Department (Service)
• Email (E-mail)
• First Name (Prénom)
• ID
• Last Name (Nom)
• Locale (Région)
• Mobile Phone (Téléphone portable)
• Profile Image (Image de profil)
  • Height (Hauteur)
  • Image ID (ID de l’image)
  • Width (Largeur)
• Role (Rôle)
• Timezone (Fuseau horaire)
• Title (Titre)
• Work Phone (Téléphone professionnel)

En cas d’échec

• Message renvoyé : « failed to find user » (n’a pas pu trouver l’utilisateur)

List Columns (Répertorier les colonnes)

Le module List Columns (Répertorier les colonnes) renvoie toutes les colonnes disponibles dans une feuille spécifiée. Vous pouvez l’utiliser avec le module Get Column (Obtenir une colonne) pour renvoyer la référence Column ID (ID de la colonne).

Champ du module List Columns (Répertorier les colonnes)

Vous pouvez utiliser des références de données dans ce champ.

Sheet (Feuille)

Saisissez le nom ou l’ID de la feuille dans laquelle vous souhaitez récupérer les colonnes. 

Une fois que Bridge aura exécuté le module List Columns (Répertorier les colonnes) dans un flux de travail, ces informations seront disponibles dans la section runlog (journal d’exécution) :

• Data (Données) : tableau
  • Object (Objet)
    • ColumnID (IDColonne) : chaîne
    • Index 
      • Index ou position de la colonne 
      • Ce nombre commence à zéro
    • Primary (Principale) : renvoyé uniquement si la colonne est la colonne principale (valeur = True [Vrai])
    • Title (Intitulé) : nom de l’en-tête de la colonne
    • Type : l’option sélectionnée parmi ces types de colonnes :
      • ABSTRACT_DATETIME (EXTRAIT_DATES_HEURES)
      • CHECKBOX (CASE_À_COCHER)
      • CONTACT_LIST (LISTE_DES_CONTACTS)
      • DATE
      • DATETIME (DATES_HEURES)
      • DURATION (DURÉE)
      • MULTI_CONTACT_LIST (LISTE_CONTACTS_MULTIPLES)
      • MULTI_PICKLIST (LISTE_DE_SÉLECTION_MULTIPLE)
      • PICKLIST (LISTE_DE_SÉLECTION)
      • PREDECESSOR (PRÉCÉDENT)
      • TEXT_NUMBER (TEXTE_NOMBRE)
    • Validation : indique si la validation a été activée pour la colonne
    • Width (largeur) : affiche la largeur de la colonne en pixels
    • Version 
      • Lecture seule 
      • Le niveau du type de colonne 
      • Chaque élément du tableau est défini sur l’une des valeurs suivantes :
        • 0 : TEXT_NUMBER (TEXTE_NOMBRE), CONTACT_LIST (LISTE_DES_CONTACTS) ou PICKLIST (LISTE_DE_SÉLECTION)
        • 1 : MULTI_CONTACT_LIST (LISTE_CONTACTS_MULTIPLES)
        • 2 : MULTI_PICKLIST (LISTE_DE_SÉLECTION_MULTIPLE)
  • State (État) : consultez cette section pour vérifier si le module a fonctionné
    • Code : il s’agit du code de réussite/d’erreur renvoyé par le module depuis Smartsheet
    • Message : message système renvoyé par le module depuis Smartsheet.
      • Par exemple, si un module ne trouve pas la valeur, le message qui s’affiche peut être « Not found » (Introuvable)
    • Status (Statut) : il s’agit du statut renvoyé par le module à partir de Smartsheet. Voici quelques exemples que vous pourriez rencontrer :
      • Succeeded : le module a trouvé la valeur
      • Failed : le module n’a pas trouvé la valeur

List Sheets (Répertorier les feuilles)

Répertoriez toutes les feuilles disponibles dans Smartsheet.

Champs du module List Sheets (Répertorier les feuilles)

• Filters (Filtres) : options permettant de filtrer les colonnes et les lignes qui seront renvoyées.
  • Modified Since (Modifiées depuis) : indiquez si vous souhaitez uniquement les feuilles qui ont été modifiées depuis un moment donné. La date est exprimée dans le fuseau horaire UTC au format ISO-8601, AAAA-MM-JJTHH:MM:SS. Si l’objet Numeric Dates (Dates numériques) est défini, la date est alors indiquée en millisecondes depuis l’heure UNIX (minuit le 1er janvier 1970, en heure UTC).
  • Page Number (numéro de page) : utilisé pour obtenir des résultats par lots de pages. Spécifiez un numéro de page compris entre 1 et le nombre de pages disponibles (un nombre allant au-delà renverra la dernière page) pour obtenir une sous-section des résultats. Si vous ne la définissez pas, la valeur par défaut est 1.
  • Results Per Page (Résultats par page) : le nombre de résultats qui seront renvoyés en même temps. Si vous ne la définissez pas, la valeur par défaut est 100.
• Advanced Options (Options avancées)
  • Numeric Date (Date numérique) : indique si vous souhaitez que les valeurs de date soient renvoyées au format numérique, en millisecondes depuis l’heure UNIX (le 1er janvier 1970 à minuit, heure UTC). Lorsque ce paramètre n’est pas défini, les dates sont renvoyées dans le fuseau horaire UTC au format ISO-8601 (AAAA-MM-JJTHH:MM:SS).
  • Sheet Version (Version de la feuille) : inclut des informations sur la version de la feuille.
  • Source : inclut des informations sur la source de la feuille.

Données renvoyées par le module List Sheets (Répertorier les feuilles)

• Data (Données)
  • Access level (Niveau d’accès)
  • Created At (Créée le)
  • ID
  • Modified At (Modifiée le)
  • Nom
  • Permalink (Lien permanent)
  • Source
    • ID
    • Type
  • Version
• Page Number (Numéro de page)
• Page Size (Taille de la page)
• Total Count (Nombre total)
• Total Pages (Total des pages)

Manage Alternate Email (Gérer les adresses e-mail alternatives)

Gérez les adresses e-mail alternatives d’un utilisateur.

Ce module ne fonctionnera que si vous êtes authentifié en tant qu’administrateur système de votre compte Smartsheet.

Champs du module Manage Alternate Email (Gérer les adresses e-mail alternatives)

• User (Utilisateur) : adresse e-mail ou ID de l’utilisateur que vous souhaitez modifier.
• Alternate Emails (Adresses e-mail alternatives) : la liste des adresses e-mail alternatives que vous souhaitez ajouter à l’utilisateur. Vous pouvez laisser ce champ vide et choisir de supprimer les autres adresses e-mail pour effacer toutes les adresses e-mail alternatives d’un utilisateur.
• Delete other emails (Supprimer les autres adresses e-mail) : indiquez si vous souhaitez supprimer les autres adresses e-mail de l’utilisateur déjà définies (non spécifiées comme adresses e-mail alternatives ci-dessus).

Données renvoyées par le module Manage Alternate Email (Gérer les adresses e-mail alternatives)

• Removed (Supprimée)
• Added (Ajoutée)
  • ID
  • Email (E-mail)

Reactivate Smartsheet User (Réactiver un utilisateur Smartsheet)

Ce module permet de réactiver automatiquement un utilisateur d’un compte d’organisation. Lorsqu’il est utilisé pour réactiver un utilisateur, ce dernier retrouve l’accès à Smartsheet et aura les mêmes rôles que lorsqu’il a été désactivé. Ce module ne fonctionnera correctement que s’il est configuré par les administrateurs système des organisations Entreprise.

Champs du module

• User (Utilisateur) : saisissez l’adresse e-mail ou l’ID de l’utilisateur à désactiver 

Données de la réponse 

• Message : message de réussite ou d’erreur
• Code : 0 indique une réussite ; 3 indique une réussite partielle

Search Sheet (Chercher dans la feuille)

Effectuez une recherche dans une feuille et renvoyez les colonnes et les lignes qui répondent aux conditions de filtrage en fonction du contenu des cellules.

Champs du module Search Sheet (Chercher dans la feuille)

• Sheet (Feuille) : l’ID ou le nom unique de la feuille. 
• Filters (Filtres) : options permettant de filtrer les colonnes et les lignes qui seront renvoyées.
  • Columns (Colonnes) : le nom ou l’ID des colonnes que vous souhaitez inclure dans la réponse. Si ce paramètre n’est pas défini, toutes les colonnes sont renvoyées. Les données de cellule renvoyées ne comprendront que les colonnes sélectionnées.
  • Row Filters (Filtres de ligne) : un tableau de conditions de filtre qui détermineront les lignes renvoyées. Une ligne doit répondre à toutes les conditions de filtre pour être renvoyée. Si vous spécifiez plusieurs valeurs pour une condition de filtre, la condition ne doit être valide que pour une seule valeur. Il existe deux exceptions : Is Not Equal To (n’est pas égale à), où la valeur de la cellule ne doit être égale à aucune des valeurs fournies, et Between (Entre), où vous devez spécifier deux valeurs et où la valeur de la cellule doit être un nombre valide compris entre les valeurs de début et de fin spécifiées, à l’exclusion des valeurs de début et de fin elles-mêmes.
    • Column (Colonne) : le nom ou l’ID de la colonne.
    • Condition : le type de condition à appliquer au filtre.
    • Values (Valeurs) : les valeurs à comparer à la valeur de la cellule en fonction de la condition du filtre.
• Advanced Options (options avancées) :
  • Numeric Date (Date numérique) : indique si vous souhaitez que les valeurs de date soient renvoyées au format numérique, en millisecondes depuis l’heure UNIX (le 1er janvier 1970 à minuit, heure UTC).
  • Include Attachments (Inclure les pièces jointes) : inclut toutes les pièces jointes de la feuille et des lignes.
  • Include Comments (Inclure les commentaires) : inclut l’ensemble des commentaires et discussions de la feuille et des lignes.
  • Include Link In from Cell details (Inclure les détails de lien depuis une cellule) : inclut le statut, l’ID de ligne et l’ID de colonne provenant des détails de lien depuis une cellule.
  • Include Link In from Cell details (Inclure les détails de liens vers des cellules) : inclut le statut, l’ID de ligne et l’ID de colonne provenant des détails de liens vers des cellules.
  • Include Row Permanent Link (Inclure le lien permanent de la ligne) : inclut un lien direct vers la ligne dans l’application Smartsheet.
  • Include Row Writer Information (Inclure des informations sur l’auteur de la ligne) : inclut des détails supplémentaires sur le créateur des lignes et sur la personne qui les a modifiées en dernier.
  • Exclude Empty Cells (Exclure les cellules vides) : exclut les cellules qui n’ont jamais contenu de données.
  • Owner Info (Information sur le propriétaire) : inclut des informations sur le propriétaire de la feuille.
  • Source : inclut des informations sur la source de la feuille.

Données renvoyées par le module Search Sheet (Chercher dans la feuille)

Les données de la feuille peuvent être incluses en sélectionnant Advanced Option (Options avancées), Include Sheet Data (Inclure les données de la feuille). Il s’agira de l’objet de la feuille défini par le module Get Sheet (Obtenir une feuille), avec les lignes et les colonnes filtrées comme indiqué.

Les données renvoyées contiennent toutes les colonnes (ou uniquement celles définies dans les filtres), affichant la valeur Column Name (Nom de la colonne) et la valeur de cellule pour toutes les lignes trouvées.

Problèmes connus de Search Sheet (Chercher dans la feuille)

Actuellement, les conditions de filtrage des champs de date fonctionnent différemment selon que l’option Numeric Dates (Dates numériques) est sélectionnée ou non. 

• Si cette option est sélectionnée, la valeur sera traitée comme un nombre, ce que les conditions de filtrage doivent refléter. 
• Sinon, si l’option Numeric Dates (Dates numériques) n’est pas cochée, la valeur de la cellule est une chaîne. Cela signifie que les conditions de filtrage Less Than, More Than et Between (Inférieure à, Supérieure à et Entre) ne fonctionneront pas.

Send Update Request (Envoyer une demande d’actualisation)

Utilisez ce module pour envoyer une demande d’actualisation lorsque Bridge détecte les événements déclencheurs que vous avez identifiés.

Champs du module Send Update Request (Envoyer une demande d’actualisation)

Vous pouvez utiliser des références de données dans ces champs.

Sheet ID or Name (ID ou nom de la feuille) 

Dans ce champ, saisissez l’ID ou le nom de la feuille. 

Recipient Email (E-mail du destinataire) 

Dans ce champ, saisissez l’adresse e-mail ou la référence de données du destinataire. 

Row ID (ID de la ligne) 

L’ID de la ligne à envoyer en tant que demande d’actualisation. 

Customize Message (Personnaliser le message) 

Dans cette section, remplissez les champs suivants pour configurer le message que vous devez envoyer à l’utilisateur : 

• Message Subject (Objet du message) : la ligne d’objet de l’e-mail contenant la demande d’actualisation.
  • Si vous n’avez pas saisi de texte, l’objet par défaut sera Update Request: {{Primary Column Data}} (Demande d’actualisation : {{Données de la colonne principale}}).
  • Vous pouvez utiliser ce champ pour écrire un objet personnalisé que le flux de travail enverra toujours dans l’e-mail de demande d’actualisation. 
  • Vous pouvez également utiliser les données d’une autre partie de votre flux de travail pour remplir la ligne d’objet. Pour importer des données depuis une autre partie de votre flux de travail Bridge, copiez la référence appropriée à partir du volet Run Log (journal d’exécution). Collez-la ensuite dans ce champ.
• Message Content (Contenu du message) : le message de l’e-mail de demande d’actualisation. 
  • Si vous n’avez pas saisi de message, le texte par défaut sera Please update my online sheet (Veuillez actualiser ma feuille en ligne).
  • Vous pouvez utiliser ce champ pour écrire un message personnalisé que le flux de travail enverra toujours dans la demande d’actualisation. 
  • Vous pouvez également utiliser les données d’une autre partie de votre flux de travail pour remplir le champ Message. Pour importer des données depuis une autre partie de votre flux de travail Bridge, copiez la référence appropriée à partir du volet Run Log (journal d’exécution). Collez-la ensuite dans ce champ.
• Include Specific Columns (Inclure des colonnes spécifiques) : par défaut, Bridge inclut toutes les colonnes. 
  • Pour inclure uniquement des colonnes spécifiques, saisissez les ID ou la référence des colonnes dans ce champ. Séparez alors les valeurs par une virgule. 
• CC Sender? (CC expéditeur ?) : mettez en copie l’utilisateur qui a authentifié l’intégration de Smartsheet. 
• Don’t Include Attachments (Ne pas inclure les pièces jointes) : exclure les pièces jointes de la demande d’actualisation. 
• Don’t Include Comments (Ne pas inclure les commentaires) : supprimez la colonne Comments/Conversations (Commentaires/Conversations) de la demande d’actualisation. 

Une fois que Bridge aura exécuté le module Send Update Request (Envoyer une demande d’actualisation), ces informations seront disponibles dans le volet Run Log (journal d’exécution) :

• Data (Données)
  • ccSender (ccExpéditeur)
  • columnIds (IdColonnes) : cela fournira les différents ID de colonne inclus dans la demande d’actualisation.
  • id : l’ID de la demande d’actualisation. 
  • includeAttachments (inclurePiècesJointes) : indique si les pièces jointes étaient incluses dans la demande d’actualisation.
  • includeComments (inclureCommentaires): indique si les commentaires étaient inclus dans la demande d’actualisation.
  • message : le texte de la demande d’actualisation. 
  • recipients (destinataires) : utilisateurs ayant reçu la demande d’actualisation.
  • rowIds (IdLignes) : les ID des lignes incluses dans la demande d’actualisation. 
  • schedule (planning) : moment où la demande d’actualisation a été envoyée.
  • sentBy (Envoyée par) : indique l’adresse e-mail et le nom de l’expéditeur, à savoir l’utilisateur qui a authentifié l’intégration de Smartsheet dans Bridge.
  • subject (objet) : la ligne d’objet de la demande d’actualisation.
• State (État) : consultez cette section pour vérifier si le module a fonctionné. 
  • Code : il s’agit du code de réussite/d’erreur renvoyé par le module depuis Smartsheet.
  • Message : message système renvoyé par le module depuis Smartsheet. 
    • Par exemple, si un module n’a pas trouvé la valeur, le message qui s’affiche peut être « Not found » (Introuvable).
  • Status (Statut) : il s’agit du statut renvoyé par le module à partir de Smartsheet. 
    • Voici quelques exemples de libellés de statut que vous pourriez rencontrer :
      • Succeeded (Réussite) : le système a trouvé les informations.
      • Failed (Échec) : le système n’a pas trouvé les informations.

Share Sheet (Partager une feuille)

Partagez des feuilles avec d’autres utilisateurs.

Champs du module Share Sheet (Partager une feuille)

• Sheet (Feuille) : l’ID ou le nom unique de la feuille. 
• Send Email (Envoyer un e-mail) : indiquez si vous souhaitez envoyer un e-mail aux destinataires ainsi qu’une notification dans Smartsheet.
• Recipients (Destinataires) : liste des destinataires de la demande de partage.
  • Email (E-mail) : l’adresse e-mail du destinataire. 
  • Group ID (ID de groupe) : l’ID de groupe du destinataire.

La valeur Email (E-mail) ou Group ID (ID de groupe) doit être spécifiée, mais pas les deux. L’ID de groupe sera ignoré au profit de l’adresse e-mail si les deux valeurs sont fournies.

• Access Level (Niveau d’accès) : le niveau d’accès du destinataire. Il peut s’agir de l’une des valeurs suivantes :
  • Admin (Administrateur)
  • Editor (Éditeur)
  • Editor with sharing (Éditeur avec partage)
  • Propriétaire
  • Viewer (Spectateur)
• Subject (objet) : l’objet de l’e-mail à envoyer au destinataire.
• Message : le message de l’e-mail à envoyer au destinataire.
• CC Me (me mettre en copie) : indiquez si vous devez être inclus lors de l’envoi de l’e-mail au destinataire.

Update Column (Actualiser une colonne)

Champs du module Update Column (Actualiser une colonne)

Vous pouvez utiliser des références de données dans tous ces champs.

Sheet (Feuille) 

Saisissez le nom ou l’ID de la feuille dans laquelle vous souhaitez mettre à jour les valeurs de colonne.  

Column Name (Nom de la colonne) 

Saisissez l’en-tête de la colonne.

Position 

Saisissez la valeur qui fait référence à la position d’une colonne dans une feuille. 
 

La première colonne d’une feuille est 0. 

Type 

Sélectionnez le type de colonne (par ex. Date, Contact List [Liste des contacts], Text/Number [Texte/Nombre], etc.).

• Colonnes Contact List (Liste des contacts) : fournissez les valeurs sous forme de tableau d’objets ou de référence à un tableau d’objets. Le format est entre crochets et chaque paire clé/valeur est entre accolades. Exemple : [{"nom": "John Smith", "e-mail":"john.smith@smartsheet.com"}, {"nom": "Joe Bloggs", "e-mail":"joe.bloggs@smartsheet.com"}]
• Colonnes Dropdown list (Liste déroulante) : vous pouvez ajouter les valeurs sous forme de tableau. Pour ce faire, saisissez les valeurs et appuyez sur la touche Entrée pour les séparer. Vous pouvez également mettre en forme les valeurs comme suit : [1, 2 “valeur” , “chaîne de valeur”]. Vous pouvez également fournir une référence à un tableau.

Column Description (Description de colonne) 

Saisissez la description de la colonne.

Hide Column (Masquer la colonne) 

Sélectionnez cette option pour afficher les colonnes masquées.

Lock Column (Verrouiller la colonne) 

Sélectionnez cette option pour afficher les colonnes verrouillées.

Une fois que Bridge aura exécuté le module Updated Column (Actualiser une colonne), ces informations seront disponibles dans la section runlog (journal d’exécution) :

• Data (Données) : tableau
  • Object (Objet) :
    • ColumnID (IDColonne) : chaîne
    • Index 
      • Index ou position de la colonne 
      • Ce nombre commence à zéro
    • Primary (Principale) : renvoyé uniquement si la colonne est la colonne principale (valeur = True [Vrai])
    • Title (Intitulé) : nom de l’en-tête de la colonne
    • Type : l’option sélectionnée parmi ces types de colonnes :
      • ABSTRACT_DATETIME (EXTRAIT_DATES_HEURES)
      • CHECKBOX (CASE_À_COCHER)
      • CONTACT_LIST (LISTE_DES_CONTACTS)
      • DATE
      • DATETIME (DATES_HEURES)
      • DURATION (DURÉE)
      • MULTI_CONTACT_LIST (LISTE_CONTACTS_MULTIPLES)
      • MULTI_PICKLIST (LISTE_DE_SÉLECTION_MULTIPLE)
      • PICKLIST (LISTE_DE_SÉLECTION)
      • PREDECESSOR (PRÉCÉDENT)
      • TEXT_NUMBER (TEXTE_NOMBRE)
    • Validation : indique si la validation a été activée pour la colonne
    • Width (largeur) : affiche la largeur de la colonne en pixels
    • Version
      • Lecture seule 
      • Le niveau du type de colonne 
      • Chaque élément du tableau est défini sur l’une des valeurs suivantes :
        • 0 : TEXT_NUMBER (TEXTE_NOMBRE), CONTACT_LIST (LISTE_DES_CONTACTS) ou PICKLIST (LISTE_DE_SÉLECTION)
        • 1 : MULTI_CONTACT_LIST (LISTE_CONTACTS_MULTIPLES)
        • 2 : MULTI_PICKLIST (LISTE_DE_SÉLECTION_MULTIPLE)

Update Row (Actualiser une ligne)

Actualisez une ligne d’une feuille.

Champs du module Update Row (Actualiser une ligne)

• Sheet (Feuille)
• Row ID (ID de la ligne)
• Calls (Appels)
  • Key/Value (Clé/Valeur)
• Advanced Cells (Cellules avancées) : un tableau de définitions de colonne.
  • Column (Colonne) : le nom ou l’ID de la colonne.
  • Input Type (Type d’entrée)
    • Value (Valeur) : la valeur de la cellule.
    • Formula (Formule) : la formule à définir pour la cellule.
    • Hyperlink (Lien hypertexte) : le lien hypertexte à définir sur la cellule. Vous pouvez créer un lien vers une URL, une feuille ou un rapport.
    • Link In From Cell (Lien depuis une cellule) : un lien vers une autre cellule d’une autre feuille à définir dans la cellule. Vous devrez spécifier l’ID de la feuille, de la colonne et de l’ID de ligne de la cellule à associer à cette cellule.
• Advanced Options (Options avancées)
  • Numeric Dates (Dates numériques) : indiquez si les valeurs de date doivent être traitées comme des horodatages Unix. Cela permet de définir des valeurs de date ainsi qu’un format de date dans la réponse. Lorsque cette option n’est pas définie, les dates sont renvoyées au format ISO 8601, par exemple, 2000-12-25.
  • Locked (Verrouillée)
  • Expanded (Développée)
  • Override Validation (Écraser la validation) : définissez cette option si vous souhaitez ignorer par défaut la validation de toutes les cellules de la ligne. Vous pouvez également la définir pour chaque cellule individuellement.
  • Location (Emplacement)
    • Top (Haut) : déplace la ligne vers le haut de la feuille.
    • Bottom (Bas) : déplace la ligne vers le bas de la feuille. Cette option sera ignorée si l’option Top (Haut) est cochée.
    • Parent ID (ID parent) : déplacez la ligne en tant que ligne enfant à la ligne spécifiée. Elle sera déplacée en tant que premier enfant de la ligne parent, sauf si l’option Bottom (Bas) est cochée. Si l’option Bottom (Bas) est cochée, la ligne sera ajoutée comme dernière ligne enfant.
    • Sibling ID (ID sœur) : déplacez la ligne à la suite de la ligne spécifiée. Elle sera déplacée après la ligne sœur, sauf si l’option Top (Haut) est cochée. Si Top (Haut) est coché, elle sera déplacée au-dessus de la ligne sœur.

Données renvoyées par le module Update Row (Actualiser une ligne)

Ce module renvoie des informations sur la ligne mise à jour.

• Column Name (Nom de la colonne)
  • Column ID (ID de la colonne)
  • Display Value (Afficher la valeur)
  • Value (Valeur)
• Created At (Créée le)
• Expanded (Développée)
• ID
• Modified At (Modifiée le)
• Row Number (Numéro de ligne)

Update Smartsheet User (Actualiser un utilisateur Smartsheet)

Mettez à jour les autorisations et le nom d’un utilisateur.

Ce module ne fonctionnera que si vous êtes authentifié en tant qu’administrateur système de votre compte Smartsheet.

Champs du module Update Smartsheet User (Actualiser un utilisateur Smartsheet)

• User (Utilisateur) : adresse e-mail ou ID de l’utilisateur que vous souhaitez modifier.
• Is System Admin (Est administrateur système) : indique si l’utilisateur est un administrateur système (peut gérer les comptes d’utilisateurs et le forfait de l’organisation).
• Is Licensed Sheet Creator (Est un créateur de feuilles sous licence) : indique si l’utilisateur est un utilisateur payant (peut créer et posséder des feuilles).
• Is Group Admin (Est administrateur de groupe) : indique si l’utilisateur est un administrateur de groupe (peut créer et modifier des groupes).
• Is Resource Viewer (Est un afficheur de ressources) : indique si l’utilisateur est un afficheur de ressources (peut accéder aux vues des ressources).
• Profile (Profil)
  • Title (Titre)
  • First Name (Prénom)
  • Last Name (Nom)
  • Company (Société)
  • Department (Service)
  • Role (Rôle)
  • Mobile Phone (Téléphone portable)
  • Work Phone (Téléphone professionnel)

Données renvoyées par le module Update Smartsheet User (Actualiser un utilisateur Smartsheet)

• User (Utilisateur)
  • Email (E-mail)
  • First Name (Prénom)
  • Last Name (Nom)
  • ID
  • Admin (Administrateur)
  • Licensed Sheet Creator (Créateur de feuilles sous licence)