Kernkonzepte
MyIntegrationHub organisiert Ihre Integrationslandschaft durch eine klare Hierarchie von Objekten. Das Verständnis dieser Kernkonzepte hilft Ihnen, Ihr Partner-Onboarding effizient zu strukturieren.
Workspace
Ein Workspace ist Ihre oberste Organisationseinheit. Er repräsentiert ein Projekt, eine Abteilung oder eine Kundenumgebung. Alle Partner, Integrationen und Spezifikationen befinden sich innerhalb eines Workspaces.
Partner
Ein Partner repräsentiert eine externe Einheit, mit der Sie Daten austauschen — ein Kunde, Lieferant, Logistikdienstleister oder ein anderer Dritter. Partner haben Kontaktdaten, Statusverfolgung und zugehörige Integrationen.
Integration
Eine Integration definiert, wie Daten zwischen Ihnen und einem Partner fließen — Richtung (eingehend/ausgehend), Protokolltyp (REST API, EDI, XML, etc.), Endpunkt-URL und aktueller Status.
Spezifikation
Eine Spezifikation beschreibt das Datenformat für eine Integration — Felddefinitionen, Typen, Verschachtelung, Validierungsregeln und Beispiel-Payloads. Spezifikationen haben Versionen und durchlaufen Freigabe-Workflows.
Freigabe
Freigaben verfolgen Abnahmeprozesse für Spezifikationsänderungen, Integrationsupdates oder Go-live-Entscheidungen. Weisen Sie Reviewer zu, setzen Sie Fristen und verfolgen Sie den Status durch Ausstehend → In Prüfung → Freigegeben.
Checkliste
Checklisten stellen sicher, dass beim Onboarding nichts vergessen wird. Erstellen Sie wiederverwendbare Vorlagen mit kategorisierten Elementen und verfolgen Sie die Fertigstellung pro Partner für einen strukturierten Go-live-Prozess.
Checklisten-Vorlage
Checklisten-Vorlagen sind wiederverwendbare Blaupausen für Onboarding-Prozesse. Definieren Sie einmalig kategorisierte Elemente mit Pflichtmarkierungen und wenden Sie die Vorlage einheitlich auf jeden neuen Partner an.
Testfall
Testfälle validieren Ihre Integrationen anhand ihrer Spezifikationen. Sie können aus Payload-Feldern, Validierungsregeln oder Beispiel-Payloads abgeleitet werden und decken Positiv-, Negativ-, Grenzwert- und Prozessszenarien ab.
Dokument
Speichern und teilen Sie Dateien zu Ihren Integrationen — technische Dokumentation, Mapping-Tabellen, Testberichte oder jede für Ihr Partner-Onboarding relevante Datei.
Kommentar
Fügen Sie kontextbezogene Kommentare zu Spezifikationen, Freigaben oder anderen Objekten hinzu. Kommentare erstellen einen Audit-Trail und erleichtern die Kommunikation zwischen Teammitgliedern und Partnern.
Wie Objekte zusammenhängen
Die Objekte in MyIntegrationHub bilden eine klare Hierarchie. Das Verständnis ihrer Beziehungen hilft Ihnen, Ihre Integrationslandschaft effizient zu organisieren.
Wichtige Beziehungen
In Aktion sehen
Erkunden Sie die Partneransicht unten. Klicken Sie auf einen Partner, um zu sehen, wie Integrationen, Spezifikationen und Freigaben im Partnerkontext organisiert sind.
Partner
3 Partner| Name | Typ | Status | Kontakt | Integrationen |
|---|---|---|---|---|
| Acme Corp | Customer | Active | John Miller | 3 |
| GlobalTrade Ltd | Supplier | Onboarding | Sarah Chen | 1 |
| TechFlow GmbH | Logistics | Active | Max Weber | 2 |
↑ Klicken Sie auf einen Partner für die Detailansicht
Typischer Workflow
Folgen Sie diesem schrittweisen Workflow, um einen neuen Partner einzubinden und Ihre Integration vollständig zu dokumentieren. Jeder Schritt baut auf dem vorherigen auf.
↑ Klicken Sie auf jeden Schritt, um den Workflow voranzubringen
Acme Corp — Go-Live-Checkliste
3/6↑ Klicken Sie auf Elemente, um den Status umzuschalten
Workflow-Details
Partner erstellen
Navigieren Sie zu Partner in der Seitenleiste und klicken Sie auf + Neuer Partner. Geben Sie den Partnernamen, den Typ (Kunde, Lieferant, Logistik, etc.), Kontaktinformationen und relevante Notizen ein.
Integration definieren
Gehen Sie zu Integrationen und erstellen Sie eine neue Integration. Geben Sie den Partnernamen, die Richtung (Eingehend oder Ausgehend), den Typ (REST API, EDI, XML, CSV, etc.), die Endpunkt-URL und einen Anfangsstatus an.
Spezifikation erstellen
Erstellen Sie unter Spezifikationen eine neue Spezifikation und verknüpfen Sie sie mit der Integration. Legen Sie den Formattyp, die initiale Versionsnummer fest und geben Sie eine Beschreibung des Datenvertrags an.
Spezifikation anreichern
Öffnen Sie die Spezifikationsdetailseite und arbeiten Sie die Tabs durch: Payload-Struktur zur Definition von Feldern und deren Typen, Validierungsregeln für Geschäftsregeln und Beispiel-Payload mit einem realitätsnahen Beispiel.
Freigabe & Version beantragen
Erstellen Sie eine Freigabe, um die Spezifikation zur Prüfung einzureichen. Nach der Freigabe nutzen Sie den Tab Versionshistorie, um einen Versions-Snapshot zu erstellen. Dies bewahrt den freigegebenen Zustand und ermöglicht die Nachverfolgung zukünftiger Änderungen.
Beispiele
Erkunden Sie diese praxisnahen Beispiele, um zu verstehen, wie verschiedene Integrationstypen in MyIntegrationHub dokumentiert werden.
REST-JSON-Bestell-Spezifikation
Dieses Beispiel zeigt eine vollständige JSON-basierte Bestellspezifikation mit Payload-Struktur, Validierungsregeln und einem Beispiel-Payload. Klicken Sie durch die Tabs, um jeden Bereich zu erkunden.
REST Order Payload
In Reviewv1.0JSON payload specification for outbound order data via REST API. Includes customer information, order items with SKU/quantity/price, and total calculation.
↑ Klicken Sie durch die Tabs, um die Spezifikationsansichten zu erkunden
EDI 850 Bestellung
EDI-Integrationen folgen derselben Struktur. Unten sehen Sie ein Beispiel, wie eine EDI-Spezifikation im System aussieht.
EDI 850 Purchase Order
Approvedv2.1Beispiel-EDI-Segmente
ISA*00* *00* *ZZ*ACME *ZZ*PARTNER *250320*1200*U*00401*000000001*0*P*>~
GS*PO*ACME*PARTNER*20250320*1200*1*X*004010~
ST*850*0001~
BEG*00*NE*ORD-2025-001**20250320~
N1*BY*Acme Corp*92*ACME001~
PO1*1*10*EA*29.99**VP*WIDGET-001~
CTT*1~
SE*7*0001~XML-Versandanzeige (ASN)
XML-basierte Spezifikationen unterstützen verschachtelte Strukturen. Das System erkennt das Format automatisch und validiert die Syntax.
ASN XML Schema
Draftv1.2<?xml version="1.0" encoding="UTF-8"?>
<ShippingNotice>
<Header>
<NoticeID>ASN-2025-042</NoticeID>
<ShipDate>2025-03-20</ShipDate>
<Carrier>DHL Express</Carrier>
</Header>
<Shipment>
<TrackingNumber>1Z999AA10123456784</TrackingNumber>
<Origin>
<City>Hamburg</City>
<Country>DE</Country>
</Origin>
<Destination>
<City>New York</City>
<Country>US</Country>
</Destination>
</Shipment>
<Items>
<Item sku="WIDGET-001" quantity="10" />
<Item sku="GADGET-002" quantity="5" />
</Items>
</ShippingNotice>Spezifikationsänderungs-Freigabe
Wenn Spezifikationsänderungen eine Abnahme benötigen, erstellen Sie eine Freigabe. So sieht der Freigabe-Workflow aus:
EDI 850 v2.1 Release
ApprovedChecklisten-Vorlage
Erstellen Sie wiederverwendbare Vorlagen mit kategorisierten Elementen und Pflichtmarkierungen. Wenden Sie sie auf jeden neuen Partner für einen einheitlichen Onboarding-Prozess an.
Checklisten-Vorlage — API-Integration-Setup
8 Items| # | Titel | Kategorie | Erforderlich |
|---|---|---|---|
| 1 | API credentials provisioned | Setup | ● |
| 2 | Endpoint URL configured | Setup | ● |
| 3 | Authentication method verified | Technical | ● |
| 4 | Payload structure defined | Technical | ● |
| 5 | Validation rules documented | Documentation | ○ |
| 6 | Sample payload tested | Testing | ● |
| 7 | Error handling verified | Testing | ○ |
| 8 | Go-live approval obtained | Approval | ● |
Testfälle aus der Spezifikation
Testfälle können aus Ihren Spezifikationsfeldern, Validierungsregeln und Beispiel-Payloads abgeleitet werden. Jeder Testfall überprüft einen bestimmten Aspekt der Integration.
Testfälle — REST Order Payload
6 Test Cases| Code | Titel | Testtyp | Quelle | Status |
|---|---|---|---|---|
| TC-001 | Valid order payload accepted | positive | sample_payload | ready |
| TC-002 | Missing required field order_id rejected | negative | payload_field | ready |
| TC-003 | Invalid email format rejected | negative | validation_rule | draft |
| TC-004 | Empty items array rejected | boundary | validation_rule | ready |
| TC-005 | Quantity zero rejected | boundary | validation_rule | draft |
| TC-006 | Total amount equals sum of items | process | validation_rule | reviewed |
↑ Click on a test case to see its details
FAQ & Best Practices
Häufige Fragen und Empfehlungen, um das Beste aus MyIntegrationHub herauszuholen.
Bereit loszulegen?
Erstellen Sie Ihr kostenloses Konto und beginnen Sie noch heute mit der Verwaltung Ihrer Integrationspartner.