ipin CSV-Datenimport (Mac OS X) ipin bietet Ihnen die Möglichkeit, Daten aus anderen Programmen oder Datenquellen zu importieren. Dies ist vor allem dann sehr hilfreich, wenn große Datenmengen in ipin erfasst und gespeichert werden sollen. Dieses Dokument beschreibt den Import von Daten in ipin mit Hilfe einer Textdatei im CSV Dateiformat (CSV = Comma Separated Values). Der Aufbau einer solchen Textdatei ist zwar strukturiert, dennoch ist das Format als Solches nicht standardisiert. ipin ermöglicht einen generischen Import, mit dessen Hilfe die Struktur der zu importierenden Daten während des Imports durch entsprechende Parametrisierung und Konfiguration festgelegt und definiert werden kann, um so den Aufwand der Datenaufbereitung im Vorfeld zu minimieren. Allgemeine Informationen zum CSV Dateiformat findet man beispielsweise unter wikipedia.org. Seite 1 von 7
ÜBERSICHT Schritt 1 Auswahl der CSV Datei... 3 Schritt 2 Format Beschreibung... 4 CSV-Format... 4 Feld Trennzeichen... 5 Textbegrenzung... 5 Notiz Zeilenumbruch... 5 Encoding... 5 Option Erste Zeile ignorieren (Kopfsatz)... 6 Option Leerzeichen am Anfang und Ende eines Feldes entfernen... 6 Option Importierte Daten in einer neuen Gruppe speichern... 6 Schritt 3 Vorschau... 7 Seite 2 von 7
Schritt 1 Auswahl der CSV Datei Der CSV Datenimport wird über den Menüpunkt ipin > Import > CSV gestartet. Zunächst wird die zu importierende CSV-Datei über einen Dateiauswahl Dialog ausgewählt haben. Bitte beachten Sie, dass hier lediglich Dateien mit der Datei-Endung.cvs ausgewählt werden können. Seite 3 von 7
Schritt 2 Format Beschreibung Im nächsten Dialog wird die Datenstruktur der CSV Datei festgelegt: CSV-Format In dieser Tabelle werden die einzelnen Datenfelder der CSV Datei sowie deren Reihenfolge festgelegt. D.h. hier wird der Aufbau und die Datenstruktur einer Zeile in der CSV-Datei definiert. Feldname GRUPPE NAME BENUTZERNAME PIN ODER PASSWORT NOTIZ IGNORIEREN Bedeutung Bestimmt den Gruppennamen, unter dem der Datensatz gespeichert werden soll. Existiert die hier angegeben Gruppe nicht, so wird eine entsprechende Gruppe automatisch erzeugt. Ist die Gruppe nicht angegeben (leere Zeichenkette oder Feld ist in der Tabelle nicht spezifiziert) so wird der resultierende Eintrag in der Hauptgruppe gespeichert. Hinweis: Es können derzeit keine Untergruppen (Gruppe in einer Gruppe) spezifiziert werden. Legt den Namen des Eintrags fest. Legt den Benutzernamen fest. Ist kein Benutzername angegeben (leere Zeichenkette oder Feld ist in der Tabelle nicht spezifiziert), so wird automatisch ein PIN-Eintrag erzeugt. Ist ein Benutzername angegeben, so wird ein Konto-Eintrag erzeugt. Legt die PIN (im Falle eines PIN-Eintrags) oder das Passwort (im Falle eines Konto-Eintrags) fest. Legt fest, dass das entsprechende Feld in der Notiz des entsprechenden Eintrags gespeichert wird. Das Feld Notiz kann mehrfach angegeben werden, um mehrere Felder in das Notizfeld zu überführen. Die einzelnen Felder werden hierbei durch einen Zeilenumbruch voneinander getrennt. Legt fest, dass das entsprechende Feld beim Import ignoriert werden soll. Auch dieses Feld kann mehrfach angegeben werden. Seite 4 von 7
Feld Trennzeichen Auch wenn die Formatbezeichnung CSV das Komma als Trennzeichen zwischen einzelnen Feldern in der Datenstruktur vorsieht, können Sie hier alternativ ein Semikolon oder einen Doppelpunkt als Trennzeichen festlegen. Textbegrenzung Mit Hilfe einer Textbegrenzung kann ein Text als Feldwert in der CSV-Datei angegeben werden, der Steuerzeichen enthalten kann, die aber nicht weiter interpretiert werden sollen. Beispiel: Meine PIN,4711, Dies ist eine Notiz, mit einem Komma,PINs Das Komma nach dem Wort Notiz wird nicht als Feld-Trennzeichen interpretiert, da der Text in den Textbegrenzungszeichen... eingeschlossen wurde. Mögliche Textbegrenzungszeichen sind das einfache oder das doppelte Hochkomma. Notiz Zeilenumbruch Um mehrzeilige Notizen angeben zu können, kann entweder die Zeichenkette \n oder <br/> genutzt werden. Beispiel: Meine PIN,4711,Zeile 1 der Notiz\nZeile 2 der Notiz,PINs Das resultierende Notizfeld des PIN-Eintrags ist dann zweizeilig: Zeile 1 der Notiz Zeile 2 der Notiz Encoding Legt den zugrundeliegenden Zeichensatz der CSV-Datei fest. Mögliche Zeichensätze: UTF-8, UTF-16, ASCII Windows 1250, Windows 1252, ISO Latin 1, ISO Latin 2 Seite 5 von 7
Option Erste Zeile ignorieren (Kopfsatz) Mit dieser Option können Sie ipin anweisen, die erste Zeile der CSV-Datei beim Import zu ignorieren. Dies ist dann sinnvoll, wenn in der CSV Datei die Feldnamen in der ersten Zeile aufgelistet sind. Option Leerzeichen am Anfang und Ende eines Feldes entfernen Ist diese Option ausgewählt, so entfernt ipin automatisch alle Leerzeichen am Anfang und Ende der einzelnen CVS-Felder bevor die Werte in den entsprechenden Zielfeldern gespeichert werden. Option Importierte Daten in einer neuen Gruppe speichern Ist diese Option ausgewählt, so erstellt ipin eine Gruppe mit einem generierten Gruppennamen Import YYYYMMDD HHMMSS und speichert alle importierten Datensätze inklusive etwaiger Untergruppen in dieser Gruppe. Dies ist vor allem dann sinnvoll, wenn der Import zunächst getestet und überprüft werden soll, da man durch Löschen der generierten Gruppe alle importierten Daten auf einmal löschen kann und nicht mehrere Datensätze oder Gruppen in der Hautgruppe löschen muss. Zudem kann diese Option genutzt werden, um die importierten Daten nach dem Import in eine existierende Gruppenstruktur zu verschieben und diese Gruppenstruktur beim Import unberührt zu lassen. Seite 6 von 7
Schritt 3 Vorschau Nachdem das CSV-Format beschrieben ist, kann man im nächsten Schritt eine Import-Vorschau in Form einer Tabelle sowie ein Import-Protokoll einsehen: Fehler in der Formatbeschreibung und/oder der CSV-Datei lassen sich so im Vorfeld recht schnell erkennen. Ist die Vorschau zufriedenstellend, können die Daten schließlich importiert werden. Seite 7 von 7