Direkt zum Inhalt
KostenlosEin Audit deiner Drupal-WebsiteEin schriftliches Audit deiner Drupal-Website, innerhalb von drei Werktagen
Alle Artikel

Frontend & SDX2. Nov. 20265 Min. Lesezeit

Deine Website mit den Systemen verbinden, die du schon nutzt

Valentin ZsigmondGründer & Lead Engineer

Eine Website steht selten für sich allein. Hinter den meisten Unternehmenswebsites stehen ein Rechnungsprogramm, ein CRM, eine Lagerdatenbank, ein Newsletter-Tool, ein Buchungskalender oder eine Buchhaltungssoftware – und der Nutzen der Website vervielfacht sich, wenn sie mit diesen Systemen Daten austauscht. Ein Formular, das im CRM einen Lead anlegt, statt eine E-Mail zu verschicken. Eine Produktseite, die den echten Lagerbestand zeigt. Eine Bestellung, aus der eine Rechnung wird, ohne dass jemand etwas abtippt. In Rumänien ist das letzte Beispiel in diesem Jahr für Zehntausende kleiner Unternehmen Wirklichkeit geworden: Mit der Einführung von e-Factura muss seit Juli fast jede Rechnung innerhalb von fünf Arbeitstagen als strukturierte Daten im staatlichen System ankommen. Integration ist damit kein nettes Extra mehr, sondern gehört zum Geschäftsalltag. In diesem Artikel zeigen wir, wie wir eine Drupal-Website mit den Systemen verbinden, die du schon nutzt, und warum diese Verbindungen zuverlässig bleiben.

Vier Arten von Integrationen

Die meisten Integrationen lassen sich einer von vier Arten zuordnen. Wenn du weißt, welche du brauchst, ist die Konzeption schon halb erledigt.

Die Website sendet. Aus einem abgeschickten Formular wird ein Lead im CRM, ein Ticket im Helpdesk, ein neuer Eintrag im Newsletter-Verteiler oder eine Zeile in einer Tabelle. Die Website ist die Quelle, das andere System empfängt.

Die Website empfängt. Produkte, Preise, Lagerbestände, Öffnungszeiten oder Stellenanzeigen werden in einem anderen System gepflegt und erscheinen auf der Website. Sie zeigt Daten an, die ihr nicht gehören, und aktualisiert sie in festen Abständen oder sobald sich die Quelle ändert.

Die Website steuert. Eine Bestellung auf der Website reserviert den Bestand in einem System, wickelt die Zahlung über ein zweites ab, erstellt in einem dritten die Rechnung, übermittelt sie an e-Factura und benachrichtigt anschließend den Kunden. Die Website koordiniert einen Ablauf über mehrere Beteiligte hinweg.

Die Website stellt bereit. Eine mobile App, ein Partner oder ein Reporting-Tool liest die Inhalte der Website über eine API. Die Website ist die Quelle für andere.

Warum Drupal hier in seinem Element ist

Drupal wurde ebenso als Framework wie als CMS entwickelt, und bei Integrationen zeigt sich das. Die Inhalte sind strukturiert. Einen Produktdatensatz aus einem externen System auf ein Produkt der Website abzubilden, ist deshalb kein Parsing-Problem, sondern eine Zuordnung von Feld zu Feld. Über das Queue-System laufen Aufgaben, die andere Dienste ansprechen, im Hintergrund, werden bei Fehlern wiederholt und bremsen nie einen Besucher aus. Über die API-Schicht können andere Systeme auf jeden Inhaltstyp zugreifen, und die Berechtigungen gelten auch dort. Und dank des Modulsystems ist jede Integration ein abgeschlossener Baustein mit eigener Konfiguration, eigenen Tests und eigenen Logs, der sich aktualisieren oder austauschen lässt, ohne den Rest der Website anzufassen.

Gerade diese letzte Eigenschaft zählt auf lange Sicht. Externe Systeme ändern sich: Eine API-Version wird abgeschaltet, ein Anbieter gewechselt, ein Feld umbenannt. Ist die Integration als Modul gebaut, ist die Anpassung eine Kleinigkeit. Zieht sie sich dagegen quer durch Templates und individuellen Code, wird daraus ein Projekt.

Gerüstet für den Tag, an dem das andere System ausfällt

Jede Integration hängt an einem System, das du nicht kontrollierst, und jedes dieser Systeme ist irgendwann nicht erreichbar. Gute Integrationen sind von Anfang an auf diesen Tag ausgelegt. Ist das CRM ausgefallen, lässt sich das Formular trotzdem abschicken: Der Lead wartet in der Warteschlange und wird zugestellt, sobald das CRM wieder da ist, ohne dass der Besucher etwas davon merkt. Antwortet der Lagerdienst nicht rechtzeitig, zeigt die Produktseite den letzten bekannten Bestand samt Zeitstempel statt einer Fehlermeldung. Lehnt das Rechnungssystem eine Übermittlung ab, bekommt ein Mensch eine Nachricht mit dem Grund, und die Bestellung geht nicht verloren. Die Regel ist einfach: Was der Besucher erlebt, darf nie davon abhängen, dass ein Drittanbieter rechtzeitig antwortet.

Dasselbe Prinzip gilt für die Sicherheit. Zugangsdaten für externe Systeme liegen als Secrets außerhalb des Codes und gelten nur für ihre jeweilige Umgebung, sodass die Staging-Umgebung nie an ein echtes Rechnungskonto herankommt. Jeder Aufruf wird protokolliert. Ein anderes System bekommt nur die Daten, die es wirklich braucht. Und die Verbindung wird überwacht wie jeder andere Teil der Website, damit eine gestörte Integration auffällt, bevor ein Kunde eine fehlende Rechnung bemerkt.

Das Beispiel e-Factura

Die rumänische Pflicht zur E-Rechnung ist ein gutes Beispiel, weil sie jeden Teil dieses Musters berührt. Die Rechnung muss als strukturiertes XML in einem bestimmten Format erzeugt, signiert und an das staatliche System übermittelt werden, und die Antwort muss gespeichert werden – alles innerhalb einer Frist. Kommen die Bestellungen eines Unternehmens über die Website herein, geschieht das am besten im Moment der Bestellbestätigung: im Hintergrund und mit einem Ergebnis, das Buchhaltung und Kunde sehen können.

Ob die Website die Rechnung selbst erstellt oder eine Buchhaltungssoftware mit Daten versorgt: Die Integration ist immer gleich aufgebaut. Sie besteht aus einer Warteschlange, einer Zuordnung der Felder, einer idempotenten Übermittlung, die sich gefahrlos wiederholen lässt, einer Aufzeichnung der Antwort und einer Warnung, sobald etwas abgelehnt wird. Wir bauen sie so, dass die Buchhaltung den Status jeder Rechnung an einer Stelle sieht und dass eine Änderung des Formats – die es schon mehr als einmal gab – nur ein einziges Modul betrifft.

Integrationen in einem Portal

Hat ein Unternehmen ein Kundenportal, werden Integrationen zu dessen eigentlichem Inhalt. Bestellungen aus dem Shop, Rechnungen aus der Buchhaltung, Tickets aus dem Support und Dokumente aus einem Dateisystem stehen nebeneinander, jeweils aus ihrer eigenen Quelle abgerufen und mit denselben Berechtigungen angezeigt. Unser eigenes Portal arbeitet genau so und bezieht Daten aus mehreren internen Systemen. Das Muster funktioniert aber auch im Kleinen, etwa für einen Kundenbereich mit einem einzigen angebundenen System.

Wie ein Integrationsprojekt beginnt

Wir beginnen mit den Daten, nicht mit der Technik: Welche Datensätze müssen übertragen werden, in welche Richtung, wie oft, und was soll passieren, wenn dabei etwas schiefgeht? Dann sehen wir uns an, was das andere System bietet, lesen seine Dokumentation und bauen einen kleinen Prototyp, der einen echten Datensatz vollständig von einem System ins andere bringt. Die meisten Integrationen sind nach wenigen Wochen live. Bei Zahlungen oder Rechnungen dauert es länger, weil Zertifizierungen und Tests in einer Sandbox dazugehören. Während des gesamten Projekts ist die Arbeit im Portal sichtbar und lässt sich in der Staging-Umgebung mit bereinigten Daten testen, nie mit echten Konten.

Wenn dein Team Daten von der Website in ein anderes System abtippt oder umgekehrt, ist das eine Integration, die bisher nur niemand gebaut hat. Sag uns, welche Systeme beteiligt sind, und wir sagen dir, was es braucht, um sie zu verbinden.

Geschrieben von

Valentin Zsigmond

Gründer & Lead Engineer

Full-Stack-Drupal-Architekt mit fast zwei Jahrzehnten Erfahrung in der Leitung großer Teams in Enterprise-Umgebungen. Hat Tilizy Digital gegründet, um Senior-Expertise direkt zu den Organisationen zu bringen, die sie brauchen. Mentor für Dutzende Drupal-Entwickler und Schöpfer von SDX.

Hat dir der Artikel gefallen?

Wenn er dich angesprochen hat: Stell dir vor, was wir gemeinsam aus deiner Drupal-Website machen könnten.