trigger profile(a,b)


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


Profilketten

Siehe Abschnitt Profilketten.

Siehe auch