|
Oracle Fusion Middleware Java API for Oracle WebLogic Portal 10g Release 3 (10.3.2) E14255-01 |
||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
public interface ICommunityMemberManager
Interface for the Communities Membership Manager. Implementations of this interface allow for management of Community Members including CRUD operations on Community Members, their memberships in specific Communities, capabilities within those Communities and association with MessagingAddresses for use by the Communities framework and Communities applications. <p/>The overview of community functionality contains a description of the community framework.
CommunityContext, CommunityUserContext
| Method Summary | |
|---|---|
void |
activateMember(CustomizationContext customizationContext, CommunityMemberId id)Activates a disabled CommunityMember globally for all Communities. |
void |
activateMembership(CustomizationContext customizationContext, CommunityMemberId mId, CommunityDefinitionId cId)Activates a CommunityMembership in the specified CommunityDefinition, making a disabled member able to use the community once again. |
void |
addMembershipCapability(CustomizationContext customizationContext, CommunityMemberId mId, CommunityDefinitionId cId, MembershipCapability capability)Adds a capability (owner, leader or manager) to the CommunityMembership specified. |
void |
cleanupAllInactiveInvitations(CustomizationContext customizationContext)Deletes all inactive status Invitations from the database |
void |
cleanupInactiveInvitations(CustomizationContext customizationContext, CommunityDefinitionId communityId)Deletes all inactive status Invitations from the database for a specified Community. |
InvitationStatus |
consumeInvitation(CustomizationContext customizationContext, InviteeId inviteeId, InvitationStatus toStatus)Consumes an Invitation that is in active status and moves it to one of the inactive statuses. |
CommunityMember |
createMember(CustomizationContext customizationContext, CommunityMember info)Creates a new CommunityMember based on the contents of the info parameter. |
CommunityMembership |
createMembership(CustomizationContext customizationContext, CommunityMemberId mId, CommunityDefinitionId cDefinitionId)Creates a CommunityMembership for the specified CommunityMember in the specified CommunityDefinition. |
CommunityMembership |
createMembership(CustomizationContext customizationContext, CommunityMemberId mId, Invitation invitation)Creates a CommunityMembership based on an Invitation that has been sent. |
void |
disableMember(CustomizationContext customizationContext, CommunityMemberId id)Disables a CommunityMember globally for all Communities. |
void |
disableMembership(CustomizationContext customizationContext, CommunityMemberId mId, CommunityDefinitionId cId)Disables a CommunityMembership. |
SortableFilterablePagedResult<String> |
getAllCommunityAssociates(CustomizationContext context, MemberCriteria criteria, int pageSize)Retrieves a paginated collection of all WLS user IDs of individuals belonging to the same communities the specified CommunityMember also belongs to. |
Collection<MessagingAddress> |
getAllMessagingAddresses(CustomizationContext customizationContext, CommunityMember member)Gets all of the MessagingAddresses associated with the specified CommunityMember, as determined by User profile values that are mapped to Communities MessagingAddresses. |
SortableFilterablePagedResult<CommunityMembership> |
getCommunityMemberships(CustomizationContext context, MembershipCriteria criteria, int pageSize)Returns a paginated set of all CommunityMembership objects for the specified member that meet the specified criteria. |
Invitation |
getInvitation(CustomizationContext customizationContext, CommunityDefinitionId communityId, String wlsUserName)Retrieves an Invitation by communityId and wlsUserName. |
Invitation |
getInvitation(CustomizationContext customizationContext, InviteeId inviteeId)Retrieves an Invitation by InviteeId. |
Invitation |
getInvitation(CustomizationContext customizationContext, String validationText)Retrieves an Invitation by validation text. |
SortableFilterablePagedResult<Invitation> |
getInvitations(CustomizationContext customizationContext, InvitationSearchCriteria invitationCriteria, int pageSize)Paginated search method for getting Invitations matching the supplied InvitationSearchCriteria The returned PagedResult can be ordered by "USERNAME", "INVITE_ADDRESS", "STATUS", "DATE" and "FROM", and can be filterd by "INVITE_ADDRESS", "STATUS", "DATE" and "FROM", using these filter methods: FilterMethod.BEGINS_WITH FilterMethod.ENDS_WITH FilterMethod.CONTAINS FilterMethod.EQUALS |
<any> |
getInvitationsPage(<any> request)Callback method to support paging for getInvitations |
CommunityMember |
getMember(CustomizationContext customizationContext, CommunityMemberId memberId)Retrieves a CommunityMember object populated with information for the CommunityMember specified by CommunityMemberId. |
CommunityMember |
getMember(CustomizationContext customizationContext, String userId)Retrieves a CommunityMember object populated with information for the CommunityMember specified by id. |
CommunityMembership |
getMembership(CustomizationContext customizationContext, CommunityMemberId mId, CommunityDefinitionId cId)Returns the CommunityMembership information for a CommunityMember, if they have a membership in the specified community. |
CommunityMembership |
getMembership(CustomizationContext customizationContext, String username, CommunityDefinitionId cId)Returns the CommunityMembership information for a user if they have a membership in the specified community. |
MessagingAddress |
getMessagingAddress(CustomizationContext customizationContext, CommunityMember member, MessagingAddressType addrType, String mappingName)Gets the MessagingAddress of a particular type and mapping name for the specified CommunityMember. |
Collection<MessagingAddress> |
getMessagingAddresses(CustomizationContext customizationContext, CommunityMember member, MessagingAddressType addrType)Gets all MessagingAddresses of a particular type for the specified CommunityMember. |
MessagingAddress |
getPrimaryMessagingAddress(CustomizationContext customizationContext, CommunityMember member, MessagingAddressType addrType)Gets the primary MessagingAddress of a particular type for the specified CommunityMember. |
void |
inviteToCommunity(CustomizationContext customizationContext, InviteeIterator invitees, InvitationDetails inviteDetails, CommunityInviter[] inviters)Invites a set of Invitees to a community, via a specified set of communications methods. |
void |
removeInvitation(CustomizationContext customizationContext, InviteeId inviteeId)Deletes a single Invitation from the database. |
void |
removeMember(CustomizationContext customizationContext, CommunityMemberId id)Removes a CommunityMember globally for all Communities. |
void |
removeMembership(CustomizationContext customizationContext, CommunityMemberId mId, CommunityDefinitionId cId)Deletes a CommunityMembership for a CommunityMember in a specified CommunityDefinition. |
void |
removeMembershipCapability(CustomizationContext customizationContext, CommunityMemberId mId, CommunityDefinitionId cId, MembershipCapability capability)Removes a capability (owner, leader or manager) from the CommunityMembership specified. |
void |
setMessagingAddress(CustomizationContext customizationContext, CommunityMember member, MessagingAddress m, String mappingName)Sets a MessagingAddress value into a mapped property in the User Profile for this CommunityMember that is used as the mapped address for the MessagingAddressType specified in the MessagingAddress. |
void |
setPrimaryMessagingAddress(CustomizationContext customizationContext, CommunityMember member, MessagingAddress m)Sets a MessagingAddress value into a mapped property in the User Profile for this CommunityMember that is used as the primary address for the MessagingAddressType specified in the MessagingAddress. |
void |
synchronousInviteToCommunity(CustomizationContext customizationContext, InviteeIterator invitees, InvitationDetails inviteDetails, CommunityInviter[] inviters)Invites a set of Invitees to a community, via a specified set of communications methods. |
long |
updateLastAccessDate(CustomizationContext customizationContext, CommunityMembershipId membershipId)Updates the last access date for the specified membership to the current time. |
| Method Detail |
|---|
CommunityMember createMember(CustomizationContext customizationContext,
CommunityMember info)
throws RemoteException,
DuplicateObjectException
CommunityMember based on the contents of the info parameter.customizationContext - customization informationinfo - a set of information on which to base the creation of the new CommunityMemberCommunityMember object populated with values corresponding to the new CommunityMemberDuplicateObjectException - if a member record already exists for the WLS user specified in the CommunityMember object.RemoteException
CommunityMember getMember(CustomizationContext customizationContext,
String userId)
throws RemoteException
CommunityMember object populated with information for the CommunityMember specified by id. If deepInfo is set to true, CommunityMembership information is also retrieved and contained within the CommunityMember return value.customizationContext - customization informationuserId - the WLS user id of the CommunityMember to look upCommunityMember object populated with information for the specified CommunityMember if they exist, otherwise null.RemoteException
CommunityMember getMember(CustomizationContext customizationContext,
CommunityMemberId memberId)
throws RemoteException
CommunityMember object populated with information for the CommunityMember specified by CommunityMemberId.customizationContext - customization informationmemberId - the CommunityMemberId of the user id of the CommunityMember to look upCommunityMember object populated with information for the specified CommunityMember if they exist, otherwise null.RemoteException
void disableMember(CustomizationContext customizationContext,
CommunityMemberId id)
throws ObjectNotFoundException,
RemoteException
CommunityMember globally for all Communities.customizationContext - customization informationid - the id of the CommunityMember to disable.ObjectNotFoundException - if the specified member does not exist in the database.RemoteException
void activateMember(CustomizationContext customizationContext,
CommunityMemberId id)
throws ObjectNotFoundException,
RemoteException
CommunityMember globally for all Communities.customizationContext - customization informationid - the id of the CommunityMember to activate.ObjectNotFoundException - if the specified member does not exist in the database.RemoteException
void removeMember(CustomizationContext customizationContext,
CommunityMemberId id)
throws ObjectNotFoundException,
RemoteException
CommunityMember globally for all Communities.customizationContext - customization informationid - the id of the CommunityMember to remove.ObjectNotFoundException - if the specified member does not exist in the database.RemoteException
CommunityMembership createMembership(CustomizationContext customizationContext,
CommunityMemberId mId,
CommunityDefinitionId cDefinitionId)
throws IllegalArgumentException,
DuplicateObjectException,
RemoteException
CommunityMembership for the specified CommunityMember in the specified CommunityDefinition.customizationContext - customization informationmId - the id of the CommunityMembercDefinitionId - the id of the CommunityDefinitionCommunityMembership object containing the new membership information.IllegalArgumentException - if the invitation does not have "sent" status or if the invitation is not for the specified member.DuplicateObjectException - if a membership already exists for the specified member and community.RemoteException
CommunityMembership createMembership(CustomizationContext customizationContext,
CommunityMemberId mId,
Invitation invitation)
throws DuplicateObjectException,
RemoteException
CommunityMembership based on an Invitation that has been sent. The new membership is created based off of the CommunityDefinition referrenced by the Invitation and the CommunityMember specifed by member id. Any MembershipCapabilities in the Invitation will additionally be added to the membership, and the Invitation will be set to the accepted status.customizationContext - customization informationmId - the id of the CommunityMember to create the membership forinvitation - an Invitation to base the membership onCommunityMembership object containing the new membership information.DuplicateObjectExceptionRemoteException
void removeMembership(CustomizationContext customizationContext,
CommunityMemberId mId,
CommunityDefinitionId cId)
throws ObjectNotFoundException,
RemoteException
CommunityMembership for a CommunityMember in a specified CommunityDefinition.customizationContext - customization informationmId - the id of the CommunityMembercId - the id of the CommunityDefinitionRemoteExceptionObjectNotFoundException - if no membership for the specified community and member exists.
void disableMembership(CustomizationContext customizationContext,
CommunityMemberId mId,
CommunityDefinitionId cId)
throws ObjectNotFoundException,
RemoteException
CommunityMembership.customizationContext - customization informationmId - the id of the CommunityMembercId - the id of the CommunityDefinitionRemoteExceptionObjectNotFoundException - if no membership for the specified community and member exists.
void activateMembership(CustomizationContext customizationContext,
CommunityMemberId mId,
CommunityDefinitionId cId)
throws RemoteException,
ObjectNotFoundException
CommunityMembership in the specified CommunityDefinition, making a disabled member able to use the community once again.customizationContext - customization informationmId - the id of the CommunityMembercId - the id of the CommunityDefinitionRemoteExceptionObjectNotFoundException - if no membership for the specified community and member exists.
CommunityMembership getMembership(CustomizationContext customizationContext,
CommunityMemberId mId,
CommunityDefinitionId cId)
throws RemoteException
CommunityMembership information for a CommunityMember, if they have a membership in the specified community.customizationContext - customization informationmId - the id of the CommunityMembercId - the id of the CommunityDefinitionCommunityMembership object populated with membership information for the specified CommunityMember, if it exists, otherwise null.RemoteException
CommunityMembership getMembership(CustomizationContext customizationContext,
String username,
CommunityDefinitionId cId)
throws RemoteException
CommunityMembership information for a user if they have a membership in the specified community.customizationContext - customization informationusername - the WLS username of the usercId - the id of the CommunityDefinitionCommunityMembership object populated with membership information for the specified user, if it exists, otherwise null.RemoteException
long updateLastAccessDate(CustomizationContext customizationContext,
CommunityMembershipId membershipId)
throws ObjectNotFoundException,
RemoteException
customizationContext - customization informationmembershipId - the ID for the CommunityMembership to updateObjectNotFoundException - if no membership can be found in the database matching the specified membership ID.RemoteException
SortableFilterablePagedResult<CommunityMembership> getCommunityMemberships(CustomizationContext context,
MembershipCriteria criteria,
int pageSize)
throws RemoteException
CommunityMembership objects for the specified member that meet the specified criteria. <p/> If the returned SortableFilterablePagedResult is re-filtered using the reFilter() method, the filter specified is used in addition to the original filter criteria specified in the MembershipCriteria object. If the filter criteria specified in the reFilter() method conflicts with a criteria specified in the original MembershipCriteria object, the newly specified filter criteria is used in place of the original MembershipCriteria for that field only; all other field criteria specified in the MembershipCriteria object will still be used as filter criteria. The returned PagedResult is sortable by "USERNAME", "MEMBER_IS_ACTIVE", "MEMBER_IS_EXTERNAL", "MEMBERSHIP_IS_ACTIVE", "LAST_ACCESS_DATE" and "JOIN_DATE". The returned PagedResult is filterable by "USERNAME", using these filter methods:
context - the context for the search.criteria - the criteria CommunityMemberships must match to be returned. If a MemberMembershipCriteria object is used, memberships matching the specified criteria for the specified member will be returned. If a CommunityMembershipCriteria object is used, memberships matching the specified criteria for the specified community will be returned.pageSize - the number of membership objects to return per result page.RemoteException
SortableFilterablePagedResult<String> getAllCommunityAssociates(CustomizationContext context,
MemberCriteria criteria,
int pageSize)
throws RemoteException,
ObjectNotFoundException
CommunityMember also belongs to. The returned PagedResult can be sorted and filtered "USERNAME" using filter methods:
context - the context for the search.criteria - the specification of the CommunityMember to get community associates of.pageSize - the number of usernames to return per result page.String WLS user IDs which is the merged community membership list for all communities the specified CommunityMember belongs to. A WLS user ID will only be included once, even if the user has a membership in multiple communities to which the specified CommunityMember also belongs.ObjectNotFoundException - if the member specified in the criteria cannot be found.RemoteException
void addMembershipCapability(CustomizationContext customizationContext,
CommunityMemberId mId,
CommunityDefinitionId cId,
MembershipCapability capability)
throws RemoteException,
IllegalArgumentException,
ObjectNotFoundException
CommunityMembership specified.customizationContext - customization informationmId - the id of the CommunityMember whose membership is to be modified.cId - the id of the Community for the membership.capability - the capability to add to the membership, which is one of the CommunityMembership.Capability constants.RemoteExceptionIllegalArgumentException - if the capability specified is not valid.ObjectNotFoundException - if the specified community membership does not exist.
void removeMembershipCapability(CustomizationContext customizationContext,
CommunityMemberId mId,
CommunityDefinitionId cId,
MembershipCapability capability)
throws RemoteException,
IllegalArgumentException,
ObjectNotFoundException
CommunityMembership specified.customizationContext - customization informationmId - the id of the CommunityMember whose membership is to be modified.cId - the id of the Community for the membership.capability - the capability to remove from the membership, which is one of the CommunityMembership.Capability constants.RemoteExceptionIllegalArgumentException - if the capability specified is not valid.ObjectNotFoundException - if the specified community membership does not exist.
void setPrimaryMessagingAddress(CustomizationContext customizationContext,
CommunityMember member,
MessagingAddress m)
throws RemoteException,
ProfileNotFoundException,
PropertyValidationException
MessagingAddress value into a mapped property in the User Profile for this CommunityMember that is used as the primary address for the MessagingAddressType specified in the MessagingAddress.customizationContext - customization informationmember - the CommunityMember to add the address to.m - the MessagingAddress value to setRemoteExceptionProfileNotFoundExceptionPropertyValidationException
void setMessagingAddress(CustomizationContext customizationContext,
CommunityMember member,
MessagingAddress m,
String mappingName)
throws RemoteException,
ProfileNotFoundException,
PropertyValidationException
MessagingAddress value into a mapped property in the User Profile for this CommunityMember that is used as the mapped address for the MessagingAddressType specified in the MessagingAddress.customizationContext - customization informationmember - the CommunityMember to add the address to.m - the MessagingAddress value to setmappingName - the name of the MessagingAddressMapping to use to set the MessagingAddressRemoteExceptionProfileNotFoundExceptionPropertyValidationException
MessagingAddress getPrimaryMessagingAddress(CustomizationContext customizationContext,
CommunityMember member,
MessagingAddressType addrType)
throws RemoteException,
ProfileNotFoundException
MessagingAddress of a particular type for the specified CommunityMember.customizationContext - customization informationmember - the CommunityMemberaddrType - the type of MessagingAddressMessagingAddress of the specified type, if it exists, otherwise null. Null is also returned if the specified member does not exist.RemoteExceptionProfileNotFoundException
MessagingAddress getMessagingAddress(CustomizationContext customizationContext,
CommunityMember member,
MessagingAddressType addrType,
String mappingName)
throws RemoteException,
ProfileNotFoundException
MessagingAddress of a particular type and mapping name for the specified CommunityMember.customizationContext - customization informationmember - the CommunityMemberaddrType - the type of MessagingAddressMessagingAddress of the specified type, if it exists, otherwise null. Null is also returned if the specified member does not exist.RemoteExceptionProfileNotFoundException
Collection<MessagingAddress> getMessagingAddresses(CustomizationContext customizationContext,
CommunityMember member,
MessagingAddressType addrType)
throws RemoteException,
ProfileNotFoundException
MessagingAddresses of a particular type for the specified CommunityMember.customizationContext - customization informationmember - the CommunityMemberaddrType - the type of MessagingAddress.Collection of MessagingAddress objects of the specified type for the specified CommunityMember, if they exist, otherwise an empty Collection.RemoteExceptionProfileNotFoundException
Collection<MessagingAddress> getAllMessagingAddresses(CustomizationContext customizationContext,
CommunityMember member)
throws RemoteException,
ProfileNotFoundException
MessagingAddresses associated with the specified CommunityMember, as determined by User profile values that are mapped to Communities MessagingAddresses.customizationContext - customization informationmember - the CommunityMemberCollection of all MessagingAddress objects o for the specified CommunityMember, if they exist, otherwise an empty Collection.RemoteExceptionProfileNotFoundException
void inviteToCommunity(CustomizationContext customizationContext,
InviteeIterator invitees,
InvitationDetails inviteDetails,
CommunityInviter[] inviters)
throws RemoteException
Invitees to a community, via a specified set of communications methods. This method is asynchronous- it returns before the invitations have been sent, allowing large batches of invitations to be sent in the background without a thread blocking.customizationContext - customization informationinvitees - an InviteeIterator that can enumerate all users to inviteinviters - an array of CommunityInviters which specifies the various communications channel Inviters the framework should use to send the invitations. The array may be empty, meaning that invitations will be created but no mechanism will be used to inform the invitee(s) that they have been invited.inviteDetails - detailed information about the invitation to performRemoteException
void synchronousInviteToCommunity(CustomizationContext customizationContext,
InviteeIterator invitees,
InvitationDetails inviteDetails,
CommunityInviter[] inviters)
throws RemoteException
Invitees to a community, via a specified set of communications methods. This method is synchronous- it blocks until all invitations have been sent. The inviteToCommunity method is asynchronous and will not block.customizationContext - customization informationinvitees - an InviteeIterator that can enumerate all users to inviteinviters - an array of CommunityInviters which specifies the various communications channel Inviters the framework should use to send the invitations. The array may be empty, meaning that invitations will be created but no mechanism will be used to inform the invitee(s) that they have been invited.inviteDetails - detailed information about the invitation to performRemoteException
Invitation getInvitation(CustomizationContext customizationContext,
String validationText)
throws RemoteException
Invitation by validation text. This is useful for cases where the Invitee was an external user and does not yet have a WLS username, and where the application supplied a unique validation text for each InviteecustomizationContext - customization informationvalidationText -RemoteException
Invitation getInvitation(CustomizationContext customizationContext,
CommunityDefinitionId communityId,
String wlsUserName)
throws RemoteException
Invitation by communityId and wlsUserName. This is useful for cases where the Invitee has an existing WLS username and the Community is known. If there is more than one Invitation for the specified user and community, the most recent Invitation will be returned.customizationContext - customization informationcommunityId -wlsUserName -RemoteException
Invitation getInvitation(CustomizationContext customizationContext,
InviteeId inviteeId)
throws RemoteException
Invitation by InviteeId. This is useful for cases where a Communities application has access to the InviteeId, typically obtained from a custom CommunityInviter implementation after an invitation operation has completed.customizationContext - customization informationinviteeId -RemoteException
SortableFilterablePagedResult<Invitation> getInvitations(CustomizationContext customizationContext,
InvitationSearchCriteria invitationCriteria,
int pageSize)
throws RemoteException
Invitations matching the supplied InvitationSearchCriteria The returned PagedResult can be ordered by "USERNAME", "INVITE_ADDRESS", "STATUS", "DATE" and "FROM", and can be filterd by "INVITE_ADDRESS", "STATUS", "DATE" and "FROM", using these filter methods:
customizationContext -invitationCriteria -pageSize - size of pages forSortableFilterablePagedResult of Invitations matching the InvitationSearchCriteriaRemoteException
<any> getInvitationsPage(<any> request)
throws RemoteException
request -PageFetchResponse used by pagination frameworkThrowsRemoteException
InvitationStatus consumeInvitation(CustomizationContext customizationContext,
InviteeId inviteeId,
InvitationStatus toStatus)
throws RemoteException
Invitation that is in active status and moves it to one of the inactive statuses. If the invitation was created with a self_destruct flag marked true, this will additionally delete the Invitation record.customizationContext - customization informationinviteeId -toStatus -InvitationStatus that the system set the Invitation to. In the case of either expiration or prior revocation, this will be the status returned instead of the input status, so the caller should check to verify the actual result of the operation.RemoteException
void removeInvitation(CustomizationContext customizationContext,
InviteeId inviteeId)
throws RemoteException
Invitation from the database.customizationContext - customization informationinviteeId - the id of the invitation to deleteRemoteException
void cleanupInactiveInvitations(CustomizationContext customizationContext,
CommunityDefinitionId communityId)
throws RemoteException
Invitations from the database for a specified Community.customizationContext - customization informationcommunityId -RemoteException
void cleanupAllInactiveInvitations(CustomizationContext customizationContext)
throws RemoteException
Invitations from the databasecustomizationContext - customization informationRemoteException
|
Oracle Fusion Middleware Java API for Oracle WebLogic Portal 10g Release 3 (10.3.2) E14255-01 |
||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright © 2010, Oracle. All rights reserved.