試算表和 JSON

除了將 Google 文件和 Word 文件轉換為 Markdown 和 HTML 標記之外,AEM 還可將電子表格 (Microsoft Excel 工作簿和 Google Sheet) 轉換為可由網站或 Web 應用程式輕鬆使用的 JSON 文件。

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

頁面和頁面結構

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

在透過sidekick預覽和發佈之後,AEM會將此表格轉譯為JSON表示法,以處理對應.json資源的要求。 上述範例將轉譯為:

{
  "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"
}

AEM可讓您管理含有多個工作表的活頁簿。

  • 如果只有一個工作表, AEM預設會使用該工作表作為資訊的來源。
  • 如果有多個工作表, AEM只會傳送前置詞為shared- (或helix-)的工作表,讓您保留其他資訊,並可能保留相同試算表中未傳送至網路的公式。
  • 如果有名為 shared-default (或helix-default)的工作表,則會在未提供其他查詢引數時傳遞它。

注意helix-首碼已過時,應該使用較中立的shared-首碼。

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

查詢參數

位移和限制

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

由於AEM一律會壓縮JSON,裝載通常相對較小。 因此,依預設,如果未指定limit查詢引數,AEM會將其傳回的列數限製為1000。 這足以處理許多簡單的情況。

工作表

sheet查詢引數可讓應用程式在試算表或活頁簿中指定一或多個特定工作表。 例如,?sheet=jobs將傳回名為shared-jobs的工作表,而?sheet=jobs&sheet=articles將傳回名為shared-jobsshared-articles的工作表的資料。

特殊工作表名稱

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

  • 表單服務只寫入名為incoming的工作表,該工作表永遠不會以JSON形式傳遞。
  • 索引服務只會寫入名為raw_index的工作表,這些工作表可能會以簡單的單一工作表設定傳遞到JSON。

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

陣列

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

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

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

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