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.
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.
- 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.
- Representação FPO.
- Alterar formato de arquivo e resolução de imagens
- Aplicar condicionalmente a tipos de arquivos configurados.
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:
-
Os administradores acessam Ferramentas > Assets > Processando Perfis. Clique em Criar.
-
Forneça um nome que ajude a identificar exclusivamente o perfil ao aplicar a uma pasta.
-
Para gerar representações FPO, na guia Imagem, habilite Criar Representação FPO. Insira um valor de Qualidade de 1-100.
-
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.
-
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.
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.
Criar um perfil personalizado create-custom-profile
Para criar um perfil personalizado, siga estas etapas:
-
Os administradores acessam Ferramentas > Assets > Processando Perfis. Clique em Criar.
-
Clique na guia Personalizado. Clique em Adicionar novo. Forneça o nome de arquivo desejado para a representação.
-
Forneça as seguintes informações.
- Nome de arquivo de cada representação e uma extensão de arquivo compatível.
- URL do ponto de extremidade de um aplicativo personalizado do App Builder. O aplicativo deve ser da mesma organização da conta Experience Manager.
- Adicionar Parâmetros de Serviço a passar informações extras ou parâmetros para o 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 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.
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.
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.
-
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
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.
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.
Figura: Exemplo de duas representações adicionais geradas por um perfil de processamento aplicado à pasta pai.
Workflows de pós-processamento 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 pós-processamento permite adicionar processamento totalmente personalizado além do processamento configurável usando microsserviços de ativos.
Os fluxos de trabalho de pós-processamento 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 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 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:
-
Crie um modelo de fluxo de trabalho.
-
Selecione uma pasta, clique em Propriedades na barra de ferramentas e clique na guia Processamento do Assets.
-
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 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 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 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 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
-
Navegue até Ferramentas > Fluxo de trabalho > Modelos
-
Selecione Criar > Criar modelo na barra de ações superior
-
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
-
Selecione Concluído para criar o modelo de fluxo de trabalho
-
Selecione e Edite o Modelo de Fluxo de Trabalho criado
-
No editor de Modelo de Fluxo de Trabalho, selecione Etapa 1 da definição de modelo e exclua-a
-
Abra o Painel Lateral e selecione Etapas
-
Arraste a etapa Fluxo de trabalho do ativo de atualização do DAM concluído para a definição do modelo
-
Selecione o botão Informações da Página (ao lado da opção Painel Lateral) e selecione Abrir Propriedades
-
Na guia Básico, selecione Fluxo de trabalho transitório
-
Selecione Salvar e fechar na barra de ações superior
-
Selecione Sincronizar na barra de ações superior
-
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
- Traduzir ativos
- API HTTP de ativos
- Formatos de arquivo compatíveis com os ativos
- Pesquisar ativos
- Ativos conectados
- Relatórios de ativos
- Esquemas de metadados
- Baixar ativos
- Gerenciar metadados
- Pesquisar aspectos
- Gerenciar coleções
- Importação de metadados em massa
- Publish Assets para AEM e Dynamic Media