使用代码库

1.概述

代码库允许developer用户中引用的可重用脚本脚本编辑器在仪表板和其他视图中。

例如,您可能希望从多个指示板调用通用的脚本行或帮助函数。代码库允许您编写并保存此脚本一次,并从多个视图引用它。您还可以在其他代码库中引用代码库,以避免进一步的重复。

2.创建一个代码库

您可以在打开文件(如仪表板或其他类型的视图)进行编辑时创建代码库。

探索窗口,右键单击代码库文件夹,然后选择新的JavaScript代码库

创建一个新的代码库
创建一个新的代码库

打开代码库对话框。点击进入名字字段来命名库并确认保存位置保存对话框,然后单击底部的提交按钮以返回代码库对话框。

您可以选择在Save对话框中创建一个新的子文件夹,方法是再次右键单击Code Libraries文件夹并选择新文件夹,然后输入名称和回车键。

创建一个新的代码库
创建一个新的代码库

点击添加引用如果您有其他代码库,其中包含此代码库应该能够引用的脚本,或者应该在使用此代码库时包含该脚本。

您可以将脚本直接写入或粘贴到对话框中显示的编辑器中,该编辑器具有许多与脚本编辑器在编辑视图时显示,包括自动完成弹出框。你也可以点击选择文件浏览…(取决于浏览器)上载一个扩展名为.js的文件。

代码库JavaScript将在引用它的视图被加载时立即运行<脚本>元素在其页面上。您可以包含任何应该包含在这些页面上的JavaScript,例如应该从添加到仪表板事件的脚本操作中调用的函数。下面是一些例子:

函数mySimpleFunction(){返回"Hello!";}窗口。corporateLibrary ={调色板:["#418cf0", "#fcb441", "#e0400a", "#056492", "#bfbfbf", "#1a3c69", "#e1e480", "#119cdd", "#cb6a49", "#005cdb", "#f4d288", "#506381", "#f1b9a8", "#e0830a", "#7893be"], applyPaletteColors: function (colorRules) {var discreterrules = colorRules。filter(function (rule){返回dundas.controls.DiscreteColorRule的规则实例;});discreteRules。forEach(函数(规则,索引){var colorString = corporateLibrary。调色板[index % corporateLibrary.palette.length];规则。value = dundas.controls.Color.fromString(colorString);});}};

单击对话框底部的提交按钮以保存和检查中选择的位置中的代码库代码库文件夹中。

要编辑代码库,请在探索窗口并双击它,或右键单击它并选择编辑

3.使用代码库

在编辑指示板、报表或其他视图时,可以在属性那个视图的窗口。如果选择了任何元素或控件,请单击画布的空白部分以取消对其的取消选择,并显示视图自己的属性。

行动范畴,扩大代码库然后点击+按钮。

在属性中向视图添加代码库
在属性中向视图添加代码库

开放对话框中,选择要使用的代码库,然后单击底部的提交按钮。

选择代码库
选择代码库

代码库脚本通常需要从脚本操作中访问或调用。使用脚本编辑器为事件访问,例如加载准备好了在仪表板或视图本身,或点击在可视化或其他控件上,您现在可以引用代码库的脚本。

在仪表板加载脚本中使用代码库
在仪表板加载脚本中使用代码库

添加到视图中的代码库在第一次打开视图时包含在该页上。点击沙箱视图在工具栏中,立即在视图模式下的新选项卡或窗口中打开仪表板,并加载所有代码库并运行脚本。

提示
如果代码库脚本即使在编辑模式下也会导致视图出现问题,则可以添加? IgnoreBuiltInResources = true到浏览器地址栏中的URL(或&IgnoreBuiltInResources = true遵循其他参数)。

请注意
使用视图容器来嵌入视图,这两个视图中的代码库将被添加到页面中。

您还可以重新打开当前文件或刷新要加载的任何新添加的代码库的页面,但请注意,脚本操作只能在视图模式下运行,并且必须将仪表板直接打开到视图模式才能运行脚本操作。

单击沙盒视图后的示例结果
单击沙盒视图后的示例结果

4.另请参阅

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

北美:1.800.463.1492
国际:1.416.467.5100

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