Seminar Cofinity-X – EDC Connector: Integration, APIs und Automatisierung

Manuelle API-Aufrufe reichen für einen Proof of Concept, nicht für einen stabilen Geschäftsdienst. Produktivbetrieb benötigt wiederholbare Provisionierung, robuste Statussteuerung, sichere Secrets, Tests und Observability.

Das Seminar entwickelt einen Integrationsdienst, der Datenangebote automatisiert verwaltet und Datentransfers belastbar orchestriert.

Inhaltsübersicht

• Zielsetzung
• Zielgruppe
• Voraussetzungen
• Schritt 1: Integrationsarchitektur und Verantwortungsgrenzen entwerfen
• Schritt 2: API-Client sicher aufbauen
• Schritt 3: Backends und Datenadressen integrieren
• Schritt 4: Assets automatisiert provisionieren
• Schritt 5: Policy-Vorlagen verwalten
• Schritt 6: Vertragsdefinitionen konsistent erzeugen
• Schritt 7: Kataloge abfragen und normalisieren
• Schritt 8: Vertragsverhandlungen orchestrieren
• Schritt 9: Transfers robust steuern
• Schritt 10: Asynchrone Zustände und Fehler behandeln
• Schritt 11: Tests automatisieren
• Schritt 12: CI/CD und Konfiguration organisieren
• Schritt 13: Observability und Audit ergänzen
• Schritt 14: Integrationsdienst produktionsnah abschließen
• Praxisübungen
• Arbeitsweise

Zielsetzung

Ziel ist eine wartbare Integrationslösung mit sauberer API-Schicht, automatisierter Konfiguration, robuster Fehlerbehandlung, reproduzierbarer Bereitstellung und vollständiger technischer Beobachtbarkeit.

Zielgruppe

Erfahrene Entwickler, Integrationsarchitekten, DevOps- und Plattformteams sowie technische Projektleitung.

Voraussetzungen

Sichere Kenntnisse in HTTP, JSON und Softwareentwicklung. Praktische EDC-Grundlagen oder Teilnahme am EDC-Grundlagenseminar.

Seminarinhalte

Schritt 1: Integrationsarchitektur und Verantwortungsgrenzen entwerfen

Connector, Integrationsdienst, Fachbackend, Speicher, Identity-Komponenten und Monitoring werden in einem Systembild verbunden. Synchroner und asynchroner Ablauf werden bewusst getrennt.

Schritt 2: API-Client sicher aufbauen

Basis-URL, Authentisierung, Timeouts, Korrelation, Serialisierung und Fehlerobjekte werden zentral gekapselt. Secrets gelangen weder in Quellcode noch in Logs.

Schritt 3: Backends und Datenadressen integrieren

HTTP-, API- oder Objekt-Speicher werden über geeignete Datenadressen angebunden. Zugriffstoken, Pfade, Mandantenbezug und Datenminimierung werden geprüft.

Schritt 4: Assets automatisiert provisionieren

Fachliche Konfiguration wird in wiederholbare API-Aufrufe übersetzt. Create, Read, Update, Delete, Versionsabgleich und Idempotenz werden implementiert.

Schritt 5: Policy-Vorlagen verwalten

Wiederverwendbare Richtlinien werden parametrisiert, versioniert und getestet. Fachliche Freigaben bleiben von technischer Auslieferung getrennt.

Schritt 6: Vertragsdefinitionen konsistent erzeugen

Asset-Selektoren und Policies werden automatisiert verbunden. Abhängigkeiten und Fehler werden vor Veröffentlichung validiert.

Schritt 7: Kataloge abfragen und normalisieren

Angebote verschiedener Partner werden abgefragt, gefiltert und in ein internes Modell überführt. Paging, wechselnde Metadaten und nicht erfüllbare Policies werden berücksichtigt.

Schritt 8: Vertragsverhandlungen orchestrieren

Der Integrationsdienst startet Verhandlungen, verfolgt Status und korreliert Verträge mit Geschäftsobjekten. Wiederholte Anfragen erzeugen keine unkontrollierten Duplikate.

Schritt 9: Transfers robust steuern

Transferparameter, Ziele und Callback- oder Polling-Mechanismen werden umgesetzt. Unterbrechungen, Zeitüberschreitungen und teilweise Erfolge erhalten definierte Wiederanlaufregeln.

Schritt 10: Asynchrone Zustände und Fehler behandeln

Statusmaschinen, Retry mit Begrenzung, Dead-Letter-Verfahren und manuelle Eskalation werden kombiniert. Technische Fehler werden in fachlich verständliche Zustände übersetzt.

Schritt 11: Tests automatisieren

Unit-, Vertrags-, Integrations- und Ende-zu-Ende-Tests decken Provider- und Consumer-Pfade ab. Testdaten und simulierte Gegenstellen machen Fehler reproduzierbar.

Schritt 12: CI/CD und Konfiguration organisieren

Umgebungswerte, Secrets, Policy-Versionen und Deployment-Artefakte werden getrennt verwaltet. Freigabe, Rollback und Migration werden als Pipeline-Schritte definiert.

Schritt 13: Observability und Audit ergänzen

Metriken, strukturierte Logs und Traces erhalten gemeinsame Korrelation. Geschäftsvorgang, Vertrag und Transfer bleiben über Systemgrenzen hinweg nachvollziehbar.

Schritt 14: Integrationsdienst produktionsnah abschließen

Last, Parallelität, Ressourcen, Fehlergrenzen und Betriebshandbuch werden geprüft. Ein Abnahmeszenario zeigt Provisionierung, Verhandlung, Transfer und Wiederanlauf in einem durchgängigen Ablauf.

Praxisübungen

• Implementieren eines gekapselten EDC-API-Clients
• Automatisiertes Provisionieren von Asset, Policy und Vertragsdefinition
• Orchestrieren einer Vertragsverhandlung und eines Transfers mit Statusmaschine
• Einrichten von Tests, Retry, Korrelation, Metriken und strukturierten Logs

Arbeitsweise

Fachvortrag, Live-Coding, API-Demonstrationen, praktische Entwicklungsübungen und Architektur-Reviews. Die Übungen werden mit Checklisten, Testfällen und nachvollziehbaren Zwischenergebnissen dokumentiert.