TriCon / Vollupload / Bereinigung
Abgrenzung
Mit unserem Serviceangebot (TRADElube) haben wir uns zum Ziel gesetzt die Softwaresysteme verschiedenester Softwarehersteller (ERP-Systeme, Shopsysteme & weitere) untereinander zu vernetzen. So ist auch mit der Firma TriData vor bereits mehreren Jahren (2020) mehr oder weniger zufällig eine Kooperation bzw. enge Partnerschaft entstanden. Über diese Verlauf sind wir überaus glücklich, weil hier eine echte Win-Win-Situation mit dem Effekt der gegenseitigen Wertsteigerung entstanden ist.
Unser Teil des partnerschaftlichen Serviceangebots besteht darin, die Produktdaten aus TriCon (der allgemeinen Schnittstelle von TriData) mit Shopsystemen wie Shopware, WooCommerce oder Shopify zu synchronisieren und umgekehrt die Bestellungen und Aufträge. TriCon (ein Produkt der Firma TriData) ist also eine ganz allgemeine Schnittstelle (Technologie: SOAP), die man als Drittanbieter an-programmieren kann. TriCon selber überträgt aber keine Daten zu Onlineshops, bzw. zu dritten Softwareanbietern. Diese sehr umfangreiche Erweiterung übernimmt TRADElube als Drittanbieter-Service.
Unser Einflussbereich beginnt daher bei der Vernetzung mit der TriCon. Absolut keinerlei Einfluss haben wir hingegen darauf, was zwischen TriData und TriCon passiert. Passen die Daten in der TriCon also mal nicht mit den in der WaWi (TriData) gespeicherten Daten zusammen, dann gibt es absolut keine Möglichkeit für TRADElube dies zu erkennen. TRADElube synchronisiert die Daten zuverlässig und voll-automatisch mit der TriCon und das ist auch dann absolut folgeRICHTIG wenn die Daten in der TriCon mal nicht mit der WaWi synchron sind.
TriCon Vollupload erklärt
Die Datenabgleich von TriData nach TriCon erfolgt nicht voll-automatisch.
Eine Ausnahme sind die Lagerbestände und die Aufträge, sofern dies entsprechend konfiguriert ist. Bei den Lagerbeständen gilt, nur wenn die Produkt in der TriCon existieren und die Produktnummer darf dann nicht geändert werden.
Folgende Fälle erfolgen generell NICHT automatisch:
- Existierende (bzw. ausverkaufte!) Produkte werden gelöscht (wenn die Internetfreigabe in TriData entfernt wird)
- Neue Produkte werden angelegt (wenn die Internetfreigabe in TriData gesetzt wird)
- Produktnummern werden geändert
Damit diese Änderungen mit der TriCon synchronisiert werden ist immer ein sogenannter Vollupload erforderlich:
Es wurden auch weitere Fälle beobachtet (Preisanpassung, teilweise Lagerbestände etc.), wo nur durch einen Vollupload eine Datenanpassung/korrektur in der TriCon erfolgte. In vielen dieser Fälle reichte dann aber auch oft ein normaler Upload.
TriCon ist ein Produkt von TriData, wenden sie sich bei Detailfragen zur Durchführung von Uploads und Volluploads daher bitte direkt an den Service von TriData.
Was genau passiert bei einem Vollupload von TriData nach TriCon?
- Im ersten Schritt werden alle Produkte, Bilddatensätze, Attribute etc. aus der TriCon gelöscht.. D. h. die TriCon Datenbank ist dann leer..
- Im nächsten Schritt wird dann nach der Reihe alles neu angelegt. Je nach Größe des Produktsortiments kann das länger dauern.
Indirekt sind dadurch die ausverkauften Produkte dann nach dem Vollupload in der TriCon Datenbank nicht mehr vorhanden. So begründet sich wie oben beschrieben indirekt warum ein Vollupload erforderlich ist, nachdem man bei den Produkten in TriData die Internetfreigabe entfernt hat.
Da im ersten Schritt alles gelöscht wird, hat ein Vollupload das große Potential von Datenverlust, wenn dieser nicht vollständig oder nicht erfolgreich ausgeführt wird bzw. wenn dieser abbricht (z. B. wenn die Internetverbindung ausfällt). Wie wir diesem Thema in TRADElube aber durchaus gerecht werden, erfahren sie in den folgenden Kapiteln.
Wenn sie sich berechtigterweise fragen, "Warum muss ich das alles als Kunde wissen?"
Weil sich daraus, wie in den folgenden Kapiteln beschrieben, diverse Konsequenzen ableiten, die es in einem anderen Kontext gar nicht geben würde, und die man von der Komplexität her verständlicherweise nur begreifen kann, wenn man diese Wissensgrundlage hat. Und weil sich diese Konsequenzen tatsächlich auch auf die alltägliche Praxis auswirken und mit diesem Wissen unterschiedlichst geartete Folge-Probleme optimal selbständig gemeistert werden können.
Produkte, Hersteller, Kategorien und Bilder bereinigen
Sofern sie das vorherige Kapitel "TriCon Vollupload erklärt" nicht gelesen haben, würden wir das an dieser Stelle nochmal ausdrücklich empfehlen. Dies ist Voraussetzung, damit sie folgende Notwendigkeit in diesem Kapitel verstehen können:
Warum in TRADElube eine Bereinigung der aus TriCon synchronisierten Produktsortimentsdaten NICHT automatisch durchgeführt wird, sondern nur MANUELL durchgeführt werden kann?
An dieser Stelle sei erwähnt, der Begriff "MANUELL" ist vielleicht etwas übertrieben. Es ist nicht erforderlich, dass man die Daten alle einzeln bereinigt oder löscht. Eher ist damit gemeint, dass der Bereinigungsvorgang vom Benutzer kontrolliert als ganzes manuell gestartet werden muss. Der Rest läuft automatisch. SEMI-AUTOMATISCH wäre daher wahrscheinlich ein besserer Begriff.
Was ist nun die Begründung?
Die Bereinigung funktioniert so (und kann in diesem Kontext auch nur so funktionieren), dass alle Produkte, die ursprünglich aus TriCon synchronisiert wurden, nun aber nicht mehr in TriCon existieren, gelöscht werden. Soweit so simple.
Wenn aber nun ein Vollupload von TriData nach TriCon aus irgendwelchen Gründen abgebrochen wurde (erinnern sie sich: TriCon löscht erst alles), oder TriCon aus anderen technischen Gründen einige oder sogar alle Produkte fälschlicherweise nicht mehr listet, dann hat dies zur Folge bzw. es ist dann auch folgeRICHTIG wenn TRADElube diese Produkte löscht, konsequenterweise auch aus dem Onlineshop.
Ganz zu Anfang ist es tatsächlich auch zu diesen Vorfällen gekommen, und wenn die Datenpflege nicht vollständig WaWi-seitig sondern auch teilweise Shop-seitig durchgeführt wird, gehts dabei auch um großen Datenverlust. Als wir also auf diese Zusammenhänge und Funktionsweise von TriCon aufmerksam wurden, hatten wir uns daher entschieden, dass die Bereinigung aus den genannten Gründen nicht mehr voll-automatisch durchgeführt werden kann.
Wie wird die Bereinigung nun in TRADElube durchgeführt?
Bis zur Version 1.2.0.x gibt es dafür eine eigene Aufgabe "TriData Produkte Bereinigen". Führen sie die Aufgaben über die Schaltfläche "Ausführen" aus. Ab der Version 1.2.1.x fällt diese Aufgabe weg. Führen sie in diesem Fall stattdessen die Aufgabe "TriData Produkte Herunterladen" einmal vollständig manuell aus.
Am Ende der Ausführung erhalten sie dann nacheinander, falls erforderlich, Dialoge zum Löschen von Produkten, Kategorien, Herstellern und Bildern. Beachten sie dabei das Eingabefeld rechts neben dem Feld „Freischalten“. Hier müssen sie den angezeigten Code eingeben, damit die „Ja“ Schaltfläche freigeschaltet wird. Dies ist eine Sicherheitsvorkehrung. Bitte geben sie die Bereinigung nur frei, wenn die angezeigte Anzahl an betroffenen Datensätzen mit ihrer Erwartung übereinstimmt, denn aus weiteren Systemen (z. B. dem Onlineshop) werden dieses Daten dann auch wieder voll-automatisch und ohne weitere Rückfrage gelöscht.
Produkte werden TROTZDEM AUTOMATISCH AKTIVIERT und DEAKTIVIERT:
Da das obige Vorgehen etwas umständlich sein kann, werden Produkte aber automatisch aktiviert und falls diese gelöscht wurden (also in der TriCon nicht mehr vorhanden sind), immer auch voll-automatisch deaktiviert. Das ist auch eher unproblematisch in Bezug auf Datenverlust. Deaktivierte Produkte sind dann also in ihrem Shop-Frontend für ihren Endkunden nicht mehr sichtbar, was dann ja letztenlich denselben gewünschten Effekt hat als eine richtige Bereinigung, wo Produkte ganz gelöscht werden. Voll-Automatisch im Sinne von TRADElube zu und von TriCon. Der Vollupload von TriData nach TriCon bleibt dabei dennoch ein manuelles Erfordernis.
Weitere Mechanismen gegen Datenverlust
Auch durch die manuell abgesicherte Bereinigungsfunktion (im Kontext der TriCon Anbindung) ist man gegen Datenverlust immer noch nicht vollständig abgesichert. Z. B. wenn bei einem Vollupload von TriData nach TriCon zwar die Produkte vollständig synchronisiert wurden, dann aber bei den Produktbildern oder Produktattributen ein Abbruch auftritt (für das nötige Hintergrundwissen lesen sie bitte unbedingt das Kapitel "TriCon Vollupload erklärt").
Dieser Vorgang lässt sich zwar wieder korrigieren mit einem erneuten und erfolgreichen Vollupload von TriData nach TriCon, dennoch ist es ärgerlich, wenn hier TRADElube vorrübergehend (es sei angemerkt durch folgeRICHTIGE Synchronisierung) alle Produktbilder aus den Produkten entfernt und der Shop daher vorrübergehend keine Produktbilder mehr für den Endkunden anzeigt.
Daher haben wir für diesen Anwendungsfall ein weiteres Alarmsystem integriert. Dies funktioniert so, indem TRADElube die Anzahl Datensätze aus TriCon in allen Bereichen intelligent überwacht und Alarm schlägt, sobald sich eine Datensatzanzahl von einem auf's nächste mal um mindestens 20 % verringert.
Es ist selbsterklärend, dass so ein Überwachungssystem natürlich auch einen Fehlalarm auslösen kann, wenn diese Menge an Daten tatsächlich absichtlich aus dem Produktsortiment entfernt wurde. Für diesen Fall führen sie bitte die Aufgabe "TriData Produkte Herunterladen" einmal manuell aus, dann erhalten sie die Möglichkeit, diesen Alarm über die Schaltfläche "Fortsetzen" zu quittieren.
Beachten sie: Solang der Alarm aktiv ist, ist die Synchronisierung in diesem Bereich vollständig außer Betrieb.
Troubleshooting FAQ
In den Kapiteln oberhalb haben sie einiges über die Herausforderungen zu der TriCon-Integration erfahren und welche aufwendigen Maßnahmen in TRADElube, für einen möglichst reibungslosen Ablauf, getroffen wurden. Sie haben auch die Gründe erfahren, wieso die Bereinigung des Produktsortiments im Kontext von TriCon nicht voll-automatisch erfolgt.
Daraus können wiederrum weitere Nebeneffekte folgen, die in diesem Kapitel beispielhaft als FAQ thematisiert werden.
Fehler mit unterschiedlichen Produktnummern bei Lagerbeständen
Die Synchronisierung in TRADElube identifiziert Datensätze intern über die Datensatz-Ids aus TriCon. Die Produktnummer ist für die Zuordnung NUR relevant, wenn das Produkt das erste mal synchronisiert wird. Nur dann sucht TRADElube das erste mal, ob es denn vielleicht schon ein Produkt mit dieser Produktnummer gibt, und falls ja wird dieses Produkt wiederrum über die Interne Datensatz-Id zugeordnet. Daher ist es grundsätzlich auch vorgesehen, dass Produktnummern nachträglich in TriData bzw. TriCon auch geändert werden können.
Das über die Datensatz-Id zugeordnete Produkt bleibt trotzdem dasselbe Produkt, auch wenn sich die Produktnummer nachträglich ändert. Gehen sie also bitte umgekehrt nicht davon aus, dass sie über die Produktnummer diese Zuordnung verändern könnten, das ist NICHT der Fall.
Zurück zum Thema. TRADElube macht Plausibilitätsprüfungen, und es kommt zu folgender Fehlermeldung, wenn es Unstimmigkeiten mit der Produktnummer gibt, wenn diese also nicht mehr zusammenpasst. Die Produktnummern werden nur von der Aufgabe "TriData Produkte Hochladen" synchronisiert. Bei der Aufgabe "TriData Lagerbestände Herunterladen" kommt es zu folgender Fehlermeldung, wenn TriCon hier eine abweichende Produktnummer liefert.
An dieser Stelle sind wir wieder beim Thema "Vollupload von TriData nach TriCon", da es folgendermaßen zu diesem Zustand kommt
- Produktnummern werden in TriData geändert.
- Einen Vollupload nur für "Artikel" ABER NICHT für "Bestand" wird durchgeführt.
Das Ergebnis ist, dass sich die Produktnummern in TriCon bei den Produkten und Lagerbeständen unterscheiden, da hier scheinbar auch die Produktnummer redundant gespeichert werden.
Führen sie also, falls diese Situation und dieses Vorgehen zutrifft, immer einen Vollupload mit Auswahl "Artikel" und "Bestand" aus.
Entstehung doppelter Produktnummern
In TRADElube und auch in den meisten Onlineshops muss eine Produktnummer eindeutig sein oder anders gesagt verschiedene Produkte dürfen NICHT eine gleiche Produktnummer haben. Ein Verstoß gegen diese Regel führt daher in TRADElube zu folgender plausiblen Fehlermeldung:
Doppelte Produktnummern können auch entstehen, wenn man nachträglich bei existierenden Produkten die Produktnummern einfach vertauscht. Von diesem willkürlichen Vorgehen raten wir auch generell ab! Lösen lässt sich dieser Konflikt, indem sie die Produkte aus TRADElube manuell löschen. Bei der nächsten Synchronisierung können diese dann wieder erfolgreich angelegt werden.
Der Zusammenhang des vorherige Szenario sollte einleuchtend sein. Hingegegen nicht mehr ganz so offensichtlich ist es wenn sie bereits synchronisierte Produkte in TriData löschen (das kann auch schon länger her sein) und nochmal neu mit der selben Produktnummer anlegen. Auch dies führt dann zu dieser Fehlermeldung. Warum? Na ja, weil man dann nicht vergessen darf, dass Produkte, aus in den obigen Kapiteln genannten Gründen, nicht automatisch bereinigt werden, und ein Produkt identifiziert sich über seine Interne unveränderbare Id und nicht über die Produktnummer. Das mittlerweile gelöschte Produkt existiert also dann immer noch in TRADElube.
Das Ausführen der Produktbereinigung hilft dann also zur Lösung dieses Konflikts.
Diverse Fehlermeldungen verschwinden nicht
Wenn sie sich wundern, warum Fehlermeldungen in TRADElube nicht verschwinden, obwohl sie die Anweisungen der Fehlermeldung bereits befolgt haben bzw. entsprechende Korrekturen in TriData vorgenommen haben.
Z. B. konkret ein Produktbild in TriData umbenannt oder entfernt haben.
Dann reicht es oft nicht, dass ein Vollupload ausgeführt wird. Bedenken sie dabei ebenfalls das aus guten Gründen im Kontext von TriCon die Bereinigung nicht automatisch erfolgt und die alten Bilder daher nicht automatisch gelöscht wurden.