Roboteka
Roboteka · Roboter · Aufgabe per ID aktualisieren

Aufgabe per ID aktualisieren

Der Roboter „Aufgabe per ID aktualisieren“ ändert eine vorhandene Bitrix24 (Alaio)-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

Welche Fehler kann der Roboter zurückgeben?

Diese Meldungen schreibt der Roboter ins Protokoll des Geschäftsprozesses, wenn er einen Schritt nicht ausführen kann. Der Text zeigt, was in den Einstellungen oder Daten zu korrigieren ist.

  • Fehler: task_id nicht angegeben
  • Fehler: fields_json ist leer
  • Fehler: fields_json enthält ungültiges JSON
  • API-Fehler

Szenario: Neuzuweisung einer Aufgabe beim Fortschritt eines Auftrags

  1. Ein Auftrag wechselt in die Phase „In Arbeit“
  2. Der Roboter ruft die Aktualisierung der Aufgabe anhand ihrer ID mit den Feldern {"RESPONSIBLE_ID":5} auf
  3. Bei „Erfolgreich“ = Y wird der Prozess fortgesetzt, bei N geht er in den Zweig zur Fehlerbehandlung

Ähnliche Roboter

Passende Artikel

Installieren Aufgabe beschreiben — wir bauen den Roboter kostenlos