Exchange Synchronization AX 2012

Transcription

1 Exchange Synchronization AX 2012 Autor... Pascal Gubler Dokument... Exchange Synchronization 2012 (EN) Erstellungsdatum September 2012 Version... 2 /

2 Content 1 PRODUKTBESCHREIBUNG... FEHLER! TEXTMARKE NICHT DEFINIERT. 1.1 OVERVIEW FEATURES SETTINGS EXCHANGE PARAMETERS CATEGORIES EMPLOYEES USING EXCHANGE SYNCHRONIZATION IN AX CONTACTS Private contacts Public contacts Employee-Contacts Contacts and mobile devices Photos Deleting private contacts Deleting public contacts S IMPORT SEND S APPOINTMENTS TASKS DELETED ACTIVITIES ACTIVE DIRECTORY INTEGRATION IN AX EMPLOYEE CONTACTS INSTALLATION VERSIONEN Version Datum Autor Änderung Status Pascal Gubler Pascal Gubler Mitarbeiter-Kontakte, Active Directory Martin Abrle Translation, more details Version 2 Seite 2 von 16 Axperience AG Gewerbestrasse Thalwil

3 1 Product description 1.1 Overview «AXP-Exchange Sync» Dynamics AX module supports a seemles integration between Exchange objects and their Dynamics AX counterparts. One integration example could the usage of your tablet to input data (into the calendar and contacts) while on the go. There is no online requirement here data will be automatically synchronized with Exchange and therefore also with Dynamics AX the next time you connect to the network. Following AX and Exchange objects can be synchronized: - Private contacts / AX Contacts - Contacts in public folders / AX Contacts - Contacts in public folders / AX Employees (Export only) - Appointments and meetings / AX Activities - Tasks / AX Activities - s / AX Activities (Import) - s distribution Additionally, employee information can be synchronized into the active directory to keep AD objects up to date with HR Information. 1.2 Features - Compatible with all recent AX versions (AX 4.0, AX 2009, AX 2012, AX 2012 R2) - Compatible all Exchange version from Exchange Server 2007SP1 (latest CU recommended) upwards - Compatible with Office 365, regardless of where the servers are hosted - integration for CRM Activities allows for better Exchange and AX CRM Activities integration - Supports a centralised contact data management in AX - Supports a centralised contact and employee data management in AX - Organization of customer related activities (tasks, meetings) - Always up-to date info about your CRM activities in AX Version 2 Seite 3 von 16 Axperience AG Gewerbestrasse Thalwil

4 2 Settings 2.1 Exchange Parameters Exchange Parameters form is used to set general integration parameters. - Exchange Server: Exchange Webservices URL typically it s - Admin address: This is the mailbox address of the person with a full access to the public folder containing Contacts and Employee contacts. Typically this is the Exchange Administrator - Domain, synchronization account and the password identify the user who will connect to the Exchange server to perform synchronization tasks. This account must have impersonation permissions to all user mailboxes you want to synchronize with. - Exchange protocol used to decide, whether Categories will be synchronized using Exchange. Exchange 2007 does not support the Category synchronization, all newer versions do. If you are using Exchange 2007, Categories will need to be deployed using GPOs. The rest oft he parameters is used to set a recipient of batch processing errors, synchronization window for meetings and appointments and import details (what type of CRM activity should be created when importing s). Version 2 Seite 4 von 16 Axperience AG Gewerbestrasse Thalwil

5 2.2 Categories «ExchangeSync > Setup > Categories» Form is where Exchange categories are centrally managed. These categories will be automatically deployed to all mailboxes which are synchronized and can be chosen to classify AX CRM activities, AX Employees and AX Contacts. Categories are also used to decide which objects can be synchronized in case of s, Appointments, Meetings Tasks and private contacts. You can also use this form to export categories to selected mailboxes. This is being done automatically, but «Export categories» can serve as a troubleshooting tool to prove that Connection settings and impersonation rights are setup correctly. Note: Please restart the AX Client each time you modify categories, as they are cached in clients memory for performance reasons. 2.3 Employees Employee s mailbox is defined here. There is also a setup for each Exchange object type which is going to be synchronized. Settings here are overriding the setup in categories for example, Tasks will not be synchronized unless it s explicitelly allowed here. This feature can be used to limit synchronization with sensitive mailboxes (CEO, HR). To disable the synchronization with sensitive mailboxes completely, do not give the impersonation permission for these mailboxes to the synchronization account. Version 2 Seite 5 von 16 Axperience AG Gewerbestrasse Thalwil

6 3 Using Exchange Synchronization in AX Contacts There are two approaches to contact synchronization one is to synchronize AX contacts with Exchange (Outlook) Private contacts and the other one is to synchronize AX contacts with contacts in an Exchange s public folder. In order to make both approaches to work, communication types need to be configured first in «Exchange Synch > Setup > Communication methods». Typically, all Exchange -Types (1..3), address types (Business, Private, Other) and phone number types need to be covered Private contacts Private contacts are managed using the «Exchange Sync > Common > Private contacts» form. User can choose, which contacts to synchronize with his mailbox using the the «Choose contacts» button, import contacts using the import button (based on categories assigned to his contacts) and export modified contacts. Contacts, which have been imported, can be assigned to a vendor, customer or prospect if the exchange contact s company name was not unique (e.g. there is only one global address book company entry with this name). First time the user starts this form, he can change the contact directory if there is a need to use a different contacts sub-directory. Some users might want to use this feature to separate their own contacts and company contacts. Version 2 Seite 6 von 16 Axperience AG Gewerbestrasse Thalwil

7 3.1.2 Public contacts Public folders to synchronize contacts with can be setup using the form «Exchange Sync > Setup > Public contacts folders». Here you define the Exchange path, separated using the / sign as a delimiter (for example Axperience/Global Contacts. Assigned to each Exchange path is a query, selecting a set of contacts which are going to be synchronized (based for example on a region). Query selection is the selection and filtering mechanism here not the Category as is the case with private contacts. Export and import can be started using «Exchange Sync > Periodic > Export > Contacts > Exchange public contacts» and «Exchange Sync > Periodic > Import > Contacts > Exchange public contacts». AX Contacts, linked to exchange public folder contacts, can be maintained using the form «Exchange Sync > Common > Public contacts» Export is exporting only recently modified contacts. Recently modified objects can be viewed using the form «Exchange Sync > Inquiries > Synchronization log» Employee-Contacts Employee contacts work the same way as public contacts with the only difference, that there is no import functionality. Public folder setup is to be found under «Exchange Sync > Setup > Public employee contacts folders». Links between exchange public contacts and AX employees can be viewed using the «Exchange Sync > Common > Employee contacts» form. Export batch job is located under «Exchange Sync > Periodic > Export > Export employee contacts» Contacts and mobile devices Public contacts are not usually directly available from mobile device clients (iphone, ipad, Android). However, there are dedicated applications, which allow you to browse and modify (and cache) public folders. One example is the Public Folders application for iphone we re using. Private contacts are directly synchronized with all mobile devices, which can connect to Exchange. Many clients also allow for an extra search/verification of contacts against the active directory (often called global contacts or global address book in mobile clients). Version 2 Seite 7 von 16 Axperience AG Gewerbestrasse Thalwil

8 3.1.5 Photos Photos can be assigned (in Microsoft Dynamics AX standard) to employees; «AXP-Exchange Sync» extends this functionality to AX contacts as well. Employee and contact photos will be then synchronized with Exchange Deleting private contacts When deleting an AX contact, Exchange contact will not get deleted automatically; only the link between these two (in «Exchange Sync > Common > Private contacts») will be removed. When an Exchange (private) contact gets deleted, the link between AX and exchange contacts gets removed as well Deleting public contacts When deleting an AX contact, the link between these two (in «Exchange Sync > Common > Public contacts») will be removed and the Exchange contact will be removed during the next synchronization. When an Exchange (public) contact gets deleted, the ling (to be found in «Exchange Sync > Common > Public contacts») gets the flag «Skip synchronization» set. Later, the AX contact can be either manually deleted, or the Skip synchronization flag can be removed using the butting «Activate synchronization». Version 2 Seite 8 von 16 Axperience AG Gewerbestrasse Thalwil

9 3.2 s import Die s aus Outlook, resp. Exchange, werden in Microsoft Dynamics AX als Aktivität importiert. Es können empfangene oder gesendete s importiert werden. Dies wird in den Parametern (Absatz 2.1) festgelegt. To import an into Dynamics AX, the should have the right category set, e.g. a category, for which the import has been activated (see 2.2) import can be started from «Exchange Sync > Periodic > Import > Import s» and it will search mailboxes defined in the import batch job s query. s found will be used to create AX activities; AX Activity will be assigned to the contact, with the sender s address (in case of incoming s) or recipient s address (in case of outgoing s). If the contact with this address doesn t exist, will not be imported. On the following picture, you can see the link between the contact (sender/recipient) and the imported activity. Version 2 Seite 9 von 16 Axperience AG Gewerbestrasse Thalwil

10 attachements are imported into document management (Attachments, see below). Document types for attachments have to be defined in «Sales and Marketing > Setup > Sale and marketing parameters > Documents». 3.3 Send s «AXP-Exchange Sync» can be used to ditribute s through Exchange. The advantage (compared to using the SMTP) is, that the user can see sent s in his mailbox. Exchange distribution ist o be found under «Exchange Sync > Periodic > Export > Send s»; source for the query are the AX standard outgoing s «System administration > Periodic > processing > E- mail sending status». Version 2 Seite 10 von 16 Axperience AG Gewerbestrasse Thalwil

11 3.4 Appointments Import In order for an Exchange appointment or a meeting, it needs to be created by a mailbox owner, which is an AX employee with enabled appointment synchronization. Appropriate category needs to be assigned, as discussed in 2.2. The import is performed by the «Exchange Sync > Periodic > Import > Import appointments» job. Import job will then create an activity of the category Appointment. All exchange data are mapped to AX data; most important data for thy synchronization can be found in the «Exchange Synchronization» tab. Version 2 Seite 11 von 16 Axperience AG Gewerbestrasse Thalwil

12 Meeting attendees (if they exist) will be imported into AX and can be viewed or modified using the Button «Attendees» in AX activities. Export In order to export an AX appointment, this AX activity of category Appointment should have the appropriate category assigned and the responsible worker needs to have the appointment synchronization enabled. When the activity gets saved, an entry in the synchronization log is created. Export is performed using the «Exchange Sync > Periodic > Export > Export appointments» batch job. If you want to export all, and not only modified AX apointments, select the checkbox «Export all appointmentd». If you assign attendees to an AX appointment, these will be created as attendees in for the Exchange appointment and they will be invited to this (newly created) meeting. Version 2 Seite 12 von 16 Axperience AG Gewerbestrasse Thalwil

13 3.5 Tasks Import Task import works similar to and calendar apointments/meetings import. Task needs to have a synchronizable category (see 2.2). After starting the job «Exchange Sync > Periodic > Import > Import tasks», Tasks will be imported into AX as and activitiy with the category Task. Version 2 Seite 13 von 16 Axperience AG Gewerbestrasse Thalwil

14 Export To export an activity with the category Task into AX, Um eine Aktivität aus AX an Exchange zu exportieren, wird eine Aktivität mit der Kategorie Aufgabe und der entsprechenden Exchange Kategorie angelegt. Beim Speichern der Aktivität wird dieser im Exchange Synchronizationsprotokoll vermerkt. Der Export wird über die Funktion «Exchange Sync > Periodisch > Export > Aufgaben exportieren» gestartet. Sollen alle Aufgaben und nicht nur die geänderten exportiert werden, kann der Parameter Alle Aufgaben exportieren gewählt werden. 3.6 Deleted activities When the user deletes an activity, a backup of of all relevant information (the activity itself, attendees,..) is made. «Exchange Sync > Periodic > Deleted activities» form can be then used to view these activities and restore them if needed. Version 2 Seite 14 von 16 Axperience AG Gewerbestrasse Thalwil

15 4 Active Directory Integration in AX Employee contacts «AXP-Exchange Sync» can be used to synchronize employee information into the active directory using the «Exchange Sync > Periodisch > Export > Kontakte > Mitarbeiter-Kontakte» nach Active Directory exportieren» batch job. Employees, which are assigned to a a user in AX, can be (based on a query) searched for and updated in an OU, described with the parameter «LDAP Path users». «LDAP Path contacts» is an optional parameter. If used, employees which do not have an AX user, will be exported as contacts into this group. Version 2 Seite 15 von 16 Axperience AG Gewerbestrasse Thalwil

16 5 Installation Installation is described in the install.txt file in the installation archive. Version 2 Seite 16 von 16 Axperience AG Gewerbestrasse Thalwil