Versions Compared

Old Version 3

changes.mady.by.user mlinkwitz

Saved on

compared with

New Version Current

changes.mady.by.user mlinkwitz

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Diese Tabelle enthält die Konfiguration des Imports, wie die "provides"-Felder der "importer.exe" auf das "antony"-Feld abgebildet werden.

Database field

Description

id

An incremental

Eine inkrementelle id

foreign_source_field

This is the fieldname the

Dies ist der Feldname, den die importer.exe

provides to the AntonyImportModule. This might be the name of a column for ODBC Importer or from a json or so on. This one is specific to the importer.exe

dem AntonyImportModul zur Verfügung stellt. Dies kann der Name einer Spalte für den ODBC-Importer oder einer json-Spalte oder ähnlichem sein.

Die Felder sind Abhängig vom verwendeten Importer.

antony_target_field

This is the field of your configured

Dies ist das Feld des von Ihnen konfigurierten target_type

the

(siehe unten), in das das foreign_source_field

should be written to. Be sure that this field is only mapped once for an import configuration.

For customFields you need to know the <ID> of the field. The easiest way to get this is to open the flexobject in layout mode and copy it from the properties view.

converter_infos

Here you can configure converters to convert the values provided by the importer.exe. Each Converter needs two parameter

  • ConverterName: This is the name of the converter. You might provide some converter within your code or use std. one. There are two defined

    • Expression: Takes a C# Linq Expression to freely convert the value

    • IdLookup: This Converter can be used to lookup an id from the import_state. Is is usefull in combination with import_group

  • ConverterParameter: The parameter the converter takes. The value depends on the converter used

    • Expression: The Expression to use. f. (x)=> x.ToString().ToUpper()

    • Lookup: The mapping_name you want to lookup

An example could be

geschrieben werden soll. Achten Sie darauf, dass dieses Feld nur einmal für eine Importkonfiguration zugeordnet wird.

Für customFields müssen Sie die <ID> des Feldes kennen. Am einfachsten erhalten Sie diese, indem Sie das Flexobjekt im Layoutmodus öffnen und sie aus der Eigenschaftenansicht kopieren. Der Name lautet entsprechend Field_<ID>

converter_infos

Hier können Sie Konverter konfigurieren, um die vom Importer.exebereitgestellten Werte zu konvertieren. Diese sind für kleine Umformungen wie “ToUpper”, “Split” oder sonstiges gedacht. Jeder Konverter benötigt zwei Parameter

  • ConverterName: Dies ist der Name des Konverters. Es sind standardmäßig zwei Konverter definiert

  • Expression: Nimmt einen C# Linq-Ausdruck, um den Wert frei zu konvertieren. Beispiel:

Code Block
languagejson
[{"ConverterName":"Expression","ConverterParameter":"(x) => x.ToUpper()"}]

  • IdLookup: Dieser Konverter kann verwendet werden, um eine Id aus dem import_state nachzuschlagen. Er ist nützlich in Kombination mit import_group für zum Beispiel Ansprechpartner Mappings. Beispiel:

Code Block
languagejson
[
{ 
"ConverterName": "
Expression
IdLookup",
 "ConverterParameter":
"(x) => new int[] { 73, (int.Parse(x.ToString())) }" } ]

Be sure to properly quote the QuotationMarks (“ to \”)

comment

A comment. This can be filled by you to still understand the mapping in 2 days
 "integra"}]

Achten Sie darauf, dass die Eingabe korrekt gequoted wird (" zu \")

comment

Ein Kommentar. Dieser kann von Ihnen ausgefüllt werden, um das Mapping noch in 2 Tagen zu verstehen.

import_configuration_id

The ImportId of the importer. This one is the link to the

Die Id des Imports. Dies ist der Link zur Tabelle _import_configuration

table

List Antony Fields

Of course you want to configure the mapping of the fields to the according antony fields. Therefore you need to know the name of the fields antony provides. You can find them hereNatürlich wollen Sie die Zuordnung der Felder zu den entsprechenden antony-Feldern konfigurieren. Dazu müssen Sie die Namen der Felder kennen, die antony zur Verfügung stellt. Sie können sie hier finden

Contact

TargetType: “antony://contact”

Customfields of contacts can be added by placing Field_n within the antony_field. The n is the id of the customfield itselve. You can either grab is from antonys visual editor or the table instance_customfields

Antony Mapping Field

.net Data-Type

Comments

MainContactId

System.Int64This is the id of antonys main contact, if the contact wants to be a subcontact. Normally you wont have this present within the foreign system - So you need to map them. Therefore you can use the build in Converter “IdLookup” and provide the mapping_name of the corresponding import. The importer will resolve antonys MainContactId automatically

Dies ist die Id von antonys' Hauptkontakt, wenn der Kontakt ein Unterkontakt sein möchte. Normalerweise ist diese im Fremdsystem nicht vorhanden, denn dort sind natürlich nur die Ids des jeweiligen Fremdsystems enthalten.

Zum Mappen können Sie den eingebauten Konverter IdLookup verwenden und den mapping_name des entsprechenden Imports angeben. Der Importer wird antonys MainContactId automatisch auflösen.

Code Block
languagejson
[{ "ConverterName": "IdLookup", "ConverterParameter": "integra"}]
If the given main contact isn't present within antonys import mapping, the crearted contact will be a normal main contact
Wenn der angegebene Hauptkontakt nicht im Importmapping enthalten ist, wird der neue Kontakt als normaler Hauptkontakt angelegt
Damit das IdLookup funktioniert müssen die Importe in der selben import_group sein
TitleId
System.Int64
The id of the title of the contact. You can find them in the table Die ID des Titels des Kontakts. Sie können sie in der Tabelle type_title finden
Company 
System.String
Firstname 
System.String
Lastname
System.String
Street
System.String
Zipcode
System.String
City
System.String
State 
System.Int64
The id of the state. You can find it them in the table Die ID des Bundeslandes. Sie finden sie in der Tabelle type_state
CountryId 
System.Int64
The id of the country. You can find them in the table Die ID des Landes. Sie können sie in der Tabelle type_contry finden
Phone
System.String
Phone2
System.String
Fax
System.String
Email
System.String
Mobile
System.String
Homepage
System.String
Comment
System.String
StreetPrivate
System.String
ZipcodePrivate 
System.String
CityPrivate 
System.String
StatePrivate 
System.Int64
The id of the state. You can find it them in the table Die private ID des Bundeslands. Sie finden sie in der Tabelle type_state
CountryIdPrivate 
System.Int64
The id of the country. You can find them in the table Die private ID des Landes. Sie können sie in der Tabelle type_contry finden
PhonePrivate 
System.String
Phone2Private 
System.String
FaxPrivate 
System.String
Department 
System.String
Picture 
Byte[]
Birthday 
System.DateTime
Be sure to place LocalTime hereStellen Sie sicher, dass Sie hier LocalTime verwenden
ContactGroup 
System.Boolean
This is a write only property. If you pass a contact group here the contact will be added to the given contact group. The present contact will not be removed from existing ones
Wenn Sie hier eine Kontaktgruppe angeben, wird der Kontakt zu der angegebenen Kontaktgruppe hinzugefügt. Der aktuelle Kontakt wird nicht aus den bestehenden Gruppen entfernt.
Benutzerdefinierte Felder von Kontakten können hinzugefügt werden, indem Feld_n in das Feld antony_field eingetragen wird. Das n ist die ID des benutzerdefinierten Feldes selbst. Sie können es entweder aus dem visuellen Editor von antony oder aus der Tabelle instance_customfields übernehmen
Appointment
TargetType: “antony://appointment”
Antony Mapping Field
.net Data-Type
Comments
UID
System.Int64
Sequence 
System.Int64
AllDay 
System.Boolean
StartDateTime 
System.DateTime
LOCALTIMEDie Angaben sind hier in LocalTime!
EndDateTime 
System.DateTime
LOCALTIMEDie Angaben sind hier in LocalTime!
Subject 
System.String
Location 
System.String
Description 
System.String
Label 
System.Int64
Status 
System.Int64
IsPrivate 
System.Boolean
HasReminder 
System.Boolean
True, if a reminder is configuredwenn eine Erinnerung konfiguriert ist
ReminderTimeBeforeStart 
System.Int64
The number of nanoseconds of the reminder time.
This is some kind of technical dept
Die Anzahl der Nanosekunden der Erinnerungszeit.
Die Angabe in Nanosekunden ist historisch bedingt.
ResourceIds 
List`1
The ids of the resource the appointment should be placed in. You can find them within the antony admin.
Example converter_infos placing an appointment within calendar 73 and the mapped fieldDie IDs der Kalender, in die der Termin gelegt werden soll. Sie finden sie im Administator, wenn Sie sich dort die Spalte Ideinblenden lassen.
Beispiel für converter_infos, welche Termin im Kalender 73 und dem zugeordneten Feld eintragen.
 Code Block
languagejson
[{"ConverterName":"Expression","ConverterParameter":"(x) => new int[] { 73, (int.Parse(x.ToString()))  }"}]
Creating recurring appointments is not supportedDas Erstellen von wiederkehrenden Terminen wird nicht unterstützt.
Flexobjects
The importer is also able to import flexobjects, which are configured within your environment. As a flexobject only contains CustomFields you need to look them up. They can be added by placing Field_n within the antony_field. The n is the id of the customfield itselve. You can either grab is from antonys visual editor or the table instance_customfieldsDer Importer kann auch Flexobjekte importieren, die in Ihrer Umgebung konfiguriert sind. Da ein Flexobjekt nur CustomFields enthält, müssen Sie diese nachschlagen. Sie können hinzugefügt werden, indem man Field_n innerhalb des antony_field platziert. Das n ist die ID des Customfields selbst. Sie können sie entweder aus dem visuellen Editor von antony oder aus der Tabelle instance_customfields abrufen
TargetType: “antony://flexobject/<type_id>”
The Die type_id is the id of the type of the flexobject itselve. You can find it in the table flexobject
Conclusion
The import is a powerful but complex tool to import any data from an external datasource. You can also write a custom importer to grab data from your custom source. 
If you have troubles to get your import up an running, please contact us ist die ID des Typs des Flexobjects selbst. Sie finden sie in der Tabelle flexobject
Fazit
Der Import ist ein leistungsstarkes, aber komplexes Werkzeug zum Importieren beliebiger Daten aus einer externen Datenquelle. Sie können zu den Standardimportern auch einen benutzerdefinierten Importer schreiben, um Daten aus Ihrer benutzerdefinierten Quelle zu holen. 
Wenn Sie Probleme haben, Ihren Import zum Laufen zu bringen, kontaktieren Sie uns bitte.