Igloo Org Chart Azure AD Tree View Integration
What is it?
The Azure AD Org Chart Tree View Integrations widget provides a portal into your Azure Active Directory where you can view the managers and direct reports of the members of your company.
The widget also provides basic profile information and job title if it is present in your Azure AD.
Features and functionality
View Profile
The Azure AD Org Chart Tree View integrations widget presents contact information for members of your Azure AD, where available. This includes their position, phone number, email address, address, and a “sip" message link which will open you native messaging service on your computer.
The Org Chart will open to show the profile of the currently logged in user.
Selecting the ellipsis icon in the upper right corner of any person will display their profile.
View direct reports
People reporting directly to the currently displayed person are shown below the currently selected person, along with their role and department. You can click on these names to open their details.
View manager
The name, role and department manager of the currently displayed person is shown at the top of the widget. The number of direct reports that manager has is also displayed below their profile image.
View chain of command
The chain of reporting above the current member is displayed in the right of the widget.
Search
You can search for other employees in your Azure AD by name. Options will be displayed below the search field as text is entered.
Setting up the Azure AD Org Chart Tree View Integration
Step 1: Add the Integrations Widget to a Page or Space
Follow the steps in How to add and edit a Widget to add the Integrations Widget to your Page or Space.
When adding the Integrations Widget do not place it in the narrow side columns of the Page or Space. This positioning is not supported for the Azure AD Org Chart Tree View Integration.
Step 2: Select Igloo Org Chart
Edit the widget and select the Igloo Org Chard Azure AD Tree View option from the tree.
Step 3: Authorize the Org Chart (First-time setup)
The first time you set up the Org Chart in your digital workplace you will need to authorize the integration with Azure. Authorization to allow the widget to query your AD can only come from one of your Microsoft Administrators. To authorize:
- In the widget’s options select Show Admin Login, save this change and publish the page.
- Your organization’s Global Admin for O365/Microsoft (not Igloo admin) needs to click the link “Sign in as Microsoft Admin”. The Global Admin will be prompted to authorize on behalf of their entire organization.
- Once the widget has been authorized, it no longer needs the Microsoft Admin sign in link. You can turn it off by editing your page and widget again and deselecting Show Admin Login.
Step 4: Configure advanced options (optional)
Selecting Advanced Options will expand a tree of additional features. You can enable or disable them as appropriate.
- Azure Tenant ID: You can enter your Microsoft tenant ID if you have one. By default, it is “common”. Refer to Microsoft's article, Find your Office 365 tenant ID (Microsoft), for instructions on locating this value.
- Default User ID: Use this option to have the Org Chart open on a certain user rather than the logged in user. This can either be the user’s ID or the userPrincipalName in Azure.
- Profile Photo: Select whether the Org Chart will use photos from Azure active directory, or Igloo.
- UserEmailField: The field name in your Azure active directory that stores user’s emails. By default, this will be userPrincipalName.
- Show Send Message: Enables or disables the SIP messaging function. It is enabled by default.
- Show Reporting Chain: Enabling this feature will display the chain of direct reports above the currently selected profile. This feature can slow down the performance of the widget on very large ADs. It is off by default.
- Hide Disabled Accounts: This feature, enabled by default, prevents AD profiles that are marked as Disabled from displaying in the widget. This features checks the “accountEnabled” property which is carried over to Azure from on-premises ADs via DirSync.
- User Property to Filter On: Allows you to filter users based on a Microsoft Graph User Property (Microsoft). Select one of the following filter options: None, City, Country, Department, Job Title, State, or User Type. Refer to the Property fields section below to learn how these options map to your AD fields.
- User Property Values to Include: Enter a comma-separated list of values associated with the selected User Property. Only users who match any of these properties will be displayed. A maximum of seven values can be entered. Do not include spaces around the separator commas. For example, if you have selected to filter on Job Title, entering the property values of "Knowledge Manager,Support Technician" will result in only users with the title Knowledge Manager or Support Technician being displayed in the widget.
Note: Anyone outside of the scope of the filter will not appear in the widget. This will also limit who will appear in search and in reporting chains.
Property fields
Below are the property fields used in this widget and how they correspond to the associated Microsoft AD fields.
| Widget Field Name | Microsoft Graph Field Name | Azure AD Field Name |
|---|---|---|
| Name | displayName | displayName |
| Title | jobTitle | jobTitle / title (LDAP) |
| Department | department | department |
| userPrincipalName | userPrincipalName | |
| Phone | businessPhones (first entry) | telephoneNumber |
| Location | officeLocation | physicalDeliveryOfficeName |
| Photo | photo value | |
| Manager | manager | manager |
Frequently asked questions
Is there an API available to customize the Igloo Org Chart for my organization?
There is currently no API for the Igloo Org Chart.
Does the Igloo Org Chart work with an on-premise installation of Active Directory?
Igloo Org Chart is designed to be used with Active Directory in the Microsoft Azure cloud.
Customers could use an on-premise installation of Active Directory using the Azure AD Connect tool (Microsoft), in a synchronized or federated manner.
For more information, see Understanding Office 365 identity and Azure Active Directory (Microsoft).
How do I get pictures in my Azure Org Chart?
The Azure Org Chart widget requires Exchange Online in order to supply pictures for members to the widget. Azure instances without Exchange Online will not show images for their members.