REST-Nachricht – Legacy-Workflow-Aktivität

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

    • Mit der Aktivität Veraltet REST-Nachricht kann ein Administrator den REST-Endpunkt überschreiben oder die im REST-Nachrichtenmodul konfigurierten Variablen bereitstellen.

    Diese Aktivität ist in der Zurich-Version veraltet und erscheint nicht mehr im Workflow-Bereich für die Entwicklung neuer Workflows. Neue Workflows sollten Orchestration REST-Aktivitätsvorlagen.

    nutzen. Bestehende Workflows, die es verwenden, funktionieren weiterhin wie geplant. Um diese Aktivität in einem vorhandenen Workflow zu bearbeiten, müssen Sie die Aktivität erneut aktivieren.

    Die Aktivität REST-Nachricht führt eine REST-Funktion für einen Dead Link (POST, PUT, GET oder DELETE) für einen Endpunkt aus, wobei die im Funktionsdatensatz definierten Werte verwendet werden.

    Hinweis:
    Wenn Sie zum Senden der REST-Nachricht einen MID-Server verwenden möchten, muss die Instanz auf den MID-Server zugreifen können, und der MID-Server muss für die Verwendung von SSH konfiguriert sein.

    Eingabevariablen

    Tabelle : 1. Eingabevariablen der Aktivität „REST-Nachricht“
    Feld Beschreibung
    REST-Nachricht
    REST-Nachricht Name des Erstellen Sie eine REST-Nachricht Zur Ausführung. Dies ist ein Referenzfeld für die Tabelle „REST-Nachricht“ [sys_Rest_message] (System-Webservices > Ausgehend > REST-Nachricht) an.
    REST-Nachrichtenfunktion Aufzurufende Funktion, die in einer REST-Nachrichtenfunktion definiert ist. Dies ist ein Referenzfeld für die Tabelle „HTTP-Methode“ [sys_Rest_message_fn] (System-Webservices > Ausgehend > REST-Nachricht) an.

    Verfügbare Funktionen sind put, post, get und delete. Sie können Funktionen in der zugehörigen Liste HTTP-Methoden in jedem REST-Nachrichtendatensatz bearbeiten.
    REST-Endpunkt REST-Endpunkt, der anstelle des im HTTP-Methodendatensatz definierten Endpunkts verwendet werden soll. Lassen Sie dieses Feld leer, um den definierten Endpunkt im Datensatz der REST-Nachrichtenfunktion zu verwenden.
    REST-Nachricht – Variablen
    Variablen Werte, für die verwendet werden soll Variablenersetzung in ausgehenden REST-Nachrichten Definiert im HTTP-Methodendatensatz.
    Verwenden Sie das folgende Format für die Zeichenfolge: 
    name1=value1, name2=value2, . . .
    Verwenden Sie beispielsweise name=${nameValue}, id=${idValue}, wobei name und id Funktionsvariablen sind. Wenn entweder der Variablenname oder der Wert ein Komma oder ein Gleichheitszeichen enthält, verwenden Sie für diese Zeichen einen umgekehrten Schrägstrich als Escape-Zeichen.
    REST-Nachricht – MID Server
    MID Server verwenden Aktivieren Sie diese Option, wenn Sie einen MID Server zum Senden der REST-Nachricht verwenden möchten. Ein MID-Server kann erforderlich sein, um einen Endpunkt innerhalb einer Firewall oder eines Subnetzwerks zu erreichen, das von der Instanz nicht sichtbar ist. Wenn diese Checkbox aktiviert ist, im Feld MID-Server jedoch kein MID-Server definiert ist, versucht der Workflow automatisch, einen MID-Server basierend auf dem IP-Bereich und der REST-Funktion zu finden.
    MID-Server Name des zu verwendenden MID-Servers. Dieses Feld ist verfügbar, wenn MID-Server verwenden aktiviert ist. Der Workflow ignoriert diesen Parameter, wenn der Parameter use_midserver deaktiviert ist.
    REST-Nachricht – Skript
    Sensorskript Das nach dem Stellen der Anforderung und dem Empfang einer Antwort auszuführende Skript. Auf den vollständigen Antworthaupttext können Sie über die Variable activity.output zugreifen.