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().

recommendation-more-help
10a6ce9d-c5c5-48d9-8ce1-9797d2f0f3ec