Email Funktionen im Jitterbit Integration Studio

Email Funktionen ermöglichen das Senden von Email Nachrichten aus Scripts entweder durch eine vollständige Angabe von Optionen oder durch Verwendung einer konfigurierten Email Benachrichtigung.

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 soll
to: Eine durch Kommas getrennte Liste von Email-Adressen, an die die Email-Nachricht gesendet werden soll
subject: Der Betreff der Email-Nachricht
message: Die Nachricht der Email Nachricht

Optionale Parameter

smtpServers: Eine durch Kommas getrennte Liste von SMTP-Servern im Format Server:Port, wie zum Beispiel smtp.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 Kontoname
accountPassword: Passwort für das Konto bei den SMTP-Servern
cc: Eine durch Kommas getrennte Liste von Email-Adressen zum Senden einer Kopie der Email an
bcc: Eine durch Kommas getrennte Liste von Email Adressen zum blinden „Durchschreiben“
replyTo: Eine Email-Adresse für das Antwortfeld
useSSL: 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

Example 1

// 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);

Example 2

// 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.

[Zurück zum Anfang]

`SendEmailMessage`

Erklärung

string SendEmailMessage(string emailMessageId)

Syntax

SendEmailMessage(<emailMessageId>)

Erforderliche Parameter

emailMessageId: Ein String-Referenzpfad zu einer Email Benachrichtigung im aktuellen Projekt

Beschreibung

Sendet eine Email mit einer vordefinierten Email Benachrichtigung. Bei Erfolg wird eine leere Zeichenfolge zurückgegeben, andernfalls werden alle Fehlermeldungen zurückgegeben.

Die in diesem Funktionsaufruf verwendete Email Nachricht muss als Email Benachrichtigung definiert sein im aktuellen Projekt. Weitere Informationen finden Sie in den Anweisungen zum Einfügen von Email Nachrichten unter Benachrichtigungen Abschnitt in Jitterbit Script.

Beispiele

// Send a predefined email message
SendEmailMessage("<TAG>email:My Email Message<TAG>");

[Zurück nach oben]

`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 soll
subject: Der Betreff der Email-Nachricht
message: 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

[Zurück nach oben]