Se você tiver algum problema ao instalar ou usar o Jira Сards ou o Jira Add-on, este guia pode ajudar.
Sugestões para cartões do Jira
Mensagem / problema |
Possíveis causas e etapas para resolver o problema |
---|---|
conexão | |
Aplicável ao OAuth 1.0. (Jira Server e Data Center) somente. Erro de conexão do Jira ao tentar se conectar ao Miro com suas credenciais pessoais. Não é possível adicionar o pop-up cartões do Jira ao tentar usar o aplicativo cartões do Jira em um board |
O aplicativo cartões do Jira está instalado, mas seu Equipe 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 time admin de equipe, peça ao admin para fazê-lo. |
A solicitação ao Jira ... falhou: Ocorreu tempo limite / Host desconhecido / Conexão recusada |
O Jira só pode ser acessado na sua intranet (você está usando endereços IP errados para se comunicar com o sistema Jira). Certifique-se de permitir 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 Jira Server e em uma versão mais antiga, verifique novamente se nenhum recurso obscuro bloqueia o acesso do Miro. |
Aplicável ao OAuth 1.0. (Jira Server e Data Center) somente. O link do aplicativo no seu Jira não está configurado corretamente |
- Você perdeu algumas etapas na configuração do link ou webhook - Você instalou o Jira Addon em vez de configurar o link para os cartões do Jira. Tente instalar a integração do cartões do Jira do zero. Se você optar por criar o webhook manualmente, tente criá-lo automaticamente. |
Aplicável ao OAuth 1.0. (Jira Server e Data Center) somente. 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 Verifique se o link do aplicativo está configurado corretamente e tente conectar o Miro aos cartões do Jira novamente. Se você estiver usando um Jira altamente protegido ou um proxy, certifique-se de permitir 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 Jira Server e em uma versão mais antiga, verifique novamente se nenhum recurso obscuro bloqueia o acesso do Miro. |
Aplicável ao OAuth 1.0. (Jira Server e Data Center) somente. O link do seu aplicativo solicita mais valores do que apenas URL, chave do consumidor, nome do consumidor e chave pública |
Você está olhando para a aba Autenticação de Saída do menu de configuração. - Mude para a Autenticação de Entrada. A autenticação de saída não requer configuração. - Se não for possível pular a etapa, adicione quaisquer valores temporários. Você poderá removê-los mais tarde: quando estiver na página com a lista de links do seu aplicativo, clique no link Editar cartões Miro e remova os valores temporários. |
Aplicável ao OAuth 1.0. (Jira Server e Data Center) somente. URL do JIRA inválido
|
Seu Jira está em uma rede privada / o firewall da sua empresa bloqueia conexões de rede externas. Adicione nossos endereços IP (e portas) do Gateway NAT à sua lista de permissões. |
Você usa um proxy / Seus URLs externos e internos do Jira não correspondem. Certifique-se de preencher o campoURL do Jira com o endereço que podemos acessar, então configure um proxy reverso que nos permita acessar e/ousiga os passos deste guia da Atlassian. Com esta solução, a integração poderá conectar e encaminhar solicitações com sucesso entre o Jira e o Miro se suas URLs externas e internas forem diferentes. |
|
Há um problema com seu certificado SSL (certificados autoassinados não são suportados). Verifique o certificado SSL ativo no servidor Jira. Esta ferramenta pode ser útil: insira sua URL do Jira e veja os resultados da verificação de conexão. |
|
Seu Jira está sob SSO (também pode resultar no erro Autenticação de entrada não configurada corretamente ). Certifique-se de que seu processo de SSO não seja aplicado às solicitações de conexão da nossa integração. Para isso, os seguintes endpoints devem ser excluídos dos processos SSO : POST {JIRA_URL}/plugins/servlet/oauth/token-de-solicitação
POST {JIRA_URL}/plugins/servlet/oauth/access-token
OBTER {JIRA_URL}/rest/api/2/serverInfo
|
|
Comportamento inesperado durante a instalação |
Você usa o Jira versão 6.4 ou inferior. Nossos cartões não funcionarão com essas versões devido a esse bug do Jira. Atualize seu Jira para a versão mais recente. |
Falha na autorização do aplicativo. Tente autorizar o aplicativo novamente. |
Uma perda momentânea de conexão. Clique para conectar novamente. |
Aplicável ao OAuth 1.0. (Jira Server e Data Center) somente. Erro do Jira: "Você não tem permissão para criar o Webhook ' Miro'." |
Você não tem direitos de admin no Jira. Peça ao seu admin do Jira para fazer upgrade sua função para admin para que você possa configurar a integração. |
Falha na solicitação ao Jira: Falha na construção do caminho PKIX: não foi possível encontrar o caminho de certificação válido para o destino solicitado |
Há algum problema como certificado do seu servidor. |
Incapacidade de autorizar no Jira via Miro. |
Isso pode ocorrer devido à configuração incorreta da infraestrutura do Jira quando a configuração da infraestrutura indica suporte ao protocolo HTTP/2, mas nenhuma transferência de dados ocorre ao tentar usá-lo. Verifique suas configurações HTTP/2 nos arquivos de configuração do seu servidor web para garantir que estejam configuradas corretamente. Se necessário, desative temporariamente o suporte HTTP/2 na configuração do seu servidor para garantir compatibilidade com versões anteriores e serviço ininterrupto até que o problema seja resolvido. |
Trabalhando com cartões |
|
Os cartões do Jira não estão sendo atualizados
|
Aplicável ao OAuth 1.0. (Jira Server e Data Center) somente. Você está usando um webhook manual. Desative a integração e reconecte-a usando um webhook automático. Se tudo estiver funcionando bem com um webhook automático, significa que um manual foi configurado incorretamente. Consulte também Como configurar o WebHook para cartões do Jira. |
Aplicável ao OAuth 1.0. (Jira Server e Data Center) somente. Se você estiver usando um webhook automático: O primeiro passo da solução de problemas é reconectar a integração. Se isso não ajudar, pode haver vários motivos pelos quais os cartões do Jira não estão mais ativos: - uma board da Miro foi movida/baixada via backup para um time de outra - os itens do Jira que não eram 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 não atualizáveis não estão localizados em a mesma instância do Jira que você está usando atualmente em seu navegador |
|
Aplicável ao OAuth 1.0. (Jira Server e Data Center) somente. Os cartões Jira pararam de atualizar sem nenhuma alteração da sua parte e, ao tentar reconectar, o link do aplicativo no seu Jira não foi configurado corretamente. |
A mensagem de erro pode aparecer quando o Miro não consegue solicitar um Jira conectado devido a umerro de autorização. Isso pode acontecer se o usuário que configurou a integração revoga seu tokenou se o Jira estiver de alguma formaconfigurado com uma vida útil curta do token emitido, então ele simplesmente se torna inválido após esse tempo e tem que ser reconectado para obter um novo token de autorização válido com o qual o Miro acessa o Jira. |
A opção Editar cartão retorna uma janela em branco |
Aplicável ao OAuth 1.0. (Jira Server e Data Center) somente. Você usa o Jira ver. 7.6 e superior. Por motivos de segurança, a Atlassian pode não permitir que o conteúdo seja incorporado em iFrames, o que também pode afetar janelas pop-up para edição de seus cartões Jira. Você pode usar estas instruções como uma solução alternativa. |
Não é possível adicionar cartões do Jira |
Aplicável ao OAuth 1.0. (Jira Server e Data Center) somente. 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 do Miro. Não se esqueça de clicar em Conectar |
O ícone Editar não é exibido
|
Aplicável ao OAuth 1.0. (Jira Server e Data Center) somente. Você usa o servidor Jira versão 7.6 ou superior. O ícone de edição 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ê consegue acessar o modo de edição depois de abrir o problema no Jira. |
|
Você entendeu a mensagem: Você não está conectado e não tem as permissões necessárias para atuar no problema selecionado como convidado. Por favor faça o login |
Devido à maneira como nossa integração usa cookies, seu Jira pode não permitir que você faça login nesta página. Faça login no Jira em outra aba do navegador. |
Seu Jira está sob SSO e seu IDP não permite autenticação por meio de iframes. Se você estiver trabalhando no aplicativo de desktop Miro , recomendamos mudar para a versão de navegador Miro em miro.com. |
|
Nenhuma opção para converter/criar um cartão Jira no Miro quando você escolhe alguns Projetos específicos: - nenhum dado no campo Tipo de problema - o botão Converter/Criar está inativo |
Você não tem acesso ao Projeto no Jira. Verifique se você pode ter acesso concedido. |
item do Jira ao tentar converter/criar um novo cartão Jira: |
Você não tem permissão para criar itens do Jira. Entre em contato com seu admin do Jira e peça que ele lhe conceda a permissão necessária por parte do Jira. É assim que deve ficar: |
Alguns campos personalizados não são exibidos no menu Converter para problema do Jira/Editar problema do Jira Não é possível criar o item do Jira. Campos obrigatórios (...)não são suportadoserro ao criar um item do Jira no Miro |
Os campos não estão habilitados no seletor de cartões do Jira do board . Use nosso seletor Jira no aplicativo para configurar campos personalizados seguindo as etapas deste guia. |
Se a opção Selecionar campos para exibir nos 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 do Miro. Vá paraConfigurações do projeto > Telas > Esquema de tela padrão e verifique se os campos necessários são permitidos. |
|
O Miro não suporta campos de tipos de dados complexos. O Miro suporta campos personalizados básicos, mas não complexos. Configure os campos do cartão Jira e remova os campos que não são suportados. |
|
Você não pode escolher o Repórter ao editar/criar um cartão Jira |
Não há campo Reporter nos metadados do Create do Jira: o campo não está disponível natela do JiraCreatepara o projeto selecionado. Vá para Configurações do projeto > Telase verifique se o campo Repórter está presente na tela Criar . |
Você não tem a permissão necessária para definir o relator de problemas no projeto selecionado. Peça ao admin do Jira para verificar seus níveis de acesso e garantir que você tem permissão para definir/alterar o campo Relator no projeto selecionado. Para fazer isso, eles precisam fazer login no Jira > ir paraConfigurações>Problemas>Esquemas de permissão> e marcar o campoModificar repórter(adicione oacesso ao aplicativo: Qualquer usuário logado,caso você não o tenha na lista): |
|
O campo do repórter não é editável para trilha de auditoria e é definido para quem criou o problema. 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 |
O Miro não recebe atualizações do Jira.
|
Aplicável ao OAuth 1.0. (Jira Server e Data Center) somente. Erro Jira indisponível nas configurações do aplicativo 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 acessado pelo Miro. Se ao mesmo tempo os cartões do Jira forem sincronizados entre o Miro e o Jira, isso significa que seu Jira pode nos enviar webhooks. É por isso que você pode ver as atualizações em seus boards.
Se você estiver no Jira Server e em uma versão mais antiga, verifique novamente se nenhum recurso obscuro bloqueia o acesso do Miro. |
Aplicável ao OAuth 1.0. (Jira Server e Data Center) somente. O webhook do Jira emite um erro nas configurações do aplicativo cartões do Jira |
- Você alterou/excluiu um webhook no lado do Jira
Como um solução, sugerimos que você desabilite a integração e reconecte- o 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 maiores ou boards com imagens maiores ou documentos PDF. Aguarde pelo menos 10 segundos após abrir a board e deixe - a carregar completamente. Em seguida, tente colar o link novamente. |
A descrição não é visível nos cartões do Jira no board |
Para ver os detalhes do cartão, clique no cartão e escolhaexpandir para ver os detalhes 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 estão fechados/concluídos). 2. Seu O filtro no Jira não inclui nenhum projeto. Adicione um projeto necessário ao JQL para o filtro do board - assim, os sprints aparecerão, tanto no Jira quanto no Miro. |
Aplicável ao OAuth 1.0. (Jira Server e Data Center) somente. A conexão SSL com ... falhou |
O erro significa que o Miro não tem acesso ao seu Jira. |
Nenhum usuário é exibido no campo "Atribuído" do cartão Jira no Miro |
Certifique-se de ter a permissão "Navegar pelos usuários" definida em nível global no Jira. Saiba mais sobre como gerenciar permissões globais. |
Sugestões para o complemento 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 atuar no problema selecionado como convidado. Por favor faça o login |
Infelizmente, como nosso plugin usa cookies, o Jira não permitirá que você faça login nesta página. Faça login no Jira em outra aba do navegador. |
Após clicar no botão Instalar na página do complemento, você poderá ver o seguinte erro: |
Uma perda momentânea de conexão. Nesse caso, basta tentar instalar novamente um minuto depois. |
Durante ou após a configuração do Jira Addon, você não consegue prosseguir 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ãoestão registrados no Miro verão o menu de login do Miro em vez do board anexado. |
As políticas do Jira bloqueiam algumas funcionalidades do plugin. Infelizmente, esse comportamento é causado pela atualização mais recente da API do Jira e não pode ser corrigido no momento. |
O Addon não lembra da sua autorização e continua pedindo para você efetuar login todas as vezes. Quando você tenta adicionar boards a um item do Jira, um seletor de board mostra o erro "Desculpe, a integração não está disponível". |
Os cookies de terceiros sã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 segurança. |