Baixar ativos em 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 Experience Manager interface 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. Experience Manager O baixa diretamente solicitações de um único ativo para o arquivo original, em vez de incluir 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 variável Experience Manager Caixa de entrada após a geração de um arquivo de download.

Notificação na 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 ativar esse recurso, os administradores podem configurar o serviço de email configuração de 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. Efetue logon no Experience Manager Assets.

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

  3. Selecione o Notificações por email para download de ativos e clique em Aceitar.

    enable-email-notifications-for-large-downloads

Para baixar ativos, siga estas etapas:

  1. Entrada 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 do 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 dam-users grupo. 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 subativos estará disponível se o ativo original tiver subativos.
    Representação(ões) Uma representação é a representação binária de um ativo. Os ativos têm uma representação principal - a do arquivo carregado. Eles podem ter qualquer número de representações.
    Com essa opção, é possível selecionar as representações que deseja baixar. As representações disponíveis dependem do ativo selecionado.
    Cortes 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 entre as Predefinição de imagem lista.
    Além disso, você pode selecionar o tamanho e a unidade de medida, o formato, o espaço de cor, a resolução e qualquer modificador de imagem opcional, como inverter a imagem. A opção só estará disponível se você Dynamic Media ativado.
  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.

    email-notifications-for-large-downloads

    Você também pode visualizar a notificação em sua Experience Manager Caixa de entrada.

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

O compartilhamento de ativos usando um link é uma maneira conveniente de disponibilizá-lo para as 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, Assets O 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 variável Baixar caixa de entrada 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 O permite que usuários autenticados emitam solicitações de download simultâneas arbitrariamente grandes 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 atenuar esses possíveis riscos semelhantes a DoS causados por esse recurso, AssetDownloadServlet O componente OSGi está desativado 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 direcionada 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 nomeado com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config.

  3. Preencher 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. A variável Asset Download Servlet pode ser desativado em um Experience Manager crie e publique instâncias atualizando a configuração do dispatcher para bloquear qualquer solicitação de download de ativo. 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 o dispatcher.any e adicionar uma nova regra à variável seção de filtro.

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

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

Para ativar o OnOffTimeAssetAccessFilter precisa 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 do OSGi deve ser para com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter. Siga as etapas abaixo:

  1. No código do seu 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 seu 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 essa nova configuração, por meio do 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 esta guia.

Dicas e limitações tips-limitations

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

Consulte também

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