Usar microsserviços de ativos e perfis de processamento

Os microsserviços de ativos oferecem 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 gama de tipos de arquivos cobrindo mais formatos prontos para uso do que o possível com versões anteriores de Experience Manager. Por exemplo, a extração em miniatura de formatos PSD e PSB agora é possível que tenha exigido anteriormente soluções de terceiros, como o ImageMagick.

O processamento de ativos depende da configuração em Perfis de processamento. O Experience Manager oferece uma configuração básica padrão 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 a personalização opcional. Personalizar os fluxos de trabalho permite que os desenvolvedores estendam a oferta padrão.

Uma visão de alto nível do

OBSERVAÇÃO

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

Entender as opções de processamento de ativos

O Experience Manager permite os seguintes níveis de processamento.

Opção Descrição Casos de uso cobertos
Configuração padrão Está disponível como está e não pode ser modificado. Essa configuração fornece recursos de geração de representação muito básicos.
  • Miniaturas padrão usadas pela interface do usuário Assets (48, 140 e 319 pixels)
  • Visualização grande (renderização da Web - 1280 pixels)
  • Metadados e extração de texto.
Configuração personalizada Configurado pelos administradores pela 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 de FPO.
  • Alterar o formato do arquivo e a resolução das imagens
  • Aplicar condicionalmente a tipos de arquivo configurados.
Perfil personalizado Configurado pelos administradores pela interface do usuário para usar o código personalizado por meio de aplicativos personalizados para chamar Asset compute Service. Suporta requisitos mais complexos em um método nativo em nuvem e dimensionável. Consulte casos de uso permitidos.

Formatos de arquivo não suportados

Os microsserviços de ativos oferecem suporte para uma grande variedade de formatos de arquivo para processar, gerar representações ou extrair metadados. Consulte formatos de arquivo suportados para obter a lista completa de tipos MIME e a funcionalidade suportada para cada tipo.

Configuração padrão

Alguns padrões são pré-configurados para garantir que as renderizaçõ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. Esse 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

Experience Manager forneça 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. Em seguida, os usuários atribuem um ou mais perfis disponíveis a pastas específicas para realizar 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, que 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 de pixel do original.

  • Regras de inclusão do 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 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 corresponder à lista, a representação será gerada (lista de permissões).

  • Representação especial de FPO: Ao colocar ativos de grande porte Experience Manager em Adobe InDesign documentos, um profissional criativo aguarda por um tempo substancial após colocar um ativo. Enquanto isso, o usuário está bloqueado de usar InDesign. Isso interrompe o fluxo criativo e afeta negativamente a experiência do usuário. O Adobe permite colocar temporariamente representações de pequeno porte em documentos InDesign para começar, o que pode ser substituído por ativos de resolução completa sob demanda posteriormente. Experience Manager O fornece representações que são usadas somente para posicionamento (FPO). Essas renderizações de 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 Adobe Asset Link documentação para entender se você precisa ativá-la para seu perfil de processamento. Para obter mais informações, consulte a documentação completa do Adobe Asset Link.

Criar um perfil padrão

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

  1. Os administradores acessam Ferramentas > Ativos > Perfis de processamento. Clique em Criar.

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

  3. Para gerar representações FPO, na guia Standard, ative Criar representação FPO. Insira um valor Quality entre 1 e 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 renderização.
    • Largura e altura em pixels de cada representação. Se os valores não forem especificados, será usado o tamanho total de pixel da imagem original.
    • Qualidade em porcentagem de cada renderização JPEG e WebP.
    • Tipos MIME incluídos e excluídos para definir a aplicabilidade de um perfil.

    perfis de processamento-adição

  5. Clique em Salvar.

Perfil personalizado e casos de uso

O Asset Compute Service é compatível com uma variedade de casos de uso, como processamento padrão, 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 DAM necessária no passado é manipulada automaticamente ou por meio da configuração de perfis de processamento. Se as necessidades comerciais não forem atendidas por essas opções de processamento, a Adobe recomenda desenvolver e usar Asset Compute Service para estender os recursos padrão. Para obter uma visão geral, consulte compreender extensibilidade e quando usá-la.

OBSERVAÇÃO

O Adobe recomenda usar um aplicativo personalizado somente quando os requisitos comerciais não puderem ser alcançados 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 suportados. Experience Manager O pode chamar esses aplicativos personalizados da interface do usuário usando perfis personalizados configurados pelos administradores. Asset Compute Service O suporta os seguintes casos de uso de invocar serviços externos:

OBSERVAÇÃO

Não é possível editar os metadados padrão usando os aplicativos personalizados. Você só pode modificar metadados personalizados.

Criar um perfil personalizado

Para criar um perfil personalizado, siga estas etapas:

  1. Os administradores acessam Ferramentas > Ativos > Perfis de processamento. 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 sem cabeçalho Project Firefly. O aplicativo personalizado obtém todos os arquivos fornecidos se eles estiverem configurados com um perfil de processamento. O aplicativo deve filtrar os arquivos.

CUIDADO

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

Um exemplo de um perfil personalizado

Para ilustrar o uso do perfil personalizado, vamos considerar um caso de uso para aplicar texto personalizado às imagens da campanha. Você pode criar um perfil de processamento que aproveite a API do Photoshop para editar as imagens.

A integração do Asset compute Service permite que o Experience Manager transmita esses parâmetros para o aplicativo personalizado usando o campo Parâmetros de Serviço. O aplicativo personalizado chama a API do Photoshop e transmite esses valores para a API. Por exemplo, é possível passar o nome da fonte, a cor do texto, o peso do texto e o tamanho do texto para adicionar o texto personalizado às imagens da campanha.

perfil de processamento personalizado

Figura: Use o campo Service Parameters para transmitir informações adicionais para parâmetros predefinidos incorporados no aplicativo personalizado. Neste exemplo, quando imagens de campanha são carregadas, as imagens são atualizadas com o texto Jumanji na fonte Arial-BoldMT.

Use perfis de processamento para processar ativos

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 integrado é sempre executado, mas não é visível na interface do usuário. 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 > Ativos > Perfis de processamento e usar a ação Aplicar perfil à(s) pasta(s). Ele abre um navegador de conteúdo que permite navegar para pastas específicas, selecioná-las e confirmar o aplicativo 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 Perfis de processamento e, na lista pop-up, 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 na guia Propriedades do ativo
DICA

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 subpasta dela são processados usando o perfil de processamento adicional configurado. Esse processamento está além do perfil padrão.

OBSERVAÇÃO

Um perfil de processamento aplicado a uma pasta funciona para a árvore inteira, mas pode ser substituído por outro perfil aplicado a uma subpasta. Quando os ativos são carregados em uma pasta, o Experience Manager verifica as propriedades da pasta contêiner em busca de um perfil de processamento. Se nenhuma for aplicada, uma pasta pai na hierarquia será verificada em busca de um perfil de processamento a ser aplicado.

Para verificar se os ativos são processados, visualize as representações geradas na visualização Representações no painel esquerdo. Abra a visualização de ativos e abra o painel à esquerda para acessar a visualizaçã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 ser visíveis e acessíveis.

representações adicionais

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

Fluxos de trabalho de pós-processamento

Para uma situação em que é necessário um processamento adicional de ativos que não pode ser obtido usando os perfis de processamento, é possível adicionar mais workflows pós-processamento à configuração. Isso permite adicionar processamento totalmente personalizado sobre o processamento configurável usando microsserviços de ativos.

Os workflows de pós-processamento, se configurados, são executados automaticamente por Experience Manager após a conclusão do processamento de microsserviços. Não há necessidade de adicionar iniciadores de fluxo de trabalho manualmente para acionar os fluxos de trabalho. Os exemplos incluem:

  • Etapas de fluxo de trabalho personalizadas 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 workflow de pós-processamento a Experience Manager, siga estas etapas:

  • Crie um ou mais modelos de fluxo de trabalho. Esses modelos personalizados são chamados de pós-processamento de modelos de fluxo de trabalho 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ê deseja que a marcação inteligente ocorra automaticamente após o upload do ativo, adicione a etapa ao modelo de fluxo de trabalho de pós-processamento personalizado.
  • Adicione a etapa Fluxo de trabalho de ativos de atualização do DAM concluída Processo no final. Adicionar essa etapa garante que o Experience Manager saiba quando o processamento termina e o ativo pode ser marcado como processado, ou seja, New é exibido no ativo.
  • Crie uma configuração para o Custom Workflow Runner Service que permite 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.

Criar modelos de fluxo de trabalho de pós-processamento

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

As etapas de processamento devem ser adicionadas com base nas necessidades. Você pode usar qualquer etapa suportada disponível, bem como qualquer etapa de fluxo de trabalho implementada por personalização.

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

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

Para configurar os modelos de fluxo de trabalho de pós-processamento a serem executados para ativos carregados ou atualizados no sistema após a conclusão do processamento dos microsserviços de ativos, o serviço Custom Workflow Runner precisa ser configurado.

O Adobe CQ DAM Custom Workflow Runner (com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl) é um serviço OSGi e fornece duas opções para configuração:

  • Fluxos de trabalho de pós-processamento por caminho (postProcWorkflowsByPath): Vários modelos de fluxo de trabalho podem ser listados, com base em caminhos de repositório diferentes. Caminhos e modelos devem ser separados por dois pontos. Caminhos de repositório simples são suportados e devem ser mapeados 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 pós-processamento 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 para o nó do ativo diretamente, e não para uma das representações ou arquivos. Por exemplo: /content/dam(/.*/?lang=pt-BR)(marketing/seasonal)(/.*?lang=pt-BR):/var/workflow/models/my-workflow.
OBSERVAÇÃO

A configuração do Executor de Fluxo de Trabalho Personalizado é uma configuração de um serviço OSGi. Consulte implantar no Experience Manager para obter informações sobre como implantar uma configuração OSGi.
O console da Web OSGi, ao contrário das implantações locais e de serviços gerenciados de Experience Manager, não está disponível diretamente nas implantações do serviço de nuvem.

Para obter detalhes sobre qual etapa de 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.

Práticas recomendadas e limitações

  • Considere suas necessidades para todos os tipos de representações ao projetar fluxos de trabalho. Se você não prever a necessidade de uma representação no futuro, remova sua 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 muito espaço de armazenamento após o uso prolongado de Experience Manager. Para ativos individuais, você pode remover as renderizaçõ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.
  • Atualmente, 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 10 GB. Ao fazer upload de ativos muito grandes, às vezes a operação de extração de metadados falha.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now