配置混搭参数
您可以为混搭创建和配置参数。这些参数为具有 Parameter Value Changed 事件的可绑定源和目标。可使用以下字段配置混搭参数:
• “名称”:参数的名称。
• “基本类型”:
字段定义基本类型
基本类型 | 说明 |
---|
BOOLEAN | True 或 False 值。 |
DASHBOARDNAME | 仪表板名称。 |
DATASHAPENAME | 对模型中数据形状的引用,因此具有特殊处理。 |
DATETIME | 格式化的日期和时间。 |
HTML | 某些 HTML 内容。 |
HYPERLINK | 标准 URL (例如 www.thingworx.com)。 |
IMAGE | 可以渲染为图像的二进制数据。 |
IMAGELINK | 图像的 URL 链接。 |
INFOTABLE | ThingWorx 中数据的标准表示,类似于 SQL 结果集。有许多用于构建、使用和解析信息表的内置服务。 |
INTEGER | 写入时不包含小数部分的数字。 |
JSON | JavaScript 对象表示法字符串。 | 适用于 ThingWorx 8.4.0 及更高版本。 |
|
LOCATION | 标准世界大地测量系统 (WGS) 84 坐标,表示为 [经度,纬度],海拔。 |
LONG | 如果所需长度超出整数基本类型提供的范围,则应使用长整型。 |
MASHUPNAME | 对 ThingWorx 混搭的引用,因此具有特殊处理。 |
NOTHING | 未包含任何内容 (void)。 |
NUMBER | 一个数字。 |
PASSWORD | |
QUERY | 包括 "filters" 数组的 JSON 对象。每个筛选器都应包括 "value"、"type" 和 "fieldname"。 |
SCHEDULE | 基于 Cron 的计划 (使用计划编辑器进行配置)。 |
STRING | 任意数量的字母数字字符。 |
STYLETHEMENAME | 对样式主题的引用,因此具有特殊处理。 |
TAGS | ThingWorx 标记值。 |
TEXT | 任意数量的字母数字字符。文本与字符串的差异在于文本将进行索引。 |
THINGNAME | 对事物的引用,因此具有特殊处理。 |
THINGSHAPENAME | 对模型中事物形态的引用,因此具有特殊处理。 |
THINGTEMPLATENAME | 事物模板的名称。 |
TIMESPAN | TimeSpan 对象表示以天、小时、分钟、秒为单位计量的正数或负数时间间隔 (持续时间或已用时间)。 |
USERNAME | 对系统中所定义 ThingWorx 用户的引用。 |
XML | 一个 XML 片段或文档。 |
• “绑定方向”:源、目标或两者。
• “工具提示”:添加到混搭参数的文本,可作为悬停在参数上时显示的工具提示。
• “显示待办项”:如果选择该选项,则会显示在所包含的混搭中配置参数所需的附加步骤的提示。
• “删除”:移除混搭参数。
• “添加自定义配置表单”:将混搭添加为自定义配置。
ThingWorx 8.4.X 及更高版本的增强功能
为配置混搭参数,已完成下列增强功能:
• 您可以将基本类型设置为 JSON 类型。
此功能为高级开发人员带来了很大的灵活性。提供 JSON 编辑器,以允许用户键入 JSON。
• 可以将 InfoTable 类型分配至参数,但不分配 datashape。
在 ThingWorx 8.3.X 和更早版本中,Datashape 是必填内容。对于 8.4.X 和更高版本,它不再是必填内容,因此会更加灵活。这样,就可以将不同 datashapes 提供给混搭。
• 您可以控制参数的绑定方向:"←"(Source)、"→"(目标) 和 "↔"(两者)。
对于 8.3.X 和更早版本,该参数始终设置为“两者”方向,因此,在包含混搭时,您可能不清楚对参数执行哪些操作。现在,您可以控制绑定方向。
• 可以在每个参数的“待办事项”面板中添加“待办事项”指示。
因此,当其包含在“内置混搭”小组件中时,“待办事项”面板中将提供一个提示,建议填写此参数。
将混搭拖动到“内置混搭”小组件中后,这些参数将在“内置混搭”小组件的属性面板中变为可用状态,且您可以使用以下功能:
• 您可以将 JSON 字符串发送到“内置混搭”小组件。提供 JSON 编辑器,以允许用户键入 JSON。
• 您可以将不包含预定义数据形状的信息表发送至内置混搭参数。在 ThingWorx 8.3.X 和更早版本中,Datashape 是必填内容。对于 8.4.X 和更高版本,不是必填内容。
• 您可以轻松了解什么是“内置混搭”参数的绑定方向:"←"(源)、"→"(目标) 和 "↔"(两者)。对于 8.3.X 和更早版本,该参数始终设置为“两者”方向。
• 每个参数的“待办事项”面板中都有“待办事项”指示。
例如,对于下图所示的参数;
“内置混搭”小组件中的预期结果如下所示: