プロパティのベースタイプ
プロパティのベースタイプ
定義済みのベースタイプは、プロパティに格納されるデータの周囲のコンテキストを提供します。次の表は、すべての Thing エンティティで使用できるベースタイプを示しています。
 |
ThingWorx でサポートされていないプロパティタイプの場合、プロパティタイプは STRING と見なされます。
|
|
ベースタイプ
|
説明
|
||
|---|---|---|---|
|
BASETYPENAME
|
有効なベースタイプの名前。
|
||
|
BLOB
|
バイナリラージオブジェクト。
|
||
|
BOOLEAN
|
値 true または false。
|
||
|
DASHBOARDNAME
|
ダッシュボードの名前。
|
||
|
DATASHAPENAME
|
モデル内のデータシェイプへの参照。特別な処理を使用します。
|
||
|
DATETIME
|
書式設定に従った日付と時刻。(プロパティ定義でデフォルトが明示的に設定されていない場合) 永続および非永続 DATETIME プロパティのプラットフォームのデフォルト (default) 値は、Unix エポック (1/1/1970) です。
|
||
|
GUID
|
グローバル一意識別子。永続および非永続 GUID プロパティのプラットフォームのデフォルト (default) 値は、Nil GUID (00000000-0000-0000-0000-000000000000) です。GUID プロパティが作成されると、デフォルト値または値がユーザーによって設定されていない場合、GUID が自動的に作成されます。以下の動作は永続および非永続 GUID プロパティに適用され、これはフェデレーションのシナリオでも当てはまります。
• プロパティが永続または非永続として設定され、デフォルト値または値がユーザーによって設定されていない場合、Thing が初期化されるたびに新しい GUID 値が生成されます。システムまたは Thing が再起動した場合、新しい値が生成されます。
• プロパティが永続でデフォルト値または値がユーザーによって設定されている場合、Thing またはシステムが再起動したときに新しい値は生成されません。
|
||
|
GROUPNAME
|
ユーザーグループの名前。
|
||
|
HTML
|
HTML コンテンツ。
|
||
|
HYPERLINK
|
標準 URL (www.ptc.com など)。
|
||
|
IMAGE
|
イメージとしてレンダー可能なバイナリデータ。
|
||
|
IMAGELINK
|
イメージへの URL リンク。
|
||
|
INFOTABLE
|
ThingWorx におけるデータの標準的な表現。SQL 結果セットとほぼ同じです。インフォテーブルの構築、消費、解析用に多数の組み込みサービスが用意されています。
|
||
|
INTEGER
|
小数部なしで書き込み可能な数値。
|
||
|
JSON
|
JavaScript Object Notation (JSON) オブジェクト。
|
||
|
LOCATION
|
標準世界測地系 (WGS) 84 座標。[緯度, 経度], 標高として表されます。
|
||
|
LONG
|
必要な範囲が、INTEGER ベースタイプによって指定される範囲より長い場合は、LONG タイプを使用する必要があります。
|
||
|
MASHUPNAME
|
ThingWorx マッシュアップへの参照。特別な処理を使用します。
|
||
|
MENUNAME
|
メニューの名前。
|
||
|
NUMBER
|
数値。
|
||
|
PASSWORD
|
マスクされたパスワードの値。
|
||
|
QUERY
|
フィルタの配列を含む JSON オブジェクト。各フィルタに value、type、fieldname が含まれている必要があります。
|
||
|
SCHEDULE
|
Schedule Editor を使用して設定される cron ベースのスケジュール。
|
||
|
STRING
|
任意の数の英数字。
|
||
|
TAGS
|
ThingWorx タグの値。
|
||
|
TEXT
|
任意の数の英数字。STRING との違いとして、TEXT にはインデックスが付きます。
|
||
|
THINGCODE
|
ドメイン ID とインスタンス ID を含む Thing の数値表現。たとえば、2:1。
|
||
|
THINGNAME
|
モデル内の Thing への参照。特別な処理を使用します。
|
||
|
THINGSHAPENAME
|
モデル内の Thing Shape への参照。特別な処理を使用します。
|
||
|
THINGTEMPLATENAME
|
Thing Template の名前。
|
||
|
USERNAME
|
ThingWorx ユーザーへの参照。
|
||
|
VEC2
|
2 つの数値の集合。たとえば、2D 座標 x と y。
|
||
|
VEC3
|
3 つの数値の集合。たとえば、3D 座標 x、y、z。
|
||
|
VEC4
|
4 つの数値の集合。たとえば、4D 座標 x、y、z、w。
|
||
|
XML
|
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
|
byte
|
STRING
|
byte
|
|
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
|
float
|
NUMBER
|
float
|
|
Edm.Double
|
STRING
|
double
|
NUMBER
|
double
|
|
Edm.Date
|
STRING
|
date
|
DATETIME
|
date
|
|
Edm.DateTime
|
STRING
|
date-time
|
DATETIME
|
date-time
|
|
Edm.DateTimeOffset
|
STRING
|
date-time
|
DATETIME
|
date-time
|
|
Edm.Time
|
STRING
|
date-time
|
DATETIME
|
date-time
|
|
Edm.TimeOfDay
|
STRING
|
date-time
|
DATETIME
|
date-time
|