Tabellen und JSON
Neben der Übersetzung von Google-Dokumenten und Word-Dokumenten in Markdown und HTML-Markup können mit AEM auch Tabellen (Microsoft Excel-Arbeitsmappen und Google Sheets) in JSON-Dateien übersetzt werden, die von Ihrer Website oder Web-Anwendung einfach genutzt werden können.
Dies ermöglicht viele Verwendungen für tabellenorientierte oder strukturierte Inhalte.
Blätter und Blattstruktur
Das einfachste Beispiel für eine Tabelle besteht aus einer Tabelle, die die erste Zeile als Spaltennamen und die nachfolgenden Zeilen als Daten verwendet. Ein Beispiel könnte in etwa so aussehen.
Nach der Vorschau und Veröffentlichung über den Sidekick übersetzt AEM diese Tabelle in eine JSON-Darstellung, die Anfragen an die entsprechende .json-Ressource gesendet wird. Das obige Beispiel wird übersetzt in:
{
"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"
}
Mit AEM können Sie Arbeitsmappen mit mehreren Blättern verwalten.
- Wenn nur ein Blatt vorhanden ist, verwendet AEM dieses Blatt standardmäßig als Quelle der Informationen.
- Wenn mehrere Blätter vorhanden sind, stellt AEM nur Blätter mit dem Präfix
shared-(oderhelix-) bereit. Auf diese Weise können Sie zusätzliche Informationen und möglicherweise Formeln in derselben Tabelle speichern, die nicht im Internet bereitgestellt werden. - Wenn es ein Blatt mit dem:
shared-default(oderhelix-default) gibt, wird es bereitgestellt, wenn keine zusätzlichen Abfrageparameter angegeben sind.
Hinweis: Das helix- Präfix ist veraltet und es sollte das neutralere shared- verwendet werden.
Im folgenden Abschnitt finden Sie Details zum Abfragen eines bestimmten Arbeitsblatts.
Abfrageparameter
Versatz und Begrenzung
Tabellen und JSON-Dateien können sehr groß werden. In solchen Fällen unterstützt AEM die Verwendung von limit und offset Abfrageparametern, um anzugeben, welche Zeilen des Arbeitsblatts bereitgestellt werden.
Da AEM JSON immer komprimiert, sind Payloads im Allgemeinen relativ klein. Daher begrenzt AEM standardmäßig die Anzahl der Zeilen, die zurückgegeben wird, auf 1000, wenn der limit Abfrageparameter nicht angegeben ist. Dies ist für viele einfache Fälle ausreichend.
Blatt
Mit dem sheet Abfrageparameter kann ein Programm ein oder mehrere bestimmte Blätter in der Kalkulationstabelle oder Arbeitsmappe angeben. Beispielsweise gibt ?sheet=jobs das Blatt mit dem Namen shared-jobs zurück und ?sheet=jobs&sheet=articles gibt die Daten für die Blätter mit dem Namen shared-jobs und shared-articles zurück.
Spezielle Tabellennamen
In bestimmten Anwendungsfällen schreibt AEM auch in Tabellen, wo bestimmte Tabellennamen erwartet werden.
- Der Forms- schreibt nur in ein Blatt mit dem Namen
incoming, das nie als JSON bereitgestellt wird. - Der Index- schreibt nur in ein Blatt mit dem Namen
raw_index, das in einer einfachen Einzelblatt-Einrichtung an JSON gesendet werden kann.
Weitere Informationen zu diesen Services finden Sie unter den obigen Links.
Arrays
Native Arrays werden nicht als Zellwerte unterstützt, daher werden sie als Zeichenfolgen bereitgestellt.
"tags": "[\"Adobe Life\",\"Responsibility\",\"Diversity & Inclusion\"]"
Sie können sie in JavaScript mithilfe von JSON.parse() wieder in Arrays umwandeln.