Import von Daten im csv-Format nach karatasi

Für Neuinstallationen empfehlen wir, zum Import von csv Daten unsere Java-Applikation statt des Perl Scripts zu verwenden (ab Version 0.2). Die Java Applikation benötigt keine externe Software. Bitte benutzen sie den Menue Eintrag 'Lesen' unter 'Dateien'.

Wir stellen ein Perl Programm für den Import von csv Daten bereit. Dieses Perl Programm erzeugt eine neue Datenbank oder fügt die Datensätze zu einer bestehenden karatasi Datenbank hinzu.

Allgemeines

csv steht für 'comma-separated values' (durch Komma getrennte Werte). In einer csv Datei

• werden die einzelnen Werte durch Kommata getrennt.
• kann ein Wert mit doppelten Anführungszeichen " geschützt werden.
• doppelte Anführungszeichen im Wert sind zulässig, müssen jedoch verdoppelt werden.
• csv Dateien können bequem mit Hilfe der Exportfunktion einer Spreadsheet-Applikation erzeugt werden.

Format

Die Import-Funktion übernimmt die Kategorie und die Datenfelder einer Karte in eine karatasi Datenbank.

• Die erste Spalte enthält den Namen der Kategorie. Wenn die Kategorie noch nicht existiert, so wird sie erzeugt.
• Die nächsten 6 Spalten enthalten die Felder der Karte.
• Leere oder fehlende Spalten sind zulässig und resultieren in leeren Datenfeldern.
• Eine Zelle darf Zeilenumbrüche enthalten, sofern diese mit doppelten Anführungszeichen umschlossen (geschützt) sind.
• Wichtig: Sämtliche Texte für karatasi in der csv Datei müssen UTF-8 codiert sein.

Vorbereitungen

• Sie benötigen eine lauffähige Perl Installation.
• Das Perl Modul DBI für das Interface zur Datenbank.
• Das Perl Modul Encode für UTF-8 support.
• Die Perl Moduln File::Basename und Time::Local.
• Laden Sie das karatasi Tools Paket von http://sourceforge.net/projects/karatasi/files/Tools.
• Nehmen Sie die Datenbank-Übertragung zum iPhone in Betrieb. Sie können hierfür entweder die Java Applikation verwenden, oder Sie installieren einen Apache Webserver, und verwenden unsere cgi Skripten zur Übertragung.
  Anmerkung: Für Neuinstallationen empfehlen wir, die Java Applikation zu verwenden.

Und so gehts

• Entpacken Sie das heruntergeladene Tools Paket.
• Wechseln Sie in das tools Verzeichnis (z.B. karatasi-tools-1.5.0) und kopieren Sie Ihre csv-Dateien in dieses Verzeichnis.
• perl import_csv.pl -h      zeigt den Hilfetext an.
• perl import_csv.pl -s -d l_myFile.db myFile.csv      konvertiert die csv Datei 'myFile.csv' in die karatasi Datenbank 'l_myFile.db'. Dieser Name mit dem Präfix l_ und der Dateierweiterung *.db paßt zur Datenbank-Übertragung mit cgi-Scripten.
• Kopieren Sie die konvertierte Datenbank in das Synchronisations-Verzeichnis und setzen Sie den File Owner auf '_www'.
• Übertragen Sie nun die Datenbank auf das iPhone.