データシェイプはモデル内のデータを表します。データシェイプは、フィールド定義と関連メタデータの名前付きセットです。データシェイプ内の各フィールドがデータ型を持ちます。ThingWorx には定義済みのベースタイプのセットがあります。

データシェイプは、アプリケーションの作成に役立ちます。アプリケーションがデータを消費するときに、データシェイプ定義があると、そのデータセットを表す方法についての知識がアプリケーションに組み込まれるためです。たとえば、マッシュアップ上のグリッドにデータを渡すと、グリッドではデータシェイプ定義に基づいてそのデータがどのようなものであるかが判別されます。グリッドではどのフィールドが数値、文字列、日付であるかが判別されます。グリッドでのデータのレンダー方法を設定する際には、データセットに関するこの情報によって設定がはるかに簡単になります。

データを保存するために作成されている特別な Thing として、ストリーム、値ストリーム、データテーブルがあります。データストレージ Thing を定義する場合、データシェイプを定義する必要があります (値ストリームを除く)。

データシェイプはストリーム、値ストリーム、データテーブル用の定義以外にも多くの場面で使用されます。データシェイプはデータセットを定義しなければならない場合にも必ず使用します。たとえば、サービス実装のためのインフォテーブル出力を定義する場合、データシェイプを使用して出力結果セットを定義します。INFOTABLE タイプの Thing プロパティを作成でき、そのプロパティを定義するデータシェイプも指定できます。

データシェイプのフィールドを定義する場合、少なくとも 1 つのフィールドをプライマリキーとしてマークする必要があります。MSSQL を永続化プロバイダとして使用している場合、プライマリキーの値の長さ (複数のフィールドがプライマリキーとしてマークされている場合には、各プライマリキーの値の長さの合計) は 128 文字に制限されます。設定する値の長さが 128 文字を超えている場合、使用している MSSQL のバージョンに応じて、次のいずれかのエラーメッセージが表示されます。

既存のデータシェイプを定義後に更新する場合 (フィールド定義、タイプ、またはプライマリキーの変更)、以下の影響を考慮してください。