Mashup Builder > 小组件 > 高级栅格 > 使用配置服务
使用配置服务
要动态配置高级栅格或高级树形网格,请按以下步骤操作:
1. 在 ThingWorx Composer 中,将 JavaScript 配置服务编写为以 JSON 对象的形式输出结果。
2. 在 Mashup Builder 中创建栅格时,可在右侧面板中将配置服务添加为另一实体。
3. 在右侧面板配置实体中的“返回的数据”/“所有数据”下,将“结果”拖动到栅格并将其绑定到 Configuration 属性。
* 
将配置服务绑定到栅格时,Mashup Builder 面板中的大部分属性会消失。如果取消配置服务的绑定,则其他属性会再次显示。
4. 保存并查看已完成的混搭
编写配置服务脚本
可通过以下任意一种方式来编写配置脚本:
在 Composer 中为某一事物创建一个新服务并写入原始 Javascript。其中有多个选项卡可提供代码片段和其他有用的快捷方式。
在您首选的任何文本编辑器中编写 Javascript 服务,然后将其复制到 Composer 中某一事物上服务的脚本窗口中。
修改其中一个示例配置服务。要使用示例服务,请保存并导入 PTC 软件下载页面中 ThingWorx Foundation 下的示例文件。有关详细信息,请参阅 高级栅格示例文件
要在 ThingWorx Composer 中使用其中一个已导入的示例配置服务,请按以下步骤操作:
1. 请导航至“建模”/“事物”,并打开事物 GridAdvancedExampleServices
2. 单击左侧面板中的“服务”,则可用示例服务将会显示在右侧。
3. 选择其中一个配置服务,然后单击“编辑”以查看脚本窗口。
4. 单击“全屏”,以便更易于查看。
5. 修改脚本并进行保存。有关详细信息,请参阅下面的“配置服务参数”部分。
配置服务参数
配置服务的脚本包含以下几部分参数:
列 - 包含列定义和一些用于定义栅格中列的其他属性,如列标题和多列排序顺序。
大多数列定义属性很容易与 Mashup Builder 中提供的相应属性匹配。但是,只有当栅格的数据源与数据形状相关联时,Mashup Builder 中才会提供以下列定义属性。这样,以下属性便与“配置栅格列”对话框中的类似选项相对应:
hidden - 定义特定栅格列最初在视图中是可见还是隐藏。最终用户可以在运行时通过右键单击列标题来隐藏或取消隐藏列显示。对应于 Mashup Builder/“配置栅格列”中的“显示”属性。
inLayout - 定义最终用户是否可以看到特定的栅格列。设置为 false 时,最终用户看不到此列,且无法控制其外观。不过,仍可将此列中的数据用于状态格式。对应于 Mashup Builder/“配置栅格列”中的 Exclude 属性。
* 
可通过将本地化标记放在双方括号中来本地化 JSON 脚本中的列标题,如下所示。在运行时,系统会翻译已标记化的值。
如果使用标记化标题,但 ThingWorx 中不存在该标记,则 ??? 会在运行时显示在列标题中。要在 ThingWorx 中创建或修改标记,请导航至“系统”->“本地化表”,并使用“默认”表中的“本地化标记”列表。要将新标记添加到“默认”表中,可以将提供的 AddLocalizationToken 服务用作 GridAdvancedExamplesServices 事物的一部分。
行 - 行属性,如默认行选择、行高和基于行的状态格式行为。
样式 - 用于控制栅格外观的可选样式定义,例如背景颜色、边框样式、字体和状态特定样式。
仅当使用服务进行配置时,才能控制字体属性。字体选择并非 Mashup Builder 中提供的属性。
* 
仅当使用服务进行配置时,才能控制字体属性。字体选择并非 Mashup Builder 中提供的属性。
搜索 - 定义是否启用全局搜索,并在栅格上定位搜索框。
resetButton - 定义是否启用栅格重置选项,并提供“重置”按钮在栅格上的位置。