Use asset microservices and processing profiles

Os microserviços de ativos fornecem processamento escalonável e resiliente de ativos usando aplicativos nativos na nuvem (também chamados de trabalhadores). O Adobe gerencia os serviços para uma manipulação otimizada de diferentes tipos de ativos e opções de processamento.

Os microserviços de ativos permitem que você processe uma ampla variedade de tipos de arquivos que abrangem mais formatos prontos para uso do que o que é possível com versões anteriores do Experience Manager. Por exemplo, a extração em miniatura dos formatos PSD e PSB agora é possível e exigia soluções de terceiros como o ImageMagick.

O processamento de ativos depende da configuração em Perfis de processamento. 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 de workflows de pós-processamento, incluindo personalização opcional. Personalizar os workflows permite que os desenvolvedores estendam a oferta padrão.

Uma visualização de alto nível de

Observação

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

Compreender as opções de processamento de ativos

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 execução muito básicos.
  • Miniaturas padrão usadas pela interface Assets do usuário (48, 140 e 319 pixels)
  • Pré-visualização grande (execução na Web - 1280 pixels)
  • Metadados e extração de texto.
Configuração personalizada Configurado pelos administradores por meio da interface do usuário. Fornece mais opções para a geração de representação estendendo a opção padrão. Estenda a opção predefinida para fornecer diferentes formatos e execuções.
  • Execução FPO.
  • Alterar o formato e a resolução das imagens
  • Aplica-se condicionalmente aos tipos de arquivos configurados.
Perfil personalizado Configurado pelos administradores por meio da interface do usuário para usar o código personalizado por meio de aplicativos personalizados para chamar o Serviço deAsset computes. Suporta requisitos mais complexos em um método nativo de nuvem e dimensionável. Consulte casos de usopermitidos.

Formatos de arquivo não suportados

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

Configuração padrão

Alguns padrões são pré-configurados para garantir que as execuçõ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 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 é 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 ele seja concluído em todos os ativos.

Configuração padrão

Experience Manager forneça recursos para gerar renderizaçõ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 a criação dessa execução. Em seguida, os usuários atribuem um ou mais dos 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 execuçõ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 microserviços de ativos tentam produzir a maior representação possível, que a largura e a altura não são maiores que a largura e a altura especificadas, respectivamente. A proporção é preservada, é 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 pela primeira vez 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 ele corresponder à lista, a representação será gerada (lista de permissões).

  • Representação especial do FPO: Ao colocar ativos de grande porte de Experience Manager dentro de Adobe InDesign documentos, um profissional criativo espera por um tempo substancial depois de colocar um ativo. Enquanto isso, o usuário está impedido de usar InDesign. Isso interrompe o fluxo criativo e afeta negativamente a experiência do usuário. O Adobe permite que as execuções de pequeno porte sejam colocadas temporariamente em InDesign documentos para começar, o que pode ser substituído por ativos de resolução completa sob demanda posteriormente. Experience Manager fornece execuções que são usadas apenas para posicionamento (FPO). Essas renderizações FPO têm um tamanho de arquivo pequeno, mas têm a mesma proporção.

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

Criar 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 o ajude a identificar exclusivamente o perfil ao se inscrever em uma pasta.

  3. Para gerar execuções de FPO, na guia Padrão , ative Criar representação de FPO. Insira um valor de Qualidade entre 1 e 100.

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

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

    adição de perfis de processamento

  5. Clique em Salvar.

Perfil personalizado e casos de uso

O Asset Compute Service oferece suporte a 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 do DAM necessária no passado é feita automaticamente ou pela configuração de perfis de processamento. Se as necessidades da empresa 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 entender a extensibilidade e quando usá-la.

Observação

A Adobe recomenda usar um aplicativo personalizado somente quando os requisitos comerciais não podem 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 para Asset Compute Service criar aplicativos personalizados que atendam aos casos de uso suportados. Experience Manager pode chamar esses aplicativos personalizados da interface do usuário usando perfis personalizados configurados pelos administradores. Asset Compute Service apoia os seguintes casos de utilização de serviços externos:

  • Use Adobe Photoshopa API ImageCutout da e salve o resultado como execução.
  • Chame sistemas de terceiros para atualizar dados, por exemplo, um sistema PIM.
  • Use a Photoshop API para gerar várias execuções com base no modelo da Photoshop.
  • Use a API Adobe Lightroom para otimizar os ativos assimilados e salvá-los como execuções.
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 do Project Firefly sem cabeçalho. 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 Experience Manager conta não forem da mesma organização, a integração não funcionará.

Um exemplo de um perfil personalizado

Para ilustrar o uso personalizado de perfis, considere um caso de uso para aplicar algum texto personalizado a imagens de campanha. Você pode criar um perfil de processamento que aproveita a API do Photoshop para editar as imagens.

A integração com o Serviço de asset compute permite que o Experience Manager passe esses parâmetros para o aplicativo personalizado usando o campo Parâmetros de serviço. O aplicativo personalizado então 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 de campanha.

perfil de processamento personalizado

Figura: Use o campo Parâmetros de serviço para passar informações adicionadas para parâmetros predefinidos criados no aplicativo personalizado. Neste exemplo, quando imagens de campanha são carregadas, as imagens são atualizadas com Jumanji texto na Arial-BoldMT fonte.

Usar 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 o processamento de ativos carregados ou atualizados nessas pastas. O perfil padrão de processamento padrão incorporado é 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 > Processamento de Perfis e usar a ação Aplicar Perfil às pastas . Ele abre um navegador de conteúdo que permite navegar para pastas específicas, selecioná-las e confirmar o aplicativo do perfil.
  • Users can select a folder in the Assets user interface, use Properties action to open folder properties screen, click on the Processing Profiles tab, and in the popup list, select the appropriate processing profile for that folder. Para salvar as alterações, clique em Salvar e fechar.
    Aplicar o 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 execuções, adicione mais definições de execuçã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 é adicionado ao 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 que os contém para verificar se há um perfil de processamento. Se nenhum for aplicado, uma pasta pai na hierarquia será verificada para que um perfil de processamento seja aplicado.

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

execuções adicionais

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

Workflows de pós-processamento

Para situações em que é necessário um processamento adicional de ativos que não pode ser obtido usando os perfis de processamento, workflows adicionais pós-processamento podem ser adicionados à configuração. Isso permite adicionar processamento totalmente personalizado sobre o processamento configurável usando os microserviços de ativos.

Os workflows de pós-processamento, se configurados, são executados automaticamente por AEM após a conclusão do processamento dos microserviços. Não há necessidade de adicionar iniciadores de fluxo de trabalho manualmente para acioná-los. 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 sobre produtos ou processos.
  • Processamento adicional feito por serviços externos.

A adição de uma configuração de fluxo de trabalho de pós-processamento ao Experience Manager é composta das seguintes etapas:

  • Crie um ou mais modelos de fluxo de trabalho. Os documentos o mencionam como modelos de fluxo de trabalho de pós-processamento, mas esses são modelos comuns de fluxo de trabalho de Experience Manager.
  • Adicione etapas específicas do fluxo de trabalho a esses modelos. As etapas são executadas nos ativos com base em uma configuração de modelo de fluxo de trabalho.
  • Adicione a etapa Processo Concluído do Fluxo de Trabalho de Atualização de Ativo do DAM no final. Adicionar essa etapa garante que o Experience Manager saiba quando o processamento termina e que o ativo pode 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 (localização 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 modelos regulares de fluxo de trabalho AEM. 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 quaisquer etapas compatíveis disponíveis, bem como quaisquer etapas de fluxo de trabalho implementadas por personalização.

Verifique se a última etapa de cada workflows de pós-processamento está 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 fluxo de trabalho 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 microserviços de ativos, o serviço do Custom Workflow Runner precisa ser configurado.

O serviço de Executador de Fluxo de Trabalho Personalizado (com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl) é um serviço OSGi e fornece duas opções para configuração:

  • Workflows de pós-processamento por caminho (postProcWorkflowsByPath): Vários modelos de fluxo de trabalho podem ser listados, com base em diferentes caminhos de repositório. 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 /var caminho. Por exemplo: /content/dam/my-brand:/var/workflow/models/my-workflow.
  • Workflows 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. Expressões e modelos devem ser separados por dois pontos. A expressão regular deve apontar diretamente para o nó Ativo, e não para uma das execuções ou arquivos. Por exemplo: /content/dam(/.*/)(marketing/seasonal)(/.*):/var/workflow/models/my-workflow.
Observação

A configuração do Custom Workflow Runner é 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 de serviços no local e gerenciados de AEM, não está disponível diretamente nas implantações de serviços em 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 as 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 execuções ao projetar 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 execuções não podem ser excluídas em massa depois. As representações indesejadas podem ocupar muito espaço no armazenamento após uso prolongado de Experience Manager. Para ativos individuais, você pode remover execuçõ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 execuções. Não há suporte para a geração de novo ativo.

Nesta página