Erstellen einer Import-Datei - d3oh23olawhmms.cloudfront.net · LOGIN Loginname des Systembenutzers...

7
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

Transcript of Erstellen einer Import-Datei - d3oh23olawhmms.cloudfront.net · LOGIN Loginname des Systembenutzers...

Page 1: Erstellen einer Import-Datei - d3oh23olawhmms.cloudfront.net · LOGIN Loginname des Systembenutzers String 0..255 Zeichen COUNTRY Land ISO 3166-1 Ländercode 2 Buchstaben LANGUAGE

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

Page 2: Erstellen einer Import-Datei - d3oh23olawhmms.cloudfront.net · LOGIN Loginname des Systembenutzers String 0..255 Zeichen COUNTRY Land ISO 3166-1 Ländercode 2 Buchstaben LANGUAGE

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

Page 3: Erstellen einer Import-Datei - d3oh23olawhmms.cloudfront.net · LOGIN Loginname des Systembenutzers String 0..255 Zeichen COUNTRY Land ISO 3166-1 Ländercode 2 Buchstaben LANGUAGE

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

Page 4: Erstellen einer Import-Datei - d3oh23olawhmms.cloudfront.net · LOGIN Loginname des Systembenutzers String 0..255 Zeichen COUNTRY Land ISO 3166-1 Ländercode 2 Buchstaben LANGUAGE

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

Page 5: Erstellen einer Import-Datei - d3oh23olawhmms.cloudfront.net · LOGIN Loginname des Systembenutzers String 0..255 Zeichen COUNTRY Land ISO 3166-1 Ländercode 2 Buchstaben LANGUAGE

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.

Page 6: Erstellen einer Import-Datei - d3oh23olawhmms.cloudfront.net · LOGIN Loginname des Systembenutzers String 0..255 Zeichen COUNTRY Land ISO 3166-1 Ländercode 2 Buchstaben LANGUAGE

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 

Page 7: Erstellen einer Import-Datei - d3oh23olawhmms.cloudfront.net · LOGIN Loginname des Systembenutzers String 0..255 Zeichen COUNTRY Land ISO 3166-1 Ländercode 2 Buchstaben LANGUAGE

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