Créez facilement des factures dans Jira

Voici comment passer du ticket à la facture grâce à des rapports créatifs/innovants

Êtes-vous confus par le titre de cet article de blog ? Génial – alors vous devriez absolument le lire ! Du moins si vous travaillez régulièrement avec Jira et que vous avez souvent du mal avec le fait que les rapports que vous pouvez extraire de Jira lui-même ne correspondent pas à vos besoins. Parce que c’est exactement à cela que sert l’application « Report Builder for Jira » ! Et il peut faire bien plus que « simplement » créer d’excellents rapports Jira.

En fait, Report Builder pour Jira est extrêmement flexible. Ci-dessous, nous allons vous montrer comment l’utiliser pour créer non seulement un rapport classique, mais même une (belle) facture.

Dans notre exemple, vous constaterez qu’avec un peu de créativité et de codage, des exigences très particulières peuvent être satisfaites dans Jira. Bien sûr : cela ne fonctionne pas complètement sans travail. Mais le résultat est exactement ce qui vous aidera vraiment à la fin.

Pourquoi une application de reporting pour une facture ?

Report Builder for Jira est conçu pour permettre aux utilisateurs d’extraire des données de Jira et de les utiliser ailleurs. Au début, l’application créait des feuilles de temps. Aujourd’hui, elle peut être utilisée pour transformer les processus Jira avec toutes les données qu’ils contiennent en rapports et même en factures.

Normalement, c’est difficile dans Jira : vous devez d’abord exporter les données, d’abord dans CVS, puis par ex. B. dans Excel. Et jusqu’à ce que tout soit transformé en rapport (ou en facture) quelque part et d’une manière ou d’une autre dans une autre application, de nombreuses étapes sont généralement nécessaires.

Report Builder pour Jira fournit une solution, sans aucune transformation de données à l’aide d’applications tierces. Cela signifie que les données restent entièrement dans Jira Cloud, un gros plus en termes de sécurité des données. Vous n’avez donc pas besoin de moteurs de traitement de données ou d’autres applications – c’est garanti !

Comment ça fonctionne?

Êtes vous curieux? Alors poursuivez votre lecture, car nous allons maintenant vous expliquer comment même des factures complexes peuvent être créées directement depuis Jira à l’aide de Report Builder. Cela peut sembler presque impossible à quiconque connaît Jira, mais c’est en fait assez simple (du moins avec notre application) !

Tout d’abord, téléchargez l’application Générateur de rapports : Rapports et analyse de données Jira sur l’Atlassian Marketplace. Installez-la dans votre instance Jira. Vous trouverez désormais l’application dans l’onglet « Applications ». Vous y verrez de nombreux modèles de rapports préparés, par exemple « Fermé ou réouvert » ou « Créé ou résolu ». Les noms parlent d’eux-mêmes. Vous pouvez utiliser tous ces rapports immédiatement ; ils créeront le rapport souhaité en quelques minutes seulement. Chaque rapport peut être ajouté aux rapports personnels de l’utilisateur respectif.

Au cœur du problème : créer un nouveau « rapport scripté »

Mais comment obtenir le calcul que vous avez mentionné ? En haut à droite du menu, vous verrez le bouton « Nouveaux rapports scriptés » (ici une facture).

Ici, vous pouvez voir l’onglet Modèle, qui contient votre code HTML et vos styles CSS, ainsi que l’onglet Script. Le tout est rendu fonctionnel avec du code JavaScript.

L’éditeur divisé est pratique : il vous permet de voir les deux éditeurs à la fois, modèle et script.

Commençons par le calcul proprement dit ! Définissez vos exigences minimales : Votre document a probablement besoin d’un logo, d’une adresse, du nom de l’entreprise, de l’email, du numéro de téléphone, etc. À cela s’ajoutent les données normales et dynamiques d’une facture : le numéro de facture, la date, le numéro des produits facturés ou des Services, le total de la facture, etc. Il n’y a pas de limites à la flexibilité des données incluses.

Comme vous pouvez le voir, le code est simplement codé dans le script – vous envoyez ensuite le tout au modèle. C’est ici que vous créez les différents paramètres que doit contenir votre facture, comme le titre et la description. Créez les différents paramètres puis envoyez-les à votre modèle. Le Générateur de rapports l’utilise pour cela Guidon-Cadre: Il vous permet de convertir des variables en syntaxe HTML-nice. Les données de Jira sont introduites dans le modèle (HTML+CSS) via JavaScript via le guidon. Après une actualisation, vous pouvez voir les résultats dans l’aperçu. Soit dit en passant, le tout fonctionne pour tout type de rapport, pas seulement pour les factures.

Si vous vous y connaissez en codage, vous savez probablement déjà à quoi tout cela se résume (pour tout le monde : ne vous inquiétez pas, nous vous expliquerons étape par étape).

Trois étapes avec Report Builder pour Jira : obtenir des données, calculer des données et afficher des données

Dans notre exemple, nous créons un calcul très simple. Pour ce faire, nous utilisons les données d’un seul processus Jira et créons une facture avec un seul article.

1ère étape : // récupérer les données

Nous voulons extraire les données d’un ticket spécifique. Pour ce faire, nous avons besoin d’un champ de saisie dont nous transférons la valeur dans le script. Sélectionnez le type de champ « Issue Picker » dans le menu déroulant, entrez un nom de champ et un titre de champ, et le champ de saisie est prêt. Ensuite, les données de cette sélection doivent se retrouver dans le code JavaScript. Il existe des extraits de code prêts à l’emploi dans la documentation. Une fois que tout a été inséré, nous pouvons regarder les processus Jira et sélectionner celui que nous voulons facturer ou, mieux encore, dont nous avons besoin pour la facture !

Étape 2 : Calculer les données

Il se passe maintenant des choses intéressantes. C’est ainsi que Jira enregistre habituellement, par ex. B. la durée du temps de travail enregistré, en secondes. Il faut donc d’abord convertir les secondes en heures (diviser par 3600, on obtient alors des heures). Cette valeur peut ensuite être arrondie à l’aide de JavaScript.

Toutes nos félicitations! La première version simple de la facture est prête !

Étape 3 : Affichez (joliment) les données.

Cette partie prend un peu plus de temps, mais l’investissement en vaut la peine car la facture souhaitée sera finalement superbe ! Vous pouvez travailler avec CSS pour ajouter des couleurs, des polices et bien plus encore.

Est-ce que ça pourrait être plus simple ? Naturellement! En utilisant un éditeur WYSIWYG en ligne tel que B. au lieu de creuser profondément dans HTML et CSS (d’ailleurs, WYSIWYG signifie « ce que vous voyez est ce que vous obtenez »). Là, vous construisez votre modèle comme vous le souhaitez, puis copiez le tout, collez-le dans le modèle et continuez à y travailler pour tout adapter et améliorer. Simple mais efficace!

Soit dit en passant, ce sont des données en direct. C’est ce qui rend ce système si spécial. Cela signifie que les modifications apportées aux tickets Jira apparaissent toujours dans le rapport (ou dans ce cas dans la facture) en temps réel. De même, par exemple, la date sera toujours saisie correctement dès que l’utilisateur final remplira la facture.

Le point fort est la flexibilité absolue du système. Si le numéro de facture doit être une combinaison de lettres et de chiffres, un autre champ de saisie est simplement ajouté. Tout est contrôlé via les champs.

Tout ce qui figure sur la facture – prix, acomptes, total, etc. – tout est codé à l’aide des champs et de l’éditeur WYSIWYG utilisé. Alternativement, vous pouvez créer votre propre code en HTML ou CSS. Vous décidez ce que vous préférez ou combien de temps vous pouvez ou souhaitez y consacrer. 🙂

L’addition, s’il vous plaît! Déjà fini? Oui!

Votre (belle) facture est prête ! Vous pouvez désormais le voir et y accéder sous forme de rapport dans le générateur de rapports.

Une fois la facture créée, vous pouvez ensuite l’exporter au format PDF ou la mettre à disposition de votre équipe ou de votre service comptable. Vous avez également la possibilité de partager les autorisations pour cela (sous «Autorisations de rapport») : Vous pouvez donc soit rendre la facture publique, soit autoriser uniquement certains utilisateurs à l’utiliser.

Et bien sûr, toute personne disposant de l’autorisation appropriée peut également remplir le « rapport de facture » encore et encore ! Cela permet de transformer les données en direct collectées par Jira en une facture fonctionnelle qui peut vous faire gagner, ainsi qu’aux membres de votre équipe, du temps à l’avenir.

La feuille de route du Report Builder pour Jira

Vous avez aimé l’idée de créer une facture fonctionnelle et visuellement attrayante directement dans Jira ? Avec des données en temps réel et sans avoir à tout exporter laborieusement depuis Jira ? Alors n’hésitez pas à nous suivre, car notre feuille de route pour le Report Builder est énorme : à l’avenir, par exemple, nous simplifierons les processus de traitement des données, développerons des bibliothèques spéciales pour ajouter des données sans avoir à écrire beaucoup de code, et bien plus encore ! De nouveaux rapports de projets, de sprints ou de tableaux de bord sont également à notre agenda.

Avez-vous une idée à laquelle nous devrions absolument nous attaquer ? Alors contactez-nous! Nous sommes toujours là pour vous.

Et maintenant, nous espérons que vous aurez du plaisir à créer votre première facture avec notre Report Builder pour Jira ! 🙂

Informations Complémentaires

Jira Reporting-Apps fermées ou rouvertes dans Vergleich
Le nouveau Jira – Jira Software et Jira Work Management sont combinés en un seul produit
Savoir comment : décollez dans Jira Cloud – parcours d’apprentissage à la Seibert Academy