Usar microsserviços de ativos e perfis de processamento get-started-using-asset-microservices

Os microsserviços de ativos fornecem processamento escalável e resiliente de ativos usando aplicativos nativos em nuvem (também chamados de trabalhadores). O Adobe gerencia os serviços para obter o tratamento ideal de diferentes tipos de ativos e opções de processamento.

Os microsserviços de ativos permitem processar uma ampla variedade de tipos de arquivos que abrangem mais formatos prontos para uso do que o possível com versões anteriores do Experience Manager. Por exemplo, a extração em miniatura dos formatos PSD e PSB agora é possível, mas anteriormente era necessária para soluções de terceiros, como o ImageMagick.

O processamento de ativos depende da configuração em Processando Perfis. O Experience Manager fornece uma configuração padrão básica e permite que os administradores adicionem configurações mais específicas de processamento de ativos. Os administradores criam, mantêm e modificam as configurações dos fluxos de trabalho de pós-processamento, incluindo personalização opcional. A personalização dos fluxos de trabalho permite que os desenvolvedores estendam a oferta padrão.

Uma exibição de alto nível do processamento de ativos

NOTE
O processamento de ativos descrito aqui substitui o modelo de fluxo de trabalho DAM Update Asset existente nas versões anteriores do Experience Manager. A maioria das etapas relacionadas à geração de representação padrão e aos metadados é substituída pelo processamento dos microsserviços de ativos, e as etapas restantes, se houver, podem ser substituídas pela configuração do fluxo de trabalho de pós-processamento.

Entender as opções de processamento de ativos get-started

Experience Manager permite os seguintes níveis de processamento.

Opção
Descrição
Casos de uso abrangidos
Configuração padrão
Ela está disponível como está e não pode ser modificada. Essa configuração fornece um recurso de geração de representação muito básico.
  • Miniaturas padrão usadas pela interface do usuário Assets (48, 140 e 319 pixels)
  • Visualização grande (representação da Web - 1280 pixels)
  • Extração de metadados e texto.
Configuração personalizada
Configurado por administradores via interface do usuário. Fornece mais opções para geração de representação estendendo a opção padrão. Estenda a opção pronta para uso para fornecer diferentes formatos e representações.
  • Representação FPO.
  • Alterar formato de arquivo e resolução de imagens
  • Aplicar condicionalmente a tipos de arquivos configurados.
Perfil personalizado
Configurado por administradores via interface de usuário para usar o código personalizado por meio de aplicativos personalizados para chamar o Serviço do Asset Compute. Suporta requisitos mais complexos em um método escalável e nativo em nuvem.
Consulte casos de uso permitidos.

Formatos de arquivo não compatíveis supported-file-formats

Os microsserviços de ativos são compatíveis com uma grande variedade de formatos de arquivo para processar, gerar representações ou extrair metadados. Consulte formatos de arquivo com suporte para obter a lista completa de tipos MIME e a funcionalidade com suporte para cada tipo.

Configuração padrão default-config

Alguns padrões são pré-configurados para garantir que as representações padrão necessárias no Experience Manager estejam disponíveis. A configuração padrão também garante que as operações de extração de metadados e extração de texto estejam disponíveis. Os usuários podem começar a fazer upload ou atualizar ativos imediatamente e o processamento básico está disponível por padrão.

Com a configuração padrão, somente o perfil de processamento mais básico é configurado. O perfil de processamento não está visível na interface do usuário e você não pode modificá-lo. Ele sempre é executado para processar ativos carregados. Esse perfil de processamento padrão garante que o processamento básico exigido por Experience Manager seja concluído em todos os ativos.

Configuração padrão standard-config

O Experience Manager fornece recursos para gerar representações mais específicas para formatos comuns, de acordo com as necessidades do usuário. Um administrador pode criar Perfis de Processamento adicionais para facilitar essa criação de representação. Os usuários atribuem um ou mais perfis disponíveis a pastas específicas para concluir o processamento adicional. Por exemplo, o processamento adicional pode gerar representações para web, dispositivos móveis e tablets. O vídeo a seguir ilustra como criar e aplicar Perfis de Processamento e como acessar as representações criadas.

  • Largura e altura da representação: a especificação de largura e altura da representação fornece tamanhos máximos da imagem de saída gerada. Os microsserviços de ativos tentam produzir a maior representação possível, cuja largura e altura não são maiores que a largura e a altura especificadas, respectivamente. A proporção é preservada, ou seja, a mesma do original. Um valor vazio significa que o processamento de ativos assume a dimensão em pixels do original.

  • Regras de inclusão de tipo MIME: quando um ativo com um tipo MIME específico é processado, o tipo MIME é verificado primeiro em relação ao valor de tipos MIME excluídos para a especificação de representação. Se ele corresponder a essa lista, essa representação específica não será gerada para o ativo (lista de bloqueios). Caso contrário, o tipo MIME será verificado em relação ao tipo MIME incluído e, se ele corresponder à lista, a representação será gerada (lista de permissões).

  • Representação FPO especial: ao colocar ativos de grande porte do Experience Manager em documentos do Adobe InDesign, um profissional de criação aguarda um tempo considerável depois de colocar um ativo. Enquanto isso, o usuário não pode usar InDesign. Isso interrompe o fluxo de criação e afeta negativamente a experiência do usuário. O Adobe permite colocar temporariamente representações de pequeno porte em documentos do InDesign para começar, que podem ser substituídas por ativos de resolução completa sob demanda posteriormente. Experience Manager fornece representações que são usadas apenas para posicionamento (FPO). Essas representações FPO têm um tamanho de arquivo pequeno, mas têm a mesma proporção.

O perfil de processamento pode incluir uma representação FPO (somente para posicionamento). Consulte a Adobe Asset Link documentação para entender se você precisa ativá-la para o seu perfil de processamento. Para obter mais informações, consulte a documentação completa do Link do ativo do Adobe.

Criar um perfil padrão create-standard-profile

Para criar um perfil de processamento padrão, siga estas etapas:

  1. Os administradores acessam Ferramentas > Assets > Processando Perfis. Clique em Criar.

  2. Forneça um nome que ajude a identificar exclusivamente o perfil ao aplicar a uma pasta.

  3. Para gerar representações FPO, na guia Imagem, habilite Criar Representação FPO. Insira um valor de Qualidade de 1-100.

  4. Para gerar outras representações, clique em Adicionar novo e forneça as seguintes informações:

    • Nome do arquivo de cada representação.
    • Formato de arquivo (PNG, JPEG, GIF ou WebP) de cada representação.
    • Largura e altura em pixels de cada representação. Se os valores não forem especificados, será usado o tamanho total em pixels da imagem original.
    • Qualidade em porcentagem de cada representação de JPEG e WebP.
    • Tipos MIME incluídos e excluídos para definir a aplicabilidade de um perfil.

    adicionando-perfis-de-processamento

  5. Clique em Salvar.

Perfil personalizado e casos de uso custom-config

O Asset Compute Service oferece suporte a diversos casos de uso, como processamento padrão, processamento de formatos específicos de Adobe, como arquivos Photoshop, e implementação de processamento personalizado ou específico da organização. A personalização do fluxo de trabalho do Ativo de atualização do DAM necessária no passado é realizada automaticamente ou por meio da configuração de perfis de processamento. Se essas opções de processamento não atenderem às necessidades dos negócios, a Adobe recomenda desenvolver e usar o Asset Compute Service para estender os recursos padrão. Para obter uma visão geral, consulte entender a extensibilidade e quando usá-la.

NOTE
A Adobe recomenda usar um aplicativo personalizado somente quando os requisitos comerciais não puderem ser cumpridos usando as configurações padrão ou o perfil padrão.

Ele pode transformar imagens, vídeos, documentos e outros formatos de arquivo em diferentes representações, incluindo miniaturas, texto e metadados extraídos e arquivos.

Os desenvolvedores podem usar o Asset Compute Service para criar aplicativos personalizados para os casos de uso com suporte. O Experience Manager pode chamar esses aplicativos personalizados na interface do usuário usando perfis personalizados que os administradores configuram. Asset Compute Service dá suporte aos seguintes casos de uso de invocação de serviços externos:

  • Use a API ImageCutout de Adobe Photoshop e salve o resultado como representação.
  • Chame sistemas de terceiros para atualizar dados, por exemplo, um sistema PIM.
  • Use a API Photoshop para gerar uma variedade de representações com base no modelo do Photoshop.
  • Use a API do Adobe Lightroom para otimizar os ativos assimilados e salvá-los como representações.
NOTE
Não é possível editar os metadados padrão usando os aplicativos personalizados. Você só pode modificar metadados personalizados.

Criar um perfil personalizado create-custom-profile

Para criar um perfil personalizado, siga estas etapas:

  1. Os administradores acessam Ferramentas > Assets > Processando Perfis. Clique em Criar.

  2. Clique na guia Personalizado. Clique em Adicionar novo. Forneça o nome de arquivo desejado para a representação.

  3. Forneça as seguintes informações.

    Clique em Salvar.

Os aplicativos personalizados são aplicativos Project App Builder headless. Seu aplicativo personalizado obtém todos os arquivos fornecidos se eles forem configurados com um perfil de processamento. O aplicativo deve filtrar os arquivos.

CAUTION
Se o aplicativo App Builder e a conta Experience Manager não forem da mesma organização, a integração não funcionará.

Exemplo de perfil personalizado custom-profile-example

Para ilustrar o uso do perfil personalizado, vamos considerar um caso de uso para aplicar texto personalizado a imagens da campanha. É possível criar um perfil de processamento que use a API do Photoshop para editar as imagens.

A integração do Asset Compute Service permite que o Experience Manager passe esses parâmetros para o aplicativo personalizado usando o campo Parâmetros de Serviço. O aplicativo personalizado chama a API do Photoshop e passa esses valores para a API. Por exemplo, você pode passar o nome da fonte, a cor do texto, a espessura e o tamanho do texto para adicionar o texto personalizado às imagens da campanha.

perfil-processamento-personalizado

Figura: Use o campo Parâmetros de Serviço para transmitir informações adicionadas à compilação de parâmetros predefinidos para o aplicativo personalizado. Neste exemplo, quando as imagens da campanha são carregadas, elas são atualizadas com texto Jumanji na fonte Arial-BoldMT.

Usar perfis de processamento para processar ativos use-profiles

Crie e aplique perfis de processamento adicionais e personalizados a pastas específicas para que o Experience Manager processe ativos carregados ou atualizados nessas pastas. O perfil de processamento padrão incorporado é sempre executado, mas não fica visível na interface do usuário do. Se você adicionar um perfil personalizado, ambos os perfis serão usados para processar os ativos carregados.

Aplique perfis de processamento a pastas usando um dos seguintes métodos:

  • Os administradores podem selecionar uma definição de perfil de processamento em Ferramentas > Assets > Perfis de Processamento e usar a ação Aplicar Perfil às Pastas. Ele abre um navegador de conteúdo que permite navegar até pastas específicas, selecioná-las e confirmar a aplicação do perfil.

  • Os usuários podem selecionar uma pasta na interface do usuário do Assets, usar a ação Propriedades para abrir a tela de propriedades da pasta, clicar na guia Processamento de ativos e, na lista Perfil de Processamento, selecionar o perfil de processamento apropriado para essa pasta. Para salvar as alterações, clique em Salvar e fechar.
    Aplicar perfil de processamento a uma pasta da guia Propriedades do ativo

  • Os usuários podem selecionar pastas ou ativos específicos na interface do Assets para aplicar um perfil de processamento e, em seguida, selecionar a opção ícone de reprocessamento de ativos Reprocessar Assets nas opções disponíveis na parte superior.

TIP
Somente um perfil de processamento pode ser aplicado a uma pasta. Para gerar mais representações, adicione mais definições de representação ao perfil de processamento existente.

Depois que um perfil de processamento é aplicado a uma pasta, todos os novos ativos carregados (ou atualizados) nessa pasta ou em qualquer uma de suas subpastas são processados usando o perfil de processamento adicional configurado. Esse processamento é executado em adição ao do perfil padrão.

NOTE
Um perfil de processamento aplicado a uma pasta funciona para toda a árvore, mas pode ser substituído por outro perfil aplicado a uma subpasta. Quando os ativos são carregados para uma pasta, o Experience Manager verifica se as propriedades da pasta que os contém têm um perfil de processamento. Se nenhum for aplicado, uma pasta principal na hierarquia será verificada em busca de um perfil de processamento para ser aplicado.

Para verificar se os ativos são processados, visualize as representações geradas na exibição Representações no painel esquerdo. Abra a visualização de ativos e abra o painel esquerdo para acessar a exibição Representações. As representações específicas no perfil de processamento, para as quais o tipo de ativo específico corresponde às regras de inclusão do tipo MIME, devem estar visíveis e acessíveis.

execuções adicionais

Figura: Exemplo de duas representações adicionais geradas por um perfil de processamento aplicado à pasta pai.

Fluxos de trabalho de processamento Post post-processing-workflows

Para uma situação em que é necessário um processamento adicional de ativos que não pode ser obtido usando os perfis de processamento, fluxos de trabalho de pós-processamento adicionais podem ser adicionados à configuração. O processamento Post permite adicionar processamento totalmente personalizado além do processamento configurável usando microsserviços de ativos.

Os fluxos de trabalho de processamento Post ou o Fluxo de trabalho de início automático, se configurado, são executados automaticamente por Experience Manager após a conclusão do processamento dos microsserviços. Não há necessidade de adicionar iniciadores de fluxo de trabalho manualmente para acionar os fluxos de trabalho. Os exemplos incluem:

  • Etapas personalizadas do fluxo de trabalho para processar ativos.
  • Integrações para adicionar metadados ou propriedades a ativos de sistemas externos, por exemplo, informações de produto ou processo.
  • Processamento adicional feito por serviços externos.

Para adicionar uma configuração de fluxo de trabalho de pós-processamento ao Experience Manager, siga estas etapas:

  • Crie um ou mais modelos de fluxo de trabalho. Esses modelos personalizados são chamados de modelos de fluxo de trabalho de pós-processamento nesta documentação. Esses são modelos de fluxo de trabalho Experience Manager comuns.
  • Adicione as etapas de fluxo de trabalho necessárias a esses modelos. Revise as etapas do fluxo de trabalho padrão e adicione todas as etapas padrão necessárias ao fluxo de trabalho personalizado. As etapas são executadas nos ativos com base em uma configuração de modelo de fluxo de trabalho. Por exemplo, se você quiser que a marcação inteligente ocorra automaticamente no upload do ativo, adicione a etapa ao modelo de fluxo de trabalho de pós-processamento personalizado.
  • A etapa Adicionar Fluxo de trabalho do Ativo de atualização do DAM concluiu o processo no final. Adicionar esta etapa garante que o Experience Manager saiba quando o processamento termina e o ativo possa ser marcado como processado, ou seja, Novo é exibido no ativo.
  • Crie uma configuração para o Serviço de Execução de Fluxo de Trabalho Personalizado que permita configurar a execução de um modelo de fluxo de trabalho de pós-processamento por um caminho (local da pasta) ou por uma expressão regular.

Para obter detalhes sobre qual etapa do fluxo de trabalho padrão pode ser usada no fluxo de trabalho de pós-processamento, consulte etapas do fluxo de trabalho no fluxo de trabalho de pós-processamento na referência do desenvolvedor.

Criar modelos de fluxo de trabalho de pós-processamento create-post-processing-workflow-models

Os modelos de fluxo de trabalho de processamento de Post são modelos de fluxo de trabalho Experience Manager comuns. Crie modelos diferentes se precisar de processamento diferente para locais de repositório ou tipos de ativos diferentes.

As etapas de processamento são adicionadas conforme necessário. Você pode usar ambas as etapas, as etapas compatíveis que estão disponíveis e qualquer etapa de fluxo de trabalho personalizada implementada.

Verifique se a última etapa de cada fluxo de trabalho de pós-processamento é DAM Update Asset Workflow Completed Process. A última etapa ajuda a garantir que o Experience Manager saiba quando o processamento de ativos foi concluído.

Configurar a execução do workflow de pós-processamento configure-post-processing-workflow-execution

Depois que os microsserviços de ativos concluírem o processamento dos ativos carregados, você poderá definir um fluxo de trabalho de pós-processamento para processar ainda mais os ativos. Para configurar o pós-processamento usando modelos de fluxo de trabalho, siga um destes procedimentos:

Aplicar um modelo de fluxo de trabalho a uma pasta apply-workflow-model-to-folder

Para casos de uso típicos de pós-processamento, considere usar o método para aplicar um fluxo de trabalho a uma pasta. Para aplicar um modelo de fluxo de trabalho na pasta Propriedades, siga estas etapas:

  1. Crie um modelo de fluxo de trabalho.

  2. Selecione uma pasta, clique em Propriedades na barra de ferramentas e clique na guia Processamento do Assets.

  3. Em Fluxo de trabalho de início automático, selecione o fluxo de trabalho necessário, forneça um título para o fluxo de trabalho e salve as alterações.

    Aplicar um fluxo de trabalho de pós-processamento a uma pasta em suas Propriedades

Configurar o serviço Executor de fluxo de trabalho personalizado configure-custom-workflow-runner-service

Você pode configurar o serviço de execução de fluxo de trabalho personalizado para as configurações avançadas que não podem ser prontamente atendidas ao aplicar um fluxo de trabalho a uma pasta. Por exemplo, um fluxo de trabalho que usa uma expressão regular. O Adobe CQ DAM Custom Workflow Runner (com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl) é um serviço OSGi. Ela fornece as duas opções de configuração a seguir:

  • Fluxos de trabalho de processamento Post por caminho (postProcWorkflowsByPath): vários modelos de fluxo de trabalho podem ser listados, com base em caminhos de repositório diferentes. Separe caminhos e modelos usando dois-pontos. Há suporte para caminhos de repositório simples. Mapeie-os para um modelo de fluxo de trabalho no caminho /var. Por exemplo: /content/dam/my-brand:/var/workflow/models/my-workflow.
  • Fluxos de trabalho de processamento de Post por expressão (postProcWorkflowsByExpression): vários modelos de fluxo de trabalho podem ser listados, com base em diferentes expressões regulares. As expressões e os modelos devem ser separados por dois-pontos. A expressão regular deve apontar diretamente para o nó Asset e não para uma das representações ou arquivos. Por exemplo: /content/dam(/.*/)(marketing/seasonal)(/.*):/var/workflow/models/my-workflow.

Para saber como implantar uma configuração OSGi, consulte implantar em Experience Manager.

Desative a execução do workflow de pós-processamento

Quando o pós-processamento não for necessário, crie e use um Modelo de Fluxo de Trabalho "vazio" na seleção Fluxo de Trabalho de início automático.

Criar o modelo de fluxo de trabalho de início automático desativado
  1. Navegue até Ferramentas > Fluxo de trabalho > Modelos

  2. Selecione Criar > Criar modelo na barra de ações superior

  3. Forneça um título e nome para o novo Modelo de fluxo de trabalho, por exemplo:

    • Título: desativar o fluxo de trabalho de início automático
    • Nome: disable-auto-start-workflow
  4. Selecione Concluído para criar o modelo de fluxo de trabalho

  5. Selecione e Edite o Modelo de Fluxo de Trabalho criado

  6. No editor de Modelo de Fluxo de Trabalho, selecione Etapa 1 da definição de modelo e exclua-a

  7. Abra o Painel Lateral e selecione Etapas

  8. Arraste a etapa Fluxo de trabalho do ativo de atualização do DAM concluído para a definição do modelo

  9. Selecione o botão Informações da Página (ao lado da opção Painel Lateral) e selecione Abrir Propriedades

  10. Na guia Básico, selecione Fluxo de trabalho transitório

  11. Selecione Salvar e fechar na barra de ações superior

  12. Selecione Sincronizar na barra de ações superior

  13. Fechar o editor de modelo de fluxo de trabalho

Aplicar o modelo de fluxo de trabalho de início automático desativado

Siga as etapas descritas em aplicar um modelo de fluxo de trabalho a uma pasta e definir o Desabilitar Fluxo de Trabalho de Início Automático, pois o Fluxo de Trabalho de Início Automático para pastas não requer pós-processamento de ativos.

Práticas recomendadas e limitações best-practices-limitations-tips

  • Considere suas necessidades para todos os tipos de representações ao criar workflows. Se você não prever a necessidade de uma representação no futuro, remova a etapa de criação do fluxo de trabalho. As representações não podem ser excluídas em massa posteriormente. As representações indesejadas podem ocupar grandes quantidades de espaço de armazenamento após o uso prolongado de Experience Manager. Para ativos individuais, é possível remover representações manualmente da interface do usuário. Para vários ativos, você pode personalizar Experience Manager para excluir representações específicas ou excluir os ativos e carregá-los novamente.
  • No momento, o suporte está limitado à geração de representações. Não há suporte para a geração de novo ativo.
  • Atualmente, o limite de tamanho do arquivo para extração de metadados é de aproximadamente 15 GB. Ao fazer upload de ativos muito grandes, às vezes a operação de extração de metadados falha.

Consulte também

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