Se você tiver um problema durante a instalação ou uso dos Сards do Jira ou do complemento do Jira, este guia pode ajudar.
Sugestões para os cartões do Jira
Mensagem/problema |
Possíveis causas e etapas para resolver o problema |
---|---|
Conexão | |
Aplicável a OAuth 1.0. (Servidor e Data Center do Jira). O Jira não está conectado ao tentar se conectar à Miro com suas credenciais pessoais. Não é possível adicionar os cartões do Jira ao tentar usar o aplicativo de cartões do Jira em um board. |
O aplicativo de cartões do Jira está instalado, mas seu time da Miro não está conectado ao Jira. Siga este guia de instalação: Como configurar e desinstalar os cartões do Jira. Se você não for um admin do time, peça ao admin para fazer isso. |
Solicitação ao Jira… falhou: tempo limite ocorreu/host desconhecido/conexão negada. |
O Jira é acessível somente na sua intranet (você está usando os endereços IP errados para se comunicar com o sistema do Jira). Certifique-se de incluir na lista de permissões nosso endereço IP, domínios e subdomínios para fornecer à nossa integração o nível de acesso necessário. Se você estiver no servidor do Jira e em uma versão antiga, verifique se nenhuma funcionalidade do Dark bloqueia o acesso da Miro. |
Aplicável a OAuth 1.0. (Servidor e Data Center do Jira). O link do aplicativo no seu Jira não está configurado corretamente. |
— Você perdeu algumas etapas na configuração do link ou do Webhook. — Você instalou o Addon do Jira em vez de configurar o link para os cartões do Jira. Tente instalar a integração dos cartões do Jira do zero. Se você escolheu criar os Webhooks manualmente, tente criá-los automaticamente. |
Aplicável a OAuth 1.0. (Servidor e Data Center do Jira). O link do aplicativo na sua instância do Jira não está configurado corretamente ou o token expirou. Verifique o link do aplicativo e reconecte a integração. |
— O link do aplicativo no Jira foi reconfigurado. — O token expirou. — O token foi revogado. Certifique-se de que seu link do aplicativo esteja configurado corretamente e tente Conectar a Miro aos cartões do Jira novamente. Se você estiver usando um Jira altamente protegido ou um proxy, certifique-se de incluir na lista de permissões nosso endereço IP, domínios e subdomínios para fornecer à nossa integração o nível de acesso necessário. Se você estiver no servidor do Jira e em uma versão antiga, verifique se nenhuma funcionalidade do Dark bloqueia o acesso da Miro. |
Aplicável a OAuth 1.0. (Servidor e Data Center do Jira). O link do seu aplicativo pede mais valores do que apenas URL, chave do consumidor, nome do consumidor, chave pública. |
Você está olhando para a guia Autenticação de saída do menu de configuração. — Altere para a Autenticação de entrada. A autenticação de saída não requer configuração. — Se você não puder pular a etapa, adicione quaisquer valores temporários. Você poderá removê-los mais tarde: quando estiver na página com a lista dos links do seu aplicativo, clique para Editar o link dos cartões da Miro e remova os valores temporários. |
Aplicável a OAuth 1.0. (Servidor e Data Center do Jira). URL do Jira não é
|
Seu Jira está em uma rede privada/o firewall da sua empresa bloqueia as conexões de rede externa. Adicione nossos endereços IP do Gateway NAT (e portas) à sua lista de permissões. |
Você usa um proxy/Seus URLs externos e internos do Jira não correspondem. Certifique-se de preencher o campo URL do Jira com o endereço que podemos acessar. Portanto, configure um proxy reverso que nos permita acessar e/ou siga as etapas deste guia da Atlassian. Com esta solução, a integração poderá conectar e encaminhar as solicitações com sucesso entre o seu Jira e a Miro se seus URLs externos e internos forem diferentes. |
|
Há um problema com o seu certificado SSL (os certificados autoassinados não são compatíveis). Verifique o certificado SSL ativo no servidor do Jira. Esta ferramenta pode ser útil: digite o seu URL do Jira e veja os resultados da verificação de |
|
Seu Jira está em SSO (pode também resultar no erro de autenticação de entrada não está configurado corretamente). Certifique-se de que seu processo de Logon único não seja aplicado às solicitações de conexão da nossa integração. Para isso, os seguintes pontos de extremidade devem ser excluídos dos processos de Logon único: POST {JIRA_URL}/plugins/servlet/oauth/request-token
POST {JIRA_URL}/plugins/servlet/oauth/access-token
GET {JIRA_URL}/rest/api/2/serverInfo
|
|
Comportamento inesperado durante a instalação |
Você usa as versões 6.4 ou inferiores do Jira. Nossos cartões não funcionarão com essas versões devido a este bug do Jira. Atualize seu Jira para a versão mais recente. |
A autorização do aplicativo falhou. Tente autorizar o aplicativo novamente. |
Uma perda momentânea de conexão. Clique para Conectar novamente. |
Aplicável a OAuth 1.0. (Servidor e Data Center do Jira). Erro do Jira: "Você não tem permissões para criar Webhooks da Miro". |
Você não tem direitos de admin no Jira. Peça ao seu admin do Jira para fazer upgrade da sua função para admin para que você possa configurar a integração. |
Solicitação ao Jira falhou: criação do caminho do PKIX falhou: não foi possível encontrar o caminho de certificação válido para o destino solicitado |
Há algum problema com o seu certificado do servidor. |
Incapacidade de autorizar no Jira por meio da Miro. |
Isso pode ocorrer devido a uma configuração incorreta da infraestrutura do Jira quando a configuração da infraestrutura indica suporte para o protocolo HTTP/2, mas nenhuma transferência de dados ocorre ao tentar usá-la. Verifique suas configurações HTTP/2 nos arquivos de configuração do seu servidor da web para garantir que elas estejam configuradas corretamente. Se necessário, desabilite temporariamente o suporte a HTTP/2 na configuração do seu servidor para garantir a compatibilidade com versões anteriores e o serviço ininterrupto até que o problema seja resolvido. |
Como trabalhar com cartões |
|
Os cartões do Jira não estão sendo atualizados.
|
Aplicável a OAuth 1.0. (Servidor e Data Center do Jira). Você está usando um Webhook manual. Desabilite a integração e reconecte-a usando um Webhook automático. Se tudo estiver funcionando bem com um Webhook automático, isso significa que um manual foi configurado incorretamente. Além disso, consulte Como configurar Webhooks para cartões do Jira. |
Aplicável a OAuth 1.0. (Servidor e Data Center do Jira). Se você estiver usando um Webhook automático: A primeira etapa de solução de problemas é reconectar a integração. Se isso não ajudar, pode haver várias razões pelas quais os cartões do Jira não estão mais vivos: — Um board da Miro foi movido/baixado por meio de backup para um time a partir de outro. — Os itens do Jira que não são atualizados foram movidos de um projeto para outro no lado do Jira. — Você não tem acesso aos projetos nos quais os itens do Jira estão localizados. — Os cartões que não estão sendo atualizados não estão localizados na mesma instância do Jira que você está usando atualmente no seu navegador. |
|
Aplicável a OAuth 1.0. (Servidor e Data Center do Jira). Os cartões do Jira pararam de atualizar sem nenhuma alteração do seu lado e ao tentar reconectar, o link do aplicativo no seu Jira não está configurado corretamente. |
A mensagem de erro pode aparecer quando a Miro não consegue solicitar um Jira conectado devido a um erro de autorização. Isso pode acontecer se o usuário que configurou a integração revogar seu token ou se o Jira estiver de alguma forma com uma duração mínima do token emitido, para que ele simplesmente se torne inválido após esse período e tenha que ser reconectado para obter um novo token de autorização válido com o qual a Miro acessa o Jira. |
A opção Editar cartão retorna uma janela em branco |
Aplicável a OAuth 1.0. (Servidor e Data Center do Jira). Você usa o Jira ver. 7.6 e superior. Por razões de segurança, a Atlassian pode não permitir que o conteúdo seja inserido nos iFrames, o que também pode afetar as janelas pop-up para editar seus cartões do Jira. Você pode usar essas instruções como uma solução alternativa. |
Não é possível adicionar cartões do Jira |
Aplicável a OAuth 1.0. (Servidor e Data Center do Jira). Você criou um Webhook manual e não salvou as informações de configuração. Verifique se o campo URL do Jira está preenchido nas Configurações da Miro. Certifique-se de clicar em Conectar |
O ícone Editar não é exibido
|
Aplicável a OAuth 1.0. (Servidor e Data Center do Jira). Você usa as versões do servidor do Jira 7.6 ou superior. O ícone Editar pode não ser exibido devido a uma atualização de segurança nesta versão. |
Seu perfil não tem permissão para editar o item do Jira em questão. Verifique se você pode acessar o modo de edição tendo aberto o item no lado do Jira. |
|
Você recebe a mensagem: você não está conectado e não tem as permissões necessárias para agir sobre o item selecionado como convidado. Faça login |
Devido à forma como nossa integração usa cookies, seu Jira pode não permitir que você faça login a partir desta página. Faça login no Jira em outra guia do |
Seu Jira está em SSO e seu IDP não permite a autenticação por meio de iframes. Se você estiver trabalhando no aplicativo para desktop da Miro, recomendamos alternar para a versão do navegador da Miro em miro.com. |
|
Nenhuma opção para converter/criar um cartão do Jira na Miro quando você escolhe alguns projetos específicos: — Nenhum dado no campo Tipo de item — O botão Converter/Criar está inativo. |
Você não tem acesso ao projeto no Jira. Verifique se você pode receber acesso. |
Não é possível criar um item do Jira ao tentar converter/criar um novo cartão do Jira: |
Você não tem permissão para criar itens do Jira. Entre em contato com seu admin do Jira e peça para que ele conceda a permissão necessária no lado do Jira. É assim que deve parecer: |
Alguns campos personalizados não são mostrados no menu Converter em item do Jira/Editar item do Jira. Não é possível criar um item do Jira. Erro de campos obrigatórios (...) não são compatíveis ao criar um item do Jira na Miro. |
Os campos não estão habilitados no seletor de cartões do Jira do board. Use nosso seletor do Jira no aplicativo para configurar os campos personalizados seguindo as etapas deste guia. |
Se o Selecione campos para exibir em cartões não mostrar campos personalizados do seu Jira, é possível que algumas das telas configuradas para os projetos da sua instância do Jira protejam os campos da Miro. Vá para Configurações do projeto > Telas > Esquema de tela padrão e verifique se os campos necessários são permitidos. |
|
A Miro não é compatível com campos de tipo de dados complexos. A Miro é compatível com campos personalizados básicos, mas não com campos complexos. Configure os campos do cartão do Jira e remova os campos que não são compatíveis. |
|
Você não pode escolher o Relator ao editar/criar um cartão do Jira. |
Não há campo de relator nos metadados Criar do Jira: o campo está indisponível na tela Criar do Jira para o projeto selecionado. Vá para Configurações do projeto > Telas e verifique se o campo Relator está presente na tela Criar. |
Você não tem a permissão necessária para definir o relator para itens no projeto selecionado. Peça ao admin do Jira para verificar seus níveis de acesso e garantir que você tenha permissão para definir/alterar o campo Relator no projeto selecionado. Para fazer isso, eles precisam fazer login no Jira > ir para Configurações > Problemas > Esquemas de permissão > e verificar o campo Modificar relator (adicione o acesso ao aplicativo: Qualquer usuário conectado no caso de você não tê-lo na lista): |
|
O campo de relator não é editável para a trilha de auditoria e está definido para quem criou o item. O campo indisponível é um comportamento esperado. |
|
Alguns campos são exibidos no modo de edição de um cartão, mas não aparecem nos cartões do Jira nos boards. |
A Miro não recebe atualizações do Jira.
|
Aplicável a OAuth 1.0. (Servidor e Data Center do Jira). O Jira não está disponível no erro nas Configurações do aplicativo de cartões do Jira. |
1. Peça ao admin do time para desabilitar e reconectar a integração. 2. Seu Jira está sob proteção (firewall, bloqueadores de segurança, etc.) e não pode ser alcançado pela Miro. Se ao mesmo tempo os cartões do Jira sincronizarem entre a Miro e o Jira, isso significa que seu Jira pode nos enviar Webhooks. É por isso que você pode ver as atualizações nos seus boards.
Se você estiver no servidor do Jira e em uma versão antiga, verifique se nenhuma funcionalidade do Dark bloqueia o acesso da Miro. |
Aplicável a OAuth 1.0. (Servidor e Data Center do Jira). Erro de Webhooks do Jira nas Configurações do aplicativo de cartões do Jira |
— Você alterou/excluiu um Webhook no lado do Jira. A
Como solução, sugerimos que você desabilite a integração e reconecte-a novamente. |
Quando você usa Ctrl + V (para Windows)/Cmd + V (para Mac) para colar um link de item do Jira no board, ele não é convertido em um cartão do Jira, mas é colado como um URL. |
O board ainda está carregando. Pode acontecer em boards ou boards maiores com imagens maiores ou documentos em PDF. Aguarde pelo menos 10 segundos depois de abrir o board e deixar o board carregar completamente. Em seguida, tente colar o link novamente. |
A descrição não está visível nos cartões do Jira no board. |
Para ver os dados do cartão, clique no cartão e escolha expandir para ver os dados do cartão na barra lateral do seu board. |
"Mostrando 0 de 0 sprints correspondentes" ao tentar pesquisar e encontrar sprints disponíveis. |
1. Isso acontece quando você não tem sprints ativos/futuros (todos eles são fechados/completos). 2. Seu filtro no Jira não inclui nenhum projeto. Adicione um projeto necessário ao JQL do filtro do board. Assim, os sprints aparecerão no Jira e na Miro. |
Aplicável a OAuth 1.0. (Servidor e Data Center do Jira). Conexão SSL com… falhou |
O erro significa que a Miro não tem acesso ao seu Jira.Entre em |
Nenhum usuário é exibido no campo "Assignatário" do cartão do Jira na Miro. |
Certifique-se de que você tenha a permissão "Navegar por usuários" definida no nível global no Jira. Saiba mais sobre como gerenciar permissões globais. |
Sugestões para o complemento do Jira
Mensagem/problema | Possíveis causas e etapas para resolver o problema |
---|---|
Você não está conectado e não tem as permissões necessárias para agir sobre o item selecionado como convidado. Faça login |
Infelizmente, como nosso plugin usa cookies, o Jira não permitirá que você faça login a partir desta página. Faça login no Jira em outra guia do navegador. |
Depois de clicar no botão Instalar na página do complemento, você pode ver o seguinte erro: |
Uma perda momentânea de conexão. Neste caso, basta tentar instalar novamente um minuto depois. |
Durante ou após a configuração do complemento do Jira, você não pode avançar para a próxima página em alguma etapa. |
Algo nos seus cookies ou cache interrompe o processo. Limpe a memória do seu navegador para o domínio atlassian.com e tente novamente. |
Após a instalação bem-sucedida, os usuários do Jira que não estão registrados na Miro estão vendo o menu de login da Miro em vez do board anexado. |
As políticas do Jira bloqueiam algumas funcionalidades do plugin. Infelizmente, esse comportamento é causado pela atualização da API do Jira mais recente e não pode ser alterado no momento. |
O complemento não lembra da sua autorização e fica pedindo para você fazer login todas as vezes. Quando você tenta adicionar boards a um item do Jira, um seletor de board mostra o erro "Lamentamos, a integração está indisponível". |
Os cookies de terceiros estão bloqueados no seu navegador. Como solução, siga as instruções sobre como habilitar os cookies no seu navegador. Isso acontece principalmente com o Mozilla e o Safari devido às suas novas políticas de |