DocumentaçãoAEM as a Cloud ServiceGuia do usuário

Utilização de Planilhas para Gerenciar Dados Tabulares tabular-data

Last update: Tue Nov 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Administrador
  • Desenvolvedor

Saiba como usar planilhas para gerenciar dados tabulares para vários valores, como metadados e redirecionamentos para seu AEM com Edge Delivery Services.

Casos de uso use-cases

Para qualquer AEM com um site de Edge Delivery Services, é necessário manter listas de dados tabulares, como para mapeamentos de valores-chave. Elas podem ser listas de vários valores diferentes, como metadados e redirecionamentos. O Edge Deliver Services permite manter essas listas tabulares usando uma ferramenta intuitiva: a planilha. O AEM traduz essas planilhas em arquivos JSON que podem ser facilmente consumidos pelo seu site ou aplicativo da Web.

Casos de uso comuns incluem:

Além disso, você pode criar planilhas de qualquer estrutura para armazenar mapeamentos para fins próprios.

Este documento usa o exemplo de redirecionamentos para ilustrar como criar essas planilhas. Consulte os tópicos vinculados anteriormente na documentação do Edge Delivery Services para obter detalhes sobre cada caso de uso.

TIP
Para obter mais informações sobre como as planilhas em geral funcionam com Edge Delivery Services, consulte o documento Planilhas e JSON.
TIP
As planilhas devem ser usadas apenas para manter dados tabulares. Para armazenar dados estruturados, confira os recursos headless do AEM.

Pré-requisitos prerequisites

Para criar mapeamentos usando planilhas no projeto AEM com Edge Delivery Services, é necessário criar o site usando o modelo de site mais recente.

Consulte o documento Guia de Introdução do Desenvolvedor para criação no WYSIWYG com Edge Delivery Services para obter mais informações.

Criação de uma Planilha spreadsheet

Neste exemplo, você criará uma planilha para gerenciar redirecionamentos do AEM com o site Edge Delivery Services. As mesmas etapas se aplicam a outros tipos de planilha que você deseja criar.

  1. Entre na sua instância de criação do AEM as a Cloud Service, vá para o console Sites e navegue até a raiz do site, que requer uma planilha. Toque ou clique em Criar -> Página.

    Criar página

  2. Na guia Modelo do assistente de criação de página, toque ou clique no modelo Redirecionamentos para selecioná-lo e toque ou clique em Avançar.

    Selecionar modelo

  3. A guia Propriedades do assistente apresenta os valores padrão para a planilha de redirecionamentos. Toque ou clique em Criar.

    • Título - Deixar este valor como está.

    • Colunas - As colunas mínimas necessárias para redirecionamentos são preenchidas previamente.

      • origem - A página a ser redirecionada
      • destino - A página para redirecionar

    Propriedades da planilha

  4. Na caixa de diálogo Êxito, toque ou clique em Abrir.

    Caixa de diálogo de sucesso

  5. Uma nova guia é aberta com a planilha carregada em um editor com as colunas origem e destino predefinidas. Para definir seus redirecionamentos, toque ou clique na linha vazia da coluna origem. As alterações são salvas automaticamente à medida que você edita a planilha.

    Editar planilha

    • A origem é relativa ao domínio do seu site, portanto, contém apenas o caminho relativo.
    • O destino pode ser uma URL totalmente qualificada se você estiver redirecionando para um site diferente ou um caminho relativo se você estiver redirecionando dentro do seu próprio site.
    • Use a tecla tab para mover o foco para a próxima célula.
    • O editor adiciona novas linhas à planilha conforme necessário.
    • Para excluir ou mover uma linha, use o ícone Excluir no final de cada linha e as alças de arrastar no início de cada linha, respectivamente.

Importando Dados da Planilha importing

Além de editar planilhas no Editor de páginas AEM, você também pode importar dados de um arquivo CSV.

  1. Ao editar sua planilha no AEM, toque ou clique no botão Carregar, no canto superior esquerdo da tela.

  2. Na lista suspensa, selecione como deseja importar os dados.

    • Substituir Documento para substituir o conteúdo da planilha inteira pelo conteúdo do arquivo CSV que você fará upload.
    • Anexar ao Documento para anexar os dados do arquivo CSV que você carregará no conteúdo da planilha existente.

  3. Na caixa de diálogo que é aberta, selecione o arquivo CSV e toque ou clique em Abrir.

Uma caixa de diálogo é aberta conforme a importação é processada. Após a conclusão, os dados no arquivo CSV são adicionados ou substituem o conteúdo da planilha. Se forem encontrados erros, como uma incompatibilidade de colunas, eles serão relatados para que você possa corrigir seu arquivo CSV.

NOTE
  • Os cabeçalhos no arquivo CSV devem corresponder exatamente às colunas na planilha.
  • A importação do CSV inteiro não modifica os cabeçalhos da coluna, somente as linhas de conteúdo.
  • Se você precisar atualizar as colunas, é necessário fazer isso no Editor de páginas do AEM antes de executar a importação do CSV.
  • Um arquivo CSV não pode ter mais de 10 MB para importação.

Dependendo da sua seleção de mode, você também pode create, replace ou append para planilhas usando um CSV e um comando cURL semelhante ao seguinte.

curl --request POST \
  --url http://<aem-instance>/bin/asynccommand \
  --header 'content-type: multipart/form-data' \
  --form file=@/path/to/your.csv \
  --form spreadsheetPath=/content/<your-site>/<your-spreadsheet> \
  --form 'spreadsheetTitle=Your Spreadsheet' \
  --form cmd=spreadsheetImport \
  --form operation=asyncSpreadsheetImport \
  --form _charset_=utf-8 \
  --form mode=append

A chamada retorna uma página de HTML com informações sobre a ID do trabalho.

Message | Job(Id:2024/9/18/15/27/5cb0cacc-585d-4176-b018-b684ad2dfd02_90) created successfully. Please check status at Async Job Status Navigation.

Você pode usar o console Trabalhos para exibir o status do trabalho ou usar a ID retornada para consultá-lo.

https://<aem-instance>/bin/asynccommand?optype=JOBINF&jobid=2024/10/24/14/1/8da63f9e-066b-4134-95c9-21a9c57836a5_1

Publicar uma planilha em paths.json paths-json

Para que o AEM possa publicar os dados em sua planilha, você também precisa atualizar o arquivo paths.json do seu projeto.

  1. Abra a raiz do seu projeto no GitHub.

  2. Toque ou clique no arquivo paths.json para abrir seus detalhes e, em seguida, no ícone Editar.

    arquivo paths.json

  3. Adicione uma linha para mapear sua nova planilha para um recurso redirects.json.

    code language-json 
    {
  "mappings": [
   "/content/<site-name>/:/",
   "/content/<site-name>/redirects:/redirects.json"
  ]
}
    note note
    NOTE
    Esta entrada paths.json é baseada no exemplo de criação de redirecionamentos usando dados tabulares. Atualize o caminho apropriado para o tipo de planilha que você está criando.

  4. Clique em Confirmar alterações… para salvar as alterações em main.

    • Confirme com main ou crie uma solicitação pull de acordo com seu processo.

  5. Quando terminar de definir os redirecionamentos e atualizar o mapeamento de caminho, retorne ao console Sites.

  6. Toque ou clique para selecionar a planilha de redirecionamentos criada no console e toque ou clique em Publish Rápido na barra de ações para publicar a planilha.

    Selecione a planilha no console Sites

  7. Na caixa de diálogo Publish Rápido, toque ou clique em Publish.

    Confirmar publicação

  8. Um banner confirma a publicação.

    Confirmação de banner da publicação

A planilha de redirecionamentos agora está publicada e acessível ao público.

TIP
Para obter mais informações sobre mapeamentos de caminho, consulte o documento Mapeamento de Caminho para Edge Delivery Services.

Outros Tipos de Planilha other

Agora que você sabe como criar uma planilha de redirecionamentos, é possível criar qualquer outro tipo de planilha padrão:

  • Espaços reservados
  • Metadados
  • Cabeçalhos
  • Configuração
  • Taxonomia

Basta seguir as mesmas etapas nas seções Criar planilha e Atualizar caminhos.json e escolher o modelo apropriado e atualizar o arquivo paths.json apropriadamente.

Para Configuração, Cabeçalhos e Metadados adicione um mapeamento para publicá-los em seus locais padrão:

  • Configuração: /.helix/config.json
  • Cabeçalhos: /.helix/headers.json
  • Metadados: /metadata.json
  • Taxonomia: consulte o documento Gerenciando Dados de Taxonomia para obter mais informações.

Além disso, você pode criar sua própria planilha com colunas arbitrárias para uso próprio.

NOTE
Não é necessário criar uma planilha para gerenciar a indexação do AEM as a Cloud Service com projetos Edge Delivery Services.
Se quiser criar seus próprios índices, siga esta documentação para criar seu próprio arquivo helix-query.yaml.

Criar Sua Própria Planilha own-spreadsheet

  1. Siga as mesmas etapas na seção Criar Planilha.

  2. Ao selecionar o modelo, escolha Planilha.

  3. Na guia Propriedades do assistente, você pode adicionar suas próprias colunas.

    Adicionar suas próprias colunas

    • Na seção Colunas, toque ou clique em Adicionar para adicionar uma nova coluna.
    • Forneça um nome para a coluna.
    • Remova ou reorganize as colunas usando os ícones Excluir e arrastar alça, respectivamente.

  4. Crie a planilha e publique de acordo com as instruções para a planilha de redirecionamentos.

  5. Adicione um mapeamento ao arquivo paths.json de acordo com as instruções da planilha de redirecionamentos.

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