Aktion „auf Nachricht warten“

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer

    • Halten Sie einen Flow an, bis er eine bestimmte Nachricht von der Flow-API erhält. Geben Sie die Zeichenfolgennachricht an, die die Ausführung des Flows fortsetzt, und geben Sie optional einen Zeitüberschreitungswert an, um den Flow fortzusetzen, wenn nach einer bestimmten Zeit keine Nachricht empfangen wird.

    Rollen und Verfügbarkeit

    Verfügbar als Workflow-Studio ServiceNowCore-Aktion. Anwender mit der Rolle „Flow_Designer“ oder „admin“ können einem Flow eine Aktion hinzufügen und Konfigurationsdetails definieren.

    Eingaben

    Geben Sie einen Wert für jede Eingabe an, die Ihre Aktion benötigt. Um dynamische Werte hinzuzufügen, können Sie Pillen auch aus dem Datenbereich ziehen oder in der Pillenauswahl auswählen.

    Nachricht
    Datentyp: String

    Die Textzeichenfolge, auf die der Flow von der sendMessage()-API wartet. Die Aktion verwendet diese Nachricht, um die Ausführung des Flows fortzusetzen. Weitere Informationen zur sendMessage()-API finden Sie unter FlowAPI - sendMessage(String contextSysID, String message, String payload).

    Zeitüberschreitung aktivieren
    Datentyp: True/False
    Option, um die Zeit zu begrenzen, die der Flow auf den Abschluss der Aktion wartet, bevor er fortfährt.
    Hinweis:
    Verwenden Sie Aktivieren Sie die Zeitüberschreitung Option, um zu verhindern, dass der Flow unendlich warten kann. Wenn die Nachricht nicht empfangen wird, gibt ein Zeitüberschreitungswert an, wann das System die Aktion „auf Nachricht warten“ überspringen und zum nächsten Element im Flow wechseln kann. Sie müssen einen Wert für die Dauer festlegen, um eine Zeitüberschreitung zu aktivieren.
    Dauer
    Datentyp: Duration

    Zeit, die der Flow wartet, bevor er fortgesetzt wird, wenn Aktivieren Sie die Zeitüberschreitung Option ist ausgewählt. Geben Sie die Wartezeit in Stunden, Minuten und Sekunden ein. Wenn Sie dieses Feld leer lassen, wartet der Flow nicht.

    Ausgaben

    Diese Ausgaben werden im Datenbereich angezeigt. Sie können sie an anderer Stelle in Ihrem Flow als Eingaben verwenden.

    Nutzlast
    Datentyp: String

    Eine Textzeichenfolge, die von der sendMessage()-API zurückgegeben wird. Der übergeordnete Flow kann Nutzlastwerte als Eingaben für andere Aktionen oder Flow-Logik verwenden.

    Status
    Datentyp: Choice
    Der Abschlussstatus der Aktion als numerischer Wert.
    • 0 (Erfolg)
    • 1 (Fehler)

    Allgemeine Richtlinien

    Verwenden Sie diese allgemeinen Richtlinien, wenn Sie Flows erstellen, die auf eine Nachricht warten.
    Konvertieren Sie Workflow-Ereignis-Warteaktivitäten mit dieser Aktion
    Konvertieren Sie klassische Workflows, die die Aktivität „Warten auf WF-Ereignis“ verwenden, in Flows, die die Aktion „Warten auf Nachricht“ verwenden. Sie können den Ereignisnamen als Nachrichtentext verwenden, der den Flow fortsetzt.
    Verwenden Sie die Methode sendMessage(), um Nachrichten zu erstellen
    Erstellen Sie Nachrichten für wartende Flows mit der sendMessage()-Methode. Wenn der Flow die Nachricht generieren soll, um die Ausführung fortzusetzen, erstellen Sie eine anwenderdefinierte Aktion mit einem Skriptschritt, um die Nachricht zu generieren. Alternativ können Sie eine Skriptlogik erstellen, die außerhalb des Flows ausgeführt wird, z. B. ein Ereignis, um die Nachricht zu generieren. Weitere Informationen zur sendMessage()-API finden Sie unter FlowAPI - sendMessage(String contextSysID, String message, String payload).

    Warten Sie, bis die Nachricht ausgeführt wird, um zur Flow-Logik zurückzukehren

    Ausführungsdetails der Aktion „auf Nachricht warten“ im Status „Warten“. Die anderen Schritte des Flows befinden sich im Status „nicht ausgeführt“.

    In diesem Beispiel-Flow bestimmt der Genehmigungsstatus, ob die Aktion auf Nachricht warten ausgeführt werden soll. Wenn der Genehmigungsstatus „Übersprungen“ oder „abgelehnt“ ist, wartet der Flow auf eine Nachricht von der sendMessage()-API, bevor er fortfährt. Sie können diese Logik verwenden, um eine abgelehnte Genehmigungsanforderung zu korrigieren und erneut zur Genehmigung zu übermitteln.

    In diesem Beispiel hat Fred Luddy die Genehmigung abgelehnt und weitere Informationen angefordert. Um den Flow fortzusetzen, muss jemand die Kommentare von Fred beantworten und dann die API sendMessage() ausführen, um die richtige Nachricht zu senden Flow Fortsetzen .

    Ausführungsdetails der Aktion „auf Nachricht warten“ im Status „Abgeschlossen“. Die Nutzlast hat den Laufzeitwert „erneut zur Genehmigung übermittelt“.

    Nach dem Beheben der Change-Anforderung hat jemand die sendMessage()-API ausgeführt, um die Nachricht zu senden Flow Fortsetzen Und senden Sie dem Flow auch einen Nutzlastwert von Erneut zur Genehmigung übermittelt . Weitere Informationen zur sendMessage()-API finden Sie unter FlowAPI - sendMessage(String contextSysID, String message, String payload).

    Da der API-Nachrichtenwert den Bedingungen der Aktion „auf Nachricht warten“ entsprach, wurde die Ausführung des Flows fortgesetzt. In diesem Fall verwendete der Flow einen Flow-Logikblock „zurück zum Flow“, um die Aktion „Genehmigung anfordern“ erneut auszuführen.

    Beispiel-Aktivitätenstrom eines Change-Datensatzes mit dem Text, der zur Genehmigung erneut übermittelt wurde.

    Hier ist das Aktivitätsprotokoll der Change-Anforderung. Der Nutzlastwert Erneut zur Genehmigung übermittelt Wurde zu hinzugefügt Zusätzliche Kommentare Feld.