Configurar o Workfront for Experience Manager enhanced connector assets-integration-overview

Versão
Link do artigo
AEM 6.5
Clique aqui
AEM as a Cloud Service
Este artigo

Um usuário com acesso de administrador no Adobe Experience Manager as a Cloud Service configura o conector aprimorado após instalá-lo. Para obter instruções de instalação, consulte Instalar o conector.

IMPORTANT
A partir de junho de 2022, o Adobe lançou uma nova integração nativa para conectar o Workfront ao Adobe Experience Manager Assets as a Cloud Service. Essa integração se tornou o método necessário para conectar essas duas soluções. Qualquer nova implementação futura do conector aprimorado (1.9.8 e posterior) para conectar o Workfront com o AEM Assets as a Cloud Service está bloqueada.
IMPORTANT
  • O Adobe exige a implantação e a configuração do Adobe Workfront for Experience Manager enhanced connector somente por meio de parceiros certificados ou Adobe Professional Services. Se implantado e configurado sem um parceiro certificado ou Adobe Professional Services, não é suportado pelo Adobe.

  • O Adobe pode lançar atualizações para Adobe Workfront e Adobe Experience Manager que tornam este conector redundante; se isso ocorrer, pode ser necessário que os clientes façam a transição do uso deste conector.

  • O Adobe suporta o conector aprimorado versões 1.7.4 e superiores. As versões anteriores de pré-lançamento e personalizadas não são compatíveis. Para verificar a versão aprimorada do conector, consulte a etapa 5(a) de instruções de instalação do conector aprimorado.

  • Consulte Exame de certificação de parceiro para o conector aprimorado do Workfront for Experience Manager Assets. Para obter informações sobre o exame, consulte o Guia do Exame.

Configurar assinaturas de evento event-subscriptions

Assinaturas de eventos são usadas para notificar o AEM sobre eventos que ocorrem em Adobe Workfront. Existem três recursos Workfront for Experience Manager enhanced connector que precisam de assinaturas de evento para funcionar:

  • Criação automática de pastas vinculadas ao projeto.
  • Sincronização de alterações nos valores de formulário personalizado do documento do Workfront com os metadados de ativos AEM.
  • Publicação automática de ativos no Brand Portal após a conclusão do projeto.

Para usar esses recursos, habilite as assinaturas de evento.

  • Edite a configuração Workfront Tools Cloud Service criada na etapa 5 e selecione a guia Assinaturas de Eventos.

  • Selecione a Integração personalizada do Workfront que você criou na seção 6.

  • Clique em Habilitar assinaturas de eventos do Workfront.

    Assinatura de evento

Configurar pastas vinculadas linked-folders

Para se inscrever nos eventos, siga estas etapas:

  1. Navegue até a guia Assinaturas de Eventos nos serviços em nuvem.
  2. Selecione a integração personalizada criada em Workfront.
  3. Clique em Habilitar assinaturas de eventos do Workfront.

Configuração da estrutura de pastas vinculada linked-folder-structure

  1. Acesse a guia Pastas vinculadas do projeto nos serviços em nuvem.
  2. Caminho principal da pasta vinculada: selecione uma pasta no DAM onde deseja criar as pastas vinculadas. Se deixado em branco, o padrão será /content/dam. Verifique se o esquema de metadados das Ferramentas do Workfront e o esquema de metadados da pasta vinculada do Workfront foram aplicados à pasta selecionada.
  3. Estrutura de pasta vinculada: insira valores separados por vírgula. Cada valor deve ser DE:<some-project-custom-form-field>, Portfolio, Program, Year, Name ou algum "Valor de sequência de caracteres literais" (este último com aspas). No momento, está definido como Portfolio, Program, Year, DE:Project Type, Name.
  4. Configurar permissões: Adicionar permissões de jcr:all permissions a /conf/workfront-tools/settings/cloudconfigs para o grupo wf-workfront-users.
  5. Criar título de pasta vinculado no Workfront usando a caixa de seleção de nomes de estrutura de pastas deve ser marcada se o título da pasta no Workfront deve incluir todas as pastas na estrutura. Caso contrário, será o título da última pasta.
  6. Sub-folders multifield permite especificar uma lista de pastas que devem ser criadas como uma pasta filho da pasta vinculada.
  7. Status do projeto: selecione o status para o qual o projeto deve ser definido para criar a pasta vinculada.
  8. Criar uma pasta vinculada em projetos com portfólio: lista de Portfolio aos quais o projeto deve pertencer para que você possa criar a pasta vinculada. Deixe essa lista vazia para criar a pasta vinculada para todos os portfólios de projetos.
  9. Criar uma pasta vinculada em projetos com campo de formulário personalizado: o campo de formulário personalizado e seu valor correspondente que o projeto deve ter para que você possa criar a pasta vinculada. Essa configuração será ignorada se for deixada vazia. Selecione CUSTOM FORMS: Create DAM Linked Folder para o campo e insira Yes para o valor.
  10. Configurar permissão: configure essas permissões, jcr:all permissions for /conf/workfront-tools/settings/cloudconfigs para o wf-workfront-users group.
  11. Clique em Habilitar criação automática de pastas vinculadas. Volte para a guia Assinaturas de eventos e veja que agora há um evento de criação.

configuração de pasta vinculada

Mapeamento de esquema de metadados metadata-schema-mapping

Configurar mapeamento de metadados da pasta folder-metadata-mapping

O mapeamento de metadados entre Projetos Workfront e Pastas AEM é definido nos Esquemas de metadados da pasta AEM. Os esquemas de metadados de pasta devem ser criados e configurados como de costume no AEM. O Workfront Tools adiciona uma lista suspensa de preenchimento automático à guia Configurações de cada campo de formulário de esquema de metadados de pasta. Esse menu suspenso de preenchimento automático permitirá especificar para qual campo do Workfront cada propriedade da pasta AEM deve ser mapeada.

Para configurar os mapeamentos, siga estas etapas:

  1. Adicionar permissões de jcr:read a /conf/global/settings/dam/adminui-extension/foldermetadataschema para o grupo wf-workfront-users.

  2. Navegue até Ferramentas > Assets > Esquemas de Metadados de Pasta.

  3. Selecione o formulário de esquema de metadados da pasta que deseja editar e clique em Editar.

  4. Selecione o campo de formulário de esquema de metadados da pasta que deseja editar e selecione a guia Configurações no painel direito.

  5. No campo Mapeado do Campo Workfront, selecione o nome do campo Workfront que você deseja mapear para a propriedade de pasta AEM selecionada. As opções disponíveis são:

    • Campos de formulário personalizado do projeto
    • Campos de visão geral do projeto (ID, Nome, Descrição, Número de referência, Data de conclusão planejada, Proprietário do projeto, Patrocinador do projeto, Portfolio ou Programa)

configuração de mapeamento de metadados

Configurar o mapeamento de metadados de ativos asset-metadata-mapping

O mapeamento de metadados entre os documentos do Adobe Workfront e o Assets é definido nos Esquemas de metadados do AEM. Os esquemas de metadados devem ser criados e configurados como de costume no AEM. O Workfront Tools adiciona opções de configuração à guia Configurações de cada campo de formulário de esquema de metadados. Essas opções permitirão especificar para qual campo do Workfront cada propriedade AEM deve ser mapeada.

Para configurar os mapeamentos, siga estas etapas:

  1. Navegue até Ferramentas > Assets > Esquemas de Metadados.

  2. Selecione o formulário de esquema de metadados que deseja editar e clique em Editar ou crie um esquema de metadados do zero.

  3. Selecione o campo de formulário de esquema de metadados que deseja editar e selecione a guia Configurações no painel direito.

  4. No Campo de formulário personalizado Workfront, selecione o nome do campo Workfront que você deseja mapear para a propriedade AEM selecionada. As opções disponíveis são:

    • Campos de formulário personalizado de documento
    • Campos de formulário personalizado do projeto
    • Emitir campos de formulário personalizados
    • Campos de formulário personalizado de tarefa
    • Campos de Visão Geral do Projeto (ID, Nome, Descrição ou Número de Referência)
  5. Se o campo Workfront selecionado no Campo de formulário personalizado do Workfront for um campo de tipo antecipado do usuário do Workfront, será necessário especificar qual campo de usuário do Workfront você deseja mapear. Para fazer isso, marque Obter valor do campo de objeto referenciado do Workfront e especifique o nome do Campo de Formulário personalizado do usuário do Workfront do qual recuperar o valor a ser mapeado.

    configuração de mapeamento de metadados

Mapear propriedade map-property

Esta etapa do fluxo de trabalho permite que um usuário mapeie uma propriedade para um formulário personalizado Workfront em um projeto, tarefa, problema ou documento. O artefato Workfront que esta etapa afeta é pesquisado usando um caminho relativo da carga. As propriedades a serem mapeadas são controladas na configuração da caixa de diálogo de etapas.

Tipo: este campo permite selecionar o tipo de objeto do Workfront para o qual as propriedades devem ser mapeadas.

Propriedade de ID: este campo permite que você especifique o caminho para a ID do objeto Workfront para o qual as propriedades devem ser mapeadas. O caminho especificado neste campo deve ser relativo à carga do fluxo de trabalho.

Atribuições de propriedade: este multicampo permite especificar os mapeamentos entre propriedades AEM e campos Workfront. Cada item no multicampo especificará um mapeamento. Cada mapeamento deve ter o formato <workfront-field>=<aem-mapped-property>.

  • O workfront-field pode ser

    • Um campo de formulário personalizado identificado pelo prefixo DE:.
    • Um campo editável identificado por seu nome. Os nomes de campos são encontrados no Workfront explorador de API.
  • O aem-mapped-property pode ser:

    • Um valor literal. Elas devem estar entre aspas.
    • Uma propriedade do AEM. Essa referência deve ser relativa à carga do workflow.
    • Um valor nomeado. Eles devem estar entre colchetes.
    • Uma concatenação dos 3 itens acima. Especifique usando {+}.
    • Uma alteração dos 3 itens acima ao cercar o valor com {replace(<value>,"old-char","new-char")}.
  • Alguns exemplos são:

    • status="INP"
    • DE:Asset Type=jcr:content/metadata/assetType
    • DE:Path={path}
    • URL="https://my-aem-author/assets.html"{+}{path}

Configuração para mapear a propriedade

Definir status set-status

No editor de fluxo de trabalho, edite as propriedades de Workfront - Definir Status na guia Argumentos.

Editar fluxo de trabalho para definir o status

Sincronização de comentários comments-sync

  1. Em Experience Manager, acesse Ferramentas > Cloud Service > Configuração de Ferramentas do Workfront, selecione a configuração e selecione Propriedades.

    sincronização de comentários

  2. Selecione a guia Assinaturas de Eventos, clique na opção Habilitar Sincronização de Comentários em Enviar Comentários feitos no Workfront para AEM.

    Sincronização habilitada

Para testar a sincronização de comentários do Workfront com o AEM, siga estas etapas:

  1. Navegue até um documento vinculado no Workfront e adicione um comentário na guia Atualizações.

    deixar comentário no Workfront

  2. Navegue até o mesmo documento vinculado no AEM, selecione o documento e abra a opção Linha do tempo na navegação à esquerda e selecione Comentários. A barra lateral esquerda exibe os comentários sincronizados de Workfront.

Versões do ativo asset-versions

Para manter o histórico de versões de ativos no AEM, configure o controle de versão de ativos no AEM.

  1. No Experience Manager, acesse Ferramentas > Cloud Service > Configuração de Ferramentas Workfront e abra a guia Avançado.

  2. Selecione a opção Armazenar ativos com o mesmo nome das versões do ativo existente. Quando marcada, essa opção permite armazenar ativos carregados com o mesmo nome e no mesmo local que a versão do ativo existente. Se deixado desmarcado, um novo ativo é criado com um nome diferente (por exemplo, asset-name.pdf e asset-name-1.pdf).

  3. Selecione a opção Atualizar metadados de ativos ao criar uma nova versão. Quando marcada, essa opção atualiza os metadados do ativo sempre que uma nova versão do ativo é criada. Se desmarcado, o ativo manterá os metadados que tinha antes da criação da nova versão.

configurar o controle de versão do ativo

NOTE
Não há suporte para o controle de versão em pastas vinculadas. Ao criar uma prova do Workfront com um documento dentro de uma pasta vinculada, os comentários e as anotações na versão anterior do ativo são removidos.

Anexar formulários personalizados attach-custom-forms

Esta etapa do fluxo de trabalho permite que os usuários anexem um formulário personalizado a um artefato do Workfront. Essa etapa do fluxo de trabalho pode ser adicionada a qualquer modelo de fluxo de trabalho. O artefato Workfront que esta etapa afeta é pesquisado usando um caminho relativo da carga.

No editor de fluxo de trabalho do Experience Manager, edite as propriedades da etapa de fluxo de trabalho Workfront - Anexar formulário personalizado.

formulários personalizados .

Publicar ativos automaticamente auto-publish-assets

  1. No Experience Manager, acesse Ferramentas > Cloud Service > Configuração de Ferramentas Workfront e abra a guia Avançado.

  2. Selecione Publicar ativos automaticamente quando enviados do Workfront. Essa opção permite a publicação automática de ativos quando eles são enviados do Workfront para o AEM. Esse recurso pode ser ativado condicionalmente especificando um campo de formulário personalizado do Workfront e o valor para o qual ele deve ser definido. Sempre que um documento for enviado ao AEM, se ele atender à condição, o ativo será publicado automaticamente.

  3. Selecione Publish todos os ativos do projeto para Brand Portal após a conclusão do projeto. Esta opção habilita a publicação automática de ativos em Brand Portal quando o status do projeto do Workfront ao qual eles pertencem é alterado para Complete.

configurar publicação automática

Atualizações de formulário personalizado de documento do Workfront subscribe-workfront-doc-custom-form-updates

Para assinar as alterações feitas nos formulários personalizados de documentos do Workfront, selecione a opção relevante na guia Avançado. Quando você assina essas atualizações, ele atualiza os campos de metadados Experience Manager mapeados quando o campo correspondente no formulário personalizado do documento Workfront é alterado.

Configuração de atualizações de formulário personalizado de documento do Workfront em Experience Manager

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab