Usar microsserviços de ativos e perfis de processamento

Última atualização em 2023-12-05
  • Criado para:
  • Developer
    Admin

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 abrangendo mais formatos prontos para uso do que o possível com versões anteriores do Experience Manager. Por exemplo, a extração de miniaturas dos formatos PSD e PSB agora é possível, mas anteriormente era necessária a soluções de terceiros, como ImageMagick.

O processamento de ativos depende da configuração no Processamento de 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
OBSERVAÇÃO

O processamento de ativos descrito aqui substitui o DAM Update Asset modelo de fluxo de trabalho que existe 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

Experience Manager O 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 por Assets interface do usuário (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 do usuário para usar o código personalizado por meio de aplicativos personalizados para chamar Serviço 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

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 compatíveis para obter a lista completa de tipos MIME e a funcionalidade compatível com cada tipo.

Configuração padrão

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 pelo Experience Manager foi concluído em todos os ativos.

Configuração padrão

Experience Manager O fornece recursos para gerar representações mais específicas para formatos comuns de acordo com as necessidades do usuário. Um administrador pode criar Processamento de perfis para facilitar essa criação de rendiçã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 Processamento de 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, 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 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 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 Adobe InDesign profissionais criativos esperam um tempo considerável depois de terem 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. Adobe permite colocar temporariamente representações de pequeno porte no InDesign documentos para começar, que podem ser substituídos posteriormente por ativos de resolução completa sob demanda. Experience Manager O fornece representações usadas somente 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 Adobe Asset Link documentação para entender se você precisa ativá-lo para o seu 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 de administradores Ferramentas > Assets > Processamento de 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, no campo Imagem guia, ativar Criar representação FPO. Inserir um Qualidade valor de 1-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 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.

    processing-profiles-adding

  5. Clique em Salvar.

Perfil personalizado e casos de uso

A variável Asset Compute Service O 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 Asset Compute Service para estender os recursos padrão. Para ter uma visão geral, consulte entenda a extensibilidade e quando usá-la.

OBSERVAÇÃO

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 compatíveis. Experience Manager O pode chamar esses aplicativos personalizados na interface do usuário do usando perfis personalizados que os administradores configuram. Asset Compute Service O é compatível com os seguintes casos de uso de invocação de serviços externos:

  • Uso Adobe Photoshopdo API ImageCutout e salve o resultado como representação.
  • Chame sistemas de terceiros para atualizar dados, por exemplo, um sistema PIM.
  • Uso Photoshop API para gerar várias representações com base no modelo do Photoshop.
  • Uso API do Adobe Lightroom para otimizar os ativos assimilados e salvá-los como representaçõ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. Acesso de administradores Ferramentas > Assets > Processamento de 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.

    Clique em Salvar.

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

ATENÇÃO

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

Exemplo de perfil personalizado

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

custom-processing-profile

Figura: Uso Parâmetros de serviço para transmitir informações adicionadas à build de parâmetros predefinidos no aplicativo personalizado. Neste exemplo, quando as imagens da campanha são carregadas, elas 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 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 no Ferramentas > Assets > Processamento de perfis e use Aplicar perfil às pastas ação. 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 Assets, usar Propriedades ação para abrir a tela de propriedades da pasta, clique na guia Processamento de ativos e na guia Processando perfil selecione 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

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

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 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.

OBSERVAÇÃO

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 Representações no painel esquerdo. Abra a pré-visualização de ativos e abra o painel esquerdo para acessar o Representações exibição. 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.

representações adicionais

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

Workflows 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, fluxos de trabalho de pós-processamento adicionais podem ser adicionados à configuração. O pós-processamento permite adicionar processamento totalmente personalizado além do processamento configurável usando microsserviços de ativos.

Fluxos de trabalho de pós-processamento ou Fluxo de trabalho de início automático, se configurado, são executados automaticamente pelo 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 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 modelos de workflow de pós-processamento nesta documentação. Elas são regulares 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ê 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.
  • Adicionar Processo concluído do fluxo de trabalho do ativo de atualização DAM etapa no final. Adicionar essa 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

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 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

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

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 e clique em Propriedades na barra de ferramentas e 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.

    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

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 Executor de fluxo de trabalho personalizado do Adobe CQ DAM (com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl) é um serviço OSGi. Ela fornece as duas opções de configuração a seguir:

  • Workflows 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. Há suporte para caminhos de repositório simples. Mapeie-os para um modelo de fluxo de trabalho na /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. 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 Fluxo de trabalho de início automático seleção.

Criar o modelo de fluxo de trabalho de início automático desativado
  1. Navegue até Ferramentas > Fluxo de trabalho > Modelos
  2. Selecionar Criar > Criar modelo formar a barra de ação 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. Selecionar Concluído para criar o modelo de fluxo de trabalho
  5. Selecionar e Editar o modelo de fluxo de trabalho criado
  6. No editor de Modelo de fluxo de trabalho, selecione Etapa 1 da definição do modelo e exclua-o
  7. Abra o Painel lateral e selecione Etapas
  8. Arraste o Fluxo de trabalho do Ativo de atualização DAM concluído entrar na definição do modelo
  9. Selecione o Informações da página (ao lado do botão Painel lateral alterne) e selecione Abrir propriedades
  10. No Básico selecione Fluxo de trabalho transitório
  11. Selecionar Salvar e fechar na barra de ação superior
  12. Selecionar Sincronizar na barra de ação 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 defina o Desabilitar Fluxo de Trabalho de Início Automático como o Fluxo de trabalho de início automático para pastas não exigem pós-processamento de ativos.

Práticas recomendadas e limitações

  • 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 renderizaçõ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, é possível 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

Nesta página