Zum Inhalt
PDF

Shop Management Interface

Web-Applikation zur Ausführung und Planung von Synchronisationen.

Die installierte Versionsnummer wird direkt unter dem letzten Menüeintrag der linken Navigation angezeigt, auch in der erweiterten Ansicht.

Rahmendaten

Zur Installation wird die ess.exe benötigt. Für diese Datei ist die Config-Datei management.ini essenziell. Dieser liegt in dem gleichen Ordner wie die ess.exe Datei.

Die Datei wird beim Ausführen von ess.exe --init automatisch mit Standardwerten erstellt, sofern sie noch nicht existiert. Vor dem ersten Start müssen in der management.ini Datei einige Änderungen vorgenommen werden. Diese Config-Datei ist folgendermaßen aufgebaut.

management.ini

Die Kategorien ACTIVE und SHOPS bilden den Grundbaustein der zu ansteuerenden Shops. Je nach Wunsch können neue Shops als Keys aufgenommen oder gelöscht werden.

In der SHOPS Kategorie wird jedem Shop der Pfad zu seiner config.ini zugewiesen. Die Shop-URL wird automatisch aus der jeweiligen config.ini ([SHOP] → url) ausgelesen. Der Launcher-Pfad (ess.exe bzw. Python) wird automatisch bestimmt.


Beispiel: Einen Shop hinzufügen
[ACTIVE]
default = mostwanted

[SHOPS]
mostwanted = C:\Program Files\energy shop-sync\config.ini

Die URL des Shops (z.B. https://shop.example.de/) wird automatisch aus der hinterlegten config.ini ([SHOP] → url) ausgelesen und im Interface angezeigt.

Beispiel: Mehrere Shops
[ACTIVE]
default = local

[SHOPS]
local = conf\config.ini
mostwanted = C:\Program Files\energy shop-sync\config.ini

Weitere Kategorien sind für die Funktionsweise der Syncs notwendig und können angepasst werden.

[TIMER]

Parameter Defaultwert Beschreibung
wakeup 1300 Timer zum Abchecken der Sync-Warteschlange in Sekunden-Intervall
overtimekill 85500 Maximale Laufzeit eines Syncs in Sekunden bevor er abgebrochen wird

Synceinstellungen sind Shop-abhängig, d.h. für jeden Shop ist eine Config-Kategorie notwendig bei der der Sektionsname dem Shopnamen in Großbuchstaben entspricht.

Vom obigen Beispiel also:

[MOSTWANTED]

Parameter Defaultwert /Wert wenn Aktiv Beschreibung
debuglvl -d Debug-Level (-d=ERROR, -dd=WARNING, -ddd=INFO, -dddd=DEBUG)
-wc -wc Sync ohne Kategorien. Value frei lassen falls mit Kategorien.
-wa -wa Sync ohne Attribute. Value frei lassen falls mit Attributen.
-to -to wl Target-Option für den Sync
-we -we Sync ohne Eigenschaften. Value frei lassen falls mit Eigenschaften.
Beispiel: Shop-Einstellungen
[LOCAL]
debuglvl = -d
-wc = -wc
-wa = -wa
-we = -we
-m =
-ai =
-to = -to wl

[MOSTWANTED]
debuglvl = -dddd
-wc = -wc
-wa = -wa
-we = -we
-m =
-ai =
-to = -to wl

[SYNCRENAME]

Bestimmt die sichtbaren Dashboardkacheln und ihre Namen. Leere Werte blenden eine Kachel aus. Eigene Namen haben Vorrang vor den Standardbezeichnungen unten. Ohne [DASHBOARD]-Gruppen entspricht die Kachelreihenfolge der Reihenfolge der Einträge.

Parameter Standardbezeichnung Beschreibung
syncProductsAndPrices Artikel & Preise Überträgt Artikel und anschließend geänderte Preise; mit -a vollständig.
syncCustomersAndOrders Kunden & Bestellungen Überträgt Kundendaten und anschließend Bestellungen.
syncProducts Artikel Überträgt Artikelstammdaten in den Shop.
syncProductsAll Artikel (Vollübertragung) Überträgt Artikel unabhängig vom Änderungsdatum.
syncPrices Preise (alle) Überträgt Artikelpreise, einschließlich kundenspezifischer Preise.
syncPricesDiff Preise (geändert) Überträgt alle Preise der Artikel mit Preisänderungen; der erste Lauf ist vollständig.
syncOrders Bestellungen Übernimmt Shopbestellungen in die WinLine und gleicht Sendungsnummern ab.
syncCustomers Kunden Übernimmt Shop-Kundendaten in die WinLine und aktualisiert Kundennummern im Shop.
syncCustomersWLNumber Kundennummern Hinterlegt WinLine-Kundennummern im Shop.
syncCustomersWLtoSW Kunden an den Shop Überträgt WinLine-Kundendaten an Shopware 5.
syncCategories Kategorien Überträgt die Artikelkategorien.
syncAttr Variantenausprägungen Überträgt Ausprägungsgruppen und Werte wie Größe oder Farbe.
syncCross Artikelverknüpfungen Überträgt zugehörige Artikel, etwa Zubehör oder Alternativen.
syncBestand Lagerbestände Überträgt die verfügbaren Artikelbestände.
syncProperties Artikeleigenschaften Überträgt Eigenschaften und filterbare Merkmale der Artikel.
syncImages Artikelbilder Überträgt Artikelbilder aus dem WinLine-Archiv.
syncCompanyLogo Unternehmenslogo Überträgt die Mandantengrafik als Logo des Verkaufskanal-Themes.
syncDownloads Artikeldokumente Überträgt Artikeldokumente aus dem WinLine-Archiv.
syncTranslations Übersetzungen Überträgt mehrsprachige Artikeldaten.
syncFilteredCustomers Kundenabgleich Übernimmt Shop-Kundendaten in die WinLine und aktualisiert Kundennummern im Shop; entspricht derzeit „Kunden“.
syncOrderStatus Bestellstatus Aktualisiert den Bestellstatus im Shop.
syncShipmenttype Versand & Bestellstatus Aktualisiert Versandarten, Sendungsnummern und Bestellstatus.
syncAll Gesamtübertragung Führt mehrere Übertragungen, unter anderem Kunden, Bestellungen, Artikel und Preise, nacheinander aus.
healthCheck Systemprüfung Prüft Verbindungen und Konfiguration auf Probleme.
Beispiel: Sync-Bezeichnungen
[SYNCRENAME]
syncProductsAndPrices = Artikel & Preise
syncOrders = Bestellungen
syncImages =

Hier sind „Artikel & Preise“ und „Bestellungen“ sichtbar, „Artikelbilder“ ausgeblendet.


[DASHBOARD] und [DASHBOARDGROUP:*]

Optional. Erlaubt es, die Kacheln auf dem Dashboard in mehrere Bereiche zu gruppieren und die Reihenfolge frei festzulegen. Die erste Gruppe wird als Featured gerendert (größere Kacheln, dezent hervorgehoben). Fehlt die Sektion, werden alle aktiven Kacheln aus [SYNCRENAME] als eine flache Liste in INI-Reihenfolge angezeigt.

Sektion / Parameter Beschreibung
[DASHBOARD] groups Komma-getrennte Liste der Gruppen-IDs in Anzeigereihenfolge. Jede ID verweist auf eine Sektion [DASHBOARDGROUP:<id>].
[DASHBOARDGROUP:<id>] title Überschrift über der Gruppe. Leer = keine Überschrift (z. B. für die Featured-Zeile). Nur Gruppen mit Titel sind aufklappbar.
[DASHBOARDGROUP:<id>] keys Komma-getrennte Liste der Sync-Keys in der gewünschten Reihenfolge. * als alleiniger oder zusätzlicher Eintrag steht für „alle übrigen aktiven Keys aus [SYNCRENAME], die nicht von einer anderen Gruppe explizit beansprucht werden”. Unbekannte oder inaktive Keys werden ignoriert. Bei mehreren *-Gruppen gewinnt die erste in groups-Reihenfolge.
[DASHBOARDGROUP:<id>] collapsed Optional, Default false. Bei true wird die Gruppe initial zugeklappt dargestellt; ein Klick auf den Gruppen-Header klappt sie auf.
[DASHBOARD]
groups = featured, weitere

[DASHBOARDGROUP:featured]
title =
keys = syncProductsAndPrices, syncOrders

[DASHBOARDGROUP:weitere]
title = Weitere Synchronisationen
keys = *
collapsed = false

Mit dieser Konfiguration erscheinen oben in größeren Kacheln “Artikel & Preise” und “Bestellungen”, darunter durch eine horizontale Linie abgegrenzt alle übrigen Sync-Kacheln in [SYNCRENAME]-Reihenfolge. Mit collapsed = true lässt sich die Restgruppe initial zuklappen.


## Installation

Die management.ini wird beim Ausführen von ess.exe --init automatisch mit Standardwerten erstellt. Anschließend müssen die Shops manuell hinzugefügt werden. Dies erfolgt dadurch, dass jeder Shop in der Kategorie [SHOPS] mit seinem Namen als Key und dem Pfad zur config.ini als Value aufgenommen wird. Die Shop-URL und der Launcher-Pfad werden automatisch bestimmt.

Ist die Management.ini entsprechend erstellt worden, reicht die Ausführung von ess.exe manage runserver aus. Die Web-Applikation läuft standardmäßig auf dem Hostnamen mit dem Port 8000 und kann über jeden beliebigen Web-Browser erreicht werden. Der Port kann beim Start angepasst werden (z.B. ess.exe manage runserver 0.0.0.0:9000).

Bspw. : nerdpool:8000


## Ausführung von Synchronisationen

Das Management-Interface bietet 2 verschiedene Möglichkeiten Synchronisationen auszführen bzw. 3, letzteres ist aber über die erweiterte Ansicht erreichbar.

### 1. Live-Sync image

Auf der Startseite starten Sie eine Übertragung per Klick auf ihre Kachel. Live-Log und Fortschrittsbalken zeigen den Verlauf.

Der Punkt neben dem Kacheltitel zeigt den letzten Lauf genau dieser Übertragungsart: grün abgeschlossen, rot Fehler oder Zeitüberschreitung, blau läuft, grau unbekannt. Ohne bisherigen Lauf fehlt der Punkt. Der Tooltip zeigt Status und Zeitpunkt. „Artikel“ und „Artikel (Vollübertragung)“ werden getrennt angezeigt. Die Live-Anzeige aktualisiert den überwachten Lauf; andere Änderungen erscheinen beim Neuladen.

Custom-Startparameter

Im Startdialog können Sie Custom-Startparameter verwenden? aktivieren. Das Feld enthält den vollständigen Aufruf wie beim normalen Start: den Sync-Befehl, den Config-Pfad, das aktuelle Debug-Level und die aktiven Shop-Optionen aus der management.ini, beispielsweise -to wl. Bei „Artikel (Vollübertragung)“ ist auch die Option für die Vollübertragung vorbelegt.

Sie können diese Parameter für den einzelnen Lauf ändern, ergänzen oder entfernen. Mit Custom-Parameter starten führt den bearbeiteten Aufruf aus. Kommata trennen Befehl, Optionen und Werte; Argumente mit enthaltenen Kommata werden automatisch in doppelte Anführungszeichen eingeschlossen.

2. Geplante Syncs (Scheduler)

Über den Scheduler im erweiterten Bereich können Synchronisationen zeitlich geplant werden.

Scheduler verwalten

Job erstellen:

  1. Im Menü auf “Scheduler” klicken
  2. Bezeichnung für den Job vergeben
  3. Sync-Art auswählen (z.B. Artikel, Bestellungen)
  4. Frequenz wählen:
    • Einmalig: Einmaliger Sync zu einem bestimmten Zeitpunkt
    • Minütlich/Stündlich/Täglich: Wiederkehrender Sync im gewählten Intervall
    • Wöchentlich: Sync an bestimmten Wochentagen
  5. Optional: Parameter als freie CLI-Argumente angeben (z. B. -a für Vollsync, -wc ohne Kategorien). Mehrere Argumente werden per Leerzeichen getrennt, Quoting wird unterstützt. Eine Übersicht aller Flags liefert ess.exe --help.
  6. Startzeit festlegen und Job speichern
  7. Nachholfrist (Minuten) festlegen: So lange darf der geplante Start überschritten werden. Standard sind 15 Minuten; erlaubt sind positive ganze Zahlen. Beispiel: Bei einem Start um 00:10 Uhr und 60 Minuten Nachholfrist kann die Aufgabe bis 01:10 Uhr nachgeholt werden. Mit Unbegrenzt nachholen gilt keine zeitliche Begrenzung. Mehrfach verpasste Ausführungen werden zu einer einzelnen zusammengefasst.

Job verwalten:

  • Pausieren: Einen laufenden Job vorübergehend anhalten
  • Fortsetzen: Einen pausierten Job wieder aktivieren
  • Bearbeiten: Bezeichnung, Parameter und Nachholfrist jeder Aufgabe ändern, auch bei Wochenaufgaben. Bei einmaligen und Intervallaufgaben lässt sich zusätzlich der Zeitplan bearbeiten. Für andere Wochentage oder Uhrzeiten einer Wochenaufgabe legen Sie die Aufgabe neu an.
  • Löschen: Einen Job dauerhaft entfernen

Alle geplanten Jobs werden persistent gespeichert und überleben einen Neustart des Management Interfaces.

Standard-Zeitplan laden

Über den Button “Standard-Zeitplan laden” im Kopfbereich der Aufgabenplan-Tabelle lassen sich drei typische Hintergrundaufgaben für den aktuellen Shop mit einem Klick anlegen:

Aufgabe Sync-Art Parameter Zeitplan Nachholfrist
Artikel & Preise Mo-Fr 01:00 syncProductsAndPrices – Mo–Fr um 01:00 15 Minuten
Artikel & Preise So 01:00 syncProductsAndPrices -a Sonntag um 01:00 unbegrenzt
Bestellungen Mo-Fr 06-18 Uhr alle 15 Min syncOrders – Mo–Fr zwischen 06:00 und 18:00 alle 15 Minuten 15 Minuten

Unter der Woche läuft ein kombinierter Artikel- und Preissync inkrementell (nur Änderungen). Der Sonntags-Vollsync läuft mit -a (Artikel & Preise ohne Berücksichtigung des Änderungsdatums), damit übers Wochenende alle Daten garantiert synchron sind. Bei einem Wochenend-Reboot wird der Vollsync dank Unbegrenzt nachholen beim nächsten Start des Dienstes nachgeholt.

Bereits vorhandene Aufgaben mit identischem Namen bleiben unangetastet – das erneute Laden des Presets fügt lediglich fehlende Jobs hinzu. Soll ein bestehender Sonntags-Job auf -a umgestellt werden, muss er manuell gelöscht und das Preset erneut geladen werden.

3. Einzelsync

Über die erweiterte Ansicht kann ein einzelner Artikel per Artikelnummer synchronisiert werden.

Warteschlange

Wird ein Sync gestartet während bereits ein anderer Sync für denselben Shop läuft, wird der neue Sync automatisch in eine Warteschlange eingereiht. Sobald der laufende Sync abgeschlossen ist, wird der nächste Sync aus der Warteschlange automatisch gestartet.

Ausnahme: Bestellungen und Kunden

Bestell- und Kundensync (syncOrders und syncCustomers) laufen als Nebenprozesse parallel zu Artikel- und Preissynchronisationen. Untereinander bleiben sie wegen ihrer fachlichen Reihenfolge gesperrt; syncCustomersAndOrders bleibt exklusiv.

In der erweiterten Ansicht beendet „Kill-Prozess“ alle laufenden Synchronisationen des gewählten Shops, auch einen alleinigen Bestell- oder Kundenabruf.


Sync-Fortschritt

Während einer Synchronisation zeigt der obere Fortschrittsbereich den aktuellen Abschnitt. Bei einer Artikelübertragung werden die jeweils aktiven Abschnitte angezeigt, zum Beispiel Kategorien, Artikel ohne Ausprägungen, Artikel mit Ausprägungen, Ausprägungen, Downloads und Bilder. Nicht ausgeführte Abschnitte werden übersprungen. Nach erfolgreichem Abschluss wird der Balken vollständig gefüllt.

Darunter erscheint während eines laufenden Untervorgangs ein zusätzlicher Fortschrittsbalken. Er zeigt, welche Daten gerade verarbeitet werden. Sobald eine Schätzung möglich ist, kennzeichnet das Symbol ⏳ die Restdauer. Bei Shopware-Untervorgängen steht die verständliche Bezeichnung vor der technischen Angabe in Klammern. Diese hilft dem Support bei der Fehleranalyse. Nach Abschluss des Untervorgangs wird die Zeile automatisch ausgeblendet.

Nach einer erfolgreichen Synchronisation wird der Abschluss mit dem konfigurierten Namen der Übertragung bestätigt. Bei einem Fehler bleibt die Fortschrittsanzeige kompakt; ausführliche Informationen stehen weiterhin im Live-Log zur Verfügung.

Bei parallelen Läufen wird der aktive Fortschritt mit der höheren ID angezeigt.

Nach einem Neustart des Management-Service werden zuvor laufende Übertragungen als fehlgeschlagen markiert.

Überschreitet eine Synchronisation die maximal zulässige Laufzeit, wird sie beendet und als Zeitüberschreitung gekennzeichnet.


Eingebettete Statusseite

Unter /{shop}/status zeigt eine kompakte Seite den Übertragungsstatus des gewählten Shops, auch eingebettet in WinLine. Sie aktualisiert sich alle zehn Sekunden. Bei Verbindungsfehlern bleibt der letzte Stand mit einem Warnhinweis sichtbar.

Bereich Zugeordnete Übertragungen
Artikel Artikeldaten, Kategorien, Bestände, Eigenschaften und Medien
Preise Artikelpreise und kundenspezifische Preise
Bestellungen Bestellungen, Bestellstatus, Versand und „Kunden & Bestellungen“
Konten Kundenabgleich und Kundennummern
Weitere Systemprüfung, Gesamtübertragung und sonstige Vorgänge

Alle fünf Bereiche bleiben sichtbar, ohne bisherigen Lauf mit „Noch kein Lauf“. „Artikel & Preise“ erscheint mit demselben Laufstatus und denselben Benachrichtigungen in beiden Bereichen.

  • Statuspunkte: Je Übertragungsart zählt ihr aktueller oder letzter Lauf. Grün bedeutet abgeschlossen, blau läuft, rot fehlgeschlagen, gelb Zeitüberschreitung, grau unbekannt. Nach einem Neustart gilt ein zuvor laufender Vorgang als unbekannt.
  • Neuester Lauf: Der zuletzt gestartete Lauf steht links und ist größer, mit Häkchen bei Erfolg oder Kreuz bei Fehler. Fortschritt erscheint nur über 0 %, wenn dieser Lauf als einziger im Bereich noch läuft.
  • Gruppenfehler: Ein Fehler färbt die gesamte Kachel rot, auch wenn eine andere Übertragung zuletzt erfolgreich war. Ein erfolgreicher neuer Lauf desselben Typs ersetzt dessen Fehlerstatus.
  • Details: Mit der Maus über die Kachel fahren oder sie per Tab auswählen. Die Detailansicht zeigt Namen, Status und Zeitpunkte; Escape schließt sie.
  • Benachrichtigungen: Die Anzahl zeigt offene Meldungen. Sie können auch nach einem erfolgreichen Lauf vorhanden sein.

Im Browser führen die Kacheln zu den passenden Benachrichtigungen, der Dashboardlink zur Hauptseite. Links öffnen ein neues Fenster oder einen neuen Tab. In erkannten WinLine-/WebView2-Einbettungen werden sie ausgeblendet.

Benachrichtigungen

Unter /{shop}/notifications verwalten Sie Übertragungsfehler und Systemhinweise. Filtern Sie nach Shop, Bereich, Übertragung, betroffenen Daten und Auflösungsstatus. „Betroffene Daten“ bezeichnet beispielsweise einen Artikel; „Übertragung“ den Vorgang, bei dem die Meldung entstand, etwa die Preisübertragung.

Öffnen Sie Details für die vollständige Meldung. Übertragungsfehler können einzeln oder gemeinsam als gelöst markiert und wieder geöffnet werden. Auch Alle gefilterten als gelöst markieren betrifft nur die aktuelle Auswahl; die Filter bleiben erhalten. Identische Fehlertexte werden je betroffenem Artikel und Übertragung nur einmal angezeigt; unterschiedliche Fehlerursachen bleiben in derselben Meldung erhalten.

Gelöste Meldungen werden 30 Tage nach ihrer Auflösung automatisch gelöscht. Die Bereinigung läuft beim Start des Management Interfaces und anschließend täglich. Offene Meldungen bleiben erhalten.

Kann eine Shopware-Fehlermeldung nicht ausgewertet werden, erscheint ein Systemhinweis. Seine Details enthalten die ursprüngliche Fehlermeldung und die Daten der fehlgeschlagenen Anfrage. Geben Sie diese zur weiteren Prüfung an den Support weiter.

Systemprüfung starten prüft Verbindungen, Einstellungen und Aufgabenplanung. Eine erfolgreiche erneute Prüfung löst die zugehörigen Systemhinweise auf. Eine Vollübertragung löst nicht erneut gemeldete Fehler derselben Übertragung automatisch auf; bei der Übertragung nur geänderter Daten bleiben ältere Meldungen erhalten.

Defekte oder nicht lesbare Artikelgrafiken erscheinen mit Artikelnummer und Dateiname als Benachrichtigung. Prüfen Sie die Grafik in WinLine und hinterlegen Sie sie erneut. Die übrigen Artikel und gültigen Medien werden weiter übertragen. Vorhandene Medien von Artikeln mit defekten Grafiken werden von der automatischen Bereinigung ausgenommen.


Importdaten (EXIM)

Unter Importdaten (/{shop}/importdaten) können alle Nutzer die EXIM-Daten des gewählten Shops vor dem WinLine-Import einsehen und einzelne Datensätze löschen.

  • Personenkonten: Kontonummer beziehungsweise Kontaktnummer und Name/Firma.
  • Belege: Bestellnummer, Kontonummer, Name/Firma, Datum (sofern in der Tabelle vorhanden) und Anzahl der Positionen.

Die Suche berücksichtigt Nummern, Namen und Firmen. Die Liste zeigt höchstens 50 Datensätze je Seite. Die Trefferzahl bezieht sich auf die aktuelle Seite. Über Zurücksetzen entfernen Sie einen Suchfilter. Über die verlinkte Konto-/ Bestellnummer oder Details anzeigen öffnen Sie alle Konten- oder Belegkopffelder und bei Belegen sämtliche Positionen der Belegmitte. Nummer und Name stehen in der Detailüberschrift und nochmals im Löschbereich. Zurück zur Liste führt mit dem bisherigen Suchbegriff zur ursprünglichen Listenseite zurück. Die Felder werden auf großen Bildschirmen zweispaltig dargestellt. Breite Tabellen lassen sich innerhalb der Ansicht seitlich scrollen; bei langen Positionstabellen bleibt die Spaltenüberschrift beim Scrollen sichtbar.

Zum Löschen bestätigen Sie die Auswahl in der Detailansicht und klicken auf Konto löschen beziehungsweise Beleg mit allen Positionen löschen. Die Löschung ist endgültig. Bei einem Beleg werden Kopf und sämtliche über BELEGKEY zugeordneten Positionen gemeinsam in einer Datenbanktransaktion entfernt; schlägt ein Schritt fehl, wird die gesamte Löschung zurückgerollt.

Die Ansicht verwendet die Einstellungen der jeweiligen Shopkonfiguration: [WL] exim_customers für Konten sowie exim_order_head und exim_order_body für Belege. Bereits vorhandene Importdaten bleiben auch bei deaktiviertem EXIM-Import einsehbar. Schemaqualifizierte Tabellennamen wie dbo.EXIM_ORDERS_KOPF werden unterstützt. Der SQL-Benutzer benötigt Lese- und für Löschungen auch Löschrechte auf diesen Tabellen. WinLine-Stammdaten und bereits importierte WinLine-Belege werden durch diese Funktion nicht entfernt.

Während einer laufenden Synchronisation des Shops sind Löschungen gesperrt. Veränderte, nicht mehr vorhandene oder nicht eindeutig zuordenbare Datensätze werden nicht gelöscht; öffnen Sie in diesem Fall die Liste und die Details erneut. Die Auswahl und Löschbestätigung gelten höchstens eine Stunde. Bei Konten werden der Primärschlüssel, die Zeilenkennung ts oder die eindeutige Konto-/Kontaktnummer zur Identifikation verwendet. Bei Belegen muss BELEGKEY im Kopf eindeutig sein.

Das Löschen setzt keine Abrufsperre und verändert weder Shopstatus noch Abrufzeitstempel. Die Daten können unter den üblichen Abrufbedingungen erneut übertragen werden. Für einen sofortigen erneuten Abruf müssen gegebenenfalls Shopstatus oder Abrufzeitraum separat angepasst werden.


Scheduler-Events-Dashboard

Unter /advanced/apdashboard kann der Status aller geplanten Scheduler-Events eingesehen werden.

Angezeigte Events:

  • Hinzugefügt
  • Entfernt
  • Geändert
  • Erfolgreich ausgeführt
  • Fehlgeschlagen
  • Verpasst

Im Ausführungsprotokoll stehen der geplante Start, der Zeitpunkt der Protokollierung und der Grund für verpasste, übersprungene oder fehlgeschlagene Läufe. Der Info-Button unter Details öffnet die vollständige Fehlermeldung in einem Popup. Auch ein nicht startbarer Unterprozess, ein Fehler beim Beenden oder eine überschrittene maximale Laufzeit werden als Fehler beziehungsweise Laufzeitüberschreitung angezeigt.

Wartend bedeutet, dass ein anderer, inkompatibler Lauf noch aktiv ist und die Aufgabe in der Warteschlange liegt. Das ist noch keine erfolgreiche Ausführung. Die Warteschlange wird bei einem Dienstneustart verworfen; der gespeicherte Zeitplan bleibt erhalten.

Bei Verpasst wurde die zulässige Nachholfrist überschritten, etwa während einer Dienstunterbrechung oder bei belegten Ausführungsplätzen. Soll der Lauf auch später noch stattfinden, erhöhen Sie die Nachholfrist (Minuten) oder aktivieren Sie Unbegrenzt nachholen in der betroffenen Aufgabe. Übersprungen bedeutet, dass bereits zu viele Ausführungen derselben Aufgabe aktiv sind. Das Scheduler-Log enthält ergänzende Meldungen.


Konfigurationseditor

Über den erweiterten Bereich können Konfigurationsdateien direkt im Browser bearbeitet werden:

Route Beschreibung
/advanced/management/ management.ini bearbeiten
/advanced/settings/{shop} config.ini eines Shops bearbeiten
/advanced/mappings/{shop} Mapping-Dateien eines Shops bearbeiten

Zusätzlich können Debug-Level und Sync-Timestamps pro Shop eingestellt werden.


Log-Ansicht

Die Log-Ansicht zeigt die neuesten 100 Logdateien nach letzter Änderung und die letzten 100 Synchronisationen im Verlauf, jeweils mit dem neuesten Eintrag zuerst. Der einklappbare Bereich Log-Dateien enthält die Dateien zum Anzeigen und Herunterladen. Der Verlauf nutzt darunter die gesamte verfügbare Breite. Ältere Dateien und Verlaufseinträge bleiben gespeichert. Unvollständige Zeilen aus älteren Verlaufsdateien werden nicht als eigene Synchronisationen angezeigt.

Im Verlauf zeigt Ausführung die Art der Synchronisation und darunter den farbig markierten Status sowie den Auslöser. Start und Ende enthalten jeweils Datum und Uhrzeit einschließlich Sekunden. Der Info-Button unter Details öffnet die technische Kennung und die vollständige Fehlermeldung in einem Popup. In der Tabelle wird kein Meldungstext angezeigt. Beim Update werden vorhandene Verlaufs- und Aufgabenprotokolle automatisch übernommen. Bei älteren Einträgen kann der Abbruchgrund fehlen, wenn er damals nicht aufgezeichnet wurde.

Route Beschreibung
/logs Neueste 100 Logdateien und Verlaufseinträge
/logs/view/{file} Logdatei im Browser anzeigen
/logs/download/{file} Logdatei herunterladen