Field Mappings
Usage
How to map fields
Left mouse click and hold one of the Active Directory User field or Entra ID User field labels and drag it onto one in the list of HelpMaster Client fields to the right, drop it on the corresponding field you wish to map. Unmapped fields will be black text and already mapped fields will be blue text in both columns. A red line will indicate the new mapping selection joining the two columns, click the Map > button and the Mapped fields will appear on the far right as Source (Windows AD or Entra ID field) and Destination (HelpMaster Client field). After mapping all required fields click Next» to continue profile configuration, or OK/Apply to immediately save the profile settings.
Available Fields for Windows AD and Entra ID
Some fields are only available in Windows AD and others are only available in Entra ID. There are two icons that indicate which fields are available for each depending upon whether a Windows AD or Entra ID based profile was selected as follows:
: Windows AD fields only that cannot be used with an Entra ID profile
: Entra ID fields only that cannot be used with a Windows AD profile
Saving and loading mapped fields to and from a file
After mapping all required fields, click the Save icon to the right of the Mappings heading. Browse to the location and enter the name you wish to save your mapping file as. To load a saved mapping file click on the Folder icon between the Mappings heading and the Save icon. Browse to your saved mapping file and selected it to load previously saved mappings.
How to remove field mappings
Click on the mapping you wish to remove from the Mapped fields column and click the <Remove mapping button.
Linking clients to sites
As part of the synchronization, you may also wish to link clients to the site that they belong to in HelpMaster. To do this, map an appropriate Windows AD or Entra ID field to the Site field in the HelpMaster list of fields. If an exact match occurs between this Windows AD or Entra ID field and an existing HelpMaster site name, the client will be linked to that site.
Note: The Active Directory synchronization does not create/import sites from Windows AD or Entra ID into HelpMaster - it only links them if the site already exists in HelpMaster (which you need to manually create, or import)
Note: You can also map the Windows AD User’s Organizational Unit Name (OU) or Entra ID User’s Group Name as one of the HelpMaster fields e.g. Site. This is useful if your Windows AD OU structure or Entra ID Group Names correspond to your HelpMaster site list.
Mapping additional fields / custom Active Directory fields
If you have Windows AD or Entra ID data/fields that you wish to import into HelpMaster, but that data type does not appear in the list of available fields, it may be possible to still import that field. The list of available Windows AD or Entra ID fields (the list on the left), is populated directly from values stored in a database table called tblActiveDirectory_Fields. By updating this table with the name of the field that you wish to import, this field will then display in HelpMaster as a map-able field. This table should only be populated with fields that correspond to the Windows AD or Entra ID field schema. For a full list of these, please refer to Microsoft Documentation.
See Also
Updating clients via Active Directory
Client picture / Gravatar support
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.