Differences

This shows you the differences between two versions of the page.

--- de:cobi.wms:teamzaehlerdienst [2026/02/18 12:51] – thuth
+++ de:cobi.wms:teamzaehlerdienst [2026/02/18 13:26] (current) – [6. Nachträgliche Konfiguration (appsettings.json)] thuth
@@ Line 10: / Line 10: @@
 <code sql>
-ALTER TABLE COBIWMS.COMPANIES
+ALTER TABLE COBIWMS.COMPANIES ADD (
-ADD (
 INCAPIURL VARCHAR(255),
 INCAPIKEY VARCHAR(255)
 );
 </code>
+Hinweis: Dieses SQL-Skript kann unverändert sowohl für Microsoft SQL Server als auch für SAP HANA Datenbanken verwendet werden.
 ===== 2. Installation des Windows Dienstes =====
@@ Line 72: / Line 72: @@
 Der App-User bekommt von diesem Hintergrundprozess nichts mit. \\
 Sobald die Daten erfolgreich an den Dienst übergeben wurden, kann der User in der App ohne Wartezeit direkt weiterarbeiten.
+===== 6. Nachträgliche Konfiguration (appsettings.json) =====
+Sollte es notwendig sein, die Konfiguration nach der ursprünglichen Installation anzupassen (z. B. wenn sich das SAP-Passwort ändert oder ein anderer Port für Hangfire genutzt werden soll), muss das Setup nicht erneut ausgeführt werden. \\
+Sie können die Änderungen direkt in der Konfigurationsdatei vornehmen.
+Navigieren Sie dazu in das Installationsverzeichnis des Windows-Dienstes (standardmäßig unter ''C:\COBI.wms-inventorycounting-service'' oder ähnlich) und öffnen Sie die Datei **''appsettings.json''** mit einem Texteditor (als Administrator).
+Die Konfiguration ist in verschiedene Blöcke unterteilt. \\
+Hier ist eine Übersicht der wichtigsten Felder und ihrer Funktion:
+  * Kestrel -> Endpoints -> Http -> Url: Der Port, auf dem der Dienst und das Hangfire-Dashboard laufen (Standard: ''http://0.0.0.0:61000''). Ändern Sie hier die Portnummer am Ende, falls der Standardport belegt ist.
+  * SAP -> Server: Adresse und Port des SAP-Servers.
+  * SAP -> Database: Name der SAP-Firmendatenbank.
+  * SAP -> User / Password: Die Anmeldedaten für SAP Business One.
+  * SAP -> DatabaseType: Der ausgewählte Datenbanktyp (z. B. ''dst_HANADB'' oder ''dst_MSSQL2016'').
+  * Jobs -> UpdateInventoryCountingJobCron: Das Intervall (Cron-Ausdruck) für die asynchrone Verarbeitung.
+  * Hangfire -> User / Password: Die Zugangsdaten für das Überwachungs-Dashboard.
+  * Api -> Key: Der Authentifizierungsschlüssel für die Verbindung zwischen Handscanner und Dienst.
+> **Wichtig: Umgang mit Passwörtern** \\
+> Wenn Sie ein Passwort (z. B. im Block `"SAP"` oder `"Hangfire"`) ändern möchten, tragen Sie das neue Passwort einfach im **Klartext (Plaintext)** in die ''appsettings.json'' ein. Speichern Sie die Datei und starten Sie den Windows-Dienst über die Diensteverwaltung (''services.msc'') neu. \\
+> Der Dienst erkennt beim Start automatisch, dass es sich um Klartext handelt, und **hashed** das Passwort umgehend. Wenn Sie die Datei danach erneut öffnen, sehen Sie anstelle Ihres Passworts nur noch den unleserlichen Hash-Wert.