The IBM® WebSphere® Portal Composite Application Selection Handler is used to select a profile based on the WebSphere Portal Composite Application Role that the user is in.
This handler is only appropriate for portlets that are part of a composite application, not portlets just placed on a portal page outside of the WebSphere Portal template-based composite application framework.
The definition file for this handler is in located in:
This selection handler compares the composite application role(s) of which the user is a member with the external associations for the profiles in the associated profile set (under the Advanced section of the New or Edit profile dialog in the profile set editor). For example, for the profile privilegedUsers
in a profile set, you could set external associations for "manager" and "executive" to correspond to roles created with those same names in the composite application in which the portlet will be used.
The APIs used to determine which role a user is in, in WebSphere Portal 6.1 and beyond, require the user to be able to resolve user to group mappings while determining role membership. To use this composite application role based profile selection handler on version 6.1 or later of WebSphere Portal, you will need to add any groups of users that use the comp app profile selection handler to the "User" role on the "User Groups" virtual resource. Every virtual resource has a set of roles and one them is called User.
Complete these steps to make this change:
- Log in to WebSphere Portal as the administrator
- Navigate to the Administration page
- Choose Access -> Resource Permissions.
- Under Resource Types, select Virtual Resources.
- Locate the User Groups virtual resource and select the icon to assign access to that resource.
- Locate the "User" role, in the list of roles for that resource and select the icon to edit that role.
- Add the groups of users that will use portlets leveraging the composite application role based profile selection handler.
If you do not follow the above steps correctly, then when a user without administrative rights run portlets using this selection handler, they may receive a missing access rights exception, instead of the portlet.
Parent topic: Using sample handlers: wpf7