@Deprecated
public interface DiscussionMetadataCoreService
extends com.appiancorp.services.ContextSensitiveService
LocalObject
, such as a Document or Knowledge Center.
Forums can be public or private. Anyone can view and post to a public forum,
whereas only selected users can view and post to a private forum (as specified
in the actors role map).
A user can subscribe to a topic/thread, in which case he/she will receive a notification whenever a new message is posted to the thread. If the user subscribes to a forum, he/she will receive a notification whenever a new message is posted to any of the topics in the forum.
Individual topics can be sponsored, which provides a way of flagging more important topics. Topics can then be retrieved or sorted based on the sponsored flag. Sponsoring is not connected to the user who marks the topic as sponsored (the topic is simply marked as "sponsored").
Individual messages can be rated by users.
Security for discussion forums is managed through the ForumsRoleMap
class.
NOTE: This service only deals with discussion forums metadata, it does not
write any content to disk. The DiscussionBodyService
should be used
to save content.
Methods of service classes can all throw the unchecked exception
ServiceException
if any
system-level error (for example, server failure) occurs, and will in general
throw a checked exception (InvalidXXXException
) when an entity
to be retrieved is inaccessible, instead of returning null
.
Exceptions to this paradigm (including the use of ResultList
as
described below) are noted. All checked exceptions extend
AppianException
.
It may be necessary to retrieve a subset of results as opposed to an entire
collection, and also to sort the subset by some property of the returned
object. "Paging" methods which return a
ResultPage
are provided in certain
instances for this purpose. The ResultPage
will contain the
sorted subset of results
(via Result.getResults()
), and the
total number of items in the available result set
(via ResultPage.getAvailableItems()
).
It may also be necessary to retrieve some results, even if all results
cannot be retrieved (for instance, some of the entities corresponding
to a list of entity IDs may no longer exist). Methods which return a
ResultList
are provided for this
purpose. The Result.getResults()
method in this case will return all results which can be retrieved. In
addition, there will be a list of result codes
(ResultList.getResultCodes()
) that
represent the successful retrieval of an entity, or, if the entity could
not be retrieved, the reason for the failure. See the CODE_XXX
constants in ResultList
for details.
DiscussionBodyService
,
Forum
,
ForumSummary
,
ThreadSummary
,
GlobalId
,
Attachment
,
ForumsRoleMap
Modifier and Type | Field and Description |
---|---|
static boolean |
acceptThreadInvitation$UPDATES
Deprecated.
|
static java.lang.Integer |
ACTION_FORUM_CREATE_THREAD
Deprecated.
The index of the element in the
allowedActions field of the
Forum bean that indicates whether the user can create threads
in the forum |
static java.lang.Integer |
ACTION_FORUM_DELETE
Deprecated.
The index of the element in the
allowedActions field of the
Forum bean that indicates whether the user can delete the
forum |
static java.lang.Integer |
ACTION_FORUM_SPONSOR_THREAD
Deprecated.
The index of the element in the
allowedActions field of the
Forum bean that indicates whether the user can sponsor a
thread in the forum |
static java.lang.Integer |
ACTION_FORUM_SUBSCRIBE
Deprecated.
The index of the element in the
allowedActions field of the
Forum bean that indicates whether the user can subscribe to
the forum |
static java.lang.Integer |
ACTION_FORUM_UNSPONSOR_THREAD
Deprecated.
The index of the element in the
allowedActions field of the
Forum bean that indicates whether the user can unsponsor a
thread in the forum |
static java.lang.Integer |
ACTION_FORUM_UNSUBSCRIBE
Deprecated.
The index of the element in the
allowedActions field of the
Forum bean that indicates whether the user can unsubscribe
from the forum |
static java.lang.Integer |
ACTION_FORUM_UPDATE
Deprecated.
The index of the element in the
allowedActions field of the
Forum bean that indicates whether the user can update the
forum |
static java.lang.Integer |
ACTION_FORUM_VIEW
Deprecated.
The index of the element in the
allowedActions field of the
Forum bean that indicates whether the user can view the
forum |
static java.lang.Integer |
ACTION_MESSAGE_ADD_RATING
Deprecated.
The index of the element in the
allowedActions field of the
Message bean that indicates whether the user can
add a rating to the message |
static java.lang.Integer |
ACTION_MESSAGE_DELETE
Deprecated.
The index of the element in the
allowedActions field of the
Message bean that indicates whether the user can
delete the message |
static java.lang.Integer |
ACTION_MESSAGE_DELETE_WITH_DESCENDANTS
Deprecated.
The index of the element in the
allowedActions field of the
Message bean that indicates whether the user can
delete the message and its descendents |
static java.lang.Integer |
ACTION_MESSAGE_SET_RATING
Deprecated.
The index of the element in the
allowedActions field of the
Message bean that indicates whether the user can
set the rating of the message |
static java.lang.Integer |
ACTION_MESSAGE_UPDATE
Deprecated.
The index of the element in the
allowedActions field of the
Message bean that indicates whether the user can
update the message |
static java.lang.Integer |
ACTION_MESSAGE_VIEW
Deprecated.
The index of the element in the
allowedActions field of the
Message bean that indicates whether the user can
view the message |
static java.lang.Integer |
ACTION_MESSAGE_VIEW_ANONYMOUS
Deprecated.
The index of the element in the
allowedActions field of the
Message bean that indicates whether the user can
anonymously view the message |
static java.lang.Integer |
ACTION_THREAD_ADD_RESOURCE
Deprecated.
The index of the element in the
allowedActions field of the
ThreadSummary bean that indicates whether the user can
add a resource to the thread |
static java.lang.Integer |
ACTION_THREAD_CREATE_MESSAGE
Deprecated.
The index of the element in the
allowedActions field of the
ThreadSummary bean that indicates whether the user can create
a message in the thread |
static java.lang.Integer |
ACTION_THREAD_DELETE
Deprecated.
The index of the element in the
allowedActions field of the
ThreadSummary bean that indicates whether the user can delete
the thread |
static java.lang.Integer |
ACTION_THREAD_INVITE_OTHER_USERS
Deprecated.
The index of the element in the
allowedActions field of the
ThreadSummary bean that indicates whether the user can
invite other users to the thread |
static java.lang.Integer |
ACTION_THREAD_MOVE
Deprecated.
The index of the element in the
allowedActions field of the
ThreadSummary bean that indicates whether the user can move
the thread |
static java.lang.Integer |
ACTION_THREAD_REMOVE_RESOURCE
Deprecated.
The index of the element in the
allowedActions field of the
ThreadSummary bean that indicates whether the user can
remove a resource from the thread |
static java.lang.Integer |
ACTION_THREAD_SPONSOR
Deprecated.
The index of the element in the
allowedActions field of the
ThreadSummary bean that indicates whether the user can
sponsor the thread |
static java.lang.Integer |
ACTION_THREAD_SUBSCRIBE
Deprecated.
The index of the element in the
allowedActions field of the
ThreadSummary bean that indicates whether the user can
subscribe to the thread |
static java.lang.Integer |
ACTION_THREAD_UNSPONSOR
Deprecated.
The index of the element in the
allowedActions field of the
ThreadSummary bean that indicates whether the user can
unsponsor the thread |
static java.lang.Integer |
ACTION_THREAD_UNSUBSCRIBE
Deprecated.
The index of the element in the
allowedActions field of the
ThreadSummary bean that indicates whether the user can
unsubscribe from the thread |
static java.lang.Integer |
ACTION_THREAD_UPDATE
Deprecated.
The index of the element in the
allowedActions field of the
ThreadSummary bean that indicates whether the user can update
the thread |
static java.lang.Integer |
ACTION_THREAD_VIEW
Deprecated.
The index of the element in the
allowedActions field of the
ThreadSummary bean that indicates whether the user can
view the thread |
static boolean |
activateUserSession$UPDATES
Deprecated.
|
static boolean |
addActorsToRolesInForums$UPDATES
Deprecated.
|
static boolean |
addRating$UPDATES
Deprecated.
|
static boolean |
addThreadResource$UPDATES
Deprecated.
|
static boolean |
addThreadResources$UPDATES
Deprecated.
|
static boolean |
allowedAnonymousPosting$UPDATES
Deprecated.
|
static boolean |
changePartitionPaths$UPDATES
Deprecated.
|
static boolean |
commitUpdateUsernames$UPDATES
Deprecated.
|
static boolean |
createForum$UPDATES
Deprecated.
|
static boolean |
createForums$UPDATES
Deprecated.
|
static boolean |
createMessage$UPDATES
Deprecated.
|
static boolean |
createMessages$UPDATES
Deprecated.
|
static boolean |
deleteForum$UPDATES
Deprecated.
|
static boolean |
deleteMessage$UPDATES
Deprecated.
|
static boolean |
deleteMessageAndDescendants$UPDATES
Deprecated.
|
static boolean |
deleteThread$UPDATES
Deprecated.
|
static boolean |
denyThreadInvitation$UPDATES
Deprecated.
|
static boolean |
disableForumAnonymousPosting$UPDATES
Deprecated.
|
static boolean |
enableForumAnonymousPosting$UPDATES
Deprecated.
|
static boolean |
findForumsPaging$UPDATES
Deprecated.
|
static boolean |
getAllDeletedMessagesPaging$UPDATES
Deprecated.
|
static boolean |
getAllForumsPaging$UPDATES
Deprecated.
|
static boolean |
getAllForumSummariesPaging$UPDATES
Deprecated.
|
static boolean |
getApplicationName$UPDATES
Deprecated.
|
static boolean |
getApplicationPermissions$UPDATES
Deprecated.
|
static boolean |
getChildrenForMessagePaging$UPDATES
Deprecated.
|
static boolean |
getForum$UPDATES
Deprecated.
|
static boolean |
getForumIdsByRelated$UPDATES
Deprecated.
|
static boolean |
getForumIdsByRelatedPaging$UPDATES
Deprecated.
|
static boolean |
getForums$UPDATES
Deprecated.
|
static boolean |
getForumsList$UPDATES
Deprecated.
|
static boolean |
getForumsPaging$UPDATES
Deprecated.
|
static boolean |
getForumSummariesPaging$UPDATES
Deprecated.
|
static boolean |
getMessage$UPDATES
Deprecated.
|
static boolean |
getMessageCountByUsers$UPDATES
Deprecated.
|
static boolean |
getMessageCountByUsersForForum$UPDATES
Deprecated.
|
static boolean |
getMessages$UPDATES
Deprecated.
|
static boolean |
getMessagesByUserPaging$UPDATES
Deprecated.
|
static boolean |
getMessagesForThread$UPDATES
Deprecated.
|
static boolean |
getMessagesForThreadPaging$UPDATES
Deprecated.
|
static boolean |
getMessagesList$UPDATES
Deprecated.
|
static boolean |
getMessagesPaging$UPDATES
Deprecated.
|
static boolean |
getPermissionsForMessageIdsForSessionUser$UPDATES
Deprecated.
|
static boolean |
getPermissionsForMessageIdsForUser$UPDATES
Deprecated.
|
static boolean |
getRoleMapForForum$UPDATES
Deprecated.
|
static boolean |
getRoleMapForThread$UPDATES
Deprecated.
|
static boolean |
getSponsoredThreadSummariesPaging$UPDATES
Deprecated.
|
static boolean |
getSubscribedForumsPaging$UPDATES
Deprecated.
|
static boolean |
getSubscribedThreadsPaging$UPDATES
Deprecated.
|
static boolean |
getSubscribersForForum$UPDATES
Deprecated.
|
static boolean |
getSubscribersForThread$UPDATES
Deprecated.
|
static boolean |
getThread$UPDATES
Deprecated.
|
static boolean |
getThreadedMessagesPaging$UPDATES
Deprecated.
|
static boolean |
getThreads$UPDATES
Deprecated.
|
static boolean |
getThreadsForForum$UPDATES
Deprecated.
|
static boolean |
getThreadsForForumPaging$UPDATES
Deprecated.
|
static boolean |
getThreadsList$UPDATES
Deprecated.
|
static boolean |
getThreadsPaging$UPDATES
Deprecated.
|
static boolean |
getThreadSummariesForForumPaging$UPDATES
Deprecated.
|
static boolean |
getThreadSummariesPaging$UPDATES
Deprecated.
|
static boolean |
getTopUsersForForum$UPDATES
Deprecated.
|
static boolean |
getTopUsersForSite$UPDATES
Deprecated.
|
static boolean |
getUsersToNotify$UPDATES
Deprecated.
|
static boolean |
getUsersToNotifyForForum$UPDATES
Deprecated.
|
static boolean |
getValidForumSummariesPaging$UPDATES
Deprecated.
|
static boolean |
getWorkspace$UPDATES
Deprecated.
|
static boolean |
importMessages$UPDATES
Deprecated.
|
static boolean |
inviteUsersToThread$UPDATES
Deprecated.
|
static boolean |
isForumPublic$UPDATES
Deprecated.
|
static boolean |
isInvitedToThreads$UPDATES
Deprecated.
|
static boolean |
isSubscribedToForum$UPDATES
Deprecated.
|
static boolean |
isSubscribedToThread$UPDATES
Deprecated.
|
static int |
MESSAGE_PERMISSION_CAN_VIEW
Deprecated.
Indicates that the user is allowed to view the message
|
static int |
MESSAGE_PERMISSION_CANNOT_VIEW
Deprecated.
Indicates that the user is not allowed to view the message
|
static int |
MESSAGE_PERMISSION_INVALID
Deprecated.
Indicates that no permissions can be obtained for the message because
the specified message was null or does not exist
|
static boolean |
moveThread$UPDATES
Deprecated.
|
static boolean |
notifyUserCreation$UPDATES
Deprecated.
|
static boolean |
notifyUsersCreation$UPDATES
Deprecated.
|
static boolean |
reloadProperties$UPDATES
Deprecated.
|
static boolean |
removeThreadResource$UPDATES
Deprecated.
|
static boolean |
removeThreadResources$UPDATES
Deprecated.
|
static boolean |
rollbackUpdateUsernames$UPDATES
Deprecated.
|
static boolean |
setAdministratorGroup$UPDATES
Deprecated.
|
static boolean |
setForumPrivate$UPDATES
Deprecated.
|
static boolean |
setForumPublic$UPDATES
Deprecated.
|
static boolean |
setRating$UPDATES
Deprecated.
|
static boolean |
setRoleMapForForum$UPDATES
Deprecated.
|
static boolean |
setTimeZone$UPDATES
Deprecated.
|
static boolean |
setTimeZoneSameAs$UPDATES
Deprecated.
|
static boolean |
sponsor$UPDATES
Deprecated.
|
static boolean |
sponsorForMessage$UPDATES
Deprecated.
|
static boolean |
subscribeToForum$UPDATES
Deprecated.
|
static boolean |
subscribeToThread$UPDATES
Deprecated.
|
static boolean |
subscribeUsersToThread$UPDATES
Deprecated.
|
static boolean |
unsponsor$UPDATES
Deprecated.
|
static boolean |
unsponsorForMessage$UPDATES
Deprecated.
|
static boolean |
unsubscribeFromForum$UPDATES
Deprecated.
|
static boolean |
unsubscribeFromThread$UPDATES
Deprecated.
|
static boolean |
updateForum$UPDATES
Deprecated.
|
static boolean |
updateForums$UPDATES
Deprecated.
|
static boolean |
updateMessage$UPDATES
Deprecated.
|
static boolean |
updateMessages$UPDATES
Deprecated.
|
static boolean |
updateUsernames$UPDATES
Deprecated.
|
static boolean |
validate$UPDATES
Deprecated.
|
static boolean |
validateGroupMembership$UPDATES
Deprecated.
|
static boolean |
validateTypedValues$UPDATES
Deprecated.
|
Modifier and Type | Method and Description |
---|---|
void |
acceptThreadInvitation(java.lang.Long threadId_)
Deprecated.
Called by the invitee to accept the invitation.
|
boolean[] |
activateUserSession(java.lang.Long[] memberGroups_,
java.lang.Long[] adminGroups_,
java.lang.Long userTypeId_)
Deprecated.
|
void |
addActorsToRolesInForums(java.lang.Long forumId_,
java.lang.String[] usernames_,
java.lang.Long[] groupIds_,
java.lang.String role_)
Deprecated.
Add users/groups to a given role in a forum.
|
void |
addRating(java.lang.Long messageId_,
int rating_)
Deprecated.
Average a new individual rating into the message's overall average rating.
|
void |
addThreadResource(java.lang.Long threadId_,
Attachment resource_)
Deprecated.
Add an attachment to a thread.
|
void |
addThreadResources(java.lang.Long threadId_,
Attachment[] resources_)
Deprecated.
Add multiple attachments to a thread.
|
boolean |
allowedAnonymousPosting(java.lang.Long forumId_)
Deprecated.
Returns whether anonymous posting is allowed for a given forum.
|
void |
changePartitionPaths(java.lang.String originalPath,
java.lang.String newPath)
Deprecated.
Changes where message texts are stored from one path to another.
|
void |
commitUpdateUsernames()
Deprecated.
|
java.lang.Long |
createForum(Forum f_)
Deprecated.
Create a discussion forum.
|
java.lang.Long[] |
createForums(Forum[] forums_)
Deprecated.
Create multiple discussion forums.
|
Message |
createMessage(java.lang.Long forumId_,
Message m_)
Deprecated.
Create a message.
|
Message[] |
createMessages(java.lang.Long[] forumIds_,
Message[] msgs_)
Deprecated.
Create multiple messages, one per forum.
|
void |
deleteForum(java.lang.Long forumId_)
Deprecated.
Delete a forum (and all of its threads).
|
void |
deleteMessage(java.lang.Long messageId_)
Deprecated.
Delete a given message (connects any children of the given message
to the parent of the message).
|
void |
deleteMessageAndDescendants(java.lang.Long messageId_)
Deprecated.
Delete a message and all its descendants.
|
void |
deleteThread(java.lang.Long threadId_)
Deprecated.
Delete a thread (and all of its messages).
|
void |
denyThreadInvitation(java.lang.Long threadId_)
Deprecated.
Called by the invitee to deny the invitation.
|
void |
disableForumAnonymousPosting(java.lang.Long forumId_)
Deprecated.
Disallows anonymous posting for a given forum (can only be set by a
forums administrator or a user having equivalent/higher privileges).
|
void |
enableForumAnonymousPosting(java.lang.Long forumId_)
Deprecated.
Allow anonymous posting for a given forum
|
ResultPage |
findForumsPaging(java.lang.String nameSearchString_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Find forums by name (gets the forums whose name matches a given query
string).
|
ResultPage |
getAllDeletedMessagesPaging(int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get all the messages that have been deleted, paging.
|
ResultPage |
getAllForumsPaging(int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get all forums, paging.
|
ResultPage |
getAllForumSummariesPaging(int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get the summaries of all forums, paging.
|
java.lang.String |
getApplicationName()
Deprecated.
Gets the name of the application on which this service is running.
|
boolean[] |
getApplicationPermissions()
Deprecated.
Returns boolean[3] of system permissions which is set in session.
|
ResultPage |
getChildrenForMessagePaging(java.lang.Long messageId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get all the child messages (ie replies) of a given message, paging.
|
Forum |
getForum(java.lang.Long id_)
Deprecated.
Get a forum.
|
java.lang.Long[] |
getForumIdsByRelated(LocalObject related_)
|
ResultPage |
getForumIdsByRelatedPaging(LocalObject related_,
int startIndex_,
int batchSize_,
java.lang.Integer sortOrder_)
Deprecated.
Get the ids of the forums related to a given Appian Type object (an Appian
Type is any type that has a corresponding TYPE_XXX constant defined in
ObjectTypeMapping ). |
Forum[] |
getForums(java.lang.Long[] ids_)
|
ResultList |
getForumsList(java.lang.Long[] forumIds_)
Deprecated.
Gets the specified forums, returning the valid results even if all
the results cannot be retrieved (for instance, if some of the forums
corresponding to the passed ids no longer exist).
|
ResultPage |
getForumsPaging(java.lang.Long[] forumIds_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Gets multiple forums, paging.
|
ResultPage |
getForumSummariesPaging(java.lang.Long[] forumIds_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get the summaries of multiple forums, paging.
|
Message |
getMessage(java.lang.Long messageId_)
Deprecated.
Get a message.
|
UserMessageCount[] |
getMessageCountByUsers(java.lang.String[] usernameList)
Deprecated.
Returns the number of message posts grouped by a list of users.
|
UserMessageCount[] |
getMessageCountByUsers(java.lang.String[] usernameList,
java.sql.Date fromDate,
java.sql.Date toDate)
Deprecated.
Returns the number of message posts grouped by a list of users from the fromDate to the toDate.
|
UserMessageCount[] |
getMessageCountByUsersForForum(java.lang.String[] usernameList,
java.sql.Date fromDate,
java.sql.Date toDate,
java.lang.Long forumId)
Deprecated.
Returns the number of message posts grouped by a list of users from the fromDate to the toDate.
|
Message[] |
getMessages(java.lang.Long[] messageIds_)
|
ResultPage |
getMessagesByUserPaging(java.lang.String username,
int startIndex,
int batchSize,
int sortProperty,
int sortOrder)
Deprecated.
This function gets all messages for a specific user.
|
Message[] |
getMessagesForThread(java.lang.Long threadId_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_,
int startIndex_,
int count_)
|
ResultPage |
getMessagesForThreadPaging(java.lang.Long threadId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get all the messages in a given thread, paging.
|
ResultList |
getMessagesList(java.lang.Long[] messageIds_)
Deprecated.
Gets the specified messages, returning the valid results even if all
the results cannot be retrieved (for instance, if some of the messages
corresponding to the passed ids no longer exist).
|
ResultPage |
getMessagesPaging(java.lang.Long[] messageIds_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get multiple messages, paging.
|
int[] |
getPermissionsForMessageIdsForSessionUser(java.lang.Long[] messageIds_)
Deprecated.
Get the permissions that the current user has for the given messages.
|
int[] |
getPermissionsForMessageIdsForUser(java.lang.Long[] messageIds_,
java.lang.String username_)
Deprecated.
Get the permissions that a given user has for the given messages.
|
ForumsRoleMap |
getRoleMapForForum(java.lang.Long forumId_)
Deprecated.
Get the rolemap of a forum.
|
ForumsRoleMap |
getRoleMapForThread(java.lang.Long threadId_)
Deprecated.
Get the rolemap of a thread; currently a thread always inherits the
rolemap from its parent forum.
|
ResultPage |
getSponsoredThreadSummariesPaging(java.lang.Long[] forumIds_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get the summaries of all the sponsored threads in multiple forums, paging.
|
ResultPage |
getSponsoredThreadSummariesPaging(java.lang.Long forumId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get the summaries of all the sponsored threads in a forum, paging.
|
ResultPage |
getSubscribedForumsPaging(int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get all the forums to which the current user is subscribed, paging.
|
ResultPage |
getSubscribedThreadsPaging(int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get all the threads to which the current user is subscribed, paging.
|
java.lang.String[] |
getSubscribersForForum(java.lang.Long forumId_)
Deprecated.
Returns the usernames of the users subscribed to a given forum.
|
java.lang.String[] |
getSubscribersForThread(java.lang.Long threadId_)
Deprecated.
Get the usernames of the users subscribed to a thread.
|
DiscussionThread |
getThread(java.lang.Long threadId_)
Deprecated.
Get a thread.
|
ResultPage |
getThreadedMessagesPaging(java.lang.Long forumId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get all the messages in a forum as
ThreadedMessage objects. |
DiscussionThread[] |
getThreads(java.lang.Long[] threadIds_)
|
DiscussionThread[] |
getThreadsForForum(java.lang.Long forumId_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_,
int startIndex_,
int count_)
|
ResultPage |
getThreadsForForumPaging(java.lang.Long forumId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get all the threads in a given forum, paging.
|
ResultList |
getThreadsList(java.lang.Long[] threadIds_)
Deprecated.
Gets the specified threads, returning the valid results even if all
the results cannot be retrieved (for instance, if some of the threads
corresponding to the passed ids no longer exist).
|
ResultPage |
getThreadsPaging(java.lang.Long[] threadIds_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get multiple threads, paging.
|
ResultPage |
getThreadSummariesForForumPaging(java.lang.Long forumId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get the summaries of all the threads in a forum, paging.
|
ResultPage |
getThreadSummariesPaging(java.lang.Long[] threadIds_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get the summaries of multiple threads, paging.
|
UserMessageCount[] |
getTopUsersForForum(java.sql.Date fromDate,
java.sql.Date toDate,
java.lang.Long forumId,
int topNUsers)
Deprecated.
Returns which users are the most active when posting into a particular forum.
|
UserMessageCount[] |
getTopUsersForSite(java.sql.Date fromDate,
java.sql.Date toDate,
int topNUsers)
Deprecated.
Returns which users are the most active when posting into the entire site.
|
java.lang.String[] |
getUsersToNotify(java.lang.Long threadId_)
Deprecated.
Get the usernames of the users who should receive notifications when
updates are made to a given thread.
|
java.lang.String[] |
getUsersToNotifyForForum(java.lang.Long forumId_)
Deprecated.
Get the usernames of the users who should receive notification when
updates are made to a given forum or any of its threads.
|
ResultPage |
getValidForumSummariesPaging(java.lang.Long[] forumIds_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Get the summaries of valid multiple forums, paging.
|
java.lang.String[] |
getWorkspace()
Deprecated.
Gets the current memory profile for the workspace.
|
Message[] |
importMessages(java.lang.Long[] forumIds_,
Message[] msgs_)
Deprecated.
Import multiple messages, one per forum.
|
void |
inviteUsersToThread(java.lang.String[] usernames_,
java.lang.Long threadId_)
Deprecated.
Add invitation for the given users to the given
thread . |
boolean |
isForumPublic(java.lang.Long forumId_)
Deprecated.
Returns whether a forum is public.
|
boolean[] |
isInvitedToThreads(java.lang.Long[] threadIds_)
Deprecated.
Called to check if the invitation to threads for current user are valid.
|
boolean |
isSubscribedToForum(java.lang.Long forumId_)
Deprecated.
Get the current user's subscription status for a given forum.
|
boolean |
isSubscribedToThread(java.lang.Long threadId_)
Deprecated.
Determine whether the current user is subscribed to a thread.
|
void |
moveThread(java.lang.Long threadId_,
java.lang.Long toForumId_)
Deprecated.
Move a thread to a different forum.
|
void |
notifyUserCreation(java.lang.String username_)
Deprecated.
done automatically by UserService.createUser
|
void |
notifyUsersCreation(java.lang.String[] usernames_)
Deprecated.
Notifies this service that new users have been created
(see
notifyUserCreation(java.lang.String) ). |
void |
reloadProperties()
Deprecated.
reloading properties is now automatic, so this call is now unnecessary and does nothing.
|
void |
removeThreadResource(java.lang.Long threadId_,
Attachment resource_)
Deprecated.
Remove an attachment from a thread.
|
void |
removeThreadResources(java.lang.Long threadId_,
Attachment[] resources_)
Deprecated.
Remove multiple resources from a thread.
|
void |
rollbackUpdateUsernames()
Deprecated.
|
void |
setAdministratorGroup(java.lang.Long groupId_)
Deprecated.
Sets the group to which a user must belong to be a forums administrator.
|
void |
setForumPrivate(java.lang.Long forumId_)
Deprecated.
Set a forum to be private, ie allow only users/groups that are
participants and administrators to see the forum and participate.
|
void |
setForumPublic(java.lang.Long forumId_)
Deprecated.
Set a forum to be public, ie allow all users to see the forum and
participate.
|
void |
setRating(java.lang.Long messageId_,
double averageRating_,
int ratingCount_)
Deprecated.
Set the average rating for a message.
|
void |
setRoleMapForForum(java.lang.Long forumId_,
ForumsRoleMap r_)
Deprecated.
Set the rolemap of a forum.
|
void |
setTimeZone(BackendTimeZoneSimple tz)
Deprecated.
Set a backend timezone.
|
void |
setTimeZoneSameAs(BackendTimeZoneSimple tz,
java.lang.String sameAsId)
Deprecated.
|
void |
sponsor(java.lang.Long threadId_)
Deprecated.
Sponsor a thread (simply marks the thread as 'sponsored').
|
void |
sponsorForMessage(java.lang.Long messageId_)
Deprecated.
Sponsor a thread through a thread message (sponsors the thread that
contains the message whose id is passed).
|
void |
subscribeToForum(java.lang.Long forumId_)
Deprecated.
Subscribe the current user to a given forum.
|
void |
subscribeToThread(java.lang.Long threadId_)
Deprecated.
Subscribe the current user to a thread.
|
void |
subscribeUsersToThread(java.lang.Long threadId_,
java.lang.String[] users_)
Deprecated.
the combination of
inviteUsersToThread(java.lang.String[], java.lang.Long) and
acceptThreadInvitation(java.lang.Long) is more secure, and should be used instead |
void |
unsponsor(java.lang.Long threadId_)
Deprecated.
Unsponsor a thread.
|
void |
unsponsorForMessage(java.lang.Long messageId_)
Deprecated.
Unsponsor a thread through a thread message (unsponsors the thread that
contains the message whose id is passed).
|
void |
unsubscribeFromForum(java.lang.Long forumId_)
Deprecated.
Unsubscribes the current user from a given forum.
|
void |
unsubscribeFromThread(java.lang.Long threadId_)
Deprecated.
Unsubscribe the current user from a thread.
|
void |
updateForum(Forum f_)
Deprecated.
Update the properties of a discussion forum.
|
void |
updateForums(Forum[] forums_)
Deprecated.
Update the properties of multiple discussion forums.
|
java.lang.String |
updateMessage(Message m_)
Deprecated.
Update the properties of a message.
|
java.lang.String[] |
updateMessages(Message[] m_)
Deprecated.
Update the properties of multiple messages.
|
void |
updateUsernames(java.lang.String[] oldUsernames_,
java.lang.String[] newUsernames_,
long maxExpirationTimeInSeconds_)
Deprecated.
|
java.lang.String |
validate()
Deprecated.
Runs validation tests against the database to check whether it is corrupt,
and returns a line-separated list of validation results
|
boolean |
validateGroupMembership(java.lang.Long[] memGroupIds_,
java.lang.Long[] admGroupIds_)
Deprecated.
No longer necessary with credential system
|
boolean |
validateTypedValues(TypedValue[] typedValues)
Deprecated.
Validates given TypedValues.
|
static final int MESSAGE_PERMISSION_INVALID
static final int MESSAGE_PERMISSION_CANNOT_VIEW
static final int MESSAGE_PERMISSION_CAN_VIEW
static final java.lang.Integer ACTION_FORUM_CREATE_THREAD
allowedActions
field of the
Forum
bean that indicates whether the user can create threads
in the forumstatic final java.lang.Integer ACTION_FORUM_UPDATE
allowedActions
field of the
Forum
bean that indicates whether the user can update the
forumstatic final java.lang.Integer ACTION_FORUM_DELETE
allowedActions
field of the
Forum
bean that indicates whether the user can delete the
forumstatic final java.lang.Integer ACTION_FORUM_VIEW
allowedActions
field of the
Forum
bean that indicates whether the user can view the
forumstatic final java.lang.Integer ACTION_FORUM_SUBSCRIBE
allowedActions
field of the
Forum
bean that indicates whether the user can subscribe to
the forumstatic final java.lang.Integer ACTION_FORUM_UNSUBSCRIBE
allowedActions
field of the
Forum
bean that indicates whether the user can unsubscribe
from the forumstatic final java.lang.Integer ACTION_FORUM_SPONSOR_THREAD
allowedActions
field of the
Forum
bean that indicates whether the user can sponsor a
thread in the forumstatic final java.lang.Integer ACTION_FORUM_UNSPONSOR_THREAD
allowedActions
field of the
Forum
bean that indicates whether the user can unsponsor a
thread in the forumstatic final java.lang.Integer ACTION_THREAD_CREATE_MESSAGE
allowedActions
field of the
ThreadSummary
bean that indicates whether the user can create
a message in the threadstatic final java.lang.Integer ACTION_THREAD_UPDATE
allowedActions
field of the
ThreadSummary
bean that indicates whether the user can update
the threadstatic final java.lang.Integer ACTION_THREAD_DELETE
allowedActions
field of the
ThreadSummary
bean that indicates whether the user can delete
the threadstatic final java.lang.Integer ACTION_THREAD_MOVE
allowedActions
field of the
ThreadSummary
bean that indicates whether the user can move
the threadstatic final java.lang.Integer ACTION_THREAD_VIEW
allowedActions
field of the
ThreadSummary
bean that indicates whether the user can
view the threadstatic final java.lang.Integer ACTION_THREAD_ADD_RESOURCE
allowedActions
field of the
ThreadSummary
bean that indicates whether the user can
add a resource to the threadstatic final java.lang.Integer ACTION_THREAD_REMOVE_RESOURCE
allowedActions
field of the
ThreadSummary
bean that indicates whether the user can
remove a resource from the threadstatic final java.lang.Integer ACTION_THREAD_SUBSCRIBE
allowedActions
field of the
ThreadSummary
bean that indicates whether the user can
subscribe to the threadstatic final java.lang.Integer ACTION_THREAD_UNSUBSCRIBE
allowedActions
field of the
ThreadSummary
bean that indicates whether the user can
unsubscribe from the threadstatic final java.lang.Integer ACTION_THREAD_SPONSOR
allowedActions
field of the
ThreadSummary
bean that indicates whether the user can
sponsor the threadstatic final java.lang.Integer ACTION_THREAD_UNSPONSOR
allowedActions
field of the
ThreadSummary
bean that indicates whether the user can
unsponsor the threadstatic final java.lang.Integer ACTION_THREAD_INVITE_OTHER_USERS
allowedActions
field of the
ThreadSummary
bean that indicates whether the user can
invite other users to the threadstatic final java.lang.Integer ACTION_MESSAGE_UPDATE
allowedActions
field of the
Message
bean that indicates whether the user can
update the messagestatic final java.lang.Integer ACTION_MESSAGE_DELETE
allowedActions
field of the
Message
bean that indicates whether the user can
delete the messagestatic final java.lang.Integer ACTION_MESSAGE_DELETE_WITH_DESCENDANTS
allowedActions
field of the
Message
bean that indicates whether the user can
delete the message and its descendentsstatic final java.lang.Integer ACTION_MESSAGE_ADD_RATING
allowedActions
field of the
Message
bean that indicates whether the user can
add a rating to the messagestatic final java.lang.Integer ACTION_MESSAGE_SET_RATING
allowedActions
field of the
Message
bean that indicates whether the user can
set the rating of the messagestatic final java.lang.Integer ACTION_MESSAGE_VIEW
allowedActions
field of the
Message
bean that indicates whether the user can
view the messagestatic final java.lang.Integer ACTION_MESSAGE_VIEW_ANONYMOUS
allowedActions
field of the
Message
bean that indicates whether the user can
anonymously view the messagestatic final boolean createForum$UPDATES
static final boolean setAdministratorGroup$UPDATES
static final boolean updateForum$UPDATES
static final boolean updateForums$UPDATES
static final boolean deleteForum$UPDATES
static final boolean getForum$UPDATES
static final boolean getForums$UPDATES
static final boolean getForumIdsByRelated$UPDATES
static final boolean deleteThread$UPDATES
static final boolean getThread$UPDATES
static final boolean getThreads$UPDATES
static final boolean getThreadsForForum$UPDATES
static final boolean getThreadsForForumPaging$UPDATES
static final boolean moveThread$UPDATES
static final boolean addThreadResource$UPDATES
static final boolean addThreadResources$UPDATES
static final boolean removeThreadResource$UPDATES
static final boolean removeThreadResources$UPDATES
static final boolean subscribeToThread$UPDATES
static final boolean subscribeUsersToThread$UPDATES
static final boolean unsubscribeFromThread$UPDATES
static final boolean isSubscribedToThread$UPDATES
static final boolean getSubscribersForThread$UPDATES
static final boolean sponsor$UPDATES
static final boolean unsponsor$UPDATES
static final boolean sponsorForMessage$UPDATES
static final boolean unsponsorForMessage$UPDATES
static final boolean createMessage$UPDATES
static final boolean updateMessage$UPDATES
static final boolean updateMessages$UPDATES
static final boolean getMessage$UPDATES
static final boolean getMessages$UPDATES
static final boolean getMessagesForThread$UPDATES
static final boolean addRating$UPDATES
static final boolean setRating$UPDATES
static final boolean deleteMessageAndDescendants$UPDATES
static final boolean deleteMessage$UPDATES
static final boolean setRoleMapForForum$UPDATES
static final boolean getRoleMapForForum$UPDATES
static final boolean getRoleMapForThread$UPDATES
static final boolean activateUserSession$UPDATES
static final boolean getUsersToNotify$UPDATES
static final boolean getUsersToNotifyForForum$UPDATES
static final boolean isSubscribedToForum$UPDATES
static final boolean subscribeToForum$UPDATES
static final boolean unsubscribeFromForum$UPDATES
static final boolean enableForumAnonymousPosting$UPDATES
static final boolean disableForumAnonymousPosting$UPDATES
static final boolean setForumPublic$UPDATES
static final boolean setForumPrivate$UPDATES
static final boolean getForumsPaging$UPDATES
static final boolean findForumsPaging$UPDATES
static final boolean getAllForumsPaging$UPDATES
static final boolean getAllForumSummariesPaging$UPDATES
static final boolean getThreadsPaging$UPDATES
static final boolean getMessagesPaging$UPDATES
static final boolean getForumIdsByRelatedPaging$UPDATES
static final boolean getMessagesForThreadPaging$UPDATES
static final boolean getForumSummariesPaging$UPDATES
static final boolean getValidForumSummariesPaging$UPDATES
static final boolean getThreadSummariesPaging$UPDATES
static final boolean getSponsoredThreadSummariesPaging$UPDATES
static final boolean getThreadedMessagesPaging$UPDATES
static final boolean getThreadSummariesForForumPaging$UPDATES
static final boolean addActorsToRolesInForums$UPDATES
static final boolean allowedAnonymousPosting$UPDATES
static final boolean getAllDeletedMessagesPaging$UPDATES
static final boolean getPermissionsForMessageIdsForSessionUser$UPDATES
static final boolean getPermissionsForMessageIdsForUser$UPDATES
static final boolean getSubscribersForForum$UPDATES
static final boolean isForumPublic$UPDATES
static final boolean notifyUserCreation$UPDATES
static final boolean notifyUsersCreation$UPDATES
static final boolean getSubscribedThreadsPaging$UPDATES
static final boolean getSubscribedForumsPaging$UPDATES
static final boolean getChildrenForMessagePaging$UPDATES
static final boolean getApplicationName$UPDATES
static final boolean getApplicationPermissions$UPDATES
static final boolean getWorkspace$UPDATES
static final boolean createMessages$UPDATES
static final boolean createForums$UPDATES
static final boolean importMessages$UPDATES
static final boolean getThreadsList$UPDATES
static final boolean getForumsList$UPDATES
static final boolean getMessagesList$UPDATES
static final boolean validateGroupMembership$UPDATES
static final boolean updateUsernames$UPDATES
static final boolean commitUpdateUsernames$UPDATES
static final boolean rollbackUpdateUsernames$UPDATES
static final boolean inviteUsersToThread$UPDATES
static final boolean acceptThreadInvitation$UPDATES
static final boolean denyThreadInvitation$UPDATES
static final boolean isInvitedToThreads$UPDATES
static final boolean changePartitionPaths$UPDATES
static final boolean reloadProperties$UPDATES
static final boolean validate$UPDATES
static final boolean validateTypedValues$UPDATES
static final boolean setTimeZone$UPDATES
static final boolean setTimeZoneSameAs$UPDATES
static final boolean getMessageCountByUsers$UPDATES
static final boolean getMessageCountByUsersForForum$UPDATES
static final boolean getTopUsersForForum$UPDATES
static final boolean getTopUsersForSite$UPDATES
static final boolean getMessagesByUserPaging$UPDATES
java.lang.Long createForum(Forum f_) throws PrivilegeException, DuplicateUuidException
f_
- The forum to be created. The following fields of the passed
object must be set: name
, creator
and
dateCreated
. The value of the id
field is
ignored (can be null
), since it will be assigned by the
server.PrivilegeException
- if the current user does not have sufficient
privileges to create a forum. Only SYSADMIN, APPADMIN, OWNER,
ADMINISTRATOR, WRITER, READER, and USER roles in
ForumsRoleMap
may create forums.DuplicateUuidException
- if the UUID of the forum already existsServiceException
- if any system-level error occursvoid setAdministratorGroup(java.lang.Long groupId_) throws java.lang.NullPointerException
groupId_
- The id of the group to be set as the forums
administrator group.java.lang.NullPointerException
- if groupId_
is nullServiceException
- if any system-level error occursvoid updateForum(Forum f_) throws PrivilegeException, InvalidForumException
id
and remoteId
are not changed.f_
- The Forum
object whose properties should be used
to update the existing forum. The id
field of the passed
object should be set to the id of the forum to update. The existing
forum's properties are overwritten with the corresponding values contained
in the passed object.PrivilegeException
- if the current user does not have sufficient
privileges to update the forum. Only SYSADMIN, APPADMIN, OWNER, and
ADMINISTRATOR roles in ForumsRoleMap
may update forums.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursvoid updateForums(Forum[] forums_) throws PrivilegeException, InvalidForumException
id
and remoteId
are not changed.forums_
- An array of Forum
objects containing the
properties that should be used to update the corresponding exisitng
forums. The id
field of each object should be set to the id
of the forum to update. Each existing forum's properties are overwritten
with the corresponding values contained in the passed object.PrivilegeException
- if the current user does not have sufficient
privileges to update at least one of the forums. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may update forums.InvalidForumException
- if any one of the forum ids is invalidServiceException
- if any system-level error occursvoid deleteForum(java.lang.Long forumId_) throws PrivilegeException, InvalidForumException
forumId_
- The local id of the forum to be deleted (ie the
id
field of a Forum
object).PrivilegeException
- if the current user does not have
sufficient privileges to delete the forum. Only SYSADMIN, APPADMIN, OWNER,
and ADMINISTRATOR roles in ForumsRoleMap
may delete forums.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursForum getForum(java.lang.Long id_) throws PrivilegeException, InvalidForumException
id_
- The local id of the forum to be retrieved (ie the
id
field of a Forum
object).PrivilegeException
- if the current user does not have
sufficient privileges to view this forum. Only SYSADMIN, APPADMIN, OWNER,
ADMINISTRATOR, WRITER, and READER roles in ForumsRoleMap
may
view forums.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occurs@Deprecated Forum[] getForums(java.lang.Long[] ids_) throws PrivilegeException, InvalidForumException
ids_
- The local ids of the forums to be returned.PrivilegeException
- if the current user does not have
sufficient privileges to view any one of the forums. Only SYSADMIN,
APPADMIN, OWNER, ADMINISTRATOR, WRITER, and READER roles in
ForumsRoleMap
may view forums.InvalidForumException
- if any one of the forum ids is invalidServiceException
- if any system-level error occurs@Deprecated java.lang.Long[] getForumIdsByRelated(LocalObject related_)
getForumIdsByRelatedPaging(com.appiancorp.suiteapi.common.LocalObject, int, int, java.lang.Integer)
.ObjectTypeMapping
).related_
- The identifier specifiying the object for which related
forums are to be returned.ServiceException
- if any system-level error occursvoid deleteThread(java.lang.Long threadId_) throws PrivilegeException, InvalidThreadException
threadId_
- The id of the thread to delete.PrivilegeException
- if the user does not have
sufficient privileges to delete the thread. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may delete threads.InvalidThreadException
- if the passed thread id is invalidServiceException
- if any system-level error occursDiscussionThread getThread(java.lang.Long threadId_) throws PrivilegeException, InvalidThreadException
threadId_
- The id of the thread to be returned.PrivilegeException
- if the user does not have sufficient privileges
to view this thread. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, WRITER, and READER roles in ForumsRoleMap
may view threads.InvalidThreadException
- if the passed id is invalidServiceException
- if any system-level error occurs@Deprecated DiscussionThread[] getThreads(java.lang.Long[] threadIds_) throws PrivilegeException, InvalidThreadException
threadIds_
- The ids of the threads to be returned.java.lang.NullPointerException
- if any one of the passed ids is
null
PrivilegeException
- if the user does not have
sufficient privileges to view any of the threads. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, WRITER, and READER roles in ForumsRoleMap
may view threads.InvalidThreadException
- if any of the threads is invalidServiceException
- if any system-level error occurs@Deprecated DiscussionThread[] getThreadsForForum(java.lang.Long forumId_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_, int startIndex_, int count_) throws InvalidForumException
getThreadsForForumPaging(java.lang.Long, int, int, java.lang.Integer, java.lang.Integer)
.forumId_
- The local id of the forum from which to get the threads.sortProperty_
- the property by which the results will be sorted. Use a
SORT_PROPERTY_THREAD_XXX
constant.sortOrder_
- the order in which to sort the results. This is one of
Constants.SORT_ORDER_ASCENDING
or Constants.SORT_ORDER_DESCENDING
startIndex_
- the index into the collection of total results at which
to start. Negative numbers are treated as zeros.count_
- the number of results to return.
Use Constants.COUNT_ALL
to return the entire collection, but this is STRONGLY discouraged.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursResultPage getThreadsForForumPaging(java.lang.Long forumId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidForumException
forumId_
- The id (local id) of the forum from which to get
the threads.startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in DiscussionThread
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
DiscussionThread
objects.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursvoid moveThread(java.lang.Long threadId_, java.lang.Long toForumId_) throws PrivilegeException, InvalidThreadException, InvalidForumException
threadId_
- The id of the thread to move.toForumId_
- The id of the forum to which to move the thread.PrivilegeException
- if the current user does not have
sufficient privileges to move the thread. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may move threads.InvalidThreadException
- if the passed thread id is invalidInvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursvoid addThreadResource(java.lang.Long threadId_, Attachment resource_) throws PrivilegeException, InvalidThreadException
threadId_
- The id of the thread to which to add the attachment.resource_
- The resource attachment to add. The attached
field of the object must be set. If the same attachment was already added
by another user, the attachement will not be readded.PrivilegeException
- if the current user does not have sufficient
privileges to attach the resource to the thread. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, and WRITER roles in ForumsRoleMap
may add resources to threads.InvalidThreadException
- if the passed thread id is invalidServiceException
- if any system-level error occursvoid addThreadResources(java.lang.Long threadId_, Attachment[] resources_) throws PrivilegeException, InvalidThreadException
threadId_
- The id of the thread to which to add the attachments.resources_
- The resource attachments to add. The
attached
field of each object must be set. If the same
attachment was already added by another user, the attachement will not
be readded.PrivilegeException
- if the current user does not have sufficient
privileges to attach any one of the resources. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, and WRITER roles in ForumsRoleMap
may add resources to threads.InvalidThreadException
- if the passed thread id is invalidServiceException
- if any system-level error occursvoid removeThreadResource(java.lang.Long threadId_, Attachment resource_) throws PrivilegeException, InvalidThreadException
threadId_
- The id of the thread from which to remove the attachment.resource_
- The resource attachment to remove. The
attached
field of the object must be set.PrivilegeException
- if the current user does not have sufficient
privileges to remove the resource from the thread. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may remove resources from threads.InvalidThreadException
- if the passed thread id is invalidServiceException
- if any system-level error occursvoid removeThreadResources(java.lang.Long threadId_, Attachment[] resources_) throws PrivilegeException, InvalidThreadException
threadId_
- The id of the thread from which to remove the
attachments.resources_
- The resource attachments to remove. The
attached
field of each object must be set.PrivilegeException
- if the current user does not have sufficient
privileges to remove the resource. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may remove resources from threads.InvalidThreadException
- if the passed thread id is invalidServiceException
- if any system-level error occursvoid subscribeToThread(java.lang.Long threadId_) throws PrivilegeException, InvalidThreadException
threadId_
- The id of the thread to subscribe to.PrivilegeException
- if the current user does not have
sufficient privileges to subscribe to the thread. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, WRITER, and READER roles in ForumsRoleMap
may subscribe to threads.InvalidThreadException
- if the passed thread id is invalidServiceException
- if any system-level error occurs@Deprecated void subscribeUsersToThread(java.lang.Long threadId_, java.lang.String[] users_) throws InvalidUserException, InvalidThreadException, PrivilegeException
inviteUsersToThread(java.lang.String[], java.lang.Long)
and
acceptThreadInvitation(java.lang.Long)
is more secure, and should be used insteadthreadId_
- The id of the thread to subscribe to.users_
- The logins (usernames) of the users to subscribe to
the thread.InvalidUserException
- if any of the passed usernames is invalidInvalidThreadException
- if the passed thread id is invalidPrivilegeException
- if the current user does not have sufficient
privileges to subscirbe the passed users to the thread. Only SYSADMIN,
APPADMIN, OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may remove resources from threads.ServiceException
- if any system-level error occursvoid unsubscribeFromThread(java.lang.Long threadId_) throws PrivilegeException, InvalidThreadException
threadId_
- The id of the thread to unsubscribe from.PrivilegeException
- if the current user does not have
sufficient privileges to unsubscribe from the thread. Only SYSADMIN,
APPADMIN, OWNER, ADMINISTRATOR, WRITER, and READER roles in
ForumsRoleMap
may unsubscribe from threads.InvalidThreadException
- if the passed thread id is invalidServiceException
- if any system-level error occursboolean isSubscribedToThread(java.lang.Long threadId_) throws InvalidThreadException
threadId_
- The id of a thread.true
if the current user is subscribed to the passed,
thread, and false
otherwiseServiceException
- if any system-level error occursInvalidThreadException
- if the passed thread id is invalidjava.lang.String[] getSubscribersForThread(java.lang.Long threadId_) throws InvalidThreadException
threadId_
- The id of a thread.InvalidThreadException
- if the passed thread id is invalidServiceException
- if any system-level error occursvoid sponsor(java.lang.Long threadId_) throws PrivilegeException, InvalidThreadException
threadId_
- The id of the thread to sponsor.PrivilegeException
- if the current user does not have
sufficient privileges to sponsor the thread. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may sponsor threads.InvalidThreadException
- if the passed thread id is invalidServiceException
- if any system-level error occursvoid unsponsor(java.lang.Long threadId_) throws PrivilegeException, InvalidThreadException
threadId_
- The id of the thread to unsponsor.PrivilegeException
- if the current user does not have
sufficient privileges to unsponsor the thread. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may unsponsor threads.InvalidThreadException
- if the passed thread id is invalidServiceException
- if any system-level error occursvoid sponsorForMessage(java.lang.Long messageId_) throws PrivilegeException, InvalidMessageException
messageId_
- The id of a message in the thread that will
be sponsored.PrivilegeException
- if the current user does not have
sufficient privileges to sponsor the thread. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may sponsor threads.InvalidMessageException
- if the passed message id is invalidServiceException
- if any system-level error occursvoid unsponsorForMessage(java.lang.Long messageId_) throws PrivilegeException, InvalidMessageException
messageId_
- The id of a message in the thread to unsponsor.PrivilegeException
- if the current user does not have
sufficient privileges to unsponsor the thread. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may unsponsor threads.InvalidMessageException
- if the passed message id is invalidServiceException
- if any system-level error occursMessage createMessage(java.lang.Long forumId_, Message m_) throws InvalidForumException, InvalidMessageException, java.lang.IllegalArgumentException, PrivilegeException
DiscussionBodyService.createMessage(com.appiancorp.suiteapi.forums.Message)
,
using the filename
returned by this method.forumId_
- The id of the forum in which to create the new message.m_
- The Message
object from which to create the
message. The minimum required fields that must be set in the object are:
threadId
, parentId
, subject
, and
anonymousAuthor
. When creating a new thread, the
threadId
and parentId
fields should be set to 0
or null.
The id
, remoteId
, and filename
will be assigned by the server.id
, remoteId
,
and filename
fields properly populated.PrivilegeException
- if the current user does not have sufficient
privileges to create the message. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, and WRITER roles in ForumsRoleMap
may create messages.InvalidMessageException
- if the parentId
of the passed
message is invalidjava.lang.IllegalArgumentException
- if the user attempts to post the message
anonymously but the Forum does not accept anonymous postsInvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursjava.lang.NullPointerException
- if the m_
message is nulljava.lang.String updateMessage(Message m_) throws PrivilegeException, java.lang.IllegalArgumentException, InvalidMessageException
id
,
remoteId
, and filename
fields are not changed.m_
- The Message
object whose properties should be used
to update the existing message. The id
field of the passed
object should be set to the id of the message to update. The existing
message's properties are overwritten with the corresponding values
contained in the passed object (with the exception of id
,
remoteId
, and filename
which are not changed).filename
for the body of the message.PrivilegeException
- if the current user does not have sufficient
privileges to update the message. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may update messages.java.lang.IllegalArgumentException
- if the user attempts to post the message
anonymously but the Forum does not accept anonymous postsInvalidMessageException
- if no message exists with the same id as
the message passed inServiceException
- if any system-level error occursjava.lang.String[] updateMessages(Message[] m_) throws PrivilegeException, InvalidMessageException
id
,
remoteId
, and filename
fields are not changed.m_
- An array of Message
objects containing the
properties that should be used to update the corresponding existing
messages. The id
field of each passed object should be set
to the id of the message to update. Each existing message's properties
are overwritten with the corresponding values contained in the passed
object (with the exception of id
, remoteId
,
and filename
which are not changed).PrivilegeException
- if the user does not have
sufficient privileges to update at least one of the messages.
Only SYSADMIN, APPADMIN, OWNER, and ADMINISTRATOR roles in
ForumsRoleMap
may uupdate messages.InvalidMessageException
- if no message exists with the same id as
the message passed inServiceException
- if any system-level error occursMessage getMessage(java.lang.Long messageId_) throws PrivilegeException, InvalidMessageException
messageId_
- The id of the message to be returned.PrivilegeException
- if the current user does not have sufficient
privileges to view this message. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, WRITER, and READER roles in ForumsRoleMap
may view messages.InvalidMessageException
- if the message does not exist or has
been deletedServiceException
- if any system-level error occurs@Deprecated Message[] getMessages(java.lang.Long[] messageIds_) throws PrivilegeException, InvalidMessageException
getMessagesPaging(java.lang.Long[], int, int, java.lang.Integer, java.lang.Integer)
.messageIds_
- The ids of the messages to be returned.java.lang.NullPointerException
- if the passed messageIds
array
contains a null
elementPrivilegeException
- if the current user does not have sufficient
privileges to view any one of the messages. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, WRITER, and READER roles in ForumsRoleMap
may view messages.InvalidMessageException
- if any one of the messages does not exist
or has been deletedServiceException
- if any system-level error occurs@Deprecated Message[] getMessagesForThread(java.lang.Long threadId_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_, int startIndex_, int count_) throws InvalidThreadException
getMessagesForThreadPaging(java.lang.Long, int, int, java.lang.Integer, java.lang.Integer)
.threadId_
- The local id of the thread from which to get the messages.sortProperty_
- The column by which to sort. Use a
SORT_PROPERTY_MESSAGE
constant.sortOrder_
- the order in which to sort the results. This is one of
Constants.SORT_ORDER_ASCENDING
or Constants.SORT_ORDER_DESCENDING
startIndex_
- the index into the collection of total results at which
to start. Negative numbers are treated as zeros.count_
- the number of results to return.
Use Constants.COUNT_ALL
to return the entire collection, but this is STRONGLY discouraged.InvalidThreadException
- of the thread is invalidServiceException
- if any system-level error occursvoid addRating(java.lang.Long messageId_, int rating_) throws InvalidMessageException, PrivilegeException
messageId_
- The id of the message being rated.rating_
- The new individual rating.PrivilegeException
- if the current user does not have
sufficient privileges to add the rating. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, WRITER, and READER roles in ForumsRoleMap
may add ratings to messages.InvalidMessageException
- if the passed message id is invalidServiceException
- if any system-level error occursvoid setRating(java.lang.Long messageId_, double averageRating_, int ratingCount_) throws InvalidMessageException, PrivilegeException
messageId_
- The id of a message.averageRating_
- The new average rating.ratingCount_
- The new number of individual ratings that were used
to determine the passed average rating.PrivilegeException
- if the current user does not have
sufficient privileges to set the rating. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, WRITER, and READER roles in ForumsRoleMap
may set ratings of messages.InvalidMessageException
- if the message is invalidServiceException
- if any system-level error occursaddRating(java.lang.Long, int)
void deleteMessageAndDescendants(java.lang.Long messageId_) throws InvalidMessageException, PrivilegeException
messageId_
- The id of a message.PrivilegeException
- if the current user does not have sufficient
privileges to delete the message. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may delete messages.InvalidMessageException
- if the passed message id is invalidServiceException
- if any system-level error occursvoid deleteMessage(java.lang.Long messageId_) throws InvalidMessageException, PrivilegeException
messageId_
- The id of the message to delete.PrivilegeException
- if the current user does not have
sufficient privileges to delete the message. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may delete messages.InvalidMessageException
- if the passed message id is invalidServiceException
- if any system-level error occursvoid setRoleMapForForum(java.lang.Long forumId_, ForumsRoleMap r_) throws InvalidForumException, PrivilegeException
forumId_
- The id of a forumr_
- The role map to set.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursPrivilegeException
ForumsRoleMap getRoleMapForForum(java.lang.Long forumId_) throws InvalidForumException
forumId_
- The id of a forum.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursForumsRoleMap getRoleMapForThread(java.lang.Long threadId_) throws InvalidThreadException
threadId_
- The id of a thread.InvalidThreadException
- if the passed thread id is invalidServiceException
- if any system-level error occurs@Deprecated boolean[] activateUserSession(java.lang.Long[] memberGroups_, java.lang.Long[] adminGroups_, java.lang.Long userTypeId_) throws InvalidUserException
memberGroups_
- Groups of which the current user is a member.adminGroups_
- Groups of which the current user is an admin.userTypeId_
- this is one of
UserProfile.USER_TYPE_BASIC
or UserProfile.USER_TYPE_SYS_ADMIN
boolean
array of three system permissions.
Element [0] of the returned array indicates whether the current user can
createForum
; element [1] of the array indicates whether the
current user can getAllDeletedMessagesPaging
; and [2] indicates
whether the current user can importMessages
. See the forums
security map description in the overall service description.InvalidUserException
- if the user calling this method is invalidServiceException
- if any system-level error occursjava.lang.String[] getUsersToNotify(java.lang.Long threadId_) throws InvalidThreadException
threadId_
- The id of a thread.InvalidThreadException
- if the passed thread id is invalidServiceException
- if any system-level error occursjava.lang.String[] getUsersToNotifyForForum(java.lang.Long forumId_) throws InvalidForumException
forumId_
- The id of a forum.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursboolean isSubscribedToForum(java.lang.Long forumId_) throws InvalidForumException
forumId_
- The id of a forum.true
if the current user is subscribed to the
forum, and false
otherwiseInvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursvoid subscribeToForum(java.lang.Long forumId_) throws InvalidForumException, PrivilegeException
forumId_
- The id of the forum to subscribe to.InvalidForumException
- if the passed forum id is invalidPrivilegeException
- if the current user does not have
sufficient privileges to subscribe to the forum. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, READER, and WRITER roles in ForumsRoleMap
may subscribe to forums.ServiceException
- if any system-level error occursvoid unsubscribeFromForum(java.lang.Long forumId_) throws InvalidForumException, PrivilegeException
forumId_
- The id of the forum to unsubscribe from.InvalidForumException
- if the passed forum id is invalidPrivilegeException
- if the current user does not have
sufficient privileges to unsubscribe from the forum. Only SYSADMIN,
APPADMIN, OWNER, ADMINISTRATOR, READER, and WRITER roles in
ForumsRoleMap
may unsubscribe from forums.ServiceException
- if any system-level error occursvoid enableForumAnonymousPosting(java.lang.Long forumId_) throws PrivilegeException, InvalidForumException
forumId_
- The id of a forum.PrivilegeException
- if the current user does not have sufficient
privileges to perform this operation. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may enable anonymous posting on forums.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursvoid disableForumAnonymousPosting(java.lang.Long forumId_) throws PrivilegeException, InvalidForumException
forumId_
- The id of a forum.PrivilegeException
- if the current user does not have sufficient
privileges to perform this operation. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may disable anonymous posting on forums.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursvoid setForumPublic(java.lang.Long forumId_) throws PrivilegeException, InvalidForumException
forumId_
- The id of a forum.PrivilegeException
- if the current user does not have sufficient
privileges to set forums as public. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may set forums as public.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursvoid setForumPrivate(java.lang.Long forumId_) throws PrivilegeException, InvalidForumException
forumId_
- The id of a forum.PrivilegeException
- if the current user does not have sufficient
privileges to set forums as private. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may set forums as private.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursResultPage getForumsPaging(java.lang.Long[] forumIds_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws PrivilegeException, InvalidForumException
forumIds_
- The ids (local ids) of the forums to retrieve.startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in Forum
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
Forum
objects.PrivilegeException
- if the current user does not have sufficient
privileges to view any of the forums.
Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, WRITER, and READER roles in ForumsRoleMap
may view forums.InvalidForumException
- if any one of the passed forum ids is
invalidServiceException
- if any system-level error occursResultPage findForumsPaging(java.lang.String nameSearchString_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_)
nameSearchString_
- The query string to use to search for forums
by name. The query string is interpreted as a regular expression but
ignoring case. null
is a wildcard, meaning any value of
the name field.startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in Forum
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
Forum
objects.ServiceException
- if any system-level error occursResultPage getAllForumsPaging(int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_)
startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in Forum
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
Forum
objects.ServiceException
- if any system-level error occursResultPage getAllForumSummariesPaging(int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_)
startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in ForumSummary
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
ForumSummary
objects.ServiceException
- if any system-level error occursResultPage getThreadsPaging(java.lang.Long[] threadIds_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws PrivilegeException, InvalidThreadException
threadIds_
- The ids of the threads to retrieve.startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in DiscussionThread
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
DiscussionThread
objects.PrivilegeException
- if the current user does not have sufficient
privileges to view any of the threads. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, WRITER, and READER roles in ForumsRoleMap
may view threads.InvalidThreadException
- if any one of the passed thread ids is
invalidServiceException
- if any system-level error occursResultPage getMessagesPaging(java.lang.Long[] messageIds_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws PrivilegeException, InvalidMessageException
messageIds_
- The ids of the messages to retrieve.startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in Message
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
Message
objects.PrivilegeException
- if the current user does not have sufficient
privileges to view any of the messages. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, WRITER, and READER roles in ForumsRoleMap
may view messages.InvalidMessageException
- if any one of the passed message ids is
invalidServiceException
- if any system-level error occursResultPage getForumIdsByRelatedPaging(LocalObject related_, int startIndex_, int batchSize_, java.lang.Integer sortOrder_)
ObjectTypeMapping
).related_
- The identifier specifiying the object for which related
forums are to be returned (the type
, and either
id
or stringId
fileds of the passed object must
be set).startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
Long
objects.ServiceException
- if any system-level error occursResultPage getMessagesForThreadPaging(java.lang.Long threadId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidThreadException
threadId_
- The thread IDstartIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in Message
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
Message
objects.InvalidThreadException
- if the passed thread id is invalidServiceException
- if any system-level error occursResultPage getForumSummariesPaging(java.lang.Long[] forumIds_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws PrivilegeException, InvalidForumException
forumIds_
- The ids of the forums to retrieve.startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in ForumSummary
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
ForumSummary
objects.PrivilegeException
- if the current user does not have sufficient
privileges to view any of the forums. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, WRITER, and READER roles in ForumsRoleMap
may view forums.InvalidForumException
- if any one of the passed forum ids is
invalidServiceException
- if any system-level error occursResultPage getValidForumSummariesPaging(java.lang.Long[] forumIds_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_)
forumIds_
- The ids of the forums to retrieve.startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in ForumSummary
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
ForumSummary
objects.ResultPage getThreadSummariesPaging(java.lang.Long[] threadIds_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws PrivilegeException, InvalidThreadException
threadIds_
- The ids of the threads to retrieve.startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in ThreadSummary
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
ThreadSummary
objects.PrivilegeException
- if the current user does not have sufficient
privileges to perform this operation. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, WRITER, and READER roles in ForumsRoleMap
may get thread summaries.InvalidThreadException
- if any one of the passed thread ids is
invalidServiceException
- if any system-level error occursResultPage getSponsoredThreadSummariesPaging(java.lang.Long forumId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws PrivilegeException, InvalidForumException
forumId_
- The id of a forum.startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in ThreadSummary
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
ThreadSummary
objects.PrivilegeException
- if the current user does not have sufficient
privileges to sponsor threads. Only SYSADMIN, APPADMIN,
OWNER, and ADMINISTRATOR roles in ForumsRoleMap
may sponsor threads.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursResultPage getSponsoredThreadSummariesPaging(java.lang.Long[] forumIds_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws PrivilegeException, InvalidForumException
forumIds_
- The ids of the forums.startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in ThreadSummary
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
ThreadSummary
objects.PrivilegeException
- if the current user does not have sufficient
privileges to sponsor threads in any of the forums.
Only SYSADMIN, APPADMIN, OWNER, and ADMINISTRATOR roles in
ForumsRoleMap
may sponsor threads.InvalidForumException
- if any one of the passed forum ids is
invalidServiceException
- if any system-level error occursResultPage getThreadedMessagesPaging(java.lang.Long forumId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidForumException
ThreadedMessage
objects.forumId_
- The id of a forum.startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in ThreadedMessage
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
ThreadedMessage
objects.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursResultPage getThreadSummariesForForumPaging(java.lang.Long forumId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws PrivilegeException, InvalidForumException
forumId_
- The id of a forum.startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in ThreadSummary
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
ThreadSummary
objects.PrivilegeException
- if the current user does not have sufficient
privileges to view any of the threads. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, WRITER, and READER roles in ForumsRoleMap
may view threads.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursvoid addActorsToRolesInForums(java.lang.Long forumId_, java.lang.String[] usernames_, java.lang.Long[] groupIds_, java.lang.String role_) throws InvalidForumException
forumId_
- The id of a forum.usernames_
- The users to add to the role.groupIds_
- The groups to add to the role.role_
- The role, which should be one of the ROLE_XXX
constants defined in ForumsRoleMap
.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursboolean allowedAnonymousPosting(java.lang.Long forumId_) throws InvalidForumException
forumId_
- The id of a forum.true
if anonymous posting is allowed in the forum,
and false
otherwiseInvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursResultPage getAllDeletedMessagesPaging(int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws PrivilegeException
startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in Message
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
Message
objects.PrivilegeException
- if the current user does not have sufficient
privileges to view deleted messages. Only SYSADMIN and APPADMIN
roles in ForumsRoleMap
may view deleted messages.ServiceException
- if any system-level error occursint[] getPermissionsForMessageIdsForSessionUser(java.lang.Long[] messageIds_)
messageIds_
- The ids of messages.int
s, each of which represents the
current user's permission level for the corresponding message. This
is one of the MESSAGE_PERMISSION_XXX
constants defined by
this class.ServiceException
- if any system-level error occursint[] getPermissionsForMessageIdsForUser(java.lang.Long[] messageIds_, java.lang.String username_)
messageIds_
- The ids of messages.username_
- The username (ie login) of a user. If the username
is invalid, the method will execute as if for an anonymous user.int
s, each of which represents the
passed user's permission level for the corresponding message. This
is one of the MESSAGE_PERMISSION_XXX
constants defined by
this class.ServiceException
- if any system-level error occursjava.lang.String[] getSubscribersForForum(java.lang.Long forumId_) throws InvalidForumException
forumId_
- The id of the forum whose subscribers should be retrieved.InvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occursboolean isForumPublic(java.lang.Long forumId_) throws InvalidForumException
forumId_
- The id of a forum.true
if the given forum is public, and
false
otherwiseInvalidForumException
- if the passed forum id is invalidServiceException
- if any system-level error occurs@Deprecated void notifyUserCreation(java.lang.String username_)
activateUserSession
has not been called) and the
administrator wants to add the user to a rolemap, etc. In that case, the
Forums server will not know the user exists unless this call is made
first.username_
- The username (ie login) of the new user.ServiceException
- if any system-level error occursvoid notifyUsersCreation(java.lang.String[] usernames_)
notifyUserCreation(java.lang.String)
).usernames_
- The usernames (ie logins) of the new users.ServiceException
- if any system-level error occursResultPage getSubscribedThreadsPaging(int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_)
startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in DiscussionThread
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
DiscussionThread
objects.ServiceException
- if any system-level error occursResultPage getSubscribedForumsPaging(int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_)
startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in Forum
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
Forum
objects.ServiceException
- if any system-level error occursResultPage getChildrenForMessagePaging(java.lang.Long messageId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidMessageException, PrivilegeException
messageId_
- The id of a message.startIndex_
- The index into the collection of total results
at which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Use
Constants.COUNT_ALL
to return
all results from startIndex_
to the end, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in Message
.sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Resultpage
containing an array of
Message
objects.InvalidMessageException
- if the passed message id is invalidPrivilegeException
- if the current user does not have sufficient
permissios to view messages. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, WRITER, and READER roles in ForumsRoleMap
may view messages.ServiceException
- if any system-level error occursjava.lang.String getApplicationName()
ServiceException
- if any system-level error occursboolean[] getApplicationPermissions()
boolean
array of three system permissions.
Element [0] of the returned array indicates whether the current user can
createForum
; element [1] of the array indicates whether the
current user can getAllDeletedMessagesPaging
; and [2] indicates
whether the current user can importMessages
. See the forums
security map description in the overall service description.java.lang.String[] getWorkspace()
ServiceException
- if any system-level error occursMessage[] createMessages(java.lang.Long[] forumIds_, Message[] msgs_) throws InvalidForumException, InvalidMessageException, java.lang.IllegalArgumentException, PrivilegeException
DiscussionBodyService.createMessages(com.appiancorp.suiteapi.forums.Message[])
, using the
filename
s returned by this method.forumIds_
- The ids of the forums in which to create the new
messages.msgs_
- The Message
objects from which to create the
messages. The minimum required fields that must be set in each object are:
threadId
, parentId
, subject
, and
anonymousAuthor
. When creating a new thread, the
threadId
and parentId
fields should be set to
0
. The id
, remoteId
, and
filename
fields will be assigned by the server.id
, remoteId
,
and filename
fields properly populated.InvalidForumException
- if any one of the passed forum ids is
invalidInvalidMessageException
- if the parentId
of any one
of the passed messages does not existjava.lang.IllegalArgumentException
- if the forumIds_
array is
not the same length as the msgs_
arrayPrivilegeException
- if the current user does not have sufficient
privileges to create messages. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, and WRITER roles in ForumsRoleMap
may create messages.ServiceException
- if any system-level error occursjava.lang.NullPointerException
- if the msgs_
array or one or more
elements in the the array is null.java.lang.Long[] createForums(Forum[] forums_) throws PrivilegeException, DuplicateUuidException
forums_
- The forums to be created. The following fields of the passed
objects must be set: name
, creator
and
dateCreated
. The value of the id
field is
ignored (can be null
), since it will be assigned by the
server.PrivilegeException
- if the current user does not have sufficient
privileges to perform this operation. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, WRITER, READER, and USER roles in
ForumsRoleMap
may create forums.DuplicateUuidException
- if the UUID of any of the forums already
exists or if the same UUID is passed in for several forumsServiceException
- if any system-level error occursMessage[] importMessages(java.lang.Long[] forumIds_, Message[] msgs_) throws InvalidForumException, InvalidMessageException, java.lang.IllegalArgumentException, PrivilegeException
datePosted
and author
values specified in the
passed Message
objects instead of assigning them on the server.
NOTE: To physically store the messages to disk, this call must be followed
by a call to DiscussionBodyService.createMessages(com.appiancorp.suiteapi.forums.Message[])
, using the
filename
s returned by this method.forumIds_
- The ids of the forums in which to create the messages.msgs_
- The Message
objects from which to create the
messages. The minimum required fields that must be set in each object are:
threadId
, parentId
, subject
,
anonymousAuthor
, datePosted
, and
author
. When creating a new thread, the threadId
and parentId
fields should be set to 0
. The
id
, remoteId
, and filename
fields
will be assigned by the server.id
,
remoteId
, and filename
fields properly
populated.InvalidForumException
- if any one of the passed forum ids is
invalidInvalidMessageException
- if the parentId
of any one
of the passed messages is invalidjava.lang.IllegalArgumentException
- if the forumIds_
array is
not the same length as the msgs_
arrayPrivilegeException
- if the current user does not have sufficient
privileges to create messages. Only SYSADMIN, APPADMIN,
OWNER, ADMINISTRATOR, and WRITER roles in ForumsRoleMap
may create messages.ServiceException
- if any system-level error occursResultList getThreadsList(java.lang.Long[] threadIds_)
threadIds_
- The ids of the threads to retrieve.ResultList
containing threads and result codes.
the Result.getResults()
method
should be used to get all the threads that were successfully retrieved.
In addition
ResultList.getResultCodes()
can be
used to get the list of result codes corresponding to each of the
passed thread ids. Each code represents the successful retrieval of a
thread, or, if the thread could not be retrieved, the reason for the
failure. Possible result codes:
ResultList.CODE_INVALID
= the thread specified does not exist,
ResultList.CODE_NO_PERMISSION
= the user can't see the thread,
and
ResultList.CODE_VALID
= the user can see the threadServiceException
- if any system-level error occursResultList getForumsList(java.lang.Long[] forumIds_) throws InvalidUserException
forumIds_
- The ids of the threads to retrieve.ResultList
containing forums and result codes.
the Result.getResults()
method
should be used to get all the forums that were successfully retrieved.
In addition
ResultList.getResultCodes()
can be
used to get the list of result codes corresponding to each of the
passed forum ids. Each code represents the successful retrieval of a
forum, or, if the forum could not be retrieved, the reason for the
failure. See the CODE_XXX
constants in ResultList
for details.ServiceException
- if any system-level error occursInvalidUserException
ResultList getMessagesList(java.lang.Long[] messageIds_)
messageIds_
- The ids of the messages to retrieve.ResultList
containing messages and result codes.
the Result.getResults()
method
should be used to get all the messages that were successfully retrieved.
In addition
ResultList.getResultCodes()
can be
used to get the list of result codes corresponding to each of the
passed message ids. Each code represents the successful retrieval of a
message, or, if the message could not be retrieved, the reason for the
failure. See the CODE_XXX
constants in ResultList
for details.ServiceException
- if any system-level error occurs@Deprecated boolean validateGroupMembership(java.lang.Long[] memGroupIds_, java.lang.Long[] admGroupIds_) throws InvalidUserException
memGroupIds_
- Groups for which the User is a memberadmGroupIds_
- Groups for which the User is an administratorInvalidUserException
- if the user calling this method does not existServiceException
- if any system-level error occurs@Deprecated void updateUsernames(java.lang.String[] oldUsernames_, java.lang.String[] newUsernames_, long maxExpirationTimeInSeconds_) throws java.lang.IllegalArgumentException, PrivilegeException, DuplicateNameException
UserService.renameUsersByUuid(java.lang.String[], java.lang.String[])
UserService.renameUsersByUuid(java.lang.String[], java.lang.String[])
Updates a list of old usernames to new usernames.
If successful, this method must be followed by
commitUpdateUsernames()
. After commitUpdateUsernames
has been called, the old usernames will still be active, but will
expire after the interval specified by
maxExpirationTimeInSeconds_
; if updateUsernames
is successful but commitUpdateUsernames
is not called, the
new usernames will not become active.
If unsuccessful, this method should be followed by
rollbackUpdateUsernames()
. This will simply free memory dedicated
to mapping old usernames to new usernames.
oldUsernames_
- the usernames to be updatednewUsernames_
- the usernames to which the old usernames will be
updatedmaxExpirationTimeInSeconds_
- the interval, in seconds, after
commitUpdateUsernames
has been called, after which
the old usernames will expire. If this parameter is zero or a
negative value the old usernames will expire instantly.
After expiration, the old usernames will no longer be valid.java.lang.IllegalArgumentException
- if the length of
oldUsernames_
is not the same as the length of
newUsernames_
.PrivilegeException
- if the current user is not a system
administratorDuplicateNameException
- if any oldUsernames_
or
newUsernames_
contain any duplicates, or if an old
username is being updated to a username that already existsServiceException
- if any system-level error occurs@Deprecated void commitUpdateUsernames()
UserService.renameUsersByUuid(java.lang.String[], java.lang.String[])
UserService.renameUsersByUuid(java.lang.String[], java.lang.String[])
Commits an update of usernames.
This method should be preceded by a call to
updateUsernames(String[], String[], long)
. After the commit, the
old usernames will be temporarily active, and will expire after the
interval specified by maxExpirationTimeInSeconds_
; if
commitUpdateUsernames
is not called, the
new usernames will not become active.
ServiceException
- if any system-level error occurs@Deprecated void rollbackUpdateUsernames()
UserService.renameUsersByUuid(java.lang.String[], java.lang.String[])
UserService.renameUsersByUuid(java.lang.String[], java.lang.String[])
Rolls back an update of usernames.
This method should be called if
updateUsernames(String[], String[], long)
is unsuccessful. The
rollback will simply free memory dedicated to mapping old usernames to
new usernames.
ServiceException
- if any system-level error occursvoid inviteUsersToThread(java.lang.String[] usernames_, java.lang.Long threadId_) throws InvalidThreadException, PrivilegeException
thread
.
Later, the invitee can accept the invitation by
acceptThreadInvitation
or deny the invitation by
denyThreadInvitation
, after which the invitation
becomes void.usernames_
- the users to invitethreadId_
- the thread to which they are invitesInvalidThreadException
- if the thread does not existPrivilegeException
- if the requesting user cannot subscribe other
users to thread. Only SYSADMIN, APPADMIN, ADMINISTRATOR, and OWNER
can subscribe other users.void acceptThreadInvitation(java.lang.Long threadId_) throws InvalidThreadException, PrivilegeException
threadId_
- the thread to which the user wants to subscribeInvalidThreadException
- if the thread does not existPrivilegeException
- if the user wasn't invitedvoid denyThreadInvitation(java.lang.Long threadId_) throws InvalidThreadException
threadId_
- the thread to which the user does not want to subscribeInvalidThreadException
- if the thread does not existboolean[] isInvitedToThreads(java.lang.Long[] threadIds_) throws InvalidThreadException
threadIds_
- the threads for which to check the user's invitation.InvalidThreadException
- if any of the threads does not existvoid changePartitionPaths(java.lang.String originalPath, java.lang.String newPath)
originalPath
- The path where forum texts were previously stored.newPath
- The path where forum texts will now be stored.ServiceException
- if any system-level error occurs@Deprecated void reloadProperties()
ServiceException
- if any system-level error occursjava.lang.String validate()
ServiceException
- if any system-level error occursboolean validateTypedValues(TypedValue[] typedValues)
typedValues
- void setTimeZone(BackendTimeZoneSimple tz)
tz
- @Deprecated void setTimeZoneSameAs(BackendTimeZoneSimple tz, java.lang.String sameAsId)
GlobalizationService.setTimeZone(com.appiancorp.suiteapi.portal.BackendTimeZoneSimple)
to set the time zone across all engines (rarely
required).tz
- The specially formatted time zone object used by the enginesUserMessageCount[] getMessageCountByUsers(java.lang.String[] usernameList) throws PrivilegeException
usernameList
- The list of usernames that the service is going to search forPrivilegeException
- thrown if user does not have admin privilegesUserMessageCount[] getMessageCountByUsers(java.lang.String[] usernameList, java.sql.Date fromDate, java.sql.Date toDate) throws PrivilegeException
usernameList
- The list of usernames that the service is going to search forfromDate
- The initial date for the querytoDate
- The end date for the queryPrivilegeException
- thrown if user does not have admin privilegesUserMessageCount[] getMessageCountByUsersForForum(java.lang.String[] usernameList, java.sql.Date fromDate, java.sql.Date toDate, java.lang.Long forumId) throws InvalidForumException, PrivilegeException
usernameList
- The list of usernames that the service is going to search forfromDate
- The initial date for the querytoDate
- The end date for the queryforumId
- Identifier of the forum to get statistics fromPrivilegeException
- thrown if user does not have admin privilegesInvalidForumException
UserMessageCount[] getTopUsersForForum(java.sql.Date fromDate, java.sql.Date toDate, java.lang.Long forumId, int topNUsers) throws InvalidForumException, PrivilegeException
fromDate
- The initial date for the querytoDate
- The end date for the queryforumId
- Identifier of the forum to get statistics fromtopNUsers
- The number of users you expect as an output of the functionInvalidForumException
- thrown if Forum Id is invalidPrivilegeException
- thrown if user does not have admin privilegesUserMessageCount[] getTopUsersForSite(java.sql.Date fromDate, java.sql.Date toDate, int topNUsers) throws PrivilegeException
fromDate
- The initial date for the querytoDate
- The end date for the querytopNUsers
- The number of users you expect as an output of the functionPrivilegeException
- thrown if user does not have admin privilegesResultPage getMessagesByUserPaging(java.lang.String username, int startIndex, int batchSize, int sortProperty, int sortOrder) throws PrivilegeException
username
- User whose messages are going to be retreivedstartIndex
- The index into the collection of total results at which to startbatchSize
- The number of results to returnsortProperty
- The property by which the results should be sorted
This should be one of the SORT_BY_XXX constants defined
in {com.appiancorp.suiteapi.forums.DiscussionThread}sortOrder
- The order in which results are going to be sorted
{com.appiancorp.suiteapi.common.Constants#SORT_ORDER_ASCENDING} or
{com.appiancorp.suiteapi.common.Constants#SORT_ORDER_DESCENDING}PrivilegeException
- thrown if user does not have admin privilegesCopyright © 2003-2024 Appian Corporation. All Rights Reserved.