필요한 권한: VariableCreateDeleteGroup

변수값 그룹은 변수값의 사용자 정의된 리스트를 참조합니다. 한 번의 요청으로 이러한 변수의 값을 읽을 수 있습니다. $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>
노트 변수값 그룹의 리소스를 생성할 때 요구되는 프로퍼티는 포함하지 않아도 됩니다. 변수값 그룹의 ID 프로퍼티는 일반적으로 요구되는 프로퍼티이고, OData에서 생성되는 리소스에는 요구되는 프로퍼티가 반드시 포함되어야 합니다. 그러나 어떤 ID가 사용 가능한지 알 수 있는 방법은 없습니다. OData 클라이언트가 요청을 보내기위해 ID프로퍼티의 값을 요구하는 경우, 임의의 값을 할당할 수 있습니다. 변수 웹 서비스는 사용자가 제공한 ID 프로퍼티 값을 고유한 값으로 대체합니다.

VariableValueGroup이 생성되면 서버는 201 응답을 반환하고 새로 생성한 리소스의 URI를 나타내는 위치 헤더를 추가합니다. 응답 본문에는 새로 생성된 그룹의 ID가 포함되어 있습니다.

변수값 그룹이 생성되지 않는 경우, 서버는 다음 응답 중 하나를 반환합니다:

  • 500 내부 서버 에러―서버에서 에러가 발생했습니다.
  • 400 유효하지 않은 요청―요청된 POST 데이터가 유효하지 않습니다.

응답 본문은 표준 OData 에러 객체를 사용하여 실패의 원인을 나타냅니다.