Seminar ADONIS Schnittstellen, REST API und Systemintegration

Eine Schnittstelle ist erst dann produktionsreif, wenn Datenhoheit, Berechtigungen, Fehlerfälle und Wiederanlauf geklärt sind. Das Seminar verbindet API-Nutzung mit Architektur, Sicherheit und Betrieb.

Inhaltsübersicht

• Zielsetzung
• Zielgruppe
• Seminarinhalte
• Integrationsarchitektur und Anwendungsfälle planen
• Authentisierung und Berechtigungen absichern
• Repository-Daten lesen und schreiben
• Datenmapping und Synchronisation gestalten
• Schnittstellenbetrieb und Fehlerbehandlung organisieren
• Praxisübungen
• Voraussetzungen

Zielsetzung

Nach Abschluss können Integrationsfälle strukturiert geplant, abgesicherte API-Zugriffe erprobt und Synchronisations- sowie Fehlerkonzepte dokumentiert werden.

Zielgruppe

Softwareentwicklung, Integrationsarchitektur, ADONIS-Administration, technische Projektleitung, Daten- und Plattformteams.

Seminarinhalte

Die Inhalte werden in einer festen Arbeitsfolge aus Einordnung, Konfiguration oder Modellierung, Prüfung und dokumentierter Anwendung bearbeitet.

Kapitel 1: Integrationsarchitektur und Anwendungsfälle planen

1. Schritt 1: Lesen, Schreiben, Suchen, Synchronisieren, Reporting und Benutzerbereitstellung als getrennte Integrationsfälle erfassen.
2. Schritt 2: Quell- und Zielsystem, Datenhoheit, Auslöser, Frequenz, Volumen, Fehlerweg und Schutzbedarf dokumentieren.
3. Schritt 3: Geeignete Standardfunktion, Dateiübertragung, Connector oder Programmierschnittstelle auswählen.

Kapitel 2: Authentisierung und Berechtigungen absichern

1. Schritt 1: Technisches Konto, Tokenverfahren, Transportverschlüsselung und Secret-Verwaltung nach Sicherheitsvorgaben festlegen.
2. Schritt 2: API-Zugriff auf notwendige Repositories, Modelltypen, Objekttypen und Aktionen begrenzen.
3. Schritt 3: Erfolgs-, Fehler- und Missbrauchsszenarien mit getrennten Testkonten prüfen und protokollieren.

Kapitel 3: Repository-Daten lesen und schreiben

1. Schritt 1: Metamodell, Repositories, Modelle, Objekte, Eigenschaften und Suchfunktionen schrittweise erkunden.
2. Schritt 2: Lesezugriff mit Filterung und Paging umsetzen und Ergebnisse gegen die Benutzeroberfläche plausibilisieren.
3. Schritt 3: Schreibzugriff mit Validierung, eindeutigen IDs und kontrollierter Fehlerbehandlung zunächst in einer Testumgebung erproben.

Kapitel 4: Datenmapping und Synchronisation gestalten

1. Schritt 1: Quellfelder, Zielklassen, Attribute, Relationen, Wertelisten und Identifikatoren eindeutig zuordnen.
2. Schritt 2: Erstellung, Aktualisierung, Löschung, Konflikte und Datenhoheit je Objektart festlegen.
3. Schritt 3: Delta-Logik, Wiederanlauf und Abgleichbericht für eine nachvollziehbare Synchronisation definieren.

Kapitel 5: Schnittstellenbetrieb und Fehlerbehandlung organisieren

1. Schritt 1: Zeitüberschreitungen, Rate Limits, ungültige Daten, Berechtigungsfehler und Teilabbrüche kontrolliert behandeln.
2. Schritt 2: Technische und fachliche Protokolle, Alarmierung, Korrelation und Supportübergabe strukturieren.
3. Schritt 3: Wiederholung, Quarantäne, manuelle Korrektur und revisionsfähigen Nachweis in ein Betriebskonzept aufnehmen.

Praxisübungen

• Auslesen von Repository-Metadaten und gefilterten Prozessinformationen.
• Entwurf eines sicheren technischen Kontos mit minimalen Rechten.
• Aufbau eines Mappings einschließlich Konflikt- und Wiederanlauflogik.

Voraussetzungen

Kenntnisse in HTTP, JSON, Authentisierung und Skript- oder Programmiersprache. Zugriff auf eine ADONIS-Testumgebung mit freigeschalteter Schnittstelle.