在嵌入到外部容器的可视化中创建数据操作

可视化可嵌入到外部容器（例如，HTML 页或使用者的应用程序页）中，并且可在可视化中包括数据操作。通过嵌入式数据操作，可以与外部容器中的嵌入式可视化交互。您可以从外部容器检索可视化中使用的一组数据元素。可以添加任意数量的嵌入式数据操作。

发布事件使外部应用程序能够接收所选可视化中的一组数据元素值（称为可视化上下文）。所选可视化中的数据元素值集不得是度量列或隐藏列。

事件名称在外部容器中提供，在发布上下文事件时传递。“上下文”表示位于可视化中选定位置的一组数据元素值。如果跨多个工作簿或者跨单个工作簿中的多个数据元素使用数据操作，可以提供唯一事件名称，这样更便于跟踪。例如，如果输入 DV Embedded Content DA1 作为操作名称，则在事件名称字段中，可以输入 Event from DA1 来指示事件所源于的数据操作。

输入传递值时，请注意以下事项：
  • 使用全部可以动态确定您单击的单元（例如，"Product and Year"）的交互并将这些值传递给目标。
  • 使用锚定点数据可确保在运行时显示数据操作，不过仅当锚定至字段中指定的所需列在视图上下文中可用时，才显示数据操作。
  • 使用无可以打开页（URL 或画布），但不传递任何值。例如，可能需要导航到 www.oracle.com 但不传递任何上下文。
  • 使用定制可以指定的一组要传递的定制列。
选择支持多选时，请注意以下事项：
  • 启用 — 可在选择了一个或多个数据点时调用数据操作。
  • 禁用 — 可在选择了单个数据点时调用数据操作。

    选择多个数据点可能会导致错误时（例如，使用一些第三方 REST API），此设置特别有用。

保存工作簿之后，您可以在外部容器中嵌入工作簿。外部容器显示嵌入的可视化。在您右键单击可视化并且其中包含了适用的数据操作时，它们显示在下拉菜单的可视化中。如果单击嵌入式数据操作，它会确定可视化的上下文信息并将该信息传递到导航操作服务以处理它。导航服务通过上下文有效负载信息来引发事件。您可以订阅到此事件，以便接收事件回调中的有效负载以及在其他区域中使用有效负载。

  1. 在主页上，将光标悬停在工作簿上，单击操作，然后选择打开。
  2. 在工作簿中，单击菜单，然后选择数据操作。
  3. 单击添加操作。在“新建数据操作”中，转到名称并输入名称。
  4. 单击类型并选择发布事件。
  5. 在锚定至字段中单击添加数据或选择数据，然后选择一个或多个在应用数据操作时要传递值的数据元素。
  6. 输入事件名称。
  7. 单击传递值字段，然后选择您希望数据操作将哪些值传递给使用者。
  8. 单击支持多选以设置值。
    • 启用 — 选择一个或多个数据点时可以调用数据操作。
    • 禁用 — 仅在选择单个数据点时才能调用数据操作。

      选择多个数据点可能会导致错误时（例如，使用一些第三方 REST API），此设置特别有用。

  9. 单击确定以保存。