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.
USM Content
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 et les détails du problème.
- Error Reports (Rapports d’erreur) : lorsqu’un problème survient, le propriétaire du flux de travail ainsi que la personne ayant modifié les champs ou la ligne du flux de travail à l’origine du problème reçoivent un e-mail de notification.
- Error Column (Colonne d’erreur) : vérifiez cette colonne de votre feuille pour vérifier un message sur les lignes présentant un problème de synchronisation.
Historique d’exécution
Après avoir créé un flux de travail, vous pouvez accéder à la page Run History (Historique d’exécution) pour afficher l’historique de la 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 Last Run (Dernière exécution) .
Il existe les types d’exécution suivants dans votre historique d’exécution :
- Sync to Smartsheet (Synchroniser vers Smartsheet) : le flux de travail s’exécute pour les modifications Jira synchronisées vers Smartsheet.
- Sync to Jira (Synchroniser vers Jira) : le flux de travail s’exécute pour les modifications de Smartsheet qui ont été synchronisées vers Jira.
- Filtered Row Finder (Recherche de lignes filtrées) : le flux de travail s’exécute pour les modifications apportées à tous les problèmes qui doivent être filtrés selon la configuration de votre flux de travail. La 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 à la hiérarchie Filtered Out by Connector—Not Synced (Filtré par le connecteur - non synchronisé) de votre feuille. Le processus de 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 vous n’avez pas spécifié de filtres dans votre flux de travail.
Erreurs courantes
Lorsqu’un problème survient, le propriétaire du flux de travail et la personne ayant modifié le problème/la ligne du 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 |
|---|---|
Détails | Les problèmes sans valeur de regroupement dans Jira apparaissent dans une hiérarchie nommée groupe de champs non défini |
Résolution des problèmes | Affecter une valeur de regroupement aux problèmes dans Jira |
Filtré par le connecteur - Non synchronisé
Objet | Détails |
|---|---|
Détails | Cela se produit avec le connecteur Salesforce et Jira. La ligne Filtré par le connecteur - Non synchronisé n’ajoute pas de lignes présentant des problèmes de synchronisation ; il affiche uniquement les éléments supprimés dans Jira ou les lignes qui ne répondent plus aux critères du filtre Jira et qui ne sont pas synchronisées avec Jira. |
Résolution des problèmes |
|
Le champ ne peut pas être défini. Il ne se trouve pas sur la page correspondante ou est inconnu.
Objet | Détails |
|---|---|
Détails | 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. |
Résolution des problèmes |
|
Configuration des notifications a échoué
Objet | Détails |
|---|---|
Détails | Le connecteur Jira ne peut pas recevoir de notifications de modification de Jira via Webhook. Lorsque cela se produit, le connecteur ne peut pas détecter les mises à jour dans Jira et les synchroniser avec Smartsheet. |
Résolution des problèmes | Vérifier l’inscription du webhook dans Jira :
Vérifiez les autorisations d’administrateur système Jira :
Ré-authentifier le connecteur :
Vérifiez les restrictions de pare-feu ou de réseau Jira (Jira auto-hébergé uniquement) :
Vérifiez qu’aucune mise à jour de l’application Jira n’a interrompu le webhook :
|
Si le problème persiste après les étapes ci-dessus, contactez l’assistance Smartsheet et fournissez un fichier d’informations d’assistance à l’exécution des flux de travail (WEX) pour accélérer la résolution. Voir Générer un fichier WEX à des fins d’assistance ci-dessous.
Générer un fichier WEX pour l’assistance
Si vous avez suivi les étapes de dépannage ci-dessus et que vous avez toujours besoin d’aide, la génération d’un fichier d’informations d’assistance à l’exécution des flux de travail (WEX) avant de contacter l’assistance permet à l’équipe de diagnostiquer votre problème plus rapidement et de réduire les va-et-vient.
Le fichier WEX contient des informations détaillées sur votre flux de travail, y compris les correspondances de champs, la direction de synchronisation et les configurations de filtre. Il ne contient pas vos données Smartsheet ou Jira.
Tout administrateur système ou administrateur du connecteur Smartsheet peut générer un fichier WEX en suivant les étapes suivantes :
- Connectez-vous à l’adresse https://connectors.smartsheet.com/c/jira.
- Dans le tableau de bord du connecteur Jira, sélectionnez l’horodatage sous la colonne Run Date (Date d’exécution) pour le flux de travail concerné. L’historique d’exécution du flux de travail s’ouvre.
- Sélectionnez l’horodatage sous Last Run (Dernière exécution) pour l’exécution la plus récente.
- Sur la page suivante, ouvrez le menu hamburger (trois lignes horizontales en haut à gauche) et sélectionnez Télécharger les informations d’assistance à l’exécution du flux de travail.
Joignez ce fichier lorsque vous soumettez votre ticket d’assistance ou que vous le partagez avec l’assistance de Smartsheet.
Le fichier WEX est au format JSON. L’assistance l’analyse de son côté ; vous n’avez pas besoin de l’interpréter vous-même.
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. Utilisez le regroupement de lignes pour trier les problèmes synchronisés avec un flux de travail automatique.
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 :
- Synchronisez Jira avec une autre feuille.
- 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))
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, des pièces jointes ou des commentaires importants.
Lorsque les problèmes Jira de votre feuille ne répondent plus aux critères de filtrage du flux de travail, Smartsheet crée une section Filtered out by Connector—not synced (Filtré par le connecteur—non synchronisé) en haut de votre feuille pour conserver les informations filtrées par le connecteur. 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, dans Jira, des services externes (tels que le connecteur Jira de Smartsheet) n’ont pas pu afficher les 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 la colonne Qui peut voir cela ? pour le champ Contact en bas. Si cette option est définie sur Only you and the admins (Vous et les administrateurs uniquement), alors le connecteur Jira ne peut pas accéder à l’adresse e-mail de l’utilisateur avec ce paramètre ni remplir le champ dédié à l’adresse e-mail.
Lorsque j’essaie d’accéder au connecteur Jira, celui-ci indique que je ne suis pas autorisé à effectuer cette action. Que dois-je faire ?
Il est possible que vous ne disposiez pas encore des autorisations nécessaires pour accéder au connecteur Jira. Contactez votre administrateur système Smartsheet pour obtenir de l’aide.