E-Mail

InitSmtp#

Die Aktion InitSmtp stellt eine Verbindung mit dem angegebenen SMTP-Server her (Attribut: Server). Falls die Authentifizierung aktiviert ist (Attribut: Authentification) müssen für die Attribute Login und Passwort gültige Anmeldedaten eingetragen werden. Über das Attribut E-Mail kann die Absender E-Mail Adresse hinterlegt werden. Für das Attribut DisplayName wird der Anzeigename des Absenders hinterlegt, für das Attribut Port kann der für den SMTP-Server gültige Port eingetragen werden. Und über das Attribut EnableSSL wird festgelegt, ob die Verbindung verschlüsselt werden soll.

<InitSmtp DisplayName="" Email="" Login="" Password="" Server="" Port="25" EnableSSL="false" Authentification="true" Condition="" Variable="{@Result}" IgnoreError="false" />

 

SendMail#

Über die Aktion SendMail wird eine E-Mail an die in dem Attribut To hinterlegten E-Mail-Adresse versendet. Über das Attribut Cc wird eine Kopie, und über Bcc eine Blindkopie an die jeweils hinterlegte E-Mail versendet. Der Betreff der E-Mail wird über das Attribut Subject angegeben, die Nachricht über das Attribut Body. Enthält die Nachricht HTML Formatierungen wird die HTML Formatierung über das Attribut IsBodyHtml angegeben werden. Der E-Mail kann zudem über das Attribut Attachment eine Datei angehangen werden. Das Attribut Template bietet die Möglichkeit den Pfad zu einem Template zu hinterlegen. In dem Template können die aus den Batchpad Skripten typischen Variablen Bezeichnungen eingetragen werden wie z.B. {@Name}. Wird das Template geladen, werden diese Platzhalter, mit denen zur Laufzeit hinterlegten gleichnamigen Variablen, ersetzt. Das Template kann als HTML formatiertes Dokument oder als reines Textdokument hinterlegt werden. Hinweis: Das Template kann auch direkt im Batchpad Skript angelegt werden, siehe Abschnitt HTML in diesem Lexikoneintrag.

<SendMail To="" Cc="" Bcc="" Subject="" Body="" IsBodyHtml="false" Attachment="" Template="" Condition="" Variable="{@Result}" IgnoreError="false" />

 

InitImap#

Die Aktion InitImap stellt eine Verbindung mit dem angegebenen IMAP-Server her (Attribut: Server). Es müssen für die Attribute Login und Passwort gültige Anmeldedaten eingetragen werden. Für das Attribut Port kann der für den IMAP-Server gültige Port eingetragen werden. Und über das Attribut UseSSL wird festgelegt, ob die Verbindung verschlüsselt werden soll.

<InitImap Server="" Port="993" Login="" Password="" UseSSL="true" Condition="" Variable="{@Result}" IgnoreError="false" />

 

ImapMailFolderList#

Ruft die Liste der E-Mail-Ordner eines IMAP-Postfaches ab und speichert die Ergebnisse in der angegebenen Daten-Tabelle.

<ImapMailFolderList Data="{@myData}" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• Data: Variable, in der die Ergebnisdaten der E-Mail-Ordner gespeichert werden.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Eine Variable in der gespeichert wird, ob die Aktion erfolgreich durchgeführt wurde. true oder false
• IgnoreError: (Optional) Wenn auf true gesetzt, werden auftretende Fehler ignoriert und die Aktion wird fortgesetzt.

Beispiel:

<ImapMailFolderList Data="{@myData}" Condition=""  Variable="{@Result}" IgnoreError="false" />

Im obigen Beispiel wird die Liste der E-Mail-Ordner abgerufen. Die Ergebnisdaten werden in der Variable {@myData} gespeichert. Da kein Wert für Condition gesetzt wurde, wird die Aktion immer ausgeführt.

 

ImapMailList#

Listet die E-Mails in einem bestimmten Ordner auf und speichert die Ergebnisse in der angegebenen Daten-Tabelle.

<ImapMailList Data="{@myData}" FolderId="inbox" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• Data: Variable, in der die aufgelisteten E-Mails gespeichert werden.
• FolderId: Die ID des Ordners, aus dem die E-Mails abgerufen werden sollen. 
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Eine Variable in der gespeichert wird, ob die Aktion erfolgreich durchgeführt wurde. true oder false
• IgnoreError: (Optional) Wenn auf true gesetzt, werden auftretende Fehler ignoriert und die Aktion wird fortgesetzt.

Beispiel:

<ImapMailList Data="{@myEmails}" FolderId="inbox" Condition="" Variable="{@Result}" IgnoreError="false" />

Dieses Beispiel ruft alle ungelesenen E-Mails aus dem Posteingang ab. Die Ergebnisse werden in der Variable {@myEmails} gespeichert.

 

ImapMailRead#

Liest Details einer bestimmten E-Mail und speichert sie in der angegebenen Variable.

<ImapMailRead FolderId="" MailId="" HtmlBody="true" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• FolderId: Die ID des Ordners, aus dem die E-Mail abgerufen werden soll.
• MailId: Die eindeutige ID der E-Mail, die gelesen werden soll.
• HtmlBody: Gibt an, ob der Text der E-Mail als Html ausgelesen werden soll.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Eine Variable in der gespeichert wird, ob die Aktion erfolgreich durchgeführt wurde. true oder false
• IgnoreError: (Optional) Wenn auf true gesetzt, werden auftretende Fehler ignoriert und die Aktion wird fortgesetzt.

Beispiel:

<ImapMailRead FolderId="inbox" MailId="AAMkAGIAAA" HtmlBody="true" Condition="" Variable="{@Result}" IgnoreError="false" />

In diesem Beispiel wird die E-Mail mit der ID AAMkAGIAAA=  ausgelesen. Der Text der Email E-Mail wird als Html in der Variablen {@EmailDetails} gespeichert.

 

ImapMailDelete#

Löscht eine bestimmte E-Mail anhand ihrer ID.

<ImapMailDelete FolderId="" MailId="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• FolderId: Die ID des Ordners, aus dem die E-Mail gelöscht werden soll.
• MailId: Die eindeutige ID der E-Mail, die gelöscht werden soll.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Eine Variable in der gespeichert wird, ob die Aktion erfolgreich durchgeführt wurde. true oder false
• IgnoreError: (Optional) Wenn auf true gesetzt, werden auftretende Fehler ignoriert und die Aktion wird fortgesetzt.

Beispiel:

<ImapMailDelete FolderId="inbox" MailId="AAMkAGIAAA=" Condition="" Variable="{@Result}" IgnoreError="false" />

Im Beispiel wird die E-Mail mit der ID AAMkAGIAAA=  gelöscht.

 

ImapMailMove#

Verschiebt eine E-Mail in einen anderen Ordner.

<ImapMailMove FolderId="" MailId="" DestinationFolderId="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• FolderId: Die ID des Ordners, aus dem die E-Mail verschoben werden soll.
• MailId: Die ID der E-Mail, die verschoben werden soll.
• DestinationFolderId: Die ID des Zielordners, in den die E-Mail verschoben werden soll.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Eine Variable in der gespeichert wird, ob die Aktion erfolgreich durchgeführt wurde. true oder false
• IgnoreError: (Optional) Wenn auf true gesetzt, werden auftretende Fehler ignoriert und die Aktion wird fortgesetzt.

Beispiel:

<ImapMailMove FolderId="inbox" MailId="AAMkAGIAAA=" DestinationFolderId="Archiv" Condition="" Variable="{@Result}" IgnoreError="false" />

Die E-Mail mit der ID AAMkAGIAAA= wird in den Ordner Archiv verschoben.

 

ImapMailAttachmentList#

Listet alle Anhänge einer E-Mail auf und speichert die Ergebnisse in der angegebenen Daten-Tabelle.

<ImapMailAttachmentList Data="{@myData}" FolderId="" MailId="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• Data: Variable, in der die Anhänge gespeichert werden.
• FolderId: Die ID des Ordners, aus dem die E-Mail abgerufen werden soll.
• MailId: Die ID der E-Mail, deren Anhänge aufgelistet werden sollen.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Eine Variable in der gespeichert wird, ob die Aktion erfolgreich durchgeführt wurde. true oder false
• IgnoreError: (Optional) Wenn auf true gesetzt, werden auftretende Fehler ignoriert und die Aktion wird fortgesetzt.

Beispiel:

<ImapAttachmentList Data="{@myAttachments}" FolderId="inbox" MailId="AAMkAGIAAA=" Condition="" Variable="{@Result}" IgnoreError="false" />

Hier werden die Anhänge der E-Mail mit der ID AAMkAGIAAA= aufgelistet. Die Ergebnisse werden in {@myAttachments} gespeichert.

 

ImapMailAttachmentDownload#

Lädt einen bestimmten Anhang einer E-Mail herunter und speichert ihn im angegebenen Zielordner.

<ImapMailAttachmentDownload FolderId="" MailId="" DestinationFolder="" AttachmentName="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• FolderId: Die ID des Ordners, aus dem die E-Mail abgerufen werden soll.
• MailId: Die ID der E-Mail, zu der der Anhang gehört.
• DestinationFolder: Der Zielordner, in dem der Anhang gespeichert wird.
• AttachmentName: Der Name der angehängten Datei.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Eine Variable in der gespeichert wird, ob die Aktion erfolgreich durchgeführt wurde. true oder false
• IgnoreError: (Optional) Wenn auf true gesetzt, werden auftretende Fehler ignoriert und die Aktion wird fortgesetzt.

Beispiel:

<ImapMailAttachmentDownload FolderId="inbox" MailId="AAMkAGIAAA=" DestinationFolder="C:\Downloads" AttachmentName="Report.pdf"  Condition="" Variable="{@Result}" IgnoreError="false" />

In diesem Beispiel wird der Anhang Report.pdf aus der E-Mail AAMkAGIAAA= heruntergeladen im Ordner C:\Downloads gespeichert.

 

ImapMailAttachmentDownloadAll#

Lädt alle Anhänge einer bestimmten E-Mail herunter und speichert sie im angegebenen Zielordner.

<ImapAttachmentDownloadAll FolderId="" MailId="" DestinationFolder="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• FolderId: Die ID des Ordners, aus dem die E-Mail abgerufen werden soll.
• MailId: Die ID der E-Mail, aus der alle Anhänge heruntergeladen werden sollen.
• DestinationFolder: Der Zielordner, in dem die Anhänge gespeichert werden.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Eine Variable in der gespeichert wird, ob die Aktion erfolgreich durchgeführt wurde. true oder false
• IgnoreError: (Optional) Wenn auf true gesetzt, werden auftretende Fehler ignoriert und die Aktion wird fortgesetzt.

Beispiel:

<ImapMailAttachmentDownloadAll FolderId="inbox" MailId="AAMkAGIAAA=" DestinationFolder="C:\Downloads" Condition="" Variable="{@Result}" IgnoreError="false" />

In diesem Beispiel werden alle Anhänge aus der E-Mail AAMkAGIAAA= heruntergeladen und im Ordner C:\Downloads gespeichert.

 

ImapMailExportToEml#

Lädt die E-Mail herunter und speichert sie als .eml Datei im angegebenen Zielordner.

<ImapMailExportToEml FolderId="" MailId="" DestinationFolder="" FileName="export.eml" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• FolderId: Die ID des Ordners, aus dem die E-Mail abgerufen werden soll.
• MailId: Die ID der E-Mail, aus der alle Anhänge heruntergeladen werden sollen.
• DestinationFolder: Der Zielordner, in dem die .eml Datei gespeichert werden soll.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Eine Variable in der gespeichert wird, ob die Aktion erfolgreich durchgeführt wurde. true oder false
• IgnoreError: (Optional) Wenn auf true gesetzt, werden auftretende Fehler ignoriert und die Aktion wird fortgesetzt.

Beispiel:

<ImapMailExportToEml FolderId="inbox" MailId="AAMkAGIAAA=" DestinationFolder="C:\Downloads" FileName="export.eml" Condition="" Variable="{@Result}" IgnoreError="false" />

In diesem Beispiel wird die E-Mail AAMkAGIAAA= heruntergeladen und als export.eml Datei im Ordner C:\Downloads gespeichert.

 

MailReadEmlToJson#

Die Aktion MailReadEmlToJson liest eine .eml-Datei und gibt deren Inhalt als JSON-Objekt zurück. Das JSON-Objekt enthält die wichtigsten Felder der E-Mail und kann anschließend mit den JSON-Aktionen weiterverarbeitet werden.

<MailReadEmlToJson MailEml="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• MailEml: Der Pfad zur .eml-Datei, die gelesen werden soll.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: Die Variable, in der das JSON-Objekt der E-Mail gespeichert wird.
• IgnoreError: (Optional) Wenn auf true gesetzt, werden auftretende Fehler ignoriert und die Aktion wird fortgesetzt.

Das zurückgegebene JSON-Objekt enthält folgende Felder:
Subject: Der Betreff der E-Mail.
FromAddress: Die Absenderadresse.
BodyText: Der Textinhalt der E-Mail.
BodyHtml: Der HTML-Inhalt der E-Mail.
DateSent: Das Sendedatum der E-Mail.

Beispiel:

<MailReadEmlToJson MailEml="C:\Ablage\export.eml" Condition="" Variable="{@MailJson}" IgnoreError="false" />

<JSONRead Json="{@MailJson}" Path="Subject"     Variable="{@Subject}" />
<JSONRead Json="{@MailJson}" Path="FromAddress" Variable="{@Von}" />
<JSONRead Json="{@MailJson}" Path="BodyText"    Variable="{@Text}" />
<JSONRead Json="{@MailJson}" Path="DateSent"    Variable="{@Datum}" />

In diesem Beispiel wird die Datei export.eml eingelesen und die Felder Subject, FromAddress, BodyText und DateSent werden in separate Variablen extrahiert.

 

MailSaveEmlAttachments#

Die Aktion MailSaveEmlAttachments extrahiert alle Anhänge aus einer .eml-Datei und speichert diese in einem angegebenen Zielverzeichnis.

<MailSaveEmlAttachments MailEml="" Destination="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

MailEml: Der Pfad zur .eml-Datei, aus der die Anhänge extrahiert werden sollen.
Destination: Das Zielverzeichnis, in das die Anhänge gespeichert werden.
Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
Variable: (Optional) Eine Variable, in der gespeichert wird, ob die Aktion erfolgreich durchgeführt wurde (true oder false).
IgnoreError: (Optional) Wenn auf true gesetzt, werden auftretende Fehler ignoriert und die Aktion wird fortgesetzt.

Beispiel:

<MailSaveEmlAttachments MailEml="C:\Ablage\export.eml" Destination="C:\Ablage\Anhänge" Condition="" Variable="{@Result}" IgnoreError="false" />

In diesem Beispiel werden alle Anhänge aus der Datei export.eml extrahiert und im Verzeichnis C:\Ablage\Anhänge gespeichert.