Schnittstellenanalyse

Zweck

Die Technik dient drei Entscheidungen, und sie kommen in dieser Reihenfolge. Sie sichert zuerst die funktionale Abdeckung: das BABOK macht daraus ihre erste Stärke, eine früh geführte Schnittstellenanalyse erhöht die Anforderungsabdeckung, denn jeder vergessene Austausch ist eine Funktion, die im Umfang und in der Schätzung fehlt. Sie ermöglicht dann die Zuordnung: sobald die Grenze spezifiziert ist, weiss man, welche Seite welche Regel trägt. Eine AHV-Nummer zu validieren ist die Arbeit von jemandem, und die Spezifikation ist der Ort, an dem dieser Jemand benannt wird. Sie lenkt schliesslich die Elizitation: die Liste der Schnittstellen benennt die Gegenparteien, also die Anspruchsgruppen, also die Personen, die für die weitere Anforderungsarbeit an einen Tisch gehören. In dieser Hinsicht gehört die Technik ebenso zur Elizitation wie zur Anforderungsanalyse.

Das Ergebnis ist zweiteilig. Der Schnittstellenkatalog ist das Inventar: eine Zeile pro Schnittstelle, mit Gegenpartei, Richtung, Typ, Format, Frequenz, Volumen und Verantwortlichem. Die Schnittstellenspezifikation ist der Vertrag: für jede Schnittstelle, die es verdient, die feldweise Definition der Nachricht, die Validierungsregeln, die Transformation, die Auslöser einschliesslich der Fehlerauslöser, das Fehlerverhalten, das Servicelevel, die Sicherheit und die geltende Version. Das Systems Engineering nennt dieses zweite Dokument ein Interface Control Document, und das Systems Engineering Handbook der NASA legt dessen Familie fest (Interface Requirements Document, Interface Control Document, Interface Description Document). Die Norm ISO/IEC/IEEE 29148:2018 führt die externen Schnittstellenanforderungen innerhalb der Systemanforderungsspezifikation. Auf einem Projekt nach HERMES, der Projektmanagementmethode des Bundes, ist dieses Inventar vorgeschrieben: Die Integrationsobjekte und Schnittstellen bilden eine der neun Rubriken des Integrationskonzepts, neben der Systemübersicht, den Integrationsumgebungen und Integrationsschritten, den Risiken und der Qualitätssicherung.

Anwendung

Wann einsetzen

• Frisch gezogene Lösungsgrenze: jede Überschreitung der Umfangslinie ist eine Schnittstelle, die zu spezifizieren und zu bepreisen ist.
• Standardsoftware oder SaaS in der Auswahl: die Schnittstellen zur bestehenden Applikationslandschaft tragen den Grossteil der Integrationskosten.
• Ablösung eines Altsystems: seine Schnittstellen sind das Inventar dessen, was der Nachfolger weiterhin erfüllen muss.
• Vom Standard vorgegebener Austausch: ELM, ISO 20022, eCH, der Vertrag kommt von aussen und die Arbeit besteht darin, ihn zu lesen.
• Bepreisung einer Integration: Volumen und Frequenz je Schnittstelle machen aus einer Liste einen Betrag.
• Planung der Elizitation: die Liste der Schnittstellen benennt die Gegenparteien, die an die Sitzung gehören.
• Übergabe zwischen zwei Einheiten oder zwei Unternehmen: dort geht die Verantwortung verloren.
• Zu belegender Änderungsantrag: die reale Nutzung und die Störungen der heutigen Schnittstellen sind bezifferte Belege.

Wann nicht einsetzen

• Internes Verhalten einer Komponente: die Grenze des BABOK, auf die Geschäftsregelanalyse oder ein Datenmodell zurückgreifen.
• Noch offener Umfang: die Überschreitungen einer nicht vereinbarten Linie zu spezifizieren ergibt einen Wegwerfkatalog, zuerst mit der Umfangsmodellierung rahmen (BABOK 10.41).
• Reihenfolge der Nachrichten in Frage: das Sequenzdiagramm (BABOK 10.42) sagt, in welcher Reihenfolge, was die Spezifikation offen lässt.

Die sechs Schnittstellentypen

Das BABOK zählt sechs Typen auf, und diese Liste ist der Punkt, den Praktiker am häufigsten verfehlen, weil sie Schnittstelle hören und API denken. Benutzerschnittstellen sind die Masken, über die Personen der Organisation direkt mit der Lösung arbeiten. Lösungsexterne Personen sind die Anspruchsgruppen, die Regulatoren und die Behörden, die Informationen empfangen oder liefern: in der Schweiz sind eine AHV-Ausgleichskasse, eine kantonale Steuerverwaltung und ein Statistikamt, das eine obligatorische Erhebung einzieht, vollwertige Schnittstellen, mit Format, Termin und Ausfallmodus. Geschäftsprozesse bilden eine Schnittstelle, wenn ein Prozess Informationen an einen anderen übergibt, auch innerhalb desselben Unternehmens. Datenschnittstellen zwischen Systemen sind die klassischen Austausche, nächtlicher Stapellauf, Replikation, Nachrichtenwarteschlange. Programmierschnittstellen, die APIs, sind die veröffentlichte Schnittstelle einer aufrufbaren Komponente. Geräte sind die Hardwareschnittstellen, Badgeleser, Zahlungsterminal, Werkstattsensor.

Diese Reichweite verankert die Technik in der Business Analyse, und das BABOK leitet daraus eine Stärke ab: ihre breite Anwendung erspart ihr die Überanalyse des Feindetails. Die beiden Typen, die niemand katalogisiert, sind die öffentliche Behörde und die Übergabe zwischen Prozessen. Der Integrationsarchitekt wird sie nicht finden, weil sie in keiner technischen Konfiguration erscheinen.

HERMES behandelt die Schnittstellen zwischen einer temporären Projektorganisation und der Stammorganisation, die sie aufnimmt: Die Methode garantiert die Kompatibilität dieser standardisierten Schnittstellen, zum Beispiel des Reportings. Sie nennt die drei Rollen, die für das Funktionieren der Schnittstellen unentbehrlich sind: den Auftraggeber, den Projektleiter und den Anwendervertreter. Was diese Grenze überquert, ist benannt: Projektstatusbericht, Phasenbericht, Releasebericht. Diese Übergabe gehört zum Typ Geschäftsprozess und wird wie die anderen katalogisiert, mit Sender, Empfänger, Frequenz, Inhalt und Termin.

Die materielle Schnittstelle

Ein Gerät tauscht Materie und Energie ebenso aus wie Nachrichten, und seine Spezifikation trägt Rubriken, die kein Dateiaustausch kennt. Die Form steht am Anfang: die Geometrie, der Platzbedarf, der Steckverbinder, die Befestigung, die Einbaurichtung, alles, was darüber entscheidet, ob die beiden Teile zusammenpassen. Die Betriebsfestigkeit ist die nichtfunktionale Anforderung der physischen Welt: der Temperaturbereich, die mechanische Beständigkeit gegen Stoss und Vibration, die chemische Beständigkeit gegen Reinigungsmittel, die Dichtheit gegen Staub und Wasser. Das Medium qualifiziert, was die Grenze physisch überschreitet: ein Gas, eine Flüssigkeit, ein Werkstück, bei welchem Druck und welchem Durchfluss. Die Energie ist eine Eingabe für sich: die Spannung, der Strom, die Leistung, die Erdung und die Frage, welche der beiden Seiten die andere speist.

Die Kommunikation entfaltet sich danach in drei Stockwerke, die regelmässig verwechselt werden. Die Übertragungsstrecke und die Codierung: die verdrillte Zweidrahtleitung, die 4-20-mA-Stromschleife, der Feldbus und die Art, wie die Bits auf dem Signal getragen werden, eine NRZ-Codierung, eine Manchester-Codierung. Das Protokoll: der Rahmen, die Adressierung, die Fehlerprüfung, der Takt der Austausche, Modbus RTU, CAN, OPC UA. Die Semantik: was der Wert bedeutet. Ein Temperatursensor in einem Pasteurisierungsbehälter liefert die ganze Zahl 3820 in einem Modbus-Register, das Protokoll ist eingehalten und spezifiziert ist noch nichts, denn 3820 sind 38,2 °C bei einem Skalierungsfaktor von 0,01 und einer Ablesung in Grad Celsius, und unter einer anderen Konvention sind es ganz andere Werte. Ein eingehaltenes Protokoll und eine unterstellte Semantik ergeben einen richtigen Wert, der falsch gelesen wird. Die Spezifikation ist der Ort, an dem die Einheit, der Skalierungsfaktor, der gültige Bereich und der vereinbarte Wert für einen gestörten Sensor aufgeschrieben werden.

Die Schnittstellen identifizieren

Die Vorbereitung besteht darin, das bereits Vorhandene zusammenzutragen. Das BABOK nennt die Dokumentenanalyse, die Beobachtung, die Interviews, die Umfangsmodellierung und vor allem das Kontextdiagramm, das die Schnittstellen auf hoher Flughöhe zwischen menschlichen Akteuren, Organisationseinheiten, Geschäftsprozessen und Lösungskomponenten sichtbar macht. In einer bestehenden Applikationslandschaft findet sich das verlässlichste Material im laufenden System: der Integrationscode, die Stapelverarbeitungspläne, die Themen des Nachrichtenbusses, die Firewallregeln und die Ablageverzeichnisse sind die Schnittstellen, die die Dokumentation vergessen hat. Das BABOK vermerkt einen zweiten, oft übersehenen Nutzen dieser Arbeit: sie legt die reale Nutzungsfrequenz der bestehenden Schnittstellen und deren Mängel offen, Material, das den Änderungsantrag stärkt.

Die Identifikation selbst geht jede Anspruchsgruppe und jedes System durch, das mit der Lösung interagiert, und listet die Schnittstellen auf, die der künftige Zustand braucht. Die Beziehung zwischen einer Anspruchsgruppe und ihren Schnittstellen kann viele zu viele sein, in manchen Fällen eins zu eins. Das BABOK besteht auf den nicht offensichtlichen Schnittstellen, jenen, die einer regulatorischen Funktion, einer Revision oder der Schulung der Mitarbeitenden dienen. Für jede vier Fragen: ihre Funktion beschreiben, ihre Nutzungsfrequenz beurteilen, den passenden Schnittstellentyp bestimmen und die ersten Details erheben.

Sechs Fragen strukturieren das Ganze, und das BABOK stellt sie genau so: wer die Schnittstelle nutzen wird, was hinübergeht und in welchem Volumen, wann und in welcher Frequenz, wo der Austausch stattfindet, warum die Schnittstelle besteht, wie sie umgesetzt ist oder umgesetzt werden soll. Das Produkt dieses Schritts ist eine Schnittstellenkarte, die Lösung im Zentrum, ihre Gegenparteien darum herum, ein beschrifteter Pfeil pro Schnittstelle.

Eine Schnittstelle spezifizieren

Das BABOK gibt fünf Definitionselemente: den Namen der Schnittstelle, ihren Geltungsbereich, die Austauschmethode zwischen den beiden Einheiten, das Nachrichtenformat und die Austauschfrequenz. Es fügt die Eingaben und Ausgaben hinzu, die Validierungsregeln, die sie beherrschen, und die auslösenden Ereignisse, mit dem Hinweis, dass diese Ereignisse den Normalfluss, die Alternativflüsse und die Ausfälle abdecken. Genau diese letzte Erwähnung wird vergessen. Sie ist das Scharnier zwischen einer Liste und einem Vertrag.

Die Vorlage wird Rubrik für Rubrik gefüllt, und jede Rubrik beantwortet eine Frage, die leer gelassen zu einer Störung wird.

Das BABOK ist beim Zeitpunkt menschlicher Schnittstellen ausdrücklich: sie verlangen eine detaillierte Analyse im Vorfeld, weil dort die grossen Designmängel entschieden werden und weil sie danach sehr teuer zurückzunehmen sind. Ein Katalog, dessen Vorlage nur die gemeinsamen Rubriken füllen kann, typisiert seine Masken als Benutzerschnittstellen und lässt sie dann leer.

Der letzte Schritt ist, den Katalog mit den Verantwortlichen an beiden Enden zu validieren. Eine nur auf einer Seite unterzeichnete Schnittstellenspezifikation bleibt ein Wunsch.

Die Grenze zu den benachbarten Techniken

Das Datenflussdiagramm (BABOK 10.13) zeigt die Daten, die durch Prozesse fliessen: woher sie kommen, was sie transformiert, wo sie ruhen, wo sie ankommen. Die Schnittstellenanalyse spezifiziert den Vertrag an einer Grenze zwischen zwei Systemen oder zwei Organisationen. Das Kontextdiagramm zählt die Überschreitungen auf, die Schnittstellenanalyse spezifiziert jede einzelne und die Übergabe steht ausdrücklich im BABOK, das das Kontextdiagramm unter die Eingaben der Vorbereitung stellt. Zwei Asymmetrien trennen die beiden Techniken endgültig: die Schnittstellenanalyse deckt auch Benutzerschnittstellen, Behörden und Geräte ab, die ein Datenflussdiagramm als blosse externe Entitäten behandelt; und ein Datenflussdiagramm sagt nichts über Frequenz, Volumen, Fehlerverhalten, Verantwortung oder Servicelevel, die die ganze Substanz einer Schnittstellenspezifikation ausmachen.

Die Umfangsmodellierung (BABOK 10.41) zieht die Linie und stellt die Elemente hinein oder hinaus. Die Schnittstellenanalyse spezifiziert jede Überschreitung, sobald die Linie gezogen ist. Die Abhängigkeit läuft in eine Richtung, und die Analyse zu starten, bevor der Umfang vereinbart ist, ergibt einen Katalog, der weggeworfen wird.

Das Sequenzdiagramm (BABOK 10.42) modelliert die Logik eines Nutzungsszenarios, indem es die zwischen Objekten ausgetauschten Informationen mit Lebenslinien und geordneten Nachrichten zeigt. Der Unterschied ist zeitlicher Natur: das Sequenzdiagramm zeigt die Reihenfolge der Nachrichten in einem Szenario, die Schnittstellenspezifikation zeigt die dauerhaften Bedingungen einer Schnittstelle, unabhängig von jedem Szenario. Beide fügen sich zusammen: sobald die Schnittstelle als Anfrage und Antwort mit negativer Bestätigung spezifiziert ist, ist das Sequenzdiagramm das Mittel, um die Choreografie eines fehlgeschlagenen Aufrufs und seiner Wiederholung zu zeigen.

Die Schnittstelle als Datenquelle

Der Guide to Business Data Analytics der IIBA (§3.13) dreht die Technik um: eine Schnittstelle erzeugt selbst auswertbare Daten. Neben dem, was die Benutzerin eingibt, zeichnet das System auf, was sie tut, und diese Transaktionsdaten beantworten Fragen, die die Eingabe nicht abdeckt. Welche Funktionen tatsächlich genutzt werden. Warum ein Antrag unvollendet bleibt. Wie lange ein Vorgang von Anfang bis Ende dauert. Wo sich Anmeldefehler oder Ladezeiten häufen.

Der Leitfaden zieht eine zweite Folgerung für die Spezifikation: jedes Schnittstellenelement entspricht einem Datenbankattribut, und diese Zuordnung aufzuschreiben legt die impliziten Aufbewahrungsregeln offen. Überschreibt eine Profiländerung den Datensatz, oder legt sie einen neuen an, den die jüngste Kennung bezeichnet? Beides sieht am Bildschirm gleich aus und verhält sich in einem Bericht unterschiedlich. Die dokumentierte Zuordnung ist das, was die Extraktions- und Ladeläufe anschliessend aufgreifen.

Die Fallstricke

Die Schnittstelle, die niemandem gehört

Jede Seite nimmt an, die andere validiere, wiederhole oder überwache. Der Mangel zeigt sich erst im Betrieb, und seine Behebung ist organisatorisch. Die Katalogspalte, die ihn verhindert, ist ein benannter Verantwortlicher auf jeder Seite: der Name einer Person und ihre Rolle. Wenn die Gegenpartei ein Lieferant ohne benannte Ansprechperson ist, ist der Ausweg die vertragliche Eskalation.

Das undokumentierte Feld, das Bedeutung trägt

Ein freies Referenzfeld, in das vor Jahren jemand begonnen hat, einen Code zu schreiben, von dem heute eine nachgelagerte Verarbeitung abhängt. Er steht in keinem Schema und in keinem Wörterbuch, und er bricht an dem Tag, an dem das Feld bereinigt wird. Schnittstellen sammeln diese blinden Passagiere an. Das ist der Grund, Feld für Feld zu spezifizieren.

Der Stapel, der stillschweigend Datensätze verliert

Der Empfänger lädt die Datei Datensatz für Datensatz und verwirft jene, die er nicht lesen kann. Bei einem Stapel von 4'812 Datensätzen werden 4'796 geladen und 16 verworfen, kein Fehler erreicht den Sender, niemand zählt nach. Die Antwort der Spezifikation ist ein Abstimmungsvertrag: der Sender meldet die gesendete Anzahl, der Empfänger bestätigt die geladene Anzahl, eine Abweichung ist eine Störung. Eine Schnittstelle ohne Empfangsbestätigung überlässt ihr Fehlerverhalten der Hoffnung.

Das angenommene Fehlerverhalten der anderen Seite

Mit dem Abstimmungsvertrag meldet der Empfänger nun seine 16 Zurückweisungen, und der Mangel verschiebt sich um eine Stufe. Die Wiederholung des Senders wurde in der Annahme gebaut, der Empfänger weise die ganze Datei zurück, sobald ein Datensatz fehlerhaft ist: sie sendet daher nach der Korrektur die ganze Datei erneut und dupliziert die 4'796 bereits geladenen Datensätze. Der Empfänger nimmt Datensatz für Datensatz an, der Sender nahm das Gegenteil an und keines der beiden Verhalten wurde je aufgeschrieben. Die Zurückweisung der ganzen Datei oder die teilweise Annahme ist eine Entscheidung, und die Wirkung eines erneuten Versands, Ersetzen oder Doppel, ist eine weitere: beide gehören in die Spezifikation.

Das leer gelassene Mengengerüst

Die Schnittstelle ist identifiziert, benannt, typisiert, und niemand hat nach dem Wie viel gefragt. Die Dimensionierung, die Servicevereinbarung und die Schätzung ruhen dann auf einer Ahnung.

Das Abdriften des Vertrags

Die andere Seite ändert den Vertrag, und man merkt es an einer Zurückweisung. Das Schweizer Beispiel ist datiert und öffentlich: die Umsetzungsrichtlinien der QR-Rechnung sind am 21. November 2025 auf Version 2.3 übergegangen, die strukturierte Adressen im Swiss QR Code verlangt und die kombinierte Form nicht mehr zulässt, wobei Version 2.4 am 14. November 2026 in Kraft tritt. Jedes Fakturierungssystem, das die Adresse als freien Text behandelte, hatte eine von aussen auferlegte Schnittstellenänderung zu einem bekannten Termin zu verkraften. Eine Spezifikation ohne Version und ohne Ankündigungskanal ist eine Momentaufnahme.

Das spezifizierte Format, die angenommene Bedeutung

Zwei Systeme einigen sich darauf, dass ein Feld eine dreizehnstellige Ziffernfolge ist, und gehen darüber auseinander, was es identifiziert. Die Einigung über das Format lässt die semantische Einigung offen, und diese lebt in den Codelisten, in der Zuordnungstabelle der Transformation und in den Definitionen des Datenwörterbuchs.

Der auf technische Schnittstellen verkürzte Katalog

Die sechs Typen des BABOK umfassen die Benutzerschnittstellen, die lösungsexternen Personen einschliesslich der öffentlichen Behörden und die Geschäftsprozesse. Die regulatorische Meldung und die Übergabe zwischen zwei Abteilungen haben ein Format, einen Termin und einen Ausfallmodus, genau wie ein Webservice.

KI-Betrachtungen

Der beste Einsatz ist die Ableitung eines Kandidatenkatalogs aus dem, was tatsächlich läuft. Ein Modell auf OpenAPI-, WSDL- oder XSD-Schemata richten, auf den Integrationscode, auf die Definitionen der ETL-Verarbeitungen, auf die Konfiguration des Nachrichtenbusses und auf die Firewallregeln; danach lässt man es einen ersten Wurf in die festgelegten Spalten extrahieren. In einer Altlandschaft, die seit zehn Jahren niemand dokumentiert hat, ersetzt das die leere Seite durch einen Entwurf, den es zu widerlegen gilt, und die Widerlegung führt man gegen das laufende System.

Zwei weitere Einsätze sind solide. Der Schemavergleich und die Wirkungsanalyse: zwei Versionen eines XSD oder eines OpenAPI-Dokuments und die Frage, welche der tatsächlich genutzten Felder sich geändert haben. Die Aufgabe ist mechanisch, vollständig und jene Wachsamkeit, die die menschliche Durchsicht beim vierhundertsten Element verliert; sie verwandelt eine Release Note des Lieferanten in eine Arbeitsliste. Die Erzeugung von Beispielnachrichten und negativen Testfällen aus einem Schema: fehlerhafte Nachricht, Randwert, fehlendes Pflichtfeld, Code ausserhalb der Liste. Die Fehlerpfade sind der am wenigsten getestete und am meisten spezifizierte Teil einer Schnittstelle, und sie aus dem Vertrag zu erzeugen kostet wenig. Die Matrix des Fehlerverhaltens lässt sich ebenso aus den Statuscodes und dem Fehlermodell vorredigieren, die eine API deklariert.

Drei Grenzen liegen im Urteil und im Recht. Mengengerüst, Frequenz, Verantwortung und Servicelevel stehen in keinem Schema: sie sind Eigenschaften der Organisation, sodass ein befragtes Modell eine plausible Zahl produziert. Ein erfundenes Volumen ist schlimmer als eine leere Zelle, weil man darauf dimensioniert. Die Semantik einer Codeliste kommt von den beiden Verantwortlichen: ein Modell wird sagen, dass ein Feld elf Werte aufzählt, nur das Fachgebiet wird sagen, welche noch gebraucht werden, welcher systematisch falsch verwendet wird und worauf sich jeder in der Liste des Ziels abbildet. Der Datenschutz schliesslich: eine ELM-Nachricht trägt AHV-Nummern, Löhne und die UID des Arbeitgebers, also Personendaten im Sinne des revDSG. Die Arbeit erfolgt am Schema und an synthetischen Nutzdaten. Ein Produktionsauszug, der in ein Allzweckmodell kopiert wird, ist ausgeschlossen.

Beispiele

Die gewählte Landschaft ist die der Lohnschnittstellen eines Schweizer KMU mit 120 Mitarbeitenden, rund um die Lohnsoftware. Von diesen 120 Mitarbeitenden sind 34 quellenbesteuert (B-Bewilligung und Grenzgänger), und die Buchhaltung verteilt die Lohnsumme auf vier Kostenstellen: diese beiden Zahlen sind zusammen mit dem Personalbestand die einzigen Eingaben, von denen sämtliche Volumen des Katalogs abhängen. Die Landschaft trägt acht Schnittstellen, fünf der sechs Typen des BABOK, fünf Formate und vier Rhythmen (ereignisgesteuert, monatlich, jährlich, alle zwei Jahre), und sie lässt die öffentliche Behörde und die Übergabe zwischen Prozessen als gewöhnliche Gegenparteien erscheinen.

Die Karte trägt den Vertrag jedes Flusses in drei Zeichen: die Richtung, das Format, den Rhythmus. Der Katalog faltet dieselben acht Schnittstellen in Spalten auf und ergänzt, was die Karte nicht tragen kann, das Volumen und den Verantwortlichen an jedem Ende.

Der Katalog hört dort auf, wo der Vertrag beginnt. Die Spezifikation entfaltet eine einzige Zeile, IF-01, und die Rubriken, die sie vom Katalog unterscheiden, sind am mühsamsten zu füllen: das Fehlerverhalten, der Verantwortliche, der seine Seite verbindlich zusagen kann, die Servicevereinbarung und die Version.

Aufwand

Werkzeuge

Die Tabellenkalkulation oder die Wiki-Tabelle ist das ehrliche Zuhause des Katalogs, solange die Landschaft klein ist, wo die meisten realen Kataloge leben. Die Werkzeuge des Anforderungsmanagements (Jama, Polarion, DOORS) übernehmen, sobald die Spezifikation vertraglichen Wert hat und die Schnittstellen bis zu den Anforderungen und den Tests verfolgt werden müssen.

Die Vertragsformate sind die Spezifikation in maschinenlesbarer Form, und sie zu übernehmen ist das einzig bekannte Mittel, damit die Spezifikation nicht von der Umsetzung abdriftet: OpenAPI für REST-APIs über HTTP, AsyncAPI für ereignis- und nachrichtenbasierte Austausche, WSDL und XSD für SOAP, das im PIV-Verfahren von Swissdec zum Einsatz kommt, und JSON Schema für die Validierung der Nutzdaten. Vertragstests (Pact) und API-Clients (Postman, SoapUI) machen die Spezifikation ausführbar: die Integrationsstrecke erkennt das Abdriften dann vor der Inbetriebnahme. API-Gateways und Entwicklerportale sind der Ort, an dem der Katalog und der Vertrag auf der Konsumentenseite veröffentlicht werden.

Für die Karte genügt ein Modellierungswerkzeug: eine Sicht der Anwendungskooperation in ArchiMate oder ein C4-Containerdiagramm liegen auf der Flughöhe der Schnittstellenkarte. Bleibt die Dokumentation der Standards selbst, die für eine Schweizer Schnittstelle oft die Spezifikation ist, die man nicht schreiben darf: Swissdec für ELM, SIX für die Swiss Payment Standards, die IBAN und die QR-Rechnung, eCH für die Austausche des E-Government, das Forum Datenaustausch für die Fakturierung zwischen Leistungserbringern und Versicherern. Den vorgegebenen Vertrag zu lesen ist die Arbeit.

Quellen

• IIBA, A Guide to the Business Analysis Body of Knowledge (BABOK Guide) v3, §10.24 Interface Analysis: die Definition, die sechs Schnittstellentypen, die drei Elemente der Technik, ihre Stärken und ihre Grenze.
• ISO/IEC/IEEE 29148:2018, Systems and software engineering, Life cycle processes, Requirements engineering: die Norm, die die externen Schnittstellenanforderungen in der Systemanforderungsspezifikation führt.
• NASA Systems Engineering Handbook, §6.3 Interface Management: die Familie der Schnittstellendokumente (IRD, ICD, IDD).
• OpenAPI Specification, OpenAPI Initiative: der HTTP-Schnittstellenvertrag in maschinenlesbarer Form.
• AsyncAPI Specification, AsyncAPI Initiative: derselbe Vertrag für ereignis- und nachrichtenbasierte Austausche.
• RFC 9457, Problem Details for HTTP APIs, IETF: eine kanonische Konvention für das Fehlerverhalten an einer HTTP-Schnittstelle.
• Swissdec, Lohnstandard-CH (ELM): der Schweizer Standard der Lohnmeldung, die Unterscheidung zwischen Meldung und Verfahren, die Verfahren PIV und EIV, die Zertifizierung der Software.
• ISO 20022: der Standard für Finanznachrichten hinter den Swiss Payment Standards und der Nachricht pain.001.
• SIX, QR-Rechnung und Swiss Payment Standards: die Umsetzungsrichtlinien und ihre Versionierung, darunter der Übergang zu strukturierten Adressen.
• SIX, IBAN: der Standard der Schweizer IBAN und die Bankidentifikation IID, geführt von SIX.
• Bundesamt für Statistik, Unternehmens-Identifikationsnummer (UID): das Format CHE-NNN.NNN.NNN und seine Prüfziffer.
• Bundesamt für Statistik, Schweizerische Lohnstrukturerhebung (LSE): die alle zwei Jahre durchgeführte Bundeserhebung, die der Statistikbereich von ELM speist.
• OFAS, Les éléments qui composent le numéro d'assuré AVS: das Format 756.XXXX.XXXX.XX, seine 13 Ziffern und seine Prüfziffer.
• Bundesgesetz über den Datenschutz (revDSG), SR 235.1: die Ordnung, die für die Personendaten gilt, die eine Lohnschnittstelle trägt, in Kraft seit dem 1. September 2023.
• eCH: die Standards des Schweizer E-Government.
• Forum Datenaustausch, XML-Standards: die Austauschstandards für die Fakturierung zwischen Leistungserbringern und Versicherern.
• IIBA, Guide to Business Data Analytics, §3.13 Interface Analysis: die Schnittstelle als Erzeugerin von Transaktionsdaten und die Zuordnung von Schnittstellenelementen zu Datenbankattributen.
• Schweizerische Eidgenossenschaft, Bundeskanzlei, HERMES 2022, Referenzhandbuch Projektmanagement, Ergebnis 4.4.1.18 Integrationskonzept: die Integrationsobjekte und Schnittstellen als geforderte Rubrik des Dokuments, das die Integration des Systems in sein Umfeld beschreibt.
• HERMES 2022, Referenzhandbuch Projektmanagement, Schweizerische Eidgenossenschaft, Bundeskanzlei, §A.5 Die Schnittstellen des HERMES-Projektmanagements: die Schnittstelle im organisatorischen Sinn, die garantierte Kompatibilität zwischen Projektorganisation und Stammorganisation, das Reporting als Beispiel und die drei für das Funktionieren der Schnittstellen unentbehrlichen Rollen.