EWS

Funktion

Test Exchange Web Services

Alarmierung

Fehlercode, Antwortcode, Verbindungszeit, Anmeldezeit, Mails gesamt, Mails ungelesen, Kalendereinträge, Kontakte, Gefundene Mails, Laufzeit

Exchange Web Services (EWS) bietet die Funktionalität, die es Client-Anwendungen ermöglicht, mit dem Exchange Server zu kommunizieren. EWS ermöglicht den Zugriff auf viele der Daten, die auch über Microsoft OfficeOutlook verfügbar sind. EWS-Clients können Outlook-Daten in Line-of-Business (LOB)-Anwendungen 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 versendet.

EWS-Details

EWS-Parameter

Parameter

Beschreibung

Konto

Definieren Sie den Verbindungstyp, wählen Sie zwischen Plain Text oder SSL/TLS

Benutzername

Der Benutzername für die Authentifizierung

Kennwort

Das Passwort für die Authentifizierung

Name des Ordners

Suche in einem anderen Ordner als dem Posteingang

Allgemein

Stammverzeichnis anzeigen

E-Mail senden

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

Mails auflisten

Liste / Suche nach Mails

Kalender

Liste / Suche nach Kalendereinträgen

Kontakte

Liste / Suche nach Kontakten

Wenn Befehle, die Listen erzeugen, 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 mit dem entfernten Server (in ms)

Anmeldezeit

Zeit für die Übertragung von Daten vom entfernten Server (in ms)

Mails Gesamt

Anzahl der Mails

Ungelesene Mails

Anzahl der ungelesenen Mails

Kalendereinträge

Anzahl der gesamten Kalendereinträge, wenn der Listenparameter aktiviert ist

Kontakte

Anzahl der gesamten Kontakte, wenn der Listenparameter aktiviert ist

Gefundene Mails

Anzahl der gefundenen 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

Antwort-Code

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 = Transport-Fehler
18 = SSL/TLS-Fehler
30 = Mailbox-Fehler
31 = Mail nicht gefunden
32 = Mail konnte nicht gesendet werden
41 = Kalendereintrag nicht gefunden
51 = Kontakt nicht gefunden

Laufende Zeit

Zeit bis zum Abschluss des Auftrags (in s)

Fehlercode

Allgemeiner Job-Fehlercode (siehe Abschnitt Job-Fehlercodes)

Ausgabe

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

Beispiele

Suche nach bestimmten Mails

Die folgende Konfiguration zählt nur Mails mit einem Betreff, der "Teststring" enthält:

3 Mails mit einem passenden Betreff gefunden:

Mails suchen und Ergebnisdatei schreiben

Nach bestimmten Mails suchen und eine Ergebnisdatei schreiben:

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

Mails in Ergebnisdatei auflisten

Bei Bedarf können die ältesten oder neuesten Mails in der Ausgabedatei aufgelistet werden. Die Anzahl der aufgelisteten Mails kann im Feld neben dem Dropdownfeld Mails auflisten konfiguriert werden (1, wenn leer gelassen). Die mit der Konfiguration Suchen nach gefundenen Mails werden separat in der gleichen Datei aufgelistet.

Beispiel einer Ausgabedatei

Die Datei enthält eine Kopfzeile, gefolgt von den Abschnitten, die in den Auftragseinstellungen konfiguriert wurden. Die folgende Beispieldatei enthält einen Abschnitt mit den zehn neuesten Mails und einen mit den Mails, die durch die Konfiguration Search for 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