Server

Directory and UI

Updated: December 4, 2024

Inside Nuxeo Platform, Directories are used to provide a common abstraction on a set of record

  • that can be stored in different manner
    • SQL, noSQL (MongoDB), LDAP, Repository, External Service
  • that can be of different nature
    • user, group, simple key/value, complex records

Layouts and Directory

Entries returned by a Directory are technically Documents: documents that have only one schema, but still Document.

This means that you can use Widgets and Layouts system to manage directories entries.

<nxl:layout name="#{currentVoc.layout}" mode="edit" value="#{directoryUIActions.selectedDirectoryEntry}" />

Directory Management UI

Both Nuxeo JSF UI and Nuxeo Web UI include management screens for the directories.

For simplicity reasons, the entry inside the Admin Center is called "Vocabularies", but actually it can manage any kind of Directories (i.e. not only the directories using the vocabulary schema).

In the Nuxeo JSF UI, to make this easily usable, the platform includes a DirectoryUIManager that uses a directories extension point to allow to contribute what directories should be available in the JSF management UI and what layouts should be used.

In Nuxeo Web UI, all the directories that are not of type system are included by default in the management UI.

Suggest Widgets

Directories can be used as a source of data for Suggest Widgets.

See Suggestion Widget Types page for more details.