group_id function

Related topics

Contained in package wwsec_api.

Call this function to return a group ID based on a specified group name. It does not require a site identifier.

First, the function checks the group in the local group repository in the Portal schema. If a local shadow entry is not found, it queries the Oracle Internet Directory (OID) to get the group information and create a local shadow entry. It always returns the ID of the local shadow entry.

function group_id

(

p_name in varchar2

)

return number;

Version: Oracle Portal 3.0.6.6.5 or later

Parameter:

p_name

The unique identifier of a group within a site.

Datatype: in varchar2

Returns:

This function returns the unique identifier of the group.

Exceptions:

If p_name does not exist, a GROUP_NOT_FOUND_EXCEPTION is raised.

If p_name is null, a VALUE_ERROR_EXCEPTION is raised.

Note: It is possible to have groups with identical names in Oracle Internet Directory (OID). The function raises the wwsec_oid.MULTIPLE_MATCHES_FOUND exception if the group name can not be resolved uniquely.

Example:

l_groupid number;
l_groupid := wwsec_api.group_id
(

p_name => 'PORTAL_ADMIN’

);

Version: Oracle Portal 3.0.6.6.5 or later
Parameter:
p_name	The unique identifier of a group within a site. Datatype: in varchar2
Returns: This function returns the unique identifier of the group. Exceptions: If p_name does not exist, a GROUP_NOT_FOUND_EXCEPTION is raised. If p_name is null, a VALUE_ERROR_EXCEPTION is raised. Note: It is possible to have groups with identical names in Oracle Internet Directory (OID). The function raises the wwsec_oid.MULTIPLE_MATCHES_FOUND exception if the group name can not be resolved uniquely. Example: l_groupid number; l_groupid := wwsec_api.group_id ( p_name => 'PORTAL_ADMIN’ );

Related topics
Security API packages	PDK PL/SQL API Reference - Home