Package com.appiancorp.suiteapi.collaboration

Interface ReportingService

All Superinterfaces:
com.appiancorp.services.ContextSensitiveService, Service
public interface ReportingService extends com.appiancorp.services.ContextSensitiveService

Defines related methods for usage reporting within collaboration.

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.

See Also:

  • Field Details

    • getTotalUploads$UPDATES

      @Deprecated(forRemoval=true) static final boolean getTotalUploads$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getNumberUploads$UPDATES

      @Deprecated(forRemoval=true) static final boolean getNumberUploads$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getNumberUploadsPaging$UPDATES

      @Deprecated(forRemoval=true) static final boolean getNumberUploadsPaging$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getGeneralStatistics$UPDATES

      @Deprecated(forRemoval=true) static final boolean getGeneralStatistics$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getGeneralUserStatistics$UPDATES

      @Deprecated(forRemoval=true) static final boolean getGeneralUserStatistics$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getCommunitiesWithMostUploads$UPDATES

      @Deprecated(forRemoval=true) static final boolean getCommunitiesWithMostUploads$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getCommunitiesWithMostUploadsPaging$UPDATES

      @Deprecated(forRemoval=true) static final boolean getCommunitiesWithMostUploadsPaging$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getKnowledgeCentersWithMostUploads$UPDATES

      @Deprecated(forRemoval=true) static final boolean getKnowledgeCentersWithMostUploads$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getKnowledgeCentersWithMostUploadsPaging$UPDATES

      @Deprecated(forRemoval=true) static final boolean getKnowledgeCentersWithMostUploadsPaging$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getUploadsByHour$UPDATES

      @Deprecated(forRemoval=true) static final boolean getUploadsByHour$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getUploadsByHourPaging$UPDATES

      @Deprecated(forRemoval=true) static final boolean getUploadsByHourPaging$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getUploadsByType$UPDATES

      @Deprecated(forRemoval=true) static final boolean getUploadsByType$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getUploadsByTypePaging$UPDATES

      @Deprecated(forRemoval=true) static final boolean getUploadsByTypePaging$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getUploadsByWeekDays$UPDATES

      @Deprecated(forRemoval=true) static final boolean getUploadsByWeekDays$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getUploadsByWeekDaysPaging$UPDATES

      @Deprecated(forRemoval=true) static final boolean getUploadsByWeekDaysPaging$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getCommunityAdminReport$UPDATES

      @Deprecated(forRemoval=true) static final boolean getCommunityAdminReport$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getCommunityAdminReportPaging$UPDATES

      @Deprecated(forRemoval=true) static final boolean getCommunityAdminReportPaging$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getWhatsNewSubscriptions$UPDATES

      @Deprecated(forRemoval=true) static final boolean getWhatsNewSubscriptions$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getWhatsNewSubscriptionsPaging$UPDATES

      @Deprecated(forRemoval=true) static final boolean getWhatsNewSubscriptionsPaging$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getMoreWhatsNewSubscriptions$UPDATES

      @Deprecated(forRemoval=true) static final boolean getMoreWhatsNewSubscriptions$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getMoreWhatsNewSubscriptionsPaging$UPDATES

      @Deprecated(forRemoval=true) static final boolean getMoreWhatsNewSubscriptionsPaging$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getWhatsNewCommunityForUser$UPDATES

      @Deprecated(forRemoval=true) static final boolean getWhatsNewCommunityForUser$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getWhatsNewCommunityForUserPaging$UPDATES

      @Deprecated(forRemoval=true) static final boolean getWhatsNewCommunityForUserPaging$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getWhatsNewTopLevelCommunityForUser$UPDATES

      @Deprecated(forRemoval=true) static final boolean getWhatsNewTopLevelCommunityForUser$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getWhatsNewTopLevelCommunityForUserPaging$UPDATES

      @Deprecated(forRemoval=true) static final boolean getWhatsNewTopLevelCommunityForUserPaging$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getWhatsNewCommunityPaging$UPDATES

      @Deprecated(forRemoval=true) static final boolean getWhatsNewCommunityPaging$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getWhatsNewCommunity$UPDATES

      @Deprecated(forRemoval=true) static final boolean getWhatsNewCommunity$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getWhatsNewTopLevelCommunity$UPDATES

      @Deprecated(forRemoval=true) static final boolean getWhatsNewTopLevelCommunity$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getWhatsNewTopLevelCommunityPaging$UPDATES

      @Deprecated(forRemoval=true) static final boolean getWhatsNewTopLevelCommunityPaging$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getWhatsNewKnowledgeCenter$UPDATES

      @Deprecated(forRemoval=true) static final boolean getWhatsNewKnowledgeCenter$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

    • getWhatsNewKnowledgeCenterPaging$UPDATES

      @Deprecated(forRemoval=true) static final boolean getWhatsNewKnowledgeCenterPaging$UPDATES
      Deprecated, for removal: This API element is subject to removal in a future version.
      See Also:

  • Method Details

    • getTotalUploads

      @Deprecated @Read(K_COLLAB) Long getTotalUploads()
      Deprecated.
      Gets the total number of uploads to the collaboration application
      Returns:
      the total number of uploads
      Throws:
      ServiceException - if any system-level error occurs

    • getNumberUploads

      @Deprecated @Read(K_COLLAB) UploadStatistics[] getNumberUploads(Long days_)
      Deprecated.
      user getNumberUploadsPaging
      Gets the number of uploads in the last N days
      Parameters:
      days_ - the number of days in the query
      Returns:
      a list of UploadStatistics objects. Each UploadStatistics object represents one day of upload information. The fields uploadDate and numberOfUploads are the only fields populated.
      Throws:
      ServiceException - if any system-level error occurs

    • getNumberUploadsPaging

      @Read(K_COLLAB) ResultPage getNumberUploadsPaging(Long days_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidDataFormatException
      Gets the number of uploads in the last N days
      Parameters:
      days_ - the number of days in the query
      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 of Constants.COUNT_ALL will result in the entire collection being returned, but this is STRONGLY discouraged.
      sortProperty_ - the property by which the results will be sorted:
      • 0 - uploadDate
      • 1 - numberOfUploads
      sortOrder_ - Constants.SORT_ORDER_ASCENDING for sorting results in ascending order, Constants.SORT_ORDER_DESCENDING for sorting results in descending order
      Returns:
      a ResultPage containing a list of UploadStatistics objects. Each UploadStatistics object represents one day of upload information. The fields uploadDate and numberOfUploads are the only fields populated.
      Throws:
      ServiceException - if any system-level error occurs
      InvalidDataFormatException - if days_ is null

    • getGeneralStatistics

      @Deprecated @Read(K_COLLAB) Statistics getGeneralStatistics()
      Deprecated.
      Gets the general usage statistics and patterns of the collaboration application (eg the number of folders created).
      Returns:
      a Statistics object encapsulating the general usage statistics
      Throws:
      ServiceException - if any system-level error occurs

    • getGeneralUserStatistics

      @Deprecated @Read(K_COLLAB) UserStatistics getGeneralUserStatistics()
      Deprecated.
      Gets user statistics in the collaboration application (eg the number of users who have uploaded documents).
      Returns:
      a UserStatistics object encapsulating the usage statistics
      Throws:
      ServiceException - if any system-level error occurs

    • getCommunitiesWithMostUploads

      @Deprecated @Read(K_COLLAB) UploadStatistics[] getCommunitiesWithMostUploads(Long num_)
      Deprecated.
      use getCommunitiesWithMostUploadsPaging
      Gets the top num_ communities with the most uploads
      Parameters:
      num_ - the top number of communities to return
      Returns:
      a list of UploadStatistics objects. Each UploadStatistics object represents a community's upload information. The fields communityName and numberOfDocumensUploaded are the only fields populated.
      Throws:
      ServiceException - if any system-level error occurs

    • getCommunitiesWithMostUploadsPaging

      @Deprecated @Read(K_COLLAB) ResultPage getCommunitiesWithMostUploadsPaging(int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_)
      Deprecated.
      Gets the communities with the most uploads
      Parameters:
      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 of Constants.COUNT_ALL will result in the entire collection being returned, but this is STRONGLY discouraged.
      sortProperty_ - the property by which the results will be sorted:
      • 0 - communityName
      • 1 - numberOfDocumentsUploaded
      sortOrder_ - Constants.SORT_ORDER_ASCENDING for sorting results in ascending order, Constants.SORT_ORDER_DESCENDING for sorting results in descending order
      Returns:
      a ResultPage containing a list of UploadStatistics objects. Each UploadStatistics object represents a community's upload information. The fields communityName and numberOfDocumensUploaded are the only fields populated.
      Throws:
      ServiceException - if any system-level error occurs

    • getKnowledgeCentersWithMostUploads

      @Deprecated @Read(K_COLLAB) UploadStatistics[] getKnowledgeCentersWithMostUploads(Long num_)
      Deprecated.
      use getKnowledgeCentersWithMostUploadsPaging
      Gets the top num_ knowledge centers with the most uploads
      Parameters:
      num_ - the top number of knowledge centers to return
      Returns:
      a list of UploadStatistics objects. Each UploadStatistics object represents a knowledge center's upload information. The fields knowledgeCenterName and numberOfDocumensUploaded are the only fields populated.
      Throws:
      ServiceException - if any system-level error occurs

    • getKnowledgeCentersWithMostUploadsPaging

      @Deprecated @Read(K_COLLAB) ResultPage getKnowledgeCentersWithMostUploadsPaging(int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_)
      Deprecated.
      Gets the knowledge centers with the most uploads
      Parameters:
      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 of Constants.COUNT_ALL will result in the entire collection being returned, but this is STRONGLY discouraged.
      sortProperty_ - the property by which the results will be sorted:
      • 0 - knowledgeCenterName
      • 1 - numberOfDocumentsUploaded
      sortOrder_ - Constants.SORT_ORDER_ASCENDING for sorting results in ascending order, Constants.SORT_ORDER_DESCENDING for sorting results in descending order
      Returns:
      a ResultPage containing a list of UploadStatistics objects. Each UploadStatistics object represents a knowledge center's upload information. The fields knowledgeCenterName and numberOfDocumensUploaded are the only fields populated.
      Throws:
      ServiceException - if any system-level error occurs

    • getUploadsByHour

      @Deprecated @Read(K_COLLAB) UploadStatistics[] getUploadsByHour()
      Deprecated.
      use getUploadsByHourPaging
      Gets the number of uploads for each hour
      Returns:
      a list of UploadStatistics objects. Each UploadStatistics object represents upload information for an hour. The fields uploadHourOfDay and numberOfDocumensUploaded are the only fields populated.
      Throws:
      ServiceException - if any system-level error occurs

    • getUploadsByHourPaging

      @Deprecated @Read(K_COLLAB) ResultPage getUploadsByHourPaging(int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_)
      Deprecated.
      Gets the number of uploads for each hour
      Parameters:
      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 of Constants.COUNT_ALL will result in the entire collection being returned, but this is STRONGLY discouraged.
      sortProperty_ - the property by which the results will be sorted:
      • 0 - uploadHourOfDay
      • 1 - numberOfDocumentsUploaded
      sortOrder_ - Constants.SORT_ORDER_ASCENDING for sorting results in ascending order, Constants.SORT_ORDER_DESCENDING for sorting results in descending order
      Returns:
      a ResultPage containing a list of UploadStatistics objects. Each UploadStatistics object represents upload information for an hour. The fields uploadHourOfDay and numberOfDocumensUploaded are the only fields populated.
      Throws:
      ServiceException - if any system-level error occurs

    • getUploadsByType

      @Deprecated @Read(K_COLLAB) UploadStatistics[] getUploadsByType()
      Deprecated.
      use getUploadsByTypePaging
      Gets the number of uploads by document extension
      Returns:
      a list of UploadStatistics objects. Each UploadStatistics object represents upload information for a document extension. The fields documentExtension and numberOfDocumensUploaded are the only fields populated.
      Throws:
      ServiceException - if any system-level error occurs

    • getUploadsByTypePaging

      @Deprecated @Read(K_COLLAB) ResultPage getUploadsByTypePaging(int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_)
      Deprecated.
      Gets the number of uploads by document extension
      Parameters:
      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 of Constants.COUNT_ALL will result in the entire collection being returned, but this is STRONGLY discouraged.
      sortProperty_ - the property by which the results will be sorted:
      • 0 - documentExtension
      • 1 - numberOfDocumentsUploaded
      sortOrder_ - Constants.SORT_ORDER_ASCENDING for sorting results in ascending order, Constants.SORT_ORDER_DESCENDING for sorting results in descending order
      Returns:
      a ResultPage containing a list of UploadStatistics objects. Each UploadStatistics object represents upload information for a document extension. The fields documentExtension and numberOfDocumensUploaded are the only fields populated.
      Throws:
      ServiceException - if any system-level error occurs

    • getUploadsByWeekDays

      @Deprecated @Read(K_COLLAB) UploadStatistics[] getUploadsByWeekDays()
      Deprecated.
      use getUploadsByWeekDaysPaging
      Gets the number of uploads by weekdays
      Returns:
      a list of UploadStatistics objects. Each UploadStatistics object represents upload information for a weekday. The fields uploadDayOfWeek and numberOfDocumentsUploaded are the only fields populated.
      Throws:
      ServiceException - if any system-level error occurs

    • getUploadsByWeekDaysPaging

      @Deprecated @Read(K_COLLAB) ResultPage getUploadsByWeekDaysPaging(int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_)
      Deprecated.
      Gets the number of uploads by weekdays
      Parameters:
      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 of Constants.COUNT_ALL will result in the entire collection being returned, but this is STRONGLY discouraged.
      sortProperty_ - the property by which the results will be sorted:
      • 0 - uploadDayOfWeek
      • 1 - numberOfDocumentsUploaded
      sortOrder_ - Constants.SORT_ORDER_ASCENDING for sorting results in ascending order, Constants.SORT_ORDER_DESCENDING for sorting results in descending order
      Returns:
      a ResultPage containing a list of UploadStatistics objects. Each UploadStatistics object represents upload information for a weekday. The fields uploadDayOfWeek and numberOfDocumentsUploaded are the only fields populated.
      Throws:
      ServiceException - if any system-level error occurs

    • getCommunityAdminReport

      @Deprecated @Read(K_COLLAB) Community[] getCommunityAdminReport(Long commid_) throws InvalidUserException, InvalidCommunityException
      Deprecated.
      use getCommunityAdminReportPaging
      Gets information about a specified community and all its sub communities
      Parameters:
      commid_ - the unique ID of the community
      Returns:
      a list of Community objects which represent the community and sub-communities
      Throws:
      ServiceException - if any system-level error occurs
      InvalidUserException - if the current user service context is invalid.
      InvalidCommunityException - if the given community does not exist

    • getCommunityAdminReportPaging

      @Deprecated @Read(K_COLLAB) ResultPage getCommunityAdminReportPaging(Long commid_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidUserException, InvalidCommunityException
      Deprecated.
      Gets information about a specified community and all its sub communities
      Parameters:
      commid_ - the unique ID of the community
      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 of Constants.COUNT_ALL will result in the entire collection being returned, but this is STRONGLY discouraged.
      sortProperty_ - the property by which the results will be sorted This is one of the SORT_BY_XXX constants in Community.
      sortOrder_ - Constants.SORT_ORDER_ASCENDING for sorting results in ascending order, Constants.SORT_ORDER_DESCENDING for sorting results in descending order
      Returns:
      a ResultPage containing a list of Community objects which represent the community and sub-communities
      Throws:
      ServiceException - if any system-level error occurs
      InvalidUserException - if the current user service context is invalid.
      InvalidCommunityException - if the community does not exist

    • getWhatsNewSubscriptions

      @Deprecated @Read(K_COLLAB) Document[] getWhatsNewSubscriptions() throws InvalidUserException
      Deprecated.
      use getWhatsNewSubscriptionsPaging
      Gets the latest documents 10 documents added/updated in the application in knowledge centers to which the user is subscribed
      Returns:
      a list of Document objects that represent the top 10 latest documents
      Throws:
      ServiceException - if any system-level error occurs
      InvalidUserException - if the current user service context is invalid.

    • getWhatsNewSubscriptionsPaging

      @Deprecated @Read(K_COLLAB) ResultPage getWhatsNewSubscriptionsPaging(int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidUserException
      Deprecated.
      Gets the latest documents added/updated in the application in knowledge centers to which the user is subscribed
      Parameters:
      startIndex_ - the index into the collection of total results at which to start. Negative numbers are treated as zeros.
      batchSize_ - the number of results. Use of Constants.COUNT_ALL will result in the entire collection up to the minimum of config property WHATS_NEW_LIMIT (if set, default 500 in collaboration.properties, Integer.MAX_VALUE if not set) and WHATS_NEW_SECURITY_LIMIT (if set, default 1000 in collaboration.properties) from collaboration.properties being returned.
      sortProperty_ - the property by which the results will be sorted This is one of the SORT_BY_XXX constants in Document.
      sortOrder_ - Constants.SORT_ORDER_ASCENDING for sorting results in ascending order, Constants.SORT_ORDER_DESCENDING for sorting results in descending order
      Returns:
      a ResultPage containing a list of Document objects which represent the latest documents
      Throws:
      ServiceException - if any system-level error occurs
      InvalidUserException - if the current user service context is invalid.

    • getMoreWhatsNewSubscriptions

      @Deprecated @Read(K_COLLAB) Document[] getMoreWhatsNewSubscriptions(String sortColumn_, Integer sortOrder_, Integer sortLength_) throws InvalidUserException
      Deprecated.
      use getMoreWhatsNewSubscriptionsPaging
      Gets the latest documents added/updated in the application in knowledge centers to which the user is subscribed
      Parameters:
      sortColumn_ - the field of the Document by which to sort the returned list of documents. This is one of the SORT_COLUMN_XXX in Document
      sortOrder_ - Constants.SORT_ORDER_ASCENDING for sorting results in ascending order, Constants.SORT_ORDER_DESCENDING for sorting results in descending order
      sortLength_ - the maximum number of documents to return
      Returns:
      a list of Document objects, of maximum length sortLength_ which represent the latest documents in a users subscriptions
      Throws:
      ServiceException - if any system-level error occurs
      InvalidUserException - if the current user service context is invalid.

    • getMoreWhatsNewSubscriptionsPaging

      @Deprecated @Read(K_COLLAB) ResultPage getMoreWhatsNewSubscriptionsPaging(int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidUserException
      Deprecated.
      Gets the latest documents added/updated in the application in knowledge centers to which the user is subscribed
      Parameters:
      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 of Constants.COUNT_ALL will result in the entire collection being returned, but this is STRONGLY discouraged.
      sortProperty_ - the property by which the results will be sorted This is one of the SORT_BY_XXX constants in Document.
      sortOrder_ - Constants.SORT_ORDER_ASCENDING for sorting results in ascending order, Constants.SORT_ORDER_DESCENDING for sorting results in descending order
      Returns:
      a ResultPage containing a list of Document objects that represent the latest documents in a user's subscriptions
      Throws:
      ServiceException - if any system-level error occurs
      InvalidUserException - if the current user service context is invalid.

    • getWhatsNewCommunityForUser

      @Deprecated @Read(K_COLLAB) Document[] getWhatsNewCommunityForUser(Long communityId_, Long num_) throws InvalidUserException, InvalidCommunityException
      Deprecated.
      use getWhatsNewCommunityForUserPaging
      Gets the latest documents (that the user can access) added/updated in the application in a specific community and its sub-communties
      Parameters:
      communityId_ - the unique ID of the community
      num_ - the top number of documents to return
      Returns:
      a list of Document objects which represent the top N latest documents
      Throws:
      ServiceException - if any system-level error occurs
      InvalidUserException - if the current user service context is invalid.
      InvalidCommunityException - if the community does not exist

    • getWhatsNewCommunityForUserPaging

      @Deprecated @Read(K_COLLAB) ResultPage getWhatsNewCommunityForUserPaging(Long communityId_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidUserException, InvalidCommunityException
      Deprecated.
      Gets the latest documents (that the user can access) added/updated in the application in a specific community and its sub-communties
      Parameters:
      communityId_ - the unique ID of the community
      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 of Constants.COUNT_ALL will result in the entire collection being returned, but this is STRONGLY discouraged.
      sortProperty_ - the property by which the results will be sorted This is one of the SORT_BY_XXX constants in Document.
      sortOrder_ - Constants.SORT_ORDER_ASCENDING for sorting results in ascending order, Constants.SORT_ORDER_DESCENDING for sorting results in descending order
      Returns:
      a ResultPage containing a list of Document objects which represent the top N latest documents
      Throws:
      ServiceException - if any system-level error occurs
      InvalidUserException - if the current user service context is invalid.
      InvalidCommunityException - if the community does not exist

    • getWhatsNewTopLevelCommunityForUser

      @Deprecated @Read(K_COLLAB) Document[] getWhatsNewTopLevelCommunityForUser(Long communityId_, Long num_) throws InvalidUserException, InvalidCommunityException
      Deprecated.
      use getWhatsNewTopLevelCommunityForUserPaging
      Gets the latest documents (that the user can access) added/updated in the application in a specific community (but not its sub-communties)
      Parameters:
      communityId_ - the unique ID of the community
      num_ - the top number of documents to return
      Returns:
      a list of Document objects which represent the top num_ latest documents
      Throws:
      ServiceException - if any system-level error occurs
      InvalidUserException - if the current user service context is invalid.
      InvalidCommunityException - if the community does not exist

    • getWhatsNewTopLevelCommunityForUserPaging

      @Deprecated @Read(K_COLLAB) Document[] getWhatsNewTopLevelCommunityForUserPaging(Long communityId_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidUserException, InvalidCommunityException
      Deprecated.
      This method always returns an empty array of Documents
      Gets the latest documents added/updated in the application in a specific community (but not its sub-communties) that the user can access
      Parameters:
      communityId_ - the unique ID of the community
      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 of Constants.COUNT_ALL will result in the entire collection being returned, but this is STRONGLY discouraged.
      sortProperty_ - the property by which the results will be sorted This is one of the SORT_BY_XXX constants in Document.
      sortOrder_ - Constants.SORT_ORDER_ASCENDING for sorting results in ascending order, Constants.SORT_ORDER_DESCENDING for sorting results in descending order
      Returns:
      a ResultPage containing a list of Document objects which represents the latest documents
      Throws:
      ServiceException - if any system-level error occurs
      InvalidUserException - if the current user service context is invalid.
      InvalidCommunityException - if the community does not exist

    • getWhatsNewCommunityPaging

      @Deprecated @Read(K_COLLAB) ResultPage getWhatsNewCommunityPaging(Long coid_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidCommunityException
      Deprecated.
      Gets the latest documents added/updated in the application in a specific community and its sub-communties (regardless of user)
      Parameters:
      coid_ - the unique ID of the community
      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 of Constants.COUNT_ALL will result in the entire collection being returned, but this is STRONGLY discouraged.
      sortProperty_ - the property by which the results will be sorted This is one of the SORT_BY_XXX constants in Document.
      sortOrder_ - Constants.SORT_ORDER_ASCENDING for sorting results in ascending order, Constants.SORT_ORDER_DESCENDING for sorting results in descending order
      Returns:
      a ResultPage containing a list of Document objects which represent the top N latest documents
      Throws:
      InvalidCommunityException - if the community does not exist
      ServiceException - if any system-level error occurs

    • getWhatsNewCommunity

      @Deprecated @Read(K_COLLAB) Document[] getWhatsNewCommunity(Long coid_, Long num_) throws InvalidCommunityException, InvalidDataFormatException
      Deprecated.
      use getWhatsNewCommunityPaging
      Gets the latest documents added/updated in the application in a specific community and its sub-communties (regardless of user)
      Parameters:
      coid_ - the unique ID of the community
      num_ - the top number of documents to return
      Returns:
      a list of Document objects which represent the top N latest documents
      Throws:
      InvalidCommunityException - if the community does not exist
      ServiceException - if any system-level error occurs
      InvalidDataFormatException

    • getWhatsNewTopLevelCommunity

      @Deprecated @Read(K_COLLAB) Document[] getWhatsNewTopLevelCommunity(Long coid_, Long num_) throws InvalidCommunityException
      Deprecated.
      use getWhatsNewTopLevelCommunityPaging
      Retrieves the the top N latest documents added or updated in a specified community, but not its sub-communities (regardless of user)
      Parameters:
      coid_ - the unique ID of the community
      num_ - the top number of documents to return
      Returns:
      a list of Document objects which represent the documents
      Throws:
      ServiceException - if any system-level error occurs
      InvalidCommunityException - if the community does not exist

    • getWhatsNewTopLevelCommunityPaging

      @Deprecated @Read(K_COLLAB) ResultPage getWhatsNewTopLevelCommunityPaging(Long coid_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidCommunityException
      Deprecated.
      Retrieves the the latest documents added or updated in a specified community, but not its sub-communities (regardless of user)
      Parameters:
      coid_ - the unique ID of the community
      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 of Constants.COUNT_ALL will result in the entire collection being returned, but this is STRONGLY discouraged.
      sortProperty_ - the property by which the results will be sorted This is one of the SORT_BY_XXX constants in Document.
      sortOrder_ - Constants.SORT_ORDER_ASCENDING for sorting results in ascending order, Constants.SORT_ORDER_DESCENDING for sorting results in descending order
      Returns:
      a ResultPage containing a list of Document objects which represents the documents
      Throws:
      ServiceException - if any system-level error occurs
      InvalidCommunityException - if the community does not exist

    • getWhatsNewKnowledgeCenter

      @Deprecated @Read(K_COLLAB) Document[] getWhatsNewKnowledgeCenter(Long kcid_, Integer sortOrder_, String sortColumn_) throws InvalidUserException, InvalidKnowledgeCenterException
      Deprecated.
      use getWhatsNewKnowledgeCenterPaging
      Retrieves the top N latest documents added or updated in a specified knowledge center
      Parameters:
      kcid_ - the unique ID of the knowledge center
      sortColumn_ - the field of the Document by which to sort the returned list of documents. This is one of the SORT_COLUMN_XXX in Document
      sortOrder_ - Constants.SORT_ORDER_ASCENDING for sorting results in ascending order, Constants.SORT_ORDER_DESCENDING for sorting results in descending order
      Returns:
      a list of Document objects which represent the top N latest documents
      Throws:
      ServiceException - if any system-level error occurs
      InvalidUserException - if the current user service context is invalid.
      InvalidKnowledgeCenterException - if the KnowledgeCenter does not exist

    • getWhatsNewKnowledgeCenterPaging

      @Deprecated @Read(K_COLLAB) ResultPage getWhatsNewKnowledgeCenterPaging(Long kcid_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidUserException, InvalidKnowledgeCenterException
      Deprecated.
      Retrieves the top N latest documents added or updated in a specified knowledge center
      Parameters:
      kcid_ - the unique ID of the knowledge center
      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 of Constants.COUNT_ALL will result in the entire collection being returned, but this is STRONGLY discouraged.
      sortProperty_ - the property by which the results will be sorted This is one of the SORT_BY_XXX constants in Document.
      sortOrder_ - Constants.SORT_ORDER_ASCENDING for sorting results in ascending order, Constants.SORT_ORDER_DESCENDING for sorting results in descending order
      Returns:
      a ResultPage containing a list of Document objects which represent the top N latest documents
      Throws:
      ServiceException - if any system-level error occurs
      InvalidUserException - if the logged in user does not have access
      InvalidKnowledgeCenterException - if the KnowledgeCenter does not exist