Customizing the Active Directory Configuration

The available property fields that can be mapped to in the Active Directory service are displayed in a drop-down list in the AD Mapped Attribute column on the Properties Tab. This list of fields is defined in the ADConfiguration.xml file. The configuration file allows the Administrator to define which fields can be updated in the directory service.

• Each sync type requires a single access account that accesses both the master user directory as well as the user directory you need to which to sync.
• Map properties from the master user directory to the secondary directory and view whether the update was successful through the Log Tab.
• Enter in settings specific to the sync type.
• Save your settings as a template to reload whenever you want to manually run the sync. You can also automate user directory syncing by using Windows NT Scheduler to set up the update to run at a time that is convenient for you and your users.

By default, User Profile Sync creates a generic ADConfiguration.xml file. You may edit this file directly to provide your own list of AD fields, but to make sure that your customization is not overwritten upon upgrading the Web Application with future releases, copy the default ADConfiguration.xml file to the folder whereUser Profile Sync is installed and rename it (For example: Company.ADConfiguration.xml). If you do not rename the file you modify, the file will be overwritten when an application upgrade is installed.

The ADConfiguration.xml file has two values for each column defined:

• Column Title is the LDAP directory service field name.
• DisplayName is the attribute title listed in the AD Mapped Attribute column in the Properties Tab of User Profile Sync.

For example:

<?xml version="1.0" encoding="utf-8" ?>
<Columns>
<Column Title="info" DisplayName="Notes" /> 
<Column Title="thumbnailPhoto" DisplayName="Picture" /> 
<Column Title="facsimileTelephoneNumber" DisplayName="Fax" /> 
<Column Title="homePhone" DisplayName="Home Phone" /> 
<Column Title="l" DisplayName="City" /> 
<Column Title="mobile" DisplayName="Mobile Phone" /> 
<Column Title="postalAddress" DisplayName="Postal Address" /> 
<Column Title="postalCode" DisplayName="Zip Code" /> 
<Column Title="postOfficeBox" DisplayName="PO Box" /> 
<Column Title="st" DisplayName="State" /> 
<Column Title="streetAddress" DisplayName="Street Address" /> 
<Column Title="telephoneNumber" DisplayName="Work Phone Number" /> 
<Column Title="wWWHomePage" DisplayName="Web Site" /> 
<Column Title="sAMAccountName" DisplayName="Account Name" /> 
<Column Title="description" DisplayName="Description" /> 
<Column Title="sn" DisplayName="Last Name" /> 
<Column Title="initials" DisplayName="Middle Initial" /> 
<Column Title="givenName" DisplayName="First Name" /> 
<Column Title="displayName" DisplayName="Full Name" /> 
<Column Title="mail" DisplayName="E-mail" />
<Column Title="physicalDeliveryOfficeName" DisplayName="Office Name" /> 
<Column Title="c" DisplayName="Country Abbreviation" /> 
<Column Title="co" DisplayName="Country" /> 
<Column Title="department" DisplayName="Department" /> 
<Column Title="title" DisplayName="Title" /> 
<Column Title="manager" DisplayName="manager" /> 
<Column Title="company" DisplayName="Company" /> 
</Columns> 

To Use a Custom Active Directory Configuration:

1. Copy and rename the default ADConfiguration.xml file in the User Profile Sync program directory.

2. Modify and save the renamed file in the User Profile Sync program directory.

3. Open the Bamboo.SPProfileADSync.exe.config file in the User Profile Sync program directory.

4. Change the value in the following line to the filename of the new file:

   <add key=”ADConfigFile” value=”ADConfiguration.xml” />