サービス入力パラメータ
サービスを作成する際に、入力 (および出力) パラメータを定義できます。これらのパラメータは ThingWorx のどのベースタイプでもよく、サービスの必須パラメータとして設定できます。入力パラメータが必須として設定されている場合に、そのパラメータが指定されていない場合、サービスは実行されません。
サービスがマッシュアップで使用されている場合、Mashup Builder のデータプロパティパネルにパラメータがバインド可能パラメータとして表示されます。
サービス入力パラメータの命名
名前は、パラメータを一意に識別する必須フィールドです。空白、特殊文字 (ハイフンとアンダースコアは使用可能。以下を参照)、先頭の数字 (名前の 2 文字目以降には数字を使用可能) は使用できません。名前では大文字と小文字が区別されます。
名前にハイフンを含む入力パラメータ
サービス入力パラメータの名前にハイフンが含まれていても構いませんが、そのようなパラメータは特別な方法で参照する必要があります。そのようなパラメータが定義されているサービス内からは、キーワード this と括弧表記を使用してこのパラメータを参照する必要があります。以下の例では、temp-01 が入力パラメータ名です。
var result = this['temp-01'];
別のサービスからそのサービスを呼び出す場合、以下のどちらかの例に従ってパラメータを渡す必要があります。
var params = new Object();
params['temp-01'] = "Some text";
または
var params = {};
params['temp-01'] = "Some text";