Documentation

Understanding Organizations

Liferay Organizations can enable distributed User and Site management that reflects real world organizational hierarchies. Organizations can nest to an unlimited number of hierarchical levels. Consider a typical organization chart:

An organization chart shows how a typical grouping of company, governmental department, non profit, or any other collection of people is organized. Liferay's Organizations can model these.

This structure can be modeled in Liferay DXP, empowering you to delegate administrative responsibility and organize Users in a way that reflects your organization. If you apply permissions to those Users through Organization Roles, Users who move from one Organization to another in a defined hierarchy automatically receive permissions appropriate to them.

Organization Roles and Permissions

Organizations can have Roles scoped only to them. An Organization Role’s permissions affect only applications and content within that Organization hierarchy. For example, the difference between a portal-scoped Role versus an Organization-scoped Role that define access to Message Boards is twofold:

  1. The Organization Role affects only Message Boards in that Organization (or its children).

  2. The portal Role affects all Message Boards installation-wide.

Organization Roles take effect only within the Organization.

This has great benefits. If, for example, a large company has modeled its organization chart in Liferay DXP as Organizations, administration becomes an easy task. An IT User who has permission to use IT’s provisioning application can transfer to HR, and by moving that User from IT to HR, permissions to the provisioning tool are removed automatically, while permissions to HR’s compensation tool are granted automatically.

Organization Administrators

Organization administrators are delegated administrators. This means they get a piece of your portal—a piece you define—to take some of the load of administration off of your shoulders. Organization Administrators can do these things:

  • Manage all the Users in their Organization and in any child Organization.

  • Optionally, assign Users to their Organization (see the Organizations section of the portal-ext.properties).

  • Manage an Organization’s Site, just like a Site Administrator.

Organization administrators can’t access the Control Panel by default. Instead, they can click the My Organizations link to gain access to any Organizations they manage.

Organization administrators can access their Organizations from their profile.

Organization Sites

An Organization can have its own Site. Organization Sites are owned by Organization Administrators, who have permissions similar to the Site Administrators: they can manage the Site’s pages, widgets, content, and Users. Members of an Organization with an attached Site are members of the Organization’s Site. This means that they can access the private pages of the Organization’s Site, along with any portlets or content there.