Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- draft:slonwiki:eic:diagnose_konfiguration [08.11.2026 20:58] – [DRAFT] Konfigurationsabschnitte mit den tatsächlichen Feldern der Oberfläche florian
+++ draft:slonwiki:eic:diagnose_konfiguration [08.11.2026 21:00] (aktuell) – Draft published, cleaning up florian
@@ Zeile 1: / Zeile 1: @@
-====== Diagnose- und Konfigurationsseite des SLON EIC ======
-SLON EIC bringt eine eigene Weboberfläche mit, die direkt am Server im Browser aufgerufen wird. Sie hat zwei Aufgaben:
-  * **Status und Fehlersuche** – auf einen Blick sehen, ob die Schnittstelle funktioniert, und bei einem Problem erfahren, was zu tun ist.
-  * **Konfiguration** – die Einstellungen des SLON EIC im Browser ansehen und ändern, statt die Konfigurationsdatei von Hand zu bearbeiten.
-Damit lassen sich die meisten Probleme ohne Anruf beim SLON Support erkennen und beheben.
-<callout type="info" title="Verfügbar ab Version 1.5.0" icon="true">
-Die Diagnose- und Konfigurationsseite ist ab SLON EIC Version 1.5.0 enthalten und nach der Installation automatisch eingeschaltet.
-</callout>
-{{draft:wiki:pasted:todo_screenshot_eic_diagnose_status.png}}
-===== Seite aufrufen =====
-Öffnen Sie auf dem Computer, auf dem SLON EIC installiert ist, im Browser die Adresse:
-<code>
-http://localhost:5099
-</code>
-Die Seite ist standardmäßig **nur auf diesem Computer** erreichbar. Rechts oben wählen Sie die Sprache (Deutsch, Italienisch, Englisch) und ob sich die Anzeige automatisch aktualisieren soll.
-<callout type="warning" title="Zugriff von anderen Rechnern" icon="true">
-Soll die Seite auch von anderen Rechnern im Netzwerk erreichbar sein, muss in der Konfiguration eine Netzwerkadresse eingetragen **und** ein SLON EIC Passwort gesetzt sein – ohne Passwort startet die Seite in diesem Fall nicht. Zusätzlich muss der Port in der Windows-Firewall freigegeben werden; das erledigt die Installation bewusst nicht automatisch. Die Seite ist dann für alle Benutzer nur mit diesem Passwort zugänglich.
-</callout>
-===== Tab „Status“: Probleme erkennen und beheben =====
-Der Tab **Status** zeigt den aktuellen Zustand der Schnittstelle:
-^Bereich ^Was Sie dort sehen ^
-|**Was ist zu tun?** |Alle aktuellen Probleme, jeweils mit einem konkreten Lösungshinweis. Ist alles in Ordnung, bleibt dieser Bereich leer. |
-|**SLON-Plattform** |Ob die Anmeldung funktioniert – zum Beispiel „Zugangsdaten falsch“, „Rolle EIC fehlt“ oder „nicht erreichbar“ –, wann zuletzt erfolgreich Kontakt bestand, sowie Echtzeitkanal und Proxy. |
-|**Warteschlange** |Wie viele Aufträge noch nicht an SLON übertragen wurden und seit wann der älteste wartet; außerdem Aufträge, die SLON abgelehnt hat. |
-|**Schnittstellen** |Datei-Import, REST-Schnittstelle, Webhook und Export mit Ordner bzw. Adresse und letzter Aktivität. Erkannt werden unter anderem fehlende Ordner, ein bereits belegter Port und Dateien, die im Importordner liegen geblieben sind. |
-|**Aktivitäten** |Die letzten Vorgänge, filterbar nach OK, Probleme und Fehler, nach Bereich und per Suchtext – etwa nach Ihrer Belegnummer oder der SLON-ID. Ein Klick auf einen Eintrag zeigt die technischen Details. Die Aktivitäten bleiben auch nach einem Neustart des Dienstes erhalten. |
-|**Service-Log** |Das Ende der Protokolldatei des Dienstes. |
-<callout type="info" title="Diagnosebericht für den Support" icon="true">
-Über **„Diagnosebericht herunterladen“** erzeugen Sie eine Textdatei mit Status, Aktivitäten und Protokoll. Passwörter und Schlüssel sind darin automatisch entfernt. Bitte senden Sie diese Datei bei jeder Support-Anfrage zum SLON EIC mit – das verkürzt die Fehlersuche erheblich.
-</callout>
-===== Tab „Konfiguration“: SLON EIC im Browser einrichten =====
-Im Tab **Konfiguration** sehen Sie die aktuellen Einstellungen des SLON EIC – ohne Passwörter. Mit dem **SLON EIC Passwort** können Sie die Einstellungen auch bearbeiten und speichern.
-{{draft:wiki:pasted:todo_screenshot_eic_diagnose_konfiguration.png}}
-Bearbeitet werden können:
-^Abschnitt ^Einstellungen ^
-|**SLON-Plattform** |Server-Adresse, Benutzer (EICUser@sloncompany_<Betriebs-ID>), neues SLON-Passwort |
-|**Datei-Import (Excel)** |Importordner, Dateifilter, Backup-Ordner, Aufbau der Transporteinheiten und Zuordnung der Spalten zu den Feldern in SLON |
-|**Export (Rechnungsdaten)** |Exportdatei, Report-ID, MwSt.-Satz und Auslöser des Exports (z. B. Intervall oder fester Tag und Uhrzeit im Monat) |
-|**REST-Schnittstelle (ERP)** |Adresse, API-Key und Webhook-URL für die Anbindung Ihres ERP-Systems |
-|**Diagnoseseite** |Seite ein/aus, Adresse, Anzahl gespeicherter Aktivitäten, Anzeige des Service-Logs |
-==== So ändern Sie die Konfiguration ====
-  - Öffnen Sie den Tab **Konfiguration** und geben Sie das SLON EIC Passwort ein. Klicken Sie auf **„Entsperren“**.
-  - Ändern Sie die gewünschten Felder. Das Feld **„Neues SLON-Passwort“** lassen Sie leer, um das gespeicherte Passwort zu behalten.
-  - Klicken Sie auf **„Speichern“**. Die Eingaben werden vorher geprüft: Fehler sind markiert und verhindern das Speichern, Hinweise nicht.
-  - Starten Sie den Dienst neu – siehe unten.
-Die vorherige Konfiguration wird bei jedem Speichern automatisch gesichert (die letzten zehn Stände im Unterordner ''config-backups'' des Programmverzeichnisses). Jede Änderung erscheint mit den geänderten Feldern in den Aktivitäten. Einstellungen, die im Formular nicht vorkommen, bleiben beim Speichern unverändert erhalten. Nach 30 Minuten oder über **„Sperren“** wird die Bearbeitung wieder gesperrt.
-<callout type="warning" title="Neustart erforderlich" icon="true">
-Gespeicherte Änderungen gelten erst nach einem **Neustart des Dienstes**: Windows-Dienste (''services.msc'') → „SlonEIC“ → Neu starten, oder in einer PowerShell mit Administratorrechten ''Restart-Service SlonEIC''. Bis dahin weisen beide Tabs auf den ausstehenden Neustart hin – auch wenn die Konfigurationsdatei von Hand geändert wurde.
-</callout>
-==== SLON EIC Passwort setzen (einmalig) ====
-Nach einer Neuinstallation ist noch kein SLON EIC Passwort gesetzt; die Konfiguration kann dann nur angesehen werden. Das Passwort wird aus Sicherheitsgründen **nicht** über die Seite selbst gesetzt, sondern einmalig von Hand:
-  - Öffnen Sie die Datei ''config.json'' im Programmverzeichnis (standardmäßig ''C:\Programme (x86)\SLON EIC'') mit einem Texteditor mit Administratorrechten.
-  - Ergänzen Sie im Abschnitt ''Diagnostics'' den Eintrag ''"Password": "IhrPasswort"''.
-  - Starten Sie den Dienst neu.
-Beim Start überträgt SLON EIC das Passwort in den sicheren Speicher von Windows (Anmeldeinformationsverwaltung) und entfernt es aus der Datei – genauso wie das SLON-Passwort. Ein neues Passwort setzen Sie auf demselben Weg.
-<callout type="info" title="Zu viele Fehlversuche" icon="true">
-Nach fünf falschen Passwörtern ist die Anmeldung für fünf Minuten gesperrt.
-</callout>
-===== Wenn SLON EIC nicht startet =====
-Fehlt die Konfigurationsdatei oder ist sie fehlerhaft, arbeitet SLON EIC keine Aufträge ab, die Diagnose- und Konfigurationsseite läuft aber weiter. Sie zeigt dann, was an der Konfiguration fehlt. Wurde schon früher ein SLON EIC Passwort gesetzt, können Sie die Konfiguration direkt im Browser korrigieren.
-===== Überwachung durch Ihre IT =====
-Unter ''http://localhost:5099/api/status'' liefert SLON EIC den Gesamtstatus für Überwachungssysteme. Der HTTP-Status ist **200**, solange alles in Ordnung ist oder nur Warnungen vorliegen, und **503** bei einer Störung. Ein einfacher HTTP-Check in PRTG, Zabbix, Checkmk o. ä. genügt, um bei Problemen automatisch alarmiert zu werden.
-===== Verwandte Artikel =====
-  * [[slonwiki:eic:start|SLON EIC – Datenaustausch mit externer Software]]
-  * [[slonwiki:eic:schnittstellen|Verfügbare SLON EIC Schnittstellen]]
-  * [[slonwiki:eic:transport_beauftragen|Transportbeauftragung über SLON EIC]]
-  * [[slonwiki:referenz:support|SLON Support kontaktieren]]