Einige Konverter benötigen eine Konfigurationsdatei mit Einstellungen. In der Konfiguration werden Feldzuweisungen, MLXML-Einstellungen sowie individuelle Einstellungen für den jeweiligen Konverter konfiguriert. Die Konfiguration wird in einer INI-Datei gespeichert.
Dieses Kapitel beschreibt nicht den kompletten Umfang der Möglichkeiten. Zur Erstellung der Konfigurationen sollte der MLXML-Business Wizard verwendet werden.
Bereich [Settings]
Name |
Beispiel-Wert |
Beschreibung |
Konverter |
SkipRows |
0 |
Anzahl der Zeilen die zu Beginn des Dokumentes übersprungen werden sollen |
csv-c |
UseHeader |
1 |
Muss auf 1 gesetzt werden, wenn die CSV-Datei Spaltenüberschriften in der 1. Zeile enthält |
csv-c |
Separator |
; |
Zeichen das als Spalten-Trenner verwendet wird |
csv-c |
QuoteChar |
" |
Zeichen das den Inhalt der Spalten abgrenzt |
csv-c |
DateFormat |
dd-mm-yyyy |
Format der Datumswerte |
csv-c |
TimeFormat |
hh:mm:ss |
Format der Zeitwerte |
csv-c |
DateSeparator |
. |
Trennzeichen für Datumswerte |
csv-c |
TimeSeparator |
: |
Trennzeichen für Zeitwerte |
csv-c |
DecimalSeparator |
. |
Dezimal-Trennzeichen für Kommazahlen |
csv-c |
ThousandSeparator |
' |
1000er-Trennzeichen für Zahlenwerte |
csv-c |
ConnectionString |
ADO-Verbindungszeichenfolge für den Verbindungsaufbau zur Datenbank |
ado-c |
|
TableName |
addresses |
Name der SQL-Tabelle*, alternativ können die Daten auch per SQL-Query selektiert werden |
ado-c |
Query |
SELECT [id], [name], [surname], [adress], [zip], [city], [phone1] FROM [addresses] |
SQL-Query*, alternativ kann auch die komplette Tabelle über TableName definiert werden |
ado-c |
* Es sollte jeweils TableName oder Query verwendet werden, nicht aber beides gleichzeitig.
Bereich [MLXML]
Name |
Beispiel-Wert |
Beschreibung |
Konverter |
Application |
Datenbank XY |
Name der Anwendung (Freitext) |
csv-c, ado-c |
PartName |
crm_address |
MLXML-Part, bezeichnet die Art der Daten. Für Adressen muss crm_address angegeben werden. |
csv-c, ado-c |
ItemName |
MLXML-ItemPart, bezeichnet die einzelnen Daten. Wird kein Wert angegeben, wird der Wert automatisch bestimmt |
csv-c, ado-c |
|
PreProcessor |
Nur zur internen Verwendung bestimmt, muss nicht definiert werden. |
||
FileExtension |
Nur zur internen Verwendung bestimmt, muss nicht definiert werden. |
||
UserCaption |
Nur zur internen Verwendung bestimmt, muss nicht definiert werden. |
||
MXCIdentifier |
Nur zur internen Verwendung bestimmt, muss nicht definiert werden. |
||
Parameter |
Nur zur internen Verwendung bestimmt, muss nicht definiert werden. |
Bereich [MLXML Options]
Die verfügbaren Optionen unter [MLXML-Options] hängen von der Anwendung und der zu importierenden Datenart (z.B. Adressen, Postleitzahlen, Banken u.s.w.) ab.
Name |
Beispiel-Wert |
Beschreibung |
Datenart/PartName |
journalnotemode |
2 |
0: Journal-Eintrag für neue Adressen hinzufügen 1: Journal-Eintrag für neue und aktualisierte Adressen hinzufügen 2: Keinen Journal-Eintrag erstellen
Diese Option ist nur für delight crm verfügbar. |
crm_address |
updatecheck |
1 |
Definiert ob beim Importieren auf bereits importierte Daten geprüft werden soll. 1: Prüfen 2: Nicht prüfen |
(alle) |
modifyexisting |
1 |
Definiert ob bereits vorhanden Datensätze aktualisiert werden sollen. Ist nur relevant bei modifyexisting=1.
0: Bereits importierte Datensätze ignorieren. 1: Bereits importierte Datensätze aktualisieren. |
(alle) |
attachmentpath |
Pfad für den Import von externen Dateien auf einen Journal-Eintrag.
Diese Option ist nur für delight crm verfügbar. |
crm_address |
Bereich [Mapping]
In diesem Bereich werden die Felder der Datenquelle den Feldern der Anwendung zugeordnet. Auf der linken Seite (Name) steht jeweils der Feldname aus der Datenquelle, auf der rechten Seite (Wert) der Feldname der Anwendung.
Beispiel:
[Mapping]
Name=name
Vorname=surname
Firma=companyname
Strasse=adress
PLZ=zip
Ort=city
Tel_P=phone1
autonummer=crm_address_ident
Bereich [ConstantValues]
In diesem Bereich können für gewisse Felder konstante Werte definiert werden. Auf der linken Seite (Name) steht der Feldname der Anwendung, auf der rechten Seite (Wert) der konstante Wert.
Beispiel:
[ConstantValues]
acomment=ADO MLXML Import Test
crm_address_source=Demo.mdb
Bereich [DataFormats]
Dieser Bereich wird nur für den csv-c Konverter benötigt. Er definiert, in welchem Format die einzelnen Spalten in der CSV-Datei gespeichert sind. Es werden die Feldnamen nach dem Mapping verwendet (Feldname der Anwendung). Auf der linken Seite (Name) steht der Feldname, auf der rechten Seite (Wert) das Format.
Der Konverter ado-c kann die Datentypen der einzelnen Spalten automatisch bestimmen.
Beispiel:
[DataFormats]
crm_journal_note=Blob
level=Integer
amount=Float
birthday=Date
creadate=DateTime
Bereiche [Replacements_XY]
Um Zeichen oder ganze Zeichenfolgen vor dem Importieren durch Andere zu ersetzen, kann für ein Feld, in dem die Werte ersetzte werden sollen, ein eigener Replacement-Bereich erstellt werden. Auf der linken Seite (Name) steht der Wert der ersetzte werden soll, auf der rechten Seite der neuen Wert.
Beispiel:
[Replacements_countryid]
CH=Schweiz
FR=Frankreich
IT=Italien
Bereich [DeleteSources]
In diesem Bereich können Daten mit einem bestimmten Wert im Quellen-Feld vor dem Import gelöscht werden. Dieser Bereich kann verwendet werden, wenn mit jedem Importlauf andere Daten importiert werden müssen und die vorgängig importierten Daten nicht mehr benötigt werden. Auf der linken Seite (Name) werden die einzelnen Einträge nummeriert, auf der rechten Seite (Wert) steht das Quellen-Feld mit dem jeweiligen Wert.
Beispiel:
[DeleteSources]
1=crm_address_source=Demo.mdb
Bereich [SyncSources]
In diesem Bereich können alle Daten die nicht synchronisiert wurden (mit einem bestimmten Wert im Quellen-Feld) nach dem Import gelöscht werden. Dieser Bereich kann verwendet werden, wenn mit jedem Importlauf Daten die in der Quelle nicht mehr vornanden sind gelöscht werden müssen. Auf der linken Seite (Name) werden die einzelnen Einträge nummeriert, auf der rechten Seite (Wert) steht das Quellen-Feld mit dem jeweiligen Wert. Gelöscht werden alle Datensätze mit dem Wert des Quellen-Feldes die beim aktuellen Importlauf nicht aktualisiert oder neu importiert wurden. Als Prüfschlüssel wird wie beim Update das Schlüssel-Feld verwendet.
Beispiel:
[SyncSources]
1=crm_address_source=Demo.mdb
siehe auch: