Replicator Wizard

The Replicator Wizard provides support for integrating a data source into estos MetaDirectory.

Depending on the license available, you can set up import or export replicators.
Import replicators replicate contacts to the MetaDirectory.
Export replicators replicate contacts from the MetaDirectory to another database.

In principle, configuration uses the following steps:

Select the type of data source
- Select the source database. You can only select data sources for which licenses have been entered.

Define the credentials under which the data source can be accessed

Applications can be started in either a user context or a system context. The database is then accessed with the privileges defined by the application. It is therefore important for the system or respective user to have access to the data sources.

	Connected network drives are unknown in a system and user context. If you want to access files on another computer, you must use fully qualified UNC paths (\\ server\share\file). Note that the user or the system require access rights to this share and the corresponding files. With an ODBC access you have to enter the UNC path manually in the ODBC Connect String.
	It should be noted that the replicator configuration is always done in the context of a user. The Administrator will be started using your user rights, thus the Replicator Wizard will also be started with your rights. Access to the source database will be limited using your rights. If the replicator is run with other user rights or in a system context, the replicator will NOT be able to access the data source.
	If you can configure the replicator, but it does not work, check the log file to determine if the source database could be opened. If errors have been recorded then determine which user rights can open the data source.

Settings for the data source (selecting the server, the data structure to be imported, etc.)

Data source settings are strongly tied to the respective data source. Depending on the replicator, you must provide different information regarding the location of the source data.

Field mapping - Which source fields are copied to which LDAP fields

The field assignment is the central part of the replicator connection. You have to assign which source fields are to be copied into which LDAP fields. Some replicators have a default field assignment that is automatically assigned when you configure the replicator. In some cases, however, you also have to define the field assignment manually.
On the left you can see the source fields. The content of the first data record found is shown next to the field name. You can scroll through the data sets with the arrow keys below the source.
On the right side you can see the LDAP target fields. The assigned fields are shown next to the field name. Below the target list are the buttons for deleting the entire assignment and, if available, for setting the standard field assignment.
Both lists use small icons to indicate the field assignments:

Field not in use
Field used once
Field used multiple times

The buttons for loading and saving field assignments will be located in the lower left corner of the dialog. Notes for Field Assignments:

The primary key must be assigned and must be unique for each source record.

Each source database normally uses a corresponding primary key, which you should use.

If the source database does not offer a primary key, use database fields that can be assigned to an entry as clearly as possible. If necessary, concatenate fields to get a unique primary key. If several records have identical primary keys, all records will be lost after the first replication. As an alternative primary key you can e.g. B. Use email addresses.

The replicator will always try to make an assignment for the "Displayed Name" field. If the field could not be filled from the specified source fields, the replicator tries to generate content from the surname, first name and company or email address.
Fields can be concatenated. If it is a telephone number field, the source data are attached directly to one another. In all other cases a space is placed between them. The extended field mapping settings offer further configuration options.

Contactpicture
Contactimages may be imported by replication in the following ways:

Contact pictures can be read in from an accessible file or network path by assigning the field Image path. (such as text, ODBC replicator)
The replicator fills the contact picture field directly with picture data (e.g. EWS replicator). The selection is made via the displayed checkbox.
Mapping of a source image field such as B. "thumbnailPhoto" on the picture field by the user. (e.g. AD, LDAP replicator)
No support for contact pictures, the fields picture and picture path are not displayed.

Which variant is used depends on the type of replicator. Some replicators allow mapping to image as well as image path.

Extended Field Assignment Settings

The extended field assignment settings permit the integration of complex databases into estos MetaDirectory.
With this configuration interface it is possible to combine or split database fields for further use. In order to be able to make advanced field assignment settings, you must activate the checkbox for advanced settings in the field assignment assistant.
On the left you can see all the LDAP database fields to which you have assigned source fields.
On the right, you will find the source fields that have been allocated to the respective database fields listed on the left.
Any prefix and suffix can be assigned to each source field. Regular expressions for each source field provide extensive possibilities for data modification.
You can apply a regular expression to each assigned source field. If the expression does not apply, you can determine whether the original value of the source field should be set or no value.
For each assigned source field, an attempt is made to determine a sample value from the database. For this purpose, the first 20 data records are read from the source database. It is therefore possible that you will be presented with values from different data records of the source.
The list on the left shows the overall state of the advanced settings per target field with the following icons:
- No advanced settings
- Valid advanced settings
- incomplete advanced settings
- Incorrect advanced settings
On the right, the settings for all source fields mapped to the LDAP field selected on the left. The icons next to the mapping name show the evaluation status of the regular expression:
- regular expression syntactically correct
- regular expression syntactically correct, matching test-pattern
- Replacement text exists, search expression is missing
- incorrect regular expression syntx
Example of use:

Eine Datenbank speichert Straße, Hausnummer, PLZ und Ort in einem Datenbankfeld, jeweils durch ein "$" getrennt. Im Datenbankfeld steht also exemplarisch: "Straße$12$12345$Ort".
Um diese Datenbank mit dem estos MetaDirectory verwenden zu können, müssen Sie dieses zusammengefügte Feld aufteilen und den LDAP Datenbankfeldern für Straße, Hausnummer, PLZ und Ort zuweisen. Im Feldzuordnungsassistenten weisen Sie dieses eine Quellfeld allen Zielfeldern zu, die befüllt werden sollen. In unserem Fall sind dies die Felder Straße, PLZ und Ort. Aktivieren Sie die erweiterten Einstellungen, um die jetzt notwendige Konfiguration vornehmen zu können.
Aus der Liste der LDAP Datenfelder wählen Sie den Eintrag "Straße". Auf der rechten Seite tragen Sie bei den regulären Ausdrücken folgende Informationen ein:
- Suche: "(.*)(\$)(.*)(\$)(.*)(\$)(.*)"
- Ersetze: "$1 $3"
Anhand des Icons zum regulären Ausdruck sehen Sie sofort, ob dieser gültig ist. In der Ergebnisliste steht jetzt Straße 12.
Bei den LDAP Datenfeldern PLZ und Ort verhält es sich ähnlich.
Für das Feld "PLZ" tragen Sie folgende Werte ein:
- Suche: "(.*)(\$)(.*)(\$)(.*)(\$)(.*)"
- Ersetze: "$5"
Für das Feld "Ort":
- Suche: "(.*)(\$)(.*)(\$)(.*)(\$)(.*)"
- Ersetze: "$7"
Jetzt haben Sie das Quellfeld passend aufgeteilt und in den Datenbankfeldern wird nach der Replikation der passende Feldinhalt hinterlegt sein.
Weitere Informationen zu den regulären Ausdrücken finden Sie hier.
Alternative:
Different modes can be selected here if the regular expression is not found in the data:
- Leave field content unchanged: The replacement is performed on the field content.
- Delete field content: The field content is deleted.
- Omit record: The record will not be replicated.
- Delete record: The record will be deleted from the MetaDirectory database, if it exists.

Contact URL Links

In jedem Datensatz können drei Kontakt-URL Links konfiguriert werden, mit denen der Kontakt auf andere Web Seiten verweisen kann. Die erste Kontakt URL hat hierbei eine besondere Verwendung bei der Verwendung von estos MetaDirectory mit estos ProCall.
estos ProCall verwendet diese URL bei allen Inhalten, die ausserhalb der Applikation geöffnet werden könnten, ohne dass hierfür der Client gestartet werden muss. So wird diese URL z. B. bei Anrufen in Abwesenheit verwendet. Sie können den Kontakt direkt öffnen, ohne dass estos ProCall gestartet werden muss. Diese URL wird aufgerufen wenn Sie einen Kontakt in estos ProCall zum Bearbeiten öffnen.
Auf LDAP Ebene wird die hier konfigurierte URL im Datenbankfeld directWebLink abgelegt. Dieser Link wird aus Kompatibilitätsgründen zusätzlich in contactURL gespeichert.
Der Link kann alle registrierten URL Handler enthalten. So sind nicht nur http: Links, sondern auch z. B. outlook: Links möglich.
Der Link kann alle Felder des Kontaktes enthalten, die auch im Template Parser verwendet werden können. Das sind z.B. <EntryID> <DisplayName>.
Web-basiertes CRM
Falls der Kontakt aus einer Datenquelle eines Web-basierten CRM-Systems stammt, kann der Link direkt zu dem Kontakt im CRM-System hinterlegt werden. Dazu ist in der Regel die <EntryID> des Kontaktes in der URL einzufügen.
Microsoft® CRM 3.0
Falls der Kontakt aus Microsoft® CRM 3.0 stammt, kann mit der URL http://mscrmserver/sfa/conts/edit.aspx?id=<EntryID> for the contact is possible.
Microsoft Outlook®
Falls der Kontakt aus Microsoft® Outlook/Exchange stammt, so kann mit der URL outlook:<EntryID> der Kontakt mit Microsoft Outlook® geöffnet werden.

Seit Microsoft Outlook® 2007 schreibt Microsoft® den Outlook®-URL-Handler, welcher für diese Funktion notwendig ist, bei der Installation von Outlook® nicht mehr in die Registry.

HCL Notes
Falls der Kontakt aus Notes stammt, so kann mit der URL notes://server/database.nsf/view/<EntryID>?OpenDocument der Kontakt mit Notes geöffnet werden.

Standorteinstellungen der Datenquelle

Die Einstellungen des Standorts einer Datenquelle dienen zur automatischen Formatierung der Rufnummern. Während der Replikation werden die Rufnummern aus der Datenbank in ein kanonisches Format gebracht. Die kanonische Formatierung macht z.B. aus einer Rufnummer wie "08151 368561" die Rufnummer "+498151368561". Die Formatierung wird automatisch durchgeführt und erkennt viele Rufnummernformate.
Country or region of the data source
Geben Sie das Land an, aus dem diese Datenquelle stammt. Ist in der Datenbank eine Rufnummer ohne Landeskennziffer eingetragen (z. B. "030-1234567") muss der Replikator wissen, welche Landeskennziffer verwendet werden soll. Ist nun "Deutschland" ausgewählt, so wird diese Rufnummer zu "+49301234567".
Area Code
Geben Sie hier Ihre eigene Vorwahl ein. Mit dieser Vorwahl können Rufnummern aus dem eigenen Ortsnetz ergänzt werden. Sind in der Datenbank Rufnummern ohne Vorwahl enthalten (z.B. "1234567"), so wird die Vorwahl verwendet, um die Rufnummer zu formatieren. Geben Sie die Vorwahl ohne Prefix ein (z. B. "30" für Berlin).
Primary System Phone Number (system connection)
Sind in der Datenbank interne Rufnummern enthalten (z. B. "210"), muss der Replikator wissen, zu welchem Anschluss diese Rufnummer gehört. Geben Sie die Basisrufnummer Ihres Anschlusses ein. Ist der Teilnehmer "210" unter der Rufnummer "+49-30-12345-210" erreichbar, so geben Sie "12345" als Anlagenrufnummer ein.

Festlegen des Replikations-Zeitplanes

Define when replication should be scheduled and at which intervals this process should be performed.

Replikatoren können auch über die Windows® Aufgabenplanung gestartet werden. Dabei werden die Namen der Replikatoren als Argumente des Parameters "-r" von der MetaServer.exe übernommen oder an eine bereits laufende Instanz zum Start übergeben.

Als zu startendes Programm wird MetaServer.exe festgelegt, z. B.: C:\Programme\estos\MetaDirectory\MetaServer.exe
Argumente: -q -r <replikator1> [<replikator2> <replikator3> ...]
Der Parameter "-q" muss unbedingt angegeben werden! Er verhindert das Öffnen von Messageboxen welche das Beenden der Aufgabe verhindern würden.
Es können mehrere Replikatoren - durch Leerzeichen getrennt - hintereinander angegeben werden.
Replikatoren, die Leerzeichen enthalten, müssen in Hochkommata angegeben werden, z. B.: -q -r "Text CSV File"
Das zu verwendende Benutzerkonto muss jenes sein, unter welchem auch der MetaDirectory Server gestartet wurde. In der Regel ist das [SYSTEM].

Festlegen von zusätzlich zu startenden Anwendungen

Sie können vor und nach dem Replikationsprozess weitere Anwendungen starten. Geben Sie hier den Pfad zur entsprechenden Anwendung an. Die Anwendungen werden vom Replikator gestartet, laufen also mit denselben Rechten wie der Replikator und blockieren bei langen Laufzeiten möglicherweise andere Replikator-Aufrufe.

Vergabe eines Namens für den neuen Replikator

Specify a name for the new replicator. You will not be able to change the name later!

Make sure you know the user context required to access the source database or whether access is possible in a system context.

Version MetaDirectory_5.0

Replicator Wizard

Example of use: