使用属性、方法和事件为自定义微件添加交互性
学习目标
使用属性、方法和事件扩展自定义微件,以实现脚本编写、用户交互以及微件与 SAP Analytics Cloud 之间的数据交换。
添加属性和方法
自定义微件可以通过以下内容进行扩展:
属性 ,它们定义随故事存储的可配置设置,
方法 ,它们可以从脚本中调用以控制微件。
属性和方法实现了对自定义微件的配置和脚本驱动的控制。
练习
在本练习中,你将添加一个新属性,并公开一个方法,使你能够从故事脚本动态更改图表类型。
你将:
在微件元数据中定义自定义属性
公开一个用于基于脚本的交互的方法
使用故事中的按钮控制微件行为
在本地修改自定义微件文件后,你将:
添加一个按钮并为其分配脚本
点击该按钮
观察图表从折线图变为条形图。
结果
该微件可通过脚本控制,从而能够动态更改图表类型。
练习:开始练习(SAP 官方交互式练习)
添加事件并与来自 ECharts 的点击事件集成
自定义微件可以发出事件,这些事件可在 SAP Analytics Cloud 脚本编写中使用。
练习
在本练习中,你将:
在微件元数据中定义自定义事件
基于用户交互(点击图表数据点)触发该事件
在 Script Editor 中访问该事件
结果
该自定义事件在 Script Editor 中可用,并可在脚本中使用。
练习:开始练习(SAP 官方交互式练习)
添加自定义数据类型
自定义数据类型简化了脚本中与数据的交互。这意味着自定义微件可以公开可从脚本访问的结构化数据。
练习
在本练习中,你将扩展该微件,使其返回有关图表中所选数据点的信息。
你将:
向故事中添加一个文本组件
在 Outline Panel 中找到该自定义微件,并点击“fx”按钮
编写脚本以解析来自该自定义微件的所选数据
在图表中选择一个数据点,并观察文本组件中的值
结果
当你在图表上选择一个数据点时,所选数据会显示在文本组件中。
练习:开始练习(SAP 官方交互式练习)
总结
自定义微件可以通过属性来扩展以控制行为,通过方法来扩展以实现基于脚本的交互。
事件使微件能够将用户操作传达给 SAP Analytics Cloud。
自定义数据类型提供可在脚本中访问的结构化数据,从而实现与故事逻辑更深入的集成。