Aplica-se a
- Business
- Enterprise
Recursos
Quem pode usar esse recurso?
Para criar ou editar um fluxo de trabalho, as seguintes permissões são necessárias:
- Você deve ser um usuário licenciado no ambiente do Smartsheet. É preciso ter permissões de editor ou superior em qualquer planilha mapeada no fluxo de trabalho.
- Você deve ter uma conta funcional do Jira com direitos de acesso adequados aos projetos do Jira para os quais deseja criar um fluxo de trabalho.
- O administrador de sistema deve habilitar a configuração Restringir usuários do Conector do Jira e atribuir a você a função de usuário do Conector Jira do Smartsheet. Essa função pode ser atribuída no Centro de administração do Smartsheet ou diretamente na interface do conector Jira.
Melhores práticas e solução de problemas do conector Jira do Smartsheet.
O Conector do Jira do Smartsheet está disponível como uma oferta premium. Se o Conector do Jira do Smartsheet estiver incluído no plano que você adquiriu, faça login para criar fluxos de trabalho entre o Smartsheet e o Jira.
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ções: acesse esta página para ver a quantidade de erros de sincronização de um fluxo de trabalho e a mensagem de erro com os detalhes do problema.
- Relatório 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 erro receberá um e-mail.
- Coluna Erro: marque esta coluna na planilha para ver uma mensagem sobre linhas com problema de sincronização.
Run history
Depois de criar um fluxo de trabalho, acesse a página Run history para conferir o histórico de execuções e qualquer erro que ocorreu. Você pode acessar o histórico de execução selecionando o carimbo de data/hora para o seu fluxo de trabalho.
Você verá os seguintes tipos de execução no histórico de execução:
- Sync to Smartsheet: o fluxo de trabalho é executado para alterações do Jira que foram sincronizadas com o Smartsheet
- Sync to Jira: o fluxo de trabalho é executado para alterações do Smartsheet que foram sincronizadas com o Jira
- Filtered Row Finder: o fluxo de trabalho é executado para alterações feitas em qualquer problema que deva ser filtrado com base na sua configuração de fluxo de trabalho. O Filtered Row Finder é um processo de segundo plano que é executado a cada 2 horas. Os problemas filtrados serão adicionados à hierarquia Filtered Out by Connector—Not Synced . O processo do Filtered Row Finder será executado apenas com tipos de fluxo de trabalho automatizados. Esse processo será executado mesmo se você não houver especificado filtros em seu fluxo de trabalho.
Melhores práticas
Salvar e atualizar com frequência
Para minimizar os erros de sincronização à medida que os usuários trabalham em ambos os sistemas, salve as alterações e atualize as planilhas sempre que fizer alguma atualização. Salvar e atualizar com frequência garantirá que outras pessoas vejam suas alterações. Saiba mais sobre como salvar e atualizar planilhas do Smartsheet.
Bloquear colunas para evitar erros
Não modifique os dados no campo obrigatório Issue Key no Smartsheet. Para proteger a integridade dos dados nesta coluna, o proprietário da planilha, ou alguém com quem ela tenha sido compartilhada que tenha privilégios de administrador, deverá bloquear a coluna Issue Key. Para obter mais informações, confira Como bloquear e desbloquear colunas e linhas na Central de ajuda do Smartsheet.
Exibir alterações
Use o recurso de exibir histórico do Smartsheet para ver um registro das alterações feitas em uma célula. Para planilhas que incluem dados compartilhados entre o Smartsheet e o Jira, o nome do usuário associado à alteração será o nome da pessoa que criou o fluxo de trabalho. Isso pode ajudar a identificar o fluxo de trabalho de um usuário específico, caso alterações inesperadas estejam sendo feitas em sua planilha.
Para saber mais sobre como rastrear alterações no Smartsheet, confira Exibição do histórico de células na Central de ajuda.
Verifique as permissões da planilha em colunas que não deveriam estar em branco
Se uma coluna aparecer vazia em uma planilha que você mapeou em seu fluxo de trabalho, é possível que a coluna esteja bloqueada. Peça ao proprietário da planilha (ou outro administrador) que conceda permissões de administrador para você na planilha.
Enviar dados do Smartsheet para o Jira apenas para linhas específicas
Para oferecer maior controle sobre quais linhas enviarão explicitamente dados de volta ao Jira, você pode criar uma coluna Atualizar problema no Jira na planilha e um filtro de planilha no fluxo de trabalho do Conector do Jira do Smartsheet para sincronizar apenas essas linhas com a coluna Atualizar problema no Jira verificada.
Webhooks do Jira
Em 15 de novembro de 2023, atualizamos o esquema de webhook do Conector do Jira do Smartsheet para aumentar a eficiência. Agora, todos os fluxos de trabalho bidirecionais criados após essa data terão um sistema de webhook compartilhado. Esse aprimoramento estratégico foi projetado para se alinhar à alteração do limite do Atlassian Jira Cloud de julho de 2024 para 100 webhooks do Jira por ambiente do Jira, que introduziu um limite de 100 webhooks do Jira por ambiente do Jira Cloud. A vantagem? Agora você tem o que é preciso para estabelecer quantos fluxos de trabalho forem necessários, contornando as restrições de webhook do Jira.
Antes de julho de 2024, e para garantir que o novo sistema esteja ativado, você deve converter pelo menos um fluxo de trabalho para o novo esquema de webhook.
Para converter um fluxo de trabalho existente no novo sistema, o proprietário do fluxo de trabalho deve:
- Desabilitar fluxos de trabalho.
- Atualizar a página.
Selecione o botão Redefinir para reabilitar o fluxo de trabalho.
Essa ação deve ser executada pelo proprietário do fluxo de trabalho, pois qualquer usuário do Jira pode desabilitar um fluxo de trabalho, mas apenas o proprietário pode reabilitar.
Consolidar fluxos de trabalho automatizados quando possível
As melhores práticas da Atlassian para webhooks sugerem ter o menor número possível de webhooks. Uma maneira de consolidar fluxos de trabalho é usar um filtro mais geral no fluxo de trabalho e usar a planilha conectada como um local de teste para seus dados. Em seguida, você pode usar o DataMesh para filtrar e enviar dados entre planilhas.
Se você tiver muitos fluxos de trabalho e estiver com lentidão no Jira, acesse o guia de solução de problemas de webhook da Atlassian para encontrar formas como o administrador do Jira pode diagnosticar quais webhooks podem estar causando a lentidão.
Habilitar o processamento assíncrono de webhook
Por padrão, o Jira Server e o DataCenter processam esses webhooks individualmente após cada alteração em um problema.
O JIRA tem um recurso não oficial que diz ao Jira para processar webhooks de forma assíncrona, tornando a interface do usuário mais responsiva após as alterações. Para habilitar essa alteração, é preciso ser um usuário com permissão de administrador do Jira.
De acordo com este ticket do Jira, você pode habilitar o recurso ao:
- Habilitar manualmente o sinalizador de recurso com.atlassian.jira.webhookEventsAsyncProcessing com as seguintes instruções.
- Reiniciar sua instância do Jira (ou cada nó no caso de DC)
As seguintes versões do Jira Server e DataCenter podem habilitar esse recurso:
- 8.13.25, 8.20.12 ou posterior
- 9.2.0 ou posterior
Limitações do conector
- O conector Jira do Smartsheet tem uma capacidade máxima de 20 mil linhas, o que está de acordo com o limite de linhas do Smartsheet.
- Limite a extração de dados a dez projetos ao mesmo tempo para garantir um desempenho melhor.
- Evite mapear para a coluna "Data de término" se as dependências estiverem habilitadas.
- O conector reclassificará a planilha cada vez que ela for executada; use relatórios para classificação personalizada.
- A reclassificação manual das tarefas do Jira pode causar erros; em vez disso, use o agrupamento personalizado.
- Atribua tarefas aos sprints do Jira, não ao Smartsheet, devido a restrições de conexão unidirecional.
- O complemento de portfólio do Jira, que introduz o tipo de problema de iniciativa, não é compatível.
- As colunas de configurações de projeto específicas, de ID exclusivo e gerada pelo sistema podem causar complicações (unidirecional ou sem mapeamento) ao mapear o conector.
- Verifique se você tem acesso de administrador ou editor em ambas as plataformas para evitar erros relacionados a permissões nas atualizações do fluxo de trabalho.
Relatórios de erro
À 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 está como o esperado
Ao executar um fluxo de trabalho automatizado, os problemas são classificados por Chave de problema ascendente, mesmo que sejam classificados de forma diferente no Jira. Para classificar os problemas sincronizados com um fluxo de trabalho automático, utilize o Row Grouping.
Para fluxos de trabalho manuais, o processo do 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))
Error: Field '<field name>' cannot be set. Ele não está na tela apropriada ou é desconhecido.
Este erro será exibido se o valor do campo que você deseja definir não estiver na tela Edit do Jira. Somente os campos na tela Edit do Jira são editáveis no Conector do Jira do Smartsheet.
Para resolver esse problema, siga um desses procedimentos:
- Configure a tela Edit no Jira e adicione o campo especificado à tela. Para obter mais informações sobre as telas do Jira, incluindo as etapas para alterar a configuração, confira Definindo uma tela na documentação do Jira.
-ou- - Mapeie o campo especificado apenas em uma direção, do Jira para o Smartsheet. Isso criará um mapa unidirecional. Eventuais revisões feitas nos campos do Smartsheet não serão propagadas para o Jira.
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, pois cada linha pode conter dados, anexos ou comentários importantes da coluna.
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 Filtradas pelo conector - não sincronizadas na parte superior a fim de manter as informações que o conector filtra. As linhas filtradas não serão sincronizadas até que atendam aos critérios de filtragem novamente 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 contém a coluna Erro de sincronização. Ela é obrigatória. Você pode editar o fluxo de trabalho para remapear a coluna Erro de sincronização 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 do Jira do Smartsheet) tiverem sido impedidos de exibir endereços de e-mail. Uma configuração por usuário pode ser modificada acessando Profile > Manage your account > Profile and visibility e modificando a configuração Who can see this? para o campo Contact, na parte inferior. Se o campo estiver definido como Only you and the admins, 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.
Limite de webhook excedido
Se você recebeu essa mensagem, isso significa que está usando mais de 100 webhooks em seu ambiente Jira. Como a Atlassian impõe um limite de 100 webhooks por instância do Jira Cloud, você deve tomar as seguintes ações para reduzir sua contagem de webhooks abaixo de 100.
- Identifique quantos fluxos de trabalho bidirecionais você está usando,
- Desabilite fluxos de trabalho bidirecionais suficientes para ficar abaixo da contagem de 100 webhooks (ou seja, será necessário ter no mínimo menos de 100 fluxos de trabalho bidirecionais).
- Depois que os fluxos de trabalho bidirecionais forem desabilitados por um administrador ou pelo proprietário do fluxo de trabalho, você poderá converter os fluxos de trabalho existentes para o novo sistema.
- Peça ao proprietário do fluxo de trabalho que atualize a página e selecione o botão Redefinir para reabilitar o fluxo de trabalho. Depois de confirmar que o fluxo de trabalho foi redefinido com sucesso, continue o processo para os fluxos de trabalho do Jira bidirecionais desabilitados restantes.
Essa ação deve ser executada pelo proprietário do fluxo de trabalho, pois qualquer usuário do Jira pode desabilitar um fluxo de trabalho, mas apenas o proprietário pode reabilitar.