trigger profile(a,b)
Gruppe |
Ruft das Profil mit dem Namen a auf. Damit ein Profil mit dieser Funktion aufgerufen werden kann, muss es aktiv sein und einen zeitgesteuerten Eingangsagenten mit Zeitsteuerungsart Trigger haben. Werden Profile mit anderen Eingangsagenten, inaktive oder nicht vorhandene Profile aufgerufen, liefert die Funktion false zurück.
Als Aufruf-Modus b stehen sync, async und direct zur Verfügung. Im synchronen Fall wird auf das Ende des Profildurchlaufs gewartet, im asynchronen Fall mit der eigenen Verarbeitung weitergemacht, ohne auf das Ende des getriggerten Profils zu warten.
Nach erfolgreichem Lauf des gerufenen Profils liefert die Funktion true zurück, bzw. sofort, wenn der Aufruf asynchron war. Bricht das aufgerufene Profil mit einem Fehler ab, wird der Fehler zwar geloggt, das aktuelle Profil aber weiter fortgeführt. Das Ergebnis der Funktion ist in diesem Fall false.
Wird der Modus direct verwendet, dann wird der Rückgabewert (in UTF-8) vom aufgerufenen Profil geliefert (bzw. vom ersten ersten Job, falls mehrere entstehen sollten). Dazu muss dieses Profil die Klasse PassBackDataResponse in einem Antwortweg verwenden.
Hinweis: Das getriggerte Profil darf bei einem Aufruf mit sync nicht schon laufen, sonst wird eine Fehlermail versendet! Lösung: Entweder den Parameter b auf async stellen oder beim getriggerte Profil eine Parallelverarbeitung zulassen (Option Profil darf nur in einer Instanz laufen deaktivieren).
Parameterbeschreibung
Parameter |
Beschreibung |
a |
Profilname. |
b |
(optional) Aufruf-Modus {sync|async|direct}. Default: async |
Beispiele
Gegeben seien folgende Profile:
Profilname |
Eingangsagent |
FTP to File |
Cron:Ftp |
Message to FTP |
Message |
FTP to File2 |
Cron:Trigger |
FTP to File3 |
Cron:Trigger |
Parameter a |
Parameter b |
Aufgerufenes Profil erfolgreich |
Ergebnis |
FTP to File |
sync |
Wurde nicht aufgerufen. |
false, da das zeitgesteuerte Profil nicht vom Untertyp Trigger ist. |
Message to FTP |
sync |
Wurde nicht aufgerufen. |
false, da das Profil nicht zeitgesteuert ist. |
FTP to File2 |
async |
Ja. |
true |
FTP to File2 |
sync |
Nein. |
false |
FTP to File2 |
async |
Nein. |
true |
FTP to File3 |
direct |
Ja. |
<Rückgabewert vom aufgerufenen Profil> |
Variablen
Die Jobnummer des rufenden Profils wird an das gerufene Profil in der System-Variable MSG_CALL_VAR_JOBNR übergeben. Legen Sie diese Variable im aufgerufenen Profil an, um auf den Wert zuzugreifen.
Tritt eine Exception auf, weil der MessageService nicht erreichbar ist, liefert die Funktion lediglich false zurück, aber die Exception-Fehlermeldung kann über die System-Variable MSG_CALL_VAR_SYS_EXCEPTION abgerufen werden (wenn diese angelegt ist).
Siehe allgemein Abschnitt Übergebene Variablen, Listen und Maps (Profilketten).
Profilketten
Siehe Abschnitt Profilketten.