Q-103.077

Adressimport

Frage
Problem Externe Adressen sollen in eine David® Installation importiert werden.
Produkt David
Priorität keine
Effekt harmlos
Datum 7.08.2012

Antwort
David® bietet eine umfangreiche Importfunktion für Adressdateien im ASCII-Format. Erstellen Sie eine reine DOS-ASCII-Textdatei (kein ANSI), die zeilenweise die einzelnen Datensätze enthält. Bei der Anordnung der Felder ist Folgendes zu beachten: Sie können entweder alle Felder oder nur die benötigten Felder aus einer Zeile aufnehmen. Diese Importdatei muss unter einem beliebigen Dateinamen mit der Erweiterung »*.NMR« (z.B. IMPORT.NMR) im Verzeichnis \DAVID\IMPORT erstellt werden. Der Service Layer entdeckt diese Datei und importiert selbstständig die Daten in die angegebenen Ordner. Anschließend wird diese Datei gelöscht. Sollte der Import fehlschlagen, weil z.B. der angegebene Ordner nicht existiert, so wird die Importdatei mit der Erweiterung »*.BAD« umbenannt (z.B. IMPORT.BAD) und es erfolgt ein Eintrag im Ordner »System - David - Ereignisse«.

Datensatz mit allen Daten
Wenn Sie alle Daten importieren möchten, erstellen Sie eine Zeile mit allen Daten in einer festgelegten Reihenfolge:

Angezeigter Name;Fax;Vorname;2.Vorname;Nachname;Anrede;Titel;
Geburtstag;Firma;Straße;PLZ;Stadt;Land;Bundesland;WebSite;
Geschäftlich;Privat;Mobil;2.Fax;eMail;Voice-Box;SMS/Pager;
Zusatz;Kategorien;2.eMail

Die einzelnen Feldinhalte in einem Datensatz müssen per Semikolon (;) voneinander getrennt werden. Für leere Felder muss ebenfalls jeweils ein Semikolon gesetzt werden. Wenn keine weiteren Daten für den aktuellen Datensatz mehr zu übergeben sind, kann direkt in die nächste Zeile gesprungen werden, ohne abschließende Semikolons angeben zu müssen.

Beispiel:
Sander,Richard;+49 89 123456;Richard;;Sander;Herr;;
01.01.1970;Unserefirma;Dorfstr.4;12345;Kleinstadt;Deutschland;;
http://www.unserefirma.com;;;;;richard.sander@unserefirma.com;;;;
0,1,0,1,0,1,0,1,0,1,0,1,0,1,0,1;sander@thn.net

Datensatz mit ausgewählten Daten
In vielen Fällen werden Sie jedoch nicht alle Felder benötigen. Sie können daher durch einen Parameter die benötigten Felder in der gewünschten Reihenfolge angeben. Geben Sie in einer eigenen Zeile nacheinander die Variablen der Felder an, die Sie verwenden möchten. Die Variablen müssen in eckigen Klammern stehen und durch ein Komma (kein Semikolon!) voneinander getrennt werden. Eine Übersicht der Variablen finden Sie in der Online-Hilfe des David Client (Taste [F1]).

Beispiel:
[ADR_NACHNAME,ADR_VORNAME,ADR_ANGEZEIGTER_NAME,ADR_FAX ]
Richter;Helmut;Richter,Helmut;0815 4711
Büscher;Petra;Meier +Co;0816 4712

Befindet sich ein # Zeichen an erster Stelle einer Zeile, so wird diese Zeile als Kommentar behandelt und dementsprechend beim Import ignoriert. Der Inhalt dieser Zeile wird also nicht ausgewertet.

Kategorien
Wenn Sie beim Import auch die Kategorien berücksichtigen wollen, so setzen Sie an entsprechender Stelle in jede Zeile eine Folge der Ziffern 0 und 1, jeweils durch Komma getrennt. Die erste Ziffer symbolisiert die erste Kategorie, die zweite Ziffer steht für die zweite Kategorie, usw. Dabei bedeutet eine 1, dass der Adresseintrag der zugehörigen Kategorie zugewiesen wird; bei 0 wird die Kategorie nicht gesetzt. Bitte beachten Sie, dass für jede der 16 Kategorien eine entsprechende Ziffer angegeben werden muss. Sollen also einem Adresseintrag die Kategorien 5, 8, 10 und 14 zugeordnet werden, so ist folgender Eintrag einzufügen:

[ADR_NACHNAME,ADR_VORNAME,ADR_ANGEZEIGTER_NAME,ADR_FAX,
ADR_KATEGORIE ]
Richter;Helmut;Richter,Helmut;024527761
Büscher;Petra;Meier +Co;055825;0,0,0,0,1,0,0,1,0,1,0,0,0,1,0,0

Es gibt bei David® maximal 16 Kategorien, deren Namen im Service Layer unter »Datenbank -> Kategorien« definiert sind. Die Standard Bezeichnungen können in diesem Menü geändert werden.

Import in beliebige Ordner
Standardmäßig werden alle importierten Daten im globalen Adressordner »SERVERNAME - Adressen« abgelegt. Wenn Sie die Daten in einen anderen Ordner importieren möchten, müssen Sie diesen Ordner in einer eigenen Zeile in der Importdatei angeben. Die Zeile muss den Servernamen, das Volume und den kompletten Pfad des Ordners enthalten. Die Angaben müssen in eckigen Klammern stehen.

Den Pfad erhalten Sie, indem Sie im Tobit InfoCenter die »Eigenschaften« des Ordners aufrufen (rechte Maustaste oder Menüpunkt »Datei / Eigenschaften«) und hier das blaue Ordner-Symbol anklicken.

Beispiel:
[\\SERVERNAME\DAVID\ARCHIVE\USER\90010002\ADDRESS]
Richter,Helmut;0815 4711;Helmut;;Richter;Herr;;20.12.66
Meier +Co;0816 4712;Petra;;Büscher;Frau

Die erste angegebene Adresse wird gleichzeitig als bevorzugte Adresse für den Versand eingetragen. Mit dem Parameter »Default=0|1|2|3|4|5« können Sie jedoch eine andere Adresse als bevorzugte Adresse angeben. Geben Sie den Parameter »Default« ebenfalls in eckigen Klammern in einer separaten Zeile direkt unterhalb des Variablen-Strings an. Die folgenden Werte sind definiert:

0 = Fax3 = Voice-Box
1 = 2. Fax4 = SMS/Pager
2 = eMail5 = 2. eMail

Beispiel:
[\\SERVERNAME\DAVID\ARCHIVE\USER\10004000\ADDRESS]
[ADR_NACHNAME,ADR_VORNAME,ADR_FAX,ADR_EMAIL]
[DEFAULT=2 ]
Richter;Helmut;0815 4711;richter@unserefirma.de
Büscher;Petra;0816 4712;meier@yourcompany.com

Bei diesem Beispiel wird also jeweils die erste eMail Adresse eines jeden Eintrags als bevorzugte Adresse markiert.

Ordner-Bereinigung vor Import
Beim Importieren der Daten wird nicht überprüft, ob eine Adresse mit gleichen Daten bereits vorhanden ist. Falls eine solche Überprüfung erwünscht ist, können Sie nur mit Hilfe der Zeile [DEL] in der Importdatei veranlassen, dass der Service Layer vor dem Importieren alle im Ziel-Ordner vorhandenen Einträge zuerst löscht und danach die neuen Daten importiert werden.

Beispiel:
[\\SERVERNAME\DAVID\ARCHIVE\USER\10004000\ADDRESS]
[ADR_NACHNAME,ADR_VORNAME,ADR_FAX,ADR_EMAIL]
[DEL ]
[DEFAULT=2]
Richter;Helmut;0815 4711;richter@unserefirma.com
Büscher;Petra;0816 4712;meier@ourcompany.com

Import im ANSI-Format
Als Standard wird beim Adressimport generell der OEM-Zeichensatz erwartet. Die Importdatei sollte also mit einem DOS-Editor erstellt werden. Ist das Erstellen mit einem DOS-Editor jedoch nicht möglich oder nicht erwünscht, kann auch ein Windows-Editor verwendet werden. In diesem Fall basieren die zu importierenden Daten auf dem ANSI-Zeichensatz, was in der Importdatei durch die zusätzliche Zeile [ANSI] zu kennzeichnen ist. Diese Zeile muss zwingend als erste Zeile an den Anfang der Importdatei geschrieben werden.

Beispiel:
[ANSI]
[\\SERVERNAME\DAVID\ARCHIVE\USER\10004000\ADDRESS]
[ADR_NACHNAME,ADR_VORNAME,ADR_FAX,ADR_EMAIL]
[DEL ]
[DEFAULT=2]
Richter;Helmut;0815 4711;richter@unserefirma.com
Büscher;Petra;0816 4712;meier@ourcompany.com

Hinweis:
Weitere Informationen zu dem Thema »Adressbücher« erhalten Sie im KnowledgeBase Artikel 103.074.