Mashup Builder > 混搭 > 配置混搭参数
配置混搭参数
您可以为混搭创建和配置参数。这些参数为具有 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
一个数字。
* 
允许使用指数值。例如,123e45
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 和更早版本,该参数始终设置为“两者”方向。
每个参数的“待办事项”面板中都有“待办事项”指示。
例如,对于下图所示的参数;
“内置混搭”小组件中的预期结果如下所示: