Guia de Conexão Jira¶

Este guia de conexão orientará você sobre como conectar o Vinyl ao Jira. Jira é uma ferramenta de rastreamento de bugs usada no gerenciamento ágil de projetos e faz parte do pacote de produtos Atlassian.

Pré-requisitos¶

• Você deve ter o Vinyl 3.3+ instalado
• Você deve ter uma conta Atlassian
• Você deve ter um token API válido para a conta Atlassian

Configuração no Atlassian¶

Crie um token de API da sua conta Atlassian:

1. Faça login em https://id.atlassian.com/manage-profile/security/api-tokens
2. Clique em Criar token de API
3. Insira um Rótulo claro e conciso para o token e clique em Criar
4. Clique em Copiar para área de transferência e cole o token em um local seguro para salvar. Esta informação será necessária nas etapas de configuração do Vinyl.

Configuração em Vinyl¶

Crie um Servidor de Dados Jira¶

1. Navegue até o Vinyl IDE
2. Clique em Servidores de dados no menu Conectar

3. Clique no botão + Servidor e forneça as seguintes informações:

   • Nome do Servidor: Nome identificável para conexão do servidor. Por exemplo: Jira
   • Tipo: Jira
   • Url: Domínio base para a instância do Atlassian Cloud. Por exemplo: https://yourcompany.atlassian.net/

4. Clique em Salvar

5. Clique no botão Configurações avançadas
6. Clique em Editar

7. Insira o token da API no campo Avançado, usando o formato APIToken=<yourAPIToken>

   

8. Clique em Salvar

Importe os Dados do Jira para Exibição em Vinyl¶

1. Navegue até o Vinyl IDE
2. Clique em Servidores de dados no menu Conectar
3. Localize a fonte de dados Jira e clique no botão Detalhes no painel direito
4. Clique no botão Importar

5. Determine qual esquema você deseja importar:

   • Importar do Padrão: Permite importar apenas as tabelas especificadas neste campo. Os prefixos podem ser usados para importar apenas um subconjunto de tabelas, por exemplo MyApp_* importará apenas tabelas começando com MyApp_. Deixar o campo em branco importará todas as tabelas.
   • Clique em Continuar quando solicitado. O Vinyl executará a importação como uma tarefa em segundo plano.
   • As guias Tabelas, Visualizações e Procedimentos listam todas as opções disponíveis junto com os botões Importar esquema correspondentes.

Depois de importar os dados, você pode criar uma lógica de negócios para usar nos painéis e exibir os dados do Jira nas páginas do seu aplicativo Vinyl.

Solução de Problemas¶

• Se você não vir nenhuma opção disponível para a fonte de dados do Jira no botão Vinyl Importar, verifique se inseriu um token de API válido.
• Se o Vinyl parecer não responder ao tentar carregar uma página de aplicativo com dados do Jira ou se o Jira exibir uma mensagem "Algo deu errado", revise a lógica que está sendo usada para garantir que ela esteja restringindo o retorno dos dados a critérios mais razoáveis.