14.3 API spécifique à Jira

L’API spécifique à Jira a été créée pour prendre en charge les Webhooks créés dans le cadre des événements de Jira. L’API Jira peut être utilisée pour créer un document de type URL (pas une pièce jointe de fichier) en envoyant le corps de vos problèmes Jira (épopées, histoires, bugs) à la description en texte riche dans EPC, les marquer de la catégorie “jira”, inclure le numéro JIRA et l’URL spécifique à l’incident dans Jira, cliquable.

Vous pouvez également utiliser cette API pour METTRE À JOUR les données liées au processus et aux tâches si vous utilisez la synchronisation Jira EPC, où le contenu original créé dans Jira était via EPC. Les images intégrées sont ajoutées en tant que pièces jointes d’image. En savoir plus sur l’intégration Jira bidirectionnelle à travers cette vidéo :

Comment l’utiliser :

Authentification :

Pour l’authentification par clé API, vous devez d’abord définir les paramètres du système API_KEY sur un UUID valide dans les PARAMÈTRES AVANCÉS de l’ADMINISTRATION SYSTÈME de l’EPC. Vous pouvez générer un UUID valide en utilisant https://www.guidgenerator.com/

Ensuite, dans l’appel API, vous devez ajouter un paramètre de requête nommé api-key et utiliser la valeur dans le paramètre système.

Supprimer ou modifier l’authentification :
Supprimez facilement l’accès à l’authentification du système en supprimant simplement l’UUID des paramètres d’administration système (le définir comme vide), puis personne ne pourra utiliser la méthode d’authentification. Si le paramètre système est modifié, alors tous ceux qui utilisent l’ancienne clé API seront rejetés et devront passer à la nouvelle valeur.

API

L’appel API prenant en charge cette fonction dans l’EPC est l’importation Jira : POST /api/v1/import/jira?api-key=…….



URL du Webhook JIRA

https://servername/api/v1/import/jira?api-key=UUID#&parent-node-id=EPCFOLDERID&category-id=CategoryID

Server Name : Nom de votre serveur (par exemple, Company.interfacing.com)
UUID# : Le numéro UUID que vous avez placé dans les paramètres d’administration avancée
Folder ID : Le dossier où les documents seront créés
Catégorie : La catégorie que vous souhaitez attribuer à tous les documents créés par JIRA. Vous pouvez utiliser n’importe quelle catégorie que vous créez sur votre serveur. Par exemple, “Jira”
Utilisez cette URL pour connaître les ID des catégories sur votre serveur : https://servername.interfacing.com/api/v1/catalog/categories?language=en&page=1&per_page=0&sort_by=name&order=ASC&draft=true


Vous devriez voir quelque chose de similaire ci-dessous, utilisez “categoryID”

URL d’exemple

Créer un Webhook dans JIRA

Créez l’URL du Webhook dans Jira sous Paramètres / Webhooks système : Créer un Webhook. Collez l’URL et définissez les événements qui déclencheront les créations ou mises à jour dans l’EPC.

Collez l’URL :

Définissez les conditions de l’événement :