Écriture dans plusieurs variables simultanément
- Mise à jour2025-08-27
- Temps de lecture : 1 minute(s)
Autorisation requise : VariableÉcriture
Utilisez le format suivant pour mettre à jour les variables variable1 et variable2 du processus process1.
POST http://my_server:3580/nivariable/BatchWrite
Données POST JSON
[{
"Url"
: "ni.var.psp://localhost/process1/variable1", "Value"
: "false"
}, {
"Url"
: "ni.var.psp://localhost/process1/variable2", "Value"
: "\"this is a new string value\""
}]
Données POST XML
<?xml version="1.0" encoding="utf-8"?>
<BatchWriteArguments>
<BatchWriteArgument>
<Url>ni.var.psp://localhost/process1/variable1</Url>
<Value>false</Value>
</BatchWriteArgument>
<BatchWriteArgument>
<Url>ni.var.psp://localhost/process1/variable2</Url>
<Value>this is a new string value</Value>
</BatchWriteArgument>
</BatchWriteArguments>
Si toutes les écritures de variables réussissent, le serveur renvoie la réponse suivante avec un corps de réponse qui est un tableau vide :
HTTP/1.1 200 OK
Corps de la réponse (JSON)
[]
Corps de la réponse (XML)
<?xml version="1.0" encoding="utf-8"?>
<BatchWriteErrors>
</BatchWriteErrors>
Si une ou plusieurs écritures de variables échouent, la réponse inclut la description des erreurs. Par exemple, si variable2 n'est pas accessible en écriture, le serveur renvoie la réponse suivante :
HTTP/1.1 200 OK
Corps de la réponse (JSON)
[{
"Url"
: "ni.var.psp://localhost/process1/variable2", "Error"
: {
"code"
: "", "message"
: {
"lang"
: "en-us", "value"
: "ni.var.psp://localhost/process1/variable2 is not writable"
}
}]
Corps de la réponse (XML)
<?xml version="1.0" encoding="utf-8"?>
<BatchWriteErrors>
<BatchWriteError>
<Url><ni.var.psp://localhost/process1/variable2</Url>
<error xmlns="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata">
<code>0</code>
<message xml:lang="en-US">"ni.var.psp://localhost/process1/variable2 is not writable"</message>
</error>
</BatchWriteError>
</BatchWriteErrors>
Remarque Chaque lot écrit dans toutes les variables accessibles en écriture et renvoie des erreurs pour toutes les tentatives d'écriture ayant échoué. Une seule tentative d'écriture ayant échoué n'arrête pas l'écriture de tout le lot.