Configurar Workfront com conector herdado Adobe Experience Manager
Criado para:
- Administrador
Como administrador do Adobe Workfront, você pode integrar o Workfront ao Adobe Experience Manager (AEM) Assets e fornecer à sua organização uma solução abrangente de gerenciamento de conteúdo para a criação, o compartilhamento e a manutenção de ativos no seu fluxo de trabalho.
Requisitos de acesso
Expanda para visualizar os requisitos de acesso para a funcionalidade neste artigo.
Você deve ter o seguinte acesso para executar as etapas deste artigo:
| Adobe Workfront plano | Qualquer |
| Adobe Workfront licença |
Novo: Padrão Ou Atual: Plano |
| Configurações de nível de acesso | Administrador de Sistema |
Para obter mais detalhes sobre as informações nesta tabela, consulte Requisitos de acesso na documentação do Workfront.
Workfront for AEM Assets
O Workfront for AEM Assets connector permite que sua organização faça o seguinte:
-
Colabore e gerencie conteúdo criativo vinculando ativos e pastas do AEM a projetos, tarefas, problemas e solicitações no Workfront.
Para obter mais informações sobre como configurar integrações de documentação com aplicativos de terceiros, consulte Configurar integrações de documentos.
-
Integre com o repositório do AEM Digital Asset Management (DAM), permitindo que você use o Workfront para gerenciar e compartilhar ativos digitais armazenados no DAM.
Para obter mais informações sobre como vincular documentos e pastas de ativos, consulte Vincular documentos de aplicativos externos.
-
Combine e aplique metadados de ambos os aplicativos a um ativo.
-
Exibir um fluxo de comunicação abrangente para um ativo. Atualizações e comentários feitos em um ativo no Workfront ou no AEM Assets são sincronizados com o outro aplicativo, estabelecendo um histórico abrangente das comunicações feitas com o ativo.
Para obter mais informações sobre como fazer comentários em Workfront, consulte Adicionar uma atualização a um documento.
Pré-requisitos para instalar o conector AEM Assets
Antes de instalar o conector Workfront para AEM Assets, verifique se os seguintes pré-requisitos foram atendidos:
- O AEM Assets está instalado e configurado, versão 6.5 ou posterior. Para obter informações sobre como instalar o AEM Assets, consulte a Adobe Experience Manager documentação.
- (Condicional) Se as regras de firewall não permitirem o tráfego conforme o esperado, adicione o endereço IP e/ou domínio do cluster à inclui na lista de permissões. Incluir na lista de permissões Para obter mais informações, consulte Configurar o arquivo do firewall.
Instalar o pacote do conector Workfront for AEM Assets
IMPORTANTPara instalar o conector Workfront for AEM Assets, você deve importar o conector para o AEM como um pacote usando o Gerenciador de Pacotes do CRX.
-
Em uma estação de trabalho em que você já instalou o AEM, baixe o arquivo de instalação do Conector do Workfront for AEM Assets.
Você pode obter o conector Workfront for AEM Assets de seu representante Workfront.
-
Faça logon no AEM usando uma conta de administrador.
-
Clique em Ferramentas > Implantação > Pacotes. O Gerenciador de Pacotes do CRX se abre.
-
Clique em Carregar pacote.
-
Na caixa de diálogo Carregar Pacote, procure e selecione o pacote do Workfront Connector e clique em OK. O pacote é exibido no Gerenciador de Pacotes do CRX.
-
Clique em Instalar.
-
Na caixa de diálogo Pacote, ignore as configurações avançadas e clique em Instalar.
-
(Opcional) Para confirmar se o conector foi instalado com êxito, verifique se a seguinte instrução é exibida no Log de atividades:
Package installed in <time> -
Feche o Gerenciador de pacotes do CRX. O conector está instalado e agora você pode configurar o AEM Assets para integrar com o Workfront.
-
Continuar com Configurar AEM Assets para integrar com Workfront.
Configurar AEM Assets para integrar com Workfront
Após instalar o conector, importe o pacote do conector para o AEM e configure o AEM para vincular com documentos em Workfront.
Para obter informações sobre como instalar o conector, consulte Instalar o Workfront for AEM Assets pacote do conector.
Pré-requisitos
Antes de começar, você deve ativar permissões para workfront-service:
- No AEM, vá para Ferramentas > Segurança > Permissões.
- No canto superior esquerdo, escolha Usuários no menu suspenso e digite workfront-service no campo Pesquisa . Selecione o usuário workfront-service.
- No lado direito da tela, selecione Adicionar ACE para criar novas entradas.
- Na janela Adicionar Nova Entrada , marque o ícone da caixa de seleção no campo Caminho e escolha a pasta: /conf
- No campo Privilégios, digite: jcr:read
- No canto superior direito, selecione Adicionar.
- (Opcional) Repita as etapas acima para criar mais entradas.
Integrar o AEM com o Workfront
-
Faça logon no AEM Assets como Administrador.
-
Clique em Ferramentas > Cloud Services > Configuração da Integração do Workfront > Global-Workfront.
-
(Condicional) Se você ainda não tiver feito isso, crie um arquivo de configuração na nuvem Workfront:
-
No canto superior direito da página Global-Workfront, clique em Criar.
-
Na caixa URL do Workfront, especifique a URL da instância Workfront.
Por exemplo, https://
<account>.my.workfront.com, onde<account>é a conta usada para integrações com o AEM. -
No campo Pasta base, marque o ícone de caixa de seleção.
-
No menu suspenso, selecione o caminho onde os documentos vinculados a Workfront objetos são armazenados.
-
No modal do AEM que aparece, siga o caminho para a pasta com os documentos que estão conectados a Workfront objetos. Escolha a pasta e pressione Select no canto superior direito.
Você pode vincular a qualquer pasta abaixo da raiz /content/dam/.
-
Na caixa Chave de API do Workfront, especifique a Chave de API do Workfront.
Para recuperar sua chave de API Workfront:
- Abra uma guia do navegador e faça logon na sua conta do Workfront como administrador do Workfront.
-
-
Clique no ícone Menu Principal
-
Clique em Sistema > Informações do cliente.
Se você já tiver gerado uma chave de API, sua Chave de API Workfront será exibida sob o rótulo Chave de API do seu usuário.
-
(Condicional) Se você ainda não tiver gerado uma chave de API, precisará gerar uma:
-
Na seção Configurações da Chave de API, verifique se a opção Após a Criação, as chaves de API expiram em está definida como Nenhuma.
Se você selecionar um período de expiração, o conector deixará de funcionar após a chave de API expirar. Em seguida, será necessário gerar novamente uma Chave de API e atualizar sua configuração Workfront.
-
No rótulo Chave de API do seu usuário, clique em Gerar Chave de API. Uma Chave de API para Workfront é gerada e exibida.
-
-
Copie a chave de API para a área de transferência.
-
Abra a guia do navegador do AEM Connector e, na caixa Workfront API Key, cole a Chave de API copiada.
-
(Condicional) Clique na guia Avançado no canto superior esquerdo da página Workfront Configuração de integração e selecione as seguintes opções, se aplicável:
Permitir Navegação da Coleção: Selecione esta opção se sua organização permitir que Workfront usuários vinculem coleções do AEM Assets a Workfront objetos.
Federated ID do Usuário: selecione esta opção se sua organização estiver usando Federated IDs ou Single Sign-On (SSO) ao fazer logon no Workfront.
Ignorar Domínio de Email: selecione esta opção se os usuários do AEM não usarem o nome de domínio em suas IDs de usuário.
Restringir Acesso: Selecione esta opção para especificar os endereços IP Workfront apropriados que precisam ser adicionados ao arquivo de inclui na lista de permissões. Para obter mais informações sobre a inclui na lista de permissões do firewall, consulte Configurar a inclui na lista de permissões do firewall.
-
No canto superior esquerdo da página Configuração de integração do Workfront, clique na guia Básico e em Conectar.
NOTEAs alterações podem levar algum tempo para serem aplicadas. Reiniciar o pacote pode acelerar o processo.
-
-
(Condicional) Se você já criou um arquivo de configuração na nuvem Workfront, selecione Global-Workfront e, no canto superior esquerdo, clique em Propriedades.
-
Gere a chave de API do AEM clicando em Gerar chave, e copie a chave de API do AEM para a área de transferência.
Você precisará da Chave de API do AEM mais tarde ao configurar o Workfront para integrar-se com o AEM Assets. Para obter mais informações, consulte Configurar o Workfront para integrar aos ativos do AEM.
-
No canto superior direito, clique em Salvar. A janela Global-Workfront é exibida.
-
(Opcional) Sincronizar a comunicação bidirecional entre o AEM e o Workfront:
-
Clique em Global-Workfront.
-
No canto superior esquerdo da janela, clique em Propriedades. A página WorkfrontConfiguração de Integração é exibida.
-
(Opcional) Para habilitar a sincronização de comentários entre o AEM Assets e o Workfront, clique em Habilitar a Sincronização de Comentários.
IMPORTANTVocê deve habilitar a Sincronização de Documentos para sincronizar os ativos. -
(Opcional) Para desativar a sincronização de comentários, clique em Desabilitar Sincronização de Comentários.
Ou
Exclua a assinatura de evento NOTA CRIAR registrada em sua instância do AEM.
Para obter informações sobre assinaturas de evento, consulte API de Assinatura de Evento.
-
-
Continue com Configurar o Externalizador do AEM.
Configurar o Externalizador do AEM
O Externalizador do AEM permite que o AEM passe URLs em um formato que possa ser usado em Workfront. Se não estiver configurado corretamente, o Workfront não poderá fazer chamadas para a API do AEM e as URLs que vinculam documentos do AEM no Workfront não funcionarão.
-
No AEM, clique em Ferramentas > Operações > Console da Web.
-
Clique em OSGI e em Configuração no menu suspenso.
-
Na lista de configuração, selecione Day CQ Link Externalizer. A página Externalizador é exibida.
-
Na seção Domínios, verifique se o domínio listado no campo Autor é o nome de domínio acessível externamente aos usuários do AEM.
O nome de domínio no campo autor deve corresponder ao domínio listado na linha de URL da sua instância do AEM.
-
(Condicional) Se necessário, atualize o domínio no campo Autor.
-
Clique em Salvar. AEM Assets agora está configurado para vincular documentos com Workfront.
-
Continuar com Configurar Workfront para integrar com AEM assets.
Configurar Workfront para integrar com AEM assets
Depois de instalar o Conector do Workfront for AEM Assets (conforme descrito em Instalar o pacote de conectores do Workfront for AEM Assets) e configurar o AEM Assets (conforme descrito em Configurar AEM Assets para integração com o Workfront), você precisará configurar o Workfront para vincular documentos entre o Workfront e o AEM Assets.
-
Faça logon no Workfront como administrador.
TIPA Workfront recomenda criar um administrador do Workfront dedicado exclusivamente à sua integração com o AEM. Para obter mais informações sobre como atribuir o nível de acesso de administrador do Workfront a um usuário, consulte Conceder aos usuários acesso administrativo a determinadas áreas. -
Clique no ícone Menu Principal
-
Clique em Documentos > Integração personalizada.
-
Clique em Adicionar Integração Personalizada.
-
Na caixa Nome, digite o nome da integração personalizada.
Este é o nome que os usuários veem ao usar a integração no Workfront.
-
Na caixa URL da API de Base, digite a URL da sua instância do AEM.
O URL da API de base consiste no URL da instância do AEM seguido pelo caminho: /bin/webhooks/api/
-
No menu suspenso Tipo de autenticação, selecione ApiKey.
-
Na caixa Chave de API, cole a Chave de API do AEM que você copiou quando configurou o AEM Assets.
-
Clique em Salvar.
-
(Opcional) Verifique se a integração está marcada como Ativa.
Workfront está configurado para trabalhar com AEM Assets.
Para acessar ativos no AEM, cada usuário do Workfront que precisar usar o conector deve ser configurado como um usuário no AEM. Para obter informações sobre como criar usuários, consulte Configurar usuários para usar o conector.
Configurar usuários para usar o conector
Para que os usuários acessem o conector, eles devem ter um perfil de usuário no AEM e pertencer a um grupo Workfront que tenha Níveis de acesso que incluam as permissões Criar e Excluir.
Para obter mais informações sobre Workfront permissões, consulte Criar ou modificar níveis de acesso personalizados.
Configurar usuários em AEM assets
-
Faça logon em AEM Assets como administrador do Workfront.
-
Clique em Ferramentas > Segurança > Usuários.
-
(Condicional) Se o usuário não tiver um perfil de usuário no AEM, crie um perfil de usuário do AEM.
-
Clique em Criar Usuário.
-
Insira as informações pessoais do usuário.
O único campo obrigatório é o campo ID. A AEM ID do usuário deve corresponder à ID Workfront, que é o endereço de email Workfront do usuário.
Se você selecionou a opção Ignorar domínio de email ao configurar o AEM para integrar com o Workfront, então a AEM ID não corresponderá ao endereço de email do Workfront.
-
-
(Condicional) Se o usuário tiver um perfil do AEM, abra o perfil do AEM do usuário:
-
Clique em Usuário. A página User Management é exibida.
-
Clique no usuário que você deseja adicionar e em Propriedades. A página de configurações do usuário é exibida.
-
-
Clique na guia Grupos.
-
Certifique-se de que o usuário pertença a pelo menos um grupo Workfront que tenha Níveis de acesso que incluam as permissões Criar e Excluir.
-
Para adicionar o usuário a um grupo existente, comece digitando o nome do grupo na caixa Digitar nome do grupo e, em seguida, selecione o grupo quando ele aparecer no menu suspenso.
Ou
Para selecionar um grupo do qual o usuário é membro, selecione um grupo na seção Grupos dos quais este usuário é membro.
-
-
Clique em Salvar.