使用电子表格管理表格数据 tabular-data
了解如何使用电子表格来管理各种值的表格数据，例如利用 Edge Delivery Services 站点为您的 AEM 提供元数据和重定向。
用例 use-cases
对于任何使用 Edge Delivery Services 站点的 AEM，都需要维护表格数据列表，例如键值映射列表。这些可以是许多不同值的列表，例如元数据和重定向。Edge Deliver Services 允许您使用直观的工具（电子表格）维护此类表格列表。AEM 将这些电子表格转换为 JSON 文件，您的网站或 Web 应用程序可以轻松使用这些文件。
常见的用例包括：
此外，您可以创建任何结构的电子表格来存储映射，以满足自己的需要。
本文档使用重定向示例来说明如何创建此类电子表格。有关每个用例的详细信息，请参阅边 Edge Delivery Services 文档中先前链接的主题。
先决条件 prerequisites
为了在具有 Edge Delivery Services 的 AEM 项目中使用电子表格创建映射，您需要使用最新的站点模板创建站点。
有关详细信息，请参阅文档使用Edge Delivery Services进行WYSIWYG创作的开发人员快速入门指南。
创建电子表格 spreadsheet
在此示例中，您将创建一个电子表格来管理利用 Edge Delivery Services 站点为您的 AEM 重定向。相同的步骤适用于您想要创建的其他电子表格类型。
-
登录到 AEM as a Cloud Service 创作实例，进入 Sites 控制台，然后导航到需要电子表格的站点的根目录。点击或单击 创建-> 页面。
-
在创建页面向导的“模板”选项卡上，点击或单击“重定向”模板将其选中，然后点击或点击“下一步”。
-
向导的“属性”选项卡显示重定向电子表格的默认值。点击或单击“创建”。
-
标题 - 保留此值不变。
-
列 - 预先填充重定向所需的最少列。
- 源 - 要重定向的页面
- 目标 - 重定向到的页面
-
-
在 “成功” 对话框中，点击或单击 “打开”。
-
将打开一个新选项卡，其中电子表格已加载到编辑器中，并包含预定义的 源列 和 目标列。要定义重定向，请点击或单击 源 列的空行。当您编辑电子表格时，更改会自动保存。
- 源 与您网站的域相关，因此它仅包含相对路径。
- 如果您重定向到其他网站，目标 可以是完全限定的 URL；如果您在自己的网站内重定向，目标可以是相对路径。
- 使用 Tab 键将焦点移至下一个单元格。
- 编辑器根据需要向电子表格添加新行。
- 要删除或移动行，请分别使用每行末尾的 “删除” 图标和每行开头的拖动手柄。
导入电子表格数据 importing
除了在AEM页面编辑器中编辑电子表格之外，您还可以从CSV文件导入数据。
-
在AEM中编辑电子表格时，点按或单击屏幕左上角的 上传 按钮。
-
在下拉菜单中，选择您希望如何导入数据。
- 替换Doc，将整个电子表格的内容替换为您要上载的CSV文件的内容。
- 附加到文档 以将要上载的CSV文件的数据附加到现有的电子表格内容。
-
在打开的对话框中，选择您的CSV文件，然后点按或单击 打开。
处理导入时，将打开一个对话框。 完成后，CSV文件中的数据将添加到电子表格或替换该电子表格的内容。 如果遇到任何错误（如列不匹配），将报告这些错误，以便您更正CSV文件。
- CSV文件中的标题必须与电子表格中的列完全匹配。
- 导入整个CSV不会修改列标题，只会修改内容行。
- 如果需要更新列，则必须在执行CSV导入之前在AEM页面编辑器中执行该操作。
- CSV文件的导入大小不能大于10 MB。
根据您选择的mode，您还可以使用CSV和cURL命令create、replace或append到电子表格，如下所示。
curl --request POST \
--url http://<aem-instance>/bin/asynccommand \
--header 'content-type: multipart/form-data' \
--form file=@/path/to/your.csv \
--form spreadsheetPath=/content/<your-site>/<your-spreadsheet> \
--form 'spreadsheetTitle=Your Spreadsheet' \
--form cmd=spreadsheetImport \
--form operation=asyncSpreadsheetImport \
--form _charset_=utf-8 \
--form mode=append
调用将返回一个HTML页面，其中包含有关作业ID的信息。
Message | Job(Id:2024/9/18/15/27/5cb0cacc-585d-4176-b018-b684ad2dfd02_90) created successfully. Please check status at Async Job Status Navigation.
您可以使用 作业 控制台查看作业的状态，或使用返回的ID进行查询。
https://<aem-instance>/bin/asynccommand?optype=JOBINF&jobid=2024/10/24/14/1/8da63f9e-066b-4134-95c9-21a9c57836a5_1
发布电子表格 paths.json paths-json
为了使 AEM 能够发布您的电子表格中的数据，您还需要更新项目的 paths.json 文件。
-
在 GitHub 中打开您的项目的根目录。
-
点击或单击
paths.json文件以打开其详细信息，然后点击“编辑”图标。
-
添加一行以将新电子表格映射到
redirects.json资源。code language-json { "mappings": [ "/content/<site-name>/:/", "/content/<site-name>/redirects:/redirects.json" ] }note note NOTE 此 paths.json条目基于使用表格数据创建重定向的示例。 请确保更新适合您正在创建的类型电子表格的路径。 -
单击“提交更改…”将更改保存到
main。- 根据您的流程提交
main或创建拉取请求。
- 根据您的流程提交
-
定义完重定向并更新路径映射后，返回 Sites 控制台。
-
点击或单击以选择您在控制台中创建的重定向电子表格，然后点击或单击操作栏中的 “快速发布” 发布电子表格。
-
在 “快速发布” 对话框中，点击或单击 “发布”。
-
横幅确认了该出版物。
重定向电子表格现已发布并可供公众访问。
其他电子表格类型 other
现在您已经知道如何创建重定向电子表格，您可以创建任何其他标准电子表格类型：
- 占位符
- 元数据
- 标头
- 配置
- 分类
只需按照各部分中的相同步骤操作即可创建电子表格和更新 paths.json，选择合适的模板并paths.json相应地更新文件。
对于配置、标头和元数据，请确保添加一项映射，以将其发布到默认位置：
- 配置：
/.helix/config.json - 标头：
/.helix/headers.json - 元数据：
/metadata.json - 分类：有关详细信息，请参阅文档管理分类数据。
此外，您还可以用任意列创建您自己的电子表格供您自己使用。
helix-query.yaml文件。创建您自己的电子表格 own-spreadsheet
-
请按照本节中的相同步骤进行操作创建电子表格。
-
选择模板时，选择 电子表格。
-
在向导的“属性”选项卡中，您可以添加自己的列。
- 在 列 部分，点击或单击 “添加” 添加新列。
- 提供该列的名称。
- 分别使用 “删除” 和拖动手柄图标进行删除或重新组织列。
-
创建电子表格并按照重定向电子表格的说明进行发布。
-
按照重定向电子表格的说明将映射添加到
paths.json文件。