Benutzertask durch Aufrufen der REST-APIs für IBM BPM verarbeiten

Eine Benutzertask wird mindestens einem Team zugewiesen. Ein Teammitglied fordert die Task an, stellt die relevanten Informationen bereit und führt die Task anschließend aus.

Vorbereitende Schritte

Achtung: REST-API-Aufrufe, von denen eine Liste mit Objekten zurückgegeben wird, zum Beispiel GET /processes oder GET /user-tasks, können Abfrageparameter enthalten, zum Beispiel den Modellnamen, den Containername oder die Prozess-ID. Wenn vom Parameterwert auf ein Objekt verwiesen wird, das nicht vorhanden ist (weil die Prozess-ID zum Beispiel einen Schreibfehler aufweist), wird ein Fehler ausgelöst. Stattdessen enthält das auf den Aufruf zurückgegebene JSON-Objekt eine Liste ohne Inhalt. Informationen zu den API-Aufrufen finden Sie in Von IBM BPM-REST-APIs bereitgestellte Ressourcen.

Vorgehensweise

Zeigen Sie eine Liste der nicht angeforderten Tasks aus, die der aktuelle Benutzer anzeigen kann. Nicht angeforderte Tasks sind Task, die sich im Bereitstatus befinden:
```
GET /bpm/user-tasks?states=ready
```
Wenn Sie die Aufgabenliste filtern möchten, damit nur Tasks für einen bestimmten Prozess angezeigt werden, schließen Sie den Modellnamen, zum Beispiel 'OrderManagement', in die Abfrage ein:
```
GET /bpm/user-tasks?model=OrderManagement&states=ready 
```
Alternativ können Sie die Tasks für eine bestimmte Prozessinstanz durch Einschließen der Prozess-ID, zum Beispiel '2072.3', in der Abfrage anzeigen:
```
GET /bpm/user-tasks?process_id=2072.3&states=ready 
```
Der Benutzer öffnet eine Task in der Liste, um die Geschäftsdaten zu überprüfen. Schließen Sie zum Anzeigen der Geschäftsdaten den Parameter optional_parts=data in die Abfrage ein. Wenn Sie sicherstellen möchten, dass der Benutzer zum Anzeigen und Anfordern der Task berechtigt ist, schließen Sie die Eigenschaft actions in den Parameter optional_parts ein.
Wenn der Benutzer zum Beispiel Task '2078.3' öffnet, können Sie den folgenden REST-API-Aufruf zum Anzeigen der Taskdetails und Zurückgeben der Aktionen verwenden, die der Benutzer ausführen kann:
```
GET /bpm/user-tasks/2078.3?optional_parts=data,actions 
```
Der Benutzer fordert die Task an. Wenn der Benutzer zum Beispiel Task '2078.3' anfordert, können Sie den folgenden REST-API-Aufruf verwenden:
```
POST /bpm/user-tasks/2078.3/claim?optional_parts=data 
```
Die Task erhält den Status 'Angefordert'. Das zurückgegebene Instanzobjekt der Benutzertask enthält die Benutzer-ID des Taskeigner und die Variablen, die derzeit festgelegt sind.

Der Taskeigner gibt die erforderlichen Informationen an und führt die Task aus.

Die erforderlichen Datenausgabevariablen für die Task werden in einem JSON-Objekt im Anforderungshauptteil des Aufrufs '/complete' übergeben. Beispiel: Es kann vorkommen, dass ein Auftragsverarbeiter die Gesamtkosten des Auftrags sowie die Bestätigung angeben muss, dass der Bestand in einem Warehouse verfügbar ist.

POST /bpm/user-tasks/2078.3/complete
...
{
   "output":[
      {
         "name":"inStock",
         "data":"Yes"
       }
       {
          "name":"Price",
          "data":"1000",
       }
       {
          "name":"warehouseAddress",
          "data":{
             "street":"Mystreet", 
             "houseNo":"12", 
             "postCode":"1234", 
             "city":"Mycity" 
            }
        }]
}

Ergebnisse

Die Task wird in den Status 'Fertiggestellt' versetzt. Das zurückgegebene Instanzobjekt der Benutzertask enthält die aktualisierten Statusinformationen, die Zeitmarke für den Fertigstellungszeit und die aktualisierten Variablen.