Funktionsblock INVITE_USER

Der Funktionsblock INVITE_USER lädt einen Benutzer per E-Mail oder SMS mithilfe eines Tokens ein.

Eingang INVITE

Bei einer positiven Flanke am Eingang wird ein Token erstellt und der Benutzer eingeladen. Dazu muss beim Benutzer eine E-Mail-Adresse oder eine Handynummer hinterlegt und der entsprechende Mail- bzw. SMS-Server konfiguriert sein.

Hinweis: Sind sowohl eine E-Mail-Adresse als auch eine Handynummer hinterlegt, wird die Einladung per E-Mail versendet.

Eingang USER

Der Eingang definiert die ID des einzuladenden Benutzers. Es darf ausschliesslich eine Zeichenkette übergeben werden. Variablen oder andere Datentypen sind aus Sicherheitsgründen nicht zulässig und werden ignoriert.

Eingang DT_END

Über den Eingang kann das Ablaufdatum des Tokens und der zugehörigen Session festgelegt werden. Nach Ablauf dieses Zeitpunkts werden sowohl das Token als auch die Session gelöscht.

Eingang ONCE

Ist der Eingang ONCE während der Einladung wahr, wird das Token nach erfolgreicher Erstellung der Session gelöscht. Dadurch kann das Token nur einmal zur Erstellung einer Session verwendet werden.

Eingang BASEURL

Dieser Eingang ist optional. Wird eine URL oder eine relative Angabe gesetzt, wird diese für die Erstellung der URL verwendet. Die angegebene Adresse muss erreichbar sein und die erforderlichen Kommunikationsports müssen entsprechend konfiguriert sein.

Folgende Angaben sind möglich:

Beispiel	Beschreibung
(kein Wert)	Es wird standardmässig die URL des Netzwerks verwendet, das über ein Gateway verfügt.
'https://antcasserver:8000/'	Vollständige URL. Der Hostname muss auf dem Server konfiguriert und der angegebene Port dem entsprechenden Projekt korrekt zugeordnet sein. Alternative Routen werden ebenfalls berücksichtigt. Pfadangaben werden ignoriert.
'eno1:8000', 'eno1' oder 'tunnel'	Relative Angabe zur Adresse. Die URL wird anhand der angegebenen Netzwerkschnittstelle und des Ports ermittelt. Ist kein Port angegeben oder konfiguriert, wird der erste für diese Schnittstelle konfigurierte Port verwendet.
'eno1:8000@serverid' oder 'eno1@serverid'	Wie oben, zusätzlich wird ein bestimmter Server angegeben. Die Server-ID ist optional, wird bei der Verwendung mehrerer Server jedoch in der Regel benötigt. Wird keine Server-ID angegeben, wird der Server verwendet, auf dem die SPS ausgeführt wird.
'!eno1:8000'	Wird der relativen Angabe ein Ausrufezeichen vorangestellt, wird der lokale Alias der Netzwerkschnittstelle verwendet.

Hinweis: Bei der Verwendung mehrerer Server wird empfohlen, die Server-ID anzugeben, um den gewünschten Server eindeutig zu bestimmen. Wird ein Server ausgetauscht, muss die hinterlegte Server-ID gegebenenfalls angepasst werden.

Ausgang DONE

Der Ausgang gibt einen Impuls aus, sobald der Vorgang erfolgreich abgeschlossen wurde.

Tipp: Die Sprache der E-Mail kann zuvor mit dem Funktionsblock USER_LANG festgelegt werden.