1. Überblick
Die Kalenderschnittstelle von BASIS 6 ermöglicht die direkte Integration mit einer lokal betriebenen Microsoft Exchange Server Umgebung über Exchange Web Services (EWS). Sie dient dazu, Termine aus BASIS 6 automatisch im Kalender eines Benutzers auf dem Exchange-Server zu erstellen, zu aktualisieren, zu löschen oder einzulesen. Die Schnittstelle arbeitet bidirektional und nutzt die standardisierte EWS-SOAP-Schnittstelle von Microsoft Exchange.
2. Zielsetzung
Ziel dieser Schnittstelle ist es, eine zentrale und konsistente Terminverwaltung zwischen BASIS 6 und Microsoft Exchange zu gewährleisten. Mitarbeiter können ihre Termine aus BASIS 6 automatisch im Outlook-Kalender sehen, dort bearbeiten oder neue Termine anlegen, die anschließend in BASIS 6 verfügbar sind.
3. Architektur und Kommunikationsweg
| Merkmal | Wert |
| Kommunikationsart | Webservice (SOAP über HTTPS) |
| Protokoll | HTTPS (TLS 1.2 oder höher) |
| Authentifizierung | NTLM Authentication |
| Datenformat | XML (gemäß EWS-Spezifikation) |
| Richtung | Bidirektional |
| Standard-Port | 443/TCP |
4. Unterstützte Exchange-Versionen
- Microsoft Exchange Server 2016
- Microsoft Exchange Server 2019
5. URL / Endpunkt
Die EWS-Endpunkte werden vom jeweiligen Exchange-Server bereitgestellt und haben in der Regel folgendes Format:
https://EWS/Exchange.asmx
Beispiel: https://mailserver.firma.local/EWS/Exchange.asmx
6. Authentifizierung
Die Schnittstelle verwendet NTLM Authentication mit Benutzername und Passwort eines Exchange-Impersonation-Benutzerkontos. Der Zugriff erfolgt dadurch über eine zentrale Anmeldung mit Stellvertreterrechten.
7. Unterstützte Funktionen
| Funktion | Beschreibung |
| Termin erstellen | BASIS 6 legt neue Termine im Kalender an. |
| Termin aktualisieren | Änderungen an Terminen in BASIS 6 werden auf dem Exchange Server synchronisiert. |
| Termin löschen | Gelöschte Termine in BASIS 6 werden im Kalender entfernt. |
| Termine lesen | Bestehende Termine aus dem Exchange-Kalender können in BASIS 6 eingelesen und angezeigt werden. |
| Teilnehmer verwalten | Teilnehmerlisten können übermittelt und Einladungen versendet werden. |
| Beschreibung und Erinnerungen setzen |
BASIS 6 kann Beschreibungstexte und Erinnerungszeitpunkte im Termin hinterlegen. |
8. Datenmodell – Terminobjekt
| Feld in BASIS 6 | Feld in EWS | Typ | Beschreibung |
| Betreff | Subject | String | Titel des Termins |
| Beschreibung | Body | String (HTML) | Detailbeschreibung |
| Beginn | Start | DateTime | Startzeitpunkt |
| Ende | End | DateTime | Endzeitpunkt |
| Teilnehmer | RequiredAttendees | E-Mail-Adressen | Liste der eingeladenen Personen |
| Kalender- Benutzer | Organizer | E-Mail-Adressen | Organisator des Termins |
| ID | ItemId | GUID | Eindeutige ID des Termisim Exchange-System |
| Privat | Sensitivity | Text | Privat Status |
| Erinnerung | Reminder | Object | Informationen zur Erinnerung |
| Seriendefinition | Object | Diverse Informationen zur Serie |
9. Fehlerbehandlung
Die Schnittstelle liefert Fehlercodes entsprechend der EWS-Spezifikation. BASIS 6 protokolliert alle aufgetretenen Fehler mit Zeitstempel und Fehlertext. Typische Fehlercodes:
| Fehlercode | Bedeutung |
| ErrorInvalidCredentials | Zugangsdaten ungültig |
| ErrorMailboxUnavailable | Postfach nicht erreichbar |
| ErrorAccessDenied | Zugriff verweigert |
| ErrorItemNotFound | Termin wurde nicht gefunden |
| ErrorInternalServerError | Interner Serverfehler auf Exchange-Seite |
10. Sicherheitsaspekte
- Kommunikation ausschließlich über verschlüsselte HTTPS-Verbindungen (TLS 1.2 oder höher).
- Benutzeranmeldeinformationen werden innerhalb von BASIS 6 verschlüsselt gespeichert.
- Optionale Einschränkung des Serverzugriffs über IP-Freigaben oder Firewalleinstellungen.
11. Voraussetzungen
- Installierter Microsoft Exchange Server mit aktivierter EWS-Funktionalität
- Netzwerkverbindung zwischen BASIS 6 und Exchange-Server (Port 443 offen)
- Impersonation-Konto mit entsprechenden Kalenderzugriffsrechten
- Eindeutige E-Mail-Adresse für die verwendeten Postfächer
12. Beispiel – SOAP-Anfrage zum Erstellen eines Termins
<CreateItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
SendMeetingInvitations="SendToAllAndSaveCopy">
<SavedItemFolderId>
<DistinguishedFolderId Id="calendar"/>
</SavedItemFolderId>
<Items>
<CalendarItem>
<Subject>Projektbesprechung</Subject>
<Body BodyType="HTML">Besprechung zum aktuellen Projektstatus.</Body>
<Start>2025-10-10T09:00:00</Start>
<End>2025-10-10T10:00:00</End>
<Location>Besprechungsraum 1</Location>
<RequiredAttendees>
<Attendee>
<Mailbox>
<EmailAddress>teilnehmer@firma.local</EmailAddress>
</Mailbox>
</Attendee>
</RequiredAttendees>
</CalendarItem>
</Items>
</CreateItem>13. Support und Kontakt
Bei technischen Fragen zur EWS-Schnittstelle wenden Sie sich bitte an:
Medisoft GmbH
E-Mail: ticket@medisoft.de
Telefon: +49 (0) 040 / 8888 00 77
