Installations- und Kurzdokumentation ExchangeSync Webservices. Version 2.26

Transkript

1 Installations- und Kurzdokumentation Webservices Version 2.26

2 Inhalt 1 Voraussetzungen Der FlowFact Sync Service Dienst Microsoft Exchange Server Updates von älteren Versionen Anpassungen bei gleichzeitiger Verwendung von BlackBarry 4 2 Komponenten Der Dienst Die installierten Komponenten Das Mapping 5 3 Konfiguration Konfiguration für den Dienst Konfiguration für die Synchronisation 7 4 Berechtigungen 10 5 Synchronisationsregeln Allgemeines Adressen / Kontakte Private Kontakte / Adressen Termine Private Termine s Wichtigkeit (Priorität) Aufgaben Notizen Objekte 15 6 Konfigurationsdateien Die SyncSettings.config Aufbau der Datei Erklärung FlowFact.Connectivity.Authentication..dll.Config Aufbau der Datei Erklärung Flowfact.connectivity.connectors.flowfact.dll.config Aufbau der Datei Erklärung Flowfact.connectivity.connectors.exchange.dll.config Aufbau der Datei Erklärung 21 7 Bekannte Probleme 23 8 Kontakt 24 Webservices Stand :43:00 Seite 2 / 24

3 1 Voraussetzungen 1.1 Der FlowFact Sync Service Dienst Auf dem Rechner auf dem der FlowFact Synchronisations Service lauffähig installiert werden soll, sind folgende Punkte zu beachten: Es handelt sich um einen Rechner mit Microsoft Windows Betriebsystem XP, Vista, Windows7 oder Windows Server 2003/2008 Das Microsoft.NET Framework 2.0 ist installiert. Auf einem 64 Bit Betriebssystem muß das.net Framework in der 32 bit Version installiert sein Dem Dienst muss es möglich sein, auf den Exchange Server per http(s) zuzugreifen. Der Windowsbenutzer in dessen Kontext der Sync Dienst läuft benötigt folgende Rechte: 1. Technischen Zugriff auf die FlowFact Datenbank (TCP/IP Port 1433) 2. Schreib-/Leserechte auf Verzeichnis-/Dateiebene für das entsprechende FlowFact Verzeichnis 3. Schreib-/Leserechte auf Verzeichnis-/Dateiebene für das eigene Installationsverzeichnis des Sync Dienstes 4. Es wird die Angabe des korrekten UNC-Pfades empfohlen. (UNC = Universal Naming Convention) Exchange Server ab Version 2007 mit installierten Exchange Web Services (EWS) Ein zentraler Benutzer auf dem ExchangeServer, der auf die Postfächer, die synchronisiert werden sollen, Lese- und Schreibrechte besitzt. 1.2 Microsoft Exchange Server Abbildung 1: : Kommunikation mit ExchangeServer Der Zugriff auf das Microsoft Exchange Storage erfolgt über die Exchange Web Services (EWS). Der FlowFact SyncService kommuniziert mit dem Exchange Server über den Austausch von SOAP (Simple Object Access Protocol) Nachrichten der Version 1.1 bzw 1.2. SOAP ist ein XML basiertes Protokoll, das vom World Wide Web Consortium (W3C) definiert wurde. Die SOAP Nachrichten werdenals eingebettet in HTTP 1. Nachrichten zwischen dem ExchangeServer und dem FlowFact SyncService ausgetauscht. Das HTTP Protokoll ist im RFC Standard 2616 definiert. Webservices Stand :43:00 Seite 3 / 24

4 Für den Zugriff des Connectors auf das Exchange System sind nachfolgend genannte Voraussetzungen erforderlich. Zugriff mittels HTTP (TCP 80) oder HTTPS (TCP 443). Authentifizierung mittels Windows Authentifizierung. Ein Active Directory Benutzeraccount mit Vollzugriff auf alle Exchange Postfächer die abgeglichen werden sollen. Der Zugriff kann wie unter beschrieben entsprechend gewährt werden. Im ExchangeServer ist nur eine SMTP-Adresse und keine x400-adresse als Hauptadresse eingetragen. 1.3 Updates von älteren Versionen Bei der Umstellung des Sync Dienstes von einer alten Version bis 2.24, bei der die Kommunikation noch auf dem WebDav Protokoll beruht, muß eine vollständige Rücksetzung der Exchange Konten, die bereits Synchronisiert worden sind, erfolgen. Geschieht dies nicht so führt dies sowohl auf dem ExchangeServer als auch in FlowFact zu Dubletten. Hierzu einfach wie unter 3.1 beschrieben die Checkbox für Exchange 2010 Schnittstelle verwenden aktivieren. Für alle Aktualisierungen des Sync Dienstes, die bereits die Kommunikation über die Exchange Web Services (EWS) verwenden ist eine Neuinstallation nicht erforderlich. Es müssen lediglich die beschriebenen Dateien in das bestehende Installationsverzeichnis kopiert zu werden. Vorab muss der FlowFact Sync Service Dienst gestoppt werden. ACHTUNG: Wurde bereits mit dem Sync-Dienst synchronisiert und es sollen die Konfigurationsdateien FlowFact.Connectivity.Connectors.FlowFact.dll.config und FlowFact.Connectivity.Connectors.Exchange.dll.config neu geschrieben werden, so ist unbedingt darauf zu achten, dass die jeweiligen ConnectorID s gleich bleiben, da es sonst zu Dubletten kommt. Daher empfiehlt es sich von den Konfigurationsdateien nach der erfolgreichen Einrichtung des Dienstes eine Sicherung vorzunehmen. 1.4 Anpassungen bei gleichzeitiger Verwendung von BlackBerry Bei gleichzeitiger Verwendung von BlackBerry auf dem Exchange-Server muss in der Flow- Fact.Connectivity.Connectors.FlowFact.dll.config der Wert AllowToSetUndone auf false gesetzt werden. Diese Einstellung verhindert, dass der Sync-Dienst Synchronisationselemente, die in FlowFact bereits auf erledigt gesetzt sind, wieder auf unerledigt setzt. Die Datei Fact.Connectivity.Connectors.FlowFact.dll.config ist nach dem erstmaligen Aufruf der Konfiguration angelegt. Webservices Stand :43:00 Seite 4 / 24

5 2 Komponenten Folgende Komponenten werden auf dem Server installiert. Mit dem MSI Installationspaket (Setup.msi) werden diese in das $programfiles\flowfact\syncservice Verzeichnis kopiert. Das Verzeichnis wird gegebenenfalls neu angelegt. 2.1 Der Dienst Der Dienst wird als Windows Dienst FlowFactSyncService installiert. Nach der Installation wird der Dienst nicht automatisch gestartet. Dies muss manuell über die Computerverwaltung getan werden. 2.2 Die installierten Komponenten FFSyncService.exe FlowFact.Connectivity.Core.dll FlowFact.Connectivity.Syncmanager.dll FlowFact.Utilities.AutoUpdate.dll FlowFact.Connectivity.Authentication..dll FlowFact.Connectivity.Connectors.FlowFact.dll FlowFact.Connectivity.Connectors.Exchange2.dll Independentsoft.Exchange.dll SyncSettings.config 2.3 Das Mapping Für die Synchronisation ist ein Mapping (Eindeutige Zuordnungsinformationen von Elementen der beteiligten Systeme) von Daten erforderlich. Bei der Mappingmethode FlowFact werden diese Informationen in der FlowFact Datenbank als X_ Tabellen gespeichert. Diese Tabellen werden automatisch vom Dienst bei der Synchronisation erstellt. Es werden insgesamt 6 Tabellen angelegt. Dies geschieht auch dann, wenn nicht alle benötigt werden. X_FFSYNC_CONTACTS X_FFSYNC_APPOINTMENTS X_FFSYNC_MESSAGES X_FFSYNC_TASKS X_FFSYNC_ESTATES X_FFSYNC_NOTES Die Datenstruktur ist bei allen Tabellen gleich aufgebaut. LeftConnectorID varchar (50) NULL LeftItemID varchar (50) NULL LeftUserID varchar (50) NULL RightConnectorID varchar (1000) NULL RightItemID varchar (50) NULL RightUserID varchar (250) NULL Webservices Stand :43:00 Seite 5 / 24

6 3 Konfiguration 3.1 Konfiguration für den Dienst In der SyncSettings.config Datei sind alle vom Dienst benötigten Informationen gespeichert. Diese Datei muss im gleichen Verzeichnis liegen, wie der Dienst selbst. Sie wird bei der Installation angelegt und muss eventuell einmalig angepasst werden. Eine Dokumentation dieser Konfigurationsdatei befindet sich in Kapitel 5. Die Konfiguration kann im interaktiven Modus des Dienstes durchgeführt werden. Hierzu starten Sie entweder die FFSyncService.exe über die Kommandozeile mit dem Parameter i oder erstellen eine Verknüpfung auf diese Datei und fügen diesen Parameter in den Eigenschaften der Verknüpfung Registerkarte Verknüpfung Feld Ziel hinzu. Anschließend starten Sie die Exe über diese Verknüpfung. Webservices Stand :43:00 Seite 6 / 24

7 3.2 Konfiguration für die Synchronisation Die Konfigurationsinformationen werden in drei Konfigurationsdateien gespeichert. Dieses sind: FlowFact.Connectivity.Authentication.FlowFactExchange.dll.Config FlowFact.Connectivity.Connectors.FlowFact.dll.config bei Verwendung der Exchange 2010 Schnittstelle FlowFact.Connectivity.Connectors.Exchange2.dll.config ansonsten FlowFact.Connectivity.Connectors.Exchange.dll.config Auf dieses Verzeichnis braucht der Syncdienst und der Benutzer, der die Benutzerzuordnung durchführt Schreib-/Leserechte. (Siehe auch 1) Eine weitere Beschreibung dieser Konfigurationsdateien befindet sich in Kapitel 5. Die Konfiguration starten Sie wie bereits unter 3.1 beschrieben. Geben Sie zunächst an, ob die ExchangeWebServices (nur Exchange2007 und Exchange2010) verwendet werden sollen. Hierzu ist die Checkbox Exchange2010 Schnittstelle verwenden zu aktivieren. Andernfalls wird die alte Webdav Schnittstelle (Exchange2003 bzw. teilweise Exchange 2007) verwendet. Webservices Stand :43:00 Seite 7 / 24

8 Geben Sie das korrekte FlowFact-Verzeichnis an, um die Benutzerzuordnung vornehmen zu können. Geben Sie die entsprechenden Servereinstellungen an. Für den standardmäßigen Zugriff auf die ExchangeWebServices geben Sie bitte hinter der Serveradresse /ews/ an. Geben Sie alle zu synchronisierenden Benutzer im Register Benutzerzuordnung an. Webservices Stand :43:00 Seite 8 / 24

9 Die Synchronisation der Unterordner wird nicht mehr unterstützt. HINWEIS: Diese Funktion wird unter der Exchange 2010 Schnittstelle nicht mehr unterstützt. Webservices Stand :43:00 Seite 9 / 24

10 4 Berechtigungen 4.1 Benötigte Berechtigungen für das Dienstekonto Der Windowsbenutzer in dessen Kontext der Sync Dienst läuft benötigt folgende Rechte: 5. Technischen Zugriff auf die FlowFact Datenbank (TCP/IP Port 1433) 6. Schreib-/Leserechte auf Verzeichnis-/Dateiebene für das entsprechende FlowFact Verzeichnis 7. Schreib-/Leserechte auf Verzeichnis-/Dateiebene für das eigene Installationsverzeichnis des Sync Dienstes 8. Es wird die Angabe des korrekten UNC-Pfades empfohlen. (UNC = Universal Naming Convention) 4.2 Benötigte Berechtigungen für den Synchronisationsbenutzer Der in der Exchange-Konfiguration eingetragene Benutzer, der alle eingetragenen Konten synchronisiert, muss auf diese Konten im Exchange Server zugriff haben, so dass dieser sich anmelden kann, Elemente auslesen, anlegen und löschen kann. Auch Unterordner muss dieser anlegen können Einstellung der Berechtigungen auf dem Exchange Server 2010 Zuerst muss im Active Directory ein neuer Benutzer, der die Synchronisation durchführt, angelegt werden. Dieser ist als normaler Domänen-Benutzer, sofern nicht vom Installationsstandard abweichende Policies eingestellt wurden. Für alle Benutzer, die Synchronisiert werden sollen ist über die Exchange-Verwaltungskonsole das Postfachfeature Outlook Web App zu aktivieren. Abb.: Outlook Web App aktivieren in Exchange-Verwaltungskonsole Webservices Stand :43:00 Seite 10 / 24

11 Zusätzlich ist über die Exchange-Verwaltungskonsole dem Benutzer, über den synchronisiert wird (Konfiguration SyncService) auf die entsprechenden Postfachspeichern unter Berechtigung Vollzugriff verwalten die Berechtigungen zu gewähren. Abb.: Berechtigungen verwalten in Exchange-Verwaltungskonsole HINWEIS: Eventuell wirken sich die Berechtigungsänderungen auf dem Postfachspeicher erst nach einem Neustart des Postfachspeicher-Dienstes aus. 4.3 Übernommene Berechtigungen aus FlowFact bei Anlage eine neuen Elementes Für alle s, Termine und Aufgaben die über den Synchronisationsdienst in FlowFact neu erstellt werden, wird die Berechtigung, der bei dem jeweiligen Benutzer in den Benutzereinstellungen Registerkarte Berechtigung Standard-Rechteschablone eingestellten Rechte, vergeben. 4.4 Berechtigungen in Flowfact Für alle s, Termine und Aufgaben, die über den Synchronisationsdienst in FlowFact neu erstellt werden, wird die Berechtigung, der bei dem jeweiligen Benutzer in den Benutzereinstellungen Registerkarte Berechtigung Standard-Rechteschablone eingestellten Rechte, vergeben. Wenn jedoch Aufgaben bzw. Termine im Exchange als Privat gekennzeichnet sind, so werden diese in Flowfact nur mit den Berechtigungen für den jeweiligen Benutzer versehen. Über die Einstellungen <SetAllTasksAsPrivate>, <SetAllMessagesAsPrivate> und <SetAllAppointmentsAsPrivate> in der Konfigurationsdatei Flowfact.connectivity.connectors.flowfact.dll.config können generell alle Aufgaben, s und Termine nur mit den Berechtigungen für den jeweiligen Benutzer versehen werden. Die Rechteschablone wird dann nicht mehr berücksichtigt. 4.5 Merkmale Bei der Synchronisation werden alle Elemente, die in FlowFact neu angelegt werden, mit dem jeweiligen Benutzermerkmal versehen. Webservices Stand :43:00 Seite 11 / 24

12 Aus FlowFact werden für die Synchronisation alle Elemente ausgelesen, die die unter 5.5, 5.3, 5.4 und 5.5 beschriebenen Merkmale haben. HINWEIS: Unter dem jeweiligen Benutzers Registerkarte Dienste/Outlook und Registerkarte Wiedervorlage eingestellten Merkmale muss jeweils immer mindestens das Benutzermerkmal eingetragen sein, da es sonst zu folgendem Effekt kommt: Neuer Eintrag in Exchange, Eintrag wird nach FlowFact übertragen und mit dem Benutzermerkmal versehen, Eintrag wird in FlowFact geändert, es werden aber nur Eintrage mit den Benutzers Registerkarte Dienste/Outlook und Registerkarte Wiedervorlage eingestellten Merkmale nach Exchange synchronisiert, Element verschwindet im Exchange Webservices Stand :43:00 Seite 12 / 24

13 5 Synchronisationsregeln 5.1 Allgemeines Es werden immer alle Elemente aus FlowFact heraus synchronisiert, die das entsprechende Benutzermerkmal besitzen. Wird dieses Merkmal entfernt so wird das Element auf dem Exchange Server und somit auch auf dem PDA gelöscht. Wird ein Element auf dem Exchange Server bzw. PDA gelöscht wird in FlowFact nur jeweils das Benutzermerkmal entfern. 5.2 Adressen / Kontakte Alle Adressen, denen einer in den Benutzereinstellungen des jeweiligen Benutzers Registerkarte Dienste/Outlook eingestellten Merkmale zugeordnet ist, werden synchronisiert. Zudem werden die Adressen synchronisiert, die mit einem Termin verknüpft sind. Der Termin muss dann das entsprechende Benutzermerkmal tragen. Hierbei ist es jedoch gleichgültig, welches Merkmal auf der entsprechenden Adresse gesetzt ist. Die FlowFact Adresse wird immer nur in die geschäftliche Adresse im Exchange-Kontakt synchronisiert. Alle weiteren Adressen des Exchange-Kontaktes werden nicht synchronisiert Private Kontakte / Adressen Wird nicht mehr unterstützt. 5.3 Termine Alle Termine, denen einer in den Benutzereinstellungen des jeweiligen Benutzers Registerkarte Wiedervorlage eingestellten Merkmale zugeordnet ist, werden synchronisiert. Dies sind alle Aktivitäten in FlowFact mit den Aktivitätenarten, die in den Einstellungen für den Kalender definiert wurden, werden als Termin synchronisiert. Die entsprechenden Aktivitätenartenbezeichnungen werden mit vor den Betreff geschrieben. Beispiel: Aktivitätenart: Besichtigungstermin Betreff: Objekt 0815 Wird synchronisiert zu: Betreff: Besichtigungstermin Objekt 0815 Es werden nur Termine synchronisiert, die maximal x Tage in FlowFact zurückliegen. Dieser Wert kann über die Datei flowfact.connectivity.connectors.flowfact.dll.config mit <MaxAppointmentTimeSpan>90</MaxAppointmentTimeSpan> konfiguriert werden Private Termine Werden Termine im Exchange angelegt und die Vertraulichkeit auf Privat gesetzt, werden diese in FlowFact als privater Termin eingetragen (Berechtigung Nur Sie). Webservices Stand :43:00 Seite 13 / 24

14 Werden Termine in FlowFact mit dieser Berechtigung angelegt, wird der Termin im Exchange als privat markiert Serientermine Es werden standardmäßig immer nur die im Exchange eingetragenen Serientermine der letzten 30 Tage und 180 Tage in die Zukunft synchronisiert. Diese Werte sind über die Eigenschaft <MaxAppointmentTimeSpan>180</MaxAppointmentTimeSpan> und <MaxAppointment- TimeSpanPast>30</MaxAppointmentTimeSpanPast> in der Datei flowfact.connectivity.connectors.exchange2.dll.config zu konfigurierbaren. Nach einem Monatswechsel wird dieser Zeitraum dann ausgehend von der Ausführungszeit erneut synchronisiert. Die Serientermine sind immer einer Serie im Exchange zugeordnet. Diese Serie wird nach Flow- Fact als erledigter Termin mit dem Datum synchronisiert. Wird dieses Element in FlowFact gelöscht oder das Merkmal entfernt wird die vollständige Serie mit allen Serienelementen im Exchange gelöscht s Alle s, unabhängig des Merkmals, werden aus dem Posteingang synchronisiert. Eine empfangene ist immer persönlich und kann zwar über das Merkmal einem anderen Benutzer in die Wiedervorlage gelegt werden, aber niemals den Besitz ändern. s, die zwar das Benutzermerkmal des Syncbenutzers haben aber nicht im jeweiligen Posteingang liegen, werden als Aufgaben synchronisiert. Bei Änderungen werden nur der Betreff, Notiz und die Attachments übertragen und geändert. Posteingang. Alle s, die ein Benutzer in FlowFact oder über den Exchange-Server erhält werden synchronisiert. Gesendete s: Alle gesendeten s werden synchronisiert. Wird auf s auf dem mobilen Endgerät geantwortet, werden diese synchronisiert und wenn möglich mit der ursprünglichen als Vorgangsaktivität verknüpft. s, die in FlowFact auf erledigt gesetzt werden, können automatisch auf dem Exchange Server gelöscht werden, wenn in der flowfact.connectivity.connectors.exchange2.dll.config unter <DeleteCompletedMessages>true</DeleteCompletedMessages> eingestellt ist. Über <CompletedMessagesFolder>Erledigt</CompletedMessagesFolder> in der obigen config-datei wird ein Ordner für erledigte s angelegt. Werden auf dem Endgerät(PDA) s in diesen Ordner verschoben, so werden die entsprechenden Aktivitäten in FlowFact auf erledigt gesetzt Wichtigkeit (Priorität) s mit der Wichtigkeit hoch werden nach FlowFact mit der unter den Grundeinstellungen eingestellte Priorität, die an der 1. Zeile steht (Standard sehr wichtig ), versehen. Die Wichtigkeit niedrig wird mit der in der 3. Zeile stehende Priorität (Standard nicht wichtig versehen. Alle anderen werden mit der Priorität aus der 2. Zeile (Standard normal ) versehen. Alle Mails aus FlowFact mit der Priorität, die in den Grundeinstellungen in Zeile 1 steht, werden im Exchange-Server mit der Wichtigkeit hoch versehen, die Mails mit der Priorität aus der Zeile 3 mit der Wichtigkeit niedrig und alle anderen mit der Wichtigkeit normal. Webservices Stand :43:00 Seite 14 / 24

15 5.5 Aufgaben Alle Aufgaben, denen einer in den Benutzereinstellungen des jeweiligen Benutzers Registerkarte Wiedervorlage eingestellten Merkmale zugeordnet ist, werden synchronisiert. Alle Aufgaben auf dem Exchange Server, die sich in den Aufgabenunterordnern von Aufgaben befinden, werden synchronisiert. Alle über den Exchange-Server neu angelegten Aufgaben werden mit der dem Service Konfigurations-Tool eingestellten Aktivitätenart für Aufgaben nach FlowFact synchronisiert. Alle über den Exchange-Server(Mobilen-Endgeräte) neu angelegten Aufgaben werden mit der im Manager Konfigurations-Tool eingestellten Aktivitätenart für Aufgaben nach FlowFact synchronisiert. Welche Aktivitäten werden aus FlowFact als Aufgaben synchronisiert Aus FlowFact werden alle Aktivitäten als Aufgaben zum Exchange Server synchronisiert, die nicht ein- oder ausgehende , Termine oder Notizen sind. Als Notizen gelten die Aktivitäten, mit der in der Konfiguration unter FlowFact bei Notizen eingestellten Aktivitätenart. Es werden nur die Aktivitäten berücksichtigt, deren Priorität gleichwertig und höher ist als der unter dem Benutzer eingestellten Priorität für die Wiedervorlage. Wird nachträglich diese eingestellt Priorität geändert, so werden die Aufgaben im Exchange- Server gelöscht, sofern in FlowFact das Änderungsdatum zwischen dem letzten Synchronisationsdatum und dem aktuell laufenden Synchronisationsdatum liegt. 5.6 Notizen Notizen werden derzeit nicht synchronisiert. 5.7 Objekte Objekte werden derzeit nicht synchronisiert. Webservices Stand :43:00 Seite 15 / 24

16 6 Konfigurationsdateien 6.1 Die SyncSettings.config Dies ist die zentrale Konfigurationsdatei, in der die wesentlichen Einstellungen für die Synchronisation vorgenommen werden. Diese Datei muss im gleichen Verzeichnis liegen, wie der Dienst/Anwendung selbst. Sie wird bei der Installation angelegt und muss einmalig angepasst werden. Es können mehrere Jobs angegeben werden. Z.B. ein Job, der Kontakte und Aufgaben synchronisiert und ein weiterer, der nur s synchronisiert Aufbau der Datei <?xml version="1.0" encoding="utf-8"?> <SynchronisationSettings xmlns:xsd=" xmlns:xsi=" <Interval>10</Interval> <StartSyncTime> T14:03: :00</StartSyncTime> <MappingMode>FlowFact</MappingMode> <Logging>Default</Logging> <AllowAutoUpdates>false</AllowAutoUpdates> <JumpOverSyncProblems>true</JumpOverSyncProblems> <Jobs> <SynchronisationJob JobID="1" JobPath="" LeftSyncConnector="FlowFact.Connectivity.Connectors.FlowFact.dll,FlowFact.Connectivity.Connectors.FlowFact.Conne ctor" RightSyncConnector="FlowFact.Connectivity.Connectors.Exchange2.dll,FlowFact.Connectivity.Connectors.Exchange2.Con nector" AuthenticationConnector="FlowFact.Connectivity.Authentication..dll,FlowFact.Connectivity.Authentication.Ex changesync.connector"> <Items> <ItemSetting Type="Contact" Mode="Peer" /> <ItemSetting Type="Message" Mode="Peer" /> <ItemSetting Type="Appointment" Mode="Peer" /> <ItemSetting Type="Task" Mode="Peer" /> </Items> </SynchronisationJob> </Jobs> </SynchronisationSettings> Erklärung <Interval> <StartSyncTime /> <MappingMode> <Logging> Zeitintervall in Minuten. Gibt an nach wie vielen Minuten nachdem der letzte Synchronisationsdurchgang beendet ist ein neuer Synchronisationsdurchgang startet. Einstellbar: Standardwert:10 Startzeit, wann die erste Synchronisation starten soll. z.b T13:55: :00 Standardwert: nicht gesetzt Gibt die Form an, wie die Synchronisationsinformationen gespeichert werden. Access = Informationen werden in Access-Datei gespeichert FlowFact = Informationen werden in FlowFact-DB gespeichert Gibt den Umfang von Meldungen an, die in das Ereignisprotokoll geschrieben werden sollen. Default = Fehlermeldungen, Sart und Ende eines Synchronisationsdurchganges Webservices Stand :43:00 Seite 16 / 24

17 <AllowAutoUpdates> <JumpOverSyncProblems> <SynchronisationJob JobID="1" JobPath="" LeftSyncConnector ="" RightSyncConnector ="" AuthenticationConnector =""> <ItemSetting Type="" Mode="" /> State = zusätzlich zu Default noch Statusmeldungen Trace = detaillierte Meldungen zur Analyse Wird zur Zeit nicht verwendet Für Service Zwecke. Bricht Synchronisation eines Benutzers nicht ab, wenn ein Element nicht gesynct werden konnte. Diese Einstellung ist nur für Service Zwecke. Einstellbar: true, false Standardwert: true Ab Version 2.20 Gibt die einzelnen Synchronisationsjobs an. Attribute: JobID = Nummer des Jobs JobPath = Pfad zu den weiteren Konfigurationsdateien (UNC-Pfad oder relativer Pfad) Ausnahme: keine Relevanz bei OutlookSync LeftSyncConnector = Gibt den linken Connector an RightSyncConnector ="" Gibt den rechten Connector an AuthenticationConnector ="" Gibt den Authentifizierungsconnector an Gibt die zu synchronisierenden Elemente an. Type="" sind folgende Einstellungen möglich: Contact = Kontakte Message = s Appointment = Termine Task = Aufgaben Note = Notizen Mode="" Synchronisationsmodus, folgende Einstellungen sind möglich: Peer = in beide Richtungen letzte Änderung gewinnt MasterLeft = in beide Richtungen immer links gewinnt MasterRight = in beide Richtungen immer rechts gewinnt ImportLeft = Synchronisation nur von links nach rechts ImportRight = Synchronisation nur von rechts nach links 6.2 FlowFact.Connectivity.Authentication..dll.Config In dieser Konfigurationsdatei befinden sich im Wesentlichen die Pfade zu den Endsystemen, die Anmeldeinformationen und das Mapping der entsprechenden Konten, die Synchronisiert werden sollen. Es können mehrere Jobs angegeben werden, um z.b. auf verschieden Exchange Servern zu synchronisieren oder damit die in der SyncSettings.config eingestellten Jobs auf verschiedene Benutzerkonten wirken Aufbau der Datei <?xml version="1.0" encoding="utf-8"?> <Settings xmlns:xsi=" xmlns:xsd=" <Jobs> <SynchronisationJob JobID="1"> <Accounts> <Account> <FlowFactAccountName>Fritzchen Mueller (FM)</FlowFactAccountName> <FlowFactAccount>66897fce-49d3-4d8c-824d-6ff6746ae901</FlowFactAccount> <ExchangeAccount>administrator</ExchangeAccount> <LastUpdate> T12:58: :00</LastUpdate> </Account> </Accounts> <Initialized>true</Initialized> <FlowFactPath>C:\FlowFact2007</FlowFactPath> <LogonDomain>PTTEST</LogonDomain> <ExchangeUrl> /exchange/</ExchangeUrl> <ExchangeUsername>administrator</ExchangeUsername> <ExchangePassword>4C DDD468BBFAB2EC</ExchangePassword> Webservices Stand :43:00 Seite 17 / 24

18 </SynchronisationJob> </Jobs> </Settings> Erklärung <SynchronisationJob JobID="1"> <Accounts> <Account> <FlowFactAccountName> <FlowFactAccount> <ExchangeAccount> <LastUpdate> <Initialized> <FlowFactPath> <LogonDomain> <ExchangeUrl> <ExchangeUsername> <ExchangeUsername> Synchronisationsjob, die JobID muß mit der JobID in der SyncSettings.config identisch sein. Enthält alle Benutzeraccounts Benutzeraccount Name des FlowFact-Benutzers mit dem synchronisiert wird. Wird über die Konfigurationsoberfläche automatisch gesetzt. DSN des FlowFact-Benutzers mit dem synchronisiert wird Exchange Server Kontoname = Benutzeraccount auf dem Exchange ServerServer Letztes erfolgreiches Synchronisationsdatum. Mit T00:00:00 kann man das Konto zurücksetzen und es werden vor der nächsten Synchronisation alle Elemente auf dem Exchange Server gelöscht. Gibt an, ob der Connector bereits initialisiert wurde. Einstellung wird automatisch vorgenommen. Pfad zur FlowFact Anwendung Domäne des Exchange Servers URL zum OWA des Exchange Servers Angabe ohne oder Benutzername des Benutzeraccount auf dem Exchange ServerServer, der den Zugriff auf alle zu synchronisierenden Postfächer hat Passwort des Exchange Synchronisationskontos ( von ExchangeUsername) 6.3 Flowfact.connectivity.connectors.flowfact.dll.config Konfigurationsdatei des FlowFact-Connectors Aufbau der Datei <?xml version="1.0" encoding="utf-8"?> <Settings xmlns:xsi=" xmlns:xsd=" <SetAllTasksAsPrivate>false</SetAllTasksAsPrivate> <SetAllMessagesAsPrivate>false</SetAllMessagesAsPrivate> <SetAllAppointmentsAsPrivate>false</SetAllAppointmentsAsPrivate> <AllowToSetUndone>true</AllowToSetUndone> <AllowNoteProperties>true</AllowNoteProperties> <IncludeActivityTypeInSubject>true</IncludeActivityTypeInSubject> <DenyAllLinkedInformation>false</DenyAllLinkedInformation > <IncludeLinkedEstatesInformation>true</IncludeLinkedEstatesInformation> <IncludeLinkedProjectInformation>true</IncludeLinkedProjectInformation> <IncludeLinkedActivityInformation>true</IncludeLinkedActivityInformation> <IncludeLinkedAddressInformation>true</IncludeLinkedAddressInformation > <IncludeContactPicture>false</IncludeContactPicture> <IncludeSendMessage>false</IncludeSendMessage> <DefaultGetMailDsn> b3b30f6</DefaultGetMailDsn> <DefaultSendMailDsn /> <MaxAppointmentTimeSpan>90</MaxAppointmentTimeSpan> <MaxAppointmentTimeSpanAhead>30</MaxAppointmentTimeSpanAhead> <MaxAttachmentSize>4</MaxAttachmentSize> <MaxNoteLength>512</MaxNoteLength> <ConnecorID>0495cb57-6ed cd-311d4e5fc377</ConnecorID> <DefaultExternalAppointmentDSN> b3b30f6</DefaultExternalAppointmentDSN> <DefaultInternalAppointmentDSN> b3b30f6</DefaultInternalAppointmentDSN> <DefaultTaskDSN> b3b30f6</DefaultTaskDSN> <DefaultNoteDSN> b3b30f6</DefaultNoteDSN> <AcceptActivityDSN /> <DetailsEmskDSN /> Webservices Stand :43:00 Seite 18 / 24

19 <DeclineActivityDSN /> <AttendeeFldArtDsn /> <SenderFldArtDsn /> </Settings> Erklärung <SetAllTasksAsPrivate> <SetAllMessagesAsPrivate> <SetAllAppointmentsAsPrivate> <AllowToSetUndone> <AllowNoteProperties> <IncludeActivityTypeInSubject> <DenyAllLinkedInformation> <IncludeLinkedEstatesInformation> <IncludeLinkedProjectInformation> <IncludeLinkedActivityInformation> <IncludeLinkedAddressInformation> <IncludeContactPicture> <IncludeSendMessage> <DefaultGetMailDsn> Alle Aufgaben, die bei der Synchronisation in FlowFact angelegt werden, werden nur mit den Vollzugriff für den jeweiligen Benutzer angelegt. Standardwert: false Alle s, die bei der Synchronisation in FlowFact angelegt werden, werden nur mit den Vollzugriff für den jeweiligen Benutzer angelegt. Standardwert: false Alle Kalendereinträge, die bei der Synchronisation in FlowFact angelegt werden, werden nur mit den Vollzugriff für den jeweiligen Benutzer angelegt. Standardwert: false Erlaubt das setzen von Erledigt auf unerledigt bei zu aktualisierenden Synchronisationselemente. Für die Anpassung an BlackBarry muß diese Wert auf false gesetzt werden. Standardwert: true Steuert das Überschreiben des Notizfeldes einer Aktivität. True läßt ein Überschreiben zu. Standardwert: true Verhindert, wenn false, dass bei Terminen und Aufgaben, die Aktivitätenarten in den Betreff geschrieben werden. Standardwert: true Verhindert, wenn true, dass bei Terminen und Aufgaben, verknüpfteni nformationen jeglicher Art hinzugefügt werden. Standardwert: false Fügt bei Terminen und Aufgaben, wenn true, die verknüpften Objektinformationen hinzu. Standardwert: true Fügt bei Terminen und Aufgaben, wenn true, die verknüpften Projektinformationen hinzu. Standardwert: true Fügt bei Terminen und Aufgaben, wenn true, die verknüpften Aktivitäteninformationen hinzu. Standardwert: true Überträgt, wenn true, die bei den Terminen und Aufgaben verknüpften Adressen als Kontakt. Standardwert: true Überträgt, wenn true, die Kontaktbilder der Kontakte. Standardwert: false Synchronisiert auch die gesendeten Mails wenn Wert true ist. Standardwert: false Ab Version 2.23 DSN der Aktivitätenart für neu anzulegende empfangende s eines Benutzers, wenn dem Benutzer kein Konto zugewiesen ist. Webservices Stand :43:00 Seite 19 / 24

20 <DefaultSendMailDsn> <MaxAppointmentTimeSpan> <MaxAppointmentTimeSpanAhead> <MaxAttachmentSize> <MaxNoteLength> <ConnecorID> <DefaultExternalAppointmentDSN> <DefaultInternalAppointmentDSN> <DefaultTaskDSN> <DefaultNoteDSN> <AcceptActivityDSN> <DetailsEmskDSN> <AttendeeFldArtDsn> <SenderFldArtDsn> ACHTUNG: Sollte immer gesetzt werden. DSN der Aktivitätenart für neu anzulegende gesendete s, wenn die Aktivitätenart beim Benutzer nicht eingestellt ist. ACHTUNG: Sollte immer gesetzt werden. Anzahl Tage die berücksichtigt werden, bei Terminen in der Vergangenheit. Einstellbare Werte: Standardwert: 90 Anzahl Tage bei Terminen in der Zukunft, die immer alle von Flowfact aus übertragen werden. Ab Version 2.19 Einstellbare Werte: Standardwert: 0 Maximale Dateigröße der Anhänge die mit übertragen werden in kbyte. Einstellbare Werte: Standardwert: 0 ACHTUNG: Werte > 5120 führen zu einer sehr langsamen Synchronisation Aktivitäten deren Maximale Größe des Inhalts des Notizfeldes größer ist als dieser Wert werden nicht übertragen. Angabe in kbyte (zur Zeit nur bei Mails berücksichtigt) Einstellbare Werte: Standardwert: 512 Ab Version 2.19 Eindeutige ID welche auch in den Synchronisationstabellen X_FFSYNC_Tasks, X_FFSYNC_Contacts usw. eingetragen wird. ACHTUNG: Bei einem Update der Konfigurationsdatei muß sichergestellt werden, daß diese ID gleich bleibt, da es sonst bei der nächsten Synchronisation zu Duplikaten kommt. DSN der Aktivitätenart für neu anzulegende externe Termine eines Benutzers. ACHTUNG: Sollte immer gesetzt werden. DSN der Aktivitätenart für neu anzulegende interne Termine eines Benutzers. ACHTUNG: Sollte immer gesetzt werden. DSN der Aktivitätenart für neu anzulegende Aufgaben eines Benutzers. ACHTUNG: Sollte immer gesetzt werden. DSN der Aktivitätenart für neu anzulegende Notizen eines Benutzers. ACHTUNG: Sollte immer gesetzt werden. Nur GroupWise: Aktivitätenart zum Akzeptieren eienes Termins Nur GroupWise: Eingabemaske um externe Teilnehmer an zu zeigen Nur GroupWise: Feldart der externen Teilnehmer an einem Termin Nur GroupWise: Feldart des externen Absenders eines Termins 6.4 Flowfact.connectivity.connectors.exchange2.dll.config Konfigurationsdatei de Exchange-Connectors. Einstellungen wirken sich auf alle Synchronisationsbenutzer aus Aufbau der Datei <?xml version="1.0" encoding="utf-8"?> <Settings xmlns:xsi=" xmlns:xsd=" <ProxyServer /> <ProxyPort>0</ProxyPort> <IncludeContactPicture>false</IncludeContactPicture> Webservices Stand :43:00 Seite 20 / 24