com.sapportals.wcm.service.actioninbox

Interface IActionInboxService

All Superinterfaces:

IService

All Known Subinterfaces:

IActionInboxServiceCleanable

public interface IActionInboxService
extends IService

The IActionInboxService stores IActionInboxNotificationss grouped by IActionInboxCategory as IActionInboxItems into IActionInboxItemCategorys.
A IActionInboxCategory represents the different types of the IActionInboxNotifications. The IActionInboxNotifications are like 'semantic events' which are send by the IActionInboxItemProducers. A IActionInboxNotification is stored as an ActionInboxItem in a user's IActionInboxItemCategory. Changes between major releases 7.0 and 7.X Added methods: getItemCategories(IResourceContext context,com.sap.security.api.IPrincipal owner), getItemCategories(com.sapportals.wcm.repository.IResourceContext, com.sap.security.api.IPrincipal, java.lang.String[]), getItemCategory(com.sapportals.wcm.repository.IResourceContext, com.sap.security.api.IPrincipal, com.sapportals.wcm.service.actioninbox.IActionInboxCategory), getItemCategory(com.sapportals.wcm.repository.IResourceContext, com.sap.security.api.IPrincipal, java.lang.String), getItemsFromIDs(com.sapportals.wcm.repository.IResourceContext, java.lang.String, com.sap.security.api.IPrincipal, java.lang.String[]), send(com.sap.security.api.IPrincipal, com.sapportals.wcm.service.actioninbox.IActionInboxItemProducer, com.sapportals.wcm.service.actioninbox.IActionInboxNotification), sendToUsers(com.sap.security.api.IPrincipal, com.sapportals.wcm.service.actioninbox.IActionInboxItemProducer, com.sapportals.wcm.service.actioninbox.IActionInboxNotification, boolean), setItemsDone(com.sapportals.wcm.service.actioninbox.IActionInboxItemProducer, java.lang.String, com.sap.security.api.IUser, java.lang.String, java.lang.String[]), setItemsDone(com.sapportals.wcm.repository.IResourceContext, com.sap.security.api.IUser, java.lang.String, com.sapportals.wcm.service.actioninbox.IActionInboxItemList), .

Copyright 2004 SAP AG

Method Summary

IActionInboxItemList	deleteItems(IActionInboxItemProducer producer, String categoryID, String[] itemIDs) Delete several existing action inbox items.
IActionInboxItemList	deleteItems(IResourceContext context, IActionInboxItemList items) Delete several existing action inbox items.
IActionInboxItemList	executeItemActions(IResourceContext context, String actionName, IActionInboxItemList items) execute an action on several existing action inbox items.
IActionInboxCategoryList	getCategories() Get the categories.
IActionInboxCategory	getCategory(String categoryID) Get a specific category by id.
IActionInboxItemCategoryList	getItemCategories(IResourceContext context, IPrincipal owner) Get all item categories for a specific user/group/role.
IActionInboxItemCategoryList	getItemCategories(IResourceContext context, IPrincipal owner, String[] categoryIDs) Get specific item categories for a specific user/group/role.
IActionInboxItemCategoryList	getItemCategories(IResourceContext context, com.sapportals.portal.security.usermanagement.IUMPrincipal owner) Deprecated. As of NetWeaver 7.1, replaced by getItemCategories(IResourceContext,com.sap.security.api.IPrincipal)
IActionInboxItemCategoryList	getItemCategories(IResourceContext context, com.sapportals.portal.security.usermanagement.IUMPrincipal owner, String[] categoryIDs) Deprecated. As of NetWeaver 7.1, replaced by getItemCategories(IResourceContext,com.sap.security.api.IPrincipal,String[])
IActionInboxItemCategory	getItemCategory(IResourceContext context, IPrincipal owner, IActionInboxCategory category) Get a specific item category for a specific user/group/role.
IActionInboxItemCategory	getItemCategory(IResourceContext context, IPrincipal owner, String categoryID) Get a specific item category for a specific user/group/role.
IActionInboxItemCategory	getItemCategory(IResourceContext context, com.sapportals.portal.security.usermanagement.IUMPrincipal owner, IActionInboxCategory category) Deprecated. As of NetWeaver 7.1, replaced by getItemCategory(IResourceContext,com.sap.security.api.IPrincipal,IActionInboxCategory)
IActionInboxItemCategory	getItemCategory(IResourceContext context, com.sapportals.portal.security.usermanagement.IUMPrincipal owner, String categoryID) Deprecated. As of NetWeaver 7.1, replaced by getItemCategory(IResourceContext,com.sap.security.api.IPrincipal,String)
IActionInboxItemList	getItemsFromIDs(IResourceContext context, String categoryID, IPrincipal owner, String[] itemIDs) Get a list of items for a given array of ids.
IActionInboxItemList	getItemsFromIDs(IResourceContext context, String categoryID, com.sapportals.portal.security.usermanagement.IUMPrincipal owner, String[] itemIDs) Deprecated. As of NetWeaver 7.1, replaced by getItemsFromIDs(IResourceContext,String,com.sap.security.api.IPrincipal,String[])
IActionInboxCategory	registerProducer(IActionInboxItemProducer itemProducer, String categoryID) Register an item producer to a category at the IActionInboxService.
IActionInboxItemList	send(Collection recipients, IActionInboxItemProducer producer, IActionInboxNotification notification) Store a notification in several user/group/role's inboxes for a given category as several items (same as send(recipients, producer, notification, false)).
IActionInboxItemList	send(Collection recipients, IActionInboxItemProducer producer, IActionInboxNotification notification, boolean isLinked) Store a notification in several user/group/role's inboxes for a given category.
IActionInboxItemList	send(IPrincipal recipient, IActionInboxItemProducer producer, IActionInboxNotification notification) Store a notification in a user/group/role's inbox for a given category.
IActionInboxItemList	send(com.sapportals.portal.security.usermanagement.IUMPrincipal recipient, IActionInboxItemProducer producer, IActionInboxNotification notification) Deprecated. As of NetWeaver 7.1, replaced by send(com.sap.security.api.IPrincipal,IActionInboxItemProducer,IActionInboxNotification)
IActionInboxItemList	sendToUsers(Collection recipients, IActionInboxItemProducer producer, IActionInboxNotification notification, boolean isLinked) Store a notification in several user's inboxes for a given category.
IActionInboxItemList	sendToUsers(IPrincipal recipient, IActionInboxItemProducer producer, IActionInboxNotification notification, boolean isLinked) Store a notification in a user's inbox for a given category.
IActionInboxItemList	sendToUsers(com.sapportals.portal.security.usermanagement.IUMPrincipal recipient, IActionInboxItemProducer producer, IActionInboxNotification notification, boolean isLinked) Deprecated. As of NetWeaver 7.1, replaced by sendToUsers(com.sap.security.api.IPrincipal,IActionInboxItemProducer,IActionInboxNotification,boolean)
IActionInboxItemList	setItemsDone(IActionInboxItemProducer producer, String categoryID, com.sapportals.portal.security.usermanagement.IUser reasonAuthor, String reasonID, String[] itemIDs) Deprecated. As of NetWeaver 7.1, replaced by setItemsDone(IActionInboxItemProducer,String,com.sap.security.api.IUser,String,String[])
IActionInboxItemList	setItemsDone(IActionInboxItemProducer producer, String categoryID, IUser reasonAuthor, String reasonID, String[] itemIDs) Set several existing action inbox items to 'done'.
IActionInboxItemList	setItemsDone(IResourceContext context, com.sapportals.portal.security.usermanagement.IUser reasonAuthor, String reasonID, IActionInboxItemList items) Deprecated. As of NetWeaver 7.1, replaced by setItemsDone(IResourceContext,com.sap.security.api.IUser,String,IActionInboxItemList)
IActionInboxItemList	setItemsDone(IResourceContext context, IUser reasonAuthor, String reasonID, IActionInboxItemList items) Set several existing action inbox items to 'done'.
IActionInboxItemList	setItemsRead(IResourceContext context, IActionInboxItemList items) Set several existing action inbox items to 'read'.
void	setItemsReadForCategory(IResourceContext context, IActionInboxItemCategory category)

Methods inherited from interface com.sapportals.wcm.service.IService

getDescription, getDescription, getID

Method Detail

registerProducer

IActionInboxCategory registerProducer(IActionInboxItemProducer itemProducer,
                                      String categoryID)
                                      throws WcmException

Register an item producer to a category at the IActionInboxService.

Parameters:

itemProducer - the IActionInboxItemProducer to register.

categoryID - the String of the category's id, for which the producer will produce items.

Returns:

the IActionInboxCategory the producer registered to.

Throws:

WcmException - WcmException if an error occurred.

getCategories

IActionInboxCategoryList getCategories()
                                       throws WcmException

Get the categories.

Returns:

a IActionInboxCategoryList of categories.

Throws:

WcmException - a WcmException if an error occurred.

getCategory

IActionInboxCategory getCategory(String categoryID)
                                 throws WcmException

Get a specific category by id.

Parameters:

categoryID - the String with the desired category's id.

Returns:

a IActionInboxCategory for the given id.

Throws:

WcmException - a WcmException if an error occurred.

getItemCategories

IActionInboxItemCategoryList getItemCategories(IResourceContext context,
                                               com.sapportals.portal.security.usermanagement.IUMPrincipal owner)
                                               throws WcmException

Deprecated. As of NetWeaver 7.1, replaced by getItemCategories(IResourceContext,com.sap.security.api.IPrincipal)

Get all item categories for a specific user/group/role.

Parameters:

context - the IResourceContext to use for accessing the inbox.

owner - the IUMPrincipal of the user/group/role to get the inbox for.

Returns:

a IActionInboxItemCategoryList with the inbox categories for the given user/group/role. If the specified owner is not a user, the list will contain only those groups which are not for users only.

Throws:

WcmException - a WcmException if an error occurred.

getItemCategories

IActionInboxItemCategoryList getItemCategories(IResourceContext context,
                                               IPrincipal owner)
                                               throws WcmException

Get all item categories for a specific user/group/role.

Parameters:

context - the IResourceContext to use for accessing the inbox.

owner - the IUMPrincipal of the user/group/role to get the inbox for.

Returns:

a IActionInboxItemCategoryList with the inbox categories for the given user/group/role. If the specified owner is not a user, the list will contain only those groups which are not for users only.

Throws:

WcmException - a WcmException if an error occurred.

Since:

NetWeaver 7.1

getItemCategories

IActionInboxItemCategoryList getItemCategories(IResourceContext context,
                                               com.sapportals.portal.security.usermanagement.IUMPrincipal owner,
                                               String[] categoryIDs)
                                               throws WcmException

Deprecated. As of NetWeaver 7.1, replaced by getItemCategories(IResourceContext,com.sap.security.api.IPrincipal,String[])

Get specific item categories for a specific user/group/role.

Parameters:

context - the IResourceContext to use for accessing the inbox.

owner - the IUMPrincipal of the user/group/role to get the inbox for.

categoryIDs - an array of Strings with the ids of the desired categories.

Returns:

a IActionInboxItemCategoryList with the inbox categories for the given user/group/role and ids. If the specified owner is not a user, the list will contain only those groups which are not for users only.

Throws:

WcmException - a WcmException if an error occurred.

getItemCategories

IActionInboxItemCategoryList getItemCategories(IResourceContext context,
                                               IPrincipal owner,
                                               String[] categoryIDs)
                                               throws WcmException

Get specific item categories for a specific user/group/role.

Parameters:

context - the IResourceContext to use for accessing the inbox.

owner - the IUMPrincipal of the user/group/role to get the inbox for.

categoryIDs - an array of Strings with the ids of the desired categories.

Returns:

a IActionInboxItemCategoryList with the inbox categories for the given user/group/role and ids. If the specified owner is not a user, the list will contain only those groups which are not for users only.

Throws:

WcmException - a WcmException if an error occurred.

Since:

NetWeaver 7.1

getItemCategory

IActionInboxItemCategory getItemCategory(IResourceContext context,
                                         com.sapportals.portal.security.usermanagement.IUMPrincipal owner,
                                         IActionInboxCategory category)
                                         throws WcmException

Deprecated. As of NetWeaver 7.1, replaced by getItemCategory(IResourceContext,com.sap.security.api.IPrincipal,IActionInboxCategory)

Get a specific item category for a specific user/group/role.

Parameters:

context - the IResourceContext to use for accessing the inbox.

owner - the IUMPrincipal of the user/group/role to get the inbox for.

category - the IActionInboxCategory with the category of the item category to get.

Returns:

a IActionInboxItemCategory with the inbox category for the given user/group/role and id. Is null if the specified owner is not a user but the requested category is for users only.

Throws:

WcmException - a WcmException if an error occurred.

getItemCategory

IActionInboxItemCategory getItemCategory(IResourceContext context,
                                         IPrincipal owner,
                                         IActionInboxCategory category)
                                         throws WcmException

Get a specific item category for a specific user/group/role.

Parameters:

context - the IResourceContext to use for accessing the inbox.

owner - the IUMPrincipal of the user/group/role to get the inbox for.

category - the IActionInboxCategory with the category of the item category to get.

Returns:

a IActionInboxItemCategory with the inbox category for the given user/group/role and id. Is null if the specified owner is not a user but the requested category is for users only.

Throws:

WcmException - a WcmException if an error occurred.

Since:

NetWeaver 7.1

getItemCategory

IActionInboxItemCategory getItemCategory(IResourceContext context,
                                         com.sapportals.portal.security.usermanagement.IUMPrincipal owner,
                                         String categoryID)
                                         throws WcmException

Deprecated. As of NetWeaver 7.1, replaced by getItemCategory(IResourceContext,com.sap.security.api.IPrincipal,String)

Get a specific item category for a specific user/group/role.

Parameters:

context - the IResourceContext to use for accessing the inbox.

owner - the IUMPrincipal of the user/group/role to get the inbox for.

categoryID - the String with the desired category's id.

Returns:

a IActionInboxItemCategory with the inbox category for the given user/group/role and id. Is null if the specified owner is not a user but the requested category is for users only.

Throws:

WcmException - a WcmException if an error occurred.

getItemCategory

IActionInboxItemCategory getItemCategory(IResourceContext context,
                                         IPrincipal owner,
                                         String categoryID)
                                         throws WcmException

Get a specific item category for a specific user/group/role.

Parameters:

context - the IResourceContext to use for accessing the inbox.

owner - the IUMPrincipal of the user/group/role to get the inbox for.

categoryID - the String with the desired category's id.

Returns:

a IActionInboxItemCategory with the inbox category for the given user/group/role and id. Is null if the specified owner is not a user but the requested category is for users only.

Throws:

WcmException - a WcmException if an error occurred.

Since:

NetWeaver 7.1

getItemsFromIDs

IActionInboxItemList getItemsFromIDs(IResourceContext context,
                                     String categoryID,
                                     com.sapportals.portal.security.usermanagement.IUMPrincipal owner,
                                     String[] itemIDs)
                                     throws WcmException

Deprecated. As of NetWeaver 7.1, replaced by getItemsFromIDs(IResourceContext,String,com.sap.security.api.IPrincipal,String[])

Get a list of items for a given array of ids.

Parameters:

context - the IResourceContext to use for accessing the inbox.

categoryID - a String with the id of the category to get the items for.

owner - the IUMPrincipal of the user/group/role to get the inbox items for.

itemIDs -

Returns:

a IActionInboxItemList with the list of items for the given ids.

Throws:

WcmException - a WcmException if an error occurred.

getItemsFromIDs

IActionInboxItemList getItemsFromIDs(IResourceContext context,
                                     String categoryID,
                                     IPrincipal owner,
                                     String[] itemIDs)
                                     throws WcmException

Get a list of items for a given array of ids.

Parameters:

context - the IResourceContext to use for accessing the inbox.

categoryID - a String with the id of the category to get the items for.

owner - the IUMPrincipal of the user/group/role to get the inbox items for.

itemIDs -

Returns:

a IActionInboxItemList with the list of items for the given ids.

Throws:

WcmException - a WcmException if an error occurred.

Since:

NetWeaver 7.1

send

IActionInboxItemList send(com.sapportals.portal.security.usermanagement.IUMPrincipal recipient,
                          IActionInboxItemProducer producer,
                          IActionInboxNotification notification)
                          throws WcmException

Deprecated. As of NetWeaver 7.1, replaced by send(com.sap.security.api.IPrincipal,IActionInboxItemProducer,IActionInboxNotification)

Store a notification in a user/group/role's inbox for a given category. If the category is for users only, the recipient will be automatically resolved, if it's not a user.

Parameters:

recipient - a IUMPrincipal with the owner to send the notification to.

producer - a IActionInboxItemProducer with the producer of this notification.

notification - the IActionInboxNotification to store.

Returns:

a IActionInboxItemLists with the successfully sent items (might be more than one, if the recipient is not a user and the category is for users only).

Throws:

WcmException - WcmException if an error occurred.

send

IActionInboxItemList send(IPrincipal recipient,
                          IActionInboxItemProducer producer,
                          IActionInboxNotification notification)
                          throws WcmException

Store a notification in a user/group/role's inbox for a given category. If the category is for users only, the recipient will be automatically resolved, if it's not a user.

Parameters:

recipient - a IUMPrincipal with the owner to send the notification to.

producer - a IActionInboxItemProducer with the producer of this notification.

notification - the IActionInboxNotification to store.

Returns:

a IActionInboxItemLists with the successfully sent items (might be more than one, if the recipient is not a user and the category is for users only).

Throws:

WcmException - WcmException if an error occurred.

Since:

NetWeaver 7.1

send

IActionInboxItemList send(Collection recipients,
                          IActionInboxItemProducer producer,
                          IActionInboxNotification notification)
                          throws WcmException

Store a notification in several user/group/role's inboxes for a given category as several items (same as send(recipients, producer, notification, false)). If the category is for users only, recipients which are not users will be automatically resolved.

Parameters:

recipients - a Collection of IUMPrincipals with the users/roles/groups to send the notification to.

producer - a IActionInboxItemProducer with the producer of this notification.

notification - the IActionInboxNotification to store.

Returns:

a IActionInboxItemLists with the successfully sent items.

Throws:

WcmException - WcmException if an error occurred.

send

IActionInboxItemList send(Collection recipients,
                          IActionInboxItemProducer producer,
                          IActionInboxNotification notification,
                          boolean isLinked)
                          throws WcmException

Store a notification in several user/group/role's inboxes for a given category. If the category is for users only, recipients which are not users will be automatically resolved.

Parameters:

recipients - a Collection of IUMPrincipals with the users/roles/groups to send the notification to.

producer - a IActionInboxItemProducer with the producer of this notification.

notification - the IActionInboxNotification to store.

isLinked - a boolean true, if the notification should be treated as a linked notification, false if not (each notification is a separate item).

Returns:

a IActionInboxItemLists with the successfully sent items.

Throws:

WcmException - WcmException if an error occurred.

sendToUsers

IActionInboxItemList sendToUsers(com.sapportals.portal.security.usermanagement.IUMPrincipal recipient,
                                 IActionInboxItemProducer producer,
                                 IActionInboxNotification notification,
                                 boolean isLinked)
                                 throws WcmException

Deprecated. As of NetWeaver 7.1, replaced by sendToUsers(com.sap.security.api.IPrincipal,IActionInboxItemProducer,IActionInboxNotification,boolean)

Store a notification in a user's inbox for a given category. If the recipient is not a user, the group/role is resolved and the item is saved in the inboxes of the user's belonging to this group/role.

Parameters:

recipient - a IUMPrincipal with the user/role/group to send the notification to.

producer - a IActionInboxItemProducer with the producer of this notification.

notification - the IActionInboxNotification to store.

isLinked - a boolean true, if the notification should be treated as a linked notification, false if not (each notification is a separate item).

Returns:

a IActionInboxItemLists with the successfully sent items.

Throws:

WcmException - WcmException if an error occurred.

sendToUsers

IActionInboxItemList sendToUsers(IPrincipal recipient,
                                 IActionInboxItemProducer producer,
                                 IActionInboxNotification notification,
                                 boolean isLinked)
                                 throws WcmException

Store a notification in a user's inbox for a given category. If the recipient is not a user, the group/role is resolved and the item is saved in the inboxes of the user's belonging to this group/role.

Parameters:

recipient - a IUMPrincipal with the user/role/group to send the notification to.

producer - a IActionInboxItemProducer with the producer of this notification.

notification - the IActionInboxNotification to store.

isLinked - a boolean true, if the notification should be treated as a linked notification, false if not (each notification is a separate item).

Returns:

a IActionInboxItemLists with the successfully sent items.

Throws:

WcmException - WcmException if an error occurred.

Since:

NetWeaver 7.1

sendToUsers

IActionInboxItemList sendToUsers(Collection recipients,
                                 IActionInboxItemProducer producer,
                                 IActionInboxNotification notification,
                                 boolean isLinked)
                                 throws WcmException

Store a notification in several user's inboxes for a given category. If a recipient is not a user, the group/role is resolved and the item is saved in the inboxes of the user's belonging to this group/role.

Parameters:

recipients - a Collection of IUMPrincipals with the users/roles/groups to send the notification to.

producer - a IActionInboxItemProducer with the producer of this notification.

notification - the IActionInboxNotification to store.

isLinked - a boolean true, if the notification should be treated as a linked notification, false if not (each notification is a separate item).

Returns:

a IActionInboxItemLists with the successfully sent items.

Throws:

WcmException - WcmException if an error occurred.

setItemsDone

IActionInboxItemList setItemsDone(IActionInboxItemProducer producer,
                                  String categoryID,
                                  com.sapportals.portal.security.usermanagement.IUser reasonAuthor,
                                  String reasonID,
                                  String[] itemIDs)
                                  throws WcmException

Deprecated. As of NetWeaver 7.1, replaced by setItemsDone(IActionInboxItemProducer,String,com.sap.security.api.IUser,String,String[])

Set several existing action inbox items to 'done'.

Parameters:

producer - a IActionInboxItemProducer with the producer of this notification.

categoryID - the String with the desired category's id.

reasonAuthor - a IUser with the user who caused the 'done' state.

reasonID - a String with a reason code.

itemIDs - an array of Strings with the ids of the IActionInboxItem to set to 'done'.

Returns:

a IActionInboxItemLists with the set items.

Throws:

WcmException - WcmException if an error occurred.

setItemsDone

IActionInboxItemList setItemsDone(IActionInboxItemProducer producer,
                                  String categoryID,
                                  IUser reasonAuthor,
                                  String reasonID,
                                  String[] itemIDs)
                                  throws WcmException

Set several existing action inbox items to 'done'.

Parameters:

producer - a IActionInboxItemProducer with the producer of this notification.

categoryID - the String with the desired category's id.

reasonAuthor - a IUser with the user who caused the 'done' state.

reasonID - a String with a reason code.

itemIDs - an array of Strings with the ids of the IActionInboxItem to set to 'done'.

Returns:

a IActionInboxItemLists with the set items.

Throws:

WcmException - WcmException if an error occurred.

Since:

NetWeaver 7.1

setItemsRead

IActionInboxItemList setItemsRead(IResourceContext context,
                                  IActionInboxItemList items)
                                  throws WcmException

Set several existing action inbox items to 'read'.

Parameters:

context - the IResourceContext to use for accessing the inbox.

items - an array of Strings with the ids of the IActionInboxItem to set to 'read'.

Returns:

a IActionInboxItemLists with the set items.

Throws:

WcmException - WcmException if an error occurred.

setItemsDone

IActionInboxItemList setItemsDone(IResourceContext context,
                                  com.sapportals.portal.security.usermanagement.IUser reasonAuthor,
                                  String reasonID,
                                  IActionInboxItemList items)
                                  throws WcmException

Deprecated. As of NetWeaver 7.1, replaced by setItemsDone(IResourceContext,com.sap.security.api.IUser,String,IActionInboxItemList)

Set several existing action inbox items to 'done'.

Parameters:

context - the IResourceContext to use for accessing the inbox.

reasonAuthor - a IUser with the user who caused the 'done' state.

reasonID - a String with a reason code.

items - an array of Strings with the ids of the IActionInboxItem to set to 'done'.

Returns:

a IActionInboxItemLists with the set items.

Throws:

WcmException - WcmException if an error occurred.

setItemsDone

IActionInboxItemList setItemsDone(IResourceContext context,
                                  IUser reasonAuthor,
                                  String reasonID,
                                  IActionInboxItemList items)
                                  throws WcmException

Set several existing action inbox items to 'done'.

Parameters:

context - the IResourceContext to use for accessing the inbox.

reasonAuthor - a IUser with the user who caused the 'done' state.

reasonID - a String with a reason code.

items - an array of Strings with the ids of the IActionInboxItem to set to 'done'.

Returns:

a IActionInboxItemLists with the set items.

Throws:

WcmException - WcmException if an error occurred.

Since:

NetWeaver 7.1

deleteItems

IActionInboxItemList deleteItems(IActionInboxItemProducer producer,
                                 String categoryID,
                                 String[] itemIDs)
                                 throws WcmException

Delete several existing action inbox items.

Parameters:

producer - a IActionInboxItemProducer with the producer of this notification.

categoryID - the String with the desired category's id.

itemIDs - an array of Strings with the ids of the IActionInboxItem to set to 'done'.

Returns:

a IActionInboxItemLists with the deleted items.

Throws:

WcmException - WcmException if an error occurred.

deleteItems

IActionInboxItemList deleteItems(IResourceContext context,
                                 IActionInboxItemList items)
                                 throws WcmException

Delete several existing action inbox items.

Parameters:

context - the IResourceContext to use for accessing the inbox.

items - an array of Strings with the ids of the IActionInboxItem to delete.

Returns:

a IActionInboxItemLists with the deleted items.

Throws:

WcmException - WcmException if an error occurred.

executeItemActions

IActionInboxItemList executeItemActions(IResourceContext context,
                                        String actionName,
                                        IActionInboxItemList items)
                                        throws WcmException

execute an action on several existing action inbox items.

Parameters:

context - the IResourceContext to use for accessing the inbox.

actionName - a String with the name of the action to excute. The name has to exist in all of the categories the specified items in the array belong to.

items - an array of Strings with the ids of the IActionInboxItem to execute the action for.

Returns:

a IActionInboxItemLists> with the items the action has been executed for.

Throws:

WcmException - WcmException if an error occurred.

setItemsReadForCategory

void setItemsReadForCategory(IResourceContext context,
                             IActionInboxItemCategory category)
                             throws WcmException

Parameters:

context -

category -

Throws:

WcmException

Access Rights

This class can be accessed from:

SC	DC	Public Part	ACH
[sap.com] KMC-CM	[sap.com] tc/km/frwk	api	EP-KM-CM
[sap.com] KMC-WPC	[sap.com] tc/kmc/wpc/wpcfacade	api	EP-PIN-WPC-WCM