Feuilles de calcul et JSON
Outre la traduction de documents Google et de documents Word en balises Markdown et HTML, AEM convertit également les feuilles de calcul (classeurs Excel Microsoft et feuilles de calcul Google) en fichiers JSON faciles à utiliser par votre site web ou votre application web.
Cela permet de nombreuses utilisations pour le contenu orienté table ou structuré.
Sheets et structure de feuille
L’exemple le plus simple d’une feuille consiste en un tableau qui utilise la première ligne comme nom de colonne et les lignes suivantes comme données. Un exemple peut ressembler à ceci.
Après un aperçu et une publication via l’événement sidekick, AEM convertit ce tableau en une représentation JSON qui est diffusée aux requêtes envoyées aux .json
ressource. L’exemple ci-dessus est traduit en :
{
"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 vous permet de gérer des classeurs avec plusieurs feuilles.
- S’il n’y a qu’une seule feuille, AEM utilisera par défaut cette feuille comme source des informations.
- S’il existe plusieurs feuilles, AEM ne distribuera que les feuilles précédées du préfixe
helix-
qui vous permet de conserver des informations et éventuellement des formules supplémentaires dans la même feuille de calcul qui ne sont pas diffusées sur le web. - Si une feuille est nommée
helix-default,
elle est fournie si aucun paramètre de requête supplémentaire n’est fourni.
Consultez la section suivante pour plus d’informations sur la manière d’interroger une feuille spécifique.
Paramètres de requête
Décalage et limite
Les feuilles de calcul et les fichiers JSON peuvent devenir très volumineux. Dans ce cas, AEM prend en charge l’utilisation de la fonction limit
et offset
paramètres de requête pour indiquer les lignes de la feuille de calcul à diffuser.
Comme AEM compresse toujours le fichier JSON, les charges utiles sont généralement relativement petites. Par conséquent, AEM limite par défaut le nombre de lignes qu’il renvoie à 1 000 si la variable limit
le paramètre de requête n’est pas spécifié. Cela suffit pour de nombreux cas simples.
Feuille
La variable sheet
le paramètre de requête permet à une application de spécifier une ou plusieurs feuilles spécifiques dans la feuille de calcul ou le classeur. Exemple ?sheet=jobs
renverra la feuille nommée helix-jobs
et ?sheet=jobs&sheet=articles
renverra les données des feuilles nommées helix-jobs
et helix-articles
.
Noms de feuilles spéciaux
Dans certains cas d’utilisation, AEM écrit également dans des feuilles de calcul, où il attend des noms de feuille spécifiques.
- Le service Forms écrit uniquement sur une feuille nommée
incoming
, qui n’est jamais diffusé au format JSON. - Le service d’index écrit uniquement sur une feuille nommée
raw_index
, qui peut être diffusé au format JSON dans une configuration simple à feuille.
Consultez les liens ci-dessus pour plus d’informations sur ces services.
Tableaux
Les tableaux natifs ne sont pas pris en charge en tant que valeurs de cellule. Ils sont donc distribués sous la forme de chaînes.
"tags": "[\"Adobe Life\",\"Responsibility\",\"Diversity & Inclusion\"]"
Vous pouvez les transformer en tableaux dans JavaScript à l’aide de JSON.parse()
.