Disponível para: Jira Cloud, servidor do Jira (no local) e Datacenter (também protegido por
LDAP)Configurado por: admin do time da Miro e admin do sistema do Jira com permissões administrativas do projeto
⚠️ Se surgir algum problema técnico, consulte nosso artigo sobre Possíveis problemas e como resolvê-los.
💡 Saiba mais sobre os cartões do Jira nos artigos Perguntas frequentes sobre os cartões do Jira e como configurar o webHook para cartões do Jira.
Como configurar a Miro no Jira
✏️ Observe que os menus do Jira podem diferir dependendo da versão do Jira que você estiver usando, no entanto, o fluxo geral deve ser o mesmo. As instruções a seguir também podem ser encontradas no Suporte da Atlassian.
Passo 1 — Link do aplicativo
Primeiro, crie um link de aplicativo e configure-o.
- Vá para Configurações do Jira > Produtos > Integrações > Links do aplicativo > Criar link:Observe que a interface do Jira pode ser diferente dependendo da sua versão do Jira.
- Escolha o link direto do aplicativo e digite https://miro.com/ no campo URL do
aplicativo.Importante: você deve inserir o URL neste formato exato. Clique em Continuar.
Como criar o link
- No próximo menu, basta clicar em Continuar novamente.
- No menu do link de revisão, verifique duas vezes se o URL ainda está exatamente https://miro.com/ e digite o nome do aplicativo de sua escolha. Role para baixo e, na parte inferior, marque a caixa Criar link de entrada. Pule o resto dos campos e clique em Continuar.
Apenas o campo Nome do aplicativo deve ser
preenchido. - Aqui você verá os campos dos valores da Miro. Para obter os valores, faça login na Miro e vá para as configurações do time > Aplicativos e integrações > Cartões do Jira.Se
você não tiver os cartões do Jira na sua lista de aplicativos, role até o topo da seção, clique em Instalar aplicativos e continue para instalar o aplicativo no Marketplace da Miro. Depois de ver os cartões do Jira na lista, clique para
abri-lo.A guia do plugin será aberta e você pode ver o Passo 1 para obter os valores necessários:Valores dos cartões do JiraCopie
os valores e adicione-os ao menu do link de revisão da Atlassian. - Você verá a mensagem de processamento por um ou dois momentos: A última etapa da criação do link.
Isso conclui as etapas do lado da Atlassian. O link aparecerá na lista de links do seu aplicativo.
Passo 2 — Conexão
Volte para as configurações do seu cartão do Jira na Miro e escolha uma das duas opções: crie um webhook manualmente ou automaticamente. Se você escolher manualmente, desmarque a opção. Veja mais informações neste artigo. Recomendamos fortemente o uso do webhooks automático, para que você não precise redefini-lo em caso de grandes atualizações do plugin.
Por fim, digite seu URL do Jira e clique em Conectar:
Como conectar cartões do Jira
Para obter o URL do Jira, copie o URL base da sua instância do Jira. Aceitamos os seguintes formatos:
https://name.domain/
https://name.domain:port/
https://IPaddress/
https://IPaddress:port/
Se seu URL do Jira não for aceito, consulte este artigo. Verifique também se a Miro tem acesso suficiente ao seu Jira para estabelecer a conexão.
Agora você conectou sua instância do Jira ao seu time da Miro.
⚠️ Observe que o servidor do Jira está sendo descontinuado a partir de fevereiro de 2024. As etapas a seguir funcionarão de forma semelhante com o data center do Jira.
- Vá para https://your-jira-server/plugins/servlet/applinks/listApplicationLinks. Se a opção "Links do aplicativo" não estiver selecionada, clique nele. Links de aplicativos do servidor do Jira
- Clique em Criar link. Selecione "Produto da Atlassian" e forneça o URL do aplicativo, "https://miro.com". Clique em Continuar. Como configurar o URL do aplicativo
- Você será levado à caixa de diálogo "Aplicativos de link". Adicione um nome do aplicativo (por exemplo, cartão da Miro Jira) e selecione "Aplicativo genérico" para tipo de aplicativo.
Você deve ver o URL do seu aplicativo do Jira em "Você está criando um link de:" e deve ver https://miro.com em "Para este aplicativo:". Clique em Continuar.Como configurar os detalhes dos aplicativos do link - A configuração do link será processada. Quando terminar, você verá seu novo link na área "Links do aplicativo" do servidor do Jira. Seu aplicativo configurado no servidor do Jira
- Em seguida, você precisará configurar os dados do seu aplicativo. Clique no ícone de lápis do seu aplicativo para editar os dados do aplicativo.
- Na caixa de diálogo Configurar, clique na opção Autenticação de entrada. Preencha a chave do consumidor, nome do consumidor, chave pública e, opcionalmente, uma descrição. Esta informação é encontrada na Miro nas configurações do seu time em Aplicativos e integrações. Como configurar os dados de autenticação de entrada no servidor do JiraDetalhes do link do aplicativo do Jira na Miro
- Role até o final das opções de autenticação de entrada e clique em Salvar. Seu status de verificação agora deve ser confirmado e este servidor do Jira agora pode ser usado na Miro para uso com os cartões do Jira. Certifique-se de escolher "Servidor do Jira" e "OAuth 1.0" no lado da Miro.
Autorização do usuário
Depois que a integração estiver conectada, cada um dos seus usuários finais precisa conectar seu perfil pessoal do Jira para estabelecer as permissões adequadas. Isso garante que o acesso de cada usuário no lado da Miro seja exatamente o mesmo que no final da sua instância do Jira. Quando os usuários finais tentarem importar ou editar um cartão do Jira pela primeira vez, será solicitado que façam login no Jira usando suas credenciais individuais de usuário.
Depois que isso terminar, os usuários podem adicionar tarefas como cartões no lousa. Todas as alterações feitas no Jira são refletidas nos cartões do Jira no board.
✏️ Se um usuário não tiver credenciais do Jira e tiver acesso ao board no qual o cartão foi adicionado, verá o título do cartão, o tipo de item, prioridade, responsável e todos os atributos que estão configurados para serem mostrados no cartão do Jira. No entanto, não poderão expandir o cartão para ver outros atributos e editá-lo, a menos que autorizem. Se o usuário não conectar suas credenciais do Jira, não verá o avatar do responsável e a aparência geral do cartão será diferente.
Como usar uma instância do Jira para vários times da Miro (opcional)
Observe que os cartões são instalados no nível do time, portanto, se você estiver usando nosso plano Enterprise e tiver vários times, precisará repetir o Passo 2 para cada um dos times que deseja conectar. O link do aplicativo existente será usado para todos eles.
Depois de conectar seu time a uma instância do Jira, nos seus Webhooks do Jira, um novo Webhooks é criado, para o time específico da Miro ao qual você fez uma conexão. A criação de um Webhooks é estabelecer o canal para as solicitações de atualização.
⚠️ Se você planeja conectar vários times, recomendamos fortemente ir para sua página dos Webhooks do Jira e editar cada Webhooks recém-criados para ter um nome exclusivo; caso contrário, pode haver confusão.
A conexão de várias instâncias do Jira a um time da Miro não é compatível.
Desinstalar o plugin
Vá para as Configurações do seu time > Aplicativos e integrações > Cartões do Jira e desabilite seu URL do Jira em Passo 2. Em seguida, clique em Desinstalar para o time.
Desinstalar os cartões do Jira
💡 Não se esqueça de dar uma olhada no artigo principal sobre como usar os cartões do Jira!