Módulo de aprendizado
O Artigo de ajuda aparece no Integrações e complementosMódulo de aprendizado. Tire o máximo proveito deste módulo de aprendizado começando no início.
O Artigo de ajuda aparece no Integrações e complementosMódulo de aprendizado. Tire o máximo proveito deste módulo de aprendizado começando no início.
Use o Conector Smartsheet para Jira a fim de criar fluxos de trabalho para sincronizar informações entre o Smartsheet e uma ou mais instâncias do Jira.O Conector pode ajudar a automatizar e otimizar uma ampla variedade de processos de negócios, incluindo colaboração entre desenvolvedores de produtos e software, emissão de bilhetes e gerenciamento de casos de TI, e roll-up de projetos e relatórios executivos para equipes técnicas e não técnicas.
Este artigo fornece instruções sobre como configurar o Conector Smartsheet para Jira com o Servidor Jira Cloud e o Servidor Jira Auto-Hospedado.
O Conector Smartsheet para Jira está disponível para compra como uma oferta premium. Para obter mais informações sobre seus recursos e benefícios, confira Unificar suas equipes com o Conector Smartsheet para Jira. Para obter informações sobre preços e compras, entre em contato com a nossa equipe de vendas. |
Se você deseja configurar o Conector com um servidor Jira auto-hospedado e tem um firewall, confira o artigo Requisitos de Firewall do Conector Jira, que explica os requisitos do servidor e do firewall que precisarão estar em vigor antes da configuração de uma conexão.
Neste artigo:
Faça login no Conector do Smartsheet para Jira
Antes de começar: requisitos
Configurar uma conexão entre o Jira e o Smartsheet
Configurar o host do Jira para uso com o Smartsheet
Gerenciar o acesso à integração
Você criará fluxos de trabalho no Conector do Smartsheet para Jira a fim de controlar a sincronização automática dos dados entre os dois sistemas. Antes de fazer isso, você precisará comprar e configurar o Conector.Para obter informações sobre preços e compras, entre em contato com a nossa equipe de vendas.
Os usuários da nuvem devem estar cientes das recentes alterações de privacidade feitas pela Atlassian. Confira Smartsheet para Jira: alterações importantes na privacidade do Jira Cloud para obter mais informações.
Para configurar o Conector do Smartsheet para Jira, você deve ser um administrador no aplicativo Jira. Você também precisa ter uma das seguintes funções:
Para garantir uma configuração bem-sucedida, eis o que será necessário:
Depois de comprar o Conector Smartsheet para Jira, você usará a seguinte URL para fazer login e configurar o Conector: https://connectors.smartsheet.com/c/jira
IMPORTANTE: Se você deseja configurar o Conector com um servidor Jira auto-hospedado e tem um firewall, confira o artigo Requisitos de Firewall do Conector Jira, que explica os requisitos do servidor e do firewall que precisarão estar em vigor antes da configuração de uma conexão.
Para registrar uma instância do Jira para uso no Smartsheet, você deve ter permissões no nível de administrador para as instâncias do Smartsheet e do Jira às quais deseja criar uma conexão.
Para registrar uma instância do Jira com o Conector:
Selecione Registrar novo servidor Jira.
No formulário exibido, digite a URL do host do Jira que deseja usar.
Aceite ou modifique o nome padrão, selecione sua versão do Jira e clique em Continuar.
Você poderá registrar várias instâncias do Jira com o Conector simultaneamente. Repita as instruções acima para cada instância adicional do Jira que quiser registrar.
O Conector Smartsheet para Jira fornecerá as chaves Pública e de Consumidor que você usará no Jira para estabelecer uma conexão segura entre os dois serviços. Siga as etapas da próxima seção - Configurar o host do Jira para Uso com o Smartsheet - para concluir a configuração.
É recomendável usar uma conta de serviço genérica no Smartsheet e no Jira (exemplo: smartsheet-jira@yourdomain.com) para configurar a conexão com o Jira. Os proprietários da conexão não podem ser alterados. Portanto, o uso de uma conta genérica ajudará a evitar a necessidade de reconstruir conexões ou fluxos de trabalho se a pessoa que gerencia a conexão com o Jira deixar sua organização, por exemplo.
Para habilitar uma conexão entre o Jira e o Smartsheet, você estabelecerá e configurará um Link de aplicativo (também conhecido como AppLink na documentação do Jira) entre os dois sistemas.
IMPORTANTE: Se você deseja configurar o Conector com um servidor Jira auto-hospedado e tem um firewall, confira o artigo Requisitos de Firewall do Conector Jira, que explica os requisitos do servidor e do firewall que precisarão estar em vigor antes da configuração de uma conexão.
Para gerar um AppLink no aplicativo do Jira:
Você receberá uma mensagem informando que o Link de aplicativo foi criado com sucesso. Siga as etapas da próxima seção para configurar o Link de aplicativo.
Você precisará ter as chaves Pública e de Consumidor do Conector Smartsheet para Jira em mãos para concluir essas etapas. (Para obtê-los, siga as etapas acima em Configurar a conexão entre o Jira e o Smartsheet.)
Para obter mais informações sobre os Links de aplicativos no Jira, confira a documentação do Jira:
Para obter informações sobre isso | Confira o seguinte |
---|---|
Artigo oficial de suporte da Atlassian que explica como os AppLinks funcionam e o processo de criação de AppLinks no Jira. | Uso do AppLinks para vincular a outros aplicativos - |
Documentação adicional fornecida pela Atlassian, relacionada a conexões, diagnósticos, solução de problemas e segurança com os Links de aplicativos. | Documentação dos Links de aplicativos |
O que você pode fazer no Conector depende de quais restrições foram ativadas, bem como das permissões que você possui sobre os itens tanto no Smartsheet (permissões de compartilhamento de planilhas) quanto no Jira (permissões de leitura/gravação no campo do problema).
O Conector respeita as permissões concedidas a você nos aplicativos Jira e Smartsheet. Como resultado, o Conector poderá ler, gravar, atualizar e excluir dados de acordo com as permissões concedidas a cada indivíduo em ambos os aplicativos.
Por exemplo, se a pessoa que criou um fluxo de trabalho no Conector não tiver permissão para editar dados específicos do projeto no aplicativo Jira, o fluxo de trabalho que criado por ela não poderá editar os dados desse projeto por meio do Conector.
Perguntas frequentes: Quais dados do Jira o Smartsheet acessa com o Conector Jira?
Os administradores do sistema Smartsheet e os administradores do Conector podem controlar quem tem acesso ao Conector. Um Administrador de sistema do Smartsheet deve habilitar uma configuração para restringir o acesso ao Conector, de modo que somente determinados usuários possam criar e editar seus próprios fluxos de trabalho.
DICA: Os usuários do Conector poderão modificar os dados do Smartsheet e do Jira por meio dos fluxos de trabalho do Conector criados por eles. Por esse motivo, os Administradores de sistema e Administradores do Conector podem querer limitar o acesso apenas às pessoas da organização com sólidos conhecimentos de trabalho sobre os aplicativos do Smartsheet e do Jira.
Eis as etapas para um administrador de sistema do Smartsheet restringir o acesso ao Conector:
NOTA: Depois de ativar a configuração para restringir usuários, você poderá conceder aos usuários acesso ao Conector Jira dentro do formulário de Gerenciamento de usuários do Smartsheet. Uma permissão em nível de usuário chamada Usuário do Conector Jira ficará visível para os Administradores de sistema do Smartsheet, que terão a capacidade de conceder aos usuários acesso ao Conector diretamente do Smartsheet.
Os administradores de sistema do Smartsheet e os administradores do Conector também podem remover os usuários do Conector clicando no ícone excluir , à direita das informações de conta dessa pessoa.
Todos os usuários removidos da lista não poderão mais criar ou editar seus próprios fluxos de trabalho.
NOTA: Se alguém que foi removido da lista de acesso tiver criado fluxos de trabalho anteriormente, seus fluxos de trabalho ainda permanecerão ativos por até 10 minutos. Após esse período, eles serão desativados automaticamente.
Se você for um Administrador de sistema do Smartsheet, também poderá gerenciar os Administradores do Conector Jira e os Usuários do Conector Jira no aplicativo do Smartsheet. Para obter mais informações sobre o gerenciamento de usuários no aplicativo do Smartsheet, confira o artigo Gerenciamento de usuários.
Perguntas frequentes: Vocês salvam minha senha do Jira?
Existem três tipos de usuários que podem interagir com o Conector Smartsheet para Jira:
A tabela a seguir descreve o nível de interação com o Conector Smartsheet para Jira, dependendo do tipo de usuário.
Administrador de sistema do Smartsheet | Admin do Jira | Usuário do Jira | |
---|---|---|---|
Criar fluxos de trabalho no Conector | Sim* | Sim* | Sim |
Editar seus próprios fluxos de trabalho | Sim* | Sim* | Sim |
Desativar seus próprios fluxos de trabalho | Sim* | Sim* | Sim |
Visualizar os fluxos de trabalho de todos | Sim | Sim | Não |
Desativar os fluxos de trabalho de todos | Sim | Sim | Não |
Ativar ou executar os fluxos de trabalho de qualquer outra pessoa | Não | Não | Não |
Visibilidade sobre os projetos e as planilhas do Jira usados nos fluxos de trabalho de todos | Sim | Sim | Não |
Exibir e configurar servidores Jira no Conector | Sim | Sim | |
Tornar alguém um usuário do Jira | Sim | Sim | Não |
Tornar alguém um Admin do Jira | Sim | Não | Não |
Tornar alguém um Administrador de sistema do Smartsheet | Sim | Não | Não |
Habilitar a configuração de Restrição de acesso | Sim | Não | Não |
Adicionar pessoas à lista de Restrição de acesso (depois que as restrições forem ativadas) | Sim | Sim | Não |
*Administradores de sistema do Smartsheet e Administradores do Conector podem criar e editar seus próprios fluxos de trabalho se o recurso restringir lista de acesso estiver desativado. Se a lista de restrição de acesso estiver ativada, eles deverão ter a função de Usuário do Conector. Confira Gerenciar quem pode acessar o Conector para obter mais informações sobre a lista de restrição de acesso.
O Smartsheet utiliza uma tecnologia conhecida como webhooks, que permite que o Conector receba notificações do Jira sobre Problemas que estão sendo criados ou atualizados no Jira e permite a implementação de fluxos de trabalho automáticos. O modelo de permissão do Jira (confira o artigo de suporte do Jira nos webhooks) determina que o aplicativo (neste caso, o Smartsheet) deve ter credenciais de Administrador de sistema do Jira a fim de criar ou configurar um webhook com a API REST do Jira. É importante observar o seguinte:
A conta de Administrador de Sistema do Jira usada para configurar a integração inicialmente, deve permanecer como uma conta ativa e também como Administrador de Sistema do Jira, de modo que, como os colaboradores podem continuar a criar fluxos de trabalho, os webhooks podem ser criados.
NOTA: Se o Administrador de sistema for removido do Smartsheet, será retornado um erro informando o seguinte:“Ausência de credenciais de usuário neste endpoint”. Quando o mesmo usuário recuperar sua permissão de Administrador de Sistema do Smartsheet, a conexão será restaurada e todos os fluxos de trabalho começarão a ser sincronizados conforme o esperado. Se as credenciais de administrador forem removidas do lado do Jira, o link de aplicativo precisará ser reconstruído porque o token será alterado.
O Smartsheet recupera apenas os dados especificados por um fluxo de trabalho criado por alguém. Um criador de fluxo de trabalho especifica quais dados sincronizar mapeando os campos associados dos Projetos do Jira para planilhas e colunas no Smartsheet e escolhendo campos específicos para filtrar.
O Smartsheet recupera certos tipos de metadados, como a lista de todos os campos no projeto do Jira que foram selecionados no momento em que o fluxo de trabalho foi criado. Isso permite que as pessoas que têm acesso ao Conector Jira e àquele projeto mapeiem qualquer um dos campos desejados disponíveis. Outros metadados incluem, entre outros, uma lista de usuários disponíveis no projeto do Jira especificado, pois isso permite atribuir um problema no Jira a partir de dentro do aplicativo do Smartsheet.
NOTA: Toda a recuperação de metadados e dados será feita usando as credenciais OAuth do usuário do Jira - não as credenciais do Administrador de sistema. Isso garante que as permissões do Jira de alguém sejam aplicadas ao selecionar projetos e campos, além de tentar recuperar ou editar dados do Jira no Smartsheet.
Todas as “credenciais” são recuperadas por meio do protocolo OAuth padronizado e o Smartsheet nunca tem acesso a nenhuma senha de usuário do Jira.
Agora que você configurou o Conector Smartsheet para Jira, confira o nosso artigo sobre a Criação e edição de fluxos de trabalho para obter detalhes sobre o processo de sincronização entre os dois sistemas.