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 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.
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 get-started
Experience Manager O permite os seguintes níveis de processamento.
- 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.
- 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 compatíveis para obter a lista completa de tipos MIME e a funcionalidade compatível com 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 pelo Experience Manager foi concluído em todos os ativos.
Configuração padrão standard-config
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 create-standard-profile
Para criar um perfil de processamento padrão, siga estas etapas:
-
Acesso de administradores Ferramentas > Assets > Processamento de 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, no campo Imagem guia, ativar Criar representação FPO. Inserir um Qualidade valor de 1-100.
-
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.
-
Clique em Salvar.
Perfil personalizado e casos de uso custom-config
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.
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.
Criar um perfil personalizado create-custom-profile
Para criar um perfil personalizado, siga estas etapas:
-
Acesso de administradores Ferramentas > Assets > Processamento de perfis. Clique em Criar.
-
Clique em Personalizado guia. 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 ao passar informações ou parâmetros extras 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 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.
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 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.
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 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 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.
-
Os usuários podem selecionar pastas ou ativos específicos na interface do Assets para aplicar um perfil de processamento e 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 é executado em adição ao do perfil padrão.
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.
Figura: exemplo de duas representações adicionais geradas por um perfil de processamento aplicado à pasta principal.
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.
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 create-post-processing-workflow-models
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 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 e clique em Propriedades na barra de ferramentas e clique em Processamento de ativos guia.
-
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 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
-
Navegue até Ferramentas > Fluxo de trabalho > Modelos
-
Selecionar Criar > Criar modelo formar a barra de ação 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
-
Selecionar Concluído para criar o modelo de fluxo de trabalho
-
Selecionar e Editar o modelo de fluxo de trabalho criado
-
No editor de Modelo de fluxo de trabalho, selecione Etapa 1 da definição do modelo e exclua-o
-
Abra o Painel lateral e selecione Etapas
-
Arraste o Fluxo de trabalho do Ativo de atualização DAM concluído entrar na definição do modelo
-
Selecione o Informações da página (ao lado do botão Painel lateral alterne) e selecione Abrir propriedades
-
No Básico selecione Fluxo de trabalho transitório
-
Selecionar Salvar e fechar na barra de ação superior
-
Selecionar Sincronizar na barra de ação 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 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 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 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