O aplicativo de sincronização bidirecional do Jira é a solução para criar uma sincronização entre a monday.com e sua conta do Jira, tudo em um só lugar, para que você possa gerenciar e acompanhar essa conexão facilmente.
Criando uma nova instância do Jira
Se você ainda não tiver uma instância do Jira criada, precisará criar uma. Se já tiver, pule esta seção.
Para criar uma nova instância do Jira, clique em Administração e, em seguida, navegue até Links de aplicativo no painel lateral esquerdo. Clique em Criar link:
Em seguida, selecione Aplicativo externo sob Tipo de aplicativo e Entrada sob Direção:
Depois, você verá uma página chamada Configurar um link de entrada. Preencha o formulário assim:
Nome: Insira um nome exclusivo para o link
URL de redirecionamento: https://apps-credentials.monday.com/authorize/oauth2/redirect-uri
(copie e cole a URL acima exatamente como está)
Permissão: Administrador do sistema
Por fim, clique em Salvar. Você agora concluiu a configuração de uma nova instância do Jira.
Como usar o aplicativo de sincronização bidirecional do Jira
Clique no botão Integrar na parte superior da tela para o quadro que você deseja usar o aplicativo, e em seguida, procure por Jira Data Center.
Clique no aplicativo Jira Data Center:
Configurar a conexão com o Jira Data Center
Conectar ao Jira é um processo de duas etapas: um aperto de mão inicial concluído pelo administrador do Jira, seguido por uma etapa de conexão conduzida pelo usuário usando OAuth 2.0.
Apenas administradores
Apenas administradores da conta podem criar uma conexão compartilhável do Jira para sua organização. Para configurá-la, abra a seção de Administração, em seguida, selecione a aba Conexão e clique em Perfis locais.
Clique no botão + Novo perfil, e então insira a URL base, ID do cliente e segredo do cliente da sua instância do Jira Data Center e salve suas alterações.
Você pode compartilhar isso com todos na sua conta ou limitar a equipes e pessoas específicas. O perfil que você criou agora estará disponível para os usuários com quem você o compartilhou quando eles se conectarem.
Usuários não administradores
Para conectar a monday.com ao Jira DC pela primeira vez, você precisará que o administrador compartilhe o perfil local da sua instância do Jira com você. Se ele fez isso, o perfil aparecerá no menu suspenso. Isso permitirá seu aperto de mão inicial com a instância do Jira.
A URL base pode ser preenchida automaticamente (se não, você precisará adicioná-la manualmente). A URL base é a que está sendo usada na sua organização.
Uma vez que você tenha feito isso, clique no botão Continuar para Jira Data Center :
Uma janela pop-up aparecerá pedindo para você se conectar à sua instância do Jira Data Center e conceder permissão para visualizar projetos e criar problemas no Jira. Depois de fazer login e aprovar as permissões, você será redirecionado de volta para a monday.com, e a conta do Jira conectada aparecerá no menu suspenso.
Configurando a integração
Escopo de Sincronização
Uma vez que um perfil local tenha sido criado, você será solicitado a configurar a direção da sincronização entre o quadro da monday.com e sua conta do Jira.
Escolha o projeto do Jira no menu suspenso. Os dados que você vê nesta página são baseados no acesso e nas permissões que você tem no Jira. Se você não tiver acesso a um determinado campo, ele não aparecerá como uma opção no menu suspenso.
Em seguida, você precisa escolher quais tipos de problemas do Jira serão usados neste quadro:
Uma vez que a sincronização tenha sido configurada, clique em Próximo para continuar.
Mapeamento de campos
Na página Mapear campos, você pode mapear quais colunas na monday.com corresponderão aos campos do Jira. Você pode escolher campos compatíveis do Jira nos menus suspensos.
Você só pode mapear campos do mesmo tipo. Os campos que você vê são aqueles aos quais você tem acesso (de acordo com suas permissões relevantes) e aparecem no layout épico.
Se você escolher sincronização bidirecional, poderá decidir qual direção os dados serão mapeados para cada campo. Se você escolher uma direção, a ordem que você selecionar determinará a direção na qual os dados serão sincronizados.
Dados de entrada
Uma vez que você chegue à tela de Dados de entrada, poderá determinar as condições que definirão quando os dados são criados ou atualizados na plataforma monday.com.
Os itens com os campos mapeados serão criados ou atualizados apenas se essas condições forem atendidas.
Se você quiser que todos os registros do Jira sejam sincronizados com a monday.com, pode deixar a opção como qualquer registro.
Se você quiser escolher quais registros específicos vêm do Jira, pode selecionar a opção um registro que atende às condições e, em seguida, adicionar suas condições. Você pode criar uma condição e/ou agrupamento.
Dados de saída
Na tela de Dados de saída, você pode determinar as condições que definirão quando os dados são criados ou atualizados na plataforma Jira.
Os itens com os campos mapeados serão criados ou atualizados apenas se essas condições forem atendidas.
Se você quiser que todos os itens da monday.com sejam sincronizados com o Jira, pode deixar a opção configurada como qualquer item.
Se você quiser escolher quais itens específicos vão para o Jira, pode escolher a opção Quando um item que atende às condições e adicionar suas condições.
Uma vez que você tenha terminado de adicionar condições ou não tenha mais nenhuma para adicionar, clique em Ativar sincronização para configurar a integração.
Sincronizando Sub-tarefas do Jira com itens da monday.com
Você pode configurar o aplicativo de sincronização bidirecional do Jira para suportar mapeamentos de subnível e cruzados entre Sub-tarefas do Jira e itens da monday.com.
Sub-tarefa do Jira → item da monday.com
Um construtor de integração pode configurar uma sincronização onde uma Sub-tarefa do Jira cria um item da monday.com e mantém a sincronização bidirecional.
Caso de uso: Quando uma Sub-tarefa é criada ou atualizada em um projeto do Jira selecionado, crie um item da monday.com e sincronize futuras alterações.
item da monday.com → Sub-tarefa do Jira
Um construtor de integração pode configurar uma sincronização onde um item da monday.com cria uma Sub-tarefa do Jira em um projeto selecionado com campos mapeados, e sincroniza futuras alterações.
Como a integração aparece na página de Automação do quadro
Uma vez concluída, a integração aparecerá na página de Automação do Quadro de forma resumida. As setas no meio do modelo de integração mudarão para refletir a configuração da integração.
Escopos de permissão
Os seguintes são os escopos de permissão para a Integração do Jira Data Center:
LEITURA
- Isso permite que a monday.com visualize projetos e problemas que o usuário pode visualizar, incluindo quaisquer itens relacionados, como painéis, filtros, anexos ou comentários. Também permite que a monday.com veja seu perfil de usuário.
ESCRITA
- Isso permite que a monday.com crie, atualize e exclua projetos e problemas que o usuário pode alterar, incluindo quaisquer itens relacionados, como painéis, filtros, anexos ou comentários.
Permissões e propriedade
As atualizações são realizadas em nome do usuário de integração/conexão conectado. Se você usar uma conta de integração dedicada, todas as alterações de sincronização aparecerão com essa conta aparecendo como o “usuário”.
Se a conta do proprietário da integração for removida, a conexão será quebrada porque usa as conexões dessa pessoa. As integrações podem ser transferidas para outro proprietário, mas as integrações devem ser reauthenticadas por um novo usuário com as permissões corretas.
Edição: Por padrão, apenas o proprietário da integração pode editar configurações. O acesso de visualização para não-proprietários é limitado por razões de segurança. No entanto, todos os usuários podem ver dados sincronizados em quadros, e erros aparecem no Histórico de Execução.
O histórico de execução é armazenado por um período limitado (algumas semanas). Se uma integração ou quadro for excluído, seu histórico de execução eventualmente desaparecerá após esse período de retenção.
O mecanismo de polling
Usamos um mecanismo de polling para sincronizar dados a cada 3 minutos. No caso de várias alterações ocorrerem durante a janela de polling de 3 minutos, a nova integração usa cache, de modo que várias atualizações para o mesmo registro em um curto espaço de tempo acionarão apenas uma chamada de API, reduzindo significativamente a carga e melhorando o desempenho.
Erros e solução de problemas
Os erros agora aparecem diretamente no Histórico de Execução com explicações detalhadas, incluindo mensagens do sistema de terceiros (Salesforce ou Jira). Isso fornece total visibilidade sobre o que deu errado e onde.
Durante a configuração, uma ferramenta de mapeamento automático de campos assistida por IA está disponível para ajudar. Além disso, o Autopilot Hub monitora todas as automações e integrações em um só lugar, usando IA para sugerir prováveis causas raiz dos problemas.
Se alguns campos forem atualizados com sucesso, mas outros falharem, toda a execução será marcada como falhada. Isso evita que erros parciais sejam ignorados. Você pode então corrigir o problema e reexecutar.
Conectando a monday.com com o Jira Data Center
A conexão entre a monday.com e o Jira Data Center é estabelecida de forma segura usando OAuth 2.0 – o padrão da indústria para autenticação e autorização. Essa configuração garante que o acesso e as ações de dados sejam sempre realizados dentro dos limites das permissões do Jira de cada usuário.
Configuração única do administrador
Para começar, um administrador do Jira precisa criar um aplicativo OAuth no Jira Data Center. Isso gera um ID do cliente e um segredo do cliente, que são usados uma vez durante a configuração inicial na monday.com. Essas credenciais do cliente (ID do cliente e segredo do cliente) estabelecem uma conexão confiável entre a monday.com e seu Jira Data Center. Elas são usadas apenas durante as trocas de token OAuth.
Conexões de usuários individuais
Uma vez que a confiança inicial é estabelecida, os usuários individuais se autenticam diretamente com o Jira (via OAuth/SSO); a monday.com nunca recebe suas senhas. Isso significa que cada ação – desde visualizar itens até atualizar problemas, é realizada com base nas permissões do Jira do próprio usuário. Nenhuma credencial compartilhada ou acesso de administrador é necessário, mantendo a integração flexível e segura.
Migração para a sincronização bidirecional do Jira Data Center
a monday.com está introduzindo um novo aplicativo de integração de sincronização bidirecional para a integração do Jira Data Center. A opção de sincronização bidirecional está disponível diretamente na monday.com sem a necessidade de uma ferramenta de terceiros ou limitações de automações unidirecionais, tornando-a muito mais fácil de usar do que outras ferramentas.
Este novo aplicativo substitui os modelos de integração unidirecional legados por uma solução mais escalável, segura e flexível que mantém os dados alinhados entre plataformas em tempo real.
Limitações conhecidas
- Não é possível mapear retroativamente itens existentes. Para gerar links entre as duas plataformas, a integração deve ser acionada, e novos itens precisam ser criados na monday.com ou novos problemas no Jira.
- O escopo de Sub-tarefa suporta um único tipo de Sub-tarefa por configuração de aplicativo.
- Sub-tarefas do Jira sincronizam apenas com itens da monday.com. O mapeamento de Sub-tarefas do Jira para subitens da monday.com não é suportado.
- Atualmente, não suportamos a sincronização de comentários do Jira para a monday.com.
- Exclusões de um problema do Jira ou de um item da monday.com não são intencionalmente suportadas para evitar a exclusão de dados no Jira através da integração.
Por favor, confira o artigo sobre benefícios para saber mais.
FAQ
Ficou com alguma dúvida? Acione o suporte oficial a qualquer momento.
Para soluções completas de implantação, treinamento e estruturação de workflows no Brasil, conte com a Audatia, parceira oficial da monday.com. Descubra como podemos ajudar →
