Des parties de cette page peuvent avoir été traduites automatiquement.

Bonnes pratiques et dépannage du connecteur Jira de Smartsheet

Le connecteur Jira de Smartsheet est disponible en tant qu’offre Premium. Si votre forfait inclut le connecteur Jira de Smartsheet, connectez-vous pour créer des flux de travail entre Smartsheet et Jira.

Qui peut l’utiliser ?

Forfaits :

  • Smartsheet Advance Package
  • Business
  • Enterprise

Autorisations :

Pour créer ou modifier un flux de travail, les autorisations suivantes sont requises :

  • Vous devez être un utilisateur sous licence dans l’environnement Smartsheet. Par conséquent, vous devez disposer des autorisations éditeur ou supérieures sur toutes les feuilles mises en correspondance dans le flux de travail.
  • Vous devez disposer d’un compte Jira fonctionnel ainsi que des droits d’accès adéquats aux projets Jira pour lesquels vous souhaitez créer un flux de travail.
  • Votre administrateur système doit activer le paramètre Restrict Users (Restreindre les utilisateurs) du connecteur Jira et vous attribuer le rôle d’utilisateur du connecteur Jira de Smartsheet. Ce rôle peut être attribué dans le centre d’administration de Smartsheet ou directement dans l’interface du connecteur Jira.

Découvrez si cette fonctionnalité est incluse dans Régions Smartsheet ou Smartsheet pour le secteur public.

Trouver et corriger les erreurs de synchronisation

Vous pouvez utiliser les ressources suivantes pour trouver et résoudre les erreurs de flux de travail :

  • Historique d’exécution : accédez à cette page pour afficher le nombre d’erreurs de synchronisation pour un flux de travail donné ainsi que le message d’erreur présentant les détails du problème. 
  • Rapports d’erreur : lorsqu’un problème survient, le propriétaire du flux de travail ainsi que la personne ayant modifié le champ ou la ligne du flux de travail responsable du problème reçoivent un e-mail.
  • Colonne d’erreur : contrôlez cette colonne dans votre feuille pour examiner tout commentaire sur les lignes présentant un problème de synchronisation.

Historique d’exécution

Après la création d’un flux de travail, vous pouvez accéder à la page Historique d’exécution pour afficher l’historique de synchronisation et les erreurs qui ont pu se produire. Vous pouvez accéder à l’historique d’exécution en sélectionnant l’horodatage de votre flux de travail dans Dernière exécution.

Brandfolder Image
Jira last run log

Il existe les types d’exécution suivants dans votre Historique d’exécution :

  • Synchronisation Smartsheet : le flux de travail s’exécute pour les modifications Jira synchronisées avec Smartsheet.
  • Synchronisation Jira : le flux de travail s’exécute pour les modifications Smartsheet synchronisées avec Jira.
  • Recherche de lignes filtrées : le flux de travail s’exécute pour les modifications apportées à tout problème devant être filtré selon la configuration de votre flux de travail. Recherche de lignes filtrées est un processus en arrière-plan qui s’exécute toutes les 2 heures. Les problèmes filtrés sont ajoutés dans la hiérarchie Filtré par le connecteur - non synchronisé de votre feuille. Le processus Recherche de lignes filtrées ne s’exécute qu’avec des types de flux de travail automatisés. Ce processus s’exécute même si aucun filtre n’est spécifié dans votre flux de travail.

Erreurs 

Lorsque des problèmes surviennent, le propriétaire du flux de travail et la personne ayant modifié le problème/la ligne dans le flux de travail à l’origine du problème reçoivent des rapports d’erreur par e-mail. Voici quelques erreurs et problèmes courants.

Champ [groupe] non défini

Objet

Détails

Causes possibles

Les problèmes sans valeur de regroupement dans Jira apparaissent dans une hiérarchie nommée champ [groupe] non défini.

Résolution des problèmes

Attribuez une valeur de regroupement aux problèmes dans Jira.

Filtré par le connecteur — non synchronisé

Objet

Détails

Causes possibles

Cela se produit avec le connecteur Salesforce et Jira. La ligne Filtré par le connecteur - non synchronisé n’ajoute pas de lignes avec des problèmes de synchronisation, seulement des éléments supprimés dans Salesforce ou des lignes qui ne répondent plus aux critères des filtres Salesforce et ne se synchronisent pas avec Salesforce.

Résolution des problèmes

  • S'il y a des lignes avec des erreurs ou des problèmes de synchronisation, vous voyez une erreur dans le champ Erreur de synchronisation qui doit être résolue avant que la ligne ne se synchronise avec succès avec Salesforce.
  • Le connecteur crée automatiquement la ligne Filtré par le connecteur - Non synchronisé, et toutes les lignes qui ne se synchronisent pas sont indentées en dessous.

FAQ

Lorsque des problèmes surviennent, les rapports d’erreur sont envoyés par e-mail au propriétaire du flux de travail et à la personne ayant modifié le problème/la ligne dans le flux de travail à l’origine du problème. Voici quelques erreurs et problèmes courants.

Problème : l’ordre des lignes n’est pas conforme aux attentes

Lors de l’exécution d’un flux de travail automatisé, les problèmes sont triés par Issue Key (Clé du problème) ascendante, même s’ils sont triés différemment dans Jira. Pour trier les problèmes synchronisés avec un flux de travail automatique, utilisez Regroupement de lignes.

Pour les flux de travail manuels, le processus de recherche de lignes filtrées ne s’exécute pas. Dans ce cas, vous pouvez trier manuellement les lignes de votre feuille.

Si vous souhaitez trier les problèmes manuellement tout en utilisant un flux de travail automatisé, suivez ces étapes :

  1. Synchronisez Jira avec une autre feuille.
  2. Utilisez une feuille croisée INDEX/MATCH ou une formule VLOOKUP pour importer les valeurs dans votre feuille principale à l’aide de la clé du problème. Exemple de formule : =INDEX({Plage contenant la valeur à renvoyer}, MATCH([Valeur de recherche]@ligne, {Plage contenant la valeur de recherche}, 0))

Erreur : impossible de définir le champ ’<field name>’. Il ne se trouve pas sur la page correspondante ou est inconnu.

Cette erreur apparaît si la valeur du champ que vous souhaitez définir ne se trouve pas sur la page de modification de Jira. Seuls les champs qui apparaissent sur l’écran Modifier de Jira sont modifiables à partir du connecteur Jira de Smartsheet.

Pour résoudre ce problème, adoptez l’une ou l’autre de ces méthodes :

  • Configurez l’écran Modifier dans Jira et ajoutez le champ spécifié à l’écran. Pour plus d’informations sur les écrans Jira, y compris les étapes de modification de la configuration, consultez Définir un écran dans la documentation Jira.
    -ou-
  • Mettez en correspondance le champ spécifié dans une seule direction, de Jira à Smartsheet. Cela créera une carte à sens unique. Les révisions apportées aux champs Smartsheet ne seront pas répercutées dans Jira.

Impossible d’enregistrer le problème dans Jira

Vous devez avoir des autorisations d’écriture sur les projets Jira connectés pour y enregistrer des données.

Les données ne sont pas supprimées d’une feuille après l’actualisation des filtres

Smartsheet ne supprimera pas les données extraites de Jira car chaque ligne peut contenir des données de colonne importantes, des pièces jointes ou des commentaires.
Lorsque les problèmes Jira dans votre feuille ne répondent plus aux critères de filtrage du flux de travail, Smartsheet crée une section Filtré par le connecteur - non synchronisé en haut pour conserver les informations que le connecteur filtre. Aucune ligne exclue du filtre n’est synchronisée tant qu’elle ne correspond pas à nouveau aux critères de filtrage. Ces lignes peuvent être supprimées si votre équipe n’a plus besoin de les inclure dans la feuille.

Erreur d’actualisation de la colonne d’erreur dans Smartsheet

Si vous supprimez la colonne Sync Error (Erreur de synchronisation) de la feuille connectée, un message d’erreur apparaît. Assurez-vous que la feuille comprend une colonne Sync Error (Erreur de synchronisation) ; celle-ci est obligatoire. Vous pouvez modifier votre flux de travail pour remapper la colonne Sync Error sur votre feuille. Reportez-vous à la section dédiée à la modification du flux de travail pour en savoir plus.

Error Column (Colonne d’erreurs)

Le connecteur ajoute automatiquement cette colonne à votre feuille ; elle contient les problèmes de synchronisation qui surviennent pour la ligne. 

 

..is not a valid user for the given JIRA project (…n’est pas un utilisateur valide pour le projet JIRA donné)

Ce message peut apparaître lorsque vous saisissez une adresse e-mail non valide dans un champ Smartsheet synchronisé avec Jira, susceptible d’entraver la synchronisation des contacts. 

De plus, dans Jira Cloud, cette erreur peut se produire si l’utilisateur n’est pas affecté au projet dans Jira ou si des services externes (tels que le connecteur Jira de Smartsheet) n’ont pas accès aux adresses e-mail. Une configuration par utilisateur peut être modifiée en accédant à Profil > Gérer votre compte > Profil et visibilité et en modifiant le Qui peut voir ceci ? paramètre pour le champ Contact en bas. Si cette option est définie sur Vous et les administrateurs uniquement, alors le connecteur Jira ne peut pas accéder aux informations d'adresse e-mail pour l'utilisateur avec ce paramètre et ne remplira pas le champ d'e-mail.

Lorsque j'essaie d'accéder au connecteur Jira, il est indiqué que je ne suis pas autorisé à effectuer cette action. Que dois-je faire ?

Il est possible que vous n'ayez pas encore les autorisations nécessaires pour accéder au connecteur Jira. Contactez votre administrateur système Smartsheet pour obtenir de l'aide. 

Apprenez comment contacter votre administrateur système.