准备工作

在本教程中，您将学习如何安装 Oracle Visual Builder Add-in for Excel、创建从 REST 服务检索数据的 Microsoft Excel 工作簿以及发布工作簿，以便业务用户可以执行数据输入任务。学完本教程大约需要 10 分钟。

背景信息

Oracle Visual Builder Add-in for Excel 可帮助您将数据从 REST 服务下载到 Excel 工作簿中的表，用户可在将数据发送回服务之前修改、创建或删除数据。安装插件后，您将输入服务的端点以将数据从服务下载到 Excel 工作簿。您还将看到一个新的 Oracle Visual Builder 功能区选项卡，其中包含可帮助您管理下载数据的命令。

需要做哪些准备？

• 安装了 Microsoft Excel 365 或其他受支持版本的 Windows 10 或 11 操作系统

  （请参阅使用 Oracle Visual Builder Add-in for Excel 开发集成电子表格中的支持的平台。）

• 访问 Oracle Visual Builder 实例

  注：您可能可以使用所选的 REST 服务完成教程。确保您具有目标服务的 OpenAPI 服务元数据（某些 Oracle 服务通过向 URL 添加 /describe 来提供此类说明）。如果您选择此路线，本教程中的某些步骤可能与您的服务不同。

  例如，您可以跳过步骤 1 的子步骤 1 到 6，但仍需要完成子步骤 7 和 8 才能安装插件。开始之前，请从 Downloads（下载）页面下载安装程序。

安装 Oracle Visual Builder Add-in for Excel

1. 右键单击此文件，然后将其下载到计算机。

   Personnel_Manager.zip 文件包含一个可视应用程序，其中包含“雇员”业务对象和示例数据。

2. 在 Web 浏览器中，登录到 Oracle Visual Builder。
3. 在“可视化应用程序”页上，单击导入，然后选择文件中的应用程序并浏览以选择 Personnel_Manager.zip 文件。单击导入。
4. 在“可视化应用程序”页上，单击“名称”列中的人员管理器。
5. 单击 Business Objects（业务对象），然后单击 Menu（菜单），然后选择 Data Manager（数据管理器）。

   

6. 在“数据管理器”页上，单击在 Excel 中编辑数据以下载安装程序。

   提示：在下载页上检查是否有较新版本。

7. 在运行安装程序之前退出 Excel。
8. 双击下载的安装程序文件以开始安装，单击下一步，然后在安装插件后单击关闭。See Install Oracle Visual Builder Add-in for Excel in Developing Integrated Spreadsheets Using Oracle Visual Builder Add-in for Excel.

   成功安装后，可在 Excel 中启用插件，启动 Excel 时将显示新的 Oracle Visual Builder 选项卡。

   

配置 Excel 工作簿以从 REST 服务下载数据

在此步骤中，您将在 Excel 工作簿中创建表，该表从与刚导入的可视化应用程序关联的 REST 服务中下载员工数据。

1. 在 Oracle Visual Builder 的 Business Objects（业务对象）选项卡中，依次单击 Employees（员工）、 Endpoints（端点）。
2. 展开资源 API ，然后单击剪贴板图标以复制元数据资源 API 的整个 URL：

   

3. 在计算机上的目录中创建名为 employees-source.xlsx 的 Excel 工作簿，然后将其打开。
4. 单击要查找数据表的单元格。
5. 在 Excel 工作簿的 Oracle Visual Builder 选项卡中，单击设计器以启动“新建布局设置”向导。
6. 在向导的第一个屏幕中，在“Web 地址”字段中输入以前复制的 URL，然后单击下一步。

   

   将验证设置保留设置为 "Default"。

   注：如果使用的是其他 REST 服务，请输入该服务的 URL 并将 /describe 附加到 URL。

7. 在“登录”对话框中，输入用于访问 Oracle Visual Builder 的用户名和密码，然后单击登录。

   此插件连接到 Oracle Visual Builder 实例并检索服务元数据。该操作的结果将显示在向导中。

8. 单击下一步继续。
9. 在下一屏幕中，选择员工，然后单击下一步。

   

   下一个屏幕提示您选择要创建的布局类型：表或表单到表。

   

10. 选择表布局，然后单击下一步。

    下一个屏幕会提示您为一个或多个从属布局选择其他业务对象。

    

11. 将此屏幕留空并单击下一步以继续。
12. 在最终屏幕中，确认新布局的详细信息，然后单击完成。

    Excel 工作簿中将显示一个新表。显示了列标题，标题下方有一个占位符数据行。您还会在右侧看到布局设计器。

    

    注：如果布局的原始单元格位于前 10 行中，则标题行将被冻结，以便您在工作表中上下滚动时始终看到列标题。

13. 单击下载数据以下载员工业务对象参考的数据。

    

在发布之前自定义 Excel 工作簿中的表

在发布插件并将其分发给用户以进行数据输入之前，您可能需要自定义插件在 Excel 工作簿中创建的表。例如，您可能希望更改列的顺序，以便“电子邮件”列显示在员工名字之前。您还可以添加搜索查询来筛选从服务下载的数据。例如，您可以将“员工”业务对象中的“薪金”字段添加为搜索字段，以允许用户输入搜索标准，以便用户仅下载符合该标准的员工的记录。

1. 在 Oracle Visual Builder 选项卡中，根据需要单击设计器。然后，单击布局设计器中的列选项卡。
2. 通过拖放电子邮件条目左侧显示的图标来对列重新排序，如下所示：

   提示：右键单击列可查看用于重新排序的更多选项。

   

   注：将自动生成“更改”、“状态”和“关键字”列。您无法自定义或删除这些列。

3. 单击下载选项卡以添加搜索查询。
4. 单击“搜索”旁边的“编辑”图标。

   

5. 在“可用业务对象”字段编辑器中选择薪金，然后单击确定。
6. 在搜索编辑器中，选择比较器列表中的大于，并将值留空。
7. 清除下载时启用的编辑器以确保下载时禁用搜索提示中的搜索编辑器控件。
8. 单击 OK 以保存搜索设置并关闭搜索编辑器。
9. 单击下载数据。
10. 在“搜索”对话框中，输入 10000，然后单击确定。

    此插件仅下载薪金超过 10,000 的员工的记录。

    

将 Excel 工作簿发布并分发给用户

现在，您已创建 Excel 工作簿并将其配置为从 REST 服务下载数据，您可能需要发布它。如果要创建可分发给其他用户进行数据录入的工作簿副本，则此可选步骤非常有用。它还允许您删除设计工具（设计器、删除布局和发布）并打开工作表保护。也就是说，您可以在不发布源 Excel 工作簿的情况下分发源 Excel 工作簿。

1. 在 Oracle Visual Builder 选项卡中，单击发布。

   

2. 在“发布工作簿”窗口中，接受工作簿的位置和文件名。当原始工作簿的名称以 -source 结尾（如我们的示例 employees-source.xlsx 中所示）时，插件提供与 -source 相同的名称。

   

3. 清除从每个目录中删除服务主机复选框，但保留其他发布选项不变。
4. 单击发布。请参阅使用 Oracle Visual Builder Add-in for Excel 开发集成电子表格中的发布集成 Excel 工作簿。

   在“状态”窗格中显示确认。

   

5. 保存并关闭用于发布 Excel 工作簿的源 Excel 工作簿。

   现在，您可以将发布的工作簿分发给其他用户进行数据输入。每个用户必须具有用户名和密码，才能访问您在创建 Excel 工作簿时输入的 REST 服务。

   本教程的下一步说明用户如何使用刚刚发布的 Excel 工作簿完成数据输入任务。

在已发布的 Excel 工作簿中创建、读取、更新和删除数据

收到您发布的 Excel 工作簿副本的业务用户必须安装插件才能从 REST 服务下载数据。（他们可以直接从下载页面下载安装程序。）安装插件后，他们可以先在工作簿中创建、读取、更新和删除下载的数据，然后再将更改上载到服务。

1. 从保存该工作簿的目录中打开已发布的 Excel 工作簿。

   

   “设计”部分不会显示在 Oracle Visual Builder 选项卡中，因为您禁用了“设计”工具，从而阻止已发布工作簿的用户访问您作为工作簿开发人员可以访问的设计器、删除布局和发布命令。该表显示列标题，但没有数据，因为您选择在发布 Excel 工作簿时清除所有布局。

2. 单击下载数据以下载工作簿配置为检索的数据。
3. 在“登录”对话框中输入用户名和密码，然后单击确定。
4. 由于您设置了搜索查询以根据员工薪金限制数据下载，因此系统会提示您为该查询输入值。将值留空，然后单击确定。

   此插件将下载所有员工数据。

   

5. 进行以下更改：
   • 在第 1 行中，将 Sophia 更改为 Sophie。
   • 单击单元格 G2，然后从值列表中选择经理以更改 Dave Brown 的职称。
   • 选择 John Sieve（第 4 行）的行，例如，单击其电子邮件地址。在 Oracle Visual Builder 选项卡中，单击表行更改，然后单击标记为删除。
   • 选择整行 5，右键单击，然后从上下文菜单中选择插入。为新插入的行输入此数据：电子邮件 = jmcgahern@example.com，名字 = John，姓氏 = McGahern，雇用日期 = 2018-01-30，职称 = Accountant，薪金 = 19,000，部门 = Accounting。

     注：在表中添加新行的另一种方法是选择紧邻表中最后下载行的行，然后单击表行更改和插入行。插件将在表中创建新行，然后您可以对其进行编辑。

   • 在表（第 102 行）的末尾为 Ken Ster 选择行，例如，选择其电子邮件地址。在 Oracle Visual Builder 选项卡中，单击表行更改，然后单击标记为删除。

     进行这些更改后，您的表与下图中所示的表类似。也就是说，在进行更改的每行的 Changed 列中都会出现 Update、Delete 或 Create 消息。

     

6. 在 Oracle Visual Builder 选项卡中，单击上载更改。

   当出现提示该表具有暂挂删除的消息时，单击是进行确认。上载完成后，表将刷新状态列，以描述已上载的每个修改行的更改。

   您创建的新行导致在集合中为 John McGahern 创建新记录。

   您标记为删除的行、John Sieve 和 Ken Ster 的记录不再显示，因为 REST 服务已将其从其集合中删除。

   

   注：在将数据上载到 REST 服务之前，会验证所有数据。如果您遇到错误，始终可以修复错误并重新上载更改。如果您有部分错误，例如，如果更新和删除行成功但创建行失败，则只需修复失败的创建行的数据。

   要验证对 Excel 工作簿所做的更改是否已成功上载，请转到可视化应用程序中“业务对象”页面的数据选项卡。

   

希望了解更多信息？

• 使用 Oracle Visual Builder Add-in for Excel 开发集成电子表格中的Oracle Visual Builder Add-in for Excel 简介
• 使用 Oracle Visual Builder Add-in for Excel 开发集成电子表格中的配置下载的搜索选项
• Managing Data Using Oracle Visual Builder Add-in for Excel。本指南可帮助您的业务用户使用集成工作簿取得成功。