EmailInformation (Objekt)

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen

Name

EmailInformation - Validierbare Email-Adresse

Beschreibung

Das EmailInformation-Objekt enthält eine Email-Adresse, die von dem EmailValidator-Service in regelmäßigen Abständen geprüft wird. Das Ergebnis der Prüfung wird in dem emailStatus-Feld abgelegt.

Folgende Stati können sich durch eine Validierung ergeben:

valid
Die Email-Adresse ist gültig
invalid
Die Email-Adresse ist ungültig
trylater
Die Email-Adresse muss zu einem späteren Zeitpunkt erneut geprüft werden, da der zuständige Email-Server zur Zeit keine Anfragen entgegen nimmt.
timeout
Bei der Prüfung der Email-Adresse konnte der zuständige Email-Server zwar erreicht werden, aber die Antwortzeit des Servers war zu lang.
refused
Der für die Email-Adresse zuständige Email-Server konnte nicht erreicht werden.
unknown
Die Email-Adresse konnte auf Grund eines unbekannten Fehlers nicht geprüft werden.
ignore
Dieser Status wird nicht vom EmailValidator-Service gesetzt, sondern kann beispielsweise wie folgt gesetzt werden. Dies hat zur Folge, dass die Email-Adresse nicht überprüft wird.
<sp:text name="sp:email" type="emailStatus">


Da die Stati trylater, timeout, refused und unknown temporär auftreten können, werden diese zunächst in dem Feld lastValidationEmailStatus gesetzt. Erst wenn bei einer darauf folgenden Überprüfung dieser Status erneut ermittelt auftritt, wird auch das Feld emailStatus mit diesem Status gesetzt.

Attribute

Attribut Type Beschreibung ab IES Version
id ID ID des Objektes 1
field String Variablenname des Objektes 1
lastField String Variablenname des Objektes ohne Struktur-Date 2.13
root Element Root-Element dieser Information 1
parent ID ID des Objektes, in dem diese Information eingebettet ist. Dies kann ein Element, eine SubInformation oder eine ListItemInformation sein 1
locale Locale Sprache, für die die Information gilt 1
isEmpty Boolean true, wenn der Counter noch nicht gestartet ist 1
email String Email-Adresse 1
emailStatus String Status der Email-Adresse. Folgende Stati sind möglich: valid, invalid, trylater, timeout, refused, unknown, ignore. 1
lastValidationEmailStatus String Vorläufiges Prüfungsergebnis, das erst bei einer erneuten Prüfung bestätigt werden muss. Bestätigt werden müssen folgende Stati: trylater, timeout, refused, unknown. 1

trylater

Methoden

Methode Rückgabewert Beschreibung ab IES Version
toXip(Boolean emptyFields) String Erzeugt XML-Daten im XIP-Format für dieses Objekt 2.14
String toXip(Boolean emptyFields)
Erzeugt XML-Daten im XIP-Format für dieses Objekt.
Parameter
Boolean emptyFields
Gibt an, ob auch leere Felder enthalten sein sollen (Default ist true).
Rückgabewert
String
XML-Daten im XIP-Format