属性基本类型
属性基本类型
已定义的基本类型将为属性中所存储的数据提供上下文。下表列出了适用于所有事物实体的基本类型：
 |
不受 ThingWorx 支持的属性类型将被视为 STRING。
|
|
基本类型
|
说明
|
||
|---|---|---|---|
|
BASETYPENAME
|
有效的基本类型名称。
|
||
|
BLOB
|
二进制大对象 (BLOB)。
|
||
|
BOOLEAN
|
True 或 False 值。
|
||
|
DASHBOARDNAME
|
仪表板名称。
|
||
|
DATASHAPENAME
|
对模型中数据形状的引用。使用特殊处理。
|
||
|
DATETIME
|
格式化的日期和时间。对于持久化和非持久化属性，DATETIME 的平台默认 (default) 值 (如果未在属性定义中明确设置默认值) 为 Unix epoch (1/1/1970)。
|
||
|
GUID
|
全局唯一标识符。对于持久化和非持久化属性，平台默认 (default) 值为 Nil GUID (00000000-0000-0000-0000-000000000000)。创建 GUID 属性后，如果用户未设置默认值或值，则会自动创建一个 GUID。持久化和非持久化 GUID 属性遵循以下行为，且以下行为也适用于联合身份验证模式：
• 如果该属性设置为持久化或非持久化，并且用户未设置默认值或值，则每次初始化事物时都会生成一个新的 GUID 值。如果系统或事物重新启动，则会生成一个新值。
• 如果该属性是持久化的，并且用户设置了默认值或值，则事物或系统重新启动时不会生成新值。
|
||
|
GROUPNAME
|
用户组名称。
|
||
|
HTML
|
HTML 内容。
|
||
|
HYPERLINK
|
标准 URL (例如 www.ptc.com)。
|
||
|
IMAGE
|
可以渲染为图像的二进制数据。
|
||
|
IMAGELINK
|
图像的 URL 链接。
|
||
|
INFOTABLE
|
ThingWorx 中数据的标准表示，类似于 SQL 结果集。有许多用于构建、使用和解析信息表的内置服务。
|
||
|
INTEGER
|
写入时不包含小数部分的数字。
|
||
|
JSON
|
Javascript 对象表示法 (JSON) 对象。
|
||
|
LOCATION
|
标准世界大地测量系统 (WGS) 84 坐标，表示为 [经度，纬度]，海拔。
|
||
|
LONG
|
当所需长度超出 INTEGER 基本类型可提供的范围时，应使用 LONG 类型。
|
||
|
MASHUPNAME
|
对 ThingWorx 混搭的引用。使用特殊处理。
|
||
|
MENUNAME
|
菜单名称。
|
||
|
NUMBER
|
一个数字。
|
||
|
PASSWORD
|
掩码密码值。
|
||
|
QUERY
|
包括 filters 数组的 JSON 对象。每个筛选器都应包括 value、type 和 fieldname。
|
||
|
SCHEDULE
|
使用计划编辑器配置的基于 cron 的计划。
|
||
|
STRING
|
任意数量的字母数字字符。
|
||
|
TAGS
|
ThingWorx 标记值。
|
||
|
TEXT
|
任意数量的字母数字字符。与 STRING 的区别在于对 TEXT 进行了索引。
|
||
|
THINGCODE
|
事物的数值表示，包含“域 ID”和“实例 ID”。例如 2:1。
|
||
|
THINGNAME
|
对模型中事物的引用。使用特殊处理。
|
||
|
THINGSHAPENAME
|
对模型中事物形态的引用。使用特殊处理。
|
||
|
THINGTEMPLATENAME
|
事物模板的名称。
|
||
|
USERNAME
|
对 ThingWorx 用户的引用。
|
||
|
VEC2
|
两个数字的集合。例如，2D 坐标 x 和 y。
|
||
|
VEC3
|
三个数字的集合。例如，3D 坐标 x、y 和 z。
|
||
|
VEC4
|
四个数字的集合。例如，4D 坐标 x、y、z 和 w。
|
||
|
XML
|
一个 XML 片段或文档。
|
|
|
在“最小值”和“最大值”字段中输入的值仅供参考。可接受小于或大于指定值的实际值。
|
属性基本类型自 ThingWorx 9.4.0 起已更改
|
OData 规范
|
旧式映射
|
最新映射
|
||
|---|---|---|---|---|
|
OData 数据类型
|
ThingWorx 数据类型
x-twx-datatype
|
ThingWorx 数据格式
|
ThingWorx 数据类型
x-twx-datatype
|
ThingWorx 数据格式
|
|
Edm.String
|
STRING
|
—
|
STRING
|
—
|
|
Edm.Guid
|
STRING
|
uuid
|
STRING
|
uuid
|
|
Edm.Boolean
|
BOOLEAN
|
—
|
BOOLEAN
|
—
|
|
Edm.Byte
|
STRING
|
字节
|
STRING
|
字节
|
|
Edm.Sbyte
|
INTEGER
|
—
|
INTEGER
|
—
|
|
Edm.lnt
|
INTEGER
|
—
|
INTEGER
|
—
|
|
Edm.lnt32
|
INTEGER
|
—
|
INTEGER
|
—
|
|
Edm.lnt64
|
LONG
|
int64
|
LONG
|
int64
|
|
Edm.Decimal
|
NUMBER
|
—
|
NUMBER
|
—
|
|
Edm.Single
|
NUMBER
|
浮点数
|
NUMBER
|
浮点数
|
|
Edm.Double
|
STRING
|
双精度
|
NUMBER
|
双精度
|
|
Edm.Date
|
STRING
|
日期
|
DATETIME
|
日期
|
|
Edm.DateTime
|
STRING
|
日期时间
|
DATETIME
|
日期时间
|
|
Edm.DateTimeOffset
|
STRING
|
日期时间
|
DATETIME
|
日期时间
|
|
Edm.Time
|
STRING
|
日期时间
|
DATETIME
|
日期时间
|
|
Edm.TimeOfDay
|
STRING
|
日期时间
|
DATETIME
|
日期时间
|