Email Funktionen im Jitterbit Design Studio
Email Funktionen ermöglichen das Versenden von Nachrichten aus Scripts entweder als vordefinierte Projekt- oder System-Email oder durch eine vollständige Angabe von Optionen.
Email Adressen validieren
Um eine Email-Adresse zu validieren, können Sie einen regulären Ausdruck verwenden, um zu testen, ob eine Email-Adresse bestimmten Regeln folgt. Überprüfen Sie, ob sie übereinstimmt (die RegExMatch
Funktion gibt mehr als 0 Übereinstimmungen zurück) und wenn ja, wird „gültig“ zurückgegeben. Die Regeln besagen, dass die Adresse aus Folgendem besteht:
- einem Namen, der aus bestimmten Zeichen besteht (alphanumerisch, Punkt, Unterstrich, Prozent, Plus, Bindestrich), gefolgt von
- einem @-Symbol, gefolgt von
- einem Domänennamen, der aus bestimmten Zeichen besteht (alphanumerisch, Punkt, Bindestrich), gefolgt von
- einem einzelnen Punkt, gefolgt von
- einem Domänennamen der obersten Ebene, der aus alphabetischen Zeichen besteht und zwei bis vier Zeichen lang ist.
Der gesamte Ausdruck wird in Klammern eingeschlossen, um einen markierten Unterausdruck zu erstellen; wenn er übereinstimmt, wird „1“ zurückgegeben.
Beachten Sie, dass die Backslashes in der Zeichenfolge des regulären Ausdrucks durch Verdoppelung maskiert werden müssen.
If(RegExMatch(emailaddress, "([A-z0-9._%+-]+@[A-z0-9.-]+\\.[A-z]{2,4})") > 0,
"valid",
"invalid");
// An email address "first.last@example.com" will return "valid"
Weitere Informationen finden Sie unter String-Funktionen und die Funktion RegExMatch
.
SendEmail
Erklärung
string SendEmail(string from, string to, string subject, string message[, string smtpServers, string account, string accountPassword, string cc, string bcc, string replyTo, bool useSSL])
Syntax
SendEmail(<from>, <to>, <subject>, <message>[, <smtpServers>, <account>, <accountPassword>, <cc>, <bcc>, <replyTo>, <useSSL>])
Erforderliche Parameter
from
: Die Email-Adresse, die für das Feld „Von“ verwendet werden sollto
: Eine durch Kommas getrennte Liste von Email-Adressen, an die die Email-Nachricht gesendet werden sollsubject
: Der Betreff der Email-Nachrichtmessage
: Die Nachricht der Email Nachricht
Optionale Parameter
smtpServers
: Eine durch Kommas getrennte Liste von SMTP-Servern im Format Server:Port, wie zum Beispielsmtp.example.com:465
. Der Port ist optional. Wenn er nicht angegeben ist, werden Standard-SMTP-Ports ausprobiert. Der erste erfolgreiche Server wird verwendet.account
: Auf den SMTP-Servern zu verwendender KontonameaccountPassword
: Passwort für das Konto bei den SMTP-Serverncc
: Eine durch Kommas getrennte Liste von Email-Adressen zum Senden einer Kopie der Email anbcc
: Eine durch Kommas getrennte Liste von Email Adressen zum blinden „Durchschreiben“replyTo
: Eine Email-Adresse für das AntwortfelduseSSL
: Boolesche Flagge, die angibt, ob SSL/TLS bei der Authentifizierung mit den SMTP-Servern verwendet werden soll.
Hinweis
Ab Jitterbit-Agent Version 10.1 können mit jedem dieser Parameter Mehrbytezeichen verwendet werden.
Beschreibung
Sendet eine Email mit den angegebenen Informationen. Bei Erfolg wird eine leere Zeichenfolge zurückgegeben, andernfalls werden alle Fehlermeldungen zurückgegeben.
Nur die ersten vier Parameter sind erforderlich, der Rest ist optional. Wenn keine Informationen angegeben werden, werden sie aus der Serverkonfigurationsdatei gelesen. Wenn sie in der Konfigurationsdatei nicht verfügbar sind, wird die Email nicht gesendet.
Beispiele
// Sending an email
// From address
// To address
// Subject
// Message
// SMTP servers
// Account
// Account password
// CC list
// BCC list
// Reply-to address
// Using SSL
SendEmail("john.doe@example.com",
"jane.doe@example.com,firstname.lastname@example.com",
"Weird data in PO input",
"There was some weird data in this incoming PO, could you have a look at it?",
"http://mail.example.com",
"john.doe@example.com",
"mymailpwd",
"jennifer@example.com",
"svennis@example.com, urban@example.com",
"jd@example.com",
1);
// Sending email, showing port configuration
SendEmail("myname@example.com",
"othername@example.com",
"Sendmail TEST",
"A Sendmail TEST message.",
"smtp.example.com:587",
"myname@example.com",
"mypassword", '', '', '', 1);
Im letzten Beispiel wird ein SMTP-Server verwendet, der auf Port lauscht. Da in der Email Nachricht keine Adressen kopiert oder blind kopiert werden, werden sie als leere Zeichenfolgen angezeigt. Da es keine „Antwort an“ Email-Adresse gibt, ist dies ebenfalls eine leere Zeichenfolge.
SendEmailMessage
Erklärung
string SendEmailMessage(string emailMessageId)
Syntax
SendEmailMessage(<emailMessageId>)
Erforderliche Parameter
emailMessageId
: Eine Email Nachricht im aktuellen Projekt
Beschreibung
Sendet eine Email mit einer vordefinierten Email-Nachricht. Bei Erfolg wird eine leere Zeichenfolge zurückgegeben, andernfalls werden alle Fehlermeldungen zurückgegeben.
Die in diesem Funktionsaufruf verwendete Email-Nachricht muss im aktuellen Projekt als Email-Nachricht definiert sein. Siehe die Anweisungen zum Einfügen von Projektelementen.
Beispiele
// Send a predefined email message
SendEmailMessage("<TAG>Email Messages/My Email Message<TAG>");
SendSystemEmail
Erklärung
string SendSystemEmail(string to, string subject, string message)
Syntax
SendSystemEmail(<to>, <subject>, <message>)
Erforderliche Parameter
to
: Eine durch Kommas getrennte Liste von Email-Adressen, an die die Email-Nachricht gesendet werden sollsubject
: Der Betreff der Email-Nachrichtmessage
: Die Nachricht der Email Nachricht
Beschreibung
Sendet eine Email unter Verwendung einer vorkonfigurierten „Von“-Adresse, SMTP-Servern und Kontoinformationen. Diese sind in der Serverkonfigurationsdatei definiert. Wenn diese nicht definiert wurden, verwenden Sie eine der anderen Email Funktionen. Bei Erfolg wird eine leere Zeichenfolge zurückgegeben; andernfalls werden alle Fehlermeldungen zurückgegeben.
Beispiele
SendSystemEmail(Get("manager_email"),
"FYI",
"About to process a new purchase order with POID = " +
Get("POID") +
". Will be available for review in a few minutes.");
// Examples entries in a jitterbit.conf file for sending system emails:
[SmtpClient]
DefaultSmtpServers=mail.example.com
DefaultFromEmail=auser@example.com
# If your SMTP server needs authentication the account and password can be specified:
DefaultAccount=auser
DefaultAccountPassword=apassword
# If your SMTP server uses SSL/TLS, set this to true:
UseSSL=true