Datenaustausch mit Mac / PC & HeadCook / Ecoshop 2008-2011 InnoBytes, Wolfgang Kohrt 1
Inhalt! Allgemeines! 3 1. Vorbereitungen! 4 1.1 Vorbereitungen für MacOSX 10! 4 1.2 Vorbereitungen für Windows XP/Vista/7! 4 2. Datenimport von HeadCook:! 5 3. Artikel, Rezepte, Bilder, Zutaten bearbeiten! 7 3.1 Bearbeiten mit Numbers unter MacOSx! 7 3.2 Bearbeiten mit MS-Excel unter MS-Windows! 9 4. Datenexport zu HeadCook! 11 5. Reciper! 12 2008-2011 InnoBytes, Wolfgang Kohrt 2
Allgemeines Mit Hilfe des Datenaustauschs können Teile der Datenbank auf dem Mac/PC exportiert, dort bearbeitet und anschließend wieder in die HeadCook- bzw. EcoShop-Anwendung importiert werden. Der nachfolgende Text bezieht sich auf die HeadCook-Anwendung, gilt aber gleichermaßen für die EcoShop-Anwendung. Mit der Ausnahme, daß in der EcoShop-Anwendung keine Rezepte verwaltet werden können. Um eine größtmögliche Betriebssystemunabhängigkeit und Flexibilität zu gewähren haben wir uns für folgende Lösung entschieden: Der Datenaustausch erfolgt über Textdateien mit Trennzeichen. Die Dateien werden über einen Bonjour-Dienst mittels WiFi und der Java-Anwendung SyncDocs (HTTP-Server) mit dem Mac/PC im lokalen Netzwerk ausgetauscht. Für die Pflege von Rezeptdaten empfehlen wird den Einsatz des kostenlosen Recipers. (s.kapitel Reciper). 2008-2011 InnoBytes, Wolfgang Kohrt 3
1. Vorbereitungen 1.1 Vorbereitungen für MacOSX 10 Laden und installieren Sie die Anwendung SyncDocs aus dem Internet. Bonjour und JAVA sind standardmäßig auf dem Mac installiert. http://sourceforge.net/projects/syncdocs 1.2 Vorbereitungen für Windows XP/Vista/7 Laden und installieren Sie die Java-Runtime-Engine aus dem Internet, falls diese noch nicht auf Ihrem PC installiert ist. http://java.com/download/index.jsp Laden und installieren Sie Bonjour für Windows aus dem Internet, falls noch nicht auf Ihrem PC installiert. http://developer.apple.com/networking/bonjour/download Laden und Installieren Sie die Anwendung SyncDocs für Windows aus dem Internet. http://sourceforge.net/projects/syncdocs 2008-2011 InnoBytes, Wolfgang Kohrt 4
2. Datenimport von HeadCook: 1. Starten Sie Java-Anwendung SyncDocs.jar auf ihrem Mac oder PC: SyncDocs dient als HTTP-Server für den Datenaustausch mit dem iphone/ipod/ipad. 2. Verbinden Sie iphone/ipod/ipad über WiFi mit ihrem lokalen Netzwerk. Achten Sie darauf, daß die Verbindung durch Firewalleinstellungen nicht blockiert wird und der WLAN-Router den Datenaustausch der registrierten Geräte untereinander erlaubt. 1 2 3 3. Wählen Sie in der Anwendung HeadCook aus dem Menü die Funktion Exportieren und anschließend Export (1). Nun wird über den Bonjour-Service nach einem HTTP- Server gesucht. Der SyncDocs-Service (2) sollte gefunden und angezeigt werden. (Ist dies nicht der Fall, prüfen Sie bitte ob der Bonjour-Dienst auf ihrem Mac/PC gestartet ist und ob Firewall-Einstellungen den Verbindungsaufbau blockieren bzw. ob SyncDocs gestartet ist und eingehende Netzwerkverbindungen erlaubt ). 4. Wählen Sie den Eintrag SyncDocs aus. Nun werden Artikel, Statistikdaten, Rezepte, Zutaten und Bilder in das Download-Verzeichnis der SyncDocs-Anwendung auf den Mac/PC übertragen. Vorhandene Dateien gleichen Namens werden dabei überschrieben (3). 5. Die Bilddateien werden im JPEG-Format gespeichert und haben den Namen des Rezeptes. 2008-2011 InnoBytes, Wolfgang Kohrt 5
6. Artikel, Statistiken, Rezepte und Zutaten sind in folgenden Textdateien im Download-Verzeichnis der SyncDocs-Anwendung gespeichert: Inhalt Dateiname Artikel Statistik Rezepte Zutaten Bilder ecoshop_artikel.txt ecoshop_statistik.txt headcook_rezepte.txt headcook_zutaten.txt *.jpg Jede Textdatei enthält mehrere Datensätze die durch ein Zeilenendezeichen begrenzt sind. Jeder Datensatz enthält mehrere Daten, die durch ein Tabulatorzeichen voneinander getrennt und im UTF-8 Zeichensatz kodiert sind. Dezimalzeichen werden je nach Sprachversion innerhalb der Textdatei als Punkt oder Komma dargestellt. Das Datum wird im Format JJJJ-MM-TT formatiert. 2008-2011 InnoBytes, Wolfgang Kohrt 6
3. Artikel, Rezepte, Bilder, Zutaten bearbeiten 3.1 Bearbeiten mit Numbers unter MacOSx Datenaustausch mit Mac/PC & HeadCook/Ecoshop 1. Wählen Sie den Zeige Dateien in der SyncDocs-Anwendung um den Ordner mit den geladenen Dateien (s. Kapitel 2) zu öffnen. 2. Ziehen Sie eine Datei mit der Maus auf das Icon der Numbers-Anwendung innerhalb der Icon-Leiste des Macs. Numbers öffnet sich automatisch und zeigt den Inhalt der Datei in Tabellenform an (4): 4 3. Die Spaltenüberschriften entsprechen den Eingabefeldern der HeadCook- Anwendung. Nehmen Sie nun die gewünschten Änderungen in der Tabelle vor in dem Sie Daten ändern oder neue Datensätze hinzufügen. 4. Lassen Sie die Spalte Index für neue Datensätze leer: Beim späteren Import in die HeadCook-Anwendung wird der Index automatisch generiert. 2008-2011 InnoBytes, Wolfgang Kohrt 7
6. Sind bestimmte Daten nicht vorhanden, so lassen Sie die entsprechende Spalte leer. So reicht für die Neuanlage eines Artikels minimal die Eingabe einer Artikelbezeichnung in der Spalte Artikel. Die Eingabe von Menge, Inhalt und Einheit bezieht sich auf die Packungsgröße des Artikels. So geben Sie z.b. in der Spalte Menge 6 und in der Spalte Inhalt 0.33 für ein Six-Pack 6x0.33 ein. 7. Die Rezeptzutaten sind in der Datei headcook_zutaten zu editieren. Vor jeder Zutat ist der entsprechende Rezeptname einzutragen. An Hand des Rezeptnamens werden die Zutaten beim späteren Import in die HeadCook-Anwendung dem Rezept zugeordnet. Die Zutaten werden beim Import automatisch als Artikel angelegt, sofern noch kein Artikel gleichen Namens existiert. 8. Zu einem Rezept kann ein Bild im JPEG-Format importiert werden. Erstellen Sie dazu eine Bilddatei mit dem Namen des Rezepts und der Dateierweiterung.JPG. 9. Wählen Sie abschließend Exportieren... aus dem Menü Ablage der Numbers- Anwendung. Wählen Sie anschließend CSV und Unicode (UTF-8) Textcodierung um die Daten in eine CSV-Datei zu schreiben. Wählen Sie als Speicherort ein anderes Verzeichnis als das Download-Verzeichnis der SyncDocs-Anwendung (generieren Sie z.b. einen Ordner Upload ). 10.Standardmäßig erstellt Numbers eine Textdatei mit der Erweiterung.CSV. Ändern Sie die Dateierweiterung vor dem Import in die HeadCook-Anwendung in.txt. 2008-2011 InnoBytes, Wolfgang Kohrt 8
3.2 Bearbeiten mit MS-Excel unter MS-Windows 1. Starten Sie MS-Excel. 2. Wählen Sie Datei-Öffnen aus dem Excel-Menü und wählen Sie anschließend die gewünschte Textdatei aus dem Download-Verzeichnis der SyncDocs-Anwendung. 3. Der Textkonvertierungsassistent öffnet sich. Wählen Sie Getrennter Dateityp und Unicode UTF-8 als Dateiursprung. Wählen Sie Fertig stellen. Die Textdatei wird nun in Tabellenform angezeigt (5): 5 4. Für die Bearbeitung einer Tabelle lesen Sie die Punkte 3-7 im Kapitel 3.1 5. Speichern Sie nach der Bearbeitung die Datei und behalten Sie die ursprüngliche Formatierung bei (Text - Tabstopp getrennt). Wählen Sie als Speicherort ein anderes Verzeichnis als das Download-Verzeichnis der SyncDocs-Anwendung (generieren Sie z.b. einen Ordner Upload ). 2008-2011 InnoBytes, Wolfgang Kohrt 9
Hinweis: MS-Excel speichert die Textdatei im ISO-8859-1-Format. Die HeadCook- Anwendung erkennt beim Datenimport neben dem UTF-8-Format auch dieses Format. 2008-2011 InnoBytes, Wolfgang Kohrt 10
4. Datenexport zu HeadCook 1. Ziehen Sie nun alle geänderten Dateien mit der Dateierweiterung.TXT und die zu übertragende Bilddateien mit der Dateierweiterung.JPG ( welche in die HeadCook- Anwendung importiert werden sollen ) mit der Maus auf das Fenster der SyncDocs- Anwendung (6): 6 2. Wählen Sie aus dem Menü der HeadCook-Anwendung die Funktion Importieren. Es erfolgt eine Abfrage ob Sie eine Datensicherung durchführen möchten. Dies ist immer sinnvoll. Falls die übertragenen Daten einmal fehlerhaft sein sollten, können Sie den ursprünglichen Zustand der Daten auf dem iphone/ipod/ipad mit der Funktion Wiederherstellen rekonstruieren. 3. Anschließend ist der Eintrag SyncDocs aus der Serverliste auszuwählen. Nun werden die bereitgestellten Daten eingelesen. 4. Existiert bereits ein Rezept gleichen Namens, so wird das vorhandene Rezept überschrieben. Auf dem iphone/ipod/ipad werden durch die Übertragung keine Rezepte/Artikel gelöscht, sondern nur hinzugefügt, wenn nicht bereits vorhanden oder ersetzt, wenn bereits vorhanden. 2008-2011 InnoBytes, Wolfgang Kohrt 11
5. Reciper Der Reciper vereinfacht die Erfassung von Rezepten auf dem Mac/PC und deren Import in die HeadCook-Anwendung. 1. Installieren Sie JAVA auf ihrem Mac/PC falls noch nicht vorhanden (s. 1.2). 2. Laden Sie die kostenlose Anwendung Reciper im Internet von folgender Adresse: http://www.innobytes.com/appstorehilfeheadcook.aspx 3. Kopieren Sie die Datei HeadCook-Reciper.jar in ein eigenes Programmverzeichnis. 4. Starten Sie die Anwendung durch Doppelklick auf die Datei HeadCook-Reciper.jar. Das Betriebssystem erkennt im Normalfall automatisch, daß es sich dabei um eine JAVA-Anwendung handelt. 5. Erfassen Sie nun mit dem Reciper ihre Rezepte und Zutaten (7): 7 2008-2011 InnoBytes, Wolfgang Kohrt 12
6. Zur Übertragung eines auf dem Reciper angezeigten Rezepts zur HeadCook- Anwendung wählen Sie in HeadCook im Menü die Funktion Reciper. 7. Geben Sie anschließend im Eingabefeld Mac/PC-Adresse die im Reciper-Fenster auf dem Mac/PC rechts unten angezeigte sogenannte IP-Adresse des Mac/PCs ein (8). 8 8. Wählen Sie abschließend Empfangen um die Übertragung zu starten. Stellen Sie dabei sicher, daß die Firewall-Einstellungen des Mac/PC den Datenaustausch nicht blockieren und der WLAN-Router den Datenaustausch der registrierten Geräte untereinander erlaubt. 2008-2011 InnoBytes, Wolfgang Kohrt 13