Se connecter à Jira

Information de concept

Jira est une plateforme Cloud ou serveur destinée au suivi des problèmes logiciels et à la gestion de projets. Utilisez le connecteur de données Jira afin d'accéder aux données Jira de votre entreprise.

Avant de commencer

Informations d'identification pour Jira

Pour vous connecter à Jira, munissez-vous des éléments suivants :

Nom d'utilisateur Jira
Jeton d'API Jira (compte Cloud) ou mot de passe Jira (instance serveur)
le nom d'hôte de la plateforme Jira de votre entreprise

Pour obtenir de l'aide concernant la réunion des conditions préalables à la connexion, contactez l'administrateur Jira de votre organisation. Si votre administrateur ne peut pas vous aider, vous ou votre administrateur devez contacter le support Jira.

Obtention d'un jeton d'API

Pour se connecter à un compte Cloud Jira, il est nécessaire de disposer d'un jeton d'API pour l'authentification du compte. Pour générer un jeton, connectez-vous à votre compte Atlassian, accédez à la page Jetons d'API, puis cliquez sur Créer un jeton d'API. Copiez le jeton généré, puis saisissez-le dans le champ Jeton API dans le panneau Paramètres de connexion aux données.

Table Jira "Problèmes" Jira

La table Jira "Problèmes" peut contenir de nombreux champs personnalisés créés par votre organisation. C'est pourquoi l'API Jira traite la table Problèmes de manière dynamique, en assemblant les champs contenus dans la table chaque fois que vous vous connectez à la table. Si votre administrateur Jira apporte une modification aux champs personnalisés de la table Problèmes, les scripts Analytics qui supposent une sélection spécifique des champs peuvent se briser.

Pour résoudre ce problème, effectuez manuellement une importation Jira à l'aide de la fenêtre Accès aux données dans Analytics. Copiez la commande ACCESSDATA du journal et utilisez-la pour mettre à jour votre script. Mettez à jour les spécifications des champs dans le corps du script pour les aligner avec les modifications apportées à la table Problèmes.

Créer une connexion Jira

Dans le menu principal Analytics, sélectionnez Importer > Base de données et application.
Depuis l'onglet Nouvelles connexions, sous la section Connecteurs ACL, sélectionnez Jira.
Astuce
Vous pouvez filtrer la liste des connecteurs disponibles en indiquant une chaîne de recherche dans la zone Filtrer les connexions. Les connecteurs sont indiqués par ordre alphabétique.
Dans le panneau Paramètres de connexion aux données entrez les paramètres de connexion, et en bas du panneau, cliquez sur Enregistrer et connecter.
Vous pouvez accepter le nom de connexion proposé par défaut ou en saisir un nouveau.

La connexion correspondant à Jira est enregistrée dans l'onglet Connexions existantes. À l'avenir, vous pourrez vous reconnecter à Jira à partir de la connexion enregistrée.

Une fois la connexion établie, la fenêtre Accès aux données s'ouvre sur la Zone de transit et vous pouvez commencer l'importation des données. Pour obtenir de l'aide concernant l'importation de données à partir de Jira, consultez la rubrique Utilisation de la fenêtre Accès aux données.

Paramètres de connexion

Paramètres de base

Paramètre	Description	Exemple
Hôte	Le nom d'hôte du compte Cloud Jira ou de l'instance de serveur Jira.	https://votre_org.atlassian.net
Type d'instance	Le type de plateforme Jira utilisée par votre entreprise : serveur Cloud ou serveur sur site.	Cloud
Utilisateur	Le compte utilisateur utilisé pour s'authentifier auprès de Jira.	admin_1@your_org.com
Jeton d'API	Pour un compte Cloud Jira, le jeton d'API Jira pour l'utilisateur actuellement authentifié
Mot de passe	Pour une instance serveur Jira, le mot de passe Jira servant à authentifier l'utilisateur
Inclure des champs personnalisés	En plus des champs standard dans les tables Jira, incluez tous les champs personnalisés ajoutés par votre entreprise.	vrai

Paramètres avancés

Paramètre	Description	Exemple
Limite de la taille de clé	Longueur maximale d'une colonne de clé primaire. Définir la taille sur 0 fera revenir la longueur de clé à sa longueur d'origine. Cette propriété force le connecteur à écraser la longueur signalée de toutes les colonnes de clés primaires.	255
Mapper vers Long Varchar	Contrôle si oui ou non une colonne est renvoyée sous SQL_LONGVARCHAR. Utilisez ce paramètre pour mapper une ou plusieurs colonnes plus grandes que la taille spécifiée pour qu'elles soient signalées sous SQL_LONGVARCHAR plutôt que sous SQL_VARCHAR.	-1
Mapper vers WVarchar	Contrôle s'il faut ou non que les types de chaînes mappent vers SQL_WVARCHAR plutôt que SQL_VARCHAR. Cela est défini par défaut. Les colonnes des chaînes de caractères doivent être mappées vers SQL_WVARCHAR pour s'adapter à différents jeux de caractères internationaux, donc MapToWVarchar est défini sur vrai par défaut. Vous pouvez aussi le définir sur faux pour utiliser SQL_VARCHAR à la place.	vrai
Colonnes pseudo	Indique s'il faut inclure ou pas des pseudocolonnes comme colonnes dans la table. Ce paramètre s'avère particulièrement utile dans un cadre d'entité, qui ne vous permet pas de définir une valeur pour une pseudocolonne sauf s'il s'agit d'une colonne de table. La valeur de ce paramètre de connexion est au format "Table1=Column1, Table1=Column2, Table2=Column3". Vous pouvez utiliser le caractère « * » pour inclure toutes les tables et toutes les colonnes.	MyTable=*
Certificat de serveur SSL	Certificat à accepter du serveur lors d'une connexion avec TLS/SSL. Vous pouvez spécifier un ou plusieurs des éléments suivants : certificat PEM complet chemin d'accès au fichier local contenant le certificat la clé publique l'empreinte numérique MD5 (les valeurs Hex peuvent aussi être séparées d'un espace ou de deux-points) l'empreinte numérique SHA1 (les valeurs Hex peuvent aussi être séparées d'un espace ou de deux-points) Si vous utilisez une connexion TLS/SSL, cette propriété peut être utilisée pour spécifier le certificat TLS/SSL à accepter par le serveur. Tous les autres certificats qui ne sont pas considérés comme fiables par la machine seront rejetés.	C:\cert.cer
Convertir DateHeure en GMT	Convertit les champs DateHeure au fuseau horaire GMT pendant l'importation. Si la valeur est fausse, la valeur DateHeure est convertie dans le fuseau horaire du système d'exploitation du poste exécutant Analytics.	vrai
Schéma d'authentification du proxy	Type d'authentification à utiliser pour l'authentification au proxy ProxyServer. Cette valeur spécifie le type d'authentification à utiliser pour l'authentification à un proxy HTTP spécifié par ProxyServer et par ProxyPort. Remarque Le connecteur utilisera les paramètres du proxy système par défaut, sans autre configuration nécessaire ; si vous souhaitez vous connecter à un autre proxy, vous devrez définir ProxyAutoDetect sur faux, en plus de ProxyServer et de ProxyPort. Pour l'authentification, définissez ProxyAuthScheme et définissez ProxyUser et ProxyPassword, si nécessaire. Le type d'authentification peut être l'un des suivants : BASIC Le pilote effectue une authentification HTTP BASIC DIGEST Le pilote effectue une authentification HTTP DIGEST NEGOTIATE Le pilote récupère un jeton NTLM ou Kerberos basé sur le protocole applicable pour l'authentification PROPRIETARY Le pilote ne génère pas un jeton NTLM ou Kerberos. Vous devez fournir ce jeton dans l'en-tête d'autorisation de la requête HTTP	BASIC
Détection automatique du proxy	Indique si oui ou non il faut utiliser les paramètres proxy du système. Définissez ProxyAutoDetect sur FALSE pour utiliser les paramètres de proxy personnalisés. Cela a priorité sur les autres paramètres de proxy.	vrai
Utilisateur proxy	Nom d'utilisateur à utiliser pour l'authentification avec le proxy ProxyServer. Les options ProxyUser et ProxyPassword sont utilisées pour se connecter et s'authentifier par rapport au proxy HTTP spécifié dans ProxyServer. Vous pouvez sélectionner l'un des types d'authentification disponibles dans ProxyAuthScheme. Si vous utilisez une authentification HTTP, définissez-le sur le nom d'utilisateur d'un utilisateur reconnu par le proxy HTTP. Si vous utilisez une authentification Windows ou Kerberos, définissez cette propriété sur un nom d'utilisateur dans l'un des formats suivants : utilisateur@domaine domaine\utilisateur	john_doe@exemple.com
Mot de passe proxy	Mot de passe à utiliser pour l'authentification avec le proxy ProxyServer. Cette propriété est utilisée pour l'authentification à un serveur proxy HTTP prenant en charge l'authentification NTLM (Windows), Kerberos ou HTTP. Pour spécifier le proxy HTTP, vous pouvez définir ProxyServer et ProxyPort. Pour spécifier le type d'authentification, définissez ProxyAuthScheme. Si vous utilisez l'authentification HTTP, définissez en outre ProxyUser et ProxyPassword sur le proxy HTTP. Si vous utilisez une authentification NTLM, définissez ProxyUser et ProxyPassword sur votre mot de passe Windows. Vous en aurez peut-être également besoin pour effectuer une authentification Kerberos.
Serveur proxy	Nom d'hôte ou adresse IP d'un proxy via lequel acheminer le trafic HTTP. Nom d'hôte ou adresse IP d'un proxy via lequel acheminer le trafic HTTP. Le pilote peut utiliser les types d'authentification HTTP, Windows (NTLM) ou Kerberos pour s'authentifier à un proxy HTTP. Par défaut, le pilote utilise le proxy du système. Si vous devez utiliser un autre proxy, définissez ProxyAutoDetect sur faux.	206.174.193.115
Port proxy	Port TCP sur lequel le proxy ProxyServer s'exécute.	80
Type de proxy SSL	Type SSL à utiliser pour la connexion au proxy ProxyServer : AUTO Si l'URL est une URL HTTPS, le connecteur utilisera l'option TUNNEL. Si l'URL est une URL HTTP, le connecteur utilisera l'option NEVER (par défaut). ALWAYS la connexion est toujours SSL activée NEVER la connexion n'est pas SSL activée TUNNEL la connexion s'effectue via un proxy de tunneling : le serveur proxy ouvre une connexion vers l'hôte distant et le trafic est échangé par le proxy	AUTO

Mises à jour du connecteur de données

Lorsque vous mettez à niveau Analytics, Agent Robots ou AX Serveur, vous devez tester tous vos scripts qui importent des données à l'aide de l'un des connecteurs de données Analytics (commande ACCESSDATA).

Il est possible que des modifications apportées par des sources de données tierces ou des fournisseurs de pilotes ODBC aient nécessité la mise à jour d'un ou plusieurs connecteurs de données. Les connexions de données écrites sous forme de scripts peuvent avoir besoin d'être mises à jour afin de continuer à fonctionner correctement.

Ré-exécuter l'importation La façon la plus simple de mettre à jour une connexion est d'effectuer manuellement une importation à l'aide de la fenêtre Accès aux données de la version mise à niveau d'Analytics. Copiez la commande ACCESSDATA du journal et utilisez-la pour mettre à jour votre script.
Remarque
Avant de vous connecter à une source de données et de réexécuter l'importation, effacez le cache du connecteur pour vider le jeu existant de noms de tables.
Dans l'onglet Connexions existantes de la fenêtre Accès aux données, à côté du nom du connecteur, sélectionnez > Effacer le cache.
Mettre à jour les spécifications des champs Vous pouvez également avoir besoin de mettre à jour les spécifications des champs dans le corps du script pour les aligner avec les modifications du schéma de table dans la source de données ou le pilote ODBC. Les modifications possibles comprennent les noms des champs, les types de données des champs et les longueurs de champ et d'enregistrement.
Vérifier les résultats des filtrages Vous devez également vérifier les résultats des filtrages que vous appliquez dans le cadre de l'importation de données. Confirmez que le filtrage des importations inclut et exclut correctement les enregistrements.

Modifications apportées au connecteur de données Jira

Les modifications spécifiques apportées au connecteur de données Jira sont énumérées ci-dessous.

Analytics Version	Table Jira	Champs ajoutés	Champs supprimés
14.2	Attachments	AuthorAccountId	AuthorKey ContentEncoded FilePath Name
	Boards		FilterId (Les importations script Jira existantes qui font référence à ce champ continuent de fonctionner, mais le champ n'existe plus.)
	Commentaires	AuthorAccountId UpdateAuthorAccountId	AuthorKey AuthorName UpdateAuthorKey UpdateAuthorName
	IssueChangeLogs	AuthorAccountId AuthorDisplayName	AuthorKey
	Projects	LeadAccountId	LeadKey LeadName Recent
	SecurityLevels	SecuritySchemeId	Link
	Users	AccountId	Key Name IncludeInactive
	Watchers	AccountId	Key Name
	Worklogs	AuthorAccountId UpdateAuthorAccountId	AuthorName UpdateAuthorName