試算表和JSON

除了將Google檔案和Word檔案轉譯為Markdown和HTML標籤外,AEM還會將試算表(Microsoft Excel活頁簿和Google工作表)轉譯為JSON檔案,以便您的網站或網頁應用程式輕鬆使用。

如此一來,以表格為導向或結構化的內容就會有許多用途。

頁面和頁面結構

工作表最簡單的範例是使用第一列作為欄名,後續列作為資料的表格。 範例看起來可能像這樣。

在透過預覽和發佈後 sidekick,AEM會將此表格轉譯為JSON表示形式,以供要求對應的 .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- 可讓您在相同的試算表中保留未傳送至網路的其他資訊和可能的公式。
  • 如果有名為的頁面 helix-default, 如果沒有提供額外的查詢引數,則會傳遞它。

如需有關如何查詢特定工作表的詳細資訊,請參閱下一節。

查詢參數

位移和限制

試算表和JSON檔案可能會變得很大。 在這種情況下,AEM支援使用 limitoffset 查詢引數以指出要傳送的試算表列。

由於AEM一律會壓縮JSON,裝載通常相對較小。 AEM因此,根據預設,如果 limit 未指定查詢引數。 這足以處理許多簡單的情況。

工作表

sheet 查詢引數可讓應用程式在試算表或活頁簿中指定一或多個特定工作表。 例如 ?sheet=jobs 將傳回指定的工作表 helix-jobs?sheet=jobs&sheet=articles 將會傳回下列工作表的資料: helix-jobshelix-articles.

特殊工作表名稱

在某些使用案例中,AEM也會將寫入試算表,期望特定工作表名稱。

  • Forms服務 只寫入名為的工作表 incoming,永遠不會以JSON形式提供。
  • 索引服務 只寫入名為的工作表 raw_index,這些資料可能會以簡單的單一工作表設定傳送至JSON。

如需這些服務的詳細資訊,請參閱上述連結。

陣列

原生陣列不支援作為儲存格值,因此會以字串形式傳遞。

"tags": "[\"Adobe Life\",\"Responsibility\",\"Diversity & Inclusion\"]"

您可以使用將它們轉換回JavaScript中的陣列 JSON.parse().

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