|
ローカル Thing と Remote Thing が同じ名前のプロパティを持つ場合に、リモートプロパティの設定に別のプロパティがバインドされると、そのリモートプロパティはローカルプロパティの値も設定します。
|
|
プロパティのバインドのセットアップ (ローカルおよびリモート) については、
プロパティバインドを管理を参照してください。
|
|
カスタムサービスを作成する際に、特定のエンティティの同じプロパティを同時に修正する可能性があるコードを生成しないようにしてください。たとえば、予期しないプロパティ値が発生する可能性があるので、プロパティ値を同時に増減しないでください。同様に、購読内でカウンタのような働きをするプロパティを増分することはよくある誤用であり、結果が不正確になります。
|
|
特定の状況でデータ変更イベントが発生しなかった場合、値ストリームのエントリはログに記録されない可能性がありますが、プロパティ値セットは維持されます。エンティティに対してプロパティを設定することは可能ですが、これらの書き込みを含むキーがいっぱいになり、データベースを空にできないことが原因で、対応する値ストリームの書き込みが削除されることがあります。これは、キューを空にするように設定されている速度よりも受信書き込みの量が多くなった場合に発生することがあります。これは永続化プロバイダごとに
platform-settings.json で調整できます。ThingWorx からデータベースへの接続が失われると、キューがバックアップされ、パフォーマンスの高い方法で空にならない場合もあります。
|
オプション
|
説明
|
||
---|---|---|---|
「リモートプロパティ名」
|
Edge に存在しているプロパティの名前。
|
||
「キャッシュメソッド」
|
キャッシュメソッドには、バインドする Edge プロパティ値を読み取るために、次の方法が提示されます。
• 「サーバーキャッシュから読み取り」では、サーバーが Edge プロパティ値をリクエストすることが禁止されます。サーバーから値を取得するだけになります。サーバーにキャッシュされた Edge プロパティ値への更新は、Edge プロパティの「データ変更タイプ」と「スキャン率」(Edge プロパティ値のプッシュ定義) によって決まります。Edge プロパティに正しい設定が行われていない場合、サーバーが Edge プロパティ値を持たず、サーバープロパティのデフォルト値を返してしまう可能性もあります。バインド先の Edge プロパティの「データ変更タイプ」が ALWAYS または VALUE と等しい場合、キャッシュタイプはこの設定がデフォルトになります。
• 「読み取りのたびにリモートからフェッチ」では、リクエストのたびに Edge から Edge プロパティ値を取得します。このオプションではキャッシュは行われません。バインド先の Edge プロパティの「データ変更タイプ」が NEVER と等しい場合、キャッシュタイプはこの設定がデフォルトになります。
• 「特定の時間のキャッシュ」は、Edge プロパティへのリクエストの頻度を制御します。最初のリクエストの後、サーバーはその値の Edge プロパティにアクセスし、定義されている秒数にわたって別の Edge プロパティへのリクエストを行いません。その間に Edge プロパティがサーバーの値を (プッシュを介して) 更新する可能性があることに注意してください。
|
||
「キャッシュ間隔」
|
リクエストによって Edge プロパティ値を Edge から取得する前に、サーバーが Edge プロパティ値をキャッシュしておく時間の長さ (秒数)。この値は、常に最初のリクエスト時に Edge から取得されます。
|
||
「開始タイプ」
|
リモートバインドされているプロパティの Thing の起動時または再起動時に、そのプロパティの初期化に使用する値を指定します。この初期化された値は、プロパティの変更イベントをトリガーしません。
• 「デフォルト値を使用」 - Edge 側の値にかかわらず、プロパティの初期値を指定されたデフォルト値に設定します。プロパティが永続化されている場合、初期値は、データベースに永続された最後の値に設定されます。
• 「Edge の値を読み取り」 - サーバー上で Thing が再起動された場合でも、サーバーの値と Edge の値が常に同期するように、Edge に対して現在の値をクエリーします。
|
||
「プッシュタイプ」
|
「プッシュタイプ」は強化された Edge Thing プロパティにのみ適用されます。これらのコンポーネントは、その値の変更をサーバーにプッシュできます。この機能は、サーバープロパティのバインドを使用して設定できます。
• 「値の変更に基づいてプッシュ」: 値の変更しきい値を設定できます。この設定を使用する場合は、「プッシュのしきい値」も設定できます。このしきい値は、Edge からサーバーに新しい値をプッシュするために超える必要があるデッドバンドです。
• 「プッシュしない」
• 「常時プッシュ」
|
||
「プッシュのしきい値」
|
このオプションは、「プッシュタイプ」が「値の変更に基づいてプッシュ」に設定されている場合に使用できます。プロパティ値のプッシュが発生するための、Edge プロパティ値の変更範囲 (プラスまたはマイナス) を指定します。プロパティ値が指定した値を超えて変更される必要があります。
|
||
「切断時」
|
Remote Thing への接続が一時的に失われた場合の、リモートのプロパティ値バインドの処理方法を指定します。
• 変更される値を無視する: 切断中。
• 「すべての変更を 1 つの最終変更値に折り込む」 - 接続が回復したら、最後の変更値を送信します。
|
||
「タイムアウト」
|
プロパティの読み取りまたは書き込みの実行中に Remote Thing への呼び出しに使用されるタイムアウト。
• 「システムデフォルトを使用」 - デフォルトは 30 秒です。
• 「カスタムタイムアウト」「タイムアウト間隔 (秒)」に追加します。
|
ベースタイプ
|
説明
|
||
---|---|---|---|
BASETYPENAME
|
有効なベースタイプの名前。
|
||
BLOB
|
バイナリラージオブジェクト。
|
||
BOOLEAN
|
値 true または false。
|
||
DASHBOARDNAME
|
ダッシュボードの名前。
|
||
DATASHAPENAME
|
モデル内のデータシェイプへの参照。特別な処理を使用します。
|
||
DATETIME
|
書式設定に従った日付と時刻。
|
||
GUID
|
グローバル一意識別子。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 ドキュメント。
|
|
「最小値」フィールドと「最大値」フィールドに入力される値は情報目的のみです。実際の値は、指定された値より小さいまたは大きい場合も受け入れられます。
|