The Fusepoint Simple Org Chart is a SharePoint Framework webpart designed to enhance the visualization of organizational structures within SharePoint. Utilizing Microsoft's Graph API, this webpart queries all users from Azure Active Directory (AAD) and displays them in an interactive organizational chart. This tool is particularly useful for large organizations needing a clear, visual representation of employee hierarchies and relationships.
Requires MS Graph Consent
Since the Fusepoint Simple Org Chart displays users’ information and the organization tree, the following permission needs to be granted:
User.Read.All: Allows the app to read basic profiles of all users in the directory. This includes properties such as display name, first and last names, email address, and photo.
To activate this, go to API access under the SharePoint Admin Center > Advanced and approve the User.Read.All permissions.
Features
1. Dynamic Org Chart Creation
Automatically generates an org chart based on user data retrieved from AAD.
Updates dynamically based on changes in the directory.
2. Customizable Layout Options
Displays 2 to 6 users per row.
Ensures optimal readability and interaction on any device.
3. Graph API Integration
Leverages Microsoft Graph API to fetch user information.
Requires SharePoint Admin Center permission for each tenant.
4. Configurable Display Options
Allows setting number of users per row.
Customizable image size for users.
Ability to include additional user properties such as Job Title, Email, Department, etc.
5. Search and Load More Functions
Includes a search box for finding individuals.
A Load More button to dynamically expand the org chart.
6. Advanced Filtering
Filter by email domains, departments, job titles, etc.
Show/hide users without job titles or departments.
7. Interactive UI Elements
Expand or collapse sections for better navigation.
Clickable user nodes to view additional details.
Steps to Configure & Update
1. Adding the Web Part
Go to SharePoint Site and navigate to the page where you want to display the org chart.
Click Edit Page > Find FusePoint icon > Type in the search bar: Fusepoint Simple Org Chart.
Click Apply and then Save & Publish the page.
2. Configuring Org Chart Settings
Open the web part properties panel.
Set the List view tab label and Org chart tab label.
Choose the number of users per row (2, 3, 4, 6).
Adjust image size for better visibility.
Enable or disable extra properties such as Job Title, Email, Phone Number, etc.
Set filtering options: exclude departments, job titles, or specific users.
3. Enabling Advanced Filters
Use the email domain filter to include/exclude external users.
Hide items without job titles or without department.
Define the main node email to set the hierarchy’s root.
Adjust lower and upper levels to control depth of the tree.
4. Updating User Permissions
Navigate to SharePoint Admin Center > API Access.
Ensure User.Read.All permission is granted.
Approve access if not already done.
5. Testing & Publishing
Preview the org chart in different screen sizes.
Use the search function to test user retrieval.
Click Republish to save changes.
Troubleshooting
1. Org Chart Not Displaying Data
Ensure API permissions (User.Read.All) are granted.
Verify that the main node email is correctly configured.
Refresh the page after making configuration changes.
2. Missing Users in the Chart
Check filtering settings to see if certain departments or job titles are excluded.
Verify if the missing users exist in Azure Active Directory.
3. Web Part Not Loading Properly
Ensure you are using a supported browser (Edge, Chrome, Firefox).
Clear browser cache and try again.
Check for any JavaScript console errors (Press F12 > Console in browser).
Conclusion
The Fusepoint Simple Org Chart is a powerful, customizable solution for visualizing company hierarchies in SharePoint. By leveraging Microsoft Graph API, it ensures real-time accuracy and seamless integration with Azure AD. With extensive configuration options, filtering capabilities, and interactive UI elements, it provides an intuitive and efficient way to explore organizational structures.
For further assistance, contact your SharePoint administrator or refer to Microsoft Graph API documentation.