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 webbplatsen eller webbprogrammet.
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 publicera 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://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"
}
Med AEM kan du hantera arbetsböcker med flera blad.
- Om det bara finns ett ark AEM använder som standard det bladet som informationskälla.
- Om det finns flera blad, AEM levererar endast ark som är försedda med
helix-som 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
helix-default,den levereras om inga ytterligare frågeparametrar anges.
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 limit och offset frågeparametrar för att ange vilka rader i kalkylbladet som levereras.
Som AEM alltid komprimerar JSON är nyttolasterna i allmänhet relativt små. Som standard AEM därför antalet rader som returneras till 1000 om limit frågeparametern har inte angetts. Detta räcker för många enkla fall.
Blad
The sheet Med frågeparametern kan ett program ange ett eller flera specifika blad i kalkylbladet eller arbetsboken. Som ett exempel ?sheet=jobs returnerar det namngivna bladet helix-jobs och ?sheet=jobs&sheet=articles returnerar data för de namngivna bladen helix-jobs och helix-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 JSON. - Indextjänsten skriver bara till ett blad med namnet
raw_index, som kan levereras till JSON i ett enda 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 göra om dem till arrayer i JavaScript med JSON.parse().