Bearbeitet die Eigenschaften einer Ressource.
Abfrage
| Vorgehensweise | URL |
|---|---|
| PUT | RACINEVP/ws/rest/Ressource/modify |
| Typ | Parameter | Werte |
|---|---|---|
| HEAD | apikey | Zeichenkette |
| DATEN | resourceModel | Zeichenkette |
| DATEN | Attribute | Zeichenkette |
| DATEN | Schlüssel | 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.
resourceModel
Name der Dimension
Attribute
Liste der zu bearbeitenden Attribute: [{"entityName":"attr1","entityValue":"value1 },…]
Schlüssel
Liste der Identifikationsattribute der Ressource: [{"entityName":"attr2","entityValue":"value2 },…]
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 Dimension: resourceModel |
| 3 | Ungültiges Attribut: attribute/key |
| 4 | Keine Ressource |
| 5 | Ungültige Daten |
| 6 | Update KO |
Beispiel:
Für den Planer „DEMO API REST“, der auf einem Visual Planning-Server installiert ist und dessen Stamm-URL http://127.0.0.1:8906/ip50, eine Ressource der Dimension „Aufgaben“ enthält, die durch die Attribute „Kunde“, „Projekt“ und „Phase“ identifiziert wird und bei der wir den Wert des Attributs „Aufgabe“ in „Analyse“ ändern möchten. Mit einem Anwender, dessen Zugriffsschlüssel für die API lautet: d9f79618-59e4-a710-8203a39bab9ad09b, haben wir:
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 2"},
],
„Attribute“:
[
{"entityName":"Tâches-Tâche","entityValue":"Analyse"},
],
„resourceModel“: „Aufgaben“
}
Antwort:
{
„Fehler“: 0,
„message“: „“
}