Erforderliche Berechtigung: VariableCreateDeleteGroup

Eine VariableValueGroup bezieht sich auf eine benutzerdefinierte Liste von Variablenwerten. Die Werte dieser Variablen lassen sich mit einer einzigen Anforderung abfragen. Mit Hilfe von $deltatoken lassen sich nur die aktualisierten Werte dieser Variablen abfragen.

Zur Verwendung einer Variablengruppe muss zuerst eine Gruppe erstellt werden. Zum Beispiel: POST http://Mein_Server:3580/nivariable/VariableValueGroups

POST-Daten (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-Daten (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>
Hinweis Erforderliche Eigenschaften müssen beim Erstellen von Ressourcen für VariableValueGroups nicht einbezogen werden. Die ID-Eigenschaft einer VariableValueGroup ist normalerweise erforderlich und in OData erstellte Ressourcen müssen erforderliche Eigenschaften enthalten. Es lässt sich jedoch nicht bestimmen, welche IDs zur Verfügung stehen. Wenn Ihr OData-Client zum Senden einer Anfrage einen Wert für die Eigenschaft Id erfordert, kann ein zufälliger Wert verwendet werden. Der Variablen-Webdienst ersetzt die bereitgestellte Eigenschaft Id durch einen eindeutigen Wert.

Wenn VariableValueGroup erstellt wurde, gibt der Server die Antwort 201 aus und fügt den Header Location an. Dieser Header steht für die neu erstellte URI der Ressource. Die Antwort enthält die ID der neuen Gruppe.

Wenn VariableValueGroup nicht erstellt wurde, gibt der Server eine der folgenden Antworten aus:

  • 500 Interner Server-Fehler - Der Fehler trat am Server auf.
  • 400 Falsche Anfrage - Die angeforderten POST-Daten sind ungültig.

Die Antwort verwendet das Standard OData-Fehlerobjekt zur Anzeige der Fehlerursache.