Ajouter et configurer le connecteur
Afin d'ajouter ce connecteur, vous devez aller dans Catalogue > Connecteurs > Jira Software > Ajouter un connecteur
🔎 Pour plus d'informations sur ce que vous propose ce connecteur, rendez-vous sur l'ampoule lorsque vous avez votre curseur sur le connecteur concerné.
Vous pouvez compléter ces informations en suivant ces liens :
Pour les environnements dédiés, le lien à suivre sera https://nomdevotreinstance.tenacy.io/doc/jira
Une fois le connecteur ajouté, vous devez le paramétrer avant de lancer le premier test.
⚠️ Attention : le type de ticket choisi lors du paramétrage doit posséder des champs summary et description obligatoirement.
Lancer son premier test
Une fois que le connecteur est bien paramétré selon le ou les modules choisis, testez l'intégration en créant une nouvelle action ou une nouvelle tâche test dans Tenacy.
Cette nouvelle création engendre le lancement de l'exécution du connecteur.
Pour vérifier si cela fonctionne bien, rendez-vous ensuite dans ⚙️ > Connecteurs > Cliquez sur votre connecteur JIRA > puis cliquez sur la dernière ligne d'exécution pour vérifier si cela a bien fonctionné.
💡 N'hésitez pas à contacter le support Tenacy si vous avez des questions à ce sujet.
Fonctionnement du connecteur
Dès la création d'un nouvel objet dans Tenacy dans le registre paramétré dans le connecteur, le connecteur s'exécute pour remonter l'information dans JIRA.
Pour le reste, Tenacy conserve l'identifiant de ces tickets pour vérifier fréquemment leur statut (une fois par heure). Si le ticket est clos, Tenacy met à jour le statut de la tâche récurrente / de l’action pour correspondre au statut du ticket.
Dans les deux cas, si un utilisateur est assigné du côté de Tenacy, une recherche est effectuée dans JIRA en fonction de l'e-mail pour assigner le ticket en conséquence.
🔎 Remarques importantes
Les tâches récurrentes et les actions créées via des plans automatiques dans Tenacy ne sont pas synchronisées dans JIRA
Les tickets JIRA présents dans le projet avant la mise en place du connecteur dans Tenacy ne sont pas synchronisés.
Les actions et tâches récurrentes existantes dans Tenacy avant la mise en place du connecteur ne sont pas créés dans JIRA.
Tâches récurrentes
À la création d'une tâche récurrente, si une réalisation (statut "à faire") est nécessaire pour la période en cours (en fonction de la date de début de la tâche), un ticket est créé dans le projet JIRA et est lié à cette tâche récurrente.
Pour chaque début de période (et pour chaque type de période), un nouveau ticket est créé dans JIRA.
🔎Une tâche récurrente mensuelle débutant le 01/01/24 crée donc un ticket JIRA à chaque début de mois.
Le statut des tickets JIRA sont vérifiés régulièrement (1 fois par heure). Le statut du ticket Jira est récupéré :
Si le ticket Jira n'est pas trouvé, le lien est supprimé et la réalisation est considérée comme non spécifiée.
Si le statut est dans la liste de ceux identifiés comme "Fait", la réalisation est enregistrée comme réalisée.
Si le statut est dans la liste de ceux identifiés comme "Non fait", la réalisation est enregistrée comme non réalisée.
Dès que le statut de la tâche récurrente passe en "Fait" ou "Non Fait", Tenacy fait remonter depuis le ticket JIRA :
Les fichiers présents dans les commentaires sont téléchargés dans les pièces jointes de la réalisation actuelle de la tâche récurrente.
Les URL sont incluses dans les liens URL de la tâche récurrente. Un seul lien est retourné. Cette URL doit être saisie dans le dernier commentaire du ticket Jira au moment de la synchronisation.
Si le nom de la tâche et la description sont modifiés du côté de Tenacy, ces changements sont rapportés dans Jira.
Dans les autres cas, rien n'est modifié du côté de Tenacy.
Actions
Lors de la création d'une action dans Tenacy, un ticket est automatiquement créé dans JIRA et est lié à cette action.
Lorsqu'une action est terminée (manuellement du côté de Tenacy), annulée ou supprimée, le ticket JIRA correspondant est également supprimé.
Régulièrement (1x par heure), les actions non closes (à planifier, planifiées, en attente, en cours) associées à des tickets Jira sont vérifiées. Le statut du ticket Jira est récupéré :
Si le ticket Jira n'est pas trouvé, le lien est supprimé et l'action reste inchangée.
Si le statut est dans la liste de ceux identifiés comme "terminée" dans le paramétrage du connecteur, l'action est enregistrée comme terminée.
Si le statut est dans la liste de ceux identifiés comme "non fait" dans le paramétrage du connecteur, l'action est enregistrée comme annulée.
Dès que le statut de l’action passe en "Terminée" ou "Annulée" Tenacy fait remonter depuis le ticket JIRA :
Les fichiers présents dans les commentaires sont téléchargés dans les pièces jointes de l’action.
Les URL sont incluses dans les liens URL de l’action. Un seul lien est retourné. Cette URL doit être saisie dans le dernier commentaire du ticket JIRA au moment de la synchronisation. S'il y avait déjà une URL avant, elle sera être écrasée.
Si le nom de l’action et la description sont modifiés du côté de Tenacy, ces changements sont rapportés dans JIRA.
💡 Recommandations
En termes de bonnes pratiques, il est donc recommandé de :
Créer un projet JIRA vierge
Mettre en place le connecteur JIRA dans Tenacy
Créer les actions / tâches récurrentes dans Tenacy
Ces dernières seront alors synchronisées dans votre projet JIRA
Mettre à jour les actions / tâches récurrentes depuis JIRA
Mettre à jour les actions / tâches récurrentes depuis Tenacy entrainent la suppression des tickets sur JIRA
Créer une action depuis le projet JIRA ne créera pas d’action dans Tenacy