Ablehnen einer bestehenden Aufgabe

Verwendungszweck

Senden einer E-Mail an einen Benutzer mit einem Link zu einer Aufgabe, die direkt abgelehnt werden soll - z.B. aus einem Workflow-System.

Sie haben auch die Möglichkeit, eine Aufgabe direkt über einen Link zu stornieren, ohne den iCL Filler zu öffnen und danach zu suchen. Hierfür können Sie die "canceltask" Deep Link API verwenden. Um diese zu nutzen, müssen Sie die externe ID der abzulehnenden Aufgabe angeben.

Die URL mit der Abbruchaktion hat das folgende Format:

https://filler.opti-q.com?$action=canceltask&externalId=<externalid_of_task>

Außerdem können Sie zwei optionale Parameter angeben:

• Normalerweise können Sie eine Aufgabe nicht ablehnen, wenn die Einstellungen der Arbeitsmappe dies einschränken. Sie können die Ablehnung jedoch erzwingen, indem Sie den Parameter force (ohne Wert) an den Deep Link anhängen.

  https://filler.opti-q.com?$action=canceltask&externalId=<externalid_of_task>&force

• Mit responseUrl können Sie eine URL angeben, an die der Benutzer nach dem Ablehnungsversuch weitergeleitet werden soll. Wenn Sie eine responseUrl angeben, wird das Ergebnis der Abbruchaktion dorthin weitergeleitet. Das Ergebnis ist immer ein URL-kodiertes JSON, das entweder ein leeres Ergebnis enthält, wenn die Ablehnung erfolgreich war, oder eine Fehlermeldung, wenn die Aufgabe nicht abgebrochen werden konnte - dies kann passieren, wenn die angegebene externe ID nicht gefunden wurde oder wenn die Ablehnung der Aufgabe in den Einstellungen der Arbeitsmappe nicht erlaubt war und die Aktion nicht erzwungen wurde.

  Das Ergebnis sieht wie folgt aus, wenn der Ablehnungsversuch mit einem Fehler zurückgegeben wurde: { "error": " Fehlermeldung." }

  Und im Falle eines Erfolges: { "result": "" }

  Die URL mit der Abbruchaktion und einer Antwort-URL hat das folgende Format:

  https://filler.opti-q.com?$action=canceltask&externalId=<externalid_of_task>&force&responseUrl=<response_url>

  Es gibt zwei Möglichkeiten, das Ergebnis der Ablehnung zu erhalten. Wenn die angegebene Antwort-URL den Platzhalter __response__ enthält, dann wird dieser durch das kodierte JSON ersetzt. Ist dies nicht der Fall, sodass der Platzhalter nicht in der URL enthalten ist, wird ein neuer Parameter mit dem Namen response an die responseURL angehängt: der Wert dieses Parameters ist das URL-kodierte JSON.

  Wenn die Antwort-URL zum Beispiel lautet: example://cancelresult=__response__ und die Ablehnung war erfolgreich, dann lautet die Antwort example://cancelresult=%7B%20%22result%22%3A%20%22%22%20%7D. Wenn die Antwort-URL das folgende Format hat: example://something=some_value und die Aufgabe kann nicht abgelehnt werden, lautet die Antwort: example://something=some_value&response=%20%7B%20%22error%22%3A%20%22%20Error%20message.%22%20%7D.

Um zum Beispiel die Aufgabe TASK_0001 abzubrechen, würde die URL wie folgt aussehen:

https://filler.opti-q.com?$action=canceltask&externalId=TASK_0001

https://filler.opti-q.com?$action=canceltask&externalId=TASK_0001&force

https://filler.opti-q.com?$action=canceltask&externalId=TASK_0001&responseUrl=example%3A%2F%2Fsomething%3D__response__

https://filler.opti-q.com?$action=canceltask&externalId=TASK_0001&force&responseUrl=example%3A%2F%2Fsomething%3D__response__

Hinweis

Wenn Sie das Android SDK auf Ihrem Computer installiert haben und den Entwicklermodus auf Ihrem Gerät eingerichtet haben, können Sie die ADB-Befehlsshell verwenden, um diese Funktion zu testen.

Starten Sie dazu einfach ADB und führen Sie den Befehl wie folgt aus:

adb shell am start -a android.intent.action.VIEW -c android.intent.category.BROWSABLE -d "https://filler.opti-q.com?\$action=canceltask\&externalId=TASK_0001&force&responseUrl=test%3A%2F%2Fsomething%3D__response__"

Beachten Sie, dass wir die Sonderzeichen $ und & mit einem Backslash \ entschlüsseln mussten, da dies von der ADB verlangt wird leider.