com.lexmark.saperion.client.administration

Interface GroupManagementServiceClient

All Known Implementing Classes:

GroupManagementServiceClientImpl

public interface GroupManagementServiceClient

This client provides methods for administrating groups.

Author:

jschwarz

Method Summary

Modifier and Type	Method and Description
GroupReferenceType	createGroup(GroupPropertiesType properties) This method creates a new group with the given properties and returns a reference to it.
GroupReferenceType	createGroup(String shortName) This method is a shorthand to createGroup(String, String, String).
GroupReferenceType	createGroup(String shortName, String fullName, String description) This method creates a new group with the given properties and returns a reference to it.
GroupClient	resolve(GroupReferenceType reference) This method returns an administration client for the group with the given reference.
GroupClient	resolveName(String groupName) This method returns an administration client for the group with the given name.
SearchClient<GroupListItemType>	search() This method returns a search client for searching groups.
SearchClient<GroupListItemType>	searchDeleted() This method returns a search client for searching deleted groups.

Method Detail

resolve

GroupClient resolve(GroupReferenceType reference)
             throws EcmException

This method returns an administration client for the group with the given reference.

Parameters:

reference - a reference to the group to administrate

Returns:

an administration client for the group with the given reference

Throws:

EcmException

resolveName

GroupClient resolveName(String groupName)
                 throws EcmException

This method returns an administration client for the group with the given name.

Parameters:

groupName - teh name of the group to administrate

Returns:

an administration client for the group with the given name

Throws:

EcmException

search

SearchClient<GroupListItemType> search()
                                throws EcmException

This method returns a search client for searching groups.

Returns:

a search client for searching groups

Throws:

EcmException

searchDeleted

SearchClient<GroupListItemType> searchDeleted()
                                       throws EcmException

This method returns a search client for searching deleted groups.

Returns:

a search client for searching deleted groups

Throws:

EcmException

createGroup

GroupReferenceType createGroup(GroupPropertiesType properties)
                        throws EcmException

This method creates a new group with the given properties and returns a reference to it.

Parameters:

properties - the properties of the group

Returns:

the reference to the new group

Throws:

EcmException

createGroup

GroupReferenceType createGroup(String shortName,
                               String fullName,
                               String description)
                        throws EcmException

This method creates a new group with the given properties and returns a reference to it.

Parameters:

shortName - the short name (display name) of the new group

fullName - the full name of the new group

description - a description of the new group

Returns:

a reference to group created

Throws:

EcmException

createGroup

GroupReferenceType createGroup(String shortName)
                        throws EcmException

This method is a shorthand to createGroup(String, String, String). It is equivalent to calling createGroup(shortName, shortName, "").

Parameters:

shortName - the short name (display name) and full name of the new group

Returns:

a reference to group created

Throws:

EcmException