Hojas de cálculo y JSON
Además de convertir documentos de Google y Word en Markdown y marcado de HTML, AEM también convierte hojas de cálculo (libros de trabajo de Microsoft Excel y Google Sheets) en archivos JSON que su sitio web o aplicación web puede consumir fácilmente.
Esto permite muchos usos para el contenido que está orientado a tablas o estructurado.
Hojas y estructura de hojas
El ejemplo más sencillo de una hoja consiste en una tabla que utiliza la primera fila como nombres de columna y las filas siguientes como datos. Un ejemplo podría tener este aspecto.
Después de obtener una vista previa y publicar mediante la barra de tareas, AEM traduce esta tabla a una representación JSON que se proporciona a las solicitudes del recurso .json correspondiente. El ejemplo anterior se traduce a:
{
"total": 4,
"offset": 0,
"limit": 4,
"data": [
{
"Source": "/sidekick-extension",
"Destination": "https://chromewebstore.google.com/detail/aem-sidekick/igkmdomcgoebiipaifhmpfjhbjccggml"
},
{
"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"
}
AEM permite administrar libros con varias hojas.
- Si sólo hay una hoja, AEM la usará de forma predeterminada como origen de la información.
- Si hay varias hojas, AEM solo entregará las hojas con el prefijo
shared-(ohelix-), lo que permite mantener información adicional y posiblemente fórmulas en la misma hoja de cálculo que no se entregan en el Web. - Si hay una hoja denominada
shared-default(ohelix-default), se enviará si no se han proporcionado parámetros de consulta adicionales.
Nota: el prefijo helix- está obsoleto y se debe usar el prefijo shared-, que es más neutro.
Consulte la siguiente sección para obtener más información sobre cómo consultar una hoja específica.
Parámetros de consulta
Desplazamiento y límite
Las hojas de cálculo y los archivos JSON pueden llegar a ser muy grandes. En estos casos, AEM admite el uso de limit y offset parámetros de consulta para indicar qué filas de la hoja de cálculo se entregan.
Como AEM siempre comprime el JSON, las cargas útiles suelen ser relativamente pequeñas. Por lo tanto, de forma predeterminada, AEM limita el número de filas a 1000 si no se especifica el parámetro de consulta limit. Esto es suficiente para muchos casos sencillos.
Hoja
El parámetro de consulta sheet permite que una aplicación especifique una o varias hojas específicas en la hoja de cálculo o el libro. Como ejemplo ?sheet=jobs devolverá la hoja denominada shared-jobs y ?sheet=jobs&sheet=articles devolverá los datos de las hojas denominadas shared-jobs y shared-articles.
Nombres especiales de hoja
En determinados casos de uso, AEM también escribe en hojas de cálculo, donde espera nombres de hoja específicos.
- El servicio de formularios solo escribe en una hoja denominada
incoming, que nunca se entrega como JSON. - El servicio de índice solo escribe en una hoja denominada
raw_index, que se puede entregar a JSON en una configuración de hoja única.
Consulte los vínculos anteriores para obtener más información sobre esos servicios.
Matrices
Las matrices nativas no se admiten como valores de celda, por lo que se envían como cadenas.
"tags": "[\"Adobe Life\",\"Responsibility\",\"Diversity & Inclusion\"]"
Puede volver a convertirlas en matrices en JavaScript con JSON.parse().