必要な権限 (Required permission): VariableCreateDeleteGroup

VariableValueGroupは、変数値のカスタマイズしたリストを参照します。これらの変数の値は、1つの要求で読み取ることができます。また、$deltatoken機能を使用することで、変数の更新された値だけを取得することもできます。

変数グループを使用するには、まずグループを作成する必要があります。例: POST http://my_server:3580/nivariable/VariableValueGroups

POST JSONデータ:

  HTTP Header - Content-Type : application/jsonHTTP Body -{
  
   "VariableValues"

  : [{ "__metadata" : {

   "uri"

  : "http://my_server:3580/nivariable/VariableValues('ni.var.psp://localhost/process1/variable1')"} }, { "__metadata" : {

   "uri"

  : "http://my_server:3580/nivariable/VariableValues('ni.var.psp://localhost/process2/variable2')"} }]}

POST XMLデータ:

  HTTP Header - Content-Type : application/xmlHTTP Body -<?xml version="1.0" encoding="utf-8"?><entry xmlns:d="http://my_server:3580/nivariable/" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom"> <title type="text"></title> <updated>2010-02-27T21:36:47Z</updated> <author> <name /> </author> <category term="nivariable.VariableValueGroup" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" /> <link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/VariableValues" href="VariableValues('ni.var.psp://localhost/process1/variable1')"/> <link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/VariableValues" href="VariableValues('ni.var.psp://localhost/process1/variable2')"/> <content type="application/xml"> <m:properties> <d:Timeout>15000</d:Timeout> </m:properties> </content></entry>
メモ VariableValueGroupsのリソースを作成するときは、必須プロパティを含める必要はありません。VariableValueGroupのIDプロパティは、通常、必須プロパティです。ODataで作成されたリソースには必須プロパティを含める必要があります。しかし、どのIDが使用可能かを確認する方法はありません。要求を送信するためにODataクライアントにIdプロパティの値が必要な場合は、ランダムな値を割り当てることができます。変数Webサービスは、ユーザが渡したIdプロパティ値を固有の値に置き換えます。

VariableValueGroupが作成されている場合、サーバは201応答を返し、新たに作成されたリソースのURIを示すLocationヘッダを追加します。応答本文には、新たに作成されたグループのIDが含まれます。

VariableValueGroupが作成されていない場合、サーバは以下のいずれかの応答を返します。

  • 500 内部サーバエラー - サーバ側でエラーが発生しました。
  • 400 不正な要求 - 要求されたPOSTデータは無効です。

応答本文は、標準ODataエラーオブジェクトを使用して失敗の原因を表示します。