Bearbeitet die Eigenschaften eines Vorgangs.
Abfrage
| Vorgehensweise | URL |
|---|---|
| PUT | RACINEVP/ws/rest/Vorgang/modify |
| Typ | Parameter | Werte |
|---|---|---|
| HEAD | apikey | Zeichenkette |
| DATEN | Attribute | Zeichenkette |
| DATEN | Schlüssel | Zeichenkette |
| DATEN | parentKeys | Zeichenkette |
| DATEN | forceCreate | Zeichenkette |
apikey
Der API-Schlüssel des Anwenders (muss in allen Abfragen übermittelt werden). Ruft die WebService für einen bestimmten Anwender und Planer ab.
Attribute
Liste der zu bearbeitenden Attribute:
[{« entityName » : « attr1 », « entityValue » : « value1 },…]
Schlüssel
Liste der Identifikationsattribute des Vorgangs:
[{« entityName » : « attr2 », « entityValue » : « value2 },…]
parentKeys [optional]
Liste der Identifikationsattribute des übergeordneten Vorgangs:
[{« entityName » : « attr3 », « entityValue » : « value3 },…]
forceCreate [optional]
Akzeptiert die Werte „true“ oder „false“. Ist der Wert „true“, wird ein Vorgang angelegt, sofern im Planer kein passender Schlüssel vorhanden ist.
Antwort
Statusmeldung
| 1 | Ungültige Sitzung: apikey |
|---|---|
| 2 | Ungültiges Attribut: entityName |
| 3 | Update KO |
Beispiel:
Für den Planer „DEMO API REST“, der auf einem Server unter Visual Planning installiert ist und dessen Stamm-URL http://127.0.0.1:8906/ip50, einen Vorgang enthält, der durch die Attribute „Kunde“, „Projekt“, „Phase“ und „Aufgabe“ identifiziert wird und dessen Enddatum wir auf den 30.03.2018 ändern möchten. Mit einem Anwender, dessen Zugriffsschlüssel für die API lautet: d9f79618-59e4-a710-8203-a39bab9ad09b, ergibt sich Folgendes:
URL:
http://127.0.0.1:8906/ip50/ws/rest/event/modify
Veröffentlichte Daten:
{
„Schlüssel“:
[
{"entityName":"Tâches-Client","entityValue":"Client 1"},
{"entityName":"Tâches-Projet","entityValue":"Projet 1"},
{"entityName":"Tâches-Phase","entityValue":"Phase 1"},
{"entityName":"Tâches-Tâche","entityValue":"Analyse"},
],
„Attribute“:
[
{"entityName":"Evénement-Date de fin","entityValue":"30/03/2018 00:00"},
]
}
Antwort:
{
„Fehler“: 0,
„message“: „“
}