# Übergabevorlage für Integrationen

Eine Seite pro produktiver Integration. Füllen Sie Systeme, Datensätze, Zeitplan, Zugangsdaten, Fehlerfälle, Eskalationskontakte und das Datum, an dem sie zuletzt jemand überprüft hat, anhand dessen aus, was heute läuft, nicht anhand der ursprünglichen Spezifikation aus dem Projekt. Die Zahl der ausgefüllten Felder an der Seite aktualisiert sich beim Eintragen.

## So verwenden Sie diese Vorlage

Füllen Sie sie einmal pro Integration aus: Laden Sie Ihre Antworten herunter und wählen Sie dann „Von vorn beginnen“ für die nächste. Jedes Feld soll das beobachtete Verhalten im Betrieb beschreiben. Wo die Antwort also „wir glauben“ lautet statt „wir haben geprüft“, schreiben Sie genau das hin und planen Sie eine Prüfung ein. Die Beispielzeilen zeigen den Detailgrad, der hilfreich ist. Ersetzen Sie sie durch Ihre eigenen.

## Systeme und Richtung

Füllen Sie die Spalte Eintrag aus; die Spalte Hinweis sagt, was in das jeweilige Feld gehört.

| Feld | Hinweis | Eintrag |
|---|---|---|
| Name der Integration | Beispiel: CRM an kaufmännisches System, Abgleich von Kunden und Aufträgen |  |
| Quellsystem |  |  |
| Zielsystem |  |  |
| Richtung | In eine Richtung, in beide Richtungen, oder in eine Richtung mit Ausnahmen (Ausnahmen auflisten) |  |
| Konfliktregel bei Abgleich in beide Richtungen | Beispiel: Zielsystem gewinnt bei Adressfeldern, Quellsystem gewinnt bei Einwilligungen |  |
| Hosting-Umgebung | Wo der Code läuft, wem diese Umgebung gehört, und ein etwaiges bekanntes Abschaltdatum |  |
| Ablageort des Codes | Repository oder Serverpfad, und wer Zugriff hat |  |
| Fachlicher Verantwortlicher | Die Person, die es merkt, wenn es stoppt |  |
| Technischer Verantwortlicher | Die Person, die es ändern kann |  |

## Datensätze und Felder

Ersetzen Sie die Beispielzeilen durch Ihre eigenen.

| Datensatz | Übertragene Felder | Zugeordnet oder umgewandelt | Richtung | Anmerkungen |
|---|---|---|---|---|
| Beispiel: Kontakt | E-Mail, Vorname, Nachname, Unternehmen, Einwilligungsstatus | Einwilligungsstatus von Text in ein Kennzeichen umgewandelt | CRM an kaufmännisches System | Kontakte ohne Unternehmen werden übersprungen |
| Beispiel: Auftrag | Auftragsnummer, Kundenreferenz, Positionen, Status | Statuswerte zwischen den beiden Systemen übersetzt | Kaufmännisches System an CRM | Stornierte Aufträge werden nicht zurückgesendet |
|  |  |  |  |  |
|  |  |  |  |  |
|  |  |  |  |  |

## Zeitplan

Eine Zeile pro Auslöser; ersetzen Sie die Beispielzeilen durch Ihre eigenen.

| Auslöser | Häufigkeit | Zeitfenster | Typisches Volumen | Überwacht durch |
|---|---|---|---|---|
| Beispiel: Zeitgesteuerter Batchlauf | Nächtlich | 02:00 bis 03:00 Uhr Ortszeit | Einige hundert Datensätze | Job-Log, jeden Morgen vom technischen Verantwortlichen geprüft |
| Beispiel: Ereignis | Beim Anlegen eines Datensatzes | Sofort | Einige Dutzend pro Tag | Alarm bei wiederholten Fehlern |
|  |  |  |  |  |
|  |  |  |  |  |

## Zugangsdaten

Eine Zeile pro Zugang, den die Integration verwendet; der graue Text zeigt, was in die jeweilige Spalte gehört.

| Zugangsdaten | Ablageort | Verantwortlicher | Läuft ab am | Wie sie rotiert werden |
|---|---|---|---|---|
|  |  |  |  |  |
|  |  |  |  |  |
|  |  |  |  |  |

## Fehlerfälle und Symptome

Beschreiben Sie jeden Fehlerfall so, wie er von außen aussieht, nicht so, wie der Code ihn sieht, und ersetzen Sie die Beispielzeilen durch Ihre eigenen.

| Fehlerfall | Wie es von außen aussieht | Wie es erkannt wird | Erste Reaktion | Rückfallebene |
|---|---|---|---|---|
| Beispiel: Zielsystem nicht erreichbar | Datensätze verzögern sich und kommen dann gesammelt an | Alarm nach drei fehlgeschlagenen Versuchen | Statusseite des Zielsystems prüfen, bevor jemand die Integration anfasst | Datensätze werden zwischengespeichert und automatisch erneut verarbeitet |
| Beispiel: Datensatz besteht die Validierung nicht | Ein einzelner Datensatz fehlt im Zielsystem, und niemand erfährt davon | Wöchentlicher Mengenabgleich zwischen den Systemen | Datensatz an der Quelle korrigieren und erneut ausführen | Keine, manuelle Erfassung |
| Beispiel: Zugangsdaten abgelaufen | Ab einem bestimmten Datum schlägt jeder Datensatz fehl | Alarm beim ersten Fehler | Zugangsdaten gemäß der Tabelle oben rotieren | Keine |
| Beispiel: Hosting abgeschaltet | Nichts kommt an, nirgends eine Fehlermeldung | Fachlicher Verantwortlicher bemerkt fehlende Leads | Beim Verantwortlichen für das Hosting bestätigen lassen, dann aus dem Ablageort des Codes wiederherstellen | Alte Umgebung, falls noch erreichbar |
|  |  |  |  |  |
|  |  |  |  |  |

## Eskalation

Die drei Stufen sind als Ausgangspunkt vorausgefüllt; passen Sie sie an Ihre Vereinbarung an.

| Stufe | Kontakt | Erreichbar über | Erwartete Reaktion |
|---|---|---|---|
| Erste | Technischer Verantwortlicher | Chat oder Telefon, keine Ticket-Warteschlange | Am selben Arbeitstag |
| Zweite | Dienstleister oder internes Plattformteam, namentlich benannte Person | Benannter Kontakt, Referenz auf das Stundenkontingent, falls vorhanden | Wie in der Supportvereinbarung festgelegt |
| Dritte | Fachlicher Verantwortlicher jedes angebundenen Systems |  | Entscheidung über einen manuellen Ersatzprozess |
|  |  |  |  |

Das ist das Feld, das das Verhalten verändert. Eine Seite ohne Prüfdatum im letzten Quartal beschreibt eine Integration in unbekanntem Zustand, und unbekannt ist genau der Zustand, der den Notfall ausgelöst hat.

## Zuletzt überprüft

| Zuletzt überprüft am | Überprüft von | Was geprüft wurde | Nächste Prüfung fällig |
|---|---|---|---|
|  |  | Datensätze wie aufgelistet übertragen, Zeitplan im Zeitfenster gelaufen, ein ausgelöster Fehler hat den Alarm erzeugt |  |

Tragen Sie den nächsten Prüftermin in einen Kalender ein, der zu einer Rolle gehört, nicht zu einer Person, und legen Sie die ausgefüllte Seite dort ab, wo die Personen, die die Alarme erhalten, sie finden.