Connector einrichten

Saleswind liest deine Zahlen live aus der JTL-Wawi. Dafür läuft ein kleiner Dienst, der Connector, auf dem Rechner mit deiner Wawi-Datenbank. Er darf nur lesen und schickt die Ergebnisse verschlüsselt direkt in deinen Browser. Bei Saleswind werden keine Daten aus deiner Wawi gespeichert.

Was du brauchst

• Den Windows-Rechner, auf dem die JTL-Wawi-Datenbank liegt (meist der Wawi-Server). Er sollte dauerhaft laufen — ist er aus, sind die Übersichten leer.
• Administratorrechte auf diesem Rechner.
• Internetzugang nach außen (HTTPS). Ein Port muss nicht geöffnet werden, der Connector baut nur ausgehende Verbindungen auf.
• In Saleswind das Recht Einstellungen des Betriebs (Inhaber und Admin haben es).

Einrichten in fünf Minuten

1. In Saleswind: Einstellungen → Connector → Connector einrichten. Es erscheint ein Aktivierungscode der Form SW-XXXX-XXXX. Er gilt 48 Stunden und nur einmal.
2. Auf derselben Seite das Programm herunterladen (ZIP) und auf dem Wawi-Server entpacken.
3. saleswind-connector.exe mit Rechtsklick → Als Administrator ausführen starten. Im Browser öffnet sich der Einrichtungsassistent.
4. Den Schritten im Assistenten folgen (siehe unten).
5. Nach etwa einer Minute steht in Saleswind unter Einstellungen → Connector der Status Online. Die Übersichten füllen sich von selbst.

Im Assistenten

• Systemprüfung — Rechte, Internet und SQL Server werden geprüft.
• Aktivierungscode eingeben. Der Assistent nennt die Stelle noch „Einstellungen → JTL Integration“; gemeint ist Einstellungen → Connector.
• Datenbank — der Assistent findet die Wawi-Datenbank meist selbst, du bestätigst nur.
• Zugang — Saleswind legt einen eigenen SQL-Benutzer saleswind_readonly an, der nur lesen darf. Bei einer Standardinstallation genügt dein Windows-Administrator; sonst einmal mit dem SQL-Administrator (sa) anmelden. Das Passwort des Lesebenutzers erzeugt der Assistent selbst.
• Installation — der Connector wird eingerichtet und startet künftig automatisch mit Windows.

Was der Connector darf — und was nicht

• Er liest nur, mit einem Benutzer ohne Schreibrechte. Er kann in deiner Wawi nichts verändern.
• Besonders schützenswerte Spalten sind für ihn gesperrt: Bankverbindungen deiner Kunden, Passwörter und Zugangsschlüssel (Wawi, Shops, Marktplätze, Mailkonten).
• Jede Abfrage wird zweimal geprüft — in Saleswind und im Connector —, dass sie nur liest. Abfragen sind in Zeilen und Laufzeit begrenzt, damit die Wawi nicht gebremst wird.
• Seine Zugangsdaten liegen nur auf deinem Rechner (C:\ProgramData\SalesWind\connector.env, nur für Administratoren lesbar).
• Er meldet ab Version 2.0.5, welche Wawi-Datenbank angeschlossen ist — als Prüfsumme, ohne Inhalte. Hängt plötzlich eine andere dran (anderer Server, anderer Mandant, eine Testdatenbank), laufen keine Abfragen mehr, bis jemand aus der Verwaltung das bestätigt. → Andere Wawi-Datenbank angeschlossen

Aktualisieren

Ist eine neue Version verfügbar, steht das unter Einstellungen → Connector. Neue Version herunterladen und wie oben als Administrator starten — der Assistent erkennt die bestehende Installation, die Einstellungen bleiben erhalten.

Auf einen anderen Rechner umziehen

Unter Einstellungen → Connector einen neuen Aktivierungscode erzeugen und auf dem neuen Rechner einrichten. Der bisherige Connector verliert dabei seinen Zugang. Mit dem neuen Code legt Saleswind auch die Wawi-Datenbank neu fest — eine Bestätigung ist danach nicht nötig.

Andere Wawi-Datenbank angeschlossen

Steht unter Einstellungen → Connector in Rot Andere Wawi-Datenbank angeschlossen, meldet der Connector eine andere Datenbank als bisher — etwa nach einem Serverumzug, beim Wechsel auf einen anderen Mandanten oder wenn im Einrichtungsassistenten versehentlich eine Testdatenbank gewählt wurde. Bis zur Bestätigung zeigen Übersichten, Ziele und Berichte keine neuen Zahlen.

• War das gewollt? Dann Neue Datenbank bestätigen klicken (nur mit dem Recht Einstellungen des Betriebs). Danach laufen die Abfragen sofort wieder.
• Nicht gewollt? Den Einrichtungsassistenten auf dem Wawi-Rechner erneut starten und die richtige Datenbank wählen — sobald der Connector wieder die bisherige meldet, ist die Sperre von selbst weg.
• Zwei Dienste mit derselben Kennung heisst: Der Connector meldet abwechselnd zwei Datenbanken, meist weil er auf einem zweiten Rechner kopiert wurde. Dort den Dienst beenden und deinstallieren, dann bestätigen. Für mehrere Wawi-Datenbanken je Betrieb (etwa eine je Land) gibt es Enterprise.

Wenn etwas nicht klappt

• „Keine Administratorrechte“ — Assistent schließen, Rechtsklick auf die exe → *Als Administrator ausführen*.
• Keine Datenbank gefunden — Verbindungsdaten von Hand eintragen. Sie stehen in der JTL-Wawi unter *Hilfe → Support-Informationen*.
• „Der SQL Server erlaubt nur Windows-Anmeldung“ — im SQL Server Management Studio unter *Servereigenschaften → Sicherheit* den gemischten Authentifizierungsmodus aktivieren und den SQL-Dienst neu starten.
• Benannte Instanz wird nicht gefunden — den Dienst *SQL Server-Browser* in services.msc starten und auf *Automatisch* stellen.
• „Der Computer wurde durch Windows geschützt“ — Windows kennt die exe noch nicht. Weitere Informationen → Trotzdem ausführen. Die exe kommt nur aus Saleswind unter Einstellungen → Connector. Ab 2.0.7 ist sie signiert: Als Herausgeber steht dort Fleorant Lokaj. Steht dort „Unbekannter Herausgeber“ oder ein anderer Name, die exe nicht starten und uns schreiben. Die Meldung selbst kann bei einer neuen Signatur anfangs noch kommen, bis Windows ihr vertraut.
• Fenster geht auf und gleich wieder zu, oder die Meldung „Node.js is only supported on Windows 8.1“ — das war ein Fehler in Versionen bis 2.0.3. Unter Einstellungen → Connector die aktuelle Version herunterladen und erneut starten.
• Update bricht ab mit „EPERM: operation not permitted, copyfile …“, Version bleibt alt — die alte exe lief noch oder war gesperrt; das war ein Fehler bis 2.0.5. Assistent schließen, PowerShell als Administrator öffnen und schtasks /end /tn SalesWindConnector, dann Get-Process saleswind-connector | Stop-Process -Force und Rename-Item 'C:\Program Files\SalesWind\saleswind-connector.exe' 'saleswind-connector.exe.alt' ausführen. Danach die neue exe als Administrator starten. Ab 2.0.6 macht der Assistent das selbst.
• Einrichtung abgebrochen — die exe einfach erneut starten. Ist der Code schon eingelöst, wird er wiederverwendet.
• Aktivierungscode abgelaufen — unter Einstellungen → Connector einen neuen erzeugen.

Keine Verbindung — warum und was tun

Unter Einstellungen → Connector steht, warum die Verbindung fehlt, seit wann, und was du prüfen kannst. Darunter siehst du die letzten 7 Tage als Band (grün verbunden, gelb gestört, rot getrennt) und die letzten Unterbrechungen mit Grund. Über den Kacheln steht derselbe Grund in einer Zeile.

• Wawi-Datenbank nicht erreichbar — der Connector läuft, kommt aber nicht an die Datenbank. Läuft der SQL-Server der Wawi? Wurde das Passwort des Lesebenutzers saleswind_readonly geändert? Dann den Assistenten neu durchlaufen.
• Live-Kanal getrennt — der Connector verbindet sich selbst neu. Bleibt es dabei, die Firewall prüfen: Er braucht ausgehend HTTPS (Port 443).
• Connector beendet — mit dem Grund, den der Connector beim Beenden gemeldet hat. Ab Version 2.0.2 startet er nach 30 Sekunden von selbst neu.
• Server nicht erreichbar oder Connector gestoppt — er hat sich ohne Abschied abgemeldet: Der Server ist aus, hängt oder hat kein Internet. Gab es einen Neustart, ein Windows-Update oder eine Wartung beim Hoster?
• Zugang des Connectors ungültig — meist wurde ein neuer Aktivierungscode eingelöst. Neuen Code erzeugen und im Assistenten eingeben.

Den Connector auf dem Server prüfen und neu starten

Auf dem Server saleswind-connector.exe als Administrator starten. Der Assistent zeigt die installierte Version, ob der Connector gerade läuft, und die letzten Zeilen aus dem Protokoll. Connector neu starten startet ihn sofort wieder. Ist die Datei neuer als die installierte Version, heißt der Knopf Jetzt aktualisieren.

Das Protokoll liegt unter C:\ProgramData\SalesWind\logs\output.log — schick uns die letzten Zeilen, wenn du nicht weiterkommst.