Leitura de 3 minutos

Recurso

Trabalhamos muito para criar uma nova integração do Jira Cloud para você. Agora ela substituiu a integração anterior com a qual você pode estar familiarizado! Com esta integração do Jira Cloud:

Não será mais necessário ter um token ou ser um administrador para configurar a integração.
- Se um usuário puder editar um problema no Jira, as alterações também poderão ser feitas pela integração usando as credenciais desse indivíduo para configurar a integração.
- A integração continuará a usar o nível de permissões de API disponíveis para o usuário que configurou a integração.
Você conseguirá usar projetos gerenciados por equipe
Você terá acesso a campos compatíveis adicionais
Você desfrutará da nossa opção de sincronização bidirecional nova e aprimorada
Você vai experimentar um novo design bonito e simplificado!

Nota: a integração descrita neste artigo substitui a antiga integração do Jira Cloud. A integração antiga foi descontinuada, portanto certifique-se de usar a integração descrita neste artigo!

Adicione a integração

Para adicionar a integração a um quadro, comece abrindo a Central de Integrações e procurando por "Jira". Selecione a integração que diz "by monday.com", e não a que diz "Deprecated":

Nota: múltiplas instâncias do Jira são suportadas na integração da monday, mas não recomendamos conectá-las no mesmo quadro.

A integração tem um modelo que tem o poder de vários modelos menores! Clique em "Adicionar ao quadro" para personalizá-la.

Depois de selecionar o modelo, é hora de estabelecer a conexão entre o Jira e a monday.com! Clique no logotipo do Jira no início do modelo e escolha "Conectar". Você será redirecionado para a Atlassian para inserir suas credenciais. Usamos OAuth para fazer a conexão, portanto a monday.com nunca terá acesso às suas credenciais de login do Jira.

Observação: você só precisa de suas credenciais no início. Ao contrário das versões anteriores desta integração, você não precisa ser um administrador para configurar a integração e não precisa de um token.

A integração do Jira não funcionará retroativamente. Problemas, épicos, etc. que foram criados antes da integração precisarão ser atualizados para que sejam sincronizados. Tudo o que for criado ou atualizado depois de configurar a integração será sincronizado.

Ao fazer a conexão inicial com sua conta do Jira, aparecerá uma solicitação para você revisar uma lista de permissões. Leia com atenção para ter certeza de que você entendeu como a nova integração funciona. Se você concordar com os termos, clique em "Aceitar" para ser redirecionado de volta à monday.com.

Nota: devido às permissões nesta integração, não é possível transferir modelos a partir dela para outros usuários em sua conta.

Personalize seu modelo

Escolha a direção da sua sincronização

Depois de conectar sua conta, você tem um mundo de opções de personalização disponíveis! Para este exemplo, considere o modelo a seguir:

"Sincronizar entre Jira os problemas neste projeto desse tipo e elementos neste quadro com esses campos"

Depois de conectar sua conta do Jira com o ícone do Jira, comece escolhendo a direção da sincronização. Você tem a opção de mover dados:

para a monday.com a partir do Jira
para o Jira a partir da monday.com
ou em ambas as direções!

Escolha o projeto do Jira ao qual se conectar

Em seguida, usando os campos "neste projeto" e "deste tipo", você pode selecionar o projeto específico e o tipo de problemas que serão sincronizados com/do Jira.

Definir condições para a sincronização

Em seguida, você pode selecionar as condições para os problemas que deseja sincronizar. Embora não seja possível usar campos personalizados para definir condições, você tem diversas opções! Neste exemplo, estamos optando por sincronizar todos os problemas em que a "Prioridade" não é "Baixa" ou "Mais baixa":

Em seguida, você pode definir as condições que devem ser atendidas para que os elementos do seu quadro da monday sejam sincronizados com o Jira. Se você souber exatamente o que está procurando, pode digitar para localizar o que procura rapidamente no menu suspenso.

Nota: como o Jira sincroniza com um usuário específico, e não com a conta inteira, somente o indivíduo que conectou sua conta do Jira à monday.com poderá editar os modelos adicionados a um quadro. Isso vale independentemente de quem sejam os proprietários do quadro.

Decidir como gerir atualizações

Clique em "estes campos" para abrir suas opções finais de personalização. Independentemente da direção escolhida para sincronizar itens e problemas recém-criados, você pode optar por alterar a direção de sincronização para qualquer atualização a elementos ou problemas existentes.

Aqui você pode selecionar um campo de problema do Jira, um campo de elemento da monday.com e a direção com a qual gostaria de sincronizar futuras atualizações: se quer que as atualizações dos problemas do Jira atualizem os elementos da monday.com, ou vice-versa, ou ambos!

Observação: alguns campos padrão não podem ser editados. Alguns exemplos são: ID do elemento, chave do problema, link para o problema, etc. Como esses campos não podem ser editados após a criação de um problema, eles não serão sincronizados.

É isso! Quando terminar de personalizar, clique em "Adicionar ao quadro" para ver a integração funcionar!

Criar uma sincronização bidirecional

Uma sincronização bidirecional ocorre quando os dados estão sendo enviados da monday.com para o Jira e extraídos do Jira para a monday.com. Isso faz com que seus dados sejam correspondentes em ambas as plataformas e permaneçam atualizados.

A natureza deste modelo permite que você escolha a direção de sua sincronização para criar uma sincronização bidirecional entre o Jira e a monday.com.

Conforme mencionado na seção anterior deste artigo, ao configurar este modelo, você será solicitado a mapear alterações futuras entre o Jira e a monday.com ao clicar "nestes campos". Independentemente da direção escolhida para sincronizar elementos e problemas recém-criados ao clicar em "Sincronizar" durante a configuração, você pode optar por alterar a direção de sincronização para qualquer atualização a elementos ou problemas existentes ao clicar "nestes campos".

Configurando a sincronização bidirecional

Ao mapear "estes campos", você selecionará o campo no Jira, o campo na monday.com e a direção que você deseja para a sincronização. Para criar uma sincronização bidirecional, selecione "ambos os sentidos".

Por exemplo, usando o GIF abaixo, se você quiser mapear a coluna "Pessoa" do seu elemento na monday.com para o campo "Responsável" no Jira, selecione esses campos abaixo do logotipo da respectiva empresa. Em seguida, no menu suspenso "Escolher direção", escolha "ambos os sentidos" para indicar que as informações trafegarão em ambos os sentidos.

Nota: você pode adicionar ou remover até 1.000 etiquetas ao mapear uma sincronização bidirecional entre a monday.com e o Jira.

Campos compatíveis do Jira

Os campos a seguir são compatíveis ao mapear do Jira para a monday.com:

Do Jira > monday.com

boleano
componente: nome e descrição
Data
datetime
versão da correção: nome e descrição
Grupo
issuekey
issuetype
Etiquetas
Número
Prioridade
Progresso
Projeto
radio button
Resolução
Status
string
Usuário
Votos
watches
Tempo gasto
Pessoa
sprint: incluindo data de início, data de término e meta
Story points
épico: incluindo responsável pelo épico
epic link
- Nota: se estiver usando "epic link (name)", observe que ele é compatível com todos os tipos de problema, excluindo "epic" e "issue (any)". Para obter "epic name" em tipos de issue "epic", selecione "summary".
Responsável
- Nota: Confira a seção "Extraia o responsável" deste artigo para ver as etapas específicas a serem seguidas.
Tempo gasto
- Nota: se estiver usando "tempo gasto", os dados associados só serão sincronizados com a monday.com depois que a tarefa for marcada como feita no JIRA.
entidades personalizadas
Todos os campos personalizados do JIRA podem ser mapeados em uma coluna de status na monday.com, contanto que o tipo de campo personalizado seja um entre os compatíveis (veja acima).

Os campos a seguir são compatíveis para mapeamento da monday.com para o Jira (o oposto do acima):

Da monday.com > Jira

Data
datetime
Menu suspenso
E-mail
Link
Prioridade
Pessoa
radio button
string
Número
Responsável
- Nota: a coluna de pessoas da monday.com não é compatível. Uma coluna do tipo texto ou e-mail pode ser usada no lugar dela.
Status
- Observação: como o Jira permite criar um fluxo de trabalho que faz a transição entre diferentes status, nem todas as alterações na monday.com alterarão o status do problema do Jira. As alterações que afetariam o status no Jira são as alterações que se aplicam ao fluxo de trabalho no Jira. Se você alterar o status na monday.com para uma etiqueta que o Jira não consiga interpretar, receberá uma notificação de que a alteração não afetou seu problema no Jira.

Observação: Na nova integração do Jira Cloud, há compatibilidade com os projetos gerenciados por equipe (anteriormente chamados de "projetos de próxima geração")! 🎉

Colunas compatíveis da monday.com

Para obter uma visão geral das colunas da monday.com que são atualmente compatíveis ao mapear da monday.com para o Jira, abra o menu suspenso e dê uma olhada no quadro.

A sua coluna monday.com é compatível? Dê uma olhada na tabela.

Coluna	Compatível?	Notas
Pessoas	Sim
Status	Sim
Fórmula	Não
Timeline	Não
Data	Sim	A data é compatível, mas a hora não é.
Controle de tempo	Não
Numeração automática	Não
ID de Elemento	Não
Telefone	Sim
Arquivo	Sim
Link para Elemento	Não
Espelho	Não
Menu suspenso	Sim
Local	Não
E-mail	Sim
Tags	Não
Texto	Sim
Progresso	Não
Link	Sim
Números	Sim
Última atualização	Não
Relógio Mundial	Não
País	Não
Texto longo	Sim
Sinal de confirmação	Sim
Voto	Não
Avaliação	Sim
Log de criação	Não
Semana	Não
Atualizações	Sim*	As informações somente serão extraídas uma única vez. O modelo extrairá dados somente a partir da primeira atualização que está sendo criada, e não das atualizações seguintes.
Seletor de cores	Não

Dica: você pode usar o URL na coluna "Link" para acessar instantaneamente seu problema no Jira!

Como importar dados do Jira

Embora não haja uma maneira direta de importar dados do Jira para a monday.com, iniciar um modelo vai acionar uma importação. Assista ao vídeo abaixo para entender melhor como isso funciona:

Observação: há uma limitação do lado do Jira de que apenas 100-150 problemas no Jira podem ser atualizados e sincronizados com a monday a cada 5 minutos.

Como excluir um modelo

Para excluir ou pausar seu modelo, visite a aba ativa "Integrações de quadro" na Central de integrações. Para pausar ou retomar sua integração, ative ou desative o botão. Para excluir a integração, abra o menu de integração usando o ícone de três pontos e selecione "Excluir integração":

No menu de integração, você também pode visualizar a atividade da integração, editar ou duplicar o modelo.

Escopos de permissões

Por que estamos solicitando permissão para acessar suas informações?

Os escopos de permissão são uma forma de definir e controlar o que um aplicativo pode acessar ou fazer em nome de um usuário ao se integrar com outro serviço. Eles especificam os tipos de dados e ações que a integração pode acessar ou realizar.

Quando você conecta dois serviços, um serviço poderá precisar acessar determinadas informações do outro para operar adequadamente. Os escopos de permissão garantem que a integração somente tenha acesso aos dados específicos necessários para executar suas tarefas, como ler eventos de calendário ou criar tarefas, sem acessar dados não relacionados. Isso ajuda a proteger sua privacidade ao limitar o acesso da integração a apenas o que é necessário para sua funcionalidade pretendida.

Específico à integração com o Jira Cloud

Estes são os seguintes escopos de permissão para a integração com o Jira Cloud:

read:jira-work e write:jira-work
- A monday.com requer essa permissão para ler, criar, atualizar e excluir problemas do Jira aos quais o usuário tem acesso com base na configuração da integração.
read:me
- Permite à monday.com acessar as informações básicas do perfil do usuário autenticado. Possibilita que a integração crie uma conexão associada ao usuário que a criou.
read:jira-user
- Permite à monday.com mapear usuários da monday.com a usuários do Jira (por e-mail). Utilizada para apoiar o mapeamento de usuários da monday.com na coluna de pessoas ao usuário do Jira.
manage:jira-webhook
- Permite à monday.com configurar webhooks em nome do usuário, para que a monday.com seja notificada sobre alterações em problemas do Jira.
offline_access
- Esta permissão possibilita que o app mantenha acesso durante um período longo sem solicitar que o usuário se reconecte continuamente.

Resolução de problemas

Estes são alguns problemas e soluções comuns:

Problema 1

Conectei o Jira ao meu quadro da monday.com e mapeei meus usuários. Mesmo assim, meus usuários não estão chegando ao quadro da monday.com.

Solução: você pode ter as configurações de "Visibilidade padrão do perfil" no Jira definidas para ocultar seu endereço de e-mail de aplicativos externos, como a monday.com. Isso significa que a monday.com não pode acessar o endereço de e-mail do usuário para mapeá-lo de acordo com seu quadro da monday.com. Para corrigir isso, você terá que selecionar "exibir o endereço de e-mail" em suas configurações de visibilidade no Jira. Saiba mais aqui.

Problema 2

Eu sou um administrador. Conectei o Jira ao meu quadro da monday.com e mapeei meus usuários. Acionar uma automação funciona para mim, mas não funciona quando aciono uma automação para outro usuário.

Solução: suas configurações de visibilidade padrão do perfil no Jira podem estar definidas para ocultar seu endereço de e-mail de aplicativos externos, como a monday.com. Nesse caso, a monday.com tem acesso ao e-mail conectado ao seu perfil de usuário porque foi você quem fez a conexão. Portanto, foi concedida permissão para compartilhar seu e-mail. No entanto, você não pode compartilhar o endereço de e-mail de outro usuário com o Jira via monday.com quando ele estiver oculto. Para corrigir isso, você terá que selecionar "exibir o endereço de e-mail" em suas configurações de visibilidade no Jira. Saiba mais aqui.

Problema 3

Um projeto pode estar selecionado, mas o tipo de pendência está em branco.

Solução: nesse caso, o usuário que está configurando a integração não possui as permissões corretas do projeto Jira. As permissões do projeto Jira estão bloqueando a seleção do campo de tipo de problema Jira. Como resultado, o campo do tipo de problema é exibido em branco. Para resolver isso, altere as permissões em sua conta do Jira.

Se você tiver alguma dúvida, entre em contato com nossa equipe por aqui. Estamos disponíveis 24 horas e prontos para ajudar!

A integração do Jira Cloud