Mail-Module
Der Ordner TBox XEngines->Mail in der Standard-Untermenge enthält Module, die bestimmte Aufgaben für die Mail Engine 3.0 ausführen.
Connect to Exchange Server
Das Modul Connect to Exchange Server ermöglicht es Ihnen, eine Verbindung zu einem Microsoft Exchange Server herzustellen, um E-Mail-Funktionen zu testen. Sie können diesen Schritt für die Exchange-Server- und Mail-Server-Testfälle verwenden.
Das Modul hat die folgenden Modulattribute:
Modulattribut |
Beschreibung |
---|---|
Connection Name |
Geben Sie einen eindeutigen Namen für den Exchange-Server an, mit dem Sie eine Verbindung herstellen möchten. Die Mail Engine 3.0 verwendet diesen Verbindungsnamen in nachfolgenden Testschritten, um sich mit dem Exchange-Server zu verbinden. |
Authentication Type |
Wählen Sie die Authentifizierungsmethode für die Verbindung mit dem Exchange Server-Endpunkt aus. Folgende Einstellungen stehen zur Verfügung:
Verwenden Sie in Ihren zugehörigen Testschritten immer dieses Modulattribut mit der Aktion Select. |
Username |
Benutzername des Exchange-Server-Kontos. |
Password |
Passwort des Benutzerkontos. |
App Id |
Wenn Sie OAuth als Authentication Type auswählen, geben Sie die Application (client) ID Ihrer Registrierung bei der Microsoft Identity Platform an. |
Tenant Id |
Wenn Sie OAuth als Authentication Type auswählen, geben Sie die Directory (tenant) ID Ihrer Registrierung bei der Microsoft Identity Platform an. |
Exchange Web Services Url |
Optional können Sie die Adresse des Exchange-Servers angeben. Verwenden Sie das Format https://<mail-server>/ews/exchange.asmx und ersetzen Sie <mail-server> durch die Adresse Ihres Exchange-Servers. Andernfalls legt der AutoErmittlungsdienst im Exchange-Server dieses Modulattribut automatisch fest, wenn es aus dem Benutzernamen abgeleitet werden kann. |
![]() |
Tricentis Tosca unterstützt Office 365. Wenn die mehrstufige Azure-Authentifizierung (Multi-Factor Authentication, MFA) für Ihr Konto aktiviert ist, müssen Sie ein neues App-Kennwort für die zweistufige Überprüfung (2FA) erstellen. Weitere Informationen finden Sie in der Microsoft-Dokumentation: Verwalten von App-Kennwörtern für die zweistufige Überprüfung. |
![]() |
In diesem Beispiel stellen Sie eine Verbindung mit dem Namen SampleConnection her, die sich mit dem Exchange-Server exchangemail.com verbindet. Tricentis empfiehlt, für jeden Request, den Sie an einen EWS-Endpunkt senden, HTTPS zu verwenden, um die Kommunikation zwischen Ihrer Applikation und dem Exchange-Server abzusichern.
Verbindung zum Exchange-Server herstellen
|
Connect to Mail Server
Mit dem Modul Connect to Mail Server können Sie einen E-Mail-Server angeben, mit dem Sie E-Mail-Funktionen testen. Wenn keine Testschrittwert mit Anmeldedaten vorhanden ist, wird der aktuell angemeldete Windows-Benutzer für die Verbindung zum Mail Server verwendet.
Das Modul hat die folgenden Modulattribute:
Modulattribut |
Beschreibung |
---|---|
Connection Name |
Geben Sie einen eindeutigen Namen für den Mail-Server an, mit dem Sie eine Verbindung herstellen möchten. Die Mail Engine 3.0 verwendet diesen Verbindungsnamen in späteren Testschritten, um sich mit dem Mail-Server zu verbinden. |
Mail Server |
IP-Adresse oder FQDN (vollqualifizierter Domänenname) des Mail-Servers. |
Username |
Benutzername des Kontos, mit dem Sie auf den Mail-Server zugreifen. |
Password |
Passwort des angegebenen Benutzernamens. |
Port |
Portnummer, über die Sie sich verbinden. Stellen Sie sicher, dass der Port offen ist und nicht von der Firewall blockiert wird. |
Enable Security |
Wählen Sie aus, ob Sie während des E-Mail-Betriebs eine sichere Verbindung mit SSL/TLS-Zertifikaten verwenden möchten. Die verfügbaren Werte sind:
|
Protocol |
Geben Sie das Netzwerkprotokoll an, das Sie verwenden möchten. Die verfügbaren Werte sind:
|
![]() |
In diesem Beispiel stellen Sie eine Verbindung namens SampleConnection her, die sich mit dem Mail-Server mailengine.examplecompany.com verbindet. Diese Verbindung hat die folgenden Spezifikationen:
Verwenden Sie den folgenden Testschritt, um Ihre Verbindung zum Mail Server zu definieren.
Verbindung zu mailengine.examplecompany.com herstellen
|
Receive Mail Simple
Mit dem Modul Receive Mail Simple können Sie überprüfen, ob Sie eine bestimmte, einzelne E-Mail erhalten haben. Diese Funktionalität unterstützt nur POP3- oder IMAP-Protokolle.
Wenn Sie den Empfang mehrerer E-Mails überprüfen möchten, verwenden Sie das Modul Receive Mail Expert.
Das Modul Receive Mail Simple hat die folgenden Modulattribute:
Modulattribut |
Beschreibung |
---|---|
Connection Name |
Name der von Ihnen definierten Verbindung. Verwenden Sie die Aktion Input. |
From Address |
Geben Sie die E-Mail-Adresse des Absenders an. Dieses Modulattribut ist optional. |
From Name |
Geben Sie den Namen des Absenders an. Dieses Modulattribut ist optional. |
To |
Geben Sie einen Empfänger an. Dieses Modulattribut ist optional. |
Cc |
Geben Sie einen Kopienempfänger an. Dieses Modulattribut ist optional. |
From Date/Time |
Geben Sie das Startdatum und die Startuhrzeit des Suchzeitraums an. Dieses Modulattribut ist optional. |
To Date/Time |
Geben Sie das Enddatum und die Enduhrzeit des Suchzeitraums an. Dieses Modulattribut ist optional. |
Subject |
Geben Sie die Betreffzeile an. Dieses Modulattribut ist optional. |
Body |
Geben Sie den Nachrichtenkörper ein. Sie können HTML- oder PLAIN-Text angeben. Wenn Sie keine Option auswählen, ist das Standardformat für E-Mails Klartext. Verwenden Sie Platzhalter, um sicherzustellen, dass die Mail Engine 3.0 nur den Textkörper und nicht die HTML-Tags überprüft. Beachten Sie, dass die Werteingaben zwischen Groß- und Kleinschreibung unterscheiden. Dieses Modulattribut ist optional. |
Attachment Name |
Geben Sie den Dateinamen des Anhangs an. Sie können mehrere Anhänge haben. Im Hintergrund speichert die Mail Engine 3.0 alle Namen von Anhängen als eine Zeichenfolge, getrennt durch Semikolon. Wenn Sie überprüfen möchten, ob ein bestimmter Anhang vorhanden ist, verwenden Sie führende und nachgestellte Platzhalter. Die Platzhalter stellen sicher, dass die Mail Engine 3.0 nur das Vorhandensein des einen Anhangs und nicht die gesamte Zeichenfolge überprüft. Wenn Sie beispielsweise mehrere Anhänge haben, aber nur überprüfen möchten, ob der Anhang TestAttachment.txt vorhanden ist, geben Sie *TestAttachment.txt* ein. Sie können auch Namen von Anhängen in den Buffer schreiben. Sie können jedoch nur die gesamte Zeichenfolge in den Buffer schreiben, nicht einzelne Namen von Anhängen. Dieses Modulattribut ist optional. |
Folder |
Diese Funktionalität wird nur von IMAP-Servern unterstützt. Geben Sie den Pfad der Ordnerstruktur an, z. B. INBOX.TestFolder. Das Trennzeichen hängt von dem von Ihnen verwendeten Mail-Server ab. Verwenden Sie die Aktion Input. Die Servereinstellungen bestimmen die genauen Ordnernamen, einschließlich Klein- und Großbuchstaben. Dieses Modulattribut ist optional. |
Save Attachments To |
Geben Sie den Pfad zum Ordner an, in dem Sie den Anhang speichern möchten. Verwenden Sie die Aktion Input. Wenn Ihre E-Mail mehrere Anhänge enthält, werden alle in diesem Ordner gespeichert. Wenn der Ordner bereits Anhänge mit dem gleichen Namen enthält, überschreibt die Mail Engine 3.0 die vorhandenen Dateien. Dieses Modulattribut ist optional. |
Save Mail |
Geben Sie einen eindeutigen Namen für die E-Mail an, die Sie speichern möchten. Im Modul Send Mail kann dieser verwendet werden, um eine Antwort zu senden. |
Number of Emails to examine |
Geben Sie die maximale Anzahl der zu untersuchenden E-Mails an. Dieses Modulattribut ist optional. |
Sie können reguläre Ausdrücke und Platzhalter verwenden.
Aktionen verwenden
Sofern in den Beschreibungen der Modulattribute in der obigen Tabelle nicht anders angegeben, können Sie die folgenden Aktionen verwenden:
-
Aktion Input, um Basissuchkriterien zu definieren.
-
Aktion Constraint, um die Suche nach allen E-Mails, die den Basissuchkriterien entsprechen, weiter einzuschränken.
-
Aktion Verify, um Daten zu überprüfen.
-
Aktion Buffer, um Daten in einem Buffer zu speichern.
![]() |
In diesem Beispiel überprüfen Sie, ob Sie eine bestimmte, einzelne E-Mail mit folgendem Inhalt erhalten haben: „Congratulations on your research grant“. Dazu verwenden Sie die Verbindung SampleConnection, die Sie zuvor eingerichtet haben (siehe Kapitel "Connect to Mail Server"). Die Basis-Suchkriterien sind die folgenden:
Aus allen E-Mails, die diesen Kriterien entsprechen, suchen Sie diejenige, welche die folgenden Anforderungen erfüllt:
Sobald die Mail Engine 3.0 die E-Mail gefunden hat, möchten Sie die folgenden Aktionen durchführen:
E-Mail mit formatiertem Inhalt suchen
E-Mail mit Inhalt suchen |
Receive Mail Expert
Mit dem Modul Receive Mail Expert können Sie überprüfen, ob Sie bestimmte E-Mails erhalten haben. Diese Funktionalität unterstützt nur POP3- oder IMAP-Protokolle.
Wenn Sie überprüfen möchten, ob Sie eine bestimmte, einzelne E-Mail erhalten haben, verwenden Sie das Modul Receive Mail Simple.
Das Modul Receive Mail Expert hat die folgenden Modulattribute:
Modulattribut |
Beschreibung |
---|---|
Connection Name |
Name der von Ihnen definierten Verbindung. Verwenden Sie die Aktion Input. |
Search criteria |
Schreibgeschützt. |
Search criteria->From Address |
Geben Sie die E-Mail-Adresse des Absenders an. Dieses Modulattribut ist optional. |
Search criteria->From Name |
Geben Sie den Namen des Absenders an. Dieses Modulattribut ist optional. |
Search criteria->To |
Geben Sie einen Empfänger an. Dieses Modulattribut ist optional. |
Search criteria->Cc |
Geben Sie einen Kopienempfänger an. Dieses Modulattribut ist optional. |
Search criteria->Subject |
Geben Sie die Betreffzeile an. Dieses Modulattribut ist optional. |
Search criteria->Attachment Name |
Geben Sie den Dateinamen des Anhangs an. Sie können mehrere Anhänge haben. Im Hintergrund speichert die Mail Engine 3.0 alle Namen von Anhängen als eine Zeichenfolge, getrennt durch Semikolon. Wenn Sie überprüfen möchten, ob ein bestimmter Anhang vorhanden ist, verwenden Sie führende und nachgestellte Platzhalter. Die Platzhalter stellen sicher, dass die Mail Engine 3.0 nur das Vorhandensein des einen Anhangs und nicht die gesamte Zeichenfolge überprüft. Wenn Sie beispielsweise mehrere Anhänge haben, aber nur überprüfen möchten, ob der Anhang TestAttachment.txt vorhanden ist, geben Sie *TestAttachment.txt* ein. Sie können auch Namen von Anhängen in den Buffer schreiben. Sie können jedoch nur die gesamte Zeichenfolge in den Buffer schreiben, nicht einzelne Namen von Anhängen. Dieses Modulattribut ist optional. |
Search criteria->Body |
Geben Sie den Nachrichtenkörper ein. Sie können HTML- oder PLAIN-Text angeben. Wenn Sie keine Option auswählen, ist das Standardformat für E-Mails Klartext. Verwenden Sie Platzhalter, um sicherzustellen, dass die Mail Engine 3.0 nur den Textkörper und nicht die HTML-Tags überprüft. Dieses Modulattribut ist optional. |
Search criteria->From Date/Time |
Geben Sie das Startdatum und die Startuhrzeit des Suchzeitraums an. Die Mail Engine 3.0 verwendet die UTC-Zeit. Daher müssen Sie die Startzeit und das Startdatum in UTC-Zeit eingeben. Dieses Modulattribut ist optional. |
Search criteria->To Date/Time |
Geben Sie das Enddatum und die Enduhrzeit des Suchzeitraums an. Die Mail Engine 3.0 verwendet die UTC-Zeit. Daher müssen Sie die Endzeit und das Enddatum in UTC-Zeit eingeben. Dieses Modulattribut ist optional. |
Search criteria->Folder |
Diese Funktionalität wird nur von IMAP-Servern unterstützt. Geben Sie den Pfad der Ordnerstruktur an, z. B. INBOX.TestFolder. Das Trennzeichen hängt von dem von Ihnen verwendeten Mail-Server ab. Verwenden Sie die Aktion Input. Die Servereinstellungen bestimmen die genauen Ordnernamen, einschließlich Klein- und Großbuchstaben. Dieses Modulattribut ist optional. |
Search criteria->Number of Emails to examine |
Geben Sie die maximale Anzahl der zu untersuchenden E-Mails an. Dieses Modulattribut ist optional. |
Result |
Schreibgeschützt. |
Result->ResultCount |
Überprüfen Sie die Ergebniszählung der von Ihnen angegebenen Filterkriterien, d. h., wie viele E-Mails der spezifische Filter erzeugt. Geben Sie dazu die erwartete Anzahl ein und verwenden Sie die Aktion Verify. |
Result->Mail |
Jeder Mail-Knoten unter Result steht für eine einzelne E-Mail, die Sie suchen und testen möchten. Sie können nach mehreren E-Mails suchen und diese testen. Legen Sie dazu für jede E-Mail einen eigenen Knoten an und füllen Sie die Mail-Attribute unter Mail Attributes aus. Sie können die folgenden Kriterien aus dem Aufklappmenü Mail auswählen:
|
Result->Mail->Mail Attributes |
Geben Sie weitere Suchkriterien an, um die Suche einzugrenzen. Sie können die folgenden Kriterien aus dem Aufklappmenü Mail Attributes auswählen:
|
Result->Mail->Mail Operations |
Sie können die folgenden Operationen aus dem Aufklappmenü Mail Operations auswählen:
Sie können eine Operation pro E-Mail verwenden. Verwenden Sie die Aktion Select. |
Result->Mail->Save Attachments To |
Geben Sie den Pfad zum Ordner an, in dem Sie den Anhang speichern möchten. Verwenden Sie die Aktion Input. Wenn Ihre E-Mail mehrere Anhänge enthält, werden alle in diesem Ordner gespeichert. Wenn der Ordner bereits Anhänge mit dem gleichen Namen enthält, überschreibt die Mail Engine 3.0 die vorhandenen Dateien. Dieses Modulattribut ist optional. |
Result->Mail->Save Mail |
Geben Sie einen eindeutigen Namen für die E-Mail an, die Sie speichern möchten. Im Modul Send Mail kann dieser verwendet werden, um eine Antwort zu senden. |
Sie können reguläre Ausdrücke und Platzhalter verwenden.
Aktionen verwenden
Sofern in den Beschreibungen der Modulattribute in der obigen Tabelle nicht anders angegeben, können Sie die folgenden Aktionen verwenden:
-
Aktion Input, um Basissuchkriterien zu definieren.
-
Aktion Constraint, um die Suche nach allen E-Mails, die den Basissuchkriterien entsprechen, weiter einzuschränken.
-
Aktion Verify, um Daten zu überprüfen.
-
Aktion Buffer, um Daten in einem Buffer zu speichern.
![]() |
In diesem Beispiel prüfen Sie, ob Sie bestimmte E-Mails erhalten haben. Dazu verwenden Sie die Verbindung SampleConnection, die Sie zuvor eingerichtet haben (siehe Kapitel "Connect to Mail Server"). Die Basis-Suchkriterien sind die folgenden:
Von allen E-Mails, die diesen Kriterien entsprechen, suchen Sie nach drei spezifischen E-Mails. Sie möchten auch überprüfen, ob nur drei E-Mails alle angegebenen Kriterien erfüllen. Dazu überprüfen Sie die Ergebniszählung. Email 1 muss die folgenden Anforderungen erfüllen:
Außerdem möchten Sie die folgenden Aktionen für Email 1 durchführen:
Email 2 muss die folgenden Anforderungen erfüllen:
Außerdem möchten Sie die folgenden Aktionen für Email 2 durchführen:
Email 3 muss die folgenden Anforderungen erfüllen:
Außerdem möchten Sie die folgenden Aktionen für Email 3 durchführen:
Nach drei bestimmten E-Mails suchen |
Auf eine E-Mail antworten
Sie können auf eine empfangene und gespeicherte E-Mail antworten, indem Sie das Modul Send Mail verwenden.
Dazu müssen Sie alle Antwortfelder mit gültigen Werten füllen wie im folgenden Beispiel gezeigt. Die Mail Engine füllt die Felder Betreff und Adresse mit Werten aus der ursprünglichen E-Mail, die Sie erhalten haben. Für die Betreffzeile fügt sie das Präfix Re: vor dem ursprünglichen E-Mail-Betreff hinzu.
Sie können das Modulattribut Body für den Inhalt Ihrer Antwort-E-Mail verwenden. Sie können auch neue Anhänge hinzufügen. Die Antwort-E-Mail enthält keine Anhänge aus der ursprünglichen E-Mail, auf die Sie antworten.
![]() |
In diesem Beispiel antworten Sie auf eine E-Mail-Nachricht. Zuerst müssen Sie nach der E-Mail suchen, auf die Sie antworten möchten, und diese speichern. Sie haben die folgenden Basis-Suchkriterien:
Mehrere E-Mails entsprechen diesen Kriterien, weshalb Sie die folgenden Kriterien hinzufügen:
Sobald die Mail Engine 3.0 die E-Mail gefunden hat, möchten Sie die folgenden Aktionen durchführen:
Eine bestimmte E-Mail suchen und speichern Nun können Sie die Antwortnachricht senden:
Eine Antwort-E-Mail senden |
Send Mail
Das Modul Send Mail ermöglicht es Ihnen, E-Mails über das Simple Mail Transfer Protocol (SMTP) zu senden und zu beantworten.
Es besitzt die folgenden Modulattribute:
Modulattribut |
Beschreibung |
---|---|
Connection Name |
Geben Sie den Namen der von Ihnen definierten Verbindung ein. |
From->Address |
Geben Sie die E-Mail-Adresse des Absenders an. |
From->Name |
Geben Sie den Namen des Absenders an. Dieses Modulattribut ist optional. |
Subject |
Geben Sie die Betreffzeile an. Dieses Modulattribut ist optional. |
To |
Geben Sie einen Empfänger an. Sie können mehrere Empfänger hinzufügen. |
Cc |
Geben Sie einen Kopienempfänger an. Sie können mehrere Empfänger in separaten Modulattributen hinzufügen. Dieses Modulattribut ist optional. |
Bcc |
Geben Sie einen Blindkopienempfänger an. Sie können mehrere Empfänger in separaten Modulattributen hinzufügen. Dieses Modulattribut ist optional. |
Body |
Geben Sie den Nachrichtenkörper ein. Sie können das HTML- oder PLAIN-Textformat angeben. Wenn Sie keine Option auswählen, sendet das System die E-Mail standardmäßig im HTML-Format. Dieses Modulattribut ist optional. |
Attachment |
Geben Sie den vollständigen Dateipfad zum Anhang an. Sie können mehrere Anhänge in separaten Modulattributen hinzufügen. Dieses Modulattribut ist optional. |
Reply To->Mail To Reply |
Name der gespeicherten E-Mail. Dieses Modulattribut ist optional. |
Reply To->Reply Options |
Wählen Sie eine der folgenden Optionen aus dem Aufklappmenü Reply Options:
Dieses Modulattribut ist optional. |
![]() |
In diesem Beispiel senden Sie eine E-Mail-Nachricht mit den folgenden Spezifikationen:
Eine E-Mail senden |