OmniSeller.ini Referenz
OmniSeller.ini Referenz
Die OmniSeller.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 |
Secret
|
GUID | – | Installations-Secret für API-Authentifizierung |
Heartbeat
|
0/1 | 0 | Azure Service Bus Heartbeat aktivieren |
Endpoint
|
String | (intern) | Optionaler Custom Service Bus Endpoint |
Beispiel:
[OmniSellerAPI]
BaseURL = https://api.omnisellerservices.de
Secret = 12345678-1234-1234-1234-123456789abc
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 |
TrackKHKArtikelLagerbewegungen
|
KHKArtikelLagerbewegungen | Lagerbewegungen |
TrackKHKArtikelStueckliste
|
KHKArtikelStueckliste | Stücklisten |
TrackHTKOmniAlternativeSKU
|
HTKOmniAlternativeSKU | Alternative SKUs |
TrackOHTKSyncData
|
oHTKSyncData | Sync-Daten |
TrackOHTKSyncDataClient
|
oHTKSyncDataClient | Client-Sync-Daten |
Beispiel für Preis-Tracking:
[ChangeTracking]
Enabled = 1
IntervalMs = 5000
TrackPrices = 1
TrackKHKPreislisten = 1
TrackPriceListValidity = 1
[PortalN]
Portal-spezifische Einstellungen (N = Portal-ID).
| Schlüssel | Typ | Beschreibung |
|---|---|---|
Enabled
|
0/1 | Portal aktiviert |
Type
|
String | Portal-Typ (z.B. "Shopware6", "Magento2") |
URL
|
String | Shop-URL |
APIKey
|
String | API-Schlüssel |
APISecret
|
String | API-Secret |
Beispiel:
[Portal1]
Enabled = 1
Type = Shopware6
URL = https://meinshop.de
APIKey = SWIA...
APISecret = ...
Vollständiges Beispiel
[DatabaseSettings]
ConnectionString = Server=SQLSERVER;Database=OLDemoReweAbfD#;Trusted_Connection=True;
ConnectionStringEncrypted = 0
[Host]
Port = 10084
[OmniSellerAPI]
BaseURL = https://api.omnisellerservices.de
Secret = 12345678-1234-1234-1234-123456789abc
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
[Portal1]
Enabled = 1
Type = Shopware6
URL = https://meinshop.de
APIKey = SWIA...
APISecret = ...
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!