使用脚本编辑器

1.概述

在编辑仪表板或其他视图时,脚本编辑器允许您添加自定义功能。

这个内置编辑器支持的脚本语言是JavaScript

登打士BI脚本编辑器
登打士BI脚本编辑器

在编辑数据集时也可以使用Script Editor窗口,它提供了以下用于编写的功能子集SQL或MDXPython或R,或DundasScript

提示
你也可以用代码库在多个仪表板和其他视图之间重用脚本。管理员还可以设置自定义JavaScript,以便在站点级别

2.打开脚本编辑器

您的帐户需要有一个开发人员座位编辑脚本。打开脚本进行编辑属性窗口,用于指示板或其他视图,或者当其画布上的某些元素被选中时。

向下滚动到行动节并展开要处理的事件。单击加号以添加新脚本或选择现有脚本。

将脚本添加到仪表板的Ready操作中
将脚本添加到仪表板的Ready操作中

脚本编辑器窗口默认情况下打开并停靠在画布的底部。

3.脚本编辑器的元素

脚本编辑器由以下主要元素组成:

  • 工具栏
  • 脚本资源管理器面板
  • 编辑器区域

提示
您可以在不同区域和面板之间拖动分割器来调整它们的大小。

3.1.工具栏

脚本编辑器中的工具栏允许您:

  • 构建检查它是否有效的脚本
  • 去一个特定的脚本中的数字
  • 撤销重做您在编辑器中的更改
  • 显示或隐藏脚本的探险家面板
  • 看到名字你的剧本
  • 看看是什么行号和您在编辑器中(即光标位置)。

脚本编辑器工具栏
脚本编辑器工具栏

3.2.脚本的探险家

脚本资源管理器允许您在当前视图上导航对象的属性和方法,以及控件中可用的数据类型Dundas BI JavaScript API

要显示或隐藏脚本资源管理器面板,请单击脚本的探险家按钮。

脚本资源管理器面板有两个部分:对象资源管理器和类型资源管理器。

对象资源管理器列出视图中当前可用的所有对象(按字母顺序),这些对象可以通过在编辑器中编写的语句进行操作。

对象资源管理器
对象资源管理器

展开左边的三角形,查看每个对象上可用的属性和方法。

展开三角形以查看属性和方法
展开三角形以查看属性和方法

浏览器类型列出脚本支持的所有数据类型(类似于API参考)。

探索可用的类型
探索可用的类型

3.3.编辑器

编辑器是一个较大的文本区域,您可以在其中编写和编辑脚本。

编辑器区域
编辑器区域

4.功能

4.1.构建脚本

点击构建在编辑器工具栏中构建脚本并检查语法错误。

如果检测到错误,请单击错误链接,将编辑器光标移动到错误所在的位置。

单击错误以转到其在代码中的位置
单击错误以转到其在代码中的位置

如果没有错误,您将看到一条指示脚本有效的消息。

脚本有效
脚本有效

4.2.转到行号

若要将光标移动到脚本中的特定行号,请单击在编辑器工具栏中。

输入行号,然后单击

转到特定的行号
转到特定的行号

4.3.撤销和重做

使用撤销重做按钮以恢复或重新应用编辑器区域中的操作。

撤销和重做
撤销和重做

4.4.自动完成

脚本编辑器提供自动完成(或代码完成)支持:ECMA5、ECMA6、浏览器、jQuery和Dundas BI JavaScript API。当您在编辑器区域中键入时,将出现自动完成弹出框,帮助您选择要包含的所需属性、方法、函数或其他构造。例如:

列出属性和方法-输入编辑器中任何变量引用、属性名或数组元素后面的字符。您将立即看到一个自动完成的弹出框,其中列出了该对象的属性和方法,以及相应的API描述。使用箭头键在可用的选项中循环,或者用鼠标单击一个项目。找到要插入脚本的项后,按下输入或者双击项目。

自动完成弹出窗口,显示图表系列的属性和方法以及描述
自动完成弹出窗口,显示图表系列的属性和方法以及描述

自动完成弹出选择边框样式
自动完成弹出选择边框样式

显示文档-无论你在哪里打字,点击文档在编辑器工具栏中或按下CTRL + O在弹出窗口中显示当前属性、对象或参数的文档,包括其类型。

单击文档的相关页面的链接JavaScript API参考

按CTRL+O查看当前对象的文档
按CTRL+O查看当前对象的文档

函数/方法参数-在方法或函数的情况下,一旦你按下ENTER键将其添加到脚本中,键入左括号'('来查看函数/方法签名。第一个必需的参数将加下划线。当您键入每个参数时,弹出窗口将显示所需的下一个参数。

自动完成弹出显示方法签名并突出显示所需的下一个参数
自动完成弹出显示方法签名并突出显示所需的下一个参数

所有可用类型—当进入新的一行时,按CTRL + SPACE要查看显示所有可用类型的自动完成弹出框。

自动完成弹出显示所有可用的类型在一个新的行
自动完成弹出显示所有可用的类型在一个新的行

下表描述了自动完成弹出框中的图标的含义:

图标 JS型
一个 数组
F 函数
B 布尔
1 数量
年代 字符串
O 对象
未知的

4.5.突出显示当前对象的实例以进行重命名

若要重命名对象的所有实例,请将光标移到其中一个实例上或单击它。

新闻CTRL +。以选择对象的所有实例,然后键入新名称。

突出显示要重命名的对象的所有实例
突出显示要重命名的对象的所有实例

4.6.跳转到对象声明

当光标在对象上时,按ALT +。突出显示定义对象的位置(即itsvar声明)。

按下ALT +。跳转到对象声明
按下ALT +。跳转到对象声明

4.7.注释当前行或选中的行

新闻CTRL + /在编辑器中注释当前行(光标所在的位置)或多个选定行。

如果当前行或选定的行已经被注释,则此键序列将取消对该行或选定行的注释。

在Mac电脑上,使用CTRL + /CMD + /注释或取消注释代码的工作原理相同。

按CTRL+/注释或取消注释代码行
按CTRL+/注释或取消注释代码行

5.运行脚本

脚本操作添加到事件只会跑进去视图模式。点击是很好的练习沙箱视图在工具栏中,在隐藏工具栏的单独浏览器选项卡中测试您的脚本,因为您通常不希望脚本的结果被保存,然后在下次为每个人加载。

请注意,诸如加载准备好了在仪表板上,只有当仪表板直接打开到视图模式时才会触发。您可以重新打开该指示板,重新加载页面,或者使用沙箱视图选项。

6.另请参阅

Dundas数据可视化公司
热维斯路400-15号
加拿大安大略省多伦多
M3C 1日元

北美:1.800.463.1492
国际:1.416.467.5100

登打士服务时间:
电话:美国东部时间周一至周五上午9点至下午6点
电子邮件:美国东部时间周一至周五上午7点至下午6点