Anleitung: Migrationstool Bestellnummer StaKIS / PV:Kompass

Dokument für: Service-Techniker und Kunden
Betrifft: Umstellung der Stahlgruber-/StaKIS-Bestellnummern auf das neue LKQ / PV:Kompass-Format in WERBAS//KSR NET

Was macht dieses Tool?

Stahlgruber hat die Artikelnummerierung auf das LKQ-System (PV:Kompass) umgestellt.
In Ihrer WERBAS//KSR NET - Datenbank sind die alten Bestellnummern hinterlegt. Dieses Tool liest eine von Stahlgruber / LKQ bereitgestellte Zuordnungsliste (CSV-Datei) und aktualisiert automatisch alle betroffenen Artikel in Ihren WERBAS//KSR NET - Datenbanken.

Es werden folgende Felder in der Artikeltabelle aktualisiert:

• Bestellnummer (BestellNr)
   

Das Tool verändert keine anderen Daten und löscht keine Artikel.

Voraussetzungen

Bevor das Tool gestartet werden kann, muss Folgendes erfüllt sein:

1. Das Tool muss auf dem WERBAS-Serverrechner ausgeführt werden – also dem Rechner, auf dem der WERBAS//KSR NET BO-Server installiert und konfiguriert ist. Nur dort liegt die benötigte Konfigurationsdatei (ConnectConfig.xml) mit den Datenbankverbindungen.
2. Ein eigener Windows-Datenbankzugriff des ausführenden Benutzers ist nicht erforderlich. Das Tool verwendet den in der ConnectConfig.xml hinterlegten SQL Server-Login.
3. Das Tool sollte außerhalb der Betriebszeiten gestartet werden, da es während des Laufs die Datenbank belastet.
    
4. Führen Sie vor dem Start der Datenmigration bitte unbedingt eine Sicherung Ihrer Datenbank durch!

Dateien vorbereiten

Den Ordner mit dem Namen StahlgruberMigration, den Sie von unserem HiDrive-Server über den Download-Link heruntergeladen und entpackt haben, speichern Sie auf dem Desktop Ihres Servers.

Dieser Ordner enthält folgende Dateien:

• Wrbs.SgMigration.exe
• EOS_Artikelzuordnung.csv  

Bedienung – Schritt für Schritt

Schritt 1: Datenbank auswählen

Führen Sie die Datei Wrbs.SgMigration.exe aus.

Nach dem Start werden alle WERBAS//KSR NET - Firmendatenbanken ermittelt. 

Dies kann einige Sekunden dauern.

In der Liste sehen Sie:

Status-Anzeigen im Überblick

Wählen Sie die zu migrierenden Datenbanken aus, indem Sie in der linken Spalte ein Häkchen setzen.
 

Klicken Sie auf „Weiter mit Lieferantenauswahl" (Schaltfläche unten rechts).

Schritt 2: Lieferanten zuweisen

Pro ausgewählter Datenbank ordnen Sie einen oder mehrere Lieferanten zu, unter denen in Ihrem System die Stahlgruber Artikel geführt werden. Nur diese Lieferanten werden bei der Migration berücksichtigt.

• Mit „+ weiteren Lieferant mappen" fügen Sie eine zusätzliche Zeile hinzu.
• Mit „×" leeren Sie eine Zeile (kein Lieferant für diese Zeile).
• Mit „⊖" entfernen Sie eine Zeile vollständig.
• Bereits in einer Zeile gewählte Lieferanten erscheinen in den anderen Zeilen der gleichen Datenbank nicht mehr zur Auswahl.
   

Klicken Sie auf „Weiter mit Zusammenfassung" (Schaltfläche unten rechts).

Schritt 3: Zusammenfassung und Start

Die Zusammenfassung zeigt:

• Anzahl der ausgewählten Datenbanken
• Anzahl der konfigurierten Lieferanten
• Gesamtanzahl betroffener Artikel (Live-Analyse aus den Datenbanken)
   

Sie haben zwei Möglichkeiten:

Möglichkeit 1: Umstellung direkt starten

Setzen Sie den Haken, dass der angezeigte Hinweis zur Kenntnis genommen wurde - und klicken Sie auf die Schaltfläche „Umstellung jetzt starten".

Die Migration beginnt sofort. Der Fortschritt wird angezeigt. Je nach Datenbankgröße kann der Vorgang mehrere Stunden dauern.

Wichtig: Starten Sie die Migration nicht während noch Mitarbeiter aktiv in WERBAS//KSR NET arbeiten! 

Möglichkeit 2: Automatische nächtliche Ausführung (Windows Task Scheduler)

Klicken Sie auf die Schaltfläche „Konfiguration exportieren". Das Tool zeigt Ihnen nun den Programmpfad an, den Sie in der Windows-Aufgabenplanung eintragen müssen.

Die automatisierte Ausführung können Sie folgendermaßen einrichten:

1. Windows-Taste drücken → „Aufgabenplanung" in das Suchfeld eingeben
2. Oben rechts die Schaltfläche „Einfache Aufgabe erstellen" auswählern
3. Die folgenden Argumente hinterlegen:
   1. Name: “Stahlgruber_Migration”
   2. Wann soll die Aufgabe gestartet werden: Einmal
   3. Startzeitpunkt:  06.04.2026 - 22 Uhr 
   4. Aktion: Programm Starten
   5. Programm: Hier den Pfad einfügen, der nach der Auswahl von “Konfiguration exportieren” angezeigt wurde.
   6. Argumente hinzufügen (optional): /silent

Der Task läuft dann automatisch und verarbeitet alle konfigurierten Datenbanken ohne Benutzerinteraktion. Das Ergebnis wird in einer Log-Datei gespeichert.

Log-Dateien einsehen

Über den Button „📂 Log-Ordner" (Schaltfläche unten links im Migrations-Tool) öffnen Sie den Ordner mit allen Log-Dateien direkt im Windows Explorer.

Pro Migrations-Durchlauf wird eine eigene Datei angelegt, z. B.:

migration_Musterbetrieb_GmbH_Stahlgruber_20250320_220001.txt

Die Log-Datei enthält eine genaue Auflistung aller aktualisierten Artikel sowie eventuelle Fehler.

Häufige Fragen

Kann ich das Tool mehrfach ausführen?
Ja. Bereits migrierte Datenbanken werden in der Auswahl angezeigt, aber nicht vorausgewählt. Sie müssen diese bewusst auswählen, um eine erneute Migration zu starten.

Was passiert, wenn die Verbindung zur Datenbank während der Migration abbricht?
Der aktuelle Migrationslauf schlägt fehl und wird als Fehler protokolliert. Bereits abgeschlossene Migrationen bleiben in der Datenbank erhalten. Das Tool setzt den Status auf „Fehler". Eine erneute Ausführung startet die Migration von Anfang an für diese Datenbank.

Es werden keine Datenbanken angezeigt.
Stellen Sie sicher, dass WERBAS//KSR NET auf dem Rechner installiert ist, auf welchem Sie die Dateien abgelegt haben.

Wie lange dauert die Migration?
Erfahrungswert: ca. 5.000 Artikel pro Sekunde. Bei 50.000 Artikeln dauert ein Lauf ca. 15–20 Sekunden. Bei mehreren Datenbanken addiert sich die Zeit entsprechend.

Support

Bei Problemen wenden Sie sich an Ihren WERBAS//KSR NET - Betreuer und legen Sie die entsprechende Log-Datei aus dem logs-Ordner bei.