Configurar o Workfront for Experience Manager enhanced connector assets-integration-overview
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.
-
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.
Configurar pastas vinculadas linked-folders
Para se inscrever nos eventos, siga estas etapas:
- Navegue até a guia Assinaturas de Eventos nos serviços em nuvem.
- Selecione a integração personalizada criada em Workfront.
- Clique em Habilitar assinaturas de eventos do Workfront.
Configuração da estrutura de pastas vinculada linked-folder-structure
- Acesse a guia Pastas vinculadas do projeto nos serviços em nuvem.
- 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.
- 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. - Configurar permissões: Adicionar permissões de
jcr:all permissionsa/conf/workfront-tools/settings/cloudconfigspara o grupowf-workfront-users. - 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.
- Sub-folders multifield permite especificar uma lista de pastas que devem ser criadas como uma pasta filho da pasta vinculada.
- Status do projeto: selecione o status para o qual o projeto deve ser definido para criar a pasta vinculada.
- 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.
- 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 Folderpara o campo e insiraYespara o valor. - Configurar permissão: configure essas permissões,
jcr:all permissions for /conf/workfront-tools/settings/cloudconfigspara owf-workfront-users group. - 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.
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:
-
Adicionar permissões de
jcr:reada/conf/global/settings/dam/adminui-extension/foldermetadataschemapara o grupowf-workfront-users. -
Navegue até Ferramentas > Assets > Esquemas de Metadados de Pasta.
-
Selecione o formulário de esquema de metadados da pasta que deseja editar e clique em Editar.
-
Selecione o campo de formulário de esquema de metadados da pasta que deseja editar e selecione a guia Configurações no painel direito.
-
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)
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:
-
Navegue até Ferramentas > Assets > Esquemas de Metadados.
-
Selecione o formulário de esquema de metadados que deseja editar e clique em Editar ou crie um esquema de metadados do zero.
-
Selecione o campo de formulário de esquema de metadados que deseja editar e selecione a guia Configurações no painel direito.
-
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)
-
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.
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-fieldpode 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.
- Um campo de formulário personalizado identificado pelo prefixo
-
O
aem-mapped-propertypode 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/assetTypeDE:Path={path}URL="https://my-aem-author/assets.html"{+}{path}
Definir status set-status
No editor de fluxo de trabalho, edite as propriedades de Workfront - Definir Status na guia Argumentos.
Sincronização de comentários comments-sync
-
Em Experience Manager, acesse Ferramentas > Cloud Service > Configuração de Ferramentas do Workfront, selecione a configuração e selecione Propriedades.
-
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.
Para testar a sincronização de comentários do Workfront com o AEM, siga estas etapas:
-
Navegue até um documento vinculado no Workfront e adicione um comentário na guia Atualizações.
-
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.
-
No Experience Manager, acesse Ferramentas > Cloud Service > Configuração de Ferramentas Workfront e abra a guia Avançado.
-
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.pdfeasset-name-1.pdf). -
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.
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.
Publicar ativos automaticamente auto-publish-assets
-
No Experience Manager, acesse Ferramentas > Cloud Service > Configuração de Ferramentas Workfront e abra a guia Avançado.
-
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.
-
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.
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.
