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:

  1. Select the type of data source
    • Auswählen der Quelldatenbank. Es können nur Datenquellen ausgewählt werden, für die Lizenzen eingegeben wurden.

  2. 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.
      Verbundene Netzwerklaufwerke sind in einem System und Benutzerkontext nicht bekannt. Wenn Sie auf Dateien auf einem anderen Rechner zugreifen möchten, müssen Sie vollqualifizierte UNC-Pfade verwenden (\\Server\Freigabe\Datei). Beachten Sie, dass der Benutzer bzw. das System Zugriffsrechte auf diese Freigabe und die entsprechende Dateien benötigen. Bei einem ODBC Zugriff müssen Sie den UNC-Pfad manuell in den ODBC Connect String eintragen.
      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.

  3. 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.

  4. Field mapping - Which source fields are copied to which LDAP fields
    • Die Feldzuordnung ist der zentrale Teil der Replikatorenanbindung. Sie müssen zuordnen, welche Quellfelder in welche LDAP Felder kopiert werden sollen. Bei einigen Replikatoren ist eine Standard-Feldzuordnung hinterlegt, die automatisch zugewiesen wird, wenn Sie den Replikator konfigurieren. Teilweise müssen Sie die Feldzuordnung aber auch manuell festlegen.
      Auf der linken Seite sehen Sie die Quellfelder. Neben dem Feldnamen ist der Inhalt des ersten gefundenen Datensatzes abgebildet. Mit den Pfeiltasten unterhalb der Quelle können Sie durch die Datensätze blättern.
      Auf der rechten Seite sehen Sie die LDAP Zielfelder. Neben dem Feldnamen sind die zugeordneten Felder abgebildet. Unterhalb der Zielliste befinden sich die Buttons zum Löschen der gesamten Zuordnung und, sofern vorhanden zum Setzen der Standard-Feldzuordnung.
      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.
        Wenn die Quelldatenbank keinen Primärschlüssel anbietet, verwenden Sie Datenbankfelder, die möglichst eindeutig zu einem Eintrag zugeordnet werden können. Wenn nötig, verketten Sie Felder, um einen eindeutigen Primärschlüssel zu erhalten. Sollten mehrere Datensätze identische Primärschlüssel aufweisen, gehen alle Datensätze nach dem ersten Replizierten verloren. Als alternativen Primärschlüssel können Sie z. B. E-Mail-Adressen verwenden.
      • Beim Feld "Angezeigter Name" wird der Replikator immer versuchen, eine Zuweisung zu machen. Wenn das Feld aus den vorgegebenen Quellfeldern nicht befüllt werden konnte, versucht der Replikator, aus Name, Vorname und Firma oder E-Mail-Adresse einen Inhalt zu generieren.
      • Felder können verkettet werden. Wenn es sich um ein Telefonnummernfeld handelt, werden die Quelldaten direkt aneinander gehängt. In allen anderen Fällen wird ein Leerzeichen dazwischen gestellt. Weitere Konfigurationsmöglichkeiten bieten die erweiterten Feldzuordnungseinstellungen.

    Contactpicture
    Contactimages may be imported by replication in the following ways:
    • Kontaktbilder können von einem erreichbaren Datei- oder Netzwerk-Pfad über das Zuordnen des Feldes Bildpfad eingelesen werden. (wie z. B. Text-, ODBC Replikator)
    • Der Replikator füllt das Kontaktbild-Feld direkt mit Bilddaten (z. B. EWS Replikator). Die Auswahl erfolgt über die angezeigte Checkbox.
    • Mapping eines Quellbildfeldes wie z. B. "thumbnailPhoto" auf das Feld Bild durch den Benutzer. (z. B. AD, LDAP Replikator)
    • Keine Unterstützung von Kontaktbildern, die Felder Bild und Bildpfad werden nicht angezeigt.

    Welche Variante verwendet wird, ist abhängig vom Typ des Replikators. Manche Replikatoren erlauben die Zuordnung zu Bild als auch zu Bildpfad.

  5. Extended Field Assignment Settings
    • The extended field assignment settings permit the integration of complex databases into estos MetaDirectory.
      Mit dieser Konfigurationsoberfläche ist es möglich, Datenbankfelder für die Weiterverwendung zusammenzufügen oder aufzutrennen. Um erweiterte Feldzuordnungseinstellungen vornehmen zu können, müssen Sie im Feldzuordnungsassistenten die Checkbox für erweiterte Einstellungen aktivieren.
      Auf der linken Seite sehen Sie alle LDAP Datenbankfelder, denen Sie Quellfelder zugeordnet haben.
      On the right, you will find the source fields that have been allocated to the respective database fields listed on the left.
      Jedem Quellfeld kann ein beliebiges Präfix und Suffix zugeordnet werden. Reguläre Ausdrücke für jedes Quellfeld bieten umfangreiche Möglichkeiten der Datenmodifikation.
      Auf jedes zugeordnete Quellfeld können Sie einen regulären Ausdruck anwenden. Wenn der Ausdruck nicht zutrifft, können Sie bestimmen, ob der Originalwert des Quellfeldes gesetzt werden soll oder kein Wert.
      Zu jedem zugewiesenen Quellfeld wird versucht, einen Beispielwert aus der Datenbank zu ermitteln. Hierfür werden aus der Quelldatenbank die ersten 20 Datensätze gelesen. Es kann daher sein, dass Sie Werte aus unterschiedlichen Datensätzen der Quelle präsentiert bekommen.
      Die Liste links zeigt den Gesamtzustand der erweiterten Einstellungen je Zielfeld mit folgenden Icons:
      • No advanced settings
      • Valid advanced settings
      • incomplete advanced settings
      • Incorrect advanced settings

      Rechts werden die Einstellungen für alle dem links ausgewählten LDAP Feld zugeordneten Quellfeldern vorgenommen. Die Icons neben dem Namen der Zuordnung zeigen die Auswertungstatus des regulären Ausdrucks:
      • regular expression syntactically correct
      • regular expression syntactically correct, matching test-pattern
      • Ersetzungstext vorhanden, Suchausdruck fehlt
      • incorrect regular expression syntx

      Anwendungsbeispiel:


      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.
      Alternativ:
      Hier können verschiedene Modi ausgewählt werden, wenn der reguläre Ausdruck in den Daten gefunden wird:
      • Feldinhalt unverändert lassen: Die Ersetzung wird auf dem Feldinhalt ausgeführt.
      • Feldinhalt löschen: Der Feldinhalt wird gelöscht.
      • Datensatz auslassen: Der Datensatz wird nicht repliziert.
      • Datensatz löschen: Der Datensatz wird aus der MetaDirectory Datenbank, falls vorhanden, gelöscht.

  6. Kontakt-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.

  7. 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.

  8. 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.
      1. Als zu startendes Programm wird MetaServer.exe festgelegt, z. B.: C:\Programme\estos\MetaDirectory\MetaServer.exe
      2. 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"
      3. Das zu verwendende Benutzerkonto muss jenes sein, unter welchem auch der MetaDirectory Server gestartet wurde. In der Regel ist das [SYSTEM].
  9. 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.

  10. Assigning a name for the new replicator
    • 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 5.0