Erstellen einer Import-Datei - d3oh23olawhmms.cloudfront.net · LOGIN Loginname des Systembenutzers...
Transcript of Erstellen einer Import-Datei - d3oh23olawhmms.cloudfront.net · LOGIN Loginname des Systembenutzers...
Aufbau einer Import-Datei
Die zu importierende Datei muss im CSV, XLS oder XLSX-Format vorliegen. Die erste Zeile besteht
aus Spaltenbezeichnern, welche den Aufbau der Datei beschreiben. Die Reihenfolge der Bezeichner ist
beliebig.
Zu beachten ist, dass keine ausgeblendeten Spalten in der Datei vorhanden sind.
Achtung: Beim erstellen der Excel Datei mit Excel treten häufig Probleme auf. Bitte werfen Sie deshalb
vorab einen Blick auf den Artikel Excel-Probleme, um die häufigsten Fehler zu vermeiden.
Die Personen können nur importiert werden, wenn eine der folgenden Bedingungen erfüllt ist:
E-Mail Adresse einer Person ist nicht leer
Anrede und Nachname sind nicht leer
Vorname und Nachname sind nicht leer
Bei Organisationen gilt:
Firmenname ist nicht leer
E-Mail ist nicht leer
Nur wenn eine der Bedingungen erfüllt wird, wird die Person in die Datenbank gespeichert. Somit
ergeben sich auch folgende Felder als Pflichtfelder, die auch in der Ansicht als solche markiert sind:
E-Mail, Vorname, Nachname, Anrede (bei Personen)
E-Mail, Firmenname (bei Organisationen)
Wenn Sie eine "Vorlagen-Datei" benötigen, wählen Sie am besten eine Beispielperson in Ihrem System
und exportieren Sie die Daten. Somit haben Sie immer eine garantiert funktionierende Datei als Vorlage.
Die Erklärung für die Spaltenbezeichnungen finden Sie hier:
Spaltenbezeichnung Beschreibung Typ Wertebereich
BPID Technische ID Zahl 1..50 Zeichen
KEY Kundennummer (falls
vorhanden)
String 1..50 Zeichen
Diese Spalte ist
statisch und kann
durch den Import
nicht verändert
werden.
GROUP Name des
Kontakt-Typs
String 1..50 Zeichen
TYPE Organisation oder
Person
String Bezeichnung "O" führt
zu Anlage einer
Organisation, "P" zur
Anlage einer Person
SALUTATION Anrede String mr: Herr
mrs: Frau
miss: Fräulein
dmr: Lieber
dms: Liebe
mrms: Herr und Frau
fam: Familie
TITLE Titel String dr: Doktor
prdr: Professor Doktor
pr: Professor
co: Firma
mag: Mag.: Mag.
ddr: DDr.
ing: Ing.
di: DI
magfh: Mag. (FH)
mmag: MMag.
bakk: Bakk.
bakkfh: Bakk. (FH)
ba: BA
ma: MA
mba: MBA
msc: MSc
mas: MAS
LASTNAME Nachname String 0..255 Zeichen
FIRSTNAME Vorname String 0..255 Zeichen
COMPANY Firmenname String 0..255 Zeichen
BUILDING Gebäude/Zusatz (Nur
für Organisationen)
String 0..255 Zeichen
DEPARTMENT Abteilung String 0..255 Zeichen
STREET Strasse String 0..255 Zeichen
ZIP Postleitzahl String 0..255 Zeichen
CITY Stadt String 0..255 Zeichen
STATE Region String 0..255 Zeichen
EMAIL E-Mail Adresse String 0..255 Zeichen
MAILSALUTATION Briefanrede String 0..255 Zeichen
ADDRESSADDITION Adresszusatz String 0..255 Zeichen
BIRTHDAY Geburtstag Datum DD.MM.YYYY
PHONE1 Telefonnummer 1 String 0..255 Zeichen
PHONE2 Telefonnummer 2 String 0..255 Zeichen
PHONE3 Telefonnummer 3 String 0..255 Zeichen
FAX Faxnummer String 0..255 Zeichen
INTERNETADDRESS Internetaddresse String 0..255 Zeichen
REMARK Notizen String 0..1000 Zeichen.
Beginnt der Notizentext
mit dem Schlüsselwort
, so wird die Notiz an
den bestehenden Text
angehängt.
Wichtig!
Um die Remark
Notizen zu Ergänzen
muss entweder die
BPID oder der KEY
vorhanden sein.
LOGIN Loginname des
Systembenutzers
String 0..255 Zeichen
COUNTRY Land ISO 3166-1
Ländercode
2 Buchstaben
LANGUAGE Sprache ISO 639-1 Code 2 Buchstaben
CUSTOMERCODE Kundencode String 0..255 Zeichen
USERCODE Benutzercode String 0..255 Zeichen
PERMISSION_EMAIL Erlaubnis E-Mail Zahl
1 = Ja - Manuelle
Einwilligung
2 = Ja - Double
Opt In
Einwilligung
3 = Ja - Single Opt
In Einwilligung
10 = Nein -
Vorläufige
Einwilligung
11 = Nein -
Transaktionsmails
möglich
12 = Nein - Keine
Einwilligung
13 = Nein -
Blacklist
PERMISSION_PHON
E
Erlaubnis Telefon Zahl
0 = keine
Erlaubnis
1 = Erlaubnis
erteilt
PERMISSION_POSTA
L
Erlaubnis Post Zahl
0 = keine
Erlaubnis
1 = Erlaubnis
erteilt
PERMISSION_SMS Erlaubnis SMS Zahl
0 = keine
Erlaubnis
1 = Erlaubnis
erteilt
PERMISSION_FAX Erlaubnis Fax Zahl
0 = keine
Erlaubnis
1 = Erlaubnis
erteilt
PERMISSION_APP Erlaubnis App Zahl
0 = keine
Erlaubnis
1 = Erlaubnis
erteilt
PERMISSION_NOTE Einwilligung
Bemerkung
Freitext - beliebig beliebiger Freitext
PERMISSION_NOTE_
KEY
Einwilligungs-Schlüsse
l
Freitext - einer
folgender Schlüssel
folgende Werte stehen
zur Verfügung (nach
diesen kann später auch
gefiltert werden):
newsletterRegistra
tion
registeredByHome
page
registeredByEmail
registeredByImpor
t
mailingHouseImp
ort
movedAway
pause
emailChanged
deregOpenNewsle
tter
unregistered
disableNewsletter
noInterest
noCustomerAnym
ore
spamComplaint
DELETE Person löschen Funktion Wert, der besagt ob die
person gelöscht werden
soll oder
nicht.Möglicher Wert
ist: Y. Alle anderen
Werte werden als
Erstellen gewertet.
Wichtig!
Um diese Funktion zu
nutzen müssen die
folgenden Spalten in
der Datei vorhanden
sein:
BPID, KEY, EMAIL
FEATURES Merkmale Liste Pipe-separierte Liste
von
Merkmalsnamen/Ids
und Merkmalswerten
(Attribut1=Y|Attribut2
=N)
Bei mehreren Werten
(B2B) werden diese mit
dem Dachsymbol
separiert aufgeführt:
(Mehrfachauswahl=A-
Kunde^B-Kunde) . Im
Falle der
Mehrfachauswahl
bewirkt ein "+" hinter
dem
Gleichheitszeichen,
dass eine Auswahl zu
den bestehenden
Werten hinzugefügt
wird.
Beispiel:
Mehrfachauswahl=+B-
Kunde.
Achtung: Ab der
Version 2.2.5 wird nur
noch Pipe getrennt
unterstützt.
Die
Mehrfachauswahlen
werden mit einem
Dachsymbol separiert,
z.B.
MerkmalN=Attribut1^
Attribut2^Attribut7
PROFILES Profile Liste Pipe-separierte Liste
von Profilen/Ids und
Profilwerten
(Profil1=Y|9872=N)
LINKS Verknüpfungen Liste Kommaseparierte Liste
von Personen die
verknüpft werden
sollen. Der erste
Eintrag der Liste stellt
die Hauptverknüpfung
dar. Der Aufbei eines
Verknüpfungseintrags
ist wie folgt: :
Löschen eines
einzelnen Wertes
Funktion Enthält ein Feld in der
CSV Datei den Wert
so wird das
entsprechende Attribut
bei der zugehörigen
Person auf Leer gesetzt.
Beispiel:
;Gäste=|Branche=|Sales
=Y;
Des Weiteren kann dem zu importierendem Kontakt eine Hauptverknüpfung angefügt werden. Diese
wird je nach gegebenen Parametern neu angelegt oder eine bereits bestehender Kontakt wird bearbeitet.
Für die Hauptverknüpfung können folgende Werte angegeben werden:
ROLE Rolle String 0..255 Zeichen
MAINBPID Technische ID Zahl 1..50 Zeichen
Diese Spalte ist statisch
und kann durch den
Import nicht verändert
werden.
MAINKEY Kundennummer (falls
vorhanden)
String 0..255 Zeichen
MAINTYPE Organisation oder Person String Bezeichnung "O" führt zu
Anlage einer
Organisation, "P" zur
Anlage einer Person
MAINGROUP Name des Kontakt-Typs String 0..255 Zeichen
MAINSALUTATION Anrede String mr: Herr
mrs: Frau
miss: Fräulein
dmr: Lieber
dms: Liebe
mrms: Herr und Frau
fam: Familie
MAINTITLE Titel String dr: Doktor
prdr: Professor Doktor
pr: Professor
co: Firma
mag: Mag.: Mag.
ddr: DDr.
ing: Ing.
di: DI
magfh: Mag. (FH)
mmag: MMag.
bakk: Bakk.
bakkfh: Bakk. (FH)
ba: BA
ma: MA
mba: MBA
msc: MSc
mas: MAS
MAINLANGUAGE Sprache ISO 639-1 Code 2 Buchstaben
MAINLASTNAME Nachname String 0..255 Zeichen
MAINFIRSTNAME Vorname String 0..255 Zeichen
MAINCOMPANY Firma String 0..255 Zeichen
MAINBUILDING Gebäude/Zusatz (nur bei
Organisationen)
String 0..255 Zeichen
MAINDEPARTMENT Abteilung String 0..255 Zeichen
MAINSTREET Straße String 0..255 Zeichen
MAINZIP Postleitzahl String 0..255 Zeichen
MAINCITY Stadt String 0..255 Zeichen
MAINSTATE Region String 0..255 Zeichen
MAINMAILSALUTATI
ON
Briefanrede String 0..255 Zeichen
MAINADDRESSADDIT
ION
Adresszusatz String 0..255 Zeichen
MAINBIRTHDAY Geburtstag Datum DD.MM.YYYY
MAINCOUNTRY Land ISO 3166-1 Ländercode 2 Buchstaben
MAINPHONE1 Telefonnummer 1 String 0..255 Zeichen
MAINPHONE2 Telefonnummer 2 String 0..255 Zeichen
MAINPHONE3 Telefonnummer 3 String 0..255 Zeichen
MAINEMAIL E-Mail String 0..255 Zeichen
MAININTERNET Internetadresse String 0..255 Zeichen