使用属性、方法和事件为自定义微件添加交互性

学习目标

  • 使用属性、方法和事件扩展自定义微件,以实现脚本编写、用户交互以及微件与 SAP Analytics Cloud 之间的数据交换。

添加属性和方法

自定义微件可以通过以下内容进行扩展:

  • 属性 ,它们定义随故事存储的可配置设置,

  • 方法 ,它们可以从脚本中调用以控制微件。

属性和方法实现了对自定义微件的配置和脚本驱动的控制。

练习

在本练习中,你将添加一个新属性,并公开一个方法,使你能够从故事脚本动态更改图表类型。

你将:

  1. 在微件元数据中定义自定义属性

  2. 公开一个用于基于脚本的交互的方法

  3. 使用故事中的按钮控制微件行为

在本地修改自定义微件文件后,你将:

  1. 添加一个按钮并为其分配脚本

  2. 点击该按钮

  3. 观察图表从折线图变为条形图。

结果

该微件可通过脚本控制,从而能够动态更改图表类型。

练习开始练习(SAP 官方交互式练习)

添加事件并与来自 ECharts 的点击事件集成

自定义微件可以发出事件,这些事件可在 SAP Analytics Cloud 脚本编写中使用。

练习

在本练习中,你将:

  1. 在微件元数据中定义自定义事件

  2. 基于用户交互(点击图表数据点)触发该事件

  3. 在 Script Editor 中访问该事件

结果

该自定义事件在 Script Editor 中可用,并可在脚本中使用。

练习开始练习(SAP 官方交互式练习)

添加自定义数据类型

自定义数据类型简化了脚本中与数据的交互。这意味着自定义微件可以公开可从脚本访问的结构化数据。

练习

在本练习中,你将扩展该微件,使其返回有关图表中所选数据点的信息。

你将:

  1. 向故事中添加一个文本组件

  2. 在 Outline Panel 中找到该自定义微件,并点击“fx”按钮

  3. 编写脚本以解析来自该自定义微件的所选数据

  4. 在图表中选择一个数据点,并观察文本组件中的值

结果

当你在图表上选择一个数据点时,所选数据会显示在文本组件中。

练习开始练习(SAP 官方交互式练习)

总结

自定义微件可以通过属性来扩展以控制行为,通过方法来扩展以实现基于脚本的交互。

事件使微件能够将用户操作传达给 SAP Analytics Cloud。

自定义数据类型提供可在脚本中访问的结构化数据,从而实现与故事逻辑更深入的集成。