The user directory app displays a list of people in your district, school or department and their associated contact information. The information displayed comes from your organisation's Active Directory system which is managed by your IT department.

Add the User Directory

Like all apps, you can add or remove the User Directory by editing the page, selecting Add an App, and finding User Directory under the Scholantis category. See Add an App to a Page to learn more about adding apps.

Edit the User Directory

You can easily configure the information displayed, and other general app settings, from the tool pane.

To edit an existing User Directory app Edit the page and select Edit App from the app menu. See Edit or Delete an App from a Page to learn more about editing apps.

The User Directory tool pane displays the settings common to all apps, and those specific to the User Directory.

Control Which Users are Listed

Your system is configured with the various locations (schools and departments) and roles (staff, teachers, administrators) that make up your district. 

Select a Location and enter the desired Roles (comma delimited) in the settings tool pane. Select Ok in the settings pane and Save the page to see the updated list of users.

Show column will appear when you Edit the page. Uncheck the check box to hide the corresponding user from the app. You can also hide users by adding their user names into the User Blacklist in the settings tool pane.


How does it work?

Each location and role maps to a specific Active Directory user group which defines the users which will be displayed. If the correct location and roles are set but there are some users missing you should contact your IT department.

Your IT department can also globally hide specific users by a creating and setting an Active Directory property hideinDirectory set to [true|1|yes]. Learn How to Create a Custom Attribute in Active Directory on Microsoft TechNet.

System Administrators can view the configured Active Directory groups for each location and role. Open System Dashboard, open User Diagnostics and find any user, click the Role Requirements button.

Control Which Columns are Displayed

You can define what information about each user is displayed by entering the Scholantis attribute names and the column's display name into the Columns box of the settings tool pane.

Values should be comma and semi-colon delimited in the following way: 
activeDirectory1, AD Column Name 1; activeDirectory2, AD Column Name 2;

Available Columns

Many of the Active Directory attributes referenced below can be viewed or edited in the Active Directory user object dialog. All attributes, including the attribute names and corresponding values, can be found in the Attribute Editor tab. 

To access the Attribute Editor tab activate Advanced features (View > Advanced Features) then open a user object dialog.

Column NameDescription
displayNameUses displayName attribute from Active Directory
firstLastFirstName LastName (in title case, delimited by space). Uses givenName and sn attributes from Active Directory.
lastFirstLastName, FirstName (in title case, delimited by comma). Uses givenName and sn attributes from Active Directory.
lastFLastName, FirstInitial (in title case, delimited by comma). Uses givenName and sn attributes from Active Directory.
firstLFirstName LastInitial (in title case, delimited by space). Uses givenName and sn attributes from Active Directory.
titleTypically contains a user's job description. Uses title attribute from Active Directory.
descriptionThe description attribute from Active Directory.
mailEmail address. Uses mail attribute from Active Directory.
telephoneNumberTelephone number. Uses telephoneNumber from Active Directory.
classesA link to a teacher's class list page (opens in new window). Displays a link to a page containing the user's name in the Url. The Url is defined by the Classes Url setting. The Classes page is used to display the classes and assignments for a teacher.
websiteThe user's website if available (opens in new window). Displays a link to a user's Scholantis Public Site.
commentThe comment attribute from Active Directory.
companyThe company attribute from Active Directory.
contactFormLinks to a contact form that sends an email to the email address specified in Active Directory. The contact form hides user email addreses to prevent spambots collecting staff email addresses. The contact form includes the sender IP address and a CAPTCHA to prevent spam. Uses mail attribute from Active Directory.
departmentThe department attribute from Active Directory.
divisionThe division attribute from Active Directory.
employeeIDThe employeeID attribute from Active Directory.
faxNumberThe facsimileTelephoneNumber attribute from Active Directory.
notesThe info attribute from Active Directory.
initialsThe initials attribute from Active Directory.
ipPhoneNumberThe ipPhone attribute from Active Directory.
mobileNumberThe mobile attribute from Active Directory.
pagerNumberThe pager attribute from Active Directory.
webPageUrlThe url attribute from Active Directory.
webPageUrl2The wWWHomePage attribute from Active Directory.

All Caps!

The setting allcaps can be added to a column to display a column in capital letters.

Example Columns

displayName, Name, allcaps; title, Job Title; telephoneNumber, Phone;mail, E-mail; website, Website;