O conector Jira do Smartsheet está disponível como uma oferta premium. Se você adquiriu o Conector Jira do Smartsheet em seu plano, faça login para criar fluxos de trabalho entre o Smartsheet e o Jira.
USM Content
Encontrar e corrigir erros de sincronização
É possível usar os seguintes recursos para encontrar e solucionar erros do fluxo de trabalho:
- Histórico de execução: acesse esta página para ver uma contagem de erros de sincronização para um fluxo de trabalho, juntamente com a mensagem de erro e os detalhes do problema.
- Relatórios de erros: quando ocorrem problemas, o proprietário do fluxo de trabalho e a pessoa que editou o campo ou a linha do fluxo de trabalho que causou o problema recebem um e-mail.
- Coluna de erro: verifique esta coluna em sua planilha para revisar uma mensagem sobre linhas com um problema de sincronização.
Histórico de execuções
Depois de criar um fluxo de trabalho, você pode acessar a página Histórico de execução para visualizar o histórico de sincronização e quaisquer erros que tenham ocorrido. Você pode acessar o Histórico de execução selecionando o carimbo de data e hora do fluxo de trabalho em Última execução.
Existem os seguintes tipos de execução em seu Histórico de execução:
- Sincronizar com o Smartsheet: o fluxo de trabalho é executado para alterações do Jira que foram sincronizadas com o Smartsheet.
- Sincronizar com o Jira: o fluxo de trabalho é executado para alterações do Smartsheet que foram sincronizadas com o Jira.
- Localizador de linhas filtradas: o fluxo de trabalho é executado para alterações em quaisquer itens que devem ser filtrados de acordo com a configuração do fluxo de trabalho. O localizador de linhas filtradas é um processo em segundo plano executado a cada 2 horas. Os itens filtrados são adicionados à hierarquia Filtrado pelo conector — Não sincronizado da sua planilha. O processo do localizador de linhas filtradas só é executado com tipos de fluxo de trabalho automatizados. Esse processo é executado mesmo que você não tenha especificado filtros no fluxo de trabalho.
Erros comuns
À medida que os problemas ocorrem, o proprietário do fluxo de trabalho e a pessoa que editou o problema/linha no fluxo de trabalho que causou o problema recebem relatórios de erro por e-mail. Confira alguns erros e problemas comuns.
Campo [Grupo] não definido
Assunto | Detalhes |
|---|---|
Detalhes | Os itens sem valor de agrupamento definido no Jira aparecem em uma hierarquia chamada grupo de campos não definido |
Solução de problemas | Atribuir um valor de agrupamento aos itens no Jira |
Filtrado por conector - Não sincronizado
Assunto | Detalhes |
|---|---|
Detalhes | Isso ocorre com o conector do Salesforce e do Jira. A linha Filtrado por conector - Não sincronizado não adiciona linhas com problemas de sincronização; mostra apenas itens excluídos no Jira ou linhas que não atendem mais aos critérios do filtro do Jira e não estão sincronizando com o Jira. |
Solução de problemas |
|
O campo não pode ser definido. Ele não está na tela apropriada ou é desconhecido.
Assunto | Detalhes |
|---|---|
Detalhes | Este erro será exibido se o valor do campo que você deseja definir não estiver na tela de edição do Jira. Somente os campos na tela de edição do Jira são editáveis no conector Jira do Smartsheet. |
Solução de problemas |
|
Falha ao configurar as notificações
Assunto | Detalhes |
|---|---|
Detalhes | O Conector do Jira não pode receber notificações de alteração do Jira via Webhook. Quando isso acontece, o Conector não consegue detectar atualizações no Jira e sincronizá-las com o Smartsheet. |
Solução de problemas | Verifique o registro do Webhook no Jira:
Verifique as permissões de administrador do sistema do Jira:
Reautentique o Conector:
Verifique se há firewall ou restrições de rede do Jira (somente Jira auto-hospedado):
Verifique se nenhuma atualização do aplicativo Jira interrompeu o Webhook:
|
Se o problema persistir após as etapas acima, entre em contato com o suporte da Smartsheet e forneça um arquivo WEX (Informações de suporte à execução do fluxo de trabalho) para ajudar a agilizar a resolução. Consulte Gerar um arquivo WEX para suporte abaixo.
Gerar um arquivo WEX para o suporte
Se você trabalhou nas etapas de solução de problemas acima e ainda precisa de ajuda, gerar um arquivo WEX (Informações de suporte à execução do fluxo de trabalho) antes de entrar em contato com o suporte ajuda a equipe a diagnosticar seu problema mais rapidamente e a reduzir as idas e vindas.
O arquivo WEX contém informações detalhadas sobre seu fluxo de trabalho, incluindo mapeamentos de campo, direção de sincronização e configurações de filtro. Ele não contém seus dados do Smartsheet ou do Jira.
Qualquer administrador de sistema ou administrador do Smartsheet pode gerar um arquivo WEX usando estas etapas:
- Faça login em https://connectors.smartsheet.com/c/jira.
- No painel do Conector do Jira, selecione o carimbo de data e hora na coluna Data de execução do fluxo de trabalho afetado. Isso abre o histórico de execução do fluxo de trabalho.
- Selecione o carimbo de data e hora em Última execução para a execução mais recente.
- Na página seguinte, abra o menu de hambúrguer (três linhas horizontais no canto superior esquerdo) e selecione Baixar informações de suporte à execução do fluxo de trabalho.
Anexe este arquivo ao enviar seu tíquete de suporte ou ao compartilhá-lo com o suporte da Smartsheet.
O arquivo WEX está no formato JSON. O suporte faz a análise do lado deles — você não precisa interpretá-lo sozinho.
Perguntas frequentes
À medida que os problemas ocorrem, os relatórios de erros são enviados por e-mail ao proprietário do fluxo de trabalho e à pessoa que editou o problema/a linha no fluxo de trabalho que causou o problema. Confira alguns erros e problemas comuns.
Problema: a ordem da linha não é a esperada
Ao executar um fluxo de trabalho automatizado, os itens são classificados por chave de problema ascendente, mesmo que sejam classificados de forma diferente no Jira. Para classificar itens sincronizados com um fluxo de trabalho automático, utilize Agrupamento de linhas.
Para fluxos de trabalho manuais, o processo Filtered Row Finder não é executado. Nesse caso, você poderá classificar manualmente as linhas na planilha.
Para classificar os problemas manualmente enquanto ainda estiver usando um fluxo de trabalho automatizado, siga estas etapas:
- Sincronize o Jira com uma planilha diferente.
- Use uma fórmula de índice/correspondência entre planilhas ou de vlookup para trazer os valores para sua planilha principal usando a chave de problema. Exemplo de fórmula: =INDEX({Range that contains value to return}, MATCH([Search Value]@row, {Range that contains search value}, 0))
Não foi possível salvar o problema no Jira
Você precisa ter permissões de gravação nos projetos Jira conectados para salvar dados nele.
Os dados não são removidos de uma planilha após a atualização do filtro
O Smartsheet não excluirá os dados extraídos do Jira porque cada linha pode conter dados importantes da coluna, anexos ou comentários.
Quando os problemas do Jira na sua planilha não atenderem mais aos critérios de filtragem do fluxo de trabalho, o Smartsheet criará uma seção Filtered out by Connector—not synced (Filtrado pelo conector—Não sincronizado) na parte superior, para manter as informações que o conector filtra. As linhas filtradas não serão sincronizadas até que atendam novamente aos critérios de filtragem e elas poderão ser excluídas se a sua equipe não precisar mais delas na planilha.
Erro ao atualizar a coluna de erro no Smartsheet
Você verá um erro se remover a coluna Erro de sincronização da planilha conectada. Certifique-se de que a planilha contenha a coluna, pois ela é obrigatória. Você pode editar o fluxo de trabalho para remapear a coluna para a planilha. Veja como modificar o fluxo de trabalho para saber mais.
Coluna de erro
Essa coluna é automaticamente adicionada à sua planilha pelo conector e exibirá detalhes sobre quaisquer problemas de sincronização que ocorram na linha.
…não é um usuário válido para o projeto JIRA fornecido
Essa mensagem pode ocorrer quando um e-mail inválido é inserido em um campo Smartsheet sincronizado com o JIRA e pode causar problemas com a sincronização de contatos.
Além disso, no Jira Cloud, esse erro pode ocorrer se o usuário não estiver atribuído ao projeto no Jira ou se, no Jira, serviços externos (como o conector Jira do Smartsheet) tiverem sido impedidos de visualizar endereços de e-mail. Uma configuração por usuário pode ser modificada acessando Perfil > Gerenciar sua conta > Perfil e visibilidade e modificando Quem pode ver isso? configuração para o campo Contato na parte inferior. Se estiver definido como Somente você e os administradores, o conector Jira não poderá acessar as informações de endereço de e-mail do usuário com essa configuração e não preencherá o campo de e-mail.
Quando tento acessar o conector Jira, ele diz que não estou autorizado a executar esta ação. O que devo fazer?
É possível que você ainda não tenha as permissões necessárias para acessar o conector Jira. Entre em contato com o administrador de sistema do Smartsheet para obter ajuda.
Saiba como entrar em contato com o administrador de sistema.