EWS

Funktion

Test Exchange Web Services

Alarmierung

Fehlercode, Antwortcode, Verbindungszeit, Anmeldezeit, Gesamtzahl der E-Mails, Ungelesene E-Mails, Kalenderelemente, Kontakte, Gefundene E-Mails, Laufzeit

Exchange Web Services (EWS) bietet Funktionen, mit denen Client-Anwendungen mit dem Exchange-Server kommunizieren können. EWS bietet Zugriff auf weitgehend dieselben Daten, die auch über Microsoft Office Outlook verfügbar sind. EWS-Clients können Outlook-Daten in Line-of-Business-Anwendungen (LOB) integrieren. SOAP stellt das Messaging-Framework für Nachrichten bereit, die zwischen der Client-Anwendung und dem Exchange-Server gesendet werden. Die SOAP-Nachrichten werden über HTTP gesendet.

EWS-Details

EWS-Parameter

Parameter

Beschreibung

Konto

Verbindungstyp definieren, zwischen Klartext oder SSL/TLS wählen

Benutzername

Der Benutzername für die Authentifizierung

Passwort

Das Passwort für die Authentifizierung

Ordnername

Anderen Ordner als den Posteingang suchen

Allgemein

Stammverzeichnis anzeigen

E-Mail senden

E-Mail im HTML-Format senden (Von = Konto)

E-Mails auflisten

E-Mails auflisten/suchen

Kalender

Kalenderelemente auflisten/suchen

Kontakte

Kontakte auflisten/suchen

Wenn Befehle zum Erstellen von Listen ausgewählt werden, wird eine Datei erstellt und an die Benutzeroberfläche gesendet.

Optionale Parameter

EWS-Werte und Alarm Limits

Wert / Alarm Limit

Beschreibung

Verbindungszeit

Zeit für die Verbindung zum Remote-Server (in ms)

Anmeldezeit

Zeit für die Datenübertragung vom Remote-Server (in ms)

E-Mails insgesamt

Anzahl der E-Mails

Ungelesene E-Mails

Anzahl ungelesener E-Mails

Kalenderelemente

Gesamtzahl der Kalendereinträge, wenn der Listenparameter aktiviert ist

Kontakte

Anzahl aller Kontakte, wenn der Listenparameter aktiviert ist

Gefundene E-Mails

Anzahl der gefundenen E-Mails basierend auf dem Suchparameter

Gefundene Kalendereinträge

Anzahl der gefundenen Kalenderelemente basierend auf dem Suchparameter

Gefundene Kontakte

Anzahl der gefundenen Kontakte basierend auf Suchparametern

Antwortcode

EWS-Antwortcodes

 0 =
OK-1 = Allgemeiner Fehler
6 = Parameter fehlt
11 = Ausführung fehlgeschlagen
12 = Python-Fehler
13 = Zeitüberschreitung
14 = Nicht autorisiert
15 = SOAP-Fehler
16 = Fehler bei der
Ratenbegrenzung 17 = Transportfehler
18 = SSL/TLS-Fehler
30 = Mailbox-Fehler
31 = E-Mail nicht gefunden
32 = E-Mail konnte nicht gesendet werden
41 = Kalenderelement nicht gefunden
51 = Kontakt nicht gefunden

Laufzeit

Zeit bis zur Fertigstellung des Auftrags (in s)

Fehlercode

Allgemeiner Auftragsfehlercode (siehe Abschnitt „Auftragsfehlercodes”)

Ausgabe

Wenn Elemente aufgelistet oder gesucht werden, wird eine Textdatei erstellt und an die Benutzeroberfläche gesendet.

Beispiele

Suche nach bestimmten E-Mails

Die folgende Konfiguration zählt nur E-Mails, deren Betreff „Teststring“ enthält:

3 E-Mails mit übereinstimmendem Betreff gefunden:

E-Mails suchen und Ergebnisdatei schreiben

Suche nach bestimmten E-Mails und Schreiben einer Ergebnisdatei:

Eine zusätzliche Zeile mit der Ausgabedatei wird angezeigt. Die Datei kann im Browser geöffnet oder zur weiteren Verarbeitung auf dem SKOOR Server verwendet werden:

E-Mails in der Ergebnisdatei auflisten

Bei Bedarf können die ältesten oder neuesten E-Mails in der Ausgabedatei aufgelistet werden. Die Anzahl der aufgelisteten E-Mails kann im Feld neben dem Dropdown-Menü „E-Mails auflisten” konfiguriert werden (1, wenn leer gelassen). Die durch die Konfiguration „Suchen nach” gefundenen E-Mails werden separat in derselben Datei aufgelistet.

Beispiel für eine Ausgabedatei

Die Datei enthält eine Kopfzeile, gefolgt von Abschnitten, wie sie in den Job-Einstellungen konfiguriert sind. Die folgende Beispieldatei enthält einen Abschnitt mit den zehn neuesten E-Mails und einen mit den E-Mails, die durch die Konfiguration „Suchen nach“ gefunden wurden. Beide Abschnitte beginnen mit dem Job-Status:

2018-10-25 14:18:35
Device: mail.company.com
Account: user@company.com
User: user
Name of inbox:  Posteingang
OK: Mail list (max 10 newest entries) of 'Posteingang':
      Sender                                	Received                  	Subject
    1 Worker, Mat					        	2018-10-25 11:32:11+00:00 	Just a test
    2 Example, Max 			                 	2018-10-25 09:55:51+00:00 	Reporting
    3 Test, Pat		                        	2018-10-25 05:27:18+00:00 	Weekly Meeting
	...
   10 Example, Max			                	2018-10-22 08:49:00+00:00 	Question
OK: Mails searched for 'Teststring' in 'Posteingang':
      Sender                                	Received                  	Subject
    1 Test, Pat				                 	2018-10-23 09:26:10+00:00 	Teststring
    2 Example, Max				            	2018-10-18 09:12:15+00:00 	Question about Teststring
    3 Test, Pat					            	2018-10-18 09:12:14+00:00 	Information: Teststring