Integrar o Jira
Conecte o Jira ao Notion para obter uma experiência perfeita que mantém você e sua equipe sempre sintonizados 🔗
A integração do Notion com o Jira permite que você faça algumas coisas diferentes. Você pode inserir os links do Jira nas páginas do Notion para acessar rapidamente ou visualizá-los, ou pode sincronizar os seus projetos e problemas do Jira com a base de dados do Notion para acompanhar todo o seu trabalho em um só lugar. Continue lendo para saber mais sobre as diferentes formas de integração e como você pode configurá-las.
Observação: no momento, a integração do Jira não é compatível com Jira local.
Acesse
Configurações
na barra lateral.Clique em
Importar
e localizeJira
(para Pré-visualização do link e menções de link).A integração com o
Jira
é usada para pré-visualização do link e menções de link.Você também pode selecionar o
Jira Sync
, outra integração que sincroniza projetos e problemas do Jira no Notion. Clique aqui para obter mais informações sobre o Jira Sync.
Clique em
Conectar
e siga o fluxo de autenticação.
Observação: prévias de link só funcionam com o Jira Software.
Cole um link do Jira no Notion.
Selecione "Visualizar" no Menu exibido para ver uma visualização ao vivo do projeto ou problema.
Se ainda não tiver conectado o Jira ao Notion, será solicitado que você o faça quando colar o link do Jira no Notion. Saiba mais sobre as pré-visualizações do link neste artigo →
Observação: as menções de link funcionam com todos os produtos do Jira Cloud.
Cole um link do Jira no Notion.
Selecione "Menção" no menu exibido para referenciar facilmente um projeto ou problema nos seus documentos.
Se ainda não tiver conectado o Jira ao Notion, será solicitado que você o faça quando colar o link do Jira no Notion. Saiba mais sobre as menções do link neste artigo →
A integração do Jira Sync conecta os projetos do Jira com o Notion por meio do uso de um token de API de administrador (em vez de um token de usuário), o que permite uma experiência mais unificada.
Agora você pode tirar o máximo proveito dos recursos do Notion, incluindo automações, rollups e IA do Notion. Use a IA do Notion para obter rapidamente repostas sobre seus projetos do Jira.
Observação:
O proprietário do espaço de trabalho deve configurar o Jira Sync primeiro e, em seguida, todos os membros poderão usá-lo.
Você pode criar uma conta de serviço do Jira para configurar essa integração — apenas certifique-se previamente de que a conta de serviço tenha acesso a todos os projetos que você deseja sincronizar com o Notion.
A base de dados sincronizada funciona com os produtos Jira Cloud (Jira Software, Jira Product Discovery, Jira Work Management e Jira Service Management), com suporte para o Jira Server em breve!
O Jira Sync exibe seus projetos e problemas do Jira como projetos do Notion e base de dados de problemas. Essa configuração permite que você veja e acompanhe vários projetos usando uma variedade de visualizações, filtros e classificações úteis.
Você pode até usar o mapeamento de identidade para conectar as identidades do Jira aos perfis do Notion, de modo que possa ver quem é responsável pelo que na base de dados sincronizada do Notion.
🟡 Nota: Somente os proprietários do espaço de trabalho podem configurar o Jira Sync, usando um token de administrador do Jira. Depois disso, qualquer membro poderá utilizar a conexão.
Configurar o Jira Sync
Embora qualquer membro possa criar sincronizações, você precisará ser proprietário de espaço de trabalho para configurar o Jira Sync inicialmente.
Acesse
Configurações
na barra lateral →Importações
→Sincronização com o Jira
.Você também pode colar o link da base de dados do Jira ou usar um comando de barra
/jira sync
.Se tiver criado anteriormente uma base de dados sincronizada com o Jira no Notion, abra essa base de dados e selecione
Melhore sua sincronização com o Jira
na parte superior.
Na janela que aparece, selecione
Comece a usar
.Digite seu e-mail de administrador do Jira, o URL do site do Jira e o token da API e selecione
Avançar
.
Adicionar uma nova sincronização
Nota: Os membros precisam autenticar o Jira para Adicionar ou remover projetos. Eles só podem adicionar projetos aos quais tenham acesso no Jira.
Acesse
Configurações
na barra lateral →Importações
→Sincronização com o Jira
.Você também pode colar o link da base de dados do Jira ou usar um comando de barra
/jira sync
.
Na janela que aparece, selecione
Comece a usar
.Selecione o site do Jira a partir do qual você deseja sincronizar.
Selecione
Criar uma nova sincronização
ou qualquer sincronização existente que você já tenha no menu suspenso. Se você escolher uma sincronização existente, os seus projetos serão adicionados aos projetos sincronizados existentes e à base de dados de itens.Na base de dados exibida, você deverá conectar a sua conta do Jira (a menos que você seja o proprietário do espaço de trabalho que configurou a integração). A partir daí, selecione os dados que deseja sincronizar com o Notion. Primeiro,
selecione projetos para sincronizar
e, em seguida,selecione as propriedades para sincronizar
.
Repita as etapas acima se quiser configurar outra sincronização com o Jira para outro site, espaço de equipe ou espaço de trabalho. Os comentários e os anexos (até cinco arquivos por item, não superiores a 1 MB) também serão sincronizados.
Você pode aplicar autorizações à página da base de dados para tornar a base de dados sincronizada acessível aos colaboradores.
Nota: As bases de dados sincronizadas do Jira herdarão as autorizações do Notion. O membro pode acessar as bases de dados sincronizadas em qualquer página que tenha autorização para visualizar.
Se um membro adicionar um projeto particular do Jira a uma página do Notion, qualquer pessoa com acesso à página do Notion poderá visualizá-lo.
Propriedade de pessoas na base de dados sincronizada
As bases de dados sincronizadas incluirão propriedades de pessoas! Agora, você pode usar o mapeamento de identidade para conectar identidades externas do JIRA aos perfis Notion da sua equipe. Confira o passo a passo:
Confirme que você implementou o Jira Cloud.
Se você tem o perfil de administrador, acesse o Jira, clique em
Configurações do sistema do Jira
e altere a visibilidade do e-mail de usuário deOculto
paraPúblico
na sua organização. Se for usuário individual, você deverá alterar manualmente as suas configurações, mudando a opção de visibilidade do e-mail. Siga as instruções aqui →
Editar ou excluir uma base de dados sincronizada
Para editar propriedades de projetos e itens do Jira que foram sincronizados com a base de dados do Notion, selecione •••
na parte superior da base de dados sincronizada → Origem
.
Para excluir uma base de dados sincronizada com o Jira, selecione •••
na parte superior da sua base de dados sincronizada → Excluir tabela
.
Bases de dados de projetos
Os seus projetos do Jira serão sincronizados em uma base de dados de projetos do Notion. Seus projetos serão mapeados de forma inteligente com seus respectivos itens do Jira para uma base de dados de itens sincronizada, relacionada no Notion. Essa base de dados terá visualizações padrão de base de dados criadas automaticamente, para ajudar você a começar mais rapidamente:
Ativo (visualização em tabela): mostra os projetos que você sincronizou e que têm status em andamento. Em outras palavras, essa visualização não mostra projetos que já foram concluídos. Há também filtros predefinidos para proprietário e datas, para facilitar a pesquisa.
Visualização em cronograma: exibe o nome do projeto, o status, o proprietário e o percentual de conclusão. Há também filtros predefinidos para status, proprietário e data, para facilitar a pesquisa.
Visualização em quadro: mostra os seus projetos agrupados por status
(Planejamento
,Em andamento
). Você pode personalizar os status que são exibidos na visualização no menu•••
. Os projetos são classificados por ordem decrescente de prioridade.Todos (visualização em tabela): exibe todos os seus projetos sincronizados. Há filtros predefinidos para status, proprietário e data, para facilitar a pesquisa.
Base de dados de itens
Os seus itens do Jira (épicos, bugs, tarefas, subtarefas, histórico) serão sincronizados em uma base de dados de itens do Notion, o equivalente a uma base de dados de tarefas do Notion. Assim como na base de dados de projetos sincronizados, haverá visualizações padrão da base de dados, criadas para ajudar você a começar mais rapidamente:
Por projeto (visualização em tabela): mostra todas as tarefas, agrupadas por projeto. Há filtros predefinidos para status, responsável, data e projeto para facilitar a pesquisa.
Por épico (visualização em tabela): mostra históricos, tarefas e bugs do Jira agrupados por épico.
Visualização em quadro: essa visualização é agrupada por status e classificada por prioridade decrescente. As propriedades predefinidas exibidas são responsável, projeto, prioridade e subtarefa.
Todas as tarefas (visualização em tabela): exibe todas as tarefas sincronizadas. As propriedades predefinidas exibidas são nome da tarefa, status, responsável, data, prioridade, tag e projeto
Minhas tarefas (visualização em tabela): filtragem que mostra apenas as tarefas atribuídas a você. Há filtros predefinidos para status, data e projeto.
O Jira Sync tem compatibilidade com a maioria das propriedades do Jira, mas não com todas elas. Aqui está a lista de propriedades do Jira sem compatibilidade:
Controle de tempo | Resolução |
Nível de segurança | Σ progresso |
Progresso | Restringir a |
statusCategory | Classificação |
Embora o Notion não tenha compatibilidade com determinadas propriedades personalizadas do Jira, ele tem compatibilidade com todas as propriedades personalizadas primitivas do Jira, como sequência, número, seleção, pessoa e data.
A sincronização inicial deve levar apenas alguns minutos para ser concluída. Dependendo do volume de projetos e e itens no Jira, isso pode levar até algumas horas.
Alguns campos ou propriedades de itens podem não ser sincronizados, como texto enriquecido em propriedades e seleção múltipla aninhada.
Após a configuração da sincronização inicial, as atualizações da propriedade deverão ser refletidas no Notion em tempo real. Se você criar novas propriedades, pode levar até 12 horas para que essas alterações sejam sincronizadas.
Não é possível sincronizar manualmente o Jira com o Notion. As sincronizações acontecem em resposta às atualizações feitas no Jira.
No momento, as atualizações do Jira serão sincronizadas com a base de dados do Notion em tempo real , mas o contrário não é possível. Todas as alterações feitas na sua base de dados do Notion não serão sincronizadas com o Jira.
Você poderá ver quando o Notion
foi sincronizado com o Jira
pela última vez em um selo azul na parte superior de uma base de dados. Se, em vez disso, você vir uma mensagem amarelaFalha na sincronização
ouSincronização interrompida
, talvez seja necessário seguir os passos abaixo para reconectar o Jira.Certifique-se de que você tenha acesso de edição ou acesso completo a uma base de dados sincronizada, se quiser adicionar ou remover projetos ou propriedades.
Se não estiver visualizando as atualizações no Notion, tente atualizar a página.
A propriedade
Watcher
pode levar até 12 horas para ser sincronizada corretamente.
Observação: Se você excluir uma propriedade no Jira, o item de base de dados associado na sua base de dados sincronizada também será excluído.
Em caso de falha do registro do webhook ou de sincronização do projeto, você verá Falha na sincronização
na parte superior da base de dados. Para resolver esse problema, tente sincronizar novamente com um conjunto diferente de projetos. Certifique-se também que seus projetos não tenham nenhum problema no Jira.
Se seu token do Jira não for mais válido ou se alguém tiver desconectado o Jira do Notion, você verá A sincronização foi interrompida
na parte superior da base de dados. Para resolver esse problema, selecione Autenticar novamente
ao lado de Sincronização interrompida
. Você deverá ser proprietário de um espaço de trabalho para concluir esse processo.
Quando sua instância do Jira for reconectada ao Notion, os projetos e base de dados de itens não serão recriados. Em vez disso, você continuará a usar os projetos e a base de dados de itens que tinha antes.
Se você quiser desconectar completamente o Jira do Notion:
Acesse
Configurações
na barra lateral →Importações
.Selecione
•••
ao lado do Jira e →Remover
.
Bases de dados sincronizadas legadas têm a seguinte aparência. Se você tiver uma base de dados sincronizada legada, poderá seguir os passos acima para recriar seus projetos e a base de dados de itens no Notion usando o nova função aprimorada de Sincronização com o Jira.