Alle Case Studies
Anonym · 20268 Min. Lesezeit

Vom Kundenproblem zur Integration

Wie ich Kundenbedarf, fachliche Anforderungen und technische Umsetzung in einer Anwendung zusammengeführt habe.

Projektvorschau
Vom Kundenproblem zur Integration

Lizenzdaten und Azure-Ressourcen waren vorhanden. Die Herausforderung lag darin, sie zuverlässig den richtigen Kunden und Strukturen in HALO zuzuordnen.

Bei HALO connect verantwortete ich das gesamte Projekt: von der Klärung der Kundenprobleme über die Strukturierung und Priorisierung der Anforderungen bis zur technischen Umsetzung. Der Kunde beschrieb seine Arbeitsabläufe und die Schwierigkeiten bei der Datenübernahme. Daraus entwickelte ich das Ziel und den Umfang der Anwendung.

Entstanden ist eine Web-Anwendung, die Lizenzdaten aus unterschiedlichen CSV-Formaten verarbeitet, Azure-Ressourcen erfasst und Informationen nach HALO überträgt. Die wesentlichen Entscheidungen lagen dabei in den fachlichen Details: Welche Daten gehören zusammen? Woran werden bestehende Einträge erkannt? Welche Zuordnungen müssen Anwender selbst konfigurieren können? Und welche Rückmeldung brauchen sie nach einer Übertragung?

Projekt im Überblick

Anwendung

HALO connect, eine Integrationsanwendung für HALO PSA

Meine Verantwortung

Kundenabstimmung, Anforderungsklärung, Priorisierung und technische Umsetzung

Schwerpunkt

Lizenzimporte, Azure-Inventarisierung und Zuordnung zum Kundenkontext

Technische Grundlage

Next.js, React, TypeScript, FastAPI, PostgreSQL und Azure-Dienste

Lizenzimporte

Azure-Anbindung

Übertragungen

Drei unterstützte CSV-Formate

Konfigurierbare Zuordnung von Ressourcentypen und Feldern

Getrennte Ergebnisse für erstellte, aktualisierte, übersprungene und fehlerhafte Assets

Daten aus mehreren Quellen in HALO zusammenführen

Im Mittelpunkt stand die Übernahme von Informationen aus unterschiedlichen Systemen. CSV-Dateien enthielten Lizenz- und Verbrauchsdaten. Azure lieferte Kunden, Subscriptions und Ressourcen. In HALO mussten diese Informationen in vorhandene Kunden-, Lizenz- und Asset-Strukturen eingeordnet werden.

Die Übertragung erforderte mehrere Entscheidungen. Eine Datei musste gelesen, eine Kundenreferenz aufgelöst und ein vorhandener Datensatz erkannt werden. Bei Azure kamen unterschiedliche Ressourcentypen mit jeweils eigenen Eigenschaften hinzu.

Mein Ausgangspunkt war deshalb der gesamte Arbeitsablauf: Wie gelangen externe Lizenz- und Infrastrukturinformationen nachvollziehbar in die vorhandenen HALO-Strukturen? Daraus ergaben sich die Anforderungen an Datenprüfung, Zuordnung, Aktualisierung und Ergebnisrückmeldung.

Kundenprobleme in konkrete Anforderungen übersetzen

Ich zerlegte die Aufgabe in fachliche Fragen, die für die Umsetzung beantwortet werden mussten:

  • Welche Datenquellen und Exportformate soll die Anwendung unterstützen?
  • Welche Informationen benötigt HALO für eine korrekte Übernahme?
  • Über welche Referenzen lassen sich Kunden und vorhandene Einträge erkennen?
  • Welche Regeln sind je Quelle erforderlich?
  • Welche Einstellungen müssen Anwender selbst pflegen können?
  • Wie sollen fehlende Voraussetzungen und Fehler behandelt werden?

Dabei führte ich die Erwartungen des Kunden mit den Bedingungen der technischen Umsetzung zusammen. Der Kunde brauchte einen verständlichen Ablauf. Für die Entwicklung waren eindeutige Regeln zu Datenformaten, Identitäten und Ausnahmefällen erforderlich.

Da auch die Umsetzung bei mir lag, konnte ich die Folgen fachlicher Entscheidungen direkt prüfen. Eine fehlende Kundenreferenz beeinflusst beispielsweise die Zuordnung. Eine fehlende Subscription-ID verändert die Erkennung bestehender Lizenzen. Solche Details bestimmen, wie weit ein Ablauf automatisiert werden kann und wo eine Rückmeldung an den Anwender nötig ist.

Jedes Format braucht eigene Regeln

HALO connect unterstützt CSV-Dateien für Mailarchiv, STARFACE und ADN. Die Formate unterscheiden sich sowohl in ihren Spalten als auch in der Bedeutung der enthaltenen Werte. Jede Quelle besitzt deshalb eine eigene Verarbeitung.

Für den Anwender sollte daraus ein wiederverwendbarer Ablauf entstehen: Export auswählen, Datei hochladen und die Daten nach den vorgesehenen Regeln nach HALO übertragen.

Die Verarbeitung berücksichtigt Dateityp, erwartete Spalten, Trennzeichen sowie Mengen, Datums- und Preisangaben. Beim Mailarchiv werden Lizenzmengen innerhalb der vorgesehenen Gruppierung über ihren Maximalwert zusammengeführt. Bei ADN werden unter anderem positive Mengen, Endkundenreferenzen und externe Subscription-IDs verarbeitet.

Diese Unterschiede bestimmten die Anforderungen an den Import. Ein Upload kann technisch funktionieren und trotzdem ein fachlich falsches Ergebnis erzeugen. Deshalb musste neben dem Dateiformat auch feststehen, wie die Werte interpretiert und zusammengeführt werden.

Belastbare Referenzen als Voraussetzung

Eine Azure-Ressource gehört zu einer Subscription und diese zu einem Tenant. Für die Übertragung muss daraus der passende Kunden- beziehungsweise Standortkontext in HALO ermittelt werden.

Die Anwendung berücksichtigt unterschiedliche Quellen für Azure-Tenant-IDs: die Azure-/CSP-Integration in HALO, ein konfiguriertes Custom Field oder eine automatische Auswahl mit Fallback. Damit lässt sich die Zuordnung an vorhandene Datenstrukturen anpassen.

Die zentrale Regel lautet: Daten werden über belastbare Referenzen zugeordnet. Ein ähnlicher Anzeigename reicht dafür nicht aus. Die Klärung dieser Identitäten ist eine Voraussetzung für die weiteren Schritte, weil selbst ein korrekt aufgebautes Asset im falschen Kundenkontext unbrauchbar wäre.

Fachliche Zuordnungen konfigurierbar machen

Azure beschreibt Ressourcen über technische Typen und Eigenschaften. HALO verwendet Asset-Typen mit eigenen Feldern. HALO connect verbindet diese Strukturen über zwei Zuordnungen:

Zuordnung

Aufgabe

Service-Mapping

Verknüpft einen Azure-Ressourcentyp mit einem HALO-Asset-Typ

Field-Mapping

Legt fest, welche Azure-Eigenschaft in welches HALO-Feld geschrieben wird

Damit können Anwender die Zuordnungen selbst pflegen. Anpassungen an der HALO-Struktur benötigen nicht für jeden Einzelfall eine Änderung am Programmcode. Verfügbare Azure-Felder werden aus gespeicherten Ressourcenstrukturen ermittelt; ergänzend unterstützt das Backend Schema-Vorlagen.

Die Entscheidung für konfigurierbare Mappings berücksichtigt, dass verschiedene Ressourcentypen unterschiedliche Informationen benötigen. Eine feste Feldliste hätte den möglichen Umfang der Integration früh begrenzt.

Vorhandene Daten erkennen und aktualisieren

Lizenzbestände und Azure-Ressourcen verändern sich. Ein Import muss deshalb auch bei erneuter Nutzung nachvollziehbar arbeiten.

Bei Assets erfolgt die Erkennung über einen Primärwert und den Vergleich mit vorhandenen HALO-Assets. Ein erkannter Datensatz wird aktualisiert, andernfalls wird ein neuer angelegt. Auch die Lizenzverarbeitung prüft auf bestehende Einträge.

Welche Identität geeignet ist, hängt von der jeweiligen Quelle ab. Bei ADN-Einträgen ohne externe Subscription-ID sieht die aktuelle Verarbeitung eine Neuanlage vor. Diese Ausnahme ist relevant, weil sie die Erwartungen an wiederholte Importe bestimmt. Die Anwendung kann vorhandene Einträge nur dort zuverlässig wiedererkennen, wo die dafür benötigten Referenzen vorliegen.

Den nächsten Arbeitsschritt ermöglichen

Nach einer Übertragung müssen Anwender erkennen können, was übernommen wurde und wo Nacharbeit erforderlich ist.

Für CSV-Importe speichert die Anwendung unter anderem Bezeichnung, Datei-Metadaten, Zeitpunkte, Bearbeitungsstatus und Verarbeitungsergebnis. Bei der kundenweisen Asset-Übertragung liefert das Backend getrennte Ergebnisse für erstellte, aktualisierte, übersprungene und fehlerhafte Ressourcen.

Ein übersprungener Datensatz kann beispielsweise auf ein fehlendes Mapping zurückgehen. Mit dieser Information kann der Anwender die Zuordnung ergänzen und die Übertragung erneut auslösen. Die Rückmeldung gehört damit zum vollständigen Ablauf und beeinflusst die Anforderungen an Oberfläche und Verarbeitung.

Umfang und Prioritäten aus den Abhängigkeiten ableiten

Die Funktionen bauen aufeinander auf. Azure-Ressourcen lassen sich erst sinnvoll übertragen, wenn der Kunde erkannt, der Ressourcentyp zugeordnet und die Felder konfiguriert sind. Ein CSV-Import benötigt eine passende Datei und eine nutzbare HALO-Verbindung.

Für die Strukturierung der Arbeit war deshalb der vollständige Arbeitsablauf maßgeblich. Auswahl, Prüfung, Verarbeitung, Übertragung und Rückmeldung müssen zusammen ein nutzbares Ergebnis ergeben.

Die folgenden Bereiche zeigen die fachlichen Abhängigkeiten der Anwendung:

Bereich

Beitrag zum Ablauf

Anmeldung und Verbindungen

Zugriff auf die Anwendung und das gewünschte HALO-Ziel ermöglichen

CSV-Verarbeitung

Unterstützte Dateien prüfen, verarbeiten und Ergebnisse speichern

Azure-Datenbasis

Kunden, Subscriptions und Ressourcen erfassen

Kunden- und Feldzuordnung

Daten in die passenden HALO-Strukturen einordnen

Erkennung bestehender Assets

Wiederholte Übertragungen und Aktualisierungen unterstützen

Suche und Pagination

Größere Datenbestände bedienbar halten

Der Umfang blieb auf definierte Lizenzformate und einen konkreten Azure-zu-HALO-Prozess ausgerichtet. Das gab der Entwicklung klare Grenzen und machte die einzelnen Anwendungsfälle überprüfbar. Die Tabelle beschreibt diese Abhängigkeiten, keine nachträglich rekonstruierte Lieferreihenfolge.

Voraussetzungen und Fehlerfälle sichtbar behandeln

Die Anwendung verbindet mehrere Systeme. HALO muss erreichbar sein, Zugänge müssen funktionieren, CSV-Dateien zum ausgewählten Format passen und Kundenreferenzen verfügbar sein.

Ich betrachtete diese Voraussetzungen als Teil des Ablaufs. Daraus ergeben sich konkrete Prüfungen und Rückmeldungen: Fehlt eine Verbindung? Ist für den Ressourcentyp ein Field-Mapping vorhanden? Gibt es einen Primärwert, über den das Asset erkannt werden kann?

Eine einzelne Asset-Übertragung prüft unter anderem diese Bedingungen. Bei der Übertragung eines ganzen Kunden werden Ressourcen ohne geeignete Voraussetzungen übersprungen. Fehler einzelner Ressourcen werden gesammelt, während weitere Ressourcen verarbeitet werden können.

Auch die Auswahl des Zielsystems gehört zu diesen Anforderungen. HALO connect verwaltet mehrere benannte HALO-Verbindungen mit Umgebungskennzeichnung und Status. Die Anmeldung erfolgt über Microsoft Entra ID; Azure Key Vault ist für Zugangsdaten eingebunden. Ob eine Übertragung an das richtige Ziel geht, hängt weiterhin von der korrekt eingerichteten und ausgewählten Verbindung ab.

Erwartetes Verhalten überprüfbar beschreiben

Die fachlichen Anforderungen lassen sich an konkreten Anwendungsfällen prüfen. Aus der vorhandenen Implementierung ergeben sich beispielsweise folgende Kriterien:

Anwendungsfall

Erwartetes Verhalten

Unterstützte CSV-Datei hochladen

Pflichtspalten werden geprüft; ein ungültiges Format führt zu einer verständlichen Rückmeldung.

Neues Asset übertragen

Bei gültiger Kundenzuordnung, passenden Mappings und unbekanntem Primärwert wird ein Asset angelegt.

Vorhandenes Asset erneut übertragen

Ein über den Primärwert erkanntes, gültiges Asset wird aktualisiert.

Einzelnes Asset ohne Primärwert übertragen

Die Übertragung wird mit einer Fehlermeldung abgelehnt.

Kundenbestand mit fehlendem Mapping übertragen

Betroffene Ressourcen werden übersprungen und im Ergebnis berücksichtigt.

Fehler bei einer Ressource

Das Ergebnis enthält Informationen zur betroffenen Ressource.

Azure-Bestand erneut erfassen

Ein erneuter Scan ist möglich; ein Zeitpunkt für den Ressourcen-Scan wird vorgehalten.

Solche Kriterien verbinden die Erwartung des Kunden mit prüfbarem Verhalten. Sie helfen außerdem bei Umfangsentscheidungen: Welche Fälle muss der Ablauf abdecken? Welche Ausnahmen brauchen eine eigene Behandlung? Welche Informationen benötigt der Anwender anschließend?

Technische Entscheidungen am Arbeitsablauf ausrichten

Das Frontend basiert auf Next.js, React und TypeScript. Das Backend verwendet Python mit FastAPI. PostgreSQL speichert unter anderem Kunden, Ressourcen, Mappings und Importvorgänge. Docker Compose und Traefik sind für die Bereitstellung vorgesehen.

Die Aufteilung unterstützt den Ablauf: Die Oberfläche führt durch Auswahl und Konfiguration, das Backend verarbeitet die Daten, und gespeicherte Mappings sowie Ergebnisse bleiben für weitere Vorgänge verfügbar.

Eine Weiterentwicklung betraf die CSV-Verarbeitung. Diese wurde von einer früheren n8n-Webhook-Verarbeitung auf die direkte Verarbeitung im Backend umgestellt. Die aktuelle Upload-Route nutzt diesen Weg; ältere Webhook-Methoden sind als Legacy-Code erhalten.

Damit liegen Verarbeitung und Ergebnisbehandlung innerhalb der Anwendung und lassen sich dort gemeinsam weiterentwickeln. Aussagen zu eingesparten Betriebskosten oder höherer Geschwindigkeit würden zusätzliche Messungen erfordern.

Die sichtbare Entwicklungshistorie von Februar bis August 2026 enthält außerdem Anpassungen an Verbindungen, Authentifizierung, CSV-Headern, Mappings, Suche, Pagination, Azure-Übertragungen und Bereitstellung. Diese Arbeiten zeigen, wie sich der Umfang über die reine Datenübertragung hinaus auf Bedienbarkeit und betriebliche Voraussetzungen erstreckte.

Ergebnis und weitere Entwicklung

HALO connect führt mehrere Integrationsaufgaben in einer Anwendung zusammen. Anwender können drei unterstützte CSV-Formate importieren, Azure-Kunden und Ressourcen erfassen, Zuordnungen pflegen und Übertragungen gezielt auslösen.

Bestehende Assets werden anhand eines Primärwerts erkannt. Die Ergebnisse unterscheiden zwischen Neuanlage, Aktualisierung, übersprungenen Ressourcen und Fehlern. Dadurch wird sichtbar, welche Schritte abgeschlossen sind und wo weitere Arbeit erforderlich ist.

Das Projekt zeigt meine Arbeitsweise bei offenen Kundenanforderungen: Ich kläre den benötigten Ablauf, übersetze ihn in fachliche Regeln, ordne die Abhängigkeiten und setze daraus eine Anwendung um. Kundenabstimmung, Umfangsentscheidungen und Entwicklung bleiben dabei eng miteinander verbunden.

Für die weitere Entwicklung wären Daten aus dem tatsächlichen Einsatz der nächste Maßstab: Bearbeitungszeit je Import, Anteil korrekt zugeordneter Ressourcen, Ursachen für übersprungene Datensätze und Aufwand für Nacharbeit. Daraus ließen sich die nächsten Verbesserungen nach ihrer Wirkung im Arbeitsalltag priorisieren.

Der Kunde bleibt anonym. Diese Darstellung stützt sich auf die geschilderten Problemfelder, die vorhandene Implementierung und die sichtbare Entwicklungshistorie. Anforderungen und Prüfkriterien sind daraus abgeleitet; sie bilden keine ursprüngliche Anforderungs- oder Abnahmedokumentation ab. Belegt ist der beschriebene Funktionsumfang. Ein produktiver Rollout sowie Zeitersparnis und Fehlerreduktion sind damit allein nicht nachgewiesen.