Hojas de cálculo y JSON
Además de traducir documentos de Google y documentos de Word en Markdown y marcado de HTML AEM, también traduce hojas de cálculo (libros de Excel de Microsoft y hojas de cálculo de Google) en archivos JSON que su sitio web o aplicación web pueden 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 una previsualización y publicación mediante el compincheAEM , traduce esta tabla a una representación JSON que se proporciona a las solicitudes de la correspondiente .json
recurso. El ejemplo anterior se traduce a:
{
"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"
}
AEM le permite administrar libros con varias hojas de cálculo.
- Si solo hay una hoja, AEM De forma predeterminada, la hoja de datos se utilizará como fuente de la información.
- Si hay varias hojas, AEM solo entregará hojas con el prefijo
helix-
que permite mantener información adicional y posiblemente fórmulas en la misma hoja de cálculo que no se entregan a la web. - Si hay una hoja denominada
helix-default,
se envía si no se proporcionan parámetros de consulta adicionales.
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. AEM En estos casos, el uso de la ayuda es compatible con el uso de: limit
y offset
parámetros de consulta para indicar qué filas de la hoja de cálculo se entregan.
AEM Como siempre comprime el JSON, las cargas útiles suelen ser relativamente pequeñas. AEM Por lo tanto, de forma predeterminada, limita el número de filas a 1000 si el valor de limit
parámetro de consulta no especificado. Esto es suficiente para muchos casos sencillos.
Hoja
El sheet
El parámetro query permite a una aplicación especificar una o varias hojas específicas en la hoja de cálculo o el libro. Como ejemplo ?sheet=jobs
devolverá la hoja denominada helix-jobs
y ?sheet=jobs&sheet=articles
devolverá los datos de las hojas denominadas helix-jobs
y helix-articles
.
Nombres especiales de hoja
AEM En algunos casos de uso, también escribe en hojas de cálculo, donde espera nombres de hoja específicos.
- El servicio Forms 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 enviar a JSON en una sencilla configuración de una sola hoja.
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 convertirlos de nuevo en matrices en JavaScript mediante JSON.parse()
.