Peppershop Synchronisationstool Anleitung

Transkript

1 Peppershop Synchronisationstool Anleitung Datum 02. Januar 2017 Version 1.4

2 Inhaltsverzeichnis 1. Einleitung Konfiguration Konfigurationsdatei bearbeiten Slave-Shops erfassen / verwalten Globale Konfigurationsparameter Log Viewer Modul Filter Konfiguration Nur gewisse Artikel synchronisieren Preisdaten nicht überschreiben bei Update Synchronisation Arten der Synchronisation Lagerbestand Synchronisation Installation Systemanforderungen Modulinstallation: Dateien kopieren und hochladen Master-Shop Slave-Shops Modulinstallation bestätigen Screenshots Hersteller Daten...11 INFO: Die Inbetriebnahme dieses Moduls erfordert u. U. vertiefte PHP-Kenntnisse! PepperShop wird von Glarotech entwickelt und vertrieben. Seit 1998 ist das innovative Unternehmen im Internet tätig und auf E-Commerce spezialisiert. Sie als Kunde profitieren vom direkten Draht zu den Herstellern der Produkte. Glarotech GmbH Toggenburgerstrasse 156 CH-9500 Wil info@glarotech.ch Tel. +41 (0)

3 1. Einleitung Viele Shopsysteme arbeiten mit einem Mandanten Konzept um weitere (Sub-)Shops zu verwalten. Das Mandantenkonzept hat aber seine Grenzen, vor allem, wenn es in geografisch verteilte Systeme mit unterschiedlichen Anforderungen geht. PpepperShop bietet mit dem Synchronisationstool eine Umsetzung auf Basis eines zentral verwalteten, synchronisierten Shop-Netzwerks an. Hierbei behalten die Shops im Netzwerk alle Freiheiten eines einzelnen, selbstständigen Webshops: Betrieb auf eigener Rechner Infrastruktur rechtlich völlig unabhängig agieren, z.b. mit eigenen Trust-Konzepten, rechtlichen Dokumenten und anderen Anforderungen für spezifische Einsatzzwecke in der jeweiligen geografischen Region Eigene Anbindungen verwenden und aktivieren komplett eigene Designumsetzungen, Module und Programmierungen ein eigenes Artikelsortiment mit Kundenstamm pro Shop pflegen Zusammen mit den Vorteilen der Synchronisation: Stammartikel und deren Kategorien werden übermittelt und automatisch aktualisiert Abbildung 1: Änderungen von Lagerbeständen Abbildung 2: Artikel und Kategorien Lagerbestandsänderungen werden im Shop-Netzwerk untereinander ausgetauscht (z.b. Verkäufe) 2. Konfiguration 2.1 Konfigurationsdatei bearbeiten Verwenden Sie zum Bearbeiten der Konfigurationsdatei bitte einen Editor, der UTF-8 encodierte PHP- Dateien mit UNIX Zeilenumbrüchen bearbeiten kann, z.b. Notepad++ auf Windows. Öffnen Sie folgende Datei zur Bearbeitung {shopdir}/shop/admin/synctool/shop_sync_config.php Seite 3/11

4 2.1.1 Slave-Shops erfassen / verwalten Vor der ersten Inbetriebnahme gibt es einen auskommentierten Block mit Beispielanweisungen für Slave-Shop Konfigurationen (unterhalb des Titels 'Setup der Slave-Shops'). Pro Shop muss man die MyS- QL Datenbankconnection bereitstellen: $conn = array( 'label' => 'slave1', 'host' => 'localhost', 'db-name' => 'slave1_db', 'db-user' => 'slave1_usr', 'db-passw' => 'slave1_pwd' ); $dbs->add_connection($conn); Die in roter Farbe hervorghobenen Elemente stellen die anzupassenden Bereiche dar. Bitte auch sicherstellen, dass der Block keine zwei Slashes am Zeilenanfang mehr hat (//). Nachdem die Blocks für die Slave-Shops erstellt worden sind, gibt man in folgender Zeile die Labels an. Diese Shops referenzieren das Feld 'label' der einzelnen Slave-Shop-Konfigurationsblocks und stehen für aktive Shops im Shop-Netzwerk: // Aktivierung der Slave-Shops $slaveshops = array('slave1', 'slave2', 'slave3'); Globale Konfigurationsparameter Das Synchronisationstool bietet in derselben Datei unterhalb der Slave-Shops Konfiguration noch weitere Steuerungsparameter. Konfigurationsparameter output produktebilder_pfad logpath + logfile debug_show + debug_ _senden _to _from lager_sync_nach_bestellung Beschreibung Soll die Ausgabe bei einem Synchronisationsvorgang in Plain/Text oder in HTML erfolgen. Standard = 'html' Dateipfad zu den lokal vorhandenen Produktebildern Pfad und Dateiname zur Logdatei für die Operationen Debugmeldungen aktivieren und/oder en Versand der Ergebnisse und Logfiles Lagerbestände nach Bestelleingang / -storno in alle Shops on-the-fly synchronisieren 2.2 Log Viewer Modul Es empfiehlt sich, die Logdateien des Synctools zu prüfen. Dazu kann man das kostenlose und immer mitgelieferte PepperShop Modul 'Log Viewer' installieren und benutzen: Shop-Administration Module Module verwalten Log Viewer wählen + installieren. 3. Filter 3.1 Konfiguration Ein wichtiger Bestandteil des Synchronisationstools sind die programmierbaren Filter, welche zwischen der Synchronisation der Stammdaten vom Master-Shop zum jeweiligen Slave-Shop greifen. Hierzu definiert man Filter. Seite 4/11

5 Filter werden mittels Ausprogrammierung von vorgegebenen Synchronisationstool PHP-Funktionen umgesetzt. Hierzu öffnet man die Datei {shopdir}/shop/admin/synctool/shop_sync_func.php und findet darin vier Funktionen vor: sync_artikel_insert_filter: Filterdefinition, welche unmittelbar vor dem Anlegen eines neuen Artikels in einem Slave-Shop aufgerufen wird sync_artikel_update_filter: Filterdefinition, welche unmittelbar vor dem Aktualisieren eines bestehenden Artikels in einem Slave-Shop aufgerufen wird sync_kategorie_insert_filter: Filterdefinition, welche unmittelbar vor dem Anlegen einer neuen Kategorie in einem Slave-Shop aufgerufen wird sync_kategorie_update_filter: Filterdefinition, welche unmittelbar vor dem Aktualisieren einer bestehenden Kategorie in einem Slave-Shop aufgerufen wird In jeder Funktion können Filter realisiert werden, die Daten auf dem Weg vom Master-Shop zum jeweili - gen Slave-Shop auf Basis von PHP-Logik verändern, löschen oder hinzufügen können. 3.2 Nur gewisse Artikel synchronisieren Falls gewisse Artikel in einigen Slave-Shops nicht aktiv sein sollen, kann man folgende Insert-Filter Programmierung verwenden. Die Idee dahinter ist, dass die Artikel sehr wohl synchronisiert werden, aber mit einem inaktiven Zustand (aktiv_von, aktiv_bis), siehe rot hervorgehobener Bereich: // // Funktion : sync_artikel_insert_filter // Zweck : Filterfunktion fuer Artikel, die in den Slaveshops neu eingefuegt werden. // Manipulationen (z.b. Preis ueberschreiben) koennen direkt im Artikelobjekt // durchgefuehrt werden. // Gruppe : synctool // Argumente: $artikel_obj -> Pointer auf Artikelobjekt // $slave_shop -> Label vom Slaveshop, in den der Artikel eingefuegt werden soll // $artikel_lang_arr -> Pointer auf assoziativen Array mit lokalisierten Feldern des Artikel vom Master // Rueckgabe: keine function sync_artikel_insert_filter(&$artikel_obj, $slave_shop, &$artikel_lang_arr){ // Bildlinks aufbereiten global $shop_sh_obj; // Shopsync-Objekt sichtbar machen $shop_sh_obj->getbildlinks_sync($artikel_obj); // DB-Language-Field-Spalten, die im Slave-Shop nicht existieren, aus $artikel_lang_arr entfernen $shop_sh_obj->prepare_artikel_lang_arr($artikel_lang_arr,$slave_shop); // Datenmanipulation hier einfuegen // XXX> BEGIN synctool_filter_funktionen: Gewisse Artikel als inaktiv markieren, hier mittels ZF1+2 Steuerung switch($slave_shop) { case 'slave1': // Zusatzfeld_1: Dieser Artikel ist in slave1 verfuegbar // Falls Zusatzfeld_1!= 'Y': Artikel in slave1 als deaktiviert markieren if (strtoupper($artikel_obj Zusatzfeld_1)!= 'Y') { // Artikel in slave1 deaktivieren $artikel_obj->aktiv_von = ' :00:00'; $artikel_obj->aktiv_bis = ' :00:00'; } break; case 'slave2': // Zusatzfeld_2: Dieser Artikel ist in slave2 verfuegbar // Falls Zusatzfeld_2!= 'Y': Artikel in slave2 als deaktiviert markieren if (strtoupper($artikel_obj Zusatzfeld_2)!= 'Y') { // Artikel in slave2 deaktivieren $artikel_obj->aktiv_von = ' :00:00'; $artikel_obj->aktiv_bis = ' :00:00'; } break; default; // Nichts tun bei unbekannten Slave-Shops }// End switch // <XXX } // end function sync_artikel_insert_filter Seite 5/11

6 Erklärung: In den cases werden die Synchronisationstool Slave-Shop Setup Labels der jeweiligen Shops eingegeben. In diesem Beispiel werden zwei Slave-Shops (slave1 und slave2) synchronisiert. Im Artikelzusatzfeld 1 wird für den Slave-Shop 'slave1' gesteuert, ob dieser aktiv synchronisiert wird oder nicht analoges gilt für den slave2-shop und das Artikelzusatzfeld Preisdaten nicht überschreiben bei Update Der folgende Update-Filter verhindert, dass bei einer Artikel-Aktualisierung neue Preisangaben vom Mastershop übernommen werden. Dies ermöglicht eine initiale Übermittlung des Preises und gewährt den jeweiligen Slave-Shops eine Preisfreiheit, so dass selbst Preise festgelegt werden können. Die Artikelsynchronisation erfolgt in zwei Schritten: 1. Erst-Synchronisation: Ein (neuer) Artikel wird zum ersten Mal in einen Slave-Shop übermittelt, wo er zuvor nicht existiert hat. Hierbei wird ein Datenbank-Insert verwendet und der Artikel mit seinen Komponenten wird dort neu angelegt. 2. Aktualisierung des Artikel Datensatzes: Hierbei geht es um Artikel, welche bereits im Slave-Shop existieren und nur aktualisiert werden sollen. // // Funktion : sync_artikel_update_filter // Zweck : Filterfunktion fuer Artikel, die in den Slaveshops aktualisiert (update) werden. // Manipulationen (z.b. Preis ueberschreiben) koennen direkt im Artikelobjekt // durchgefuehrt werden. Im zweiten Argument ($slave_artikel_obj) befindet sich // das mit den aktuellen Werten des Slaveshops abgefuellte Artikelobjekt. // Gruppe : synctool // Argumente: $artikel_obj -> Pointer auf Artikelobjekt // $slave_artikel_obj -> Artikelobjekt mit Daten des Artikels vom Slaveshop // $slave_shop -> Label vom Slaveshop, in den der Artikel eingefuegt werden soll // $artikel_lang_arr -> Pointer auf assoziativen Array mit lokalisierten Feldern des Artikel im Master // $slave_artikel_lang_arr -> Array mit lokalisierten Felder des Artikel vom Slaveshop // Rueckgabe: keine function sync_artikel_update_filter(&$artikel_obj,$slave_artikel_obj,$slave_shop,&$artikel_lang_arr,$slave_artikel_lang_arr){ // Bildlinks aufbereiten global $shop_sh_obj; // Shopsync-Objekt sichtbar machen $shop_sh_obj->getbildlinks_sync($artikel_obj); // DB-Language-Field-Spalten, die im Slave-Shop nicht existieren, aus $artikel_lang_arr entfernen $shop_sh_obj->prepare_artikel_lang_arr($artikel_lang_arr,$slave_shop); // folgende Codesequenzen zeigen, wie einzelne Daten im Artikel-Objekt ($artikel_obj) // mit den aktuellen Werten des Artikels im Slaveshop ueberschrieben werden koennen. // Dies bewirkt, dass die Artikeldaten bei einem Update des Artikels nicht mit den Werten // aus dem Mastershop ueberschrieben werden (z.b. wenn die Preise im Slaveshop manuell // bearbeitet werden). //XXX> BEGIN synctool_filter_funktionen Preise nicht ueberschreiben // Artikelpreis nicht ueberschreiben // $artikel_obj->preis = $slave_artikel_obj->preis; // Aktionspreis nicht ueberschreiben // $artikel_obj->aktionspreis = $slave_artikel_obj->aktionspreis; // Staffelpreise nicht ueberschreiben // $artikel_obj->staffelpreise = $slave_artikel_obj->staffelpreise; // Variantenpreise nicht ueberschreiben // foreach($artikel_obj->variationen as $key => $value){ $artikel_obj->variationen[$key] = $slave_artikel_obj->variationen[$key]; } // Optionspreise nicht ueberschreiben // foreach($artikel_obj->optionen as $key => $value){ $artikel_obj->optionen[$key] = $slave_artikel_obj->optionen[$key]; } //<XXX // Datenmanipulation hier einfuegen } // end function sync_artikel_update_filter Seite 6/11

7 Erklärung: Im rot hervorgehobenen Bereich der angepassten Update-Funktion, sieht man, dass die jeweiligen Preisangaben vor der Update-Operation mit den Daten des Slave-Shops populiert werden. Somit kommt es nicht zu einer Anpassung mit neuen Masterdaten. 4. Synchronisation 4.1 Arten der Synchronisation 1. Artikel- und Kategorien vom Master-Shop zu den Slave-Shops synchronisieren: Mit Klick auf Import / Export Shop-Synchronisation Synchronisation starten, mit anschliessender Bestätigung wird diese Art der Synchronisation gestartet. Dabei werden die hinterlegten Filter für Artikel und Kategorien angewendet. 2. Lagerbestandsänderung von Artikeln im Shop-Netzwerk verteilen: Wenn in der Konfiguration des Synchronisationstools die Einstellung lager_sync_nach_bestellung = true hat, werden bei Bestellungseingängen, -stornos und Wareneingängen 1 in allen Shops Meldungen via Master-Shop an alle anderen Instanzen im Shop-Netzwerk propagiert. Die Lagerbestände bleiben somit aktuell. 4.2 Lagerbestand Synchronisation Damit diese Synchronisation aktiv ist muss mindestens einmal via Import / Export Shop-Synchronisation Synchronisation starten und anschliessender Bestätigung ein Synchronisationslauf der Artikel und Kategorien im Shop-Netzwerk stattfinden. Bei diesem Anlass wird die Steuerungseinstellung lager_- sync_nach_bestellung = true ausgewertet und in jedem am Shop-Netzwerk teilnehmenden Shop werden in der Datenbank Steuerungsinformationen für die Lagerbestand Synchronisation hinterlegt. Nach dem Initialen Datenaustausch ist diese Art der Synchronisation aktiv und wird von jedem Shop mit installiertem Synchronisationstool entsprechend berücksichtigt. Die Kommunikation der Shops folgt dem Schema: Lagerbestandsänderung in Kommunikationsweg Master-Shop Master-Shop Master-Shop Slave1 Master-Shop Master-Shop Slave2 Master-Shop Master-Shop Slaven Slave1-Shop Slave1 Master-Shop Master-Shop Master-Shop Slave2-Shop Slave2 Master-Shop Master-Shop Master-Shop Slave2 Slaven Slave1 Slaven Wie man obiger Tabelle entnehmen kann, wird immer zuerst der Master-Shop kontaktiert und aktualisiert. Danach propagiert der Master-Shop die Änderung an alle anderen Slave-Shops. Ist der Master-Shop 1 Wareneingänge werden nur via Artikel Lagerverwaltung Wareneingänge manuell erfassen synchronisiert. Importe (Caller oder Import-Tool, sowie manuelle Artikelbearbeitungen) führen nicht zu einer Synchronisierung. Seite 7/11

8 ausgehender Punkt der Kommunikation aktualisiert er ebenfalls zuerst sich selbst, denselben Mechanismus verwendend (HTTP[S]-POST / JSON / Hash-Secured). Sobald die Aktualisierung im Master-Shop via HTTP angekommen ist, geschieht die weitere Verteilung im Shop-Netzwerk mittels hinterlegter MySQL- Datenbank-Connection. Automatisch on-the-fly synchronisiert - Bestelleingänge - Bestellungsstornos - Wareneingänge über die Wareneingangsmaske 5. Installation 5.1 Systemanforderungen Manuell synchronisiert - Neu angelegte Artikel - Gelöschte Artikel - Via Import-/Export-Tool impor tierte/aktualisierte Artikel - Via Business Connector/Caller importierte/aktualisierte Artikel - Kategorienbaumänderungen - Manuelle Anpassungen via Arti kelbearbeitungsmaske Um das PepperShop Synchronisationstool in der hier beschriebenen Form einsetzen zu können wird ein PepperShop Professional oder Enterprise ab Version mit installiertem Synchronisationstool (optionales Modul) benötigt. Die Installation und Konfiguration erfordert u. U. PHP-Kenntnisse. 5.2 Modulinstallation: Dateien kopieren und hochladen Das Synchronisationstool besteht je kundenseitig und in der Administration aus einem Modul-Verzeichnis, welches man in seinen installierten PepperShop kopieren muss. Dazu entpackt man zuerst das mitgelieferte ZIP-Archiv und kopiert diese in das nachfolgend dargestellte Zielverzeichnis: {shopdir}/shop/module/synctool {shopdir}/shop/admin/synctool Verzeichnis Verzeichnis Die Dateien lassen sich einfach via (S)FTP oder SCP zum Webserver hochladen. Der Platzhalter {shopdir} steht dabei für das Shopverzeichnis auf dem Webserver, wo die Datei index.php zusammen mit der Datei README.txt zu finden ist. Je nach Shop-Typ werden verschiedene Dateien benötigt: Master-Shop Der Master-Shop verwaltet die Stammartikel, synchronisiert diese mit allen Slave-Shops und ist primärer Ansprechpartner der Shops für alle Lagerbestandsanpassun- Abbildung 3: Shop-Synchronisation Menüpunkt gen während des Betriebs. Folgende Verzeichnisse müssen in diesen Shop hochgeladen werden: {shopdir}/shop/module/synctool Seite 8/11

9 {shopdir}/shop/admin/synctool Slave-Shops Folgende Verzeichnisse müssen in jeden Slave-Shop hochgeladen werden: {shopdir}/shop/module/synctool 5.3 Modulinstallation bestätigen Nach dem Kopieren der Dateien kann man in die Shop-Administration gehen und dort ins Menü 'Import / Export' wechseln. Der Menüpunkt Shop-Synchronisation wird neu angezeigt. Ein Klick auf diesen Menüpunkt wird mit einer Infomeldung quittiert, dass das Synchronisationstool noch nicht konfiguriert worden ist. 6. Screenshots Abbildung 4: Screenshot nach aufgerufener Artikel- und Kategorien-Synchronisation Seite 9/11

10 Abbildung 5: Synchronisationstool Verwaltungsmenü Seite 10/11

11 7. Hersteller Daten Wenn im synchronisierten Shop-Netzwerk Hersteller-Daten 1 verwendet werden, so werden diese Angaben pro Artikel ab PepperShop v synchronisiert (Artikel-Code, Lieferanten-ID und Hersteller-ID). Damit eine korrekte Zuweisung in den synchronisierten Slave-Shops funktioniert, ist es aber zwin gend erforderlich, dass die Hersteller-Angaben in der entsprechenden Verwaltungsmaske über alle Shops hinweg gleich sind. Dies ist eine manuelle Aufgabe, da die Herstellerdaten selbst bislang nicht synchronisiert werden. 1 Modul: Herstellerangaben zum Artikel: Seite 11/11