Baixar ativos de Adobe Experience Manager download-assets-from-aem

Versão
Link do artigo
AEM 6.5
Clique aqui
AEM as a Cloud Service
Este artigo

É possível baixar ativos, incluindo representações estáticas e dinâmicas. Como alternativa, você pode enviar emails com links para ativos diretamente do Adobe Experience Manager Assets. Os ativos baixados são incluídos em um arquivo ZIP.

Os seguintes tipos de ativos não podem ser baixados: Conjuntos de imagens, Conjuntos de rotação, Conjuntos de mídia mista e Conjuntos de carrossel.

Você pode baixar ativos do Experience Manager usando os seguintes métodos:

Baixar ativos usando a interface Experience Manager download-assets

O Experience Manager otimiza a experiência de download com base na quantidade e no tamanho do ativo. Arquivos menores são baixados da interface do usuário em tempo real. O Experience Manager baixa diretamente solicitações de ativos únicos para o arquivo original, em vez de colocar ativos únicos em um arquivo ZIP para permitir downloads mais rápidos. O Experience Manager suporta downloads grandes com solicitações assíncronas. As solicitações de download maiores que 100 GB são divididas em vários arquivos ZIP com um tamanho máximo de 100 MB cada.

Por padrão, Experience Manager aciona uma notificação na Experience Manager Caixa de Entrada ao gerar um arquivo de download.

Notificação da Caixa de entrada

Ativar notificações por email para downloads grandes enable-emails-for-large-downloads

Os downloads assíncronos são acionados em qualquer um dos seguintes casos:

  • Se houver mais de dez ativos
  • Se o tamanho do download for superior a 100 MB
  • Se o download levar mais de 30 segundos para se preparar

Enquanto o download assíncrono é executado no back-end, o usuário pode continuar a explorar e trabalhar mais no Experience Manager. Além das notificações da caixa de entrada de Experience Manager, o Experience Manager pode enviar emails para notificar o usuário após concluir o processo de download. Para habilitar este recurso, os administradores podem configurar o serviço de email configurando uma conexão de servidor SMTP.

Depois que o serviço de email é configurado, os administradores e usuários podem ativar notificações por email na interface do Experience Manager.

Para ativar notificações por email:

  1. Faça logon em Experience Manager Assets.

  2. Clique no ícone do usuário no canto superior direito e em Minhas Preferências para abrir a janela Preferências do Usuário.

  3. Marque a caixa de seleção Notificações por email de download de ativos e clique em Aceitar.

    habilitar-email-notificações-para-downloads-grandes

Para baixar ativos, siga estas etapas:

  1. Na interface de usuário do Experience Manager, clique em Assets > Arquivos.

  2. Navegue até os ativos que deseja baixar. Selecione a pasta ou selecione um ou mais ativos na pasta. Na barra de ferramentas, clique em Baixar.

    Opções disponíveis ao baixar ativos de Experience Manager Assets

  3. Na caixa de diálogo de download, selecione as opções de download desejadas.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    Opção de download Descrição
    Criar uma pasta separada para cada ativo Selecione essa opção para criar uma pasta para cada ativo que contenha todas as representações baixadas do ativo. Se não estiver selecionada, cada ativo (e suas representações, se selecionado para download) estará contido na pasta principal do arquivo gerado.
    Email

    Selecione essa opção para enviar uma notificação por email (contendo um link para o download) para outro usuário. O usuário destinatário deve ser membro do grupo dam-users. Os modelos padrão de email estão disponíveis nos seguintes locais:

    • /libs/settings/dam/workflow/notification/email/downloadasset.
    • /libs/settings/dam/workflow/notification/email/transientworkflowcompleted.

    Os modelos que você personaliza durante a implantação estão disponíveis nos seguintes locais:

    • /apps/settings/dam/workflow/notification/email/downloadasset.
    • /apps/settings/dam/workflow/notification/email/transientworkflowcompleted.

    Você pode armazenar modelos personalizados específicos do locatário nos seguintes locais:

    • /conf/<tenant_specific_config_root>/settings/dam/workflow/notification/email/downloadasset.
    • /conf/<tenant_specific_config_root>/settings/dam/workflow/notification/email/transientworkflowcompleted.
    Ativo(s) Selecione essa opção para baixar o ativo em sua forma original.
    A opção de subativos estará disponível se o ativo original tiver subativos.
    Representação(ões) Uma representação é a representação binária de um ativo. O Assets tem uma representação principal - a do arquivo carregado. Eles podem ter qualquer número de representações.
    Com essa opção, você pode selecionar as representações que deseja baixar. As representações disponíveis dependem do ativo selecionado.
    Recortes inteligentes Selecione esta opção para baixar todas as representações de corte inteligente do ativo selecionado no Experience Manager. Um arquivo zip com as representações de Recorte inteligente é criado e baixado no computador local.
    Representação(ões) Dinâmica(s) Selecione essa opção para gerar uma série de representações alternativas em tempo real. Ao selecionar essa opção, você também seleciona as representações que deseja criar dinamicamente, selecionando na lista Predefinição de imagem.
    Além disso, você pode selecionar o tamanho e a unidade de medida, o formato, o espaço de cores, a resolução e qualquer modificador de imagem opcional, como a inversão da imagem. A opção só estará disponível se você tiver o Dynamic Media habilitado.
  4. Na caixa de diálogo, clique em Baixar.

    Se a notificação por email estiver ativada para downloads grandes, um email contendo um URL de download da pasta zip arquivada será exibido em sua caixa de entrada. Clique no link de download no email para baixar o arquivo zip.

    notificações por email para downloads grandes

    Você também pode exibir a notificação em sua Caixa de Entrada do Experience Manager.

    caixa de entrada-notificações-para-downloads-grandes

O compartilhamento de ativos usando um link é uma maneira conveniente de disponibilizá-lo às pessoas interessadas sem que elas precisem fazer logon no Assets. Consulte funcionalidade de Compartilhamento de Links.

Quando os usuários baixam ativos de links compartilhados, o Assets usa um serviço assíncrono que oferece downloads mais rápidos e ininterruptos. Os ativos a serem baixados são enfileirados em segundo plano em uma caixa de entrada em arquivos ZIP de tamanho de arquivo gerenciável. Para downloads maiores, o download é dividido em arquivos de 100 GB.

A Caixa de Entrada de Download exibe o status de processamento de cada arquivo. Quando o processamento estiver concluído, você poderá baixar os arquivos da caixa de entrada.

Baixar caixa de entrada

Ativar o servlet de download de ativos enable-asset-download-servlet

O servlet padrão em Experience Manager permite que usuários autenticados emitam arbitrariamente grandes solicitações de download simultâneas para criar arquivos ZIP de ativos. A preparação do download pode ter implicações de desempenho ou pode até sobrecarregar o servidor e a rede. Para mitigar esses possíveis riscos semelhantes ao DoS causados por esse recurso, o componente OSGi AssetDownloadServlet é desabilitado para instâncias de publicação. Se você não precisar do recurso de download nas instâncias do autor, desative o servlet no autor.

Para permitir o download de ativos do seu DAM, ao usar algo como o Asset Share Commons ou outra implementação semelhante a um portal, ative manualmente o servlet por meio de uma configuração OSGi. A Adobe recomenda definir o tamanho permitido do download o mais baixo possível, sem afetar os requisitos diários de download. Um valor alto pode afetar o desempenho.

  1. Crie uma pasta com uma convenção de nomenclatura que direcione ao modo de execução de publicação, ou seja, config.publish:

    /apps/<your-app-name>/config.publish

  2. Na pasta de configuração, crie um arquivo do tipo nt:file chamado com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config.

  3. Preencha com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config com o seguinte. Define um tamanho máximo (em bytes) para o download como o valor de asset.download.prezip.maxcontentsize. O exemplo abaixo configura o tamanho máximo do download do ZIP para não exceder 100 KB.

    code language-java
    enabled=B"true"
    asset.download.prezip.maxcontentsize=I"102400"
    

Desativar o servlet de download de ativos disable-asset-download-servlet

Se você não precisar da funcionalidade de download, desative o servlet para evitar riscos semelhantes ao DoS. O Asset Download Servlet pode ser desativado em instâncias de autor e publicação Experience Manager ao atualizar a configuração do Dispatcher para bloquear qualquer solicitação de download de ativos. O servlet também pode ser desativado manualmente por meio do console OSGi diretamente.

  1. Para bloquear solicitações de download de ativos por meio de uma configuração do Dispatcher, edite a configuração dispatcher.any e adicione uma nova regra à seção de filtro.

    /0100 { /type "deny" /url "*.assetdownload.zip/assets.zip*" }

Representação OnTime ou OffTime on-off-time-rendition

Para habilitar o serviço OnOffTimeAssetAccessFilter, é necessário criar uma configuração OSGi. Esse serviço permite o bloqueio de acesso a representações e metadados, além do próprio ativo, com base em configurações de tempo de ativação/desativação. A configuração OSGi deve ser para com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter. Siga as etapas abaixo:

  1. No código do projeto no Git, crie um arquivo de configuração em /apps/system/config/com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter.cfg.json. O arquivo deve conter {} como conteúdo, o que significa uma configuração OSGi vazia para o componente OSGi correspondente. Essa ação ativa o serviço.
  2. Implante seu código, incluindo esta nova configuração, através de Cloud Manager.
  3. Depois de implantados, as representações e os metadados ficam acessíveis de acordo com as configurações de tempo de ativação/desativação dos ativos. Se a data ou a hora atual for anterior à hora de ativação ou posterior à hora de desativação, uma mensagem de erro será exibida.
    Para obter mais detalhes sobre como adicionar uma configuração OSGi vazia, consulte este guia.

Dicas e limitações tips-limitations

  • Se você baixar uma pasta vazia, o Experience Manager transmitirá uma mensagem de sucesso sobre a criação de um arquivo ZIP, mas o arquivo não será criado.

Consulte também

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab