OmniSeller:OmniSellerUpload ChangeTracking - Versionsgeschichte

Admin: /* Empfohlene Konfiguration für Preise */

2026-04-21T13:30:22Z

Empfohlene Konfiguration für Preise

← Nächstältere Version		Version vom 21. April 2026, 13:30 Uhr
Zeile 95:		Zeile 95:
	== Empfohlene Konfiguration für Preise ==		== Empfohlene Konfiguration für Preise ==

	Für ~~vollständiges~~ Preis-Tracking empfehlen wir:		Für ein Preis-Tracking empfehlen wir:

	<source lang="ini">		<source lang="ini">
Zeile 107:		Zeile 107:
	TrackPriceListValidity = 1 ; Preislisten die über Nacht gültig werden		TrackPriceListValidity = 1 ; Preislisten die über Nacht gültig werden
	</source>		</source>

	== Debugging ==		== Debugging ==

Admin: /* Verfügbare Tracking-Optionen */

2026-04-21T13:30:02Z

Verfügbare Tracking-Optionen

Admin am 2. April 2026 um 15:08 Uhr

2026-04-02T15:08:58Z

← Nächstältere Version		Version vom 2. April 2026, 15:08 Uhr
Zeile 5:		Zeile 5:
	== Grundkonfiguration ==		== Grundkonfiguration ==

	Alle Einstellungen erfolgen in der <code>~~OmniSeller~~.ini</code> in der Sektion <code>[ChangeTracking]</code>.		Alle Einstellungen erfolgen in der <code>OmniSellerUpload.ini</code> in der Sektion <code>[ChangeTracking]</code>.

	<source lang="ini">		<source lang="ini">
Zeile 19:		Zeile 19:
	{\| class="wikitable"		{\| class="wikitable"
	! INI-Schlüssel !! Tabelle !! Beschreibung		! INI-Schlüssel !! Tabelle !! Beschreibung
	\|-		\|-
	\| <code>TrackPrices</code> \|\| KHKPreislistenArtikel \|\| Einzelpreise in Preislisten		\| <code>TrackPrices</code> \|\| KHKPreislistenArtikel \|\| Einzelpreise in Preislisten
	\|-		\|-
	\| <code>TrackKHKPreislisten</code> \|\| KHKPreislisten \|\| Gültigkeitsänderung der Preisliste selbst		\| <code>TrackKHKPreislisten</code> \|\| KHKPreislisten \|\| Gültigkeitsänderung der Preisliste selbst
	\|-		\|-
	\| <code>TrackPriceListValidity</code> \|\| – (täglicher Check) \|\| Preislisten die über Nacht gültig/ungültig wurden		\| <code>TrackPriceListValidity</code> \|\| – (täglicher Check) \|\| Preislisten die über Nacht gültig/ungültig wurden
	\|-		\|-
	\| <code>TrackAttributes</code> \|\| oHTKAttributeEntities \|\| Artikelattribute		\| <code>TrackAttributes</code> \|\| oHTKAttributeEntities \|\| Artikelattribute
	\|-		\|-
	\| <code>TrackKHKArtikel</code> \|\| KHKArtikel \|\| Stammdaten der Artikel		\| <code>TrackKHKArtikel</code> \|\| KHKArtikel \|\| Stammdaten der Artikel
	\|-		\|-
	\| <code>TrackKHKArtikelVarianten</code> \|\| KHKArtikelVarianten \|\| Artikelvarianten		\| <code>TrackKHKArtikelVarianten</code> \|\| KHKArtikelVarianten \|\| Artikelvarianten
	\|-		\|-
	\| <code>TrackKHKArtikelLagerbewegungen</code> \|\| KHKArtikelLagerbewegungen \|\| Lagerbewegungen (für Bestandsänderungen)		\| <code>TrackKHKArtikelLagerbewegungen</code> \|\| KHKArtikelLagerbewegungen \|\| Lagerbewegungen (für Bestandsänderungen)
	\|-		\|-
	\| <code>TrackKHKArtikelStueckliste</code> \|\| KHKArtikelStueckliste \|\| Stücklisten		\| <code>TrackKHKArtikelStueckliste</code> \|\| KHKArtikelStueckliste \|\| Stücklisten
	\|-		\|-
	\| <code>TrackHTKOmniAlternativeSKU</code> \|\| HTKOmniAlternativeSKU \|\| Alternative SKUs		\| <code>TrackHTKOmniAlternativeSKU</code> \|\| HTKOmniAlternativeSKU \|\| Alternative SKUs
	\|-		\|-
	\| <code>TrackOHTKSyncData</code> \|\| oHTKSyncData \|\| Sync-Daten		\| <code>TrackOHTKSyncData</code> \|\| oHTKSyncData \|\| Sync-Daten
	\|-		\|-
	\| <code>TrackOHTKSyncDataClient</code> \|\| oHTKSyncDataClient \|\| Client-spezifische Sync-Daten		\| <code>TrackOHTKSyncDataClient</code> \|\| oHTKSyncDataClient \|\| Client-spezifische Sync-Daten
	\|}		\|}

Zeile 52:		Zeile 52:
	* Ein Artikel einer Preisliste hinzugefügt wird		* Ein Artikel einer Preisliste hinzugefügt wird
	* Ein Artikel aus einer Preisliste entfernt wird		* Ein Artikel aus einer Preisliste entfernt wird

	'''Trigger:'''		'''Trigger:'''
	* <code>TRIU_HTKSyncdata__KHKPreislistenArtikel</code> (INSERT/UPDATE)		* <code>TRIU_HTKSyncdata__KHKPreislistenArtikel</code> (INSERT/UPDATE)
	* <code>TRD_HTKSyncdata__KHKPreislistenArtikel</code> (DELETE)		* <code>TRD_HTKSyncdata__KHKPreislistenArtikel</code> (DELETE)

	'''Hinweis:''' Der Trigger reagiert nur auf '''echte''' Preisänderungen. Ein UPDATE das den gleichen Preis schreibt löst keinen Upload aus.		'''Hinweis:''' Der Trigger reagiert nur auf '''echte''' Preisänderungen. Ein UPDATE das den gleichen Preis schreibt löst keinen Upload aus.

Zeile 63:		Zeile 61:
	TrackPrices = 1		TrackPrices = 1
	</source>		</source>

	=== TrackKHKPreislisten (Preislisten-Gültigkeit) ===		=== TrackKHKPreislisten (Preislisten-Gültigkeit) ===

Zeile 70:		Zeile 67:
	* Preisliste wird aktiviert (<code>Aktiv</code> geändert)		* Preisliste wird aktiviert (<code>Aktiv</code> geändert)
	* <code>GueltigVon</code> oder <code>GueltigBis</code> geändert, sodass die Preisliste jetzt gültig/ungültig ist		* <code>GueltigVon</code> oder <code>GueltigBis</code> geändert, sodass die Preisliste jetzt gültig/ungültig ist

	'''Wichtig:''' Es werden '''alle Artikel''' dieser Preisliste zum Upload vorgemerkt.		'''Wichtig:''' Es werden '''alle Artikel''' dieser Preisliste zum Upload vorgemerkt.

Zeile 77:		Zeile 73:
	* Änderung anderer Felder die nicht die Gültigkeit betreffen		* Änderung anderer Felder die nicht die Gültigkeit betreffen
	* <code>GueltigBis</code> ändern, aber Preisliste war und bleibt gültig		* <code>GueltigBis</code> ändern, aber Preisliste war und bleibt gültig

	'''Trigger:'''		'''Trigger:'''
	* <code>TRIU_OmniSellerTrigger_KHKPreislisten</code>		* <code>TRIU_OmniSellerTrigger_KHKPreislisten</code>

	<source lang="ini">		<source lang="ini">
	[ChangeTracking]		[ChangeTracking]
	TrackKHKPreislisten = 1		TrackKHKPreislisten = 1
	</source>		</source>

	=== TrackPriceListValidity (Täglicher Gültigkeits-Check) ===		=== TrackPriceListValidity (Täglicher Gültigkeits-Check) ===

Zeile 92:		Zeile 85:
	* Welche Preislisten sind seit gestern gültig geworden? (GueltigVon erreicht)		* Welche Preislisten sind seit gestern gültig geworden? (GueltigVon erreicht)
	* Welche Preislisten sind seit gestern ungültig geworden? (GueltigBis überschritten)		* Welche Preislisten sind seit gestern ungültig geworden? (GueltigBis überschritten)

	'''Anwendungsfall:''' Eine Preisliste hat <code>GueltigVon = 2026-03-01</code>. Am 1. März werden automatisch alle Artikel dieser Preisliste hochgeladen, auch wenn niemand etwas geändert hat.		'''Anwendungsfall:''' Eine Preisliste hat <code>GueltigVon = 2026-03-01</code>. Am 1. März werden automatisch alle Artikel dieser Preisliste hochgeladen, auch wenn niemand etwas geändert hat.

Zeile 99:		Zeile 91:
	TrackPriceListValidity = 1		TrackPriceListValidity = 1
	</source>		</source>

	== Empfohlene Konfiguration für Preise ==		== Empfohlene Konfiguration für Preise ==

Zeile 114:		Zeile 105:
	TrackPriceListValidity = 1 ; Preislisten die über Nacht gültig werden		TrackPriceListValidity = 1 ; Preislisten die über Nacht gültig werden
	</source>		</source>

	== Debugging ==		== Debugging ==

Zeile 150:		Zeile 140:
	{\| class="wikitable"		{\| class="wikitable"
	! Reason !! Benötigte INI-Option		! Reason !! Benötigte INI-Option
	\|-		\|-
	\| KHKPreislistenArtikel \|\| TrackPrices = 1		\| KHKPreislistenArtikel \|\| TrackPrices = 1
	\|-		\|-
	\| KHKPreislisten \|\| TrackKHKPreislisten = 1		\| KHKPreislisten \|\| TrackKHKPreislisten = 1
	\|-		\|-
	\| KHKArtikel \|\| TrackKHKArtikel = 1		\| KHKArtikel \|\| TrackKHKArtikel = 1
	\|-		\|-
	\| KHKArtikelVarianten \|\| TrackKHKArtikelVarianten = 1		\| KHKArtikelVarianten \|\| TrackKHKArtikelVarianten = 1
	\|-		\|-
	\| KHKArtikelLagerbewegungen \|\| TrackKHKArtikelLagerbewegungen = 1		\| KHKArtikelLagerbewegungen \|\| TrackKHKArtikelLagerbewegungen = 1
	\|-		\|-
	\| KHKArtikelStueckliste \|\| TrackKHKArtikelStueckliste = 1		\| KHKArtikelStueckliste \|\| TrackKHKArtikelStueckliste = 1
	\|-		\|-
	\| HTKOmniAlternativeSKU \|\| TrackHTKOmniAlternativeSKU = 1		\| HTKOmniAlternativeSKU \|\| TrackHTKOmniAlternativeSKU = 1
	\|-		\|-
	\| oHTKSyncData \|\| TrackOHTKSyncData = 1		\| oHTKSyncData \|\| TrackOHTKSyncData = 1
	\|-		\|-
	\| oHTKSyncDataClient \|\| TrackOHTKSyncDataClient = 1		\| oHTKSyncDataClient \|\| TrackOHTKSyncDataClient = 1
	\|-		\|-
	\| HTKOmniArtikelAttribute \|\| TrackAttributes = 1		\| HTKOmniArtikelAttribute \|\| TrackAttributes = 1
	\|}		\|}

	Einträge mit deaktiviertem Reason werden automatisch aus der Queue gelöscht.		Einträge mit deaktiviertem Reason werden automatisch aus der Queue gelöscht.

Zeile 179:		Zeile 168:
	* [[OmniSeller.ini Referenz]]		* [[OmniSeller.ini Referenz]]
	* [[OmniSeller Preislogik]]		* [[OmniSeller Preislogik]]

	[[Kategorie:OmniSeller]]		[[Kategorie:OmniSeller]]
	[[Kategorie:Upload-Service]]		[[Kategorie:Upload-Service]]
	[[Kategorie:Konfiguration]]		[[Kategorie:Konfiguration]]

Admin: Die Seite wurde neu angelegt: „= OmniSeller Upload-Service: Change Tracking = Der OmniSeller Upload-Service kann Änderungen in der ERP-Datenbank automatisch erkennen und betroffene Artikel zum Upload vormerken. Dies geschieht über SQL-Trigger, die bei Datenänderungen Einträge in die `HTKOmniUploadQueue` schreiben. == Grundkonfiguration == Alle Einstellungen erfolgen in der `OmniSeller.ini` in der Sektion `[ChangeTracking]`. […“

2026-02-06T10:09:55Z

Die Seite wurde neu angelegt: „= OmniSeller Upload-Service: Change Tracking = Der OmniSeller Upload-Service kann Änderungen in der ERP-Datenbank automatisch erkennen und betroffene Artikel zum Upload vormerken. Dies geschieht über SQL-Trigger, die bei Datenänderungen Einträge in die <code>HTKOmniUploadQueue</code> schreiben. == Grundkonfiguration == Alle Einstellungen erfolgen in der <code>OmniSeller.ini</code> in der Sektion <code>[ChangeTracking]</code>. <source lang="ini"> […“

Neue Seite

= OmniSeller Upload-Service: Change Tracking =

Der OmniSeller Upload-Service kann Änderungen in der ERP-Datenbank automatisch erkennen und betroffene Artikel zum Upload vormerken. Dies geschieht über SQL-Trigger, die bei Datenänderungen Einträge in die <code>HTKOmniUploadQueue</code> schreiben.

== Grundkonfiguration ==

Alle Einstellungen erfolgen in der <code>OmniSeller.ini</code> in der Sektion <code>[ChangeTracking]</code>.

<source lang="ini">
[ChangeTracking]
Enabled = 1 ; Master-Switch (muss 1 sein damit der Worker startet)
IntervalMs = 5000 ; Prüf-Intervall in Millisekunden (Standard: 5000 = 5 Sekunden)
</source>

'''Wichtig:''' <code>Enabled = 1</code> ist Voraussetzung für alle anderen Tracking-Optionen.

== Verfügbare Tracking-Optionen ==

{| class="wikitable"
! INI-Schlüssel !! Tabelle !! Beschreibung
|-
| <code>TrackPrices</code> || KHKPreislistenArtikel || Einzelpreise in Preislisten
|-
| <code>TrackKHKPreislisten</code> || KHKPreislisten || Gültigkeitsänderung der Preisliste selbst
|-
| <code>TrackPriceListValidity</code> || – (täglicher Check) || Preislisten die über Nacht gültig/ungültig wurden
|-
| <code>TrackAttributes</code> || oHTKAttributeEntities || Artikelattribute
|-
| <code>TrackKHKArtikel</code> || KHKArtikel || Stammdaten der Artikel
|-
| <code>TrackKHKArtikelVarianten</code> || KHKArtikelVarianten || Artikelvarianten
|-
| <code>TrackKHKArtikelLagerbewegungen</code> || KHKArtikelLagerbewegungen || Lagerbewegungen (für Bestandsänderungen)
|-
| <code>TrackKHKArtikelStueckliste</code> || KHKArtikelStueckliste || Stücklisten
|-
| <code>TrackHTKOmniAlternativeSKU</code> || HTKOmniAlternativeSKU || Alternative SKUs
|-
| <code>TrackOHTKSyncData</code> || oHTKSyncData || Sync-Daten
|-
| <code>TrackOHTKSyncDataClient</code> || oHTKSyncDataClient || Client-spezifische Sync-Daten
|}

== Preisbezogene Tracking-Optionen im Detail ==

=== TrackPrices (Einzelpreise) ===

Überwacht die Tabelle <code>KHKPreislistenArtikel</code>. Ein Upload wird ausgelöst wenn:

* Ein Einzelpreis geändert wird
* Ein Artikel einer Preisliste hinzugefügt wird
* Ein Artikel aus einer Preisliste entfernt wird

'''Trigger:'''
* <code>TRIU_HTKSyncdata__KHKPreislistenArtikel</code> (INSERT/UPDATE)
* <code>TRD_HTKSyncdata__KHKPreislistenArtikel</code> (DELETE)

'''Hinweis:''' Der Trigger reagiert nur auf '''echte''' Preisänderungen. Ein UPDATE das den gleichen Preis schreibt löst keinen Upload aus.

<source lang="ini">
[ChangeTracking]
TrackPrices = 1
</source>

=== TrackKHKPreislisten (Preislisten-Gültigkeit) ===

Überwacht die Tabelle <code>KHKPreislisten</code>. Ein Upload wird ausgelöst wenn sich der '''Gültigkeitsstatus''' einer Preisliste ändert:

* Preisliste wird aktiviert (<code>Aktiv</code> geändert)
* <code>GueltigVon</code> oder <code>GueltigBis</code> geändert, sodass die Preisliste jetzt gültig/ungültig ist

'''Wichtig:''' Es werden '''alle Artikel''' dieser Preisliste zum Upload vorgemerkt.

'''Wann wird KEIN Upload ausgelöst:'''
* Änderung des Namens (<code>Bezeichnung</code>)
* Änderung anderer Felder die nicht die Gültigkeit betreffen
* <code>GueltigBis</code> ändern, aber Preisliste war und bleibt gültig

'''Trigger:'''
* <code>TRIU_OmniSellerTrigger_KHKPreislisten</code>

<source lang="ini">
[ChangeTracking]
TrackKHKPreislisten = 1
</source>

=== TrackPriceListValidity (Täglicher Gültigkeits-Check) ===

Dies ist '''kein Trigger''', sondern ein täglicher Check der prüft:

* Welche Preislisten sind seit gestern gültig geworden? (GueltigVon erreicht)
* Welche Preislisten sind seit gestern ungültig geworden? (GueltigBis überschritten)

'''Anwendungsfall:''' Eine Preisliste hat <code>GueltigVon = 2026-03-01</code>. Am 1. März werden automatisch alle Artikel dieser Preisliste hochgeladen, auch wenn niemand etwas geändert hat.

<source lang="ini">
[ChangeTracking]
TrackPriceListValidity = 1
</source>

== Empfohlene Konfiguration für Preise ==

Für vollständiges Preis-Tracking empfehlen wir:

<source lang="ini">
[ChangeTracking]
Enabled = 1
IntervalMs = 5000

; Preise
TrackPrices = 1 ; Einzelpreis-Änderungen
TrackKHKPreislisten = 1 ; Preisliste wird gültig/ungültig geschaltet
TrackPriceListValidity = 1 ; Preislisten die über Nacht gültig werden
</source>

== Debugging ==

Für die Fehlersuche bei Preis-Problemen gibt es ein spezielles Debug-Log:

<source lang="ini">
[Log]
Pricelog = 1
</source>

Dies schreibt detaillierte Informationen in <code>preislogiclog.txt</code> im Service-Verzeichnis:

* Welche Artikel in die Queue geschrieben werden
* Welche Tracking-Optionen aktiv sind
* SQL-Abfragen die ausgeführt werden
* Übersprungene Artikel und warum

== Technische Details ==

=== Queue-Verarbeitung ===

Die <code>HTKOmniUploadQueue</code> wird in Batches von maximal 500 Einträgen verarbeitet. Bei mehr Einträgen erfolgt die Verarbeitung in mehreren Zyklen (alle <code>IntervalMs</code> Millisekunden).

=== Trigger-Management ===

Die SQL-Trigger werden vom Upload-Service automatisch verwaltet:

* '''Service startet:''' Trigger für aktivierte Optionen werden eingeschaltet
* '''Service stoppt:''' Alle Trigger werden deaktiviert (verhindert Queue-Überlauf)

=== Reason-Filterung ===

Die Queue-Einträge haben ein <code>Reason</code>-Feld das angibt woher der Eintrag kommt. Der Service verarbeitet nur Einträge deren Reason zu einer aktivierten Tracking-Option passt:

{| class="wikitable"
! Reason !! Benötigte INI-Option
|-
| KHKPreislistenArtikel || TrackPrices = 1
|-
| KHKPreislisten || TrackKHKPreislisten = 1
|-
| KHKArtikel || TrackKHKArtikel = 1
|-
| KHKArtikelVarianten || TrackKHKArtikelVarianten = 1
|-
| KHKArtikelLagerbewegungen || TrackKHKArtikelLagerbewegungen = 1
|-
| KHKArtikelStueckliste || TrackKHKArtikelStueckliste = 1
|-
| HTKOmniAlternativeSKU || TrackHTKOmniAlternativeSKU = 1
|-
| oHTKSyncData || TrackOHTKSyncData = 1
|-
| oHTKSyncDataClient || TrackOHTKSyncDataClient = 1
|-
| HTKOmniArtikelAttribute || TrackAttributes = 1
|}

Einträge mit deaktiviertem Reason werden automatisch aus der Queue gelöscht.

== Siehe auch ==

* [[OmniSeller Upload-Service Installation]]
* [[OmniSeller.ini Referenz]]
* [[OmniSeller Preislogik]]

[[Kategorie:OmniSeller]]
[[Kategorie:Upload-Service]]
[[Kategorie:Konfiguration]]

← Nächstältere Version		Version vom 21. April 2026, 13:30 Uhr
Zeile 20:		Zeile 20:
	! INI-Schlüssel !! Tabelle !! Beschreibung		! INI-Schlüssel !! Tabelle !! Beschreibung
	\|-		\|-
	\| <code>TrackPrices</code> \|\| KHKPreislistenArtikel \|\| Einzelpreise in Preislisten		\| <code>TrackPrices</code> \|\| KHKPreislistenArtikel \|\| Einzelpreise in Preislisten
	\|-		\|-
	\| <code>TrackKHKPreislisten</code> \|\| KHKPreislisten \|\| Gültigkeitsänderung der Preisliste selbst		\| <code>TrackKHKPreislisten</code> \|\| KHKPreislisten \|\| Gültigkeitsänderung der Preisliste selbst
	\|-		\|-
	\| <code>TrackPriceListValidity</code> \|\| – (täglicher Check) \|\| Preislisten die über Nacht gültig/ungültig wurden		\| <code>TrackPriceListValidity</code> \|\| – (täglicher Check) \|\| Preislisten die über Nacht gültig/ungültig wurden
	\|-		\|-
	\| <code>TrackAttributes</code> \|\| oHTKAttributeEntities \|\| Artikelattribute		\| <code>TrackAttributes</code> \|\| oHTKAttributeEntities \|\| Artikelattribute
	\|-		\|-
	\| <code>TrackKHKArtikel</code> \|\| KHKArtikel \|\| Stammdaten der Artikel		\| <code>TrackKHKArtikel</code> \|\| KHKArtikel \|\| Stammdaten der Artikel
	\|-		\|-
	\| <code>TrackKHKArtikelVarianten</code> \|\| KHKArtikelVarianten \|\| Artikelvarianten		\| <code>TrackKHKArtikelVarianten</code> \|\| KHKArtikelVarianten \|\| Artikelvarianten
	\|-		\|-
	\| <code>TrackKHKArtikelLagerbewegungen</code> \|\| KHKArtikelLagerbewegungen \|\| Lagerbewegungen (für Bestandsänderungen)		\| <code>TrackKHKArtikelLagerbewegungen</code> \|\| KHKArtikelLagerbewegungen \|\| Lagerbewegungen (für Bestandsänderungen)
	\|-		\|-
	\| <code>TrackKHKArtikelStueckliste</code> \|\| KHKArtikelStueckliste \|\| Stücklisten		\| <code>TrackKHKArtikelStueckliste</code> \|\| KHKArtikelStueckliste \|\| Stücklisten
	\|-		\|-
	\| <code>TrackHTKOmniAlternativeSKU</code> \|\| HTKOmniAlternativeSKU \|\| Alternative SKUs		\| <code>TrackHTKOmniAlternativeSKU</code> \|\| HTKOmniAlternativeSKU \|\| Alternative SKUs
	\|-		\|-
	\| <code>TrackOHTKSyncData</code> \|\| oHTKSyncData \|\| Sync-Daten		\| <code>TrackOHTKSyncData</code> \|\| oHTKSyncData \|\| Sync-Daten
	\|-		\|-
	\| <code>TrackOHTKSyncDataClient</code> \|\| oHTKSyncDataClient \|\| Client-spezifische Sync-Daten		\| <code>TrackOHTKSyncDataClient</code> \|\| oHTKSyncDataClient \|\| Client-spezifische Sync-Daten
			\|-
			\| <code>TrackKHKRabattlistenArtikel</code> \|\| KHKRabattlistenArtikel \|\| Änderungen an Sage 100 Rabattlisten
	\|}		\|}