Playbook für Integrationsprojekte
Diese Seite ist für Projektleiter bei Integrationsunternehmen und für die Projektmanager der Kunden. Sie überträgt das Playbook für Implementierungsprojekte des Partnerbereichs auf Projekte, deren Hauptgegenstand die Verbindung zwischen Systemen ist. Es ist ein Playbook, keine Methode, der Sie folgen müssen: Passen Sie es an Ihre Verträge an.
Inhalt
Die Phasen
| Phase | Ergebnisse | Seiten |
|---|---|---|
| 1. Analyse | Systeme, Datenflüsse, Richtungen, Mengen, Zeitpunkte, Verantwortliche, Randbedingungen; das Analyse-Arbeitsblatt ausgefüllt | Analyse-Arbeitsblatt, Was Integratoren tun |
| 2. Schnittstellenentwurf | Eine Schnittstellenspezifikation pro Fluss: Schnittstelle, Zugangsdaten, Abbildung, Schlüssel, Fehler, Überwachung | Vorlage für eine Schnittstellenspezifikation, Eine Integrationsschnittstelle wählen |
| 3. Schätzung und Vereinbarung | Schätzung mit Annahmen, Leistungsbeschreibung, Abnahmekriterien | Schätzen, Leistungsbeschreibungen |
| 4. Umgebungen und Zugänge | Entwicklungs- und Staging-Installationen aus Git; Testinstanzen der anderen Systeme; Dienstkonten; gespeicherte Zugangsdaten | Mit Git entwickeln, Dienstkonten |
| 5. Aufbau | Die Integrationserweiterung: Abbildung, Client, Import oder Sender, Hooks, Cronjob-Teile, Tests | Eine Integration als Erweiterung bauen, Einen Import schreiben |
| 6. Test | Unit- und Vertragstests in der CI, Probeläufe auf einer Kopie, der Idempotenztest, End-to-End in Staging, Sicherheitsprüfung | Testen, Sicherheits-Checkliste |
| 7. Livegang | Erstbefüllung, Zeitpläne an, Überwachung an, Rückfallplan bereit | Checkliste zum Livegang |
| 8. Hypercare | Zwei bis vier Wochen enger Beobachtung; Korrekturen; Feinabstimmung der Schwellenwerte | Überwachung |
| 9. Übergabe | Runbook, Inventar der Zugangsdaten, Dokumentation, Schulung der Betreiber | Übergabe einer Integration |
| 10. Betrieb | Upgrades, Schlüsselrotation, Abgleich, Änderungen der anderen Systeme | Upgrades |
Rollen auf beiden Seiten
| Rolle | Integrator | Kunde |
|---|---|---|
| Projektleitung | plant, berichtet, steuert den Umfang | entscheidet Prioritäten, unterzeichnet die Abnahme |
| Integrationsarchitekt | entwirft Flüsse und Schnittstellen | liefert die Systemlandschaft und Randbedingungen |
| Integrationsentwickler | baut und testet die Erweiterung | |
| Verantwortlicher für jedes andere System | stellt Testinstanzen, Zugangsdaten, API-Dokumentation und einen Ansprechpartner, der innerhalb eines Tages antwortet | |
| Datenverantwortlicher | entscheidet über Stammdaten, Abbildung und Regeln für Löschungen | |
| Betrieb | bereitet Runbook und Überwachung vor | betreibt nach der Übergabe (oder vergibt es) |
| Sicherheit und Datenschutz | folgt der Sicherheits-Checkliste | genehmigt Datenflüsse und Auftragsverarbeiter |
Die häufigste Ursache für Verzögerungen ist nicht der Code: Es ist das Warten auf den Zugang zur Testinstanz des anderen Systems, auf seine Zugangsdaten oder auf eine Antwort zu seinen Daten. Tragen Sie diese Termine als Lieferungen des Kunden in den Plan ein.
Zu steuernde Risiken
| Risiko | Gegenmaßnahme |
|---|---|
| Die API des anderen Systems ist nicht dokumentiert oder ändert sich | Vertragstests mit aufgezeichneten Antworten; ein benannter Ansprechpartner; eine Klausel zur Ankündigung von Änderungen in der Vereinbarung |
| Die Datenqualität an der Quelle ist schlechter als angenommen | Probelauf mit echten Daten in der Analyse; ein Budgetposten für Bereinigungsregeln; ein Bericht über abgewiesene Datensätze |
| Die Mengen sind größer als angenommen | in der Analyse messen; Batch und Delta von Anfang an einplanen |
| Keine Testinstanz des anderen Systems | ein Testdouble für die Entwicklung; ein kurzes, beaufsichtigtes Zeitfenster in der Produktion mit Nur-Lese-Zugangsdaten |
| Redakteure ändern importierte Felder | Zuständigkeit für jedes Feld in der Abbildung; Rollen, die es verhindern; Schulung |
| Abhängigkeit von Schlüsselpersonen | alles im Repository und in der Dokumentation der Erweiterung; Pairing |
| Stiller Ausfall nach dem Livegang | Überwachung mit Alarmen vor dem Livegang, nicht nach dem ersten Vorfall |
Faustregeln
- Bauen Sie zuerst den schmalsten durchgehenden Fluss (ein Datensatz, ein Feld, den ganzen Weg), dann verbreitern Sie ihn.
- Vereinbaren Sie die Regel für Löschungen vor dem ersten Import; sie ist die am häufigsten vergessene Entscheidung.
- Gehen Sie nie an einem Freitag oder vor einem Feiertag live.
- Planen Sie Hypercare im Budget ein; dann werden die Schwellenwerte abgestimmt.
- Beziehen Sie das eigene Team des Kunden ein; es wird die Integration betreiben.
Verwandte Seiten
- Playbook für Implementierungsprojekte
- Ein Exponential-Projekt planen
- Projektvorlagen
- Risikomanagement
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.