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 um grande variedade de tipos de arquivos cobrindo mais formatos prontos para uso do que o possível com versões anteriores do Experience Manager. Por exemplo, a extração em miniatura de formatos PSD e PSB agora é possível, mas era exigida anteriormente por soluções de terceiros, como ImageMagick.

O processamento de ativos depende da configuração em Processando perfis. 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.

Compreender as opções de processamento de ativos

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

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 compatíveis 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 é concluída 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 Processando perfis para facilitar essa criação de rendições. 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 Processando perfis 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 da Experience Manager em Adobe InDesign documentos, um profissional criativo espera por um tempo substancial depois que 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 no InDesign documentos para começar, que podem ser substituídos 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 é necessário ativá-lo para o perfil de processamento. Para obter mais informações, consulte Documentação completa do Adobe Asset Link.

Criar um perfil padrão

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

1. Acesso dos administradores Ferramentas > Ativos > Processando perfis. 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, no Imagem guia , habilitar Criar representação FPO. Insira um Qualidade entre 1 e 100.

4. Para gerar outras representações, clique em Adicionar novo e fornecer 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 JPEG e renderização de WebP.
   • Tipos MIME incluídos e excluídos para definir a aplicabilidade de um perfil.

   

5. Clique em Salvar.

Perfil personalizado e casos de uso

O Asset Compute Service O suporta 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, o Adobe recomenda desenvolver e usar Asset Compute Service para estender os recursos padrão. Para obter uma visão geral, consulte entenda a extensibilidade e quando usá-la.

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:

• Use Adobe Photoshop's API ImageCutout e salve o resultado como representação.
• Chame sistemas de terceiros para atualizar dados, por exemplo, um sistema PIM.
• Use Photoshop API para gerar várias representações com base no modelo do Photoshop.
• Use API do Adobe Lightroom para otimizar os ativos assimilados e salvá-los como representações.

Criar um perfil personalizado

Para criar um perfil personalizado, siga estas etapas:

1. Acesso dos administradores Ferramentas > Ativos > Processando perfis. Clique em Criar.

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

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

   • Nome do arquivo de cada renderização e uma extensão de arquivo compatível.
   • URL de ponto final de um aplicativo personalizado Firefly. O aplicativo deve ser da mesma organização da conta do Experience Manager.
   • Adicionar parâmetros de serviço a transmitir informações ou parâmetros adicionais ao aplicativo personalizado.
   • Tipos MIME incluídos e excluídos para limitar o processamento a alguns formatos de arquivo específicos.

   Clique em Salvar.

Os aplicativos personalizados não têm cabeça Projeto Firefly aplicativos. O aplicativo personalizado obtém todos os arquivos fornecidos se eles estiverem configurados com um perfil de processamento. O aplicativo deve filtrar os arquivos.

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 Parâmetros de serviço campo. 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.

Figura: Use Parâmetros de serviço para transmitir informações adicionadas aos parâmetros predefinidos criados no aplicativo personalizado. Neste exemplo, quando imagens da campanha são carregadas, as imagens são atualizadas com Jumanji texto em 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 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 > Processando perfis e use Aplicar perfil às pastas ação. 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 Propriedades para abrir a tela de propriedades da pasta, clique no botão Processamento de ativos e na guia Perfil de processamento selecione o perfil de processamento apropriado para essa pasta. Para salvar as alterações, clique em Salvar e fechar.
  

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

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 está além do perfil padrão.

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

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. O pós-processamento permite que você adicione 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 fluxo de trabalho de pós-processamento ao Experience Managersiga 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 Experience Manager modelos de fluxo de trabalho.
• 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.
• Adicionar Processo Concluído do Fluxo de Trabalho de Ativos de Atualização 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 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.

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.

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

Os modelos de fluxo de trabalho de pós-processamento são regulares Experience Manager modelos de fluxo de trabalho. 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 e todas as etapas de fluxo de trabalho implementadas de forma personalizada.

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

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, você pode executar um dos seguintes procedimentos:

• Aplicar um modelo de fluxo de trabalho em Propriedades da pasta.
• Configurar o serviço de Execução de Fluxo de Trabalho Personalizado.

Aplicar um modelo de fluxo de trabalho a uma pasta

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 Propriedadessiga estas etapas:

1. Crie um modelo de fluxo de trabalho.

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

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.

   

Configurar o serviço de Execução de Fluxo de Trabalho Personalizado

Você pode configurar o serviço de execução do fluxo de trabalho personalizado para as configurações avançadas que não podem ser cumpridas aplicando um fluxo de trabalho a uma pasta. Por exemplo, um workflow 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 a seguir 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. Separe caminhos e modelos usando dois pontos. Caminhos de repositório simples são compatíveis. Mapeie-os para um modelo de fluxo de trabalho na /var caminho. 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(/.*/)(marketing/seasonal)(/.*):/var/workflow/models/my-workflow.

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

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 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 15 GB. Ao fazer upload de ativos muito grandes, às vezes a operação de extração de metadados falha.