Integration in Systemumgebung

ADITO bietet eine hohe Integrations-Fähigkeit durch die Unterstützung verbreiteter Standards für Schnittstellen. Dadurch kann sich ADITO nahtlos in die bestehende IT-Landschaft integrieren.

Sie können mit ADITO über mehrere flexible Schnittstellen Daten austauschen. Je nach Anforderung können diese Schnittstellen flexibel platziert werden, entweder auf dem Applikationsserver oder in der ADITO SQL-Datenbank.

Export und Import von Daten

Mit Hilfe der ADITO eigenen Programmiersprache JDito, die auf JavaScript basiert, lassen sich Prozesse und auch der Export oder Import von Daten erstellen. In den meisten Fällen reicht die Nutzung von JDito und des Dateiimports bzw. –exports bereits aus, um die benötigten Daten zur Verfügung zu stellen oder einzulesen.

So ist beispielsweise die Erstellung von DTAUS-Daten für den beleglosen Datenträgeraustausch möglich oder CSV-Daten aus einem Altsystem können per JDito-Code in das System eingetragen werden.

Webservice-Schnittstelle

Die ADITO Webservice-Schnittstellen ermöglichen die Kommunikation von über das Internet bereitgestellten Services mit dem ADITO Server. ADITO unterstützt

• SOAP Webservices und

• RESTful Webservices (REST-Calls).

Details zur Webservice-Schnittstelle finden Sie im AID059 - Webservices

Plug-In-Schnittstelle

Für besondere Anforderungen stellt ADITO eine offene Plug-In-Schnittstelle für individuelle Java-Klassen zur Verfügung. Dadurch können auch komplexe Anforderungen erfüllt werden. Die Programmierung dieser Java-Plug-Ins erfolgt entweder durch den Kunden selbst oder durch ADITO.

Details zur Plug-In-Schnittstelle finden Sie im AID004 – Plugins

Anbindung von externen Datenbanken

Stammen die Daten aus einer vorhandenen externen Datenbank, so können die Daten entweder über SQL-Views oder den direkten Zugriff auf Tabellen (sofern die benutzte Datenbank Serververknüpfungen unterstützt) ausgetauscht werden.

Für die nachfolgenden Datenbanken steht eine integrierte DBMS-Schnittstelle zur Verfügung, um direkt mittels SQL-Befehle darauf zuzugreifen.

DBMS	Versionen	integrierter JDBC-Treiber
MariaDB	10.5, 10.6, 10.11	3.1.4
Microsoft SQL-Server	2016, 2017, 2019, 2022	12.2.0.jre11
MySQL	8.0	siehe Treiber MariaDB
Oracle Database	19c, 21c, 23c	23.2.0.0
PostgreSQL	12, 13, 14, 15, 16	42.6.0

In vielen Fällen reicht für die einmalige Übernahme von Bestandsdaten die Nutzung von ETL-Werkzeugen (extract, transform and load) der Datenbank aus (beispielsweise DTS bei Microsoft SQL oder SqlLdr bei Oracle).

Single-Sign-On mit Kerberos

ADITO unterstützt Single-Sign-On, d. h. der Benutzer kann sich mit den Anmeldedaten für das Betriebssystem auch in ADITO anmelden. Voraussetzung für diese Funktion ist eine serverseitige Kerberos-Infrastruktur.

Ein zusätzlich automatisierter Login ist technisch mittels einer Zwei-Faktor-Authentifizierung geplant. Bis dahin kann der Benutzername und das Passwort der User hilfsweise mittels der dbzgl. Browserfunktionalitäten beim ersten Login gespeichert werden.

Details zur Einrichtung von Kerberos und anderen Authentifizierungsmethoden finden Sie im AID032 – Authentication Methods

Anbindung externer Authentifizierungsserver

Für die Authentifizierung der ADITO Clients gegenüber dem ADITO Server kann ein externen Authentifizierungsserver eingebunden werden. Hierbei werden grundsätzlich die Anmeldedienste Google, Azure, Facebook, GitHub, Keycloak, GitLab, LinkedIn, Microsoft Azure AD, OpenID, Connect, login.gov, Nextcloud, DigitalOcean, Bitbucket, Gitea auf der Basis von OAuth 2.0 unterstützt.

Zwischen dem ADITO Client und dem ADITO Server wird ein Authentifizierungs-Proxy eingebunden. Dieser nimmt die Anfragen der ADITO Clients entgegen und leitet an den Anmeldedienst zur Authentifizierung weiter. Nach erfolgreicher Authentifizierung seitens des Anwenders am Anmeldedienst leitet der Authentifizierungs-Proxy die Anfrage an den ADITO Server weiter, indem er die Benutzer-ID des Anwenders übergibt.

LDAP-Schnittstelle

Alle Attribute eines Elementes, die im LDAP-Verzeichnisdienst hinterlegt sind können über eine LDAP-Schnittstelle angesprochen werden. Dies geschieht über ein vorbereitetes ADITO Plugin, das mit dem Server verbunden wird.

Eine XML-Struktur definiert, welche Aktion auf welcher Instanz des Verzeichnisdienstes ausgeführt wird. Hier werden auch die Zugangsdaten und der Verschlüsselungstyp gesetzt.

Die LDAP-Schnittstelle hat folgenden Funktionsumfang:

• add: Attribute zu einem bestehenden LDAP-Eintrag hinzufügen

• create: Attribute oder einen Knoten LDAP-Eintrag erzeugen

• read: Attribute aus einem bestehenden LDAP-Eintrag auslesen

• remove: Attribute oder Knoten aus einem LDAP-Eintrag entfernen

• replace: Einen bestehenden LDAP-Eintrag ersetzen

• search: Attribute oder einen bestehenden LDAP-Eintrag suchen.

Die Schnittstelle ist generisch angelegt, d. h. sie kann an die Bedürfnisse des jeweiligen ADITO Systems angepasst werden.

Details zur LDAP-Schnittstelle finden Sie im AID097 – LDAP

E-Mail-Anbindung

Für die Integration von ein- und ausgehenden E-Mails in ADITO steht eine Schnittstelle zur Verfügung, die flexibel genug ist, um auch umfangreiche Verarbeitungen von Nachrichten abzudecken. Der Versand und der Empfang von Nachrichten können über separate Konten erfolgen.

Versenden von E-Mails

Für das Versenden von Nachrichten wird das SMTP-Protokoll (alternativ SSL-verschlüsselt über TLS/SMTP) genutzt. Sie benötigen für die Konfiguration den Hostnamen bzw. die IP-Adresse des SMTP-Servers und den zu verwendenden Port.

Empfangen von E-Mails / ADITO Mailbridge

Für den Empfang von Nachrichten steht das Protokoll IMAP4 zur Verfügung. Der Zugriff kann auch SSL-verschlüsselt erfolgen. Die Nachrichten werden aus einem Postfach oder dem definierten IMAP-Ordner gelesen und in eine interne Mailablage überführt. Anschließend werden die Senderadresse und die vorhandenen Empfängeradressen mit einer benutzerdefinierten Spalte einer Tabelle verglichen, um Nachrichten automatisiert Benutzern oder Ansprechpartnern zuordnen zu können. Ebenso kann auch auf Nachrichten reagiert werden, für die keine Zuordnung gefunden wurde. Für diese Mailverknüpfungen stehen Ihnen alle Möglichkeiten der JDito-Programmierung zur Verfügung.

Die E-Mail-Funktionalität innerhalb von ADITO ist unabhängig vom verwendeten Mailserver und nur abhängig von der Verwendung von Standard-Protokollen wie IMAP und SMTP.

Details zur LDAP-Schnittstelle finden Sie im AID019 – Mailbridge

Briefe und Serienbriefe erzeugen

Für das Schreiben von Briefen aus ADITO werden Dokumentvorlagen verwendet, die variable Textbausteine beinhalten. Die Verwaltung der Dokumentvorlagen erfolgt mittels eines eigenen Moduls im ADITO Client.

Das Erstellen von Einzel- oder Serienbriefen wird von den Usern direkt aus dem ADITO Client veranlasst. Die Textbausteine werden dann zur Laufzeit mit den benötigten Daten aus dem System befüllt und das fertige Dokument erzeugt. Die erstellten Briefe werden gleichzeitig als Aktivität bei den jeweiligen Objekten hinterlegt.

Die Dokumentvorlagen werden mittels eines Textverarbeitungsprogramms erstellt:

• Für Einzelbriefe wird aktuell nur das Format ODT unterstützt, eine zukünftige Unterstützung des DOCX-Formats ist geplant.

• Für Serienbriefe wird aktuell nur das Format ODT unterstützt, eine zukünftige Unterstützung des DOCX-Formats ist geplant.

Folgende Versionen sind kompatibel:

• Microsoft Office 2016, 2019, 2021 (für Windows)

• Microsoft Office 2021 (für macOS)

• Microsoft 365 Desktopversionen (neuste Version)

• Apache OpenOffice 3.4, 4.0, 4.1

• LibreOffice 24.2, 24.8

Kalender- und Groupware-Unterstützung (Microsoft Exchange)

Mit dem ADITO Kalendermodul steht bereits ein komplettes Groupware-Modul zur Verfügung. Dabei werden Kalenderobjekte (Aufgaben und Termine und einige weitere Groupware-Funktionen) direkt in der ADITO SQL-Datenbank gespeichert.

Schnittstelle Microsoft Exchange Server / Microsoft Exchange Online

Für die Integration von Microsoft Exchange steht eine Schnittstelle zur Verfügung, um Exchange als Backend für Termine zu nutzen. Dabei werden Kalenderobjekte (Termine) direkt auf dem Exchange-Server gespeichert. Diese Termine stehen damit überall dort zur Verfügung, wenn Zugriff auf Exchange besteht.

Der ADITO Server kommuniziert über die Exchange Webservices mit Microsoft Exchange und zeigt von dort gelieferte Termine an. Voraussetzung hierfür ist eine Installation von Exchange mit eingerichteter Web-Services-Schnittstelle und Standard-Authentifizierung.

Aktuell wird von ADITO der Microsoft Exchange Server in den Versionen 2016 und 2019 sowie Exchange Online unterstützt.

Details zur Anbindung von CTI finden Sie im AID081 – ADITO und Exchange Web Services

Telefonie Integration (serverseitiges CTI)

ADITO unterstützt In- und Outbound-Telefonie, explizit werden Provider für Tapi, Asterisk, Mitel und Cisco unterstützt (weitere Anbindungen sind per CTI-Plugin möglich). Für die Erkennung eingehender Telefonnummern und das automatische Aktivieren von Bildschirmmasken muss der Anrufer seine Nummer übertragen (CLIP).

Als Vorraussetzung muss ADITO für die Telefonanlage konfiguriert werden (das ggf. Anpassungen mittles JDito erforderlich macht, bspw. für die Berücksichtigung von Ländercodes oder Durchwahlnummern). Zu den einzelnen Usern muss das verwendete Protokoll und die persönliche Telefonnummer hinterlegt sein.

Ausgehende Anrufe erfolgen über einen Klick auf den Telefon-Link (Telefonanlage ruft dann den User an, der den Anruf nochmals bestätigen oder ablehnen muss). Wenn keine Konfiguration hinterlegt ist, wird ein Telefon-Link (tel:) auf der Maske ausgewiesen, der die verbundene Standardsoftware des Betriebssystems aufruft.

Über eingehende Anrufe erhält der User eine Benachrichtigung: Wenn der Anrufer über seine Telefonnummer erkannt wurde wird der Kontakt explizit ausgewiesen (Klick öffnet den Main-View des Kontakts), ansonsten wird die Telefonnummer des Anrufers ausgewiesen (Klick öffnet das Benachrichtigungscenter).

Details zur Anbindung von CTI finden Sie im AID018 – CTI

Anbindung an SAP

Die Anbindung an ein SAP-System kann über mehrere Wege erfolgen:

• Über das ADITO SAP Plug-In können BAPIs direkt mit Hilfe des SAP Java Connector von ADITO aus angesprochen werden, beispielsweise um Kundendaten, Lieferantendaten oder Produktdaten zu übertragen. Dazu ist kein SAP-Client notwendig. Die Voraussetzung ist, dass die BAPIs von außen angesprochen werden können.

• SAP-Systeme können auch mittels Lesezugriff auf die SAP-Datenbanken angesprochen werden. Über diesen Weg können Daten live angezeigt und mit Daten in ADITO abgeglichen werden.

• Sollen Informationen in einem gewissen Abstand abgeglichen werden, ist auch ein regelmäßiger Dateiaustausch über Dateitransfer möglich. So können aus SAP heraus CSV- oder XML-Daten exportiert werden, die ADITO über angepasste Prozesse einlesen und verarbeiten kann.

Details zur SAP-Anbindung finden Sie im AID080-DE - SAP-Schnittstelle