Ruft die Eigenschaften einer Gruppe von Ressourcen ab, die einem Ressourcenfilter im betreffenden Planer entsprechen.
Abfrage
| Vorgehensweise | URL |
|---|---|
| POST | RACINEVP/ws/rest/Ressource/get |
| Typ | Parameter | Werte |
|---|---|---|
| HEAD | apikey | Zeichenkette |
| DATEN | resourceModel | Zeichenkette |
| DATEN | Attribute | Zeichenkette |
| DATEN | filterName | Zeichenkette |
| DATEN | [extraInfos] | 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
Die abzurufenden Attribute. [„attr1“,…]
Die Attribute werden anhand ihrer Bezeichnung identifiziert, wie sie vom Zugriffspunkt/den Attributen übermittelt werden.
filterName
Name des angewendeten Ressourcenfilters.
extraInfos [optional]
Dynamische Attribute des Filters [{„entityName“: „attr2“, „entityValue“: „value2“}, …].
Antwort
| Status | Mitteilung |
|---|---|
| 0 | |
| 1 | Ungültige Sitzung: apikey |
| 2 | Ungültiges Dimension: resourceModel |
3 Ungültiger Ressourcenfilter: filterName
| 4 | Kein Wert für die Variable oder ungültiger Wert für „invalidVariable“ |
|---|---|
| 5 | Schwerwiegender Fehler: errorMessage |
| 6 | Ungültiges Attribut: Attribut |
| 7 | Es wurden keine Entitäten gefunden |
| 8 | Exportieren KO |
Beispiel:
Für den Planer „DEMO API REST“, der auf einem Server unter Visual Planning mit dem Stamm-URL http://127.0.0.1:8906/ip50 installiert ist, möchten wir die Attribute „Kunde“, „Projekt“, „Phase“ und „Aufgabe“ der Dimension „Aufgaben“ abrufen, die dem Ressourcenfilter „DYNAMIC REST API DEMO TASK/PROJECT“ entsprechen, der über einen dynamischen PROJECT-Parameter für den Projektnamen verfügt.
Unter Verwendung des Werts „Projekt 1“ für den dynamischen Parameter PROJECT und 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/resource/get
Veröffentlichte Daten:
{
"extraInfos":
[
{"entityValue":"Projet 1","entityName":"PROJET"}
],
„Attribute“:
[
„Aufgaben-Kunde“, „Aufgaben-Projekt“,
„Aufgaben-Phase“, „Aufgaben-Aufgabe“
],
„resourceModel“: „Aufgaben“,
„filterName“: „DEMO-API-REST-TACHE/PROJET DYNAMIQUE“
}
Antwort:
{
„Fehler“: 0,
"message":"",
„Entitäten“:
[
[
{"entityName":"Client","entityValue":"Client 1"},
{"entityName":"Projet","entityValue":"Projet 1"},
{"entityName":"Phase","entityValue":"Phase 1"},
{"entityName":"Tâche","entityValue":"Analyse"},
],
[
{"entityName":"Client","entityValue":"Client 1"},
{"entityName":"Projet","entityValue":"Projet 1"},
{"entityName":"Phase","entityValue":"Phase 1"},
{"entityName":"Tâche","entityValue":"Conception"},
],
[
{"entityName":"Client","entityValue":"Client 1"},
{"entityName":"Projet","entityValue":"Projet 1"},
{"entityName":"Phase","entityValue":"Phase 1"},
{"entityName":"Tâche","entityValue":"Développement"},
],
[
{"entityName":"Client","entityValue":"Client 1"},
{"entityName":"Projet","entityValue":"Projet 1"},
{"entityName":"Phase","entityValue":"Phase 1"},
{"entityName":"Tâche","entityValue":"Livraison"},
]
]
}