Ir para o conteúdo

Guia de conexão do Jira para Jitterbit App Builder

Este guia de conexão irá orientá-lo sobre como conectar o App Builder ao Jira. O Jira é uma ferramenta de rastreamento de bugs utilizada na gestão de projetos ágeis e faz parte do conjunto de produtos da Atlassian.

Aviso

Após estabelecer uma conexão do Jira com o App Builder, é necessário restringir a lógica usada para exibir os dados do Jira na página, de modo que não esteja consultando todos os registros. A falha em fazer isso pode resultar na aparição do aplicativo App Builder como não responsivo.

Pré-requisitos

  • Você deve ter uma conta Atlassian
  • Você deve ter um Token de API válido para a conta Atlassian

Configuração na Atlassian

Crie um token de API a partir 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 a área de transferência e cole o token em um local seguro para salvá-lo. Esta informação será necessária nos passos de configuração do App Builder.

Configuração no App Builder

Criar um servidor de dados Jira

  1. Navegue até o IDE do App Builder
  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 a conexão do servidor. Por exemplo: Jira
    • Tipo: Jira
    • Url: Domínio base para a instância 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 de API no campo Avançado, usando o formato APIToken=<seuAPIToken>

    Exemplo de valor do token de API inserido no campo avançado

  8. Clique em Salvar

Importar os dados do Jira para exibir no App Builder

  1. Navegue até o App Builder 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 à direita
  4. Clique no botão Importar

  5. Determine qual esquema você deseja importar:

    • Importar do Padrão: Permite importar apenas tabelas especificadas neste campo. Prefixos podem ser usados para importar apenas um subconjunto de tabelas, por exemplo, MyApp_* importará apenas tabelas que começam com MyApp_. Deixar o campo em branco importará todas as tabelas.
    • Clique em Prosseguir quando solicitado. O App Builder executará a importação como uma tarefa em segundo plano.
    • As abas Tabelas, Visões e Procedimentos listam todas as opções disponíveis junto com os correspondentes botões Importar Esquema.

Após importar os dados, você pode criar Lógica de Negócios para usar em painéis para exibir dados do Jira nas páginas do seu aplicativo App Builder.

Solução de Problemas

Se você encontrar problemas com o Jira, estas etapas de solução de problemas são recomendadas:

  1. Ative o registro de dados para gerar arquivos de log e dados, que você pode baixar e inspecionar.

  2. Consulte a documentação do CData ADO.NET Provider para Jira para informações detalhadas.

  3. Alguns erros específicos estão listados abaixo com etapas de solução de problemas sugeridas:

    • Se você não ver nenhuma opção disponível para a fonte de dados Jira no botão Importar do App Builder, verifique se você inseriu um Token de API válido.

    • Se o App Builder parecer não responsivo ao tentar carregar uma página do aplicativo com dados do Jira, ou se o Jira exibir uma mensagem "Algo deu errado", revise a lógica sendo usada para garantir que ela esteja restringindo os dados retornados a critérios mais razoáveis.