Seminar Kendox InfoShare Integration mit REST API und Fachanwendungen

Die REST-Schnittstelle ermöglicht die Einbindung von InfoShare in ERP-, CRM-, Fach- und Portalanwendungen. Dieses Seminar vermittelt die technische Nutzung der API von der Authentifizierung bis zu robusten Dokument- und Prozessintegrationen.

Die Teilnehmenden entwickeln schrittweise einen kleinen Integrationsdienst. Dabei werden nicht nur erfolgreiche Aufrufe, sondern auch Validierung, Fehlerbehandlung, Protokollierung, Wiederholbarkeit und Sicherheitsgrenzen berücksichtigt.

Seminarprofil

Drei Tage sind notwendig, weil API-Grundlagen, Dokumentoperationen, Prozessfunktionen und die Umsetzung eines belastbaren Integrationsmusters jeweils eigene Übungsblöcke benötigen. In zwei Tagen bliebe die produktionsnahe Absicherung zu oberflächlich.

Themenschwerpunkte

• Architektur und Ressourcenmodell der InfoShare REST API
• Authentifizierung, Autorisierung, Mandanten- und Benutzerkontext sowie sichere Geheimnisverwaltung
• HTTP-Methoden, JSON-Strukturen, Statuscodes und systematische Arbeit mit der Dokumentation
• Suchen, Lesen und Auswerten von Dokumenten, Eigenschaften und Akteninformationen
• Dokumente anlegen, Binärinhalte übertragen, Metadaten validieren und Versionen verwalten
• Prozesse beziehungsweise Vorgänge starten, bearbeiten und Statusinformationen auswerten
• Pagination, Filterung, große Ergebnismengen und kontrollierte Stapelverarbeitung
• Fehlerbehandlung, Wiederholungsstrategien, Idempotenz und Schutz vor Dubletten
• Protokollierung, technische Korrelation, Datenschutz und nachvollziehbare Servicekonten
• Integrationsarchitektur für ERP, CRM, Portale und individuelle Fachanwendungen
• Testautomatisierung, Mock-Daten, Abnahme und geregelte Bereitstellung
• Migrationsaspekte beim Wechsel älterer Schnittstellentechnologien auf REST und JSON

Praxisanteil

Mit einem API-Client und einer kleinen Beispielanwendung werden typische Integrationsfälle umgesetzt. Der dritte Tag dient der Zusammenführung zu einem robusten End-to-End-Szenario einschließlich Fehlerfällen und Betriebsinformationen.

• Authentifizierter API-Zugriff und strukturierte Suchabfrage
• Anlage eines Dokuments mit Binärinhalt und Metadaten
• Start und Statusabfrage eines dokumentbezogenen Prozesses
• Implementierung von Validierung, Wiederholung und technischer Protokollierung
• Entwurf einer Integrationsschnittstelle für eine konkrete Fachanwendung

Planungs- und Qualitätsaspekte

Bei der Umsetzung wird konsequent zwischen Standardfunktion, konfigurierbarer Anpassung und organisatorischer Vorentscheidung unterschieden. Die Teilnehmenden halten Annahmen, Verantwortlichkeiten, Testfälle und Freigabekriterien fest, statt Einstellungen lediglich nachzuklicken. Eigene Anforderungen können auf das Übungsmodell übertragen und hinsichtlich Aufwand, Risiken und Betriebsfolgen bewertet werden. Änderungen an einer produktiven Umgebung sind nicht Bestandteil der Übungen; vorbereitet werden jedoch Checklisten und Prüfwege, mit denen Konfigurationen kontrolliert von einer Test- in eine Integrations- oder Produktivumgebung überführt werden können. Besonderes Augenmerk liegt auf verständlichen Benennungen, minimalen Rechten, dokumentierten Abhängigkeiten und einer Abnahme mit repräsentativen Anwenderrollen.

Zielgruppe

Softwareentwickler, Integrationsarchitekten, technische Consultants, API-Verantwortliche und erfahrene Systemadministratoren.

Vorkenntnisse

Sichere Grundlagen in REST, HTTP und JSON sowie Programmiererfahrung in einer geeigneten Sprache. Grundkenntnisse in InfoShare und im jeweiligen Fachprozess werden vorausgesetzt.