Skip to main content
O conector Jira sincroniza issues e seus metadados do Jira Cloud com a infraestrutura strattum.ai. Os dados aparecem no Data Catalog e alimentam o contexto de projetos e trabalho no Memory e no Knowledge.

​
Capacidades

  • Sincroniza issues, comentários de issue, projetos e usuários.
  • Carga incremental de issues e comentários pela data de atualização.
  • Suporte a campos customizados de story points e sprint, com IDs configuráveis por instância.
  • Autenticação via API token do Atlassian.

​
Objetos suportados

​
Pré-requisitos

Conta Jira Cloud

Acesso a uma instância Jira Cloud (suaempresa.atlassian.net).

API token do Atlassian

Um API token gerado na conta Atlassian do usuário que fará a leitura.

​
Configuração

1

Gere um API token do Atlassian

Acesse id.atlassian.com/manage-profile/security/api-tokens e clique em Create API token. Dê um nome como strattum-sync e copie o token.
O token é exibido apenas uma vez. Copie-o e guarde em local seguro antes de fechar a janela.
2

Confirme as permissões do usuário

O usuário dono do token precisa enxergar os projetos que você quer sincronizar. Use uma conta com permissão Browse Projects nos projetos-alvo.
3

Adicione o conector no Console

No menu lateral do Console, clique em Conectores → + Nova Conexão e selecione Jira. Preencha os campos:
  • Nome do Conector — identificador na lista de conectores (Obrigatório)
  • Domínio — subdomínio Atlassian, apenas a parte antes de .atlassian.net (Obrigatório)
  • E-mail — e-mail da conta Atlassian dona do token (Obrigatório)
  • API Token — token gerado na etapa anterior (Obrigatório)
4

Teste e salve

Clique em Testar Conexão para validar as credenciais e, em seguida, em Salvar Conector.
Os IDs de campos customizados de story points (customfield_10016) e sprint (customfield_10020) variam por instância. Os defaults cobrem as configurações mais comuns do Jira Cloud. Para descobrir os IDs corretos da sua instância, chame GET /rest/api/3/field. O ajuste desses IDs é feito na configuração avançada do conector [verificar].

​
Autenticação e escopos

A autenticação é por Basic Auth com e-mail e API token contra a REST API v3 do Jira Cloud. O Jira não usa escopos OAuth para API tokens — o acesso é o mesmo do usuário dono do token.

​
Frequência de sync

O conector sincroniza a cada 2 horas. A primeira execução após a ativação roda como sample sync (amostra) e, ao concluir, o ciclo completo passa a rodar no schedule padrão.

​
Limitações conhecidas

  • projects e users são carregados em full refresh a cada ciclo; apenas issues e issue_comments são incrementais.
  • Comentários são capturados pela data de atualização da issue pai — editar ou criar um comentário atualiza a issue, o que dispara a recoleta dos comentários daquela issue.
  • Os IDs de campos customizados são específicos da instância; os defaults podem não corresponder à sua configuração.
  • Issues deletadas na origem não são removidas automaticamente em modo incremental.

​
Troubleshooting

​
Próximos passos

Guia de desenvolvimento local

Configure o ambiente local completo com Prefect, worker e Docker Compose.

Quickstart — Data Pipelines

Ative conectores via Console strattum.ai sem precisar de ambiente local.