スプレッドシートと JSON
AEMでは、Googleドキュメントと Word ドキュメントを Markdown やHTMLマークアップに翻訳するほか、スプレッドシート (Microsoft Excel ワークブックやGoogleシート ) を JSON ファイルに変換して、Web サイトや Web アプリケーションで簡単に利用できます。
これにより、テーブル指向または構造化されたコンテンツを多くの用途で使用できます。
シートとシート構造
シートの最も簡単な例は、最初の行を列名として使用し、後続の行をデータとして使用するテーブルで構成されています。 例としては次のようなものが挙げられます。
プレビューを実行し、 サイドキックの場合、AEMは、このテーブルを、対応する .json
リソース。 上記の例の変換先は次のとおりです。
{
"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"
}
AEMでは、複数のシートを含むワークブックを管理できます。
- もし一枚だけなら AEMは、デフォルトで、そのシートを情報のソースとして使用します。
- 複数のシートがある場合、 AEMは、「
helix-
これにより、追加情報や数式を、Web に配信されない同じスプレッドシート内に保持できます。 - 次の名前のシートがある場合:
helix-default,
追加のクエリパラメーターが指定されていない場合に配信されます。
特定のシートに対するクエリ方法の詳細については、次のセクションを参照してください。
クエリパラメーター
オフセットと制限
スプレッドシートと JSON ファイルは非常に大きくなる可能性があります。 このような場合、AEMは limit
および offset
スプレッドシートの配信行を示すクエリパラメーター。
AEMは常に JSON を圧縮するので、通常、ペイロードは比較的小さくなります。 したがって、AEMのデフォルトでは、返される行数は limit
クエリパラメーターが指定されていません。 多くの単純なケースでは、これで十分です。
シート
The sheet
クエリパラメーターを使用すると、アプリケーションはスプレッドシートまたはワークブック内の 1 つまたは複数の特定のシートを指定できます。 例 ?sheet=jobs
次の名前のシートが返されます: helix-jobs
および ?sheet=jobs&sheet=articles
は、という名前のシートのデータを返します。 helix-jobs
および helix-articles
.
特殊シート名
特定の使用例では、AEMはスプレッドシートにも書き込みを行いますが、ここでは特定のシート名を想定しています。
- forms サービス 次の名前のシートにのみ書き込みます:
incoming
:JSON としては配信されません。 - インデックスサービス 次の名前のシートにのみ書き込みます:
raw_index
:シンプルな単一のシート設定で JSON に配信できます。
これらのサービスの詳細については、上記のリンクを参照してください。
配列
ネイティブ配列はセル値としてサポートされていないので、文字列として配信されます。
"tags": "[\"Adobe Life\",\"Responsibility\",\"Diversity & Inclusion\"]"
JavaScript で、を使用して配列に戻すことができます。 JSON.parse()
.