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- (eller helix-), 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 (eller helix-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 incoming som aldrig levereras som en JSON.
  • Indextjänsten skriver bara till ett blad med namnet raw_index som 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().

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