Administração e configuração do conector Jira do Smartsheet

O conector Jira do Smartsheet é um complemento premium. Entre em contato com a equipe de vendas do Smartsheet para saber os preços.

O conector Jira do Smartsheet sincroniza dados entre o Smartsheet e uma ou mais instâncias do Jira. Use-o para criar fluxos de trabalho que vinculam problemas do Jira a linhas, colunas e células no Smartsheet.

Se o conector Jira já estiver no seu plano, entre no conector Jira do Smartsheet para começar.

Entrar no conector Jira do Smartsheet

Terminologia e tipos de permissão

Dois termos definem como o conector Jira é estruturado:

• Conexão: o link entre o Smartsheet e uma instância específica do Jira.
• Fluxo de trabalho: o link dentro do conector Jira que conecta elementos do Jira a uma planilha do Smartsheet.

Três tipos de permissão controlam o acesso ao conector Jira:

• Administrador de sistema do Smartsheet: gerencia os administradores do conector Jira e os usuários do conector Jira dentro do Smartsheet. Os administradores de sistema também podem habilitar uma configuração para restringir o acesso ao conector.
• Administrador do conector Jira: estabelece a conexão entre uma instância do Jira e o conector Jira do Smartsheet.
• Usuário do conector Jira: cria fluxos de trabalho para sincronizar informações entre o Smartsheet e o Jira.

Recursos por tipo de permissão

A tabela a seguir mostra quais permissões são necessárias para concluir tarefas específicas usando o conector Jira.

* Administradores de sistema do Smartsheet e administradores do conector podem criar e editar fluxos de trabalho quando o recurso de restrição de acesso está habilitado. Se o administrador de sistema ativar a configuração Restringir usuários no conector Jira, você também deverá ter a função de usuário do Jira no Smartsheet. Consulte Restringir o acesso ao conector Jira do Smartsheet.

Antes de começar

Usar uma conta compartilhada para configuração

Configure a conexão usando uma conta de e-mail compartilhada e licenciada (por exemplo, smartsheet-jira@yourdomain.com) para o Smartsheet e o Jira. Não é possível transferir a propriedade da conexão. Se a pessoa que criou a conexão sair da sua organização, você deverá recriar a conexão do zero. Uma conta compartilhada impede isso.

Configurar o firewall

Defina as configurações de firewall antes de iniciar qualquer configuração de conexão.

Permissões necessárias

No Jira:

• Administrador de sistema do Jira (administrador de produto ou de organização)

No Smartsheet:

• Membro (modelo de usuário) ou usuário licenciado (modelo legado) 
• Função de administrador de sistema do Smartsheet, função de administrador do conector Jira do Smartsheet ou ambas

Apenas uma das funções do Smartsheet é necessária, mas o Smartsheet recomenda ter ambas.

Como o conector Jira do Smartsheet executa fluxos de trabalho automáticos, ele precisa de credenciais de administrador de sistema do Jira para criar e configurar webhooks por meio da API REST do Jira. Essas credenciais são usadas apenas para a configuração de webhooks.

Mantenha a conta de configuração ativa. A conta usada para a conexão deve permanecer ativa e manter direitos de administrador no Jira e no Smartsheet. Se esse usuário perder o status de administrador, a conexão será interrompida com o erro: Credenciais de usuário ausentes para este endpoint. A restauração das permissões de administrador retoma a sincronização. Se as credenciais de administrador do Jira forem removidas completamente, você deverá recriar o link do aplicativo porque os tokens serão alterados.

Configurar a conexão

O conector Jira do Smartsheet é compatível com o Jira Cloud e o Jira Data Center. As etapas variam de acordo com o tipo de implementação e a versão do OAuth. Use esta tabela para seguir o caminho que corresponde à sua configuração:

Você pode criar até três conexões por instância do Jira Cloud com o OAuth 2.0.

Jira Cloud ou Data Center OAuth 1.0

Etapa 1: registre um novo servidor do Jira no conector Jira do Smartsheet

1. Entre no conector Jira do Smartsheet. Se for solicitada permissão de acesso à sua conta do Smartsheet, selecione Permitir.
2. Clique no menu superior esquerdo e selecione Administração da conta.
3. Selecione Registrar novo servidor do Jira.
4. Na página Configurações:
   • Insira o URL do host do JIRA do ambiente Jira ao qual você deseja se conectar (por exemplo, https://mbfcorp.atlassian.net/). 
   • O URL da API do JIRA geralmente é o mesmo que o host do JIRA. 
   • Em Nome, aceite o padrão ou insira um nome mais descritivo. 
   • Selecione sua versão do JIRA. Para instâncias do Jira Cloud, selecione Jira Server 7 ou Cloud.

Brandfolder Image

5. Selecione Continuar.
6. Na página Configuração, copie Chave do consumidor, Nome do consumidor e Chave pública. Você usará esses itens nas próximas etapas.
7. Selecione Continuar.

Etapa 2: crie um link do aplicativo (AppLink) para o Smartsheet no Jira

1. Entre no Jira com permissões de administrador do Jira.

2. Acesse Configurações > Produtos.
    

   Brandfolder Image

   

3. Na barra lateral Produtos, em Integrações, selecione Links do aplicativo.

   Em versões anteriores auto-hospedadas do Jira, acesse Configurações > Aplicativos e selecione Links do aplicativo.

   Brandfolder Image

   
4. Selecione Criar link. Na caixa de diálogo que aparecerá, preencha os campos:

   • Jira Cloud: selecione Link direto do aplicativo e insira https://app.smartsheet.com como o URL do aplicativo. Selecione Avançar.

     Brandfolder Image

     

   • Jira Data Center v9 e versões posteriores: selecione Produto da Atlassian e insira https://app.smartsheet.com como o URL do aplicativo. Selecione Continuar.

     Brandfolder Image

     
5. Quando aparecer um aviso de redirecionamento ou validação, selecione Continuar e deixe o URL inalterado.
6. Na caixa de diálogo Revisar link ou Vincular aplicativos que aparecer, preencha os campos:
   • Nome do aplicativo: Smartsheet.
   • Tipo de aplicativo: aplicativo genérico (aceite o padrão).
   • Somente Jira Data Center v9 e versões posteriores: marque Criar link de entrada.

   • Selecione Continuar.

     Brandfolder Image

     

Etapa 3: edite o link do aplicativo

1. Encontre o link do aplicativo que você criou na etapa 2. Selecione o menu de três pontos (passe o cursor sobre ele para revelá-lo) ou o ícone Editar (dependendo da versão). 

2. Na caixa de diálogo Configurar, selecione Autenticação de entrada.
    

   Brandfolder Image

   
3. Preencha os campos: 
   • Nome do provedor de serviços (se mostrado): Smartsheet
   • Nome do consumidor: cole o Nome do consumidor que você copiou na etapa 1
   • Chave do consumidor: cole a Chave do consumidor que você copiou na etapa 1
   • Chave pública/segredo compartilhado: cole a Chave pública que você copiou na etapa 1
   • Descrição: opcional
   • Se os campos URL do token de solicitação, URL do token de acesso ou URL de autorização forem obrigatórios no seu ambiente do Jira, insira https://api.smartsheet.com/2.0/token em cada campo.
4. Selecione Salvar e, em seguida, Fechar.

Etapa 4: conclua a conexão do Jira com o Smartsheet

1. Retorne à configuração do conector Jira do Smartsheet.

2. Na tela Conectar, selecione Conectar.

   Uma caixa de diálogo solicita que você permita ao Smartsheet ler e gravar no seu ambiente do Jira. 

3. Selecione Permitir. 

A conexão agora está ativa. Os membros (usuários licenciados no modelo legado) podem criar fluxos de trabalho entre o Jira e o Smartsheet.

Para conectar ambientes adicionais do Jira, repita essas etapas para cada instância adicional. 

Jira Cloud OAuth 2.0

Etapa 1: registre um novo servidor do Jira no conector Jira do Smartsheet

Defina as configurações de firewall e gerais antes de estabelecer essa conexão.

1. Entre no conector Jira do Smartsheet. Se for solicitada permissão de acesso à sua conta do Smartsheet, selecione Permitir.
2. Clique no menu superior esquerdo e selecione Administração da conta.
3. Selecione Registrar novo servidor do Jira.
4. Na página Configurações:
   • Insira o URL do host do JIRA do ambiente Jira ao qual você deseja se conectar (por exemplo, https://mbfcorp.atlassian.net/). 
   • O URL da API do JIRA geralmente é o mesmo que o host do JIRA. 
   • Em Nome, aceite o padrão ou insira um nome mais descritivo. 
   • Selecione sua versão do JIRA. Para instâncias do Jira Cloud, selecione Jira Server 7 ou Cloud.

Brandfolder Image

5. Selecione Continuar.

   Na página Configuração, uma mensagem é exibida informando que sua conexão com o JIRA já está configurada.

6. Selecione Continuar.

Etapa 2: conclua a conexão do Jira com o Smartsheet

1. Na tela Conectar, selecione Conectar.

   Uma caixa de diálogo solicita que você permita ao Smartsheet ler e gravar no seu ambiente do Jira. 

2. Selecione o host na lista suspensa Usar aplicativo em. 

Brandfolder Image

3. Selecione Permitir. 

A conexão agora está ativa. Os membros (usuários licenciados no modelo legado) podem criar fluxos de trabalho entre o Jira e o Smartsheet.

Para conectar ambientes adicionais do Jira, repita essas etapas para cada instância adicional. 

Jira Data Center OAuth 2.0

Etapa 1: crie um link do aplicativo (AppLink) para o Smartsheet no Jira

1. Entre no Jira.
2. Acesse Configurações > Aplicativos.

3. Na barra lateral Aplicativos, em Integrações, selecione Links do aplicativo.

   Se Aplicativos não aparecer em Configurações, acesse Produtos. Procure Links do aplicativo em Integrações na barra lateral Produtos.

4. Selecione Criar link. Na caixa de diálogo que aparecerá, preencha os campos:
   • Tipo de aplicativo: aplicativo externo
   • Direção: entrada
   • Selecione Continuar

Brandfolder Image

5. Configure o link de entrada:
   • Nome: insira um nome descritivo
   • URL de redirecionamento: {smartsheet-connector-host}/c/jira/signInCallback}. Observe que smartsheet-connector-host é diferente para cada região:

     • EUA: https://connectors.smartsheet.com/c/jira/signInCallback

     • UE: https://connectors.smartsheet.eu/c/jira/signInCallback

     • AU: https://connectors.smartsheet.au/c/jira/signInCallback

   • Permissão do aplicativo: administrador de sistema
6. Selecione Salvar.

Quando a etapa for concluída, o Jira exibirá um ID do cliente e um segredo do cliente. Copie os dois valores, pois você precisará deles na Etapa 2.

Brandfolder Image

Etapa 2: registrar um novo servidor do Jira no conector Jira do Smartsheet

1. Entre no conector Jira do Smartsheet. Se for solicitada permissão de acesso à sua conta do Smartsheet, selecione Permitir.
2. Clique no menu superior esquerdo e selecione Administração da conta.
3. Selecione Registrar novo servidor do Jira.
4. Na página Configurações:
   • Insira o URL do host do JIRA para o ambiente que deseja conectar (por exemplo, https://mbfcorp.atlassian.net/).
   • O URL da API do JIRA normalmente é o mesmo do host do JIRA.
   • Em Nome, aceite o padrão ou insira um nome mais descritivo.
   • Selecione sua versão do JIRA:
5. Selecione Continuar.
6. Na página Configuração, insira o ID do cliente e o Segredo do cliente que você copiou na Etapa 1.

Etapa 3: conclua a conexão do Jira com o Smartsheet

1. Selecione Continuar.

2. Na tela Conectar, selecione Conectar.

   Uma caixa de diálogo solicita que você permita ao Smartsheet ler e gravar no seu ambiente do Jira.

3. Selecione Permitir.

A conexão agora está ativa. Os membros (usuários licenciados no modelo legado) podem criar fluxos de trabalho entre o Jira e o Smartsheet.

Restringir o acesso ao conector Jira do Smartsheet

As permissões no Smartsheet e no Jira sempre controlam o que um usuário pode fazer no conector, independentemente de restrições adicionais estarem habilitadas. Por exemplo, se a pessoa que criou um fluxo de trabalho não tiver permissão para editar dados específicos do projeto no Jira, o fluxo de trabalho não poderá editar esses dados por meio do conector.

Para limitar quais usuários podem criar fluxos de trabalho, o administrador de sistema do Smartsheet ou o administrador do conector Jira pode ativar a configuração Restringir acesso.

Ativar a configuração Restringir acesso

1. Entre no conector Jira do Smartsheet com as suas credenciais do Smartsheet.
2. Selecione o ícone de menu no canto superior esquerdo e selecione Gerenciamento de usuários.

3. Marque Restringir quais usuários podem acessar a integração JIRA do Smartsheet. 

   Brandfolder Image

   
4. Adicione o endereço de e-mail de cada usuário que deve ter acesso.

Remover um usuário

Os usuários removidos da lista perdem a capacidade de criar ou editar fluxos de trabalho.

1. Entre no conector Jira do Smartsheet com as suas credenciais do Smartsheet.
2. Acesse Gerenciamento de usuários.
3. Selecione o ícone Excluir à direita das informações da conta desse usuário.