SKOOR Dokumentation

EWS

Funktion	Webdienste von Exchange testen
Alarmierung	Fehlercode, Antwortcode, Verbindungsdauer, Anmeldezeit, Gesamtzahl der E-Mails, ungelesene E-Mails, Kalendertermine, Kontakte, gefundene E-Mails, Laufzeit

Exchange Web Services (EWS) bieten die Funktionalität, mit der Client-Anwendungen mit dem Exchange-Server kommunizieren können. EWS ermöglicht den 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 ausgetauscht werden. Die SOAP-Nachrichten werden über HTTP gesendet.

EWS-Details

EWS-Parameter

Parameter	Beschreibung
Konto	Verbindungstyp festlegen, wählen Sie zwischen „Plain Text“ oder „SSL/TLS“
Benutzername	Der Benutzername für die Authentifizierung
Passwort	Das Passwort für die Authentifizierung
Ordnername	Anderen Ordner als den Posteingang durchsuchen
Allgemein	Stammverzeichnis anzeigen
E-Mail senden	E-Mail im HTML-Format senden (Absender = Konto)
E-Mails auflisten	E-Mails auflisten / suchen
Kalender	Kalendereinträge 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 zum Herstellen der 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 der ungelesenen E-Mails
Kalendereinträge	Gesamtzahl der Kalendereinträge, wenn der Listenparameter aktiviert ist
Kontakte	Gesamtzahl der Kontakte, wenn der Listenparameter aktiviert ist
Gefundene E-Mails	Anzahl der gefundenen E-Mails basierend auf dem Suchparameter
Gefundene Kalendereinträge	Anzahl der gefundenen Kalendereinträge basierend auf dem Suchparameter
Gefundene Kontakte	Anzahl der gefundenen Kontakte basierend auf den 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 = Postfachfehler 31 = E-Mail nicht gefunden 32 = E-Mail konnte nicht gesendet werden 41 = Kalendertermin nicht gefunden 51 = Kontakt nicht gefunden
Laufzeit	Zeit bis zum Abschluss des Auftrags (in s)
Fehlercode	Generischer 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 passendem Betreff gefunden:

E-Mails suchen und Ergebnisdatei erstellen

Suche nach bestimmten E-Mails und Erstellen einer Ergebnisdatei:

Es wird eine zusätzliche Zeile mit der Ausgabedatei 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 lässt sich im Feld neben dem Dropdown-Menü „E-Mails auflisten“ konfigurieren (1, wenn das Feld leer gelassen wird). Die durch die Konfiguration „Suchen nach“ gefundenen E-Mails werden separat in derselben Datei aufgelistet.

Beispiel für eine Ausgabedatei

Die Datei enthält einen Header, gefolgt von Abschnitten, wie sie in den Auftragseinstellungen konfiguriert wurden. Die folgende Beispieldatei enthält einen Abschnitt mit den zehn neuesten E-Mails und einen mit den E-Mails, die durch die „Suche nach“-Konfiguration gefunden wurden. Beide Abschnitte beginnen mit dem Auftragsstatus:

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