文档

电子表格和JSON

Last update: Thu Feb 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

除了将Google文档和Word文档转换为Markdown和HTML标记外，AEM还会将电子表格(Microsoft Excel工作簿和Google工作表)转换为JSON文件，这些文件可供您的网站或Web应用程序轻松使用。

这样一来，面向表或结构化的内容就可以得到很多应用。

薄片和薄片结构

工作表的最简单示例包括一个表，该表使用第一行作为列名，使用后续行作为数据。 示例可能如下所示。

通过预览和发布后 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- 它可让您在相同的电子表格中保留未传送到Web的其他信息和公式。
  • 如果存在名为 helix-default, 如果未提供其他查询参数，则会交付该参数。

有关如何查询特定工作表的详细信息，请参阅以下部分。

查询参数

偏移和限制

电子表格和JSON文件可能会变得非常大。 在这种情况下，AEM支持使用 limit 和 offset 用于指示电子表格中传送哪些行的查询参数。

由于AEM始终压缩JSON，因此有效负载通常相对较小。 AEM因此，默认情况下，如果 limit 未指定查询参数。 对于许多简单的例子来说，这已经足够。

工作表

此 sheet 查询参数允许应用程序在电子表格或工作簿中指定一个或多个特定工作表。 例如 ?sheet=jobs 将返回指定的工作表 helix-jobs 和 ?sheet=jobs&sheet=articles 将返回以下工作表的数据： helix-jobs 和 helix-articles.

特殊工作表名称

在某些用例中，AEM还会写入电子表格，它需要特定的工作表名称。

  • 表单服务 仅写入名为的工作表 incoming，永远不会作为JSON提供。
  • 索引服务 仅写入名为的工作表 raw_index，这些表单可能会以简单的单个表单设置传送到JSON。

有关这些服务的更多信息，请参阅上面的链接。

数组

不支持将本机数组作为单元格值，因此将它们作为字符串提供。

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

您可以使用将它们转换回JavaScript中的数组 JSON.parse().

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