Kalkylblad och JSON
Förutom att översätta Google Docs- och Word-dokument till markeringar och HTML-markeringar, översätter AEM även kalkylblad (Microsoft Excel-arbetsböcker och Google-blad) till JSON-filer som enkelt kan användas av din webbplats eller i ditt webbprogram.
Detta möjliggör många användningsområden för innehåll som är tabellorienterat eller strukturerat.
Blad- och bladstruktur
Det enklaste exemplet på en tabell består av en tabell som använder den första raden som kolumnnamn och efterföljande rader som data. Ett exempel kan se ut ungefär så här.
Efter en förhandsgranskning och publicering via sidekick översätter AEM den här tabellen till en JSON-representation som skickas till begäranden till motsvarande .json-resurs. Exemplet ovan översätts till:
{
"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"
}
Med AEM kan du hantera arbetsböcker med flera blad.
- Om det bara finns ett blad använder AEM som standard det bladet som informationskälla.
- Om det finns flera blad kommer AEM endast att leverera blad som har prefixet
shared-(ellerhelix-), vilket gör att du kan behålla ytterligare information och eventuellt formler i samma kalkylblad som inte levereras till webben. - Om det finns ett blad med namnet
shared-default(ellerhelix-default) levereras det om inga ytterligare frågeparametrar anges.
Obs!: helix--prefixet är föråldrat och det mer neutrala shared- -prefixet bör användas.
I följande avsnitt finns mer information om hur du använder ett visst blad.
Frågeparametrar
Förskjutning och gräns
Kalkylblad och JSON-filer kan bli mycket stora. I sådana fall stöder AEM användning av frågeparametrarna limit och offset för att ange vilka rader i kalkylbladet som levereras.
Eftersom AEM alltid komprimerar JSON är nyttolasterna i allmänhet relativt små. Som standard begränsar AEM antalet rader som returneras till 1000 om frågeparametern limit inte anges. Detta räcker för många enkla fall.
Blad
Frågeparametern sheet tillåter ett program att ange ett eller flera specifika blad i kalkylbladet eller arbetsboken. Som ett exempel returnerar ?sheet=jobs bladet shared-jobs och ?sheet=jobs&sheet=articles returnerar data för bladen shared-jobs och shared-articles.
Namn på specialblad
I vissa fall skriver AEM även till kalkylblad, där specifika arknamn förväntas.
- Formulärtjänsten skriver bara till ett blad med namnet
incomingsom aldrig levereras som en JSON. - Indextjänsten skriver bara till ett blad med namnet
raw_indexsom kan levereras till JSON i en enkel konfiguration för ett ark.
Se länkarna ovan för mer information om dessa tjänster.
Arrayer
Inbyggda arrayer stöds inte som cellvärden och levereras därför som strängar.
"tags": "[\"Adobe Life\",\"Responsibility\",\"Diversity & Inclusion\"]"
Du kan omvandla dem till arrayer i JavaScript med JSON.parse().