Handbuch CHIPSIZE Shop Connect
Inhaltsverzeichnis
1. Systemvoraussetzungen 2. Installation 2.1. 2.2. 2.3. 2.4. 2.5. 2.6. 2.7.
MySQL ODBC Treiber Einrichten eines SSH Tunnels mit PuTTY MySQL ODBC Verbindung Setup Zusatzmodul installieren Einrichten des Zusatzmoduls Einrichten der Datenbankstrukturen
3. Bedienung 3.1. 3.2. 3.3. 3.4. 3.5.
Kunden Preislisten Rabattlisten Artikel Shop Connect 3.5.1. Informationen 3.5.2. Abgleich Kunden 3.5.3. Abgleich Artikel 3.5.4. Abgleich Bestellungen 3.5.5. Automatischer Abgleich 3.6. Protokoll 3.6.1. Positionen
4. Deinstallation 4.1. Zusatzmodul deinstallieren 4.2. Setup
Handbuch CHIPSIZE Shop Connect
1
Stand: 08.04.2009
Handbuch 1. Systemvoraussetzungen - Office Line 5.0 - .Net Framework 3.5 - MySQL Connector ODBC 3.5.1
2. Installation 2.1. MySQL ODBC Treiber Das Zusatzmodul „CS Shop Connect“ benutzt eine ODBC Verbindung, um Daten mit dem Shop auszutauschen. Damit das Zusatzmodul funktioniert, muss eine ODBC Verbindung eingerichtet werden. Installieren Sie zuerst einen MySQL ODBC Treiber in der Version 3.5.1. Das Setup liegt der CD im Ordner „Require“ bei. Starten Sie die Datei „mysql-connector-odbc-3.51.27win32.msi“. Klicken Sie auf „Next“. Wählen Sie „Typical“ und klicken sie auf „Next“.
Klicken Sie auf „Install“. Warten Sie bis das Setup abgeschlossen ist und klicken Sie auf „Finish“.
Der ODBC Treiber ist jetzt installiert.
Handbuch CHIPSIZE Shop Connect
2
Stand: 08.04.2009
Handbuch 2.2. Einrichten eines SSH Tunnels mit PuTTY Kopieren Sie die Datei „PuTTY.exe“ von der CD auf den PC. Starten Sie die PuTTY. Geben Sie unter „Host Name“ den Hostnamen Ihrer Website ein und geben der Verbindung unter „Saved Session“ einen Namen. Speichern Sie die Session mit einem Klick auf „Save“.
Wechseln Sie jetzt auf „Tunnels“ unter „Connection->SSH“. Geben Sie unter „Source port“ 3307 ein und unter Destination die SSH Adresse mit „:3306“. Jetzt muss nur noch der Benutzername unter „Auto-login username“ in dem Punkt „Connection->Data“ eingegeben werden. Das Ganze noch einmal Speichern und danach die Verbindung mit der ODBC Verbindung testen. Alle Ports können natürlich freigewählt werden, müssen dann aber auch in der ODBC Verbindung Angepasst werden. Die Zugangsdaten können beim Webhoster erfragt werden.
Hinweis: Alle Ports können natürlich freigewählt werden, müssen dann aber auch in der ODBC Verbindung Angepasst werden. Bei Fragen zu Verbindungsinformationen fragen Sie bitte Ihren Webhoster.
Handbuch CHIPSIZE Shop Connect
3
Stand: 08.04.2009
Handbuch 2.3. MySQL ODBC Verbindung Erstellen Sie jetzt eine ODBC Verbindung. Öffnen Sie die „Systemsteuerung“ und die „Verwaltung“. Starten Sie „Datenquelle (ODBC)“ und öffnen Sie das Register „System-DNS“. Klicken Sie auf „Hinzufügen“. Wählen Sie den „MySQL ODBC 3.5 Driver“ und klicken auf „Fertig stellen“.
Data Source Name: Geben Sie hier einen beliebigen Namen ein. Dieser Name wird später vom Zusatzmodul benötigt. Description: Geben Sie eine beliebige Beschreibung ein oder lassen Sie das Feld leer. Server: Hier muss der Name des Servers eingegeben werden auf dem der Webshop installiert ist. In diesem fall ist der Webshop auf dem gleichen PC wie die Office Line. Port: Geben Sie den Port Ihres MySQL-Servers an. Standard Port ist „3306“. Mit SSH Verbindung muss der Port auf „3307“ geändert werden. User: Geben Sie hier einen Benutzer an. Der Benutzer muss berechtigt sein, auf die Datenbank des Webshops zuzugreifen. Er braucht die Berechtigung zum Schreiben und Lesen. Passwort: Hier muss das Passwort für den Benutzer eingetragen werden. Database: Wählen Sie die Webshop-Datenbank aus oder geben Sie den Datenbankname manuell ein. Klicken Sie jetzt auf „Test“. Wenn Sie die Meldung „Success; connection was made!“ erhalten ist die Verbindung erfolgreich eingerichtet. Klicken Sie auf „OK“ um die Verbindung zu Speichern.
Handbuch CHIPSIZE Shop Connect
4
Stand: 08.04.2009
Handbuch 2.4. Setup Um das Zusatzmodul zu installieren starten Sie die Datei „Setup.exe“. Klicken Sie auf „Weiter“. Lesen Sie sich die Lizenzbestimmungen durch, Sie müssen diesen zustimmen, um das Zusatzmodul installieren zu können. Klicken Sie anschließend auf „Weiter“.
Wählen Sie den Ordner aus unter dem die Office Line Installiert ist. Das Setup sollte den Pfad automatisch erkennen (z.B. „C:\Programme\Sage\Office Line\5.0“). Klicken Sie auf „Weiter“.
Warten Sie bis die Installation abgeschlossen ist und klicken Sie auf „Schleißen“. Das Zusatzmodul wurde nun in Ihr Office Line Verzeichnis kopiert. Im nächsten Schritt wird das Addin in der Office Line installiert.
Handbuch CHIPSIZE Shop Connect
5
Stand: 08.04.2009
Handbuch 2.5. Zusatzmodul installieren Starten Sie die Office Line Warenwirtschaft. Installieren Sie das Zusatzmodul auf folgende weise: Öffnen Sie den Menüpunkt „Zusatzmodule“ über das Register „Grundlagen“.
Klicken Sie auf „Installieren“, wählen die Datei „OLAbfCHIPSIZEXTC50.mde“ aus dem Verzeichnis „…\Sage\Office Line\5.0\Addin\“ aus und öffnen diese. Bestätigen Sie die folgende Abfrage mit „Ja“.
Schließen sie das Fenster „Zusatzmodule“ wieder und starten Sie die Office Line neu. Nach dem Neustart der Office Line erscheint eventuell eine Meldung, welche Ihnen mitteilt, dass noch keine Berechtigung für den neuen Menüeintrag gesetzt worden sind. Die Berechtigungen können, wie gewohnt, über den Administrator der Office Line erteilt bzw. entzogen werden. Hinweis: Die Vorgänge 2.1, 2.2 2.3 und 2.4 müssen auf jedem PC durchgeführt werden, an dem das Addin installiert werden soll.
Handbuch CHIPSIZE Shop Connect
6
Stand: 08.04.2009
Handbuch 2.6. Einrichten des Zusatzmoduls Öffnen Sie den „Konfigurator“ über „Regiezentrum -> CS Shop Connect“.
ODBC-Systemdatenquelle: Geben Sie hier den „Data Source Name„ ein welchen Sie unter Punkt 2.2 eingerichtet haben. Klicken Sie auf „Test“ um die Einstellungen zu testen. Zeitintervall in min: Hier können Sie ein Zeitintervall in Minuten festlegen. Geben Sie zum Beispiel 1 ein, wird jede Minute der ein Abgleich des Webshops und der Office Line durch geführt. Sie können Werte zwischen 0 und 35791 eingeben. Wenn Sie 0 eingeben, wird der Abgleich nur manuell ausgeführt. SSH über PuTTY: Falls von Webhoster ein SSH Tunnel verlangt wird kann dies mit dem beiliegenden Tool PuTTY realisiert werden. FTP: Damit der Upload von Artikelbilder funktioniert muss eine FTP Verbindung eingerichtet werden. Geben Sie hierzu den Servernamen („Server“), Benutzernamen („Benutzer“) den Pfad zum WebShop („WebShop Pfad“) und das Kennwort („Kennwort“) ein. Der WebShop Pfad muss folgendermaßen aufgebaut sein: „/Webseitenverzeichnis/WebShopverzeichnis/“. Als letztes Zeichen muss immer ein „/“ vorhanden sein.
Handbuch CHIPSIZE Shop Connect
7
Stand: 08.04.2009
Handbuch Test: Über den Button „Test“ kann die Konfiguration getestet werden. Es wird als erstes die ODBC Verbindung geprüft, gegeben falls mit SSH Tunnel. Danach wird die FTP Verbindung getestet. Hier muss eine beliebige Datei ausgewählt werden. Die Datei wird testweise auf den FTP Server hochgeladen.
Hinweis: Für den ersten Abgleich empfiehlt es sich den Zeitintervall auf 0 zusetzten. Sobald der Zeitintervall aktiviert ist, werden Fehlermeldungen nur in das Protokoll geschrieben. Die Meldungen werden nicht direkt auf dem Bildschirm angezeigt. 2.7. Einrichten der Datenbankstrukturen Zum Einrichten des Addins starten Sie die Office Line. Melden Sie sich an der Datenbank an, unter der das Addin genutzt werden soll. Öffnen Sie den „Administrator“ über „Regiezentrum -> CS Shop Connect“.
Klicken Sie auf „OK“ und beantworten Sie die folgende Abfrage mit „Ja“. Es werden nun automatisch die Voraussetzungen für das Addin installiert. Sie erhalten eine Meldung wenn die Daten aktualisiert wurden. Starten Sie die Office Line neu. Hinweis: Führen Sie die Schritte 2.5 und 2.6 unter jeder Datenbank aus, in der Sie das Zusatzmodul nutzen möchten.
Handbuch CHIPSIZE Shop Connect
8
Stand: 08.04.2009
Handbuch 3. Bedienung 3.1. Kunden Damit Kunden sich im Webshop anmelden und bestellen können, müssen die Kundendaten vom „Shop Connect“ übertragen werden. Die Kundendaten müssen für die Übertragung vorbereitet werden. Öffnen Sie den „Adressstamm“ über „„Regiezentrum>Stammdaten->Adressen“. Wählen Sie einen Kunden aus. Öffnen Sie das Register „Webshop“. WebShop Adresse: „Ja“ heißt die Adresse wird in den Webshop übertragen. „Nein“ heißt die Adresse wird nicht übertragen oder schon übertragene Adressen werden auf Inaktiv gesetzt. Anrede: Hier muss die Anrede des Ansprechpartners für Webshop-Bestellungen eingetragen werden. Vorname: Hier muss der Vorname des Ansprechpartners für Webshop-Bestellungen eingetragen werden. Nachname: Hier muss der Nachname des Ansprechpartners für Webshop-Bestellungen eingetragen werden. E-Mail: Das Feld „E-Mail“ muss gefüllt sein. Mit dieser Adresse kann sich der Kunde am Shop anmelden.
Handbuch CHIPSIZE Shop Connect
9
Stand: 08.04.2009
Handbuch Passwort: Über „Optionen -> WebShop Passwort“ kann ein Passwort für den Kunden hinterlegt oder neu gesetzt werden.
Hinweis: Das Passwort wird erst beim nächsten Synchronisieren aktiv. 3.2. Preislisten „Shop Connect“ muss wissen, welcher Preis zu einem Artikeln im Webshop gehört. Hierzu muss eine Preisliste angelegt werden oder eine bestehende als Webshop-Preisliste gekennzeichnet werden. Öffnen Sie „Preislisten“ über „Regiezentrum>Stammdaten>Preise und Rabatte“. Wählen Sie die Preisliste welche die Webshop-Preise enthält und öffnen das Register „Webshop“. Im Feld „WebShop Preisliste“ wählen Sie „Ja“ aus. Hinweis: Es kann nur eine Preisliste gewählt werden.
Handbuch CHIPSIZE Shop Connect
10
Stand: 08.04.2009
Handbuch 3.3. Artikel Das Zusatzmodul überträgt nur Artikel, welche als Webshop-Artikel gekennzeichnet sind. Öffnen Sie den „Artikelstamm“ über „„Regiezentrum -> Stammdaten>Artikel“. Wählen Sie einen Artikel aus und öffnen das Register „Webshop“. WebShop Artikel: „Ja“ heißt der Artikel wird in den Webshop übertragen. „Nein“ heißt der Artikel wird nicht übertragen oder schon übertragene Artikel werden auf Inaktiv gesetzt. Lieferstatus: Hier kann die Lieferzeit gewählt werden, welche der Kunde später im WebShop angezeigt bekommt. Auch freie Eingaben sind möglich. Beschreibung im Shop bearbeiten: Hier kann ausgewählt werden ob die Beschreibung aus der Office Line Hochgeladen werden soll oder sie im Shop bearbeitet wird. Die Preise, Lagerbestände, Steuercodes und Artikelgruppen werden immer aktualisiert. Alle anderen Felder werden dann nicht mehr überschrieben. Auch Artikelbilder werden dann nicht mehr hochgeladen. Artikelbilder: Artikelbilder werden aus der Sammelmappe der Office Line in den Shop hochgeladen. Es werden nur Bilder hochgeladen welche das Verwendbungzeichen „Web“ haben.
Handbuch CHIPSIZE Shop Connect
11
Stand: 08.04.2009
Handbuch 3.4. Shop Connect Nachdem alle Grundlagen eingestellt sind, können Artikel, Kunden und Bestellungen abgeglichen werden. Das „CS Shop Connect“ Exportiert Artikel und Kunden von der Office Line in den Shop. Artikel und Kunden werden aktualisiert, sobald sich die Daten in der Office Line ändern. Bestellungen aus dem Webshop werden in der Office Line als Auftragsbestätigungen angelegt. 3.4.1. Informationen Es wird der Zeitintervall in Minuten angezeigt und die nächste Ausführung des Abgleich. 3.4.2. Abgleich Kunden Über den Schalter „Kunden“ kann der Abgleich der Kunden manuell ausgeführt werden. Es werden neue Adressen aus dem WebShop in die Office Line importiert und Adressen aus der Office Line in den Shop exportiert. Änderungen werden nur aus der Office Line in den Shop exportiert, es werden keine Änderungen importiert. Die Änderungen welche im Shop gemacht würden werden wieder durch die Office Line Daten überschrieben. Für den Import der WebShop Adressen steht eine Adressvorlage bereit. Die „WebShop Vorlage“ funktioniert wie die „Interessentenvorlage“. Es werden alle Daten wie zum Beispiel Adressgruppe oder Sammelkonto für neue Adressen vorbelegt. Möchten Sie zum Beispiel alle neuen WebShop Kunden den Vertreter „V001“ hinterlegen können Sie dieses in der Vorlage machen. Beim nächsten Synchronisieren der Adressen wird dann allen neuen Adressen aus dem Shop der Vertreter „V001“ zugeordnet. 3.4.3. Abgleich Artikel Über den Schalter „Artikel“ kann der Abgleich der Artikel manuell ausgeführt werden. Es werden alle Artikel welche als WebShop Artikel gekennzeichnet sind in den Shop Hochgeladen. 3.4.4. Abgleich Bestellungen Mit dem Schalter „Import Bestellungen“ werden Bestellungen aus dem Webshop als Auftragsbestätigung in der Office Line angelegt. Gleichzeitig wird die Bestellhistorie im Shop aktualisiert.
Diese Informationen sieht der Kunde. Der Status „In Bearbeitung“ wird gesetzt, wenn Bestellung importiert ist. Der Status wird auf „Versendet“ geändert wenn, aus der WebShop Bestellung ein Liefernder Beleg erstellt wird.
Handbuch CHIPSIZE Shop Connect
12
Stand: 08.04.2009
Handbuch 3.4.5. Automatischer Abgleich Wird ein Zeitintervall eingestellt, erfolgt der Abgleich Automatisch. Es wird erst der Kunden-, dann der Artikel- und zuletzt der Bestellungsabgleich ausgeführt. Wird ein Abgleich ausgeführt, ist dies unten Rechts in der Statusleiste zu sehen. Die nächste Ausführung und der Intervall wird oben bei den Informationen angezeigt. Hinweis: Das Fenster „CHIPSIZE Shop Connect“ kann klein gemacht werden und im Hintergrund den Abgleich ausführen. Sie können zur selben Zeit weiter in der Office Line Arbeiten. 3.5. Protokoll Es werden alle Abgleiche und eventuelle Fehler Protokolliert. Das Protokoll kann über „Regiezentrum->CS Shop Connect->Protokoll“ gestartet werden.
Port-Id.: Die Protokoll-ID ist eine fortlaufende Nummer. Hier ist als letztes das 487. Protokoll zu sehen. Bezeichnung 1: Zeigt die Bezeichnung des Protokolls. Es gibt die drei Protokolle „Import Bestellungen“, „Export Kunden“ und „Export Artikel“. Startdatum: Zeigt das Startdatum und die Zeit des Abgleich. Enddatum: Zeigt das Enddatum und die Zeit des Abgleich. Lupe: Mit einem Klick auf die Lupe können Details zu dem Import angezeigt werden. 3.5.1. Positionen Die Positionen Zeigen alle Ereignisse zu einem Abgleich an. Der Abgleich von Artikeln ist hier zu sehen:
Fehler werden mit „Fehler:“ in der Bezeichnung gekennzeichnet.
Handbuch CHIPSIZE Shop Connect
13
Stand: 08.04.2009
Handbuch 4. Deinstallation 4.1. Zusatzmodule Starten Sie die Office Line Warenwirtschaft. Öffnen Sie das Menü „Zusatzmodule“ über „Grundlagen -> Zusatzmodule“. Wählen Sie das Addin „CHIPSIZE Shop Connect“ aus. Klicken Sie auf Deinstallieren. Beenden Sie die Office Line.
4.2. Setup Unter Windows XP: Öffnen Sie das Windows Menü „Software“ über „Systemsteuerung“ -> „Software“. Wählen Sie das Programm „CS Shop Connect“ aus. Klicken Sie auf „Entfernen“. Folgen Sie jetzt den Anweisungen des Deinstallations-Assistenten. Unter Windows Vista: Klicken Sie auf den Vista-Button unten links, wählen Sie „Systemsteuerung“ und dann „Programme und Funktionen“. Wählen Sie das Programm „CS Shop Connect“ aus. Klicken Sie auf „Deinstallieren“. Folgen Sie jetzt den Anweisungen des DeinstallationsAssistenten. Nach erfolgreicher Deinstallation sollte der Eintrag, aus der Liste der installierten Software, entfernt sein.
Handbuch CHIPSIZE Shop Connect
14
Stand: 08.04.2009