Configurar Adobe Workfront for Jira

Você pode usar o Adobe Workfront for Jira para integrar seus sistemas Jira e Workfront.

Após instalar o complemento, você pode definir fluxos de trabalho que criem Jira problemas automaticamente quando Workfront itens de trabalho forem criados. Os itens em ambos os aplicativos se tornam vinculados e algumas de suas informações são atualizadas automaticamente em ambos os sistemas.

Todos os usuários em Workfront e Jira podem se beneficiar dessa integração. Eles só precisam de uma licença para o sistema em que trabalham mais, e não para ambos os sistemas.

Este complemento está disponível para as versões do Software Servidor e OnDemand (ou Nuvem) do Jira.

Para obter uma lista de Jira versões que Workfront for Jira suporta atualmente, consulte Workfront for Jira no Atlassian Marketplace.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso para a funcionalidade neste artigo.

Você deve ter o seguinte:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront plano

Novo: Qualquer um

ou

Atual: Pro ou superior

Adobe Workfront licença

Novo: Padrão

ou

Atual: Plano

Jira acesso

Acesso de administrador do sistema

Importante: recomendamos que você crie contas de administrador do sistema separadas no Jira e no Workfront para se dedicar a essa integração, em vez de usar as existentes que podem estar anexadas aos usuários.

Configurações de nível de acesso Você deve ser um administrador Workfront.

Para obter mais detalhes sobre as informações nesta tabela, consulte Requisitos de acesso na documentação do Workfront.

Pré-requisitos

Antes de configurar o Workfront for Jira, você deve:

Configurar Workfront for Jira

Ao configurar o Workfront for Jira, você pode:

  • Defina os acionadores que criarão Jira itens quando Workfront itens forem criados.
  • Especifique quais campos devem ser sincronizados entre itens vinculados entre Jira e Workfront.
NOTE
  • Após configurar o Workfront for Jira no seu ambiente Jira, todos os usuários do Jira verão um painel direito do Workfront em todos os itens do Jira. O painel contém informações sobre os itens que podem ser vinculados de Workfront ou especifica que nenhum item Workfront está vinculado a itens Jira.
  • Ao usar a instalação do Jira Server, somente os problemas associados aos projetos identificados como acionadores da integração do Workfront exibem o painel do Workfront. Para obter mais informações sobre como configurar acionadores para o fluxo de trabalho Workfront to Jira, consulte Configurar acionadores para vincular automaticamente itens entre Jira e Workfront.

Para configurar Workfront for Jira:

  1. Faça logon em Jira como administrador Jira.

  2. Clique em Configurações no menu principal Jira.

  3. Clique em Complementos e em Gerenciar complementos.

  4. Expanda o complemento Workfront.

  5. Clique em Configurar.

  6. Siga as instruções para fazer logon no Workfront.

    note note
    NOTE
    O usuário deve ter um apiKey válido no Workfront para criar uma conexão bem-sucedida.

    Você deve fazer logon em Workfront como administrador Workfront para continuar a configuração.

    note note
    NOTE
    • O Workfront se conecta ao Jira usando o OAuth 2.0, um padrão usado pela maioria das integrações baseadas na Web para a autenticação e autorização de usuários.
    • Quando for solicitado que você insira o domínio da sua conta do Workfront, digite-o usando este formato: yourCompany'sDomain.my.workfront.com. O domínio da sua empresa geralmente é o nome da sua empresa.
    • A Autenticação Aprimorada não estará disponível até que um administrador do Workfront a habilite para esta integração.
  7. No Jira, selecione a guia Triggers para configurar a criação automática de Jira itens à medida que novos Workfront itens forem criados.

    Para obter mais informações sobre como configurar acionadores para o fluxo de trabalho do Workfront para Jira, consulte Configurar acionadores para vincular automaticamente itens entre Jira e Workfront.

  8. Selecione a guia Instalação para configurar a sincronização de campos entre itens Jira e Workfront vinculados.

    Para obter mais informações sobre como configurar a sincronização de campos entre Jira e Workfront, consulte Configurar a sincronização de campos entre Jira e Workfront Itens.

    note note
    NOTE
    Após definir os acionadores e a sincronização de campos entre os dois aplicativos, qualquer usuário do Workfront que possa criar tarefas ou problemas poderá disparar a criação de um item no Jira. O usuário poderá criar um item se os critérios no item que criar corresponderem aos acionadores em Jira, mesmo se o usuário não tiver uma licença do Jira. Além disso, qualquer usuário do Jira pode começar imediatamente a trabalhar no item Jira, e suas atualizações ficam visíveis no Workfront, sem que ele tenha uma licença do Workfront. Todas as atualizações em Workfront também estão visíveis nos itens Jira.
  9. (Opcional) Selecione a guia Log de atividades para examinar todos os erros ocorridos durante a integração.

    Para obter mais informações sobre o Log de Atividades, consulte Exibir o Jira Log de Atividades.

Configurar disparadores para vincular automaticamente itens entre Jira e Workfront

Como administrador do sistema Jira, você pode definir acionadores que criariam problemas automaticamente em Jira quando um item em Workfront atendesse a determinados critérios.

NOTE
A integração pode levar até 10 minutos para criar novos problemas no Jira.

Considere o seguinte ao configurar o disparo da criação de Jira itens, pois Workfront itens são criados:

  • A integração é unidirecional: você só pode acionar itens criados no Workfront para serem criados automaticamente no Jira. Você não pode acionar itens criados em Jira para serem criados automaticamente em Workfront.
  • Não há limite para o número de acionadores que você pode ter.
  • Se um item que você criar em Workfront corresponder a mais de um dos acionadores, apenas um item será criado em Jira. O item é criado em Jira de acordo com o primeiro acionador (na ordem em que foram definidos em Jira). Todos os outros acionadores são ignorados.
  • Somente um item em Workfront pode ser vinculado a um item no Jira. Você nunca pode vincular um item Workfront a vários problemas Jira, ou um problema Jira a vários itens Workfront.

Para configurar acionadores para criar itens automaticamente em Jira:

  1. Faça logon em Jira como administrador do sistema.

  2. Clique em Configurações no menu principal Jira.

  3. Clique em Complementos e depois em Gerenciar complementos.

  4. Expanda o complemento Workfront.

  5. Clique em Configurar.

  6. Faça logon em Workfront como administrador do sistema.

    A guia Triggers é selecionada por padrão no Jira.

  7. Clique em Adicionar acionador para adicionar um novo acionador.

  8. No campo Equipe/usuário/função do Workfront, especifique o nome de uma equipe, usuário ou função de trabalho Workfront e clique para selecioná-lo quando ele for exibido na lista.

    note note
    NOTE
    Você não pode ter vários acionadores para a mesma equipe, usuário ou função.

    Quando alguém cria uma tarefa ou um problema e o atribui a uma dessas entidades, um problema é automaticamente criado no Jira.

  9. No campo Jiraprojeto, comece digitando o nome de um projeto Jira e clique para selecioná-lo quando ele for exibido na lista.

    Quando o problema Jira é criado, ele é colocado no projeto que você escolheu aqui.

  10. Selecione um Itipo de problema no menu suspenso.

    Isso indica o tipo de problema criado em Jira quando as condições deste gatilho são atendidas, com base nas configurações do projeto específico em Jira.

  11. Clique em Salvar.

    Com essa configuração, toda vez que um usuário Workfront cria um item que corresponde aos acionadores especificados, um novo problema é criado em Jira.

Configurar a sincronização de campo entre Jira e Workfront itens

Como administrador do Jira, você pode definir quais campos devem ser sincronizados automaticamente nos itens vinculados entre o Workfront e o Jira. Determinados campos podem ser sincronizados de Workfront para o item Jira, e outros são sincronizados de Jira para Workfront.

Para definir quais campos devem ser sincronizados automaticamente em itens vinculados entre os dois aplicativos:

  1. Faça logon em Jira como administrador Jira.

  2. Clique em Configurações no menu principal Jira.

  3. Clique em Complementos e depois em Gerenciar complementos.

  4. Expanda o complemento Workfront.

  5. Clique em Configurar.

  6. Faça logon em Workfront como administrador do Workfront.

  7. No Jira, clique na guia Configuração.

  8. Na seção Sincronizar do Workfront para o Jira, selecione os campos que deseja atualizar em Jira quando forem atualizados no Workfront.

    1. Selecione qualquer uma das seguintes frequências com as quais os campos são sincronizados:

      table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
      Na Criação Os campos especificados são sincronizados entre o Workfront vinculado e Jira itens quando o item é criado no Workfront.
      Sempre Os campos especificados são sincronizados entre o Workfront vinculado e Jira itens quando os campos são atualizados no Workfront.
      Nunca Os campos especificados nunca são sincronizados entre os itens Workfront e Jira vinculados. Não há nenhuma indicação em Jira de que o campo foi atualizado em Workfront.
    2. Selecione qualquer uma das opções a seguir para sincronizar os campos de Workfront a Jira:

      table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
      Nome

      O nome de uma tarefa ou um problema em Workfront torna-se o nome do problema ao qual ela está vinculada em Jira.

      Observação: quando novos itens são criados no Jira automaticamente, o Nome do Workfront sempre é atualizado no item Jira, independentemente de esse campo estar ou não habilitado aqui. Quando um item Jira é vinculado manualmente a um item Workfront, o Nome do item Workfront só é atualizado em Jira quando você seleciona Sempre para sincronizar este campo. Para obter mais informações sobre como vincular itens manual ou automaticamente, consulte Vincular itens entre Adobe Workfront e Jira.

      Descrição A descrição de uma tarefa ou um problema em Workfront torna-se a descrição do problema ao qual ela está vinculada em Jira.
      Documentos

      Documentos anexados a uma tarefa ou um problema em Workfront também são anexados ao problema ao qual ele está vinculado no Jira. Novas versões de documentos de Workfront são adicionadas como documentos separados ao Jira e são anexadas com _v<número de versão> para indicar a versão numerada no Workfront.

      Por exemplo, se o nome de um documento em Workfront for Anúncio principal e você adicionar uma nova versão a ele em Workfront, a nova versão será transferida para Jira como um novo documento com o nome Anúncio principal_v2.

      Importante:

      Considere o seguinte ao sincronizar documentos:

      • Documentos maiores que 5 MB não são sincronizados. Se a sincronização de um documento falhar porque o documento é muito grande, um erro será registrado no registro de atividades.

        Para obter mais informações sobre o log de atividades, consulte Exibir o Log de Atividades do Jira.

      • Documentos vinculados a tarefas e problemas de servidores externos não são transferidos para os itens Jira. Somente documentos carregados diretamente na tarefa ou no problema em Workfront são transferidos para o problema vinculado em Jira.

      • Para criar uma prova de um documento, você deve gerar a prova em Workfront.

        Para obter mais informações sobre como gerar uma prova, consulte Criar uma prova para um documento existenteem Criar uma prova para um documento.

      Data de Término Planejada

      A Data de Conclusão Planejada de uma tarefa ou um problema em Workfront torna-se a Data de Conclusão do problema ao qual está vinculado em Jira.

      Observação: exiba Data de Vencimento em Jira problemas, para que esse valor seja sincronizado.

  9. Na seção Sincronizar de Jira paraWorkfront, selecione os campos que deseja atualizar em Workfront quando forem atualizados em Jira.

    1. Selecione qualquer uma das seguintes frequências com as quais os campos são sincronizados:

      table 0-row-2 1-row-2 layout-auto html-authored no-header
      Sempre Os campos especificados são sempre sincronizados entre os itens Workfront e Jira vinculados quando os campos são atualizados em Jira.
      Nunca

      Os campos especificados nunca são sincronizados entre os itens Workfront e Jira vinculados. Não há nenhuma indicação em Workfront de que o campo foi atualizado em Jira.

      Observação: ao selecionar Nunca, os campos Workfront ainda podem ser atualizados manualmente de Jira no painel Workfront esquerdo do problema Jira. Essas atualizações aparecem somente nos itens Workfront em Jira e Workfront e não nos itens Jira.

    2. Selecione para sincronizar qualquer um dos seguintes campos de Jira a Workfront:

      table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
      Status O Status de um problema em Jira torna-se o Status da tarefa ou problema ao qual ele está vinculado em Workfront.
      Para obter mais informações sobre Workfront status, consulte Criar ou editar um status.
      Atribuído

      O Atribuído de um problema em Jira torna-se o Atribuído da tarefa ou problema ao qual está vinculado em Workfront.

      Importante: quando você atribui um item em Jira a um usuário que não tem uma conta Workfront, a integração cria um novo usuário ativo em Workfront somente quando Cria automaticamente um usuário em Workfront se o usuário Jira não tiver uma conta Workfront estiver definido como Always. Este usuário não ocupa uma licença Workfront. Usuários ativos podem ser atribuídos a itens de trabalho em Workfront, mas não podem ser incluídos em atualizações.

      Anexos Anexos de um problema em Jira também são anexados à tarefa ou problema ao qual ele está vinculado em Workfront.
      Comentários

      Um comentário sobre um problema Jira também é postado no item Workfront vinculado na área Atualizações. Por outro lado, um comentário postado na área Atualizações para uma tarefa Workfront ou problema sincroniza com o fluxo de comentários nativo de Jira para o problema vinculado.

      Isso é definido como Always por padrão. Se você selecionar Nunca aqui, ainda poderá postar comentários manualmente em um item vinculado em Workfront ou em Jira.

  10. Na seção OTHER, selecione quais campos adicionais devem ser atualizados entre itens vinculados.

    1. Selecione uma opção para determinar se os campos que você especifica Sempre ou Nunca são atualizados em Jira ou Workfront quando são modificados.

    2. Selecione entre os seguintes campos e atualizações:

      table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
      Copiar Dados Personalizados Workfront no painel direito em Jira

      Exibe os Workfront Dados Personalizados de um item no painel direito Workfront.

      Observação: as seções de Formulário personalizado são exibidas no painel direito do Workfront com o nível de acesso do Administrador do Sistema do Workfront.

      Copiar Prioridade Workfront no painel direito em Jira Exibe a Prioridade Workfront de um item no painel direito Workfront.
      Adicionar uma atualização na guia Atualizações Workfront sobre alterações da Data de Conclusão em Jira Adiciona um comentário na guia Atualizar do item Workfront quando a Data de Conclusão é alterada no item Jira vinculado.
      Criar automaticamente um usuário em Workfront se o usuário Jira não tiver uma conta Workfront

      Existem os seguintes cenários:

      • Ao selecionar Always, você habilita a integração para criar um novo usuário do Workfront sempre que um usuário do Jira sem uma conta do Workfront executar as seguintes ações em um problema do Jira vinculado:

        • Está atribuído a um problema Jira

        • Registra o tempo em um problema Jira

          Este novo usuário não ocupa uma licença do Workfront. A configuração padrão é Sempre. O usuário criado desta forma em Workfront adicionou "Jira" ao seu nome.

      • Quando você seleciona Nunca, as seguintes coisas acontecem:

        • Você não pode ver nenhuma atribuição do Jira nos itens Workfront. Nesse caso, somente as atribuições feitas em Workfront são exibidas nos itens Workfront.
        • O tempo registrado em um problema Jira vinculado por um usuário sem uma conta Workfront não é transferido automaticamente para o item Workfront vinculado. Você ainda pode registrar horas no item Workfront no painel direito do problema Jira.
  11. Clique em Salvar.

    Agora, sempre que um usuário atualizar qualquer um dos campos especificados nessa configuração em um item no Jira ou Workfront, o item vinculado no outro aplicativo também será atualizado.

Solução de problemas

Não é possível criar itens em Jira devido a campos de gatilho marcados como "Não foi possível encontrar"

Problema

Quando ocorre um erro com o aplicativo Workfront for Jira, o Workfront desabilita os disparadores para evitar mais complicações. Quando esses acionadores são desativados, eles são exibidos como "Não foi possível encontrá-los".

Solução

Localize o erro que desativou os acionadores. Você pode encontrar o erro no Workfront for Jira Log de atividades.

A causa mais comum desse comportamento é o erro "O campo 'duedate' não pode ser definido. Não está na tela apropriada, ou é desconhecido."

Este erro significa que você está tentando sincronizar a "Data de Término Planejada" de Workfront para Jira. Para fazer isso, você deve garantir que seus objetos Jira tenham um campo chamado "Data de vencimento". Se eles não tiverem esse campo, Workfront não poderá sincronizar a data de conclusão planejada de Workfront e desabilitará seus gatilhos.

Para resolver esse erro, tente uma das seguintes opções:

  • Peça ao administrador do Jira para atualizar os objetos Jira afetados para garantir que eles tenham um campo de data de vencimento.
  • Desabilite a sincronização da data de conclusão planejada de Workfront na página Instalação da Workfront.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43