Data source

Note

For the versions earlier than 4.x.x (including on-premises ones), please follow this instruction.

Data source

Org Chart can pull employees information from two data sources:

  • SharePoint list,

  • User profiles.

If you choose User profiles as a data source, no additional configuration of data source is needed, just go through the wizard until the end. Unless you want to configure dotted-line managers or configure assistants.

To understand how Org Chart communicates with the User profiles service, read this article.

If you choose SharePoint list as a data source, it will be configured to create a new list with demo data by default. You only need to fill List name.

OrgChart configuration wizard

If you want to use an existing SharePoint list, you can choose it from combo box. Then you will have to specify mapping for list fields required for building correct hierarchy. The interface for mapping looks like this.

OrgChart configuration wizard

Mapping defines the connection between Organization Chart field and List field. Data from the corresponding list field will be used by the Organization Chart, for example you can specify mapping between Employee ID and list item ID.

Employee ID, Manager ID and Display text mappings are required, you can leave other mappings empty. Once you configured it, you can go through the wizard and click the finish button.

Employee ID and Manager ID are used to build hierarchy. Display text is used as display text for entities in the org chart. For example you will see “Display text” in the breadcrumb.

Description of mappings

Name

Description

Employee ID

This is unique ID of an employee. It can be list item ID, user login or any other unique identifier of the person.

Manager ID

This is unique ID of an employee manager. For example it could be ID of manager or login of manager. We need it to build a well-structured tree.

Display text

Display text is displayed in the breadcrumbs of the Org Chart.

Assistant ID

This mapping defines where information about assistant is stored for current item. This is optional mapping. Please read this instruction to learn how to configure assistants.

Dotted manager ID

This is unique ID of dotted-line manager. For example, it could be ID of manager or login of manager. Type of this field should be the same as type of Manager ID. Please read this instruction to learn how to configure dotted-line managers.

Search only in indexed list columns

SharePoint has a standard restriction on SharePoint list item queries in 5000 items. To be able to use search in such list you need to index the columns on the list level and also enable option Search only in indexed list columns in OrgChart settings. You can find more information about it here.

Search in indexed columns

Vacancies

Note

If vacancies don’t appear in your web part try to clear cache. Also, vacancies are not supported in SharePoint 2010 version.

Vacancies are stored in a separate SharePoint list. The list will be created automatically at specified Vacancies list URL.

Enable vacancies

Once you enabled vacancies Manage vacancies, a menu item will appear:

Manage vacancies menu

This menu item redirects user to vacancies list. To create new vacancies, create new list item and specify Manager. It can be account name for User Profiles data source and list item ID for SharePoint list data source:

Create vacancy

Note

Go to the next step of the configuration wizard Filtration.