Zum Inhalt springen

Email-Funktionen im Jitterbit Design Studio

Email-Funktionen ermöglichen das Versenden von Nachrichten aus Skripten, entweder als vordefinierte Projekt- oder System-Email oder durch eine vollständige Spezifikation 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 Funktion RegExMatch gibt mehr als 0 Übereinstimmungen zurück) und wenn ja, geben Sie "gültig" zurück. Die Regeln besagen, dass die Adresse aus Folgendem bestehen muss:

  • einem Namen, der aus bestimmten Zeichen (alphanumerisch, Punkt, Unterstrich, Prozent, Plus, Bindestrich) besteht, gefolgt von
  • einem @-Symbol, gefolgt von
  • einem Domänennamen, der aus bestimmten Zeichen (alphanumerisch, Punkt, Bindestrich) besteht, gefolgt von
  • einem einzelnen Punkt, gefolgt von
  • einem Top-Level-Domainnamen, der aus alphabetischen Zeichen besteht und zwischen zwei und vier Zeichen lang ist.

Der gesamte Ausdruck ist in Klammern eingeschlossen, um einen markierten Teil-Ausdruck zu erstellen; wenn er übereinstimmt, wird "1" zurückgegeben.

Beachten Sie, dass die Rückwärtsschläge im regulären Ausdrucksstring durch Verdopplung escaped 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"

Für weitere Informationen siehe String-Funktionen und die Funktion RegExMatch.

SendEmail

Deklaration

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 "Von"-Feld 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 in der Form server:port, wie zum Beispiel smtp.example.com:465. Der Port ist optional, und es werden die Standard-SMTP-Ports ausprobiert, wenn er nicht angegeben ist. Der erste erfolgreiche Server wird verwendet.

    Hinweis

    Endpunkte, die mit dem Parameter smtpServers erstellt wurden, sind in der Endpunktnutzungsberichterstattung enthalten und zählen zu Ihrer Lizenz.

  • account: Kontoname, der an den SMTP-Servern verwendet werden soll

  • accountPassword: Passwort für das Konto an den SMTP-Servern
  • cc: Eine durch Kommas getrennte Liste von Email-Adressen, an die eine Kopie der Email gesendet werden soll
  • bcc: Eine durch Kommas getrennte Liste von Email-Adressen für blindes "Carbon-Copying"
  • replyTo: Eine Email-Adresse für das Antwortfeld
  • useSSL: Boolean-Flag, das angibt, ob SSL/TLS bei der Authentifizierung mit den SMTP-Servern verwendet werden soll.

Beschreibung

Sendet eine Email mit den bereitgestellten Informationen. Bei Erfolg wird ein leerer String zurückgegeben; andernfalls werden alle Fehlermeldungen zurückgegeben.

Nur die ersten vier Parameter sind erforderlich; die restlichen sind optional. Wenn Informationen nicht angegeben sind, werden sie aus der Serverkonfigurationsdatei gelesen. Wenn sie in der Konfigurationsdatei nicht verfügbar sind, wird die Email nicht gesendet.

Beispiele

Beispiel 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);
Beispiel 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 dem Port lauscht. Da keine Adressen in der Email-Nachricht kopiert oder blind kopiert werden, werden sie als leere Strings angezeigt. Da keine "Antwort-an"-Email-Adresse vorhanden ist, ist dies ebenfalls ein leerer String.

[Zurück nach oben]

SendEmailMessage

Deklaration

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 ein leerer String zurückgegeben; andernfalls werden alle Fehlermeldungen zurückgegeben.

Die in diesem Funktionsaufruf verwendete Email-Nachricht muss als Email-Nachricht im aktuellen Projekt definiert sein. Siehe die Anweisungen zum Einfügen von Projektelementen.

Beispiele

// Sende eine vordefinierte Email-Nachricht
SendEmailMessage("<TAG>Email Messages/My Email Message<TAG>");

[Zurück nach oben]

SendSystemEmail

Deklaration

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 mit 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 ein leerer String zurückgegeben; andernfalls werden alle Fehlermeldungen zurückgegeben.

Hinweis

Endpunkte, die mit dieser Funktion unter Verwendung der privaten Agenten-Konfigurationsdatei [SMTPClient] Definition für DefaultSMTPServers erstellt wurden, sind in Endpoint-Nutzungsberichten enthalten und zählen zu Ihrer Lizenz.

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]