OmniSeller.ini Referenz

OmniSellerUpload.ini Referenz

Die OmniSellerUpload.ini ist die zentrale Konfigurationsdatei des OmniSeller Upload-Service. Sie befindet sich im Installationsverzeichnis des Services.

Dateiformat

Die Datei verwendet das klassische INI-Format mit Sektionen und Schlüssel-Wert-Paaren:

[Sektion]

Schluessel = Wert

Hinweis: Bei Boolean-Werten gilt: 0 = deaktiviert, 1 = aktiviert.

Sektionen

[DatabaseSettings]

Datenbankverbindung zur ERP-Datenbank (Sage 100).

Schlüssel	Typ	Standard	Beschreibung
ConnectionString	String	–	SQL Server Connection String
ConnectionStringEncrypted	0/1	0	Ob der ConnectionString verschlüsselt ist

Beispiel:

[DatabaseSettings]

ConnectionString = Server=SQLSERVER;Database=OLDemoReweAbfD#;User Id=sa;Password=geheim;

ConnectionStringEncrypted = 0

Hinweis: Der ConnectionString kann über das Setup oder den Service selbst verschlüsselt werden. Bei ConnectionStringEncrypted = 1 wird DPAPI zur Entschlüsselung verwendet.

[Host]

Netzwerk-Einstellungen für die TCP-Kommunikation.

Schlüssel	Typ	Standard	Beschreibung
Port	Integer	10084	TCP-Port für Client-Signale (z.B. vom Setup)

Beispiel:

[Host]

Port = 10084

[OmniSellerAPI]

Verbindung zur OmniSeller Cloud-API.

Schlüssel	Typ	Standard	Beschreibung
BaseURL	String	https://api.omnisellerservices.de	API-Basis-URL
-	-	–	-
Heartbeat	0/1	0	Azure Service Bus Heartbeat aktivieren
Endpoint	String	(intern)	Optionaler Custom Service Bus Endpoint

Beispiel:

[OmniSellerAPI]

BaseURL = xyz

Heartbeat = 0

Endpoint =

[ERP]

ERP-System Einstellungen.

Schlüssel	Typ	Standard	Beschreibung
Type	Integer	0	ERP-Typ (0 = Sage 100)

[Cache]

Cache-Einstellungen für Artikeldaten.

Schlüssel	Typ	Standard	Beschreibung
EnableTextCache	0/1	0	Text-Cache für Artikeltexte aktivieren
EnableLazyLoad	0/1	0	Lazy Loading für Cache aktivieren
DailyFullRefreshHour	Integer	-1	Stunde für täglichen Cache-Refresh (-1 = deaktiviert)

Beispiel:

[Cache]

EnableTextCache = 0

EnableLazyLoad = 1

DailyFullRefreshHour = 3

[Upload]

Upload-Verhalten.

Schlüssel	Typ	Standard	Beschreibung
DoStorageAreas	0/1	0	Lagerorte mit hochladen
DoXMLMediaAttributs	0/1	0	XML-Media-Attribute verarbeiten

[JsonLog]

JSON-Logging in die Datenbank.

Schlüssel	Typ	Standard	Beschreibung
RetentionDays	Integer	3	Anzahl Tage die Log-Einträge aufbewahrt werden
DropRecreateOnCleanupFail	0/1	1	Tabelle neu anlegen wenn Cleanup fehlschlägt

[Log]

Spezielle Logging-Optionen.

Schlüssel	Typ	Standard	Beschreibung
Pricelog	0/1	0	Detailliertes Preis-Debugging aktivieren

Bei Pricelog = 1 wird eine Datei preislogiclog.txt im Service-Verzeichnis erstellt mit:

• Queue-Einträge die verarbeitet werden
• Aktivierte Tracking-Optionen
• SQL-Abfragen
• Übersprungene Artikel und Gründe

[ChangeTracking]

Automatische Erkennung von Datenänderungen. Siehe auch: OmniSeller Upload-Service: Change Tracking

Schlüssel	Typ	Standard	Beschreibung
Enabled	0/1	0	Master-Switch – muss 1 sein damit Change Tracking funktioniert
IntervalMs	Integer	5000	Prüf-Intervall in Millisekunden

Tracking-Optionen

Schlüssel	Tabelle	Beschreibung
TrackPrices	KHKPreislistenArtikel	Einzelpreise in Preislisten
TrackKHKPreislisten	KHKPreislisten	Gültigkeitsänderung der Preisliste selbst
TrackPriceListValidity	–	Täglicher Check ob Preislisten gültig/ungültig wurden
TrackAttributes	oHTKAttributeEntities	Artikelattribute
TrackKHKArtikel	KHKArtikel	Artikel-Stammdaten
TrackKHKArtikelVarianten	KHKArtikelVarianten	Artikelvarianten
TrackKHKArtikelStueckliste	KHKArtikelStueckliste	Stücklisten
TrackHTKOmniAlternativeSKU	HTKOmniAlternativeSKU	Alternative SKUs
TrackOHTKSyncData	oHTKSyncData	Sync-Daten (nur Trigger als Auslöser möglich)
TrackOHTKSyncDataClient	oHTKSyncDataClient	Client-Sync-Daten (Medien)

Beispiel für Preis-Tracking:

[ChangeTracking]

Enabled = 1

IntervalMs = 5000

TrackPrices = 1

TrackKHKPreislisten = 1

TrackPriceListValidity = 1

 
Neue Funktion betreffend CrossSelling im Bereich Upload:
[Upload]
  CrossSellingOnFirstUpload=0   ; Default: kein CrossSelling beim ersten Upload
  CrossSellingOnFirstUpload=1   ; NEU: CrossSelling auch beim ersten Upload laden


Vollständiges Beispiel

[DatabaseSettings]

ConnectionString = Server=SQLSERVER;Database=OLDemoReweAbfD#;Trusted_Connection=True;

ConnectionStringEncrypted = 0

[Host]

Port = 10084

[OmniSellerAPI]

BaseURL = https://api.xxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Heartbeat = 0

Endpoint =

[ERP]

Type = 0

[Cache]

EnableTextCache = 0

EnableLazyLoad = 1

DailyFullRefreshHour = 3

[Upload]

DoStorageAreas = 0

DoXMLMediaAttributs = 0

[JsonLog]

RetentionDays = 3

DropRecreateOnCleanupFail = 1

[Log]

Pricelog = 0

[ChangeTracking]

Enabled = 1

IntervalMs = 5000

TrackPrices = 1

TrackKHKPreislisten = 1

TrackPriceListValidity = 1

TrackAttributes = 0

TrackKHKArtikel = 0

TrackKHKArtikelVarianten = 1

TrackKHKArtikelLagerbewegungen = 1

TrackKHKArtikelStueckliste = 0

TrackHTKOmniAlternativeSKU = 0

TrackOHTKSyncData = 0

TrackOHTKSyncDataClient = 0

[Upload]

DefaultLanguage = DE

Hinweise

• Nach Änderungen an der INI-Datei muss der Service neu gestartet werden
• Die Datei wird beim ersten Start automatisch mit Standardwerten erstellt
• Fehlende Schlüssel werden mit Standardwerten behandelt
• Bei verschlüsseltem ConnectionString: Nicht manuell bearbeiten!

Siehe auch

• OmniSeller Upload-Service Installation
• OmniSeller Upload-Service: Change Tracking
• OmniSeller Preislogik