Seletor de ativos de micro front-end

O Seletor de ativos de micro front-end fornece uma interface do usuário que se integra facilmente ao repositório Experience Manager Assets as a Cloud Service para navegar ou pesquisar ativos digitais disponíveis no repositório e usá-los na experiência de criação do aplicativo.

A interface do usuário de micro front-end é disponibilizada em sua experiência de aplicativo usando o pacote de Seletor de ativos. Quaisquer atualizações no pacote são automaticamente importadas e o Seletor de ativos implantado mais recente é automaticamente carregado no aplicativo.

O Seletor de ativos oferece muitos benefícios, como:

• Facilidade de integração com qualquer um dos aplicativos Adobe ou não-Adobe usando a biblioteca JavaScript Vanilla.

• Manutenção facilitada, pois as atualizações do pacote do Seletor de ativos são implantadas automaticamente no Seletor de ativos disponível para seu aplicativo. Não há atualizações necessárias no aplicativo para carregar as modificações mais recentes.

• Facilidade de personalização, pois há propriedades disponíveis que controlam a exibição do Seletor de ativos no aplicativo.

• Filtros de pesquisa de texto completo, prontos para uso e personalizados que navegam rapidamente até os ativos para uso na experiência de criação.

• Capacidade de alternar repositórios em uma organização IMS para seleção de ativos.

• Capacidade de classificar ativos por nome, dimensões e tamanho e visualizá-los na exibição de Lista, Grade, Galeria ou Cascata.

O escopo deste artigo é demonstrar como usar o Seletor de ativos com um aplicativo Adobe no Unified Shell ou quando já tiver um imsToken gerado para autenticação. Esses fluxos de trabalho são chamados de fluxo não SUSI neste artigo.

Execute as seguintes tarefas para integrar e usar o Seletor de ativos com o seu repositório Experience Manager Assets as a Cloud Service:

• Integrar o Seletor de ativos usando o Vanilla JS
• Definir propriedades de exibição do Seletor de ativos
• Usar o Seletor de ativos

Integrar o Seletor de ativos usando o Vanilla JS

É possível integrar qualquer Adobe ou aplicativo fora da Adobe com o repositório Experience Manager Assets as a Cloud Service no aplicativo.

A integração é feita importando o pacote do Seletor de ativos e conectando ao Assets as a Cloud Service usando a biblioteca JavaScript Vanilla. É necessário editar um index.html ou qualquer arquivo apropriado em seu aplicativo para:

• Definir os detalhes de autenticação
• Acessar o repositório do Assets as a Cloud Service
• Configurar as propriedades de exibição do Seletor de ativos

É possível executar a autenticação sem definir algumas das propriedades do IMS, se:

• Está integrando um aplicativo Adobe no Unified Shell.
• Você já tem um token IMS gerado para autenticação.

Pré-requisitos

Defina os pré-requisitos no arquivo index.html ou em um arquivo semelhante na implementação do aplicativo para definir os detalhes de autenticação e acessar o repositório do Experience Manager Assets as a Cloud Service. Os pré-requisitos incluem:

• imsOrg
• imsToken
• apikey

Instalação

Os Seletores de ativos estão disponíveis por meio das versões CDN (por exemplo, esm.sh/Skypack) e UMD do ESM.

Nos navegadores usando a Versão UMD (recomendado):

<script src="https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/assets-selectors.js"></script>

<script>
  const { renderAssetSelector } = PureJSSelectors;
</script>

Em navegadores com suporte a import maps usando a Versão CDN do ESM:

<script type="module">
  import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'
</script>

No Deno/Webpack Module Federation usando a Versão CDN do ESM:

import { AssetSelector } from 'https://experience.adobe.com/solutions/CQ-assets-selectors/static-assets/resources/@assets/selectors/index.js'

Tipo de ativo selecionado

O Tipo de ativo selecionado é uma matriz de objetos que contém as informações do ativo ao usar as funções handleSelection, handleAssetSelection, e onDrop.

Sintaxe do esquema

interface SelectedAsset {
    'repo:id': string;
    'repo:name': string;
    'repo:path': string;
    'repo:size': number;
    'repo:createdBy': string;
    'repo:createDate': string;
    'repo:modifiedBy': string;
    'repo:modifyDate': string;
    'dc:format': string;
    'tiff:imageWidth': number;
    'tiff:imageLength': number;
    'repo:state': string;
    computedMetadata: Record<string, any>;
    _links: {
        'http://ns.adobe.com/adobecloud/rel/rendition': Array<{
            href: string;
            type: string;
            'repo:size': number;
            width: number;
            height: number;
            [others: string]: any;
        }>;
    };
}

A tabela a seguir descreve algumas das propriedades importantes do objeto de ativo selecionado.

Para obter uma lista completa das propriedades e um exemplo detalhado, acesse Exemplo de código do seletor de ativos.

Exemplo para o fluxo não SUSI

Este exemplo demonstra como usar o Seletor de ativos com um fluxo não SUSI ao executar um aplicativo Adobe no Unified Shell ou quando você já tiver gereado imsToken para autenticação.

Inclua o pacote do Seletor de ativos no código usando o script tag, conforme mostrado em linhas 6-15 do exemplo abaixo. Depois que o script for carregado, a variável global PureJSSelectors estará disponível para uso. Definir o Seletor de ativos propriedades conforme mostrado em linhas 16-23. As propriedades imsOrg e imsToken são necessárias para autenticação em um fluxo não SUSI. A propriedade handleSelection é usada para manipular os ativos selecionados. Para renderizar o Seletor de ativos, chame a função renderAssetSelector como mencionado na linha 17. O Seletor de ativos é exibido no elemento de container <div>, conforme mostrado nas linhas 21 e 22.

Seguindo essas etapas, é possível usar o Seletor de ativos com um fluxo não SUSI no aplicativo Adobe.

<!DOCTYPE html>
<html>
<head>
    <title>Asset Selector</title>
    <script src="https://experience.adobe.com/solutions/CQ-assets-selectors/assets/resources/assets-selectors.js"></script>
    <script>
        // get the container element in which we want to render the AssetSelector component
        const container = document.getElementById('asset-selector-container');
        // imsOrg and imsToken are required for authentication in non-SUSI flow
        const assetSelectorProps = {
            imsOrg: 'example-ims@AdobeOrg',
            imsToken: "example-imsToken",
            apiKey: "example-apiKey-associated-with-imsOrg",
            handleSelection: (assets: SelectedAssetType[]) => {},
        };
        // Call the `renderAssetSelector` available in PureJSSelectors globals to render AssetSelector
        PureJSSelectors.renderAssetSelector(container, assetSelectorProps);
    </script>
</head>

<body>
    <div id="asset-selector-container" style="height: calc(100vh - 80px); width: calc(100vw - 60px); margin: -20px;">
    </div>
</body>

</html>

Para obter um exemplo detalhado, acesse Exemplo de código do seletor de ativos.

Usar propriedades do Seletor de ativos

Você pode usar as propriedades do Seletor de ativos para personalizar a forma como o Seletor de ativos é renderizado. A tabela a seguir lista as propriedades que você pode usar para personalizar e usar o Seletor de ativos.

handleSelection=(assets: Asset[])=> {…}

handleSelection=(assets: Asset[])=> {…}

Exemplos de uso das propriedades do Seletor de ativos

É possível definir as propriedades do Seletor de ativos no arquivo index.html para personalizar a exibição do Seletor de ativos no aplicativo.

Exemplo 1: Seletor de ativos na exibição do painel

Se o valor do Seletor de ativos rail estiver definido como false ou não for mencionado nas propriedades, o Seletor de ativos aparecerá na exibição modal por padrão.

Exemplo 2: popover de metadados

Use várias propriedades para definir os metadados de um ativo que deseja visualizar usando um ícone de informações. O popover de informações fornece a coleção de informações sobre o ativo ou a pasta, incluindo título, dimensões, data de modificação, local e descrição de um ativo. No exemplo abaixo, várias propriedades são usadas para exibir metadados de um ativo, por exemplo, a propriedade repo:path especifica o local de um ativo.

Exemplo 3: propriedade de filtro personalizado na exibição do painel

Além da pesquisa facetada, o Seletor de ativos permite personalizar vários atributos para refinar a pesquisa no Adobe Experience Manager as a Cloud Service aplicação. É necessário adicionar o código a seguir para acrescentar filtros de pesquisa personalizados em seu aplicativo. No exemplo abaixo, a pesquisa Type Filter que filtra o tipo de ativo entre Imagens, Documentos ou Vídeos ou o tipo de filtro adicionado para a pesquisa.

Lidar com a seleção de ativos usando o esquema de objeto

A propriedade handleSelection é usada para lidar com seleções únicas ou múltiplas de ativos no Seletor de ativos. O exemplo abaixo declara a sintaxe de uso de handleSelection.

Utilização do Seletor de ativos

Depois que o Seletor de ativos estiver configurado e você for autenticado para usar o Seletor de ativos com o aplicativo Adobe Experience Manager as a Cloud Service, você poderá selecionar ativos ou executar várias outras operações para pesquisar seus ativos no repositório.

• A: Ocultar/Mostrar painel
• B: Alternador de repositório
• C: Ativos
• D: Filtros
• E: Barra de pesquisa
• F: Classificação
• G: Classificação em ordem crescente ou decrescente
• H: Exibição

Ocultar/Mostrar painel

Para ocultar pastas na navegação à esquerda, clique no ícone Ocultar pastas. Para desfazer as alterações, clique no ícone Ocultar pastas novamente.

Alternador de repositório

O Seletor de ativos também permite alternar repositórios para seleção de ativos. Você pode selecionar o repositório de sua escolha no menu suspenso disponível no painel esquerdo. As opções de repositório disponíveis na lista suspensa se baseiam na propriedade repositoryId definida no arquivo index.html. Tem como base os ambientes da organização IMS selecionada que são acessados pelo usuário conectado. Os consumidores podem transmitir um repositoryID de sua preferência e, nesse caso, o Seletor de ativos interrompe a renderização do alternador de repositório e renderiza ativos somente do repositório especificado.

Repositório de ativos

É uma coleção de pastas de ativos que você pode usar para executar operações.

Filtros prontos para uso

O Seletor de ativos também fornece opções de filtro prontas para uso para refinar os resultados da pesquisa. Os filtros disponíveis são os seguintes:

• File type: inclui pasta, arquivo, imagens, documentos ou vídeo

• MIME type: inclui JPG, GIF, PPTX, PNG, MP4, DOCX, TIFF, PDF, XLSX

• Image Size: inclui largura mínima/máxima, altura mínima/máxima da imagem

  

Pesquisa personalizada

Além da pesquisa de texto completo, o Seletor de ativo permite pesquisar ativos em arquivos usando a pesquisa personalizada. Você pode usar filtros de pesquisa personalizados nos modos de exibição Modal e Painel.

Também é possível criar um filtro de pesquisa padrão para salvar os campos que você pesquisa com frequência e usá-los depois. Para criar uma pesquisa personalizada para seus ativos, você pode usar a propriedade filterSchema.

Barra de pesquisa

O Seletor de ativos permite executar uma pesquisa de texto completo dos ativos no repositório selecionado. Por exemplo, se você digitar a palavra-chave wave na barra de pesquisa, todos os ativos com a palavra-chave wave mencionada em qualquer uma das propriedades de metadados serão exibidos.

Classificação

Você pode classificar ativos no Seletor de ativos por nome, dimensões ou tamanho de um ativo. Também é possível classificar os ativos em ordem crescente ou decrescente.

Tipos de visualização

O Seletor de ativos permite exibir o ativo em quatro exibições diferentes:

• Exibição em lista: a exibição em lista exibe arquivos e pastas roláveis em uma única coluna.
• Exibição em grade: a exibição em grade exibe arquivos e pastas roláveis em uma grade de linhas e colunas.
• Exibição em galeria: a exibição em galeria exibe arquivos ou pastas em uma lista horizontal com bloqueio central.
• Exibição em cascata: a exibição em cascata exibe arquivos ou pastas no formato de uma ponte.

Recursos do Business.Adobe.com