Aufgabe per ID aktualisieren
Der Roboter „Aufgabe per ID aktualisieren“ ändert eine vorhandene Bitrix24-Aufgabe anhand ihrer ID aus jedem Kontext eines Geschäftsprozesses. Die Felder werden als JSON mit Codes in GROSSBUCHSTABEN (TITLE, RESPONSIBLE_ID, DEADLINE, PRIORITY usw.) übergeben und über die Methode tasks.task.update angewendet. Zurückgegeben wird ein Kennzeichen „Erfolgreich (Y/N)“ je nach Ergebnis des API-Aufrufs.
Der Roboter aktualisiert eine vorhandene Aufgabe anhand ihrer ID, indem er die Methode tasks.task.update aufruft. Eingabe sind eine numerische Aufgaben-ID und ein Satz von Feldern als JSON; die Feldcodes werden in GROSSBUCHSTABEN angegeben, wie es die Aufgaben-API verlangt — zum Beispiel {"TITLE":"Neuer Titel","RESPONSIBLE_ID":5,"DEADLINE":"2024-12-31T23:59:59+03:00","PRIORITY":"2"}. Wann zu verwenden: den Verantwortlichen neu zuweisen oder die Frist ändern, wenn ein Auftrag in eine neue Phase wechselt; einen Phasen-Marker an den Titel anhängen; die Priorität anhand einer Prozessbedingung erhöhen. Der Roboter gibt „Erfolgreich (Y/N)“ zurück: N, wenn die ID fehlt, das JSON leer oder ungültig ist oder die API einen Fehler zurückgegeben hat (der Fehlertext geht ins Protokoll). Verwenden Sie das Kennzeichen „Erfolgreich“ in der Bedingung des nächsten Schritts, um die Zweige für erfolgreiche und fehlgeschlagene Aktualisierung zu trennen.
Welche Eingabeparameter akzeptiert der Roboter?
| Parameter | Typ | Pflichtfeld? | Standard |
|---|---|---|---|
| Aufgaben-ID | int | ja | |
| Zu aktualisierende Felder (UPPERCASE JSON): {"TITLE":"Neuer Titel","RESPONSIBLE_ID":5,"DEADLINE":"2024-12-31T23:59:59+03:00","PRIORITY":"2"} | string | ja |
Was gibt der Roboter zurück?
| Parameter | Typ |
|---|---|
| Erfolgreich (Y/N) | string |
Szenario: Neuzuweisung einer Aufgabe beim Fortschritt eines Auftrags
- Ein Auftrag wechselt in die Phase „In Arbeit“
- Der Roboter ruft die Aktualisierung der Aufgabe anhand ihrer ID mit den Feldern {"RESPONSIBLE_ID":5} auf
- Bei „Erfolgreich“ = Y wird der Prozess fortgesetzt, bei N geht er in den Zweig zur Fehlerbehandlung