Fogli di calcolo e JSON
Oltre a tradurre documenti Google e Word in markdown e markup HTML, AEM traduce anche i fogli di calcolo (cartelle di lavoro di Microsoft Excel e fogli Google) in file JSON che possono essere facilmente utilizzati dal sito web o dall’applicazione web.
Questo consente molti utilizzi per contenuti orientati alle tabelle o strutturati.
Fogli e struttura del foglio
L'esempio più semplice di un foglio è costituito da una tabella che utilizza la prima riga come nomi di colonna e le righe successive come dati. Un esempio potrebbe essere simile al seguente.
Dopo un’anteprima e una pubblicazione tramite barra laterale, l’AEM traduce questa tabella in una rappresentazione JSON trasmessa alle richieste al corrispondente .json risorsa. L’esempio precedente viene tradotto in:
{
"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"
}
L'AEM consente di gestire le cartelle di lavoro con più fogli.
- Se è presente un solo foglio, Per impostazione predefinita, l'AEM utilizza tale foglio come fonte di informazione.
- Se sono presenti più fogli, L’AEM consegnerà solo fogli con il prefisso
helix-che consente di conservare informazioni aggiuntive ed eventualmente formule nello stesso foglio di calcolo che non vengono consegnate al web. - Se è presente un foglio denominato
helix-default,viene consegnato se non vengono forniti parametri di query aggiuntivi.
Per informazioni dettagliate su come eseguire query su un foglio specifico, vedere la sezione seguente.
Parametri di query
Offset e limite
I fogli di calcolo e i file JSON possono diventare molto grandi. In questi casi, l'AEM sostiene l'uso di limit e offset parametri di query per indicare quali righe del foglio di calcolo vengono consegnate.
Poiché l’AEM comprime sempre il JSON, i payload sono generalmente relativamente piccoli. Pertanto, per impostazione predefinita, l’AEM limita il numero di righe che restituisce a 1000 se limit parametro query non specificato. Questo è sufficiente per molti casi semplici.
Foglio
Il sheet parametro query consente a un'applicazione di specificare uno o più fogli specifici nel foglio di calcolo o nella cartella di lavoro. Ad esempio ?sheet=jobs restituirà il foglio denominato helix-jobs e ?sheet=jobs&sheet=articles restituirà i dati per i fogli denominati helix-jobs e helix-articles.
Nomi fogli speciali
In alcuni casi d’uso, l’AEM scrive anche su fogli di calcolo, dove si aspetta nomi specifici.
- Il servizio Forms scrive solo in un foglio denominato
incoming, che non viene mai consegnato come JSON. - Il servizio indice scrive solo in un foglio denominato
raw_index, che può essere consegnato a JSON in una semplice configurazione a foglio singolo.
Per ulteriori informazioni su questi servizi, consulta i collegamenti riportati sopra.
Matrici
Gli array nativi non sono supportati come valori di cella, pertanto vengono distribuiti come stringhe.
"tags": "[\"Adobe Life\",\"Responsibility\",\"Diversity & Inclusion\"]"
È possibile convertirli nuovamente in array in JavaScript utilizzando JSON.parse().