Planilhas e JSON
Além de traduzir documentos do Google Docs e do Word para markdown e marcação HTML, o AEM também traduz planilhas (pastas de trabalho do Microsoft Excel e Google Sheets) em arquivos JSON que podem ser facilmente consumidos pelo seu site ou aplicativo da Web.
Isso permite que muitos usuários utilizem conteúdo orientado a tabelas ou estruturado.
Estrutura de planilhas e chapas
O exemplo mais simples de uma planilha consiste em uma tabela que usa a primeira linha como nomes de coluna e as linhas subsequentes como dados. Um exemplo pode se parecer com isso.
Após uma pré-visualização e publicação por meio da sidekick, o AEM traduz essa tabela para uma representação JSON, que é fornecida para solicitações para a variável .json recurso. O exemplo acima é traduzido para:
{
"total": 4,
"offset": 0,
"limit": 4,
"data": [
{
"Source": "/sidekick-extension",
"Destination": "https://chrome.google.com/webstore/detail/helix-sidekick-beta/ccfggkjabjahcjoljmgmklhpaccedipo"
},
{
"Source": "/github-bot",
"Destination": "https://github.com/apps/helix-bot"
},
{
"Source": "/install-github-bot",
"Destination": "https://github.com/apps/helix-bot/installations/new"
},
{
"Source": "/tutorial",
"Destination": "/developer/tutorial"
}
],
":type": "sheet"
}
O AEM permite gerenciar pastas de trabalho com várias planilhas.
- Se houver apenas uma folha, O AEM usará, por padrão, essa planilha como fonte de informação.
- Se houver várias folhas, O AEM só fornecerá folhas com o prefixo
helix-que permite manter informações adicionais e possivelmente fórmulas na mesma planilha que não são entregues à web. - Se houver uma planilha chamada
helix-default,ele é fornecido se não houver parâmetros de consulta adicionais fornecidos.
Consulte a seção a seguir para obter detalhes sobre como consultar uma planilha específica.
Parâmetros de consulta
Deslocamento e Limite
As planilhas e os arquivos JSON podem ficar muito grandes. Nesses casos, o AEM suporta a utilização de limit e offset consulte parâmetros para indicar quais linhas da planilha são entregues.
Como o AEM sempre compacta o JSON, as cargas úteis geralmente são relativamente pequenas. Portanto, por padrão, o AEM limita o número de linhas que retorna para 1000 se a variável limit parâmetro de consulta não especificado. Isso é suficiente para muitos casos simples.
Planilha
A variável sheet parâmetro de consulta permite que um aplicativo especifique uma ou várias planilhas específicas na planilha ou pasta de trabalho. Como exemplo ?sheet=jobs retornará a planilha chamada helix-jobs e ?sheet=jobs&sheet=articles retornará os dados das planilhas chamadas helix-jobs e helix-articles.
Nomes de Planilha Especiais
Em certos casos de uso, o AEM também grava em planilhas, onde espera nomes de planilhas específicos.
- O serviço de formulários somente grava em uma planilha chamada
incoming, que nunca é fornecido como um JSON. - O serviço de índice somente grava em uma planilha chamada
raw_index, que pode ser entregue ao JSON em uma configuração simples de folha única.
Consulte os links acima para obter mais informações sobre esses serviços.
Matrizes
Matrizes nativas não são suportadas como valores de célula, então elas são entregues como sequências de caracteres.
"tags": "[\"Adobe Life\",\"Responsibility\",\"Diversity & Inclusion\"]"
Você pode transformá-los de volta em matrizes no JavaScript usando JSON.parse().