Interface ContentService
- All Superinterfaces:
com.appiancorp.services.ContextSensitiveService,Service
This interface provides access to the Content service (formerly the Collaboration
service). Whereas previously there were separate services to deal with different
types of content (e.g., FolderService),
all content can now be manipulated through this interface. The content service comes
with an entirely new API and bean hierarchy, which cannot be used with the old
Collaboration services. Inversely, the old beans cannot be used with the new
Content service.
The methods in this service that check whether a user can act on a content item,
such as canUserView(java.lang.Long, java.lang.String), only permit checking whether the user whose context was
used to obtain the service can act on that item. To check whether another user has
a certain role for the item, use getRoleMap(java.lang.Long, java.lang.Boolean) and check whether the user is
listed for the desired role or is a member of a group in the desired role.
There is also an associated service, the
ContentStatisticsService, which can be used
to get various statistics on content (such as the number of content items fitting
specific criteria).
Type Masks:
Types in Content are all powers of 2. This means that you can specify a filter of
multiple types by using the bitwise or operator |. For instance, if you want to both
documents and folders, you can set your typemask filter to:
ContentConstants.TYPE_FOLDER | ContentConstants.TYPE_DOCUMENT
Some of these combination filters are already defined as additional type constants
at ContentConstants.TYPE_XXX
To obtain the root IDs for Rules and Document Management hierarchies:
- Rules - Use
getIdByUuid(String)and passcom.appiancorp.suiteapi.content.ContentConstants.UUID_RULES_ROOT_FOLDER - Document Management - Use
getIdByUuid(String)and passcom.appiancorp.suiteapi.content.ContentConstants.UUID_COMMUNITY_ROOT
ServiceLocator and
ServiceContext):
ServiceContext sc = ServiceLocator.getAdministratorServiceContext();
ContentService cs = ServiceLocator.getContentService(sc);
Long rulesRootId = cs.getIdByUuid(ContentConstants.UUID_RULES_ROOT_FOLDER);
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.static final booleanDeprecated, for removal: This API element is subject to removal in a future version.Fields inherited from interface com.appiancorp.services.ContextSensitiveService
SET_SERVICE_CONTEXT_METHOD_NAME -
Method Summary
Modifier and TypeMethodDescriptionvoidactivateUserSession(Long[] memberOfGroups, Long[] adminOfGroups, Integer userTypeSysAdmin) Deprecated.addFavorite(Long id_) Deprecated.voidaddFavoriteForUsers(Long id, String[] usernames) Deprecated.addFavorites(Long[] ids_) Deprecated.voidaddGroupInRole(Long id, String role, Long groupId) Add group to content in given role.voidaddGroupsInRole(Long id, String role, Long[] groupId) Add groups to content in given role.voidDeprecated.voidaddUserInRole(Long id_, String role_, String username_) Add user to content in given role.voidaddUsersInRole(Long id, String role, String[] username) Add users to content in given role.adjustCounter(Long id, Double value) Adjust a rules based constant (counter) of type integer or double by the given adjustment value.adjustCounter(Long id, Integer value) Adjust a rules based constant (counter) of type integer or double by the given adjustment value.Deprecated.Approved[]Deprecated.String[]approveUsers(Long id_, String[] users_) Approve access to the specified content item for a set of users.approveVersion(Long id_, Integer versionNumber_) Deprecated.Boolean[]areFavorites(Content[] contents_) Deprecated.Boolean[]areFavorites(Long[] ids_) Deprecated.Long[]Deprecated.Long[]Deprecated.Content[]browse(Long root, ContentFilter filter) Deprecated.Long[]browseIds(Long root, ContentFilter filter) Browse includes: what the user may see via group permissions, including favorites, no personal content items, including advertised content items not visible, but not already in favorites.browsePaging(Long root, ContentFilter filter, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Browse includes: what the user may see via group permissions, including favorites, no personal content items, including advertised content items not visible, but not already in favorites.Boolean[]canAdministrate(Content[] content) Can current user Administrate?canAdministrate(Long id) Can current user Administrate?Boolean[]canAdministrate(Long[] ids) Can current user Administrate?Boolean[]Can current user Edit?Can current user Edit?Boolean[]Can current user Edit?Boolean[]canGroupAdministrate(Long[] ids, Long groupId) Can given Group Administrate?canGroupAdministrate(Long id, Long groupId) Can given Group Administrate?Boolean[]canGroupEdit(Long[] ids, Long groupId) Can given Group Edit?canGroupEdit(Long id, Long groupId) Can given Group Edit?Boolean[]canGroupView(Long[] ids, Long groupId) Can given Group View?canGroupView(Long id, Long groupId) Can given Group View?Boolean[]canUserAdministrate(Long[] ids, String username) Can given User Administrate?canUserAdministrate(Long id, String username) Can given User Administrate?Boolean[]canUserEdit(Long[] ids, String username) Can given User Edit?canUserEdit(Long id, String username) Can given User Edit?Boolean[]canUserView(Long[] ids, String username) Can given User View?canUserView(Long id, String username) Can given User View?Boolean[]Can current user View?Can current user View?Boolean[]Can current user View?checkAccess(Long id_) Returns the current user access to a content item.Integer[]checkAccess(Long[] ids_) Returns the current user access to a content items.voidDeprecated.Long[]Deprecated.voidDeprecated.copy(CopySource[] source, Long target) This copies Content item from one location to another.This copies Content item from one location to another.This copies Content item from one location to another.Long[]Creates content.Creates a content object.createApproval(Content[] contents, Integer unique) Attempts to create content, and gets the approval statuses back in anApprovalbean.createApproval(Content content, Integer unique) Attempts to create content, and gets the approval status back in anApprovalbean.createVersion(Content[] contents, Integer unique) Deprecated.createVersion(Content content, Integer unique) Creates a new version of content.deactivate(Long[] ids, Boolean deactivateChildren) Deactivates all versions of the given content items.deactivate(Long id, Boolean deactivateChildren) Deactivates all versions of the given content item.deactivateVersion(Long id, Integer versionNumber, Boolean deactivateChildren) Deactivates specified version of the given content item.deactivateVersions(Long id, Integer[] versionNumbers, Boolean deactivateChildren) Deactivates specified version(s) of the given content item.Deletes all versions of the given content item.Deletes all versions of the given content item.deleteContent(Long[] ids, Boolean deleteChildren) Deletes the given content items.This is an 'empty Recycle Bin/Trashcan' method.deleteVersion(Long id, Integer versionNumber, Boolean children) Deletes specified version(s) of the given content item.deleteVersions(Long id, Integer[] versionNumbers, Boolean children) Deletes specified version(s) of the given content item.Document[]Gets a piece of content and log the transaction if logging is enabled.generateSearchIndex(Timestamp timestamp) Deprecated.generates large files on disk (not object store)Integer[]getAccessLevel(Long[] ids_, int typemask_) Get the Access Level for the current user for a list of content items.Integer[]getAccessLevel(Long[] ids_, Integer typemask_) Get the Access Level for the current user for a list of content items.getAccessLevel(Long id_, int typemask_) Get the Access Level for the current user for a content item.getAccessLevel(Long id_, Integer typemask_) Get the Access Level for the current user for a content item.Integer[]getAccessLevelForUser(Long[] ids_, Integer typemask_, String username_) Get the Access Level for the given user for a list of content items.getAccessLevelForUser(Long id_, Integer typemask_, String username_) Get the Access Level for the given user for a content item.Long[]getAdministratable(Long root, ContentFilter filter) Deprecated.Long[]getAdministratableByUser(Long root, ContentFilter filter, String username) Get all active, non-expired ids off the root, where administratable role held by user.getAdministratablePaging(Long rootId, ContentFilter filter, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) Get Administratable Content objects paging.Members of this group will be considered administrators for all content (appadmins).Content[]getAdvertisedChildren(Long containerId, ContentFilter filter, Integer modifiers) Deprecated.Long[]getAdvertisedChildrenIds(Long containerId, ContentFilter filter, Integer modifiers) getAdvertisedChildrenPaging(Long containerId, ContentFilter filter, Integer modifiers, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) Content[]getAllChildren(Long containerId, ContentFilter filter, Integer modifiers) Deprecated.Long[]getAllChildrenAndVersionIds(Long containerId, ContentFilter filter) Get ids of all versions of all children in a given container.Content[]getAllChildrenAndVersions(Long containerId, ContentFilter filter) Deprecated.getAllChildrenAndVersionsPaging(Long containerId, ContentFilter filter, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) Get all versions of all children in a given container.Long[]getAllChildrenIds(Long containerId, ContentFilter filter, Integer modifiers) Returns all descendant ids in a recursive descent from root.getAllChildrenPaging(Long containerId, ContentFilter filter, Integer modifiers, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) Returns all descendants in a recursive descent from root.Long[]getAllVersionIds(Long id) Gets the IDs of all of the versions of a particular versioned content item.Content[]getAllVersions(Long id) Deprecated.getAllVersionsPaging(Long id, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) Gets all of the versions of a particular versioned content item.Get the application name (in this case, "Appian Collaboration").Gets the content at the specified path relative to the given root.Content[]getChildren(Long containerId, ContentFilter filter, Integer modifiers) Deprecated.Long[]getChildrenIds(Long containerId, ContentFilter filter, Integer modifiers) Returns the ids of the children of a container.getChildrenPaging(Long containerId, ContentFilter filter, Integer modifiers, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) Returns the children of a container.Integer[]getChildrenTypes(Content[] containers) Returns typemasks of all children types found within each container.getChildrenTypes(Long containerId) Returns a typemask of all children types found within a container.Integer[]getChildrenTypes(Long[] containerIds) Returns typemasks of all children types found within each container.Integer[]getChildrenTypesOfType(Long[] containerIds, Integer typemask) Returns typemasks of all children types found within each container.getChildrenTypesOfType(Long containerId, Integer typemask) Returns a typemask of all children types found within a container.getContent(Long id) Deprecated.usegetVersion(Long, Integer)insteadContent[]getContent(Long[] ids) Deprecated.Long[]getContentIdsWhereViewable(Long[] ids) Gets the specified content IDs where viewable, rather than giving an error that the content is not viewable.getContentList(Long[] ids, Integer typemask) Does the same thing asgetContent(Long[]), except it takes a type mask and returns error codes instead of throwing exceptions.getContentPaging(Long[] ids, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) Deprecated.Content[]getContentTree(Long rootContentId, Integer maxDepth, Integer typemask, Integer accessLevel) Deprecated.getContentTreePaging(Long rootContentId, Integer maxDepth, Integer typemask, Integer accessLevel, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) Get the content tree, and page the results.getContentUrl(long contentId) Gets the URL for a given content.Content[]getContentWhereViewable(Long[] ids) Deprecated.getContentWhereViewablePaging(Long[] ids, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) Gets the specified content where viewable, rather than giving an error that the content is not viewable.Long[]getDatatypeIds(Long... contentIds) Gets the datatype ids that content ids map to.getDocumentInputStream(long id) Opens a stream to a Document allowing for the caller to read its contents.getDocumentInputStream(long[] ids) Opens streams to multiple Documents allowing the caller to read their contents.Gets the download log type.Long[]getEditable(Long root, ContentFilter filter) Deprecated.Long[]getEditableByUser(Long root_, ContentFilter filter_, String username_) Get all active, non-expired ids off the root, where editor role held by user.getEditablePaging(Long rootId, ContentFilter filter, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) Get Editable Content objects paging.Content[]getExpired(Long root_, Integer days_, ContentFilter filter_) Deprecated.Long[]getExpiredIds(Long root_, Integer days_, ContentFilter filter_) Deprecated.getExpiredPaging(Long root_, Integer days_, ContentFilter filter_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.Gets the external filename (the name that the file would be saved as by the client, or the name within a .zip file) of a document.String[]getExternalFilenames(Long[] ids) Gets the external filenames (the name that the file would be saved as by the client, or the name within a .zip file) of a set of document.Long[]getFavoriteByRootIds(Long rootId_, ContentFilter filter_, Boolean includeExpiredContent_) Deprecated.Content[]getFavoritesByRoot(Long rootId_, ContentFilter filter_, Boolean includeExpiredContent_) Deprecated.getFavoritesByRootPaging(Long rootId_, ContentFilter filter_, Boolean includeExpiredContent_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.getIdByPath(Long root, String path) Gets the ID of the content at the specified path relative to the given root.getIdByUuid(String uuid) Gets a content id by UUID.Long[]getIdsByUuid(String[] uuids) Gets content ids by UUID.Long[]getImageIdsForUsers(String[] usernames) Get the image document ids for the given users.Content[]getInactive(Long root, ContentFilter filter) Deprecated.Long[]getInactiveIds(Long root, ContentFilter filter) Gets all inactive content ids within the specified root.Long[]getInactiveIdsNoSystem(Long root, ContentFilter filter) Gets all inactive content ids within the specified root but filters out system ids.getInactivePaging(Long root, ContentFilter filter, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) Gets all inactive content items within the specified root.Deprecated.since 23.2.String[]getInternalFilenames(Long[] ids) Deprecated.since 23.2.Long[]getLinkedBy(Long id) Returns the ids of those content items that link to the given id.Long[]getLinkIds(Long id) Returns all link ids to a given content id.Long[]getLinkIdsOfType(Long id, Integer typemask) Returns all links to a given content id.Content[]Returns all links to a given content id.Content[]getLinksOfType(Long id, Integer typemask) Returns all links to a given content id.Content[]Deprecated.usegetMyInactivePaging(int, int, Integer, Integer)insteadLong[]This retrieves the content ids in the 'Recycle Bin/Trashcan' of the current user.getMyInactivePaging(int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) This retrieves the content items in the 'Recycle Bin/Trashcan' of the current user.Integer[]getNumberOfChildren(Long[] containerIds_, Integer typemask_) This returns the number of children matching the typemask for each root id specified.getNumberOfChildren(Long containerId, Integer typemask) This returns the number of children matching the typemask.This returns the count of the requests returned by getRequests.getOpaqueContentUri(long contentId) Gets the opaque id for a given content.Gets the parent of the specified content.getParentId(Long id) Gets the parents of the specified content items.Long[]getParentIds(Long[] ids) Gets the IDs of the parents of the specified content items.Content[]getParents(Long[] ids) Gets the parents of the specified content items.Content[]getParentsFromRoot(Long id, Integer typemask) This returns all of direct ancestors of a node, starting with the root and tracing down to the node's parent.Long[]getParentsFromRootIds(Long id, Integer typemask) This return ids of all of direct ancestors of a node, starting with the root and tracing down to the node's parent.Content[]getParentsToRoot(Long id, Integer typemask) This returns all of direct ancestors of a node, starting with the node's parent and tracing up to the root.Long[]getParentsToRootIds(Long id, Integer typemask) This returns ids of all of direct ancestors of a node, starting with the node's parent and tracing up to the root.Content[]getPending(Long id, ContentFilter filter) Deprecated.getPendingPaging(Long id, ContentFilter filter, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.getPendingReview(Long id_) Deprecated.Integer[]getPendingReviews(Long[] ids_) Deprecated.String[]getPendingUsers(Long id_) This accumulates all users pending for the given content item, returning only the unique names.Get your Personal content item.Content[]getPersonalAndTeams(ContentFilter filter_) Deprecated.Long[]getPersonalAndTeamsIds(ContentFilter filter_) Get children of 'Personal and Teams'.getPersonalAndTeamsPaging(ContentFilter filter_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Get children of 'Personal and Teams'.Get the id for your Personal content item.Content[]Once a user requests an action on a Content item that requires approval, that request is stored with the Content item.getRestrictionMap(Long id_) Deprecated.getRoleMap(Long id_, Boolean includeAggregate_) Get the role map for a content item.getRoleSet(Long id_) Get theContentRoleSetassociated with the content with the ID provided.getRoleSetForGroup(Long groupId_, Long id_) Get theContentRoleSetassociated with the given content for a specific group.getRoleSetForUser(String username_, Long id_) Deprecated.Requires two sets of credentials.getRoleSets(Content[] contents_) Get theContentRoleSets associated with the given contents.getRoleSets(Long[] ids_) Get theContentRoleSets associated with the given content ids.getRoleSetsForGroup(Long groupId_, Long[] ids_) Get theContentRoleSets associated with the given contents for a specific group.getRoleSetsForUser(String username_, Long[] ids_) Deprecated.Requires two sets of credentials.getSystemId(String name_) Deprecated.usegetIdByUuid(String)instead.Long[]getSystemIds(String[] names_) Deprecated.usegetIdsByUuid(String[])instead.String[]Deprecated.Long[]getThumbnailIdsForUsers(String[] usernames, int size) Get the document ids of the thumbnail images of the given size for the given users.Deprecated.User quotas have been removed.getUserSpaceAvailableForUser(String username) Deprecated.User quotas have been removed.Deprecated.User quotas have been removed.getVersion(Long id, Integer versionNumber) Gets the specified version of the content.getVersion(String uuid, Integer versionNumber) Gets the specified version of the content.getVersionId(Long id, Integer versionNumber) Gets the ID of the specified version of the content.getVersionId(String uuid, Integer versionNumber) Gets the ID of the specified version of the content.Long[]getVersionIds(Long[] ids, Integer versionNumber) Gets the specified version of a bunch of pieces of content.Long[]getVersionIds(Long id, Integer[] versionNumbers) Gets the specified versions of a particular piece of content.Content[]getVersions(Long[] ids, Integer versionNumber) Deprecated.Content[]getVersions(Long id, Integer[] versionNumbers) Gets the specified versions of a particular piece of content.getVersionsList(Long[] ids, Integer versionNumber, Integer typemask) Retrieves the specified version of the content objects identified by the given ids and of the given type.getVersionsPaging(Long[] ids, Integer versionNumber, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) Gets the specified version of a bunch of pieces of content.getVersionsPaging(Long id, Integer[] versionNumbers, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) Gets the specified versions of a particular piece of content.Long[]getViewable(Long root, ContentFilter filter) Deprecated.Long[]getViewableByUser(Long root, ContentFilter filter, String username) Get all active, non-expired ids off the root, where view role held by user.getViewablePaging(Long rootId, ContentFilter filter, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) Get Viewable Content objects paging.Content[]getWhatsNew(Long root_, Integer maxResults_, ContentFilter filter_) Deprecated.Long[]getWhatsNewIds(Long root_, Integer maxResults_, ContentFilter filter_) Returns id list of most recently modified content items within the specified root.getWhatsNewPaging(Long root_, Integer maxResults_, ContentFilter filter_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Returns list of most recently modified content items within the specified root.hasChildren(Long containerId) Checks whether the specified container has children.hasChildrenOfType(Long containerId, Integer typemask) Checks whether the specified container has children of a the specified type(s).hasNoChildren(Long containerId) Checks whether the specified container has no children.hasNoChildrenOfType(Long containerId, Integer typemask) Checks whether the specified container has no children of the specified type(s).Boolean[]haveChildren(Content[] containers) Checks whether each of the specified containers has children.Boolean[]haveChildren(Long[] containerIds) Checks whether each of the specified containers has children.Boolean[]haveChildrenOfType(Long[] containerIds, Integer typemask) Checks whether the specified container has children of a the specified type(s).Boolean[]haveNoChildren(Long[] containerIds) Checks whether each of the specified containers has no children.Boolean[]haveNoChildrenOfType(Long[] containerIds, Integer typemask) Checks whether each of the specified containers has no children of the specified type(s).Long[]importContent(Content[] contents, Integer unique) Deprecated.This API is no longer supported and will be removed in the next release.Integer[]importValidate(Content[] contents) Checks the validity of the Content items for import, returning an import status for each.Is administrate privilege restricted?isEditNotRestricted(Long id_) Is edit privilege restricted?isFavorite(Long id_) Deprecated.favorites marking is deprecatedisViewNotRestricted(Long id_) Is view privilege restricted?voidLocalizes the name, description, and parent name for the given content(s).voidLocalizes the name, description, and parent name for the given content(s).voidLocalizes the name, description, and parent name for the given content(s).voidLocalizes the name, description, and parent name for the given content(s).voidDeprecated.voidDeprecated.voidThis moves Content items from one location to another, cutting connection from current parent, setting connection to new parent, updating bytes used in parents.voidThis moves a Content item from one location to another, cutting connection from current parent, setting connection to new parent, updating bytes used in parents.voidmoveKnowledgeCenter(Long kcId, Long communityId) Move a KC to a community.voidmoveKnowledgeCenters(Long[] kcIds, Long communityId) Moves KCs to a community.voidnotifyApproved(Approved... approved) Deprecated.voidnotifyGroupDeletion(Long groupId) Notify the server that a group was deleted so any new group with the same id will not assume the same permissions.voidnotifyGroupsDeletion(Long[] groupIds) Notify the server that groups were deleted so any new group with the same id will not assume the same permissions.voidnotifyUserCreation(String userName) Deprecated.done automatically by UserService.createUservoidnotifyUsersCreation(String[] userNames) Deprecated.done automatically by UserService.createUservoidpopulateExtensionInfo(Content[] contents_) Populates the extensionInfo field in the document beans you pass in.voidpopulateFavorites(Content[] contents_) Deprecated.voidpopulateRoleSets(Content[] contents_) Populates the roleSet field in the content beans you pass in.voidpopulateTypesOfChildren(Content[] containers) Populate the typesOfChildren field in the content beans you pass in.Content[]queryByRoot(Long root_, String queryText_, ContentFilter filter_) Deprecated.queryByRootPaging(Long root_, String queryText_, ContentFilter filter_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) This is more advanced search, accepting special keywords.Long[]queryIdsByRoot(Long root_, String queryText_, ContentFilter filter_) This is more advanced search, accepting special keywords.voidreactivate(Long id) Reactivates the given content item.voidreactivate(Long[] ids) Reactivates the given content items.Deprecated.Approved[]Deprecated.String[]rejectUsers(Long id_, String[] users_) Reject access to the specified content item for a set of users.rejectVersion(Long id_, Integer versionNumber_) Deprecated.voidremoveFavorite(Long id_) Deprecated.voidremoveFavoriteForUsers(Long id_, String[] username_) Deprecated.voidremoveFavorites(Long[] ids_) Deprecated.voidremoveGroupFromRole(Long id, String role, Long groupId) Remove group from content in given role.voidremoveGroupsFromRole(Long id, String role, Long[] groupId) Remove groups from content in given role.voidremoveLinks(Long id, Long[] links) Deprecated.voidremoveUserFromRole(Long id, String role, String username) Remove user from content in given role.voidremoveUsersFromRole(Long id, String role, String[] username) Remove users from content in given role.voidrequestAccess(Long id_) Deprecated.voidrequestAccess(Long[] ids_) Deprecated.voidresetGroupMembership(Timestamp timestamp) Deprecated.No longer necessary with credential systemvoidDeprecated.Content[]searchByRoot(Long rootId, String regex, ContentFilter filter) Deprecated.searchByRootPaging(Long rootId, String regex, ContentFilter filter, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) Searches for content from a given root.Long[]searchIdsByRoot(Long rootId, String regex, ContentFilter filter) Searches for content from a given root.Long[]searchIdsWithin(String regex, Long[] ids) Search for content within the given containers.Content[]searchWithin(String regex, Long[] ids) Deprecated.searchWithinPaging(String regex, Long[] ids, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) Search for content within the given containers.voidsetActorsInRoles(Long id_, String[] users_, String[][] userRoles_, Long[] groups_, String[][] groupRoles_) Set security roles for a content item by users and groups.voidsetAdministratorGroup(Long groupId) Set the group that will be considered administrators for all content (appadmins).voidSets the given id as its own root, splitting it from its existing hierarchy.voidsetPersonalId(Long id_) Set the id for your Personal content item.voidsetRestrictionMap(Long id_, RoleMap roleMap_) Deprecated.setRoleMap(Long id_, ContentRoleMap rolemap_, Boolean contract_) Set the role map for a content item.voidsetRoleMapForAllVersions(Long id_, ContentRoleMap rolemap_, Boolean contract_) Sets the role map for all the versions of a content item.voidDeprecated.usesetAsRoot(Long)intsetSizeOfDocumentVersion(Long documentContentId) Deprecated.since 23.2.voidsetSystemId(String name_, Long id_) Deprecated.Usecreate(Content, Integer)with a pre-populated UUID and the flagContentConstants.VIS_SYSTEM.voidsetSystemIds(String[] names_, Long[] ids_) Deprecated.Usecreate(Content[], Integer)with pre-populated UUIDs and the flagContentConstants.VIS_SYSTEM.voidsetUserSpaceAvailable(String username, Long bytes) Deprecated.User quotas have been removed.voidsetUserSpaceUsage(String username, Long bytesUsed) Deprecated.User quotas have been removed.suggest(String query_, int maxItems_, SuggestParam[] params_, Boolean groupResults_) Queries for content and returns a JSON formatted string to be used by autocomplete.suggest(String query, int maxItems, SuggestParam[] params, Boolean groupResults, Long[] allowList) Queries for content and returns a JSON formatted string to be used by autocomplete.voidDeprecated.voidDeprecated.Long[]Deprecated.Long[]Deprecated.voidupdateAllChildrenAndVersionsExpiration(Long id, Integer expirationDays) Update the expiration days for all children and versions of the given id (including the content with the given id).voidupdateAllChildrenAndVersionsVisibility(Long id, boolean maskType, int bitmask) Update the visibility bitmask for all children and versions of the given id.voidupdateFields(Content[] contents, Integer[] fields, Integer unique) Updates the specified fields of the content items.voidupdateFields(Content content, Integer[] fields, Integer unique) Updates the specified fields of a content item's LATEST version.voidupdateUsernames(String[] oldUsernames_, String[] newUsernames_, long maxExpirationTimeInSeconds_) Deprecated.voidupdateVersionFields(Content content, Integer versionNumber, Integer[] fields, Integer unique) Updates the specified fields of a content item's specific version.Deprecated.since 23.2.uploadDocument(Document doc, Integer unique) Creates a document and provides an output stream to which the document's content should be written.Gets the type of the content specified.Integer[]Gets the types of the content specified.validateGroupMembership(Long[] memberOfGroups, Long[] adminOfGroups) Deprecated.No longer necessary with credential systembooleanvalidateTypedValues(TypedValue[] typedValues) Validates given TypedValues.Methods inherited from interface com.appiancorp.services.ContextSensitiveService
setServiceContext
-
Field Details
-
getApplicationName$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
generateSearchIndex$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
setAdministratorGroup$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAdministratorGroup$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
activateUserSession$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
validateGroupMembership$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
resetGroupMembership$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
notifyUserCreation$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
notifyUsersCreation$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
notifyGroupDeletion$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
notifyGroupsDeletion$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
setUserSpaceUsage$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getUserSpaceUsage$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
setUserSpaceAvailable$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getUserSpaceAvailable$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getUserSpaceAvailableForUser$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getImageIdsForUsers$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getThumbnailIdsForUsers$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
validate$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
createApproval$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
create$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
createVersion$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
upload$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
importContent$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
importValidate$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getContent$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getContentList$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getContentPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getContentTree$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getContentTreePaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getContentWhereViewable$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getContentIdsWhereViewable$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getContentWhereViewablePaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getContentUrl$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getOpaqueContentUri$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getVersion$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getVersions$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getVersionsList$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getVersionId$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getVersionsPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getVersionIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAllVersions$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAllVersionsPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAllVersionIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
download$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getInternalFilename$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getInternalFilenames$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getExternalFilename$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getExternalFilenames$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getByPath$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getIdByPath$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getParent$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getParents$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getParentId$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getParentIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
hasNoChildren$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
haveNoChildren$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
hasNoChildrenOfType$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
haveNoChildrenOfType$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
hasChildren$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
haveChildren$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
hasChildrenOfType$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
haveChildrenOfType$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getChildrenTypesOfType$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getChildrenTypes$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
populateTypesOfChildren$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getChildren$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getChildrenIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getChildrenPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAdvertisedChildren$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAdvertisedChildrenIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAdvertisedChildrenPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getEditablePaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAdministratablePaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getViewablePaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAllChildren$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAllChildrenIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAllChildrenPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAllChildrenAndVersions$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAllChildrenAndVersionIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAllChildrenAndVersionsPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getNumberOfChildren$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getParentsToRoot$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getParentsToRootIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getParentsFromRoot$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getParentsFromRootIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
updateVersionFields$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
updateFields$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
setSizeOfDocumentVersion$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
updateAllChildrenAndVersionsVisibility$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
updateAllChildrenAndVersionsExpiration$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
move$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
copy$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
delete$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
deleteContent$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
deleteVersion$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
deleteVersions$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
deactivate$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
deactivateVersion$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
deactivateVersions$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
reactivate$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getInactive$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getInactiveIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getInactiveIdsNoSystem$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getInactivePaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getMyInactiveIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getMyInactive$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getMyInactivePaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
deleteMyInactive$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getLinks$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getLinkIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getLinksOfType$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getLinkIdsOfType$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
addLinks$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
removeLinks$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getLinkedBy$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
searchByRoot$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
searchIdsByRoot$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
searchByRootPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
searchWithin$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
searchIdsWithin$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
searchWithinPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
queryByRoot$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
queryIdsByRoot$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
queryByRootPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getExpired$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getExpiredIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getExpiredPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
unexpire$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
lock$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
unlock$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
breakLock$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
approve$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
approveVersion$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
reject$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
rejectVersion$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
notifyApproved$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
requestAccess$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
checkAccess$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
approveUsers$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
rejectUsers$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getPending$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getPendingPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getNumberOfRequests$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getRequests$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getPendingUsers$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getPendingReview$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getPendingReviews$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getFavoritesByRoot$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getFavoriteByRootIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getFavoritesByRootPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
isFavorite$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
areFavorites$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
populateFavorites$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
addFavorite$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
addFavoriteForUsers$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
addFavorites$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
removeFavorite$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
removeFavorites$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
removeFavoriteForUsers$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
cleanseFavorites$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
cleanseApprovals$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getRoleMap$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
setRoleMap$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
setRoleMapForAllVersions$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getRestrictionMap$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
setRestrictionMap$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
setActorsInRoles$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getRoleSet$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getRoleSets$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getRoleSetForUser$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getRoleSetsForUser$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getRoleSetForGroup$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getRoleSetsForGroup$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
populateRoleSets$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
populateExtensionInfo$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
localize$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
addUserInRole$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
addUsersInRole$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
removeUserFromRole$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
removeUsersFromRole$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
addGroupInRole$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
addGroupsInRole$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
removeGroupFromRole$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
removeGroupsFromRole$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getViewable$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getViewableByUser$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getEditable$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getEditableByUser$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAdministratable$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAdministratableByUser$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
canAdministrate$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
canUserAdministrate$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
canGroupAdministrate$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
isViewNotRestricted$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
isEditNotRestricted$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
isAdministrateNotRestricted$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
canEdit$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
canUserEdit$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
canGroupEdit$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
canView$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
canUserView$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
canGroupView$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAccessLevel$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAccessLevelForUser$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getWhatsNew$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getWhatsNewIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getWhatsNewPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
setPersonalId$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getPersonalId$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getPersonal$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getPersonalAndTeamsIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getPersonalAndTeams$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getPersonalAndTeamsPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
browse$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
browseIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
browsePaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getDownloadLogType$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
updateUsernames$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
rollbackUpdateUsernames$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
commitUpdateUsernames$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getSystemId$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getSystemIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getSystemNames$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
setSystemId$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
setSystemIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
setRoot$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
setAsRoot$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
suggest$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
adjustCounter$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
moveKnowledgeCenter$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
moveKnowledgeCenters$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
validateTypedValues$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getIdByUuid$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getIdsByUuid$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getDatatypeIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getDocumentInputStream$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
uploadDocument$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
-
Method Details
-
getApplicationName
Get the application name (in this case, "Appian Collaboration").- Returns:
- the name of the application
-
generateSearchIndex
@Write({K_CONTENT_FORCE_PRIMARY,DISK_FILE}) @Deprecated String generateSearchIndex(Timestamp timestamp) Deprecated.generates large files on disk (not object store)Generates search index text file bodies for: "content". Fields in generated file:- id
- n - name
- d - description
- t - type
- st - state
- sec - security
- vis - visibility
- crt - creator
- tsc - timestamp created
- tsm - timestamp modified
- ed - expiration days
- edt - expiration date timestamp
- b - bytes
- p - parent
- Parameters:
timestamp- only include content modified since timestamp (may benullfor all)- Returns:
- a string representation of the URI of the search index output, the caller is responsible for deleting this file once done with it
-
setAdministratorGroup
Set the group that will be considered administrators for all content (appadmins).- Parameters:
groupId- the ID of the group to set as administrators- See Also:
-
getAdministratorGroup
Members of this group will be considered administrators for all content (appadmins).- Returns:
- the ID of the group set as administrators
- See Also:
-
activateUserSession
@Deprecated @Write(K_CONTENT) void activateUserSession(Long[] memberOfGroups, Long[] adminOfGroups, Integer userTypeSysAdmin) Deprecated.Notify the Content server of group membership and application privileges.- Parameters:
memberOfGroups- ID(s) of groups for which the current user is a memberadminOfGroups- ID(s) of groups for which the current user is an adminuserTypeSysAdmin- user type (0 basic; 1 sysadmin)
-
validateGroupMembership
@Deprecated @Read(K_CONTENT) Boolean validateGroupMembership(Long[] memberOfGroups, Long[] adminOfGroups) throws InvalidUserException Deprecated.No longer necessary with credential systemValidate that the group membership passed is incorrect or incomplete (whether activateUserSession needs to be called).- Parameters:
memberOfGroups- ID(s) of groups for which the current user is a memberadminOfGroups- ID(s) of groups for which the current user is an admin- Returns:
- whether activateUserSession needs to be called
- Throws:
InvalidUserException- if an invalid user is referenced
-
resetGroupMembership
Deprecated.No longer necessary with credential systemClear group membership for users who have not logged in since the given timestamp.- Parameters:
timestamp- group membership will be cleared for users who have not logged in since this timestamp
-
notifyUserCreation
Deprecated.done automatically by UserService.createUserNotify the server that the user was created.- Parameters:
userName- username of the user that was created
-
notifyUsersCreation
Deprecated.done automatically by UserService.createUserNotify the server that the users were created.- Parameters:
userNames- usernames of the users that were created
-
notifyGroupDeletion
Notify the server that a group was deleted so any new group with the same id will not assume the same permissions.- Parameters:
groupId- the ID of the group that was deleted
-
notifyGroupsDeletion
Notify the server that groups were deleted so any new group with the same id will not assume the same permissions.- Parameters:
groupIds- the IDs of the groups that were deleted
-
setUserSpaceUsage
@Deprecated @Write(K_CONTENT) void setUserSpaceUsage(String username, Long bytesUsed) throws InvalidUserException, StorageLimitException Deprecated.User quotas have been removed. Calls to this method will be ignored.Set the amount of space (in bytes) currently used by the specified user. This will override the automatically tracked value, and automatic tracking will continue from this value. Application administrator (sysadmin) privileges are required for the user calling this method.- Parameters:
username- the username of the user for which to set the space usagebytesUsed- the number of bytes that user has used. Passing a negative value will throw an IllegalArgumentException.- Throws:
InvalidUserException- if an invalid user is referencedStorageLimitException- if there is no more available space- See Also:
-
getUserSpaceUsage
Deprecated.User quotas have been removed. This method will always return 0Get the amount of space (in bytes) currently used by the specified user.- Returns:
- the number of bytes currently used
- See Also:
-
setUserSpaceAvailable
@Deprecated @Write(K_CONTENT) void setUserSpaceAvailable(String username, Long bytes) throws InvalidUserException Deprecated.User quotas have been removed. Calls to this method will be ignored.Set the remaining disk space (in bytes) available to the specified user. Application administrator (sysadmin) privileges are required for the user calling this method.- Parameters:
username- the username of the user for which to set the quotabytes- the number of bytes to set the quota to. Passing 0 will cause it to use the value set for server.conf.collaboration.DEFAULTSPACE in custom.properties. Passing a negative value will throw an IllegalArgumentException.- Throws:
InvalidUserException- if an invalid user is referenced- See Also:
-
getUserSpaceAvailable
Deprecated.User quotas have been removed. This method will always return- 1Get the total available space (quota) in bytes for the user. In order to get the remaining available space, please subtract the available space to the remaining space: Example:Long availableSpace = contentService.getUserSpaceAvailable() - contentService.getUserSpaceUsage();- Returns:
- the current user's disk quota
- See Also:
-
getUserSpaceAvailableForUser
Deprecated.User quotas have been removed. This method will always return- 1Get the total available space (quota, in bytes) available to the specified user.- Parameters:
username- the username of the user for which to get the quota- Returns:
- the specified user's disk quota
- See Also:
-
getImageIdsForUsers
Get the image document ids for the given users.- Parameters:
usernames- the usernames for which to query- Returns:
- the id of the image document for each user, with nulls where an image was not found or the user is invalid
-
getThumbnailIdsForUsers
Get the document ids of the thumbnail images of the given size for the given users.- Parameters:
usernames- the usernames for which to querysize- the thumbnail size (width in pixels)- Returns:
- the id of the thumbnail image document for each user, with nulls where an image of the given size was not found or the user is invalid
-
validate
Gets the type of the content specified.- Parameters:
id- the ID of the content- Returns:
- the type of the content. Will return 0 if the content does not exist, and -1 if the content is type 0 (atypical)
-
validate
Gets the types of the content specified.- Parameters:
ids- the IDs of the content- Returns:
- the types of the content in the same order as the IDs passed in. Will return 0 if the content does not exist, and -1 if the content is type 0 (atypical)
-
createApproval
@Write(K_CONTENT) Approval createApproval(Content content, Integer unique) throws InvalidContentException, StorageLimitException, PrivilegeException, InsufficientNameUniquenessException, DuplicateUuidException Attempts to create content, and gets the approval status back in anApprovalbean. Seecreate(Content[], Integer).- Parameters:
content- the content to createunique- how unique the name must be (one ofContentConstants.UNIQUE_NONE,ContentConstants.UNIQUE_FOR_TYPE,ContentConstants.UNIQUE_FOR_PARENT, orContentConstants.UNIQUE_FOR_ALL)- Returns:
- the approval status in an
Approvalbean - Throws:
InvalidContentException- if an invalid content item is referencedStorageLimitException- if there is no more available spacePrivilegeException- if the user does not have permission to take this actionInsufficientNameUniquenessException- if the content name is not unique according to the unique_ parameterDuplicateUuidException- if a content item with the same uuid already exists
-
createApproval
@Write(K_CONTENT) Approval createApproval(Content[] contents, Integer unique) throws InvalidContentException, StorageLimitException, PrivilegeException, InsufficientNameUniquenessException, DuplicateUuidException Attempts to create content, and gets the approval statuses back in anApprovalbean.- Parameters:
contents- the content to createunique- how unique the name must be (one ofContentConstants.UNIQUE_NONE,ContentConstants.UNIQUE_FOR_TYPE,ContentConstants.UNIQUE_FOR_PARENT, orContentConstants.UNIQUE_FOR_ALL)- Returns:
- the approval status in an
Approvalbean - Throws:
InvalidContentException- if an invalid content item is referencedStorageLimitException- if there is no more available spacePrivilegeException- if the user does not have permission to take this actionInsufficientNameUniquenessException- if the content name is not unique according to the unique_ parameterDuplicateUuidException- if a content item with the same uuid already exists
-
create
@Write(K_CONTENT) Long create(Content content, Integer unique) throws InvalidContentException, StorageLimitException, PrivilegeException, InsufficientNameUniquenessException, DuplicateUuidException Creates a content object. If the Content object is of typeContentConstants.TYPE_DOCUMENT, you must separately create the actual file on disk in the path specified by theinternalFileNameproperty of the object. This method does not create the file on disk.- Parameters:
content- the content to createunique- how unique the name must be (one ofContentConstants.UNIQUE_NONE,ContentConstants.UNIQUE_FOR_TYPE,ContentConstants.UNIQUE_FOR_PARENT, orContentConstants.UNIQUE_FOR_ALL)- Returns:
- the ID of the content
- Throws:
InvalidContentException- if an invalid content item is referencedStorageLimitException- if there is no more available spacePrivilegeException- if the user does not have permission to take this actionInsufficientNameUniquenessException- if the content name is not unique according to the unique_ parameterDuplicateUuidException- if a content item with the same uuid already exists
-
create
@Write(K_CONTENT) Long[] create(Content[] contents, Integer unique) throws InvalidContentException, StorageLimitException, PrivilegeException, InsufficientNameUniquenessException, DuplicateUuidException Creates content. The following fields are required:- name
- parent
- attributes
- description
- expirationDays
- expirationTimestamp
- extension
- fileSystemId
- forum
- metadataIds
- name
- parent
- partition
- security
- size
- subtype
- type
- uuid
- visibility
- Parameters:
contents- an array of Content objectsunique- how unique the name must be (one ofContentConstants.UNIQUE_NONE,ContentConstants.UNIQUE_FOR_TYPE,ContentConstants.UNIQUE_FOR_PARENT, orContentConstants.UNIQUE_FOR_ALL)- Returns:
- the IDs of the content
- Throws:
InvalidContentException- if an invalid content item is referencedStorageLimitException- if there is no more available spacePrivilegeException- if the user does not have permission to take this actionInsufficientNameUniquenessException- if the content name is not unique according to the unique_ parameterDuplicateUuidException- if a content item with the same uuid already exists
-
createVersion
@Write(K_CONTENT) Approval createVersion(Content content, Integer unique) throws InvalidContentException, NotLockOwnerException, PendingApprovalException, ContentExpiredException, StorageLimitException, PrivilegeException, InsufficientNameUniquenessException Creates a new version of content. This call does not update the parent of the content. If the new version has a new parent, make sure to callmove(Long, Long). The new version will have the same security role map as its parent, even if the content is not otherwise set to inherit security. For content that should not inherit security from its parent, callsetRoleMap(java.lang.Long, com.appiancorp.suiteapi.content.ContentRoleMap, java.lang.Boolean)after creating the new version. When creating a new version of a Document, set the file system id on the document to be auto-allocated before passing it to createVersion. The following code example demonstrates using this method:Document doc = contentService.getVersion(docId, ContentConstants.VERSION_CURRENT); // prepare the document, indicating the service to assign a new file path // to the new version of the document doc.setFileSystemId(ContentConstants.ALLOCATE_FSID); // create a new version Approval a = contentService.createVersion(doc, unique); // get the file path of the new version Long newVersionContentId = a.getId()[0]; Document newDocumentVersion = cs.download(newVersionContentId, VERSION_CURRENT, false); try (OutputStream outStream = newDocumentVersion.getOutputStream()) { IOUtils.copy(inStream, outStream); }- Parameters:
content- a Content objectunique- how unique the name must be (one ofContentConstants.UNIQUE_NONE,ContentConstants.UNIQUE_FOR_TYPE,ContentConstants.UNIQUE_FOR_PARENT, orContentConstants.UNIQUE_FOR_ALL)- Returns:
- the approval status in an
Approvalbean - Throws:
InvalidContentException- if an invalid content item is referencedNotLockOwnerException- if the content is locked and the current user is not the ownerPendingApprovalException- if the content is pending approvalContentExpiredException- if the content you reference is expiredStorageLimitException- if there is no more available spacePrivilegeException- if the user does not have permission to take this actionInsufficientNameUniquenessException- if the content name is not unique according to the unique_ parameter
-
createVersion
@Deprecated @Write(K_CONTENT) Approval createVersion(Content[] contents, Integer unique) throws InvalidContentException, NotLockOwnerException, PendingApprovalException, ContentExpiredException, StorageLimitException, PrivilegeException, InsufficientNameUniquenessException Deprecated.Creates new versions of content. This may be used to create another version of any piece of Content. Each new Content bean passed into this function must be just like the existing one, except where you want the modifications to be. This is really a create, except that the version chain is extended to include this new Content. The id field in Content is used to determine which piece of content to create a new version of; any id in the version chain will suffice. The fields updated are the same list as those for create. This call does not update the parent of the contents. If the new versions have new parents, make sure to callmove(Long[], Long)for bulk move ormove(Long, Long)individually if each has a different parent.- Parameters:
contents- the content to create as new versionsunique- how unique the name must be (one ofContentConstants.UNIQUE_NONE,ContentConstants.UNIQUE_FOR_TYPE,ContentConstants.UNIQUE_FOR_PARENT, orContentConstants.UNIQUE_FOR_ALL)- Returns:
- the approval status in an
Approvalbean - Throws:
InvalidContentException- if an invalid content item is referencedNotLockOwnerException- if the content is locked and the current user is not the ownerPendingApprovalException- if the content is pending approvalContentExpiredException- if the content you reference is expiredStorageLimitException- if there is no more available spacePrivilegeException- if the user does not have permission to take this actionInsufficientNameUniquenessException- if the content name is not unique according to the unique_ parameter
-
upload
@Deprecated @Write({K_CONTENT,OBJECT_STORE}) ContentOutputStream upload(Document doc, Integer unique) throws InvalidContentException, StorageLimitException, PrivilegeException, InsufficientNameUniquenessException, DuplicateUuidException Deprecated.since 23.2. UseuploadDocument(Document, Integer)insteadCreates a document and provides an output stream to which the document's content should be written. The document is created using thecreateApproval(Content, Integer)API. The caller must write the document's data to the returned output stream and complete the upload by callingContentOutputStream.close(). Invoking the stream's close method will calculate the size of the data written to the stream and save it as metadata for the document.- Parameters:
doc- The Document to create.unique- How unique the name must be.- Returns:
- The output stream to which the document's data should be written.
- Throws:
InvalidContentExceptionStorageLimitExceptionPrivilegeExceptionInsufficientNameUniquenessExceptionDuplicateUuidException
-
importContent
@Deprecated @Write(K_CONTENT) Long[] importContent(Content[] contents, Integer unique) throws InvalidContentException, NotLockOwnerException, PendingApprovalException, ContentExpiredException, StorageLimitException, PrivilegeException, InsufficientNameUniquenessException, DuplicateUuidException Deprecated.This API is no longer supported and will be removed in the next release. Only objects that are exported using the Applications import/export will be importable in the next release.Imports content. For each content bean, if the UUID exists already in the same location, this function callscreateVersion(Content[], Integer). Otherwise, it callscreate(Content[], Integer)This does a create or createVersion, as necessary.- Parameters:
contents- an array of Content objects to importunique- how unique the name must be (one ofContentConstants.UNIQUE_NONE,ContentConstants.UNIQUE_FOR_TYPE,ContentConstants.UNIQUE_FOR_PARENT, orContentConstants.UNIQUE_FOR_ALL)- Returns:
- the IDs of the new content
- Throws:
InvalidContentException- if an invalid content item is referencedNotLockOwnerException- if the content is locked and the current user is not the ownerPendingApprovalException- if the content is pending approvalContentExpiredException- if the content you reference is expiredStorageLimitException- if there is no more available spacePrivilegeException- if the user does not have permission to take this actionInsufficientNameUniquenessException- if the content name is not unique according to the unique_ parameterDuplicateUuidException- if the UUID of any of the content items already exists or if the same UUID is passed in for several content items
-
importValidate
@Read(K_CONTENT) Integer[] importValidate(Content[] contents) throws InvalidContentException, NotLockOwnerException, PendingApprovalException, ContentExpiredException, StorageLimitException, PrivilegeException Checks the validity of the Content items for import, returning an import status for each.- Parameters:
contents- an array of Content objects to validate- Returns:
- one of
ContentConstants.IMPORT_VALID,ContentConstants.IMPORT_INVALID_PRIVILEGE,ContentConstants.IMPORT_UUID_EXISTS_ELSEWHERE,ContentConstants.IMPORT_INVALID_PRIVILEGE,ContentConstants.IMPORT_NAME_EXISTS_WITHIN_TYPE, orContentConstants.IMPORT_NAME_EXISTS_WITHIN_PARENT - Throws:
InvalidContentException- if an invalid content item is referencedNotLockOwnerException- if the content is locked and the current user is not the ownerPendingApprovalException- if the content is pending approvalContentExpiredException- if the content you reference is expiredStorageLimitException- if there is no more available spacePrivilegeException- if the user does not have permission to take this actionInsufficientNameUniquenessException- if the content name is not unique according to the unique_ parameter
-
getContent
@Deprecated @Read(K_CONTENT) Content getContent(Long id) throws InvalidContentException, PrivilegeException Deprecated.usegetVersion(Long, Integer)instead.- Parameters:
id- the ID of the content- Returns:
- the
Contentbean - Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this action
-
getContent
Deprecated.Gets Contents by id. This will get the exact Content items specified, including the specific version implied by the Content id. If you want to get only the latest item of Content, usegetVersion(Long, Integer)with version numberContentConstants.VERSION_CURRENTinstead. If retrieving aDocumenttheinternalFilenameproperty won't be populated; usedownload(Long, Integer, Boolean)instead.- Parameters:
ids- the IDs of the content- Returns:
- the
Contentbeans - Throws:
InvalidContentException- if an invalid content item is referenced- See Also:
-
getContentList
@Read(K_CONTENT) ResultList getContentList(Long[] ids, Integer typemask) throws InvalidTypeMaskException Does the same thing asgetContent(Long[]), except it takes a type mask and returns error codes instead of throwing exceptions.- Parameters:
ids- the IDs of the contenttypemask- the types of content to return- Returns:
- a
ResultListofContentbeans. - Throws:
InvalidTypeMaskException- if an invalid typemask was passed in
-
getContentPaging
@Deprecated @Read(K_CONTENT) ResultPage getContentPaging(Long[] ids, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) throws InvalidContentException Deprecated.Does the same thing asgetContent(Long[]), except it pages and returns error codes instead of throwing exceptions.- Parameters:
ids- the IDs of the contentstartIndex- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- a ResultPage containing the list of
Contentobjects - Throws:
InvalidContentException- if an invalid content item is referenced- See Also:
-
getContentTree
@Deprecated @Read(K_CONTENT) Content[] getContentTree(Long rootContentId, Integer maxDepth, Integer typemask, Integer accessLevel) throws InvalidContentException, InvalidTypeMaskException Deprecated.Get the content tree starting from the specified root. Returns the list of contents ordered by a depth first traversal. This populates the depth field in theContentbeans.- Parameters:
rootContentId- (atomic efficient)maxDepth- the maximum depth to traverse the treetypemask- only return contents that match this typemaskaccessLevel- the minimum access level required (one ofContentConstants.AL_NONE,ContentConstants.AL_VIEWER,ContentConstants.AL_EDITOR, andContentConstants.AL_ADMIN- Returns:
- list of Content (Content but with additional depth field filled in)
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed in- See Also:
-
getContentTreePaging
@Read(K_CONTENT) ResultPage getContentTreePaging(Long rootContentId, Integer maxDepth, Integer typemask, Integer accessLevel, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) throws InvalidContentException, InvalidTypeMaskException Get the content tree, and page the results. Returns the list of contents ordered by a depth first traversal. This populates the depth field in theContentbeans.- Parameters:
rootContentId- (atomic efficient)maxDepth- the maximum depth to traverse the treetypemask- only return contents that match this typemaskaccessLevel- (0 is view, 1 is edit, 2 is admin)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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- list of Content (Content but with additional depth field filled in)
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed in- See Also:
-
getContentWhereViewable
@Read(K_CONTENT) @Deprecated Content[] getContentWhereViewable(Long[] ids) throws InvalidContentException Deprecated.Gets the specified content where viewable, rather than giving an error that the content is not viewable. Note: The length of the array ofContentbeans returned may not be the same length as the array of IDs passed in.- Parameters:
ids- the IDs of the content- Returns:
- an array of the
Contentbeans that are viewable - Throws:
InvalidContentException- See Also:
-
getContentIdsWhereViewable
Gets the specified content IDs where viewable, rather than giving an error that the content is not viewable. Note: The length of the array of IDs returned may not be the same length as the array of IDs passed in.- Parameters:
ids- the IDs of the content- Returns:
- an array of the IDs of the viewable content
- Throws:
InvalidContentException
-
getContentWhereViewablePaging
@Read(K_CONTENT) ResultPage getContentWhereViewablePaging(Long[] ids, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) throws InvalidContentException Gets the specified content where viewable, rather than giving an error that the content is not viewable. Note: The number of results returned may not be the same length as the array of IDs passed in.- Parameters:
ids- the IDs of the contentstartIndex- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- an array of the
Contentbeans that are viewable - Throws:
InvalidContentException- See Also:
-
getContentUrl
Gets the URL for a given content.- Parameters:
contentId- the internal identifier of the content- Returns:
- the complete Tempo URL for the content
-
getOpaqueContentUri
Gets the opaque id for a given content.- Parameters:
contentId- the internal identifier of the content- Returns:
- the opaque uri for the content
-
getVersion
@Read(K_CONTENT) Content getVersion(Long id, Integer versionNumber) throws InvalidContentException, InvalidVersionException, PrivilegeException Gets the specified version of the content. If retrieving aDocumenttheinternalFilenameproperty won't be populated; usedownload(Long, Integer, Boolean)instead.- Parameters:
id- the content id (any id within a version chain will do)versionNumber- the version number of content to get (useContentConstants.VERSION_ORIGINALto get the first version of the content andContentConstants.VERSION_CURRENTto get the current version of the content)- Returns:
- the
Contentbean - Throws:
InvalidContentException- if an invalid content item is referencedInvalidVersionException- if an invalid version is referencedPrivilegeException- if the user does not have permission to take this action
-
getVersion
@Read(K_CONTENT) Content getVersion(@ConvertWith(com.appiancorp.kougar.mapper.parameters.UuidParameterConverter.class) String uuid, Integer versionNumber) throws InvalidContentException, InvalidVersionException, PrivilegeException Gets the specified version of the content. If retrieving aDocumenttheinternalFilenameproperty won't be populated; usedownload(Long, Integer, Boolean)instead.- Parameters:
uuid- the content UUID (any UUID within a version chain will do), as if by getIdByUuidversionNumber- the version number of content to get (useContentConstants.VERSION_ORIGINALto get the first version of the content andContentConstants.VERSION_CURRENTto get the current version of the content)- Returns:
- the
Contentbean - Throws:
InvalidContentException- if an invalid content item is referencedInvalidVersionException- if an invalid version is referencedPrivilegeException- if the user does not have permission to take this action
-
getVersions
@Deprecated @Read(K_CONTENT) Content[] getVersions(Long[] ids, Integer versionNumber) throws InvalidContentException, InvalidVersionException, PrivilegeException Deprecated.Gets the specified version of a bunch of pieces of content.- Parameters:
ids- the content ids (any id within a version chain will do)versionNumber- the version number of content to get (useContentConstants.VERSION_ORIGINALto get the first version of the content andContentConstants.VERSION_CURRENTto get the current version of the content)- Returns:
- the
Contentbeans - Throws:
InvalidContentException- if an invalid content item is referencedInvalidVersionException- if an invalid version is referencedPrivilegeException- if the user does not have permission to take this action- See Also:
-
getVersions
@Read(K_CONTENT) Content[] getVersions(Long id, Integer[] versionNumbers) throws InvalidContentException, InvalidVersionException, PrivilegeException Gets the specified versions of a particular piece of content.- Parameters:
id- the content id (any id within a version chain will do)versionNumbers- the version numbers of content to get (useContentConstants.VERSION_ORIGINALto get the first version of the content andContentConstants.VERSION_CURRENTto get the current version of the content)- Returns:
- the
Contentbeans - Throws:
InvalidContentException- if an invalid content item is referencedInvalidVersionException- if an invalid version is referencedPrivilegeException- if the user does not have permission to take this action- See Also:
-
getVersionsPaging
@Read(K_CONTENT) ResultPage getVersionsPaging(Long[] ids, Integer versionNumber, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) throws InvalidContentException, InvalidVersionException, PrivilegeException Gets the specified version of a bunch of pieces of content.- Parameters:
ids- the content ids (any id within a version chain will do)versionNumber- the version number of content to get (useContentConstants.VERSION_ORIGINALto get the first version of the content andContentConstants.VERSION_CURRENTto get the current version of the content)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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- a ResultPage containing the list of
Contentobjects - Throws:
InvalidContentException- if an invalid content item is referencedInvalidVersionException- if an invalid version is referencedPrivilegeException- if the user does not have permission to take this action
-
getVersionsPaging
@Read(K_CONTENT) ResultPage getVersionsPaging(Long id, Integer[] versionNumbers, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) throws InvalidContentException, InvalidVersionException, PrivilegeException Gets the specified versions of a particular piece of content.- Parameters:
id- the content id (any id within a version chain will do)versionNumbers- the version numbers of content to get (useContentConstants.VERSION_ORIGINALto get the first version of the content andContentConstants.VERSION_CURRENTto get the current version of the content)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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- A
ResultListofContentobjects. In the case where there is an exception (such as access restriction) the ResultList.getResultCodes() will have an entry for every id passed to it, but theResult.getResults()will only have an entry for every valid result returned. i.e. ResultList.getResultCodes().length does not always equal Result.getResults().length. They are equal only when *all* items in the ResultList array are >= ResultList.CODE_VALID. - Throws:
InvalidContentException- if an invalid content item is referencedInvalidVersionException- if an invalid version is referencedPrivilegeException- if the user does not have permission to take this action
-
getVersionsList
@Read(K_CONTENT) ResultList getVersionsList(Long[] ids, Integer versionNumber, Integer typemask) throws InvalidTypeMaskException, InvalidVersionException Retrieves the specified version of the content objects identified by the given ids and of the given type. Like allResultListAPIs, this method returns error codes instead of throwing exceptions. Note that the result array is not castable to something other than Content[]. The results should then be cast individually.- Parameters:
ids- The ids of the content objects to retrieve.versionNumber- The version of the content objects to retrieve.typemask- The type of content objects to retrieve.- Returns:
- A
ResultListofContentobjects. In the case where there is an exception (such as access restriction) the ResultList.getResultCodes() will have an entry for every id passed to it, but theResult.getResults()will only have an entry for every valid result returned. i.e. ResultList.getResultCodes().length does not always equal Result.getResults().length. They are equal only when all items in the ResultList array are >= ResultList.CODE_VALID. - Throws:
InvalidTypeMaskException- if an invalid type is passed inInvalidVersionException- if an invalid version number is passed in
-
getVersionId
@Read(K_CONTENT) Long getVersionId(Long id, Integer versionNumber) throws InvalidContentException, InvalidVersionException, PrivilegeException Gets the ID of the specified version of the content.- Parameters:
id- the content id (any id within a version chain will do)versionNumber- the version number of content to get (useContentConstants.VERSION_ORIGINALto get the first version of the content andContentConstants.VERSION_CURRENTto get the current version of the content)- Returns:
- the ID
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidVersionException- if an invalid version is referencedPrivilegeException- if the user does not have permission to take this action
-
getVersionId
@Read(K_CONTENT) Long getVersionId(@ConvertWith(com.appiancorp.kougar.mapper.parameters.UuidParameterConverter.class) String uuid, Integer versionNumber) throws InvalidContentException, InvalidVersionException, PrivilegeException Gets the ID of the specified version of the content.- Parameters:
uuid- the content UUID (any UUID within a version chain will do), as if by getIdByUuidversionNumber- the version number of content to get (useContentConstants.VERSION_ORIGINALto get the first version of the content andContentConstants.VERSION_CURRENTto get the current version of the content)- Returns:
- the ID
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidVersionException- if an invalid version is referencedPrivilegeException- if the user does not have permission to take this action
-
getVersionIds
@Read(K_CONTENT) Long[] getVersionIds(Long[] ids, Integer versionNumber) throws InvalidContentException, InvalidVersionException, PrivilegeException Gets the specified version of a bunch of pieces of content.- Parameters:
ids- the content id (any id within a version chain will do)versionNumber- the version number of content to get (useContentConstants.VERSION_ORIGINALto get the first version of the content andContentConstants.VERSION_CURRENTto get the current version of the content)- Returns:
- the IDs
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidVersionException- if an invalid version is referencedPrivilegeException- if the user does not have permission to take this action
-
getVersionIds
@Read(K_CONTENT) Long[] getVersionIds(Long id, Integer[] versionNumbers) throws InvalidContentException, InvalidVersionException, PrivilegeException Gets the specified versions of a particular piece of content.- Parameters:
id- the content id (any id within a version chain will do)versionNumbers- the version number of content to get (useContentConstants.VERSION_ORIGINALto get the first version of the content andContentConstants.VERSION_CURRENTto get the current version of the content)- Returns:
- the IDs
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidVersionException- if an invalid version is referencedPrivilegeException- if the user does not have permission to take this action
-
getAllVersions
Deprecated.Gets all of the versions of a particular versioned content item. It will return empty for an unversioned content item.- Parameters:
id- the content id (any id within a version chain will do)- Returns:
- all of the versions of the content specified, or an empty array if the content is unversioned
- Throws:
InvalidContentException- if an invalid content item is referenced- See Also:
-
getAllVersionsPaging
@Read(K_CONTENT) ResultPage getAllVersionsPaging(Long id, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) throws InvalidContentException Gets all of the versions of a particular versioned content item. It will return empty for an unversioned content item.- Parameters:
id- the content id (any id within a version chain will do)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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- a ResultPage containing the list of
Contentobjects - Throws:
InvalidContentException- if an invalid content item is referenced- See Also:
-
getAllVersionIds
Gets the IDs of all of the versions of a particular versioned content item. It will return empty for an unversioned content item.- Parameters:
id- the content id (any id within a version chain will do)- Returns:
- the Ids of the versions of the content
- Throws:
InvalidContentException- if an invalid content item is referenced
-
download
@Read(K_CONTENT) Document[] download(Long id, Integer versionNumber, Boolean includeExpired) throws InvalidContentException, InvalidVersionException, PrivilegeException Gets a piece of content and log the transaction if logging is enabled. If the content passed in is a document, this method functions similarly togetVersion(java.lang.Long, java.lang.Integer), but the download is logged if logging is enabled. If the content passed in is a container (e.g., a folder), all documents inside the container will be returned, and each document obtained is logged if logging is enabled. This function will only be used for Knowledge content.- Parameters:
id- the id of content to downloadversionNumber- the version number of content to downloadincludeExpired- whether to include expired content- Returns:
- the documents
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidVersionException- if an invalid version is referencedPrivilegeException- if the user does not have permission to take this action
-
getInternalFilename
Deprecated.since 23.2. UsegetDocumentInputStream(long)for reads anduploadDocument(Document, Integer)for writes, or calland use supported APIs on {@link com.appiancorp.suiteapi.knowledge.Document}Gets the internal filename (physical location on disk) for a document. To always get the internal filename for the most current version, callgetVersionId(Long, Integer)withContentConstants.VERSION_CURRENTto get the most current Id.- Parameters:
id_- the content ID of the version of the document; usegetVersionId(Long, Integer)to obtain the id of the version of the document- Returns:
- a string representation of the internal filename
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getInternalFilenames
@Deprecated @Read(K_CONTENT) String[] getInternalFilenames(Long[] ids) throws InvalidContentException Deprecated.since 23.2. UsegetDocumentInputStream(long[])Gets the internal filenames (physical locations on disk) for a set of documents.- Parameters:
ids- the content IDs of the versions of the documents; usegetVersionIds(Long, Integer[])to obtain the ids of the versions of the document- Returns:
- the string representations of the internal filenames
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getExternalFilename
Gets the external filename (the name that the file would be saved as by the client, or the name within a .zip file) of a document.- Parameters:
id- the content ID- Returns:
- the string representation of the external filename
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getExternalFilenames
Gets the external filenames (the name that the file would be saved as by the client, or the name within a .zip file) of a set of document.- Parameters:
ids- the content IDs- Returns:
- the string representations of the external filenames
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getByPath
Gets the content at the specified path relative to the given root.- Parameters:
root- the id of the root Content itempath- the path relative to the root. containers are separated by "/"- Returns:
- the
Contentbean - Throws:
InvalidContentException- if an invalid content item is referenced
-
getIdByPath
Gets the ID of the content at the specified path relative to the given root.- Parameters:
root- the id of the root Content itempath- the path relative to the root. containers are separated by "/"- Returns:
- the ID
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getParent
Gets the parent of the specified content.- Parameters:
id- the id of the Content item- Returns:
- the
Contentbean - Throws:
InvalidContentException- if an invalid content item is referenced
-
getParents
Gets the parents of the specified content items.- Parameters:
ids- the id of the Content items- Returns:
- the
Contentbeans - Throws:
InvalidContentException- if an invalid content item is referenced
-
getParentId
Gets the parents of the specified content items.- Parameters:
id- the id of the Content item- Returns:
- the ID of the parent
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getParentIds
Gets the IDs of the parents of the specified content items.- Parameters:
ids- the ids of the Content items- Returns:
- the IDs of the parents
- Throws:
InvalidContentException- if an invalid content item is referenced
-
hasNoChildren
Checks whether the specified container has no children. This is the inverse ofhasChildren(Long).- Parameters:
containerId- the ID of the container- Returns:
- true if the container has no children; false if the container has children
- Throws:
InvalidContentException- if an invalid content item is referenced
-
haveNoChildren
Checks whether each of the specified containers has no children. This is the inverse ofhaveChildren(Long[]).- Parameters:
containerIds- the IDs of the containers- Returns:
- true if the container has no children; false if the container has children
- Throws:
InvalidContentException- if an invalid content item is referenced
-
hasNoChildrenOfType
@Read(K_CONTENT) Boolean hasNoChildrenOfType(Long containerId, Integer typemask) throws InvalidTypeMaskException Checks whether the specified container has no children of the specified type(s).- Parameters:
containerId- the ID of the containertypemask- specifies which content types to look for- Returns:
- true if container has no children of given type(s), false if it does have children
- Throws:
InvalidTypeMaskException- if an invalid typemask was passed in
-
haveNoChildrenOfType
@Read(K_CONTENT) Boolean[] haveNoChildrenOfType(Long[] containerIds, Integer typemask) throws InvalidTypeMaskException Checks whether each of the specified containers has no children of the specified type(s).- Parameters:
containerIds- the IDs of the containerstypemask- specifies which content types to look for- Returns:
- for each container, true if container has no children of given type(s), false if it does have children
- Throws:
InvalidTypeMaskException- if an invalid typemask was passed in
-
hasChildren
Checks whether the specified container has children. This is the inverse ofhasNoChildren(Long)- Parameters:
containerId- the ID of the container- Returns:
- true if container has children, false if it does not
- Throws:
InvalidContentException- if an invalid content item is referenced
-
haveChildren
Checks whether each of the specified containers has children. This is the inverse ofhaveNoChildren(Long[]).- Parameters:
containerIds- the IDs of the containers- Returns:
- for each container, true if container has children, false if it does not
- Throws:
InvalidContentException- if an invalid content item is referenced
-
haveChildren
Checks whether each of the specified containers has children. This method extracts the IDs from theContentbeans passed in, and callshaveChildren(Long[])with those IDs.- Parameters:
containers- the containers to check- Returns:
- for each container, true if container has children, false if it does not
- Throws:
InvalidContentException- if an invalid content item is referenced
-
hasChildrenOfType
@Read(K_CONTENT) Boolean hasChildrenOfType(Long containerId, Integer typemask) throws InvalidContentException, InvalidTypeMaskException Checks whether the specified container has children of a the specified type(s).- Parameters:
containerId- the ID of the containertypemask- children types to look for- Returns:
- true if container has children of the specified type(s), false if it does not
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed in
-
haveChildrenOfType
@Read(K_CONTENT) Boolean[] haveChildrenOfType(Long[] containerIds, Integer typemask) throws InvalidContentException, InvalidTypeMaskException Checks whether the specified container has children of a the specified type(s).- Parameters:
containerIds- the IDs of the containerstypemask- children types to look for- Returns:
- for each container, true if container has children, false if it does not
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed in
-
getChildrenTypesOfType
@Read(K_CONTENT) Integer getChildrenTypesOfType(Long containerId, Integer typemask) throws InvalidContentException, InvalidTypeMaskException Returns a typemask of all children types found within a container.- Parameters:
containerId- container idtypemask- children types to look for- Returns:
- typemask of the children found
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed in
-
getChildrenTypesOfType
@Read(K_CONTENT) Integer[] getChildrenTypesOfType(Long[] containerIds, Integer typemask) throws InvalidContentException, InvalidTypeMaskException Returns typemasks of all children types found within each container.- Parameters:
containerIds- container idstypemask- children types to look for- Returns:
- typemasks of the children found
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed in
-
getChildrenTypes
Returns a typemask of all children types found within a container.- Parameters:
containerId- container id- Returns:
- typemask of the children found
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getChildrenTypes
Returns typemasks of all children types found within each container.- Parameters:
containerIds- container ids- Returns:
- typemasks of the children found
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getChildrenTypes
Returns typemasks of all children types found within each container.- Parameters:
containers- containers- Returns:
- typemasks of the children found
- Throws:
InvalidContentException- if an invalid content item is referenced
-
populateTypesOfChildren
Populate the typesOfChildren field in the content beans you pass in.- Parameters:
containers- list of containers- Throws:
InvalidContentException- if an invalid content item is referenced
-
getChildren
@Deprecated @Read(K_CONTENT) Content[] getChildren(Long containerId, ContentFilter filter, Integer modifiers) throws InvalidContentException, InvalidTypeMaskException Deprecated.Returns the children of a container.- Parameters:
containerId- root content idfilter- applies to what children are returnedmodifiers- one ofContentConstants.GC_MOD_DRAFT,ContentConstants.GC_MOD_LINKS,ContentConstants.GC_MOD_NORMAL, orContentConstants.GC_MOD_POPULATE_TYPES_OF_CHILDREN- Returns:
- Content[]
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getChildrenIds
@Read(K_CONTENT) Long[] getChildrenIds(Long containerId, ContentFilter filter, Integer modifiers) throws InvalidContentException, InvalidTypeMaskException Returns the ids of the children of a container.- Parameters:
containerId- root content idfilter- applies to what children are returnedmodifiers- one ofContentConstants.GC_MOD_DRAFT,ContentConstants.GC_MOD_LINKS,ContentConstants.GC_MOD_NORMAL, orContentConstants.GC_MOD_POPULATE_TYPES_OF_CHILDREN- Returns:
- content ids[]
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask
-
getChildrenPaging
@Read(K_CONTENT) ResultPage getChildrenPaging(Long containerId, ContentFilter filter, Integer modifiers, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) throws InvalidContentException, InvalidTypeMaskException Returns the children of a container.- Parameters:
containerId- root content idfilter- applies to what children are returnedmodifiers- one ofContentConstants.GC_MOD_DRAFT,ContentConstants.GC_MOD_LINKS,ContentConstants.GC_MOD_NORMAL, orContentConstants.GC_MOD_POPULATE_TYPES_OF_CHILDRENstartIndex- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- ResultPage of Content
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getAdvertisedChildren
@Deprecated @Read(K_CONTENT) Content[] getAdvertisedChildren(Long containerId, ContentFilter filter, Integer modifiers) throws InvalidContentException, InvalidTypeMaskException Deprecated.Returns the advertised children of a container. This includes the content items normally visible as well as those with the visibility bit VIS_ADVERTISE set to true.- Parameters:
containerId- root content idfilter- applies to what children are returnedmodifiers- one ofContentConstants.GC_MOD_DRAFT,ContentConstants.GC_MOD_LINKS,ContentConstants.GC_MOD_NORMAL, orContentConstants.GC_MOD_POPULATE_TYPES_OF_CHILDREN- Returns:
- Content[]
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getAdvertisedChildrenIds
@Read(K_CONTENT) Long[] getAdvertisedChildrenIds(Long containerId, ContentFilter filter, Integer modifiers) throws InvalidContentException, InvalidTypeMaskException -
getAdvertisedChildrenPaging
@Read(K_CONTENT) ResultPage getAdvertisedChildrenPaging(Long containerId, ContentFilter filter, Integer modifiers, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) throws InvalidContentException, InvalidTypeMaskException -
getEditablePaging
@Read(K_CONTENT) ResultPage getEditablePaging(Long rootId, ContentFilter filter, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) throws InvalidContentException, InvalidTypeMaskException Get Editable Content objects paging. Retrieves all editable objects from a give root, not just direct children.- Parameters:
rootId- root content id: atomicfilter- applies to what children are returnedstartIndex- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- ResultPage of Content
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getAdministratablePaging
@Read(K_CONTENT) ResultPage getAdministratablePaging(Long rootId, ContentFilter filter, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) throws InvalidContentException, InvalidTypeMaskException Get Administratable Content objects paging. Retrieves all objects from a given root that the user has admin rights to, not just direct children.- Parameters:
rootId- root content id: atomicfilter- applies to what children are returnedstartIndex- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- ResultPage of Content
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getViewablePaging
@Read(K_CONTENT) ResultPage getViewablePaging(Long rootId, ContentFilter filter, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) throws InvalidContentException, InvalidTypeMaskException Get Viewable Content objects paging. Retrieves all objects from a given root that the user has viewer rights to, not just direct children.- Parameters:
rootId- root content id: atomicfilter- applies to what children are returnedstartIndex- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- ResultPage of Content
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getAllChildren
@Deprecated @Read(K_CONTENT) Content[] getAllChildren(Long containerId, ContentFilter filter, Integer modifiers) throws InvalidContentException, InvalidTypeMaskException Deprecated.Returns all descendants in a recursive descent from root.- Parameters:
containerId- root content idfilter- applies to what children are returnedmodifiers- one ofContentConstants.GC_MOD_DRAFT,ContentConstants.GC_MOD_LINKS,ContentConstants.GC_MOD_NORMAL, orContentConstants.GC_MOD_POPULATE_TYPES_OF_CHILDREN- Returns:
- Content[]
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getAllChildrenIds
@Read(K_CONTENT) Long[] getAllChildrenIds(Long containerId, ContentFilter filter, Integer modifiers) throws InvalidContentException, InvalidTypeMaskException Returns all descendant ids in a recursive descent from root.- Parameters:
containerId- root content idfilter- applies to what children are returnedmodifiers-ContentConstants.GC_MOD_DRAFT- Returns:
- Content[]
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask
-
getAllChildrenPaging
@Read(K_CONTENT) ResultPage getAllChildrenPaging(Long containerId, ContentFilter filter, Integer modifiers, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) throws InvalidContentException, InvalidTypeMaskException Returns all descendants in a recursive descent from root.- Parameters:
containerId- root content idfilter- applies to what children are returnedmodifiers-ContentConstants.GC_MOD_DRAFTstartIndex- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- Content[]
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getAllChildrenAndVersions
@Deprecated @Read(K_CONTENT) Content[] getAllChildrenAndVersions(Long containerId, ContentFilter filter) throws InvalidContentException, InvalidTypeMaskException Deprecated.Get all versions of all children in a given container.- Parameters:
containerId- root content idfilter- applies to what children are returned- Returns:
- all versions of all children
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getAllChildrenAndVersionIds
@Read(K_CONTENT) Long[] getAllChildrenAndVersionIds(Long containerId, ContentFilter filter) throws InvalidContentException, InvalidTypeMaskException Get ids of all versions of all children in a given container.- Parameters:
containerId- root content idfilter- applies to what children are returned- Returns:
- all versions of all children
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask
-
getAllChildrenAndVersionsPaging
@Read(K_CONTENT) ResultPage getAllChildrenAndVersionsPaging(Long containerId, ContentFilter filter, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) throws InvalidContentException, InvalidTypeMaskException Get all versions of all children in a given container.- Parameters:
containerId- root content idfilter- applies to what children are returnedstartIndex- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- all versions of all children
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getNumberOfChildren
@Read(K_CONTENT) Integer getNumberOfChildren(Long containerId, Integer typemask) throws InvalidContentException, InvalidTypeMaskException This returns the number of children matching the typemask.- Parameters:
containerId- root content id(s)typemask- specifies which content types to look for- Returns:
- integer
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed in
-
getNumberOfChildren
@Read(K_CONTENT) Integer[] getNumberOfChildren(Long[] containerIds_, Integer typemask_) throws InvalidContentException, InvalidTypeMaskException This returns the number of children matching the typemask for each root id specified.- Parameters:
containerIds_- root content id(s)typemask_- specifies which content types to look for- Returns:
- integer
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed in
-
getParentsToRoot
@Read(K_CONTENT) Content[] getParentsToRoot(Long id, Integer typemask) throws InvalidContentException, InvalidTypeMaskException, PrivilegeException This returns all of direct ancestors of a node, starting with the node's parent and tracing up to the root.- Parameters:
id- content idtypemask- specifies which content types to return- Returns:
- content list of parent path to root; only matching types are included. This goes from parent to parent, ending in the root.
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed inPrivilegeException- if the user does not have permission to take this action
-
getParentsToRootIds
@Read(K_CONTENT) Long[] getParentsToRootIds(Long id, Integer typemask) throws InvalidContentException, InvalidTypeMaskException, PrivilegeException This returns ids of all of direct ancestors of a node, starting with the node's parent and tracing up to the root.- Parameters:
id- content idtypemask- specifies which content types to return- Returns:
- content ids of parent path to root; only matching types are included. This goes from parent to parent, ending in the root.
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed inPrivilegeException- if the user does not have permission to take this action
-
getParentsFromRoot
@Read(K_CONTENT) Content[] getParentsFromRoot(Long id, Integer typemask) throws InvalidContentException, InvalidTypeMaskException This returns all of direct ancestors of a node, starting with the root and tracing down to the node's parent.- Parameters:
id- content idtypemask- specifies which content types to return- Returns:
- content list of parent path to root; only matching types are included. This goes from root down to id.
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed in
-
getParentsFromRootIds
@Read(K_CONTENT) Long[] getParentsFromRootIds(Long id, Integer typemask) throws InvalidContentException, InvalidTypeMaskException This return ids of all of direct ancestors of a node, starting with the root and tracing down to the node's parent.- Parameters:
id- content idtypemask- specifies which content types to return- Returns:
- content ids of parent path to root; only matching types are included. This goes from parent to parent, ending in the root.
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed in
-
updateFields
@Write(K_CONTENT) void updateFields(Content content, Integer[] fields, Integer unique) throws InvalidContentException, InvalidUserException, IllegalRecursionException, DuplicateUuidException, PrivilegeException, InsufficientNameUniquenessException Updates the specified fields of a content item's LATEST version. To move all the versions of a content usemove(Long, Long)- Parameters:
content- Content object to updatefields- Integer[] of field names to update; others except id ignored.unique- how unique the name must be (one ofContentConstants.UNIQUE_NONE,ContentConstants.UNIQUE_FOR_TYPE,ContentConstants.UNIQUE_FOR_PARENT, orContentConstants.UNIQUE_FOR_ALL)- Throws:
InvalidContentException- if an invalid content item is referencedInvalidUserException- if an invalid user is referencedIllegalRecursionException- if parent refers to selfDuplicateUuidException- if a content item with the same uuid already existsPrivilegeException- if the user does not have the permissions to update the contentInsufficientNameUniquenessException- if the content name is not unique according to the unique_ parameter
-
updateVersionFields
@Write(K_CONTENT) void updateVersionFields(Content content, Integer versionNumber, Integer[] fields, Integer unique) throws InvalidContentException, InvalidUserException, IllegalRecursionException, DuplicateUuidException, PrivilegeException, InsufficientNameUniquenessException Updates the specified fields of a content item's specific version. To move all the versions of a content usemove(Long, Long)- Parameters:
content- The content object whose data should be used for the update. The id field must be populated to indicate which persisted content object should be updated.versionNumber- The version of the target content that should be updated.fields- The fields to update (other fields in the passed content object will be ignored).unique- How unique the name must be, if it's one of the fields being updated (the value must be one ofContentConstants.UNIQUE_NONE,ContentConstants.UNIQUE_FOR_TYPE,ContentConstants.UNIQUE_FOR_PARENT, orContentConstants.UNIQUE_FOR_ALL).- Throws:
InvalidContentException- if an invalid content item is referencedInvalidUserException- if an invalid user is referenced (if creator is updated and invalid)IllegalRecursionException- if parent refers to selfDuplicateUuidException- if a content item with the same uuid already existsPrivilegeException- if the user does not have the permissions to update the contentInsufficientNameUniquenessException- if the content name is not unique according to the unique_ parameter
-
updateFields
@Write(K_CONTENT) void updateFields(Content[] contents, Integer[] fields, Integer unique) throws InvalidContentException, InvalidUserException, IllegalRecursionException, DuplicateUuidException, PrivilegeException, InsufficientNameUniquenessException Updates the specified fields of the content items. To move all the versions of the contents usemove(Long[], Long)- Parameters:
contents- Content objects to updatefields- Integer[] of field names to update; others except id ignored.unique- how unique the name must be (one ofContentConstants.UNIQUE_NONE,ContentConstants.UNIQUE_FOR_TYPE,ContentConstants.UNIQUE_FOR_PARENT, orContentConstants.UNIQUE_FOR_ALL)- Throws:
InvalidContentException- if an invalid content item is referencedInvalidUserException- if an invalid user is referencedIllegalRecursionException- if parent refers to selfDuplicateUuidException- if a content item with the same uuid already existsPrivilegeException- if the user does not have the permissions to update the contentInsufficientNameUniquenessException- if the content name is not unique according to the unique_ parameter
-
setSizeOfDocumentVersion
@Deprecated @Write(K_CONTENT) @Read(OBJECT_STORE) int setSizeOfDocumentVersion(Long documentContentId) throws InvalidContentException, PrivilegeException Deprecated.since 23.2. Writing to a Document viaDocumentOutputStreamorContentUploadOutputStreamwill update the Document size metadata automatically upon closing the stream.Sets the size property of a Document. This method calculates the size of the data saved for the given Document and saves the value within the Document's metadata (the size can then be retrieved by retrieving the Document's Content object and reading thesize field).- Parameters:
documentContentId- The id of the target Document. This id must be the content id of the specific version for which the size should be set.- Returns:
- The size of the Document in bytes.
- Throws:
InvalidContentException- If there is no content object with the given id.PrivilegeException- If the user does not have sufficient privileges to update the Document's metadata.
-
updateAllChildrenAndVersionsVisibility
@Write(K_CONTENT) void updateAllChildrenAndVersionsVisibility(Long id, boolean maskType, int bitmask) throws InvalidContentException, PrivilegeException Update the visibility bitmask for all children and versions of the given id. This is typically used to update the searchability of content. Example to set all ids under contentIdOfKnowledgeCenter as VIS_SEARCHABLE: updateAllChildrenAndVersionsVisibility(contentIdOfKnowledgeCenter, true, VIS_SEARCHABLE) Example to clear all ids under contentIdOfKnowledgeCenter from VIS_SEARCHABLE: updateAllChildrenAndVersionsVisibility(contentIdOfKnowledgeCenter, false, 255-VIS_SEARCHABLE) This is equivalent to updating the visibility on all ids returned by getAllChildrenAndVersionIds for the given id.- Parameters:
id-maskType- false for bitwise AND, true for bitwise ORbitmask- (0...255) value that will be AND'd or OR'd against visibility flag- Throws:
PrivilegeException- if no edit privilege on idInvalidContentException- if id is invalid, deleted or deactivated- See Also:
-
updateAllChildrenAndVersionsExpiration
@Write(K_CONTENT) void updateAllChildrenAndVersionsExpiration(Long id, Integer expirationDays) throws InvalidContentException, PrivilegeException Update the expiration days for all children and versions of the given id (including the content with the given id). This is typically used to update the expiration of a knowledge center's children. Updating just the individual field will only take effect on newly created children not on existing data; use this method to update existing data. This is equivalent to updating the expirationDays on all ids returned by getAllChildrenAndVersionIds for the given id.- Parameters:
id-expirationDays- the number of days after which documents in the knowledge centers will expire. If null, the logid's (typically knowledge center id's) expiration days will be used.- Throws:
PrivilegeException- if no edit privilege on idInvalidContentException- if id is invalid, deleted or deactivated- See Also:
-
move
@Write(K_CONTENT) void move(Long id, Long destinationParent) throws InvalidContentException, PrivilegeException, IllegalRecursionException This moves a Content item from one location to another, cutting connection from current parent, setting connection to new parent, updating bytes used in parents. UnlikeupdateFields(Content, Integer[], Integer), it moves all the versions of the content, that supports versioning, i.e.Document,FreeformRule,ConstantandQueryRule.- Parameters:
id- content id(s) to movedestinationParent- parent under which to move the id: atomic- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this actionIllegalRecursionException- if the destination is a descendant of the item you are moving
-
move
@Write(K_CONTENT) void move(Long[] ids, Long destinationParent) throws InvalidContentException, PrivilegeException, IllegalRecursionException This moves Content items from one location to another, cutting connection from current parent, setting connection to new parent, updating bytes used in parents. UnlikeupdateFields(Content[], Integer[], Integer), it moves all the versions of the contents, that support versioning, i.e.Document,FreeformRule,ConstantandQueryRule.- Parameters:
ids- content id(s) to movedestinationParent- parent under which to move the id: atomic- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this actionIllegalRecursionException- if the destination is a descendant of the item you are moving
-
copy
@Write(K_CONTENT) CopyReference[] copy(Long source, Long target) throws InvalidContentException, PrivilegeException This copies Content item from one location to another. The source is copied to the target using the default CopySource rules (COPY_INCLUDE_INTO+COPY_CREATOR). After copying the Content metadata, the underlying file representation must be copied (or linked, as desired). Loop through the CopyReference return list for the information. The copy method returns CopyReference[], as it can make copies of many content items. For each CopyReference you can use theCopyReference.copyContents()API in order to complete the copy.- Parameters:
source- content id(s) to movetarget- parent under which to copy the id- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this action
-
copy
@Write(K_CONTENT) CopyReference[] copy(Long[] source, Long target) throws InvalidContentException, PrivilegeException This copies Content item from one location to another. The source ids are copied using default CopySource rules (COPY_INCLUDE_INTO+COPY_CREATOR). After copying the Content metadata, the underlying file representation must be copied (or linked, as desired). Loop through the CopyReference return list for the information. The copy method returns CopyReference[], as it can make copies of many content items. For each CopyReference you can use theCopyReference.copyContents()API in order to complete the copy. All sources are processed, forming the desired list to copy, before any action is taken.- Parameters:
source- content id(s) to movetarget- parent under which to copy the id- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this action
-
copy
@Write(K_CONTENT) CopyReference[] copy(CopySource[] source, Long target) throws InvalidContentException, PrivilegeException This copies Content item from one location to another. The CopySource represents explicit rules about the copying. After copying the Content metadata, the underlying file representation must be copied (or linked, as desired). Loop through the CopyReference return list for the information. The copy method returns CopyReference[], as it can make copies of many content items. For each CopyReference you can use theCopyReference.copyContents()API in order to complete the copy. All CopySources are processed, forming the desired list to copy, before any action is taken.- Parameters:
source- content id(s) to movetarget- parent under which to copy the id- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this action
-
delete
@Write({K_CONTENT,OBJECT_STORE}) Approval delete(Long id, Boolean deleteChildren) throws InvalidContentException, HasChildrenException, PrivilegeException Deletes all versions of the given content item.- Parameters:
id- content id(s), may be inactivedeleteChildren- delete children (1 is do so, 0 is give exception if children)- Returns:
- Approval Bean (content ids:Long[];pending ids;names of pending;logging id of pending;admin users of approver;admin groups of approver)
- Throws:
InvalidContentException- if an invalid content item is referencedHasChildrenException- if the content item has childrenPrivilegeException- if the user does not have permission to take this action
-
delete
@Write({K_CONTENT,OBJECT_STORE}) Approval delete(Long[] ids, Boolean deleteChildren) throws InvalidContentException, HasChildrenException, PrivilegeException Deletes all versions of the given content item.- Parameters:
ids- content id(s), may be inactivedeleteChildren- delete children (1 is do so, 0 is give exception if children)- Returns:
- Approval Bean (content ids:Long[];pending ids;names of pending;logging id of pending;admin users of approver;admin groups of approver)
- Throws:
InvalidContentException- if an invalid content item is referencedHasChildrenException- if the content item has childrenPrivilegeException- if the user does not have permission to take this action
-
deleteContent
@Write({K_CONTENT,OBJECT_STORE}) Approval deleteContent(Long[] ids, Boolean deleteChildren) throws InvalidContentException, HasChildrenException, PrivilegeException Deletes the given content items.- Parameters:
ids- content id(s), may be inactivedeleteChildren- delete children (1 is do so, 0 is give exception if children)- Returns:
- Approval Bean (content ids:Long[];pending ids;names of pending;logging id of pending;admin users of approver;admin groups of approver)
- Throws:
InvalidContentException- if an invalid content item is referencedHasChildrenException- if the content item has childrenPrivilegeException- if the user does not have permission to take this action
-
deleteVersion
@Write({K_CONTENT,OBJECT_STORE}) Approval deleteVersion(Long id, Integer versionNumber, Boolean children) throws InvalidContentException, HasChildrenException, InvalidVersionException, PrivilegeException Deletes specified version(s) of the given content item.- Parameters:
id- content id(s), may be inactiveversionNumber- version number to deletechildren- delete children (1 is do so, 0 is give exception if children)- Returns:
- Approval Bean (content ids:Long[];pending ids;names of pending;logging id of pending;admin users of approver;admin groups of approver)
- Throws:
InvalidContentException- if an invalid content item is referencedHasChildrenException- if the content item has childrenInvalidVersionException- if an invalid version is referencedPrivilegeException- if the user does not have permission to take this action
-
deleteVersions
@Write({K_CONTENT,OBJECT_STORE}) Approval deleteVersions(Long id, Integer[] versionNumbers, Boolean children) throws InvalidContentException, HasChildrenException, InvalidVersionException, PrivilegeException Deletes specified version(s) of the given content item.- Parameters:
id- content id(s), may be inactiveversionNumbers- version numbers to deletechildren- delete children (1 is do so, 0 is give exception if children)- Returns:
- Approval Bean (content ids:Long[];pending ids;names of pending;logging id of pending;admin users of approver;admin groups of approver)
- Throws:
InvalidContentException- if an invalid content item is referencedHasChildrenException- if the content item has childrenInvalidVersionException- if an invalid version is referencedPrivilegeException- if the user does not have permission to take this action
-
deactivate
@Write(K_CONTENT) Approval deactivate(Long id, Boolean deactivateChildren) throws InvalidContentException, HasChildrenException Deactivates all versions of the given content item. Does not remove the file from disk and does not log in deletion.log.- Parameters:
id- content id(s), may be inactivedeactivateChildren- deactivate children (1 is do so, 0 is give exception if children)- Returns:
- Approval Bean (content ids:Long[];pending ids;names of pending;logging id of pending;admin users of approver;admin groups of approver)
- Throws:
InvalidContentException- if an invalid content item is referencedHasChildrenException- if the content item has children
-
deactivate
@Write(K_CONTENT) Approval deactivate(Long[] ids, Boolean deactivateChildren) throws InvalidContentException, HasChildrenException Deactivates all versions of the given content items. Does not remove the file from disk and does not log in deletion.log.- Parameters:
ids- content id(s), may be inactivedeactivateChildren- deactivate children (1 is do so, 0 is give exception if children)- Returns:
- Approval Bean (content ids:Long[];pending ids;names of pending;logging id of pending;admin users of approver;admin groups of approver)
- Throws:
InvalidContentException- if an invalid content item is referencedHasChildrenException- if the content item has children
-
deactivateVersion
@Write(K_CONTENT) Approval deactivateVersion(Long id, Integer versionNumber, Boolean deactivateChildren) throws InvalidContentException, HasChildrenException, InvalidVersionException Deactivates specified version of the given content item. Does not remove the file from disk and does not log in deletion.log- Parameters:
id- content id(s), may be inactiveversionNumber- version number to deactivatedeactivateChildren- deactivate children (1 is do so, 0 is give exception if children)- Returns:
- Approval Bean (content ids:Long[];pending ids;names of pending;logging id of pending;admin users of approver;admin groups of approver)
- Throws:
InvalidContentException- if an invalid content item is referencedHasChildrenException- if the content item has childrenInvalidVersionException- if an invalid version is referenced
-
deactivateVersions
@Write(K_CONTENT) Approval deactivateVersions(Long id, Integer[] versionNumbers, Boolean deactivateChildren) throws InvalidContentException, HasChildrenException, InvalidVersionException, PrivilegeException Deactivates specified version(s) of the given content item. Does not remove the file from disk and does not log in deletion.log.- Parameters:
id- content id(s), may be inactiveversionNumbers- version numbers to deactivatedeactivateChildren- deactivate children (1 is do so, 0 is give exception if children)- Returns:
- Approval Bean (content ids:Long[];pending ids;names of pending;logging id of pending;admin users of approver;admin groups of approver)
- Throws:
InvalidContentException- if an invalid content item is referencedHasChildrenException- if the content item has childrenInvalidVersionException- if an invalid version is referencedPrivilegeException
-
reactivate
Reactivates the given content item.- Parameters:
id- content id(s), may be inactive- Throws:
InvalidContentException- if an invalid content item is referenced
-
reactivate
Reactivates the given content items.- Parameters:
ids- content id(s), may be inactive- Throws:
InvalidContentException- if an invalid content item is referenced
-
getInactive
@Deprecated @Read(K_CONTENT) Content[] getInactive(Long root, ContentFilter filter) throws InvalidContentException, InvalidTypeMaskException Deprecated.Gets all inactive content items within the specified root.- Parameters:
root- content id: atomicfilter- only content matching the filter will be returned- Returns:
- list of inactive content items
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getInactiveIds
@Read(K_CONTENT) Long[] getInactiveIds(Long root, ContentFilter filter) throws InvalidContentException, InvalidTypeMaskException Gets all inactive content ids within the specified root.- Parameters:
root- content id: atomicfilter- only content matching the filter will be returned- Returns:
- list of inactive content ids
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask
-
getInactiveIdsNoSystem
@Read(K_CONTENT) Long[] getInactiveIdsNoSystem(Long root, ContentFilter filter) throws InvalidContentException, InvalidTypeMaskException Gets all inactive content ids within the specified root but filters out system ids.- Parameters:
root- content id: atomicfilter- only content matching the filter will be returned- Returns:
- list of inactive content ids
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask
-
getInactivePaging
@Read(K_CONTENT) ResultPage getInactivePaging(Long root, ContentFilter filter, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) throws InvalidContentException, InvalidTypeMaskException Gets all inactive content items within the specified root.- Parameters:
root- content id: atomicfilter- only content matching the filter will be returnedstartIndex- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- list of inactive content items
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getMyInactiveIds
This retrieves the content ids in the 'Recycle Bin/Trashcan' of the current user.- Returns:
- ids of deactivated Content items created by the current user
-
getMyInactive
Deprecated.usegetMyInactivePaging(int, int, Integer, Integer)insteadThis retrieves the content items in the 'Recycle Bin/Trashcan' of the current user.- Returns:
- list of deactivated Content items created by the current user
- See Also:
-
getMyInactivePaging
@Read(K_CONTENT) ResultPage getMyInactivePaging(int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) This retrieves the content items in the 'Recycle Bin/Trashcan' of the current user.- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- list of deactivated Content items created by the current user
- See Also:
-
deleteMyInactive
This is an 'empty Recycle Bin/Trashcan' method.- Returns:
- count of deleted items
-
getLinks
Returns all links to a given content id.- Parameters:
id- content id(s) from which links will be returned- Returns:
- content list
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getLinkIds
Returns all link ids to a given content id.- Parameters:
id- content id(s) from which links will be returned- Returns:
- link ids
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getLinksOfType
@Read(K_CONTENT) Content[] getLinksOfType(Long id, Integer typemask) throws InvalidContentException, InvalidTypeMaskException Returns all links to a given content id.- Parameters:
id- content id(s) from which links will be returnedtypemask- the types of content to return- Returns:
- content list
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed in
-
getLinkIdsOfType
@Read(K_CONTENT) Long[] getLinkIdsOfType(Long id, Integer typemask) throws InvalidContentException, InvalidTypeMaskException Returns all links to a given content id.- Parameters:
id- content id(s) from which links will be returnedtypemask- the types of content to return- Returns:
- content ids (flat if multiple)
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed in
-
addLinks
Deprecated.Add a link. A Link is a symbolic link, as in a filesystem for Documents. It's also used in Communities to link to 'Featured' Documents.- Parameters:
id- content id to which links will be added: atomiclinks- content ids which will be added as links to first parameter content id- Throws:
InvalidContentException- if an invalid content item is referenced
-
removeLinks
@Deprecated @Write(K_CONTENT) void removeLinks(Long id, Long[] links) throws InvalidContentException Deprecated.Remove a link.- Parameters:
id- content id from which links will be removed: atomiclinks- ids which will be removed from links of first parameter content id- Throws:
InvalidContentException- if an invalid content item is referenced
-
getLinkedBy
Returns the ids of those content items that link to the given id.- Parameters:
id- content id to which returned ids link- Returns:
- content ids
- Throws:
InvalidContentException- if an invalid content item is referenced
-
searchByRoot
@Deprecated @Read(K_CONTENT) Content[] searchByRoot(Long rootId, String regex, ContentFilter filter) throws InvalidTypeMaskException Deprecated.Searches for content from a given root.- Parameters:
rootId- The root to search inregex- A regular expression to match against name and description. The regex "*text*" will be used.filter- A filter for the search results- Returns:
- list of content items matching the search
- Throws:
InvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
searchIdsByRoot
@Read(K_CONTENT) Long[] searchIdsByRoot(Long rootId, String regex, ContentFilter filter) throws InvalidTypeMaskException Searches for content from a given root.- Parameters:
rootId- The root to search inregex- A regular expression to match against name and description. The regex "*text*" will be used.filter- A filter for the search results- Returns:
- list of content ids matching the search
- Throws:
InvalidTypeMaskException- if the filter contains an invalid typemask
-
searchByRootPaging
@Read(K_CONTENT) ResultPage searchByRootPaging(Long rootId, String regex, ContentFilter filter, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) throws InvalidTypeMaskException Searches for content from a given root.- Parameters:
rootId- The root to search inregex- A regular expression to match against name and description. The regex "*text*" will be used.filter- A filter for the search resultsstartIndex- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- list of content items matching the search
- Throws:
InvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
searchWithin
@Deprecated @Read(K_CONTENT) Content[] searchWithin(String regex, Long[] ids) throws InvalidContentException Deprecated.Search for content within the given containers.- Parameters:
regex- A regular expression to match against name and description. The regex "*contains*" will be used.ids- The ids of the containers within which to search- Returns:
- list of content items matching the search
- Throws:
InvalidContentException- if an invalid content item is referenced- See Also:
-
searchIdsWithin
Search for content within the given containers.- Parameters:
regex- A regular expression to match against name and description. The regex "*contains*" will be used.ids- The ids of the containers within which to search- Returns:
- list of content ids matching the search
- Throws:
InvalidContentException- if an invalid content item is referenced
-
searchWithinPaging
@Read(K_CONTENT) ResultPage searchWithinPaging(String regex, Long[] ids, int startIndex, int batchSize, Integer sortProperty, Integer sortOrder) throws InvalidContentException Search for content within the given containers.- Parameters:
regex- A regular expression to match against name and description. The regex "*contains*" will be used.ids- The ids of the containers within which to searchstartIndex- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- list of content items matching the search
- Throws:
InvalidContentException- if an invalid content item is referenced- See Also:
-
queryByRoot
@Deprecated @Read(K_CONTENT) Content[] queryByRoot(Long root_, String queryText_, ContentFilter filter_) throws InvalidTypeMaskException Deprecated.This is more advanced search, accepting special keywords.
Reserved Keyword Notes active By default, only active is searched. inactive or nonactiv This is the only way to search inactive. hierarchy This limits to those ids visible in hierarchy. onhierarchy This limits to those ids NOT visible in hierarchy. quota This limits to those ids that are quota constrained. nonquota This limits to those ids that are NOT quota constrained. logged This limits to those ids that are logged. unlogged or nonlogged This limits to those ids that are NOT logged. indexable This limits to those ids that are indexable. nonindexable This limits to those ids that are NOT indexable. author:name This is a case-sensitive contains for the creator's username. author (current) This limits to content created by current user. name:text description:text starts:text This is name and description text*, case-insensitive. ends:text This is name and description *text, case-insensitive. contains:text This is name and description *text*, case-insensitive. subscribed This limits to current user's subscriptions. unsubscribed or nonsubscribed This limits to current user's subscriptions. bytes:number approved unapproved created:time modified:time expiration:days extension:ext
Other text is searched for as 'contains' in name and description.
For name and description:- : and = are both equals, <> and >< and != are unequal,
- < is less than, > is greater than, <= is less than or equal to, >= is greater than or equal to.
- Parameters:
root_- The root from which to searchqueryText_- This is the query to perform.filter_- A filter for the search results- Returns:
- list of content items matching the search
- Throws:
InvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
queryIdsByRoot
@Read(K_CONTENT) Long[] queryIdsByRoot(Long root_, String queryText_, ContentFilter filter_) throws InvalidTypeMaskException This is more advanced search, accepting special keywords.- Parameters:
root_- The root from which to searchqueryText_- This is the query to perform.filter_- A filter for the search results- Returns:
- list of content ids matching the search
- Throws:
InvalidTypeMaskException- if the filter contains an invalid typemask
-
queryByRootPaging
@Read(K_CONTENT) ResultPage queryByRootPaging(Long root_, String queryText_, ContentFilter filter_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidTypeMaskException This is more advanced search, accepting special keywords.- Parameters:
root_- The root from which to searchqueryText_- This is the query to perform.filter_- A filter for the search resultsstartIndex_- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty_- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder_- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- list of content items matching the search
- Throws:
InvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getExpired
@Deprecated @Read(K_CONTENT) Content[] getExpired(Long root_, Integer days_, ContentFilter filter_) throws InvalidContentException, InvalidTypeMaskException Deprecated.Returns the list of content items within the given root which will be expired within the given number of days.- Parameters:
root_- content id: only content under root will be returneddays_- Days in the future to check for expirationfilter_- Only content matching the filter will be returned- Returns:
- list of expired content items
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getExpiredIds
@Deprecated @Read(K_CONTENT) Long[] getExpiredIds(Long root_, Integer days_, ContentFilter filter_) throws InvalidContentException, InvalidTypeMaskException Deprecated.Returns the list of content items within the given root which will be expired within the given number of days.- Parameters:
root_- content id: only content under root will be returneddays_- Days in the future to check for expirationfilter_- Only content matching the filter will be returned- Returns:
- list of expired content ids
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask
-
getExpiredPaging
@Deprecated @Read(K_CONTENT) ResultPage getExpiredPaging(Long root_, Integer days_, ContentFilter filter_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidContentException, InvalidTypeMaskException Deprecated.Returns the list of content items within the given root which will be expired within the given number of days.- Parameters:
root_- content id: only content under root will be returneddays_- Days in the future to check for expirationfilter_- Only content matching the filter will be returnedstartIndex_- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty_- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder_- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- list of expired content items
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
unexpire
Deprecated.This unexpires the content, adding its parent expiration days to itself.- Parameters:
id_- content id- Throws:
InvalidContentException- if an invalid content item is referenced
-
unexpire
Deprecated.This unexpires the contents, adding their parent expiration days to themselves.- Parameters:
ids_- content ids- Throws:
InvalidContentException- if an invalid content item is referenced
-
lock
@Deprecated @Write(K_CONTENT) void lock(Long id_) throws InvalidContentException, PendingApprovalException, ContentExpiredException, NotLockOwnerException, PrivilegeException Deprecated.Exclusively locks the base id.- Parameters:
id_- content id to lock- Throws:
InvalidContentException- if an invalid content item is referencedPendingApprovalException- if the content is pending approvalContentExpiredException- if the content you reference is expiredNotLockOwnerException- if the content is locked and the current user is not the ownerPrivilegeException
-
lock
@Deprecated @Write(K_CONTENT) void lock(Long[] ids_) throws InvalidContentException, PendingApprovalException, ContentExpiredException, NotLockOwnerException, PrivilegeException Deprecated.Exclusively locks the base ids.- Parameters:
ids_- content ids to lock- Throws:
InvalidContentException- if an invalid content item is referencedPendingApprovalException- if the content is pending approvalContentExpiredException- if the content you reference is expiredNotLockOwnerException- if the content is locked and the current user is not the ownerPrivilegeException
-
unlock
Deprecated.Only unlocks those ids currently locked by the current user.- Parameters:
id_- id to unlock- Returns:
- ids unlocked
- Throws:
InvalidContentException- if an invalid content item is referenced
-
unlock
Deprecated.Only unlocks those ids currently locked by the current user.- Parameters:
ids_- ids to unlock- Returns:
- ids unlocked
- Throws:
InvalidContentException- if an invalid content item is referenced
-
breakLock
Deprecated.If the user attempts to break his or her own lock (or something unlocked) then no additional security privilege is required; treat it like an unlock. If the user attempts to break another's lock, then admin security privilege is required, or an exception will be thrown.- Parameters:
id_- content id of lock to break- Returns:
- ids with broken locks
- Throws:
InvalidContentException- if an invalid content item is referenced
-
breakLock
Deprecated.If the user attempts to break his or her own lock (or something unlocked) then no additional security privilege is required; treat it like an unlock. If the user attempts to break another's lock, then admin security privilege is required, or an exception will be thrown.- Parameters:
ids_- content id of lock to break- Returns:
- ids with broken locks
- Throws:
InvalidContentException- if an invalid content item is referenced
-
approve
@Deprecated @Write({K_CONTENT,OBJECT_STORE}) Approved approve(Long id_) throws InvalidContentException Deprecated.Approve the given content item.- Parameters:
id_- content id(s)- Returns:
- Approved bean (those ids that were successfully approved;action approved;those users who requested said review)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
approve
@Deprecated @Write({K_CONTENT,OBJECT_STORE}) Approved[] approve(Long[] ids_) throws InvalidContentException Deprecated.Approve the given content items.- Parameters:
ids_- content id(s)- Returns:
- Approved beans (those ids that were successfully approved;action approved;those users who requested said review)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
approveVersion
@Deprecated @Write({K_CONTENT,OBJECT_STORE}) Approved approveVersion(Long id_, Integer versionNumber_) throws InvalidContentException, InvalidVersionException, InvalidApprovalStateException Deprecated.Approve the given version of a content item.- Parameters:
id_- content idversionNumber_- version number- Returns:
- Approved bean (those ids that were successfully approved;action approved;those users who requested said review)
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidVersionException- if an invalid version is referencedInvalidApprovalStateException- if there is an invalid content's state
-
reject
Deprecated.Reject the given content item.- Parameters:
id_- content id(s)- Returns:
- Approved bean (those ids that were successfully rejected;action rejected;those users who requested said review)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
reject
Deprecated.Reject the given content items.- Parameters:
ids_- content id(s)- Returns:
- Approved beans (those ids that were successfully rejected;action rejected;those users who requested said review)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
rejectVersion
@Deprecated @Write(K_CONTENT) Approved rejectVersion(Long id_, Integer versionNumber_) throws InvalidContentException, InvalidVersionException, InvalidRejectionStateException Deprecated.Reject the given version of a content item.- Parameters:
id_- content idversionNumber_- version number- Returns:
- Approved bean (those ids that were successfully rejected;action rejected;those users who requested said review)
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidVersionException- if an invalid version is referencedInvalidRejectionStateException
-
notifyApproved
@Deprecated @Write(K_CONTENT) void notifyApproved(Approved... approved) throws InvalidContentException Deprecated.Sends a notification to the user associated with the approval. It receives the objects returned by any of theacceptandrejectservice methods.- Parameters:
approved- approved bean- Throws:
InvalidContentException- if an invalid content item is referenced
-
requestAccess
Deprecated.Request access to the given content item. Note: This is also done implicitly by adding it as a favorite when the user possesses insufficient permission.- Parameters:
id_- content id- Throws:
InvalidContentException- if an invalid content item is referenced
-
requestAccess
Deprecated.Request access to the given content items. Note: This is also done implicitly by adding it as a favorite when the user possesses insufficient permission.- Parameters:
ids_- content ids- Throws:
InvalidContentException- if an invalid content item is referenced
-
checkAccess
Returns the current user access to a content item. (This call is for Collaboration compatibility.)- Parameters:
id_- content id- Returns:
- 0=unsubcribed, 1=subscribed/favorite, 2=pending access
- Throws:
InvalidContentException- if an invalid content item is referenced
-
checkAccess
Returns the current user access to a content items. (This call is for Collaboration compatibility.)- Parameters:
ids_- content ids- Returns:
- 0=unsubcribed, 1=subscribed/favorite, 2=pending access
- Throws:
InvalidContentException- if an invalid content item is referenced
-
approveUsers
@Write(K_CONTENT) String[] approveUsers(Long id_, String[] users_) throws InvalidUserException, InvalidContentException Approve access to the specified content item for a set of users.- Parameters:
id_- content idusers_- set of users to approve- Returns:
- users who were successfully approved; they should then be notified by the caller
- Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referenced
-
rejectUsers
@Write(K_CONTENT) String[] rejectUsers(Long id_, String[] users_) throws InvalidUserException, InvalidContentException Reject access to the specified content item for a set of users.- Parameters:
id_- content idusers_- set of users to reject- Returns:
- users who were successfully rejected; they should then be notified by the caller
- Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referenced
-
getPending
@Deprecated @Read(K_CONTENT) Content[] getPending(Long id, ContentFilter filter) throws InvalidContentException, InvalidTypeMaskException Deprecated.Get the Content items that have approvals pending action by the current user. This is the inverse of the getRequests, which are requests to another from the current user. This populates the actionRequested, actionRequester.- Parameters:
id-filter-- Returns:
- Throws:
InvalidContentExceptionInvalidTypeMaskException
-
getPendingPaging
@Deprecated @Read(K_CONTENT) ResultPage getPendingPaging(Long id, ContentFilter filter, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidContentException, InvalidTypeMaskException Deprecated.Get the Content items that have approvals pending action by the current user. This is the inverse of the getRequests, which are requests to another from the current user. This populates the actionRequested, actionRequester.- Parameters:
id- root content idfilter- applies to what children are returnedstartIndex_- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty_- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder_- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- Content[]
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getNumberOfRequests
This returns the count of the requests returned by getRequests. By only returning a count, and not all the data, this method is faster and more suitable for status updates.- Returns:
- number of content ids for which a request is outstanding
-
getRequests
Once a user requests an action on a Content item that requires approval, that request is stored with the Content item. This method returns those items that are still pending for this user or the user's group.- Returns:
- list of content items pending approval from the current user
-
getPendingUsers
This accumulates all users pending for the given content item, returning only the unique names.- Parameters:
id_- content id- Returns:
- usernames of pending users
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getPendingReview
Deprecated.This returns the review code for each given id; this may include NO_REVIEW (0).- Parameters:
id_- content id- Returns:
- review id(s)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getPendingReviews
@Deprecated @Read(K_CONTENT) Integer[] getPendingReviews(Long[] ids_) throws InvalidContentException Deprecated.This returns the review code for each given id; this may include NO_REVIEW (0).- Parameters:
ids_- content ids- Returns:
- review id(s)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getFavoritesByRoot
@Deprecated @Read(K_CONTENT) Content[] getFavoritesByRoot(Long rootId_, ContentFilter filter_, Boolean includeExpiredContent_) throws InvalidTypeMaskException Deprecated.Retrieve all content items within the given root which are marked as favorites for the current user.- Parameters:
rootId_- root within which to get favoritesfilter_- Only content matching the filter will be returnedincludeExpiredContent_- set to true to include expired content- Returns:
- favorite contents
- Throws:
InvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getFavoriteByRootIds
@Deprecated @Read(K_CONTENT) Long[] getFavoriteByRootIds(Long rootId_, ContentFilter filter_, Boolean includeExpiredContent_) throws InvalidTypeMaskException Deprecated.Retrieve all content items within the given root which are marked as favorites for the current user.- Parameters:
rootId_- root within which to get favoritesfilter_- Only content matching the filter will be returnedincludeExpiredContent_- set to true to include expired content- Returns:
- favorite content ids
- Throws:
InvalidTypeMaskException- if the filter contains an invalid typemask
-
getFavoritesByRootPaging
@Deprecated @Read(K_CONTENT) ResultPage getFavoritesByRootPaging(Long rootId_, ContentFilter filter_, Boolean includeExpiredContent_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidTypeMaskException Deprecated.Retrieve all content items within the given root which are marked as favorites for the current user.- Parameters:
rootId_- root within which to get favoritesfilter_- Only content matching the filter will be returnedincludeExpiredContent_- set to true to include expired contentstartIndex_- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty_- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder_- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- favorite contents
- Throws:
InvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
isFavorite
Deprecated.favorites marking is deprecatedReturns true if content is marked as a favorite for the current user.- Parameters:
id_- content id- Returns:
- true if content is marked as favorite
- Throws:
InvalidContentException- if an invalid content item is referenced
-
areFavorites
Deprecated.Returns true for each content which is marked as a favorite for the current user.- Parameters:
ids_- content ids- Returns:
- true for each content which is marked as a favorite
- Throws:
InvalidContentException- if an invalid content item is referenced
-
areFavorites
@Deprecated @Read(K_CONTENT) Boolean[] areFavorites(Content[] contents_) throws InvalidContentException Deprecated.Returns true for each content which is marked as a favorite for the current user.- Parameters:
contents_- content items- Returns:
- true for each content which is marked as a favorite
- Throws:
InvalidContentException- if an invalid content item is referenced
-
populateFavorites
@Deprecated @Read(K_CONTENT) void populateFavorites(Content[] contents_) throws InvalidContentException Deprecated.Populates the favorite field in the content beans you pass in.- Parameters:
contents_- an array of Content objects- Throws:
InvalidContentException- if an invalid content item is referenced
-
addFavorite
Deprecated.Mark the given content item as a favorite for the current user.- Parameters:
id_- content id- Returns:
- PendingAccess bean (may be 0 length)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
addFavoriteForUsers
@Deprecated @Write(K_CONTENT) void addFavoriteForUsers(Long id, String[] usernames) throws InvalidContentException, PrivilegeException Deprecated.Mark the given content item as a favorite for the given users. Requires administrator privileges.- Parameters:
id- content id- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this action
-
addFavorites
@Deprecated @Write(K_CONTENT) PendingAccess addFavorites(Long[] ids_) throws InvalidContentException Deprecated.Mark the given content items as a favorite for the current user.- Parameters:
ids_- content ids- Returns:
- PendingAccess bean (may be 0 length)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
removeFavorite
Deprecated.Remove a content item as a favorite for the current user.- Parameters:
id_- content id- Throws:
InvalidContentException- if an invalid content item is referenced
-
removeFavorites
Deprecated.Remove content items as favorites for the current user.- Parameters:
ids_- content ids- Throws:
InvalidContentException- if an invalid content item is referenced
-
removeFavoriteForUsers
@Deprecated @Write(K_CONTENT) void removeFavoriteForUsers(Long id_, String[] username_) throws InvalidContentException, PrivilegeException Deprecated.Remove content item as a favorite for the given users.- Parameters:
id_- content idusername_- list of usernames- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this action
-
cleanseFavorites
Deprecated.This call eliminates those favorites to which have been deactivated/deleted, or to which the user no longer has access.- Returns:
- valid favorite ids
-
cleanseApprovals
Deprecated.This call eliminates those queued approvals that have already been handled by other users. (This is done automatically whenever something is approved or rejected by the current user.) -
getRoleMap
@Read(K_CONTENT) ContentRoleMap getRoleMap(Long id_, Boolean includeAggregate_) throws InvalidContentException Get the role map for a content item.- Parameters:
id_- singularincludeAggregate_- include aggregate (ContentConstants.RM_AGGREGATEorContentConstants.RM_EXPLICIT)- Returns:
- RoleMap
- Throws:
InvalidContentException- if an invalid content item is referenced- See Also:
-
setRoleMap
@Write(K_CONTENT) RoleMapChanges setRoleMap(Long id_, ContentRoleMap rolemap_, Boolean contract_) throws InvalidContentException, InvalidUserException, PrivilegeException Set the role map for a content item.- Parameters:
id_- singularrolemap_- singularcontract_- if true will remove users lower in the hierarchy who are removed from all access in this rolemap- Returns:
- bean with fields approvedGroups, rejectedGroups, approvedUser, rejectedUser
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidUserException- if an invalid user is referencedPrivilegeException- if the user does not have permission to take this action- See Also:
-
setRoleMapForAllVersions
@Write(K_CONTENT) void setRoleMapForAllVersions(Long id_, ContentRoleMap rolemap_, Boolean contract_) throws InvalidContentException, InvalidUserException, PrivilegeException Sets the role map for all the versions of a content item.- Parameters:
id_- The id of the content item whose role map should be set.rolemap_- The role map to set.contract_- if true will remove users lower in the hierarchy who are removed from all access in this rolemap- Throws:
InvalidContentException- if an invalid content id is specifiedInvalidUserException- if an invalid user is referencedPrivilegeException- if the user does not have permission to take this action
-
getRestrictionMap
@Deprecated @Read(K_CONTENT) RoleMap getRestrictionMap(Long id_) throws InvalidContentException, PrivilegeException Deprecated.Gets the restriction map for aContentobject.- Parameters:
id_- Restriction map will be returned for the object specified by this id.- Returns:
- RoleMap with the same roles as a ContentRoleMap, indicating the restrictions on this object.
- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this action- See Also:
-
setRestrictionMap
@Deprecated @Write(K_CONTENT) void setRestrictionMap(Long id_, RoleMap roleMap_) throws InvalidContentException, PrivilegeException, InvalidUserException Deprecated.Sets the restriction map for aContentobject.- Parameters:
id_- Restriction map will be set for the object specified by this id.roleMap_- RoleMap with the same roles as a ContentRoleMap, indicating the restrictions on this object.- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this actionInvalidUserException- if an invalid user is referenced- See Also:
-
setActorsInRoles
@Write(K_CONTENT) void setActorsInRoles(Long id_, String[] users_, String[][] userRoles_, Long[] groups_, String[][] groupRoles_) throws InvalidRoleException, InvalidContentException, PrivilegeException, InvalidUserException Set security roles for a content item by users and groups. (also supports imaginary "deny" role which automatically sets deny_readers and deny_authors)- Parameters:
id_- content idusers_- users to set security foruserRoles_- contains an array of security roles for each corresponding entry in the users_ array. It is legal to have null within this array.groups_- groups to set security forgroupRoles_- contains an array of security roles for each corresponding entry in the groups_ array. It is legal to have null within this array.- Throws:
InvalidRoleException- if an invalid role is passed inInvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this actionInvalidUserException- if an invalid user is referenced
-
getRoleSet
Get theContentRoleSetassociated with the content with the ID provided.- Parameters:
id_- content id- Returns:
- the role set associated with the given content
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getRoleSets
Get theContentRoleSets associated with the given contents.- Parameters:
contents_- list of content items- Returns:
- the role set associated with the given content id
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getRoleSets
Get theContentRoleSets associated with the given content ids.- Parameters:
ids_- content id- Returns:
- the role sets associated with the given content
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getRoleSetForUser
@Deprecated @Read(K_CONTENT) ContentRoleSet getRoleSetForUser(String username_, Long id_) throws InvalidContentException, PrivilegeException, InvalidUserException, DeprecatedException Deprecated.Requires two sets of credentials.Get theContentRoleSetassociated with the given content for a specific user.- Parameters:
username_- user to retrieve role set for (must match current user, or will throw DeprecatedException)id_- content id- Returns:
- the role sets associated with the given content
- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this actionInvalidUserException- if an invalid user is referencedDeprecatedException
-
getRoleSetsForUser
@Deprecated @Read(K_CONTENT) ContentRoleSet[] getRoleSetsForUser(String username_, Long[] ids_) throws InvalidContentException, PrivilegeException, InvalidUserException, DeprecatedException Deprecated.Requires two sets of credentials.Get theContentRoleSets associated with the given contents for a specific user.- Parameters:
username_- user to retrieve role set for (must match current user, or will throw DeprecatedException)ids_- content ids- Returns:
- the role sets associated with the given contents
- Throws:
PrivilegeException- if the user does not have permission to take this actionInvalidContentException- if an invalid content item is referencedInvalidUserException- if an invalid user is referencedDeprecatedException
-
getRoleSetForGroup
@Read(K_CONTENT) ContentRoleSet getRoleSetForGroup(Long groupId_, Long id_) throws InvalidContentException, PrivilegeException Get theContentRoleSetassociated with the given content for a specific group.- Parameters:
groupId_- group to retrieve role set forid_- content id- Returns:
- the role sets associated with the given content
- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this action
-
getRoleSetsForGroup
@Read(K_CONTENT) ContentRoleSet[] getRoleSetsForGroup(Long groupId_, Long[] ids_) throws InvalidContentException, PrivilegeException Get theContentRoleSets associated with the given contents for a specific group.- Parameters:
groupId_- group to retrieve role set forids_- content id- Returns:
- the role sets associated with the given content
- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this action
-
populateRoleSets
@Read(K_CONTENT) void populateRoleSets(Content[] contents_) throws InvalidContentException, PrivilegeException Populates the roleSet field in the content beans you pass in.- Parameters:
contents_- an array of Content objects- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this action
-
populateExtensionInfo
@Read(K_CONTENT) void populateExtensionInfo(Content[] contents_) throws InvalidContentException, PrivilegeException Populates the extensionInfo field in the document beans you pass in. Only applies to documents- Parameters:
contents_- an array of Document objects- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this action
-
localize
Localizes the name, description, and parent name for the given content(s).- Parameters:
content_- content to localize
-
localize
Localizes the name, description, and parent name for the given content(s).- Parameters:
contents_- content to localize
-
localize
Localizes the name, description, and parent name for the given content(s).- Parameters:
content_- content to localizelocale_- localize according to this local
-
localize
Localizes the name, description, and parent name for the given content(s).- Parameters:
contents_- content to localizelocale_- localize according to this local
-
addUserInRole
@Write(K_CONTENT) void addUserInRole(Long id_, String role_, String username_) throws InvalidUserException, InvalidContentException, InvalidRoleException Add user to content in given role.- Parameters:
id_- content idrole_- from ContentConstants (e.g.ContentConstants.ROLE_READERS)username_- username- Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referencedInvalidRoleException- if an invalid role is passed in
-
addUsersInRole
@Write(K_CONTENT) void addUsersInRole(Long id, String role, String[] username) throws InvalidUserException, InvalidContentException, InvalidRoleException Add users to content in given role.- Parameters:
id- content idrole- from ContentConstants (e.g.ContentConstants.ROLE_READERS)username- list of usernames to add role- Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referencedInvalidRoleException- if an invalid role is passed in
-
removeUserFromRole
@Write(K_CONTENT) void removeUserFromRole(Long id, String role, String username) throws InvalidUserException, InvalidContentException, InvalidRoleException Remove user from content in given role.- Parameters:
id- content idrole- from ContentConstants (e.g.ContentConstants.ROLE_READERS)username- user to remove role from- Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referencedInvalidRoleException- if an invalid role is passed in
-
removeUsersFromRole
@Write(K_CONTENT) void removeUsersFromRole(Long id, String role, String[] username) throws InvalidUserException, InvalidContentException, InvalidRoleException Remove users from content in given role.- Parameters:
id- content idrole- from ContentConstants (e.g.ContentConstants.ROLE_READERS)username- list of usernames to remove role from- Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referencedInvalidRoleException- if an invalid role is passed in
-
addGroupInRole
@Write(K_CONTENT) void addGroupInRole(Long id, String role, Long groupId) throws InvalidContentException, InvalidRoleException Add group to content in given role.- Parameters:
id- content idrole- from ContentConstants (e.g.ContentConstants.ROLE_READERS)groupId- group to add role to- Throws:
InvalidContentException- if an invalid content item is referencedInvalidRoleException- if an invalid role is passed in
-
addGroupsInRole
@Write(K_CONTENT) void addGroupsInRole(Long id, String role, Long[] groupId) throws InvalidContentException, InvalidRoleException Add groups to content in given role.- Parameters:
id- content idrole- from ContentConstants (e.g.ContentConstants.ROLE_READERS)groupId- list of groups to add role to- Throws:
InvalidContentException- if an invalid content item is referencedInvalidRoleException- if an invalid role is passed in
-
removeGroupFromRole
@Write(K_CONTENT) void removeGroupFromRole(Long id, String role, Long groupId) throws InvalidContentException, InvalidRoleException Remove group from content in given role.- Parameters:
id- content idrole- from ContentConstants (e.g.ContentConstants.ROLE_READERS)groupId- group to remove role from- Throws:
InvalidContentException- if an invalid content item is referencedInvalidRoleException- if an invalid role is passed in
-
removeGroupsFromRole
@Write(K_CONTENT) void removeGroupsFromRole(Long id, String role, Long[] groupId) throws InvalidContentException, InvalidRoleException Remove groups from content in given role.- Parameters:
id- content idrole- from ContentConstants (e.g.ContentConstants.ROLE_READERS)groupId- list of groups to remove role from- Throws:
InvalidContentException- if an invalid content item is referencedInvalidRoleException- if an invalid role is passed in
-
getViewable
@Deprecated @Read(K_CONTENT) Long[] getViewable(Long root, ContentFilter filter) throws InvalidContentException, InvalidTypeMaskException Deprecated.Get all active, non-expired ids off the root, where view role held by user.- Parameters:
root- content idfilter- Only content matching the filter will be returned- Returns:
- content ids
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getViewableByUser
@Read(K_CONTENT) Long[] getViewableByUser(Long root, ContentFilter filter, String username) throws InvalidUserException, InvalidContentException, InvalidTypeMaskException, DeprecatedException Get all active, non-expired ids off the root, where view role held by user.- Parameters:
root- content idfilter- Only content matching the filter will be returnedusername- user (must match current user, or will throw DeprecatedException)- Returns:
- content ids
- Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemaskDeprecatedException
-
getEditable
@Deprecated @Read(K_CONTENT) Long[] getEditable(Long root, ContentFilter filter) throws InvalidContentException, InvalidTypeMaskException Deprecated.Get all active, non-expired ids off the root, where editor role held by user.- Parameters:
root- content idfilter- Only content matching the filter will be returned- Returns:
- content ids
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getEditableByUser
@Read(K_CONTENT) Long[] getEditableByUser(Long root_, ContentFilter filter_, String username_) throws InvalidUserException, InvalidContentException, InvalidTypeMaskException, DeprecatedException Get all active, non-expired ids off the root, where editor role held by user.- Parameters:
root_- content idfilter_- Only content matching the filter will be returnedusername_- username (must match current user, or will throw DeprecatedException)- Returns:
- content ids
- Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemaskDeprecatedException
-
getAdministratable
@Deprecated @Read(K_CONTENT) Long[] getAdministratable(Long root, ContentFilter filter) throws InvalidContentException, InvalidTypeMaskException Deprecated.Get all active, non-expired ids off the root, where administratable role held by user.- Parameters:
root- content idfilter- Only content matching the filter will be returned- Returns:
- content ids
- Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemask- See Also:
-
getAdministratableByUser
@Read(K_CONTENT) Long[] getAdministratableByUser(Long root, ContentFilter filter, String username) throws InvalidUserException, InvalidContentException, InvalidTypeMaskException, DeprecatedException Get all active, non-expired ids off the root, where administratable role held by user.- Parameters:
root- content idfilter- only content matching the filter will be returnedusername- username (must match current user, or will throw DeprecatedException)- Returns:
- content ids
- Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if the filter contains an invalid typemaskDeprecatedException
-
canAdministrate
Can current user Administrate?- Parameters:
id- content id- Returns:
- boolean (0 if not, 1 if so)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
canAdministrate
Can current user Administrate?- Parameters:
ids- content ids- Returns:
- boolean array (0 if not, 1 if so)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
canAdministrate
Can current user Administrate?- Parameters:
content- content array- Returns:
- boolean array (0 if not, 1 if so)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
canUserAdministrate
@Read(K_CONTENT) Boolean canUserAdministrate(Long id, String username) throws InvalidUserException, InvalidContentException, DeprecatedException Can given User Administrate?- Parameters:
id- content idusername- username (must match current user, or will throw DeprecatedException)- Returns:
- boolean (0 if not, 1 if so)
- Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referencedDeprecatedException
-
canUserAdministrate
@Read(K_CONTENT) Boolean[] canUserAdministrate(Long[] ids, String username) throws InvalidUserException, InvalidContentException Can given User Administrate?- Parameters:
ids- content idsusername- username (must match current user, or will throw DeprecatedException)- Returns:
- boolean array (0 if not, 1 if so)
- Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referenced
-
canGroupAdministrate
Can given Group Administrate?- Parameters:
id- content idgroupId- group id- Returns:
- boolean (0 if not, 1 if so)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
canGroupAdministrate
@Read(K_CONTENT) Boolean[] canGroupAdministrate(Long[] ids, Long groupId) throws InvalidContentException Can given Group Administrate?- Parameters:
ids- content idsgroupId- group id- Returns:
- boolean array (0 if not, 1 if so)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
isViewNotRestricted
Is view privilege restricted?- Parameters:
id_- content id- Returns:
- true if not restricted
- Throws:
InvalidContentException- if an invalid content item is referenced
-
isEditNotRestricted
Is edit privilege restricted?- Parameters:
id_- content id- Returns:
- true if not restricted
- Throws:
InvalidContentException- if an invalid content item is referenced
-
isAdministrateNotRestricted
Is administrate privilege restricted?- Parameters:
id_- content id- Returns:
- true if not restricted
- Throws:
InvalidContentException- if an invalid content item is referenced
-
canEdit
Can current user Edit?- Parameters:
id- content id- Returns:
- boolean (0 if not, 1 if so)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
canEdit
Can current user Edit?- Parameters:
ids- content ids- Returns:
- boolean array (0 if not, 1 if so)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
canEdit
Can current user Edit?- Parameters:
content_- content list- Returns:
- boolean array (0 if not, 1 if so)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
canUserEdit
@Read(K_CONTENT) Boolean canUserEdit(Long id, String username) throws InvalidUserException, InvalidContentException, DeprecatedException Can given User Edit?- Parameters:
id- content idusername- username (must match current user, or will throw DeprecatedException)- Returns:
- boolean (0 if not, 1 if so)
- Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referencedDeprecatedException
-
canUserEdit
@Read(K_CONTENT) Boolean[] canUserEdit(Long[] ids, String username) throws InvalidUserException, InvalidContentException Can given User Edit?- Parameters:
ids- content idusername- username (must match current user, or will throw DeprecatedException)- Returns:
- boolean array (0 if not, 1 if so)
- Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referenced
-
canGroupEdit
Can given Group Edit?- Parameters:
id- content idgroupId- group id- Returns:
- boolean (0 if not, 1 if so)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
canGroupEdit
Can given Group Edit?- Parameters:
ids- content idsgroupId- group id- Returns:
- boolean array (0 if not, 1 if so)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
canView
Can current user View?- Parameters:
id- content id- Returns:
- boolean (0 if not, 1 if so)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
canView
Can current user View?- Parameters:
ids- content ids- Returns:
- boolean array (0 if not, 1 if so)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
canView
Can current user View?- Parameters:
content- content list- Returns:
- boolean array (0 if not, 1 if so)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
canUserView
@Read(K_CONTENT) Boolean canUserView(Long id, String username) throws InvalidUserException, InvalidContentException, DeprecatedException Can given User View?- Parameters:
id- content idusername- username (must match current user, or will throw DeprecatedException)- Returns:
- boolean (0 if not, 1 if so)
- Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referencedDeprecatedException
-
canUserView
@Read(K_CONTENT) Boolean[] canUserView(Long[] ids, String username) throws InvalidUserException, InvalidContentException Can given User View?- Parameters:
ids- content idsusername- username (must match current user, or will throw DeprecatedException)- Returns:
- boolean array (0 if not, 1 if so)
- Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referenced
-
canGroupView
Can given Group View?- Parameters:
id- content idgroupId- group id- Returns:
- boolean (0 if not, 1 if so)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
canGroupView
Can given Group View?- Parameters:
ids- content idsgroupId- group id- Returns:
- boolean array (0 if not, 1 if so)
- Throws:
InvalidContentException- if an invalid content item is referenced
-
getAccessLevel
@Read(K_CONTENT) Integer getAccessLevel(Long id_, Integer typemask_) throws InvalidContentException, InvalidTypeMaskException Get the Access Level for the current user for a content item.- Parameters:
id_- content idtypemask_- specifies the content type- Returns:
- access level. One of
ContentConstants.AL_ADMIN,ContentConstants.AL_EDITOR,ContentConstants.AL_INVALID_ID,ContentConstants.AL_NONE,ContentConstants.AL_VIEWER - Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed in
-
getAccessLevel
@Read(K_CONTENT) Integer getAccessLevel(Long id_, int typemask_) throws InvalidContentException, InvalidTypeMaskException Get the Access Level for the current user for a content item.- Parameters:
id_- content idtypemask_- specifies the content type- Returns:
- access level. One of
ContentConstants.AL_ADMIN,ContentConstants.AL_EDITOR,ContentConstants.AL_INVALID_ID,ContentConstants.AL_NONE,ContentConstants.AL_VIEWER - Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed in
-
getAccessLevel
@Read(K_CONTENT) Integer[] getAccessLevel(Long[] ids_, Integer typemask_) throws InvalidContentException, InvalidTypeMaskException Get the Access Level for the current user for a list of content items.- Parameters:
ids_- content idtypemask_- specifies the content type- Returns:
- access level array. One of
ContentConstants.AL_ADMIN,ContentConstants.AL_EDITOR,ContentConstants.AL_INVALID_ID,ContentConstants.AL_NONE,ContentConstants.AL_VIEWER - Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed in
-
getAccessLevel
@Read(K_CONTENT) Integer[] getAccessLevel(Long[] ids_, int typemask_) throws InvalidContentException, InvalidTypeMaskException Get the Access Level for the current user for a list of content items.- Parameters:
ids_- content idtypemask_- specifies the content type- Returns:
- access level array. One of
ContentConstants.AL_ADMIN,ContentConstants.AL_EDITOR,ContentConstants.AL_INVALID_ID,ContentConstants.AL_NONE,ContentConstants.AL_VIEWER - Throws:
InvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed in
-
getAccessLevelForUser
@Read(K_CONTENT) Integer getAccessLevelForUser(Long id_, Integer typemask_, String username_) throws InvalidUserException, InvalidContentException, InvalidTypeMaskException, DeprecatedException Get the Access Level for the given user for a content item.- Parameters:
id_- content idtypemask_- specifies the content typeusername_- username (must match current user, or will throw DeprecatedException)- Returns:
- access level. One of
ContentConstants.AL_ADMIN,ContentConstants.AL_EDITOR,ContentConstants.AL_INVALID_ID,ContentConstants.AL_NONE,ContentConstants.AL_VIEWER - Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed inDeprecatedException
-
getAccessLevelForUser
@Read(K_CONTENT) Integer[] getAccessLevelForUser(Long[] ids_, Integer typemask_, String username_) throws InvalidUserException, InvalidContentException, InvalidTypeMaskException, DeprecatedException Get the Access Level for the given user for a list of content items.- Parameters:
ids_- content idtypemask_- specifies the content typeusername_- username (must match current user, or will throw DeprecatedException)- Returns:
- access level array. One of
ContentConstants.AL_ADMIN,ContentConstants.AL_EDITOR,ContentConstants.AL_INVALID_ID,ContentConstants.AL_NONE,ContentConstants.AL_VIEWER - Throws:
InvalidUserException- if an invalid user is referencedInvalidContentException- if an invalid content item is referencedInvalidTypeMaskException- if an invalid typemask was passed inDeprecatedException
-
getWhatsNew
@Deprecated @Read(K_CONTENT) Content[] getWhatsNew(Long root_, Integer maxResults_, ContentFilter filter_) throws InvalidTypeMaskException, InvalidContentException Deprecated.Returns list of most recently modified content items within the specified root.- Parameters:
root_- content idmaxResults_- max number of content items to returnfilter_- only content matching the filter will be returned- Returns:
- content list
- Throws:
InvalidTypeMaskException- if the filter contains an invalid typemaskInvalidContentException- if an invalid content item is referenced- See Also:
-
getWhatsNewIds
@Read(K_CONTENT) Long[] getWhatsNewIds(Long root_, Integer maxResults_, ContentFilter filter_) throws InvalidTypeMaskException, InvalidContentException Returns id list of most recently modified content items within the specified root.- Parameters:
root_- content idmaxResults_- max number of content items to returnfilter_- only content matching the filter will be returned- Returns:
- id list
- Throws:
InvalidTypeMaskException- if the filter contains an invalid typemaskInvalidContentException- if an invalid content item is referenced
-
getWhatsNewPaging
@Read(K_CONTENT) ResultPage getWhatsNewPaging(Long root_, Integer maxResults_, ContentFilter filter_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidTypeMaskException, InvalidContentException Returns list of most recently modified content items within the specified root.- Parameters:
root_- content idmaxResults_- max number of content items to returnfilter_- only content matching the filter will be returnedstartIndex_- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty_- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder_- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- content list
- Throws:
InvalidTypeMaskException- if the filter contains an invalid typemaskInvalidContentException- if an invalid content item is referenced- See Also:
-
setPersonalId
Set the id for your Personal content item. Currently refers to your personal knowledge center.- Parameters:
id_- of the content object to set as your personal content- Throws:
InvalidContentException- if an invalid content item is referenced- See Also:
-
getPersonalId
Get the id for your Personal content item. Currently refers to your personal knowledge center. If no personal knowledge center exists it will be created.- Returns:
- the id for your Personal content
- Throws:
InvalidPersonalContentException- if Personal Content does not exist for this user- See Also:
-
getPersonal
Get your Personal content item. Currently refers to your personal knowledge center. If no personal knowledge center exists it will be created.- Returns:
- your Personal content item
- Throws:
InvalidPersonalContentException- if Personal Content does not exist for this user
-
getPersonalAndTeamsIds
@Read(K_CONTENT) Long[] getPersonalAndTeamsIds(ContentFilter filter_) throws InvalidPersonalContentException Get children of 'Personal and Teams'. If no personal knowledge center exists it will be created.- Parameters:
filter_- only content matching the filter will be returned- Returns:
- content ids
- Throws:
InvalidPersonalContentException- if Personal Content does not exist for this user
-
getPersonalAndTeams
@Deprecated @Read(K_CONTENT) Content[] getPersonalAndTeams(ContentFilter filter_) throws InvalidPersonalContentException Deprecated.Get children of 'Personal and Teams'. If no personal knowledge center exists it will be created.- Parameters:
filter_- only content matching the filter will be returned- Returns:
- content list
- Throws:
InvalidPersonalContentException- if Personal Content does not exist for this user- See Also:
-
getPersonalAndTeamsPaging
@Read(K_CONTENT) ResultPage getPersonalAndTeamsPaging(ContentFilter filter_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidPersonalContentException Get children of 'Personal and Teams'. If no personal knowledge center exists it will be created.- Parameters:
filter_- only content matching the filter will be returnedstartIndex_- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty_- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder_- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- content ids
- Throws:
InvalidPersonalContentException- if Personal Content does not exist for this user- See Also:
-
browse
@Deprecated @Read(K_CONTENT) Content[] browse(Long root, ContentFilter filter) throws InvalidContentException, PrivilegeException Deprecated.Browse includes: what the user may see via group permissions, including favorites, no personal content items, including advertised content items not visible, but not already in favorites. Typically used with Personal Knowledge Centers off of Knowledge Root.- Parameters:
root- content idfilter- Only content matching the filter will be returned- Returns:
- list of content items
- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this action
-
browseIds
@Read(K_CONTENT) Long[] browseIds(Long root, ContentFilter filter) throws InvalidContentException, PrivilegeException Browse includes: what the user may see via group permissions, including favorites, no personal content items, including advertised content items not visible, but not already in favorites. Typically used with Personal Knowledge Centers off of Knowledge Root.- Parameters:
root- content idfilter- Only content matching the filter will be returned- Returns:
- list of content item ids
- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this action
-
browsePaging
@Read(K_CONTENT) ResultPage browsePaging(Long root, ContentFilter filter, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidContentException, PrivilegeException Browse includes: what the user may see via group permissions, including favorites, no personal content items, including advertised content items not visible, but not already in favorites. Typically used with Personal Knowledge Centers off of Knowledge Root.- Parameters:
root- content idfilter- Only content matching the filter will be returnedstartIndex_- 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. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.sortProperty_- the property by which the results will be sorted. This is one of theCOLUMN_XXXconstants inContentConstants.sortOrder_- the order in which to sort the results.This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- list of content items
- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this action- See Also:
-
getDownloadLogType
Gets the download log type. Currently always returns TYPE_KC.- Returns:
- download log type
-
updateUsernames
@Deprecated @Write(K_CONTENT) void updateUsernames(String[] oldUsernames_, String[] newUsernames_, long maxExpirationTimeInSeconds_) throws IllegalArgumentException, PrivilegeException, DuplicateNameException Deprecated.DEPRECATED: SeeUserService.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(). AftercommitUpdateUsernameshas been called, the old usernames will still be active, but will expire after the interval specified bymaxExpirationTimeInSeconds_; ifupdateUsernamesis successful butcommitUpdateUsernamesis 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.Note: Only this or the CollaborationService updateUsernames must be called. Do not call both.
- Parameters:
oldUsernames_- the usernames to be updatednewUsernames_- the usernames to which the old usernames will be updatedmaxExpirationTimeInSeconds_- the interval, in seconds, aftercommitUpdateUsernameshas 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.- Throws:
IllegalArgumentException- if the length ofoldUsernames_is not the same as the length ofnewUsernames_.PrivilegeException- if the current user is not a system administratorDuplicateNameException- if anyoldUsernames_ornewUsernames_contain any duplicates, or if an old username is being updated to a username that already existsServiceException- if any system-level error occurs
-
rollbackUpdateUsernames
Deprecated.DEPRECATED: SeeUserService.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.- Throws:
ServiceException- if any system-level error occurs
-
commitUpdateUsernames
Deprecated.DEPRECATED: SeeUserService.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 bymaxExpirationTimeInSeconds_; ifcommitUpdateUsernamesis not called, the new usernames will not become active.- Throws:
ServiceException- if any system-level error occurs
-
getSystemId
Deprecated.usegetIdByUuid(String)instead. This method will be removed in a future releaseGet the system id corresponding to the given name K Supplied names include: community (the system default community) kc (the system kc) image_folder_id leader_message_channel_image_folder_id priority_image_folder_id indicator_image_folder_id reports_folder_id.- Parameters:
name_- this is a known name for a system Content id- Returns:
- system id, or null for unknown
- See Also:
-
getSystemIds
Deprecated.usegetIdsByUuid(String[])instead. This method will be removed in a future releaseGet the system ids corresponding to the given names.- Parameters:
names_- these are the known names for a system Content id- Returns:
- list of system ids (-1 for unknown)
- See Also:
-
getSystemNames
Deprecated.Get all system names.- Returns:
- name array (it will be small)
-
setSystemId
@Deprecated @Write(K_CONTENT) void setSystemId(String name_, Long id_) throws InvalidContentException Deprecated.Usecreate(Content, Integer)with a pre-populated UUID and the flagContentConstants.VIS_SYSTEM.Set a system name to a system id.- Parameters:
name_- system name, must globally uniqueid_- content id- Throws:
InvalidContentException- if an invalid content item is referenced- See Also:
-
setSystemIds
@Deprecated @Write(K_CONTENT) void setSystemIds(String[] names_, Long[] ids_) throws InvalidContentException, IllegalArgumentException Deprecated.Usecreate(Content[], Integer)with pre-populated UUIDs and the flagContentConstants.VIS_SYSTEM.Set system names to system ids.- Parameters:
names_- system names, must globally uniqueids_- content ids- Throws:
InvalidContentException- if an invalid content item is referencedIllegalArgumentException- if the length ofnames_is different from the length ofids_- See Also:
-
setRoot
Deprecated.usesetAsRoot(Long)Sets the given name to be a system id, and its own root, splitting it from its existing hierarchy. Setting as root sets its parent to itself, so it won't traverse further up the tree, and it detaches from the old root. This method also sets the system id; no need for a separate call to call setSystemId().- Parameters:
name_- root nameid_- root id- Throws:
InvalidContentException- if an invalid content item is referenced
-
setAsRoot
Sets the given id as its own root, splitting it from its existing hierarchy. Setting it as root sets its parent to itself, so it won't traverse further up the tree, and it detaches from the old root.- Parameters:
id- root id- Throws:
InvalidContentException- if an invalid content item is referenced
-
suggest
@Read(K_CONTENT) String suggest(String query_, int maxItems_, SuggestParam[] params_, Boolean groupResults_) Queries for content and returns a JSON formatted string to be used by autocomplete.- Parameters:
query_- querymaxItems_- max number of items to returnparams_- list of information on what is being suggested and what format the results should be in. valid types are rules.groupResults_- if specifying more than one SuggestParam, would you like to group the results by type, or mixed together and sorted? Default is true. If grouped, order of types matches the order of the suggestParams passed in.- Returns:
- a JSON formatted string
-
suggest
@Read(K_CONTENT) String suggest(String query, int maxItems, SuggestParam[] params, Boolean groupResults, Long[] allowList) Queries for content and returns a JSON formatted string to be used by autocomplete.- Parameters:
query- querymaxItems- max number of items to returnparams- list of information on what is being suggested and what format the results should be in. valid types are rules.groupResults- if specifying more than one SuggestParam, would you like to group the results by type, or mixed together and sorted? Default is true. If grouped, order of types matches the order of the suggestParams passed in.allowList- list of IDs that will be automatically added to returned results, filtered by query. Ignored if null or empty.- Returns:
- a JSON formatted string
-
adjustCounter
@Write(K_CONTENT) Integer adjustCounter(Long id, Integer value) throws InvalidContentException, PrivilegeException, InvalidTypeMaskException Adjust a rules based constant (counter) of type integer or double by the given adjustment value. This is useful for atomically incrementing or decrementing global constant counters. Note, that while this is useful for ensuring that read/update/write errors do not occur, the propagation of the update is the same as all constant updates. Also, no new version of the id is created -- it is the same id as before. (This is to prevent a million counter updates from creating a million separate content items.)- Parameters:
id- rule id of integer or double constantvalue- adjustment value (e.g., 1 to increase by 1, -1 to decrease by 1, etc.)- Returns:
- new value
- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this actionInvalidTypeMaskException- for any type error, including adjusting non-rule, non-constant, non-integer or -double.
-
adjustCounter
@Write(K_CONTENT) Double adjustCounter(Long id, Double value) throws InvalidContentException, PrivilegeException, InvalidTypeMaskException Adjust a rules based constant (counter) of type integer or double by the given adjustment value. This is useful for atomically incrementing or decrementing global constant counters. Note, that while this is useful for ensuring that read/update/write errors do not occur, the propagation of the update is the same as all constant updates. Also, no new version of the id is created -- it is the same id as before. (This is to prevent a million counter updates from creating a million separate content items.)- Parameters:
id- rule id of integer or double constantvalue- adjustment value (e.g., 1 to increase by 1, -1 to decrease by 1, etc.)- Returns:
- new value
- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this actionInvalidTypeMaskException- for any type error, including adjusting non-rule, non-constant, non-integer or -double.
-
moveKnowledgeCenter
@Write(K_CONTENT) void moveKnowledgeCenter(Long kcId, Long communityId) throws InvalidContentException, PrivilegeException, IllegalRecursionException, InvalidStateException Move a KC to a community. This method will also update the Content Object to reflect the changes of Type and Quota. If the move succeeds, the KC will be updated to a Community KC.- Parameters:
kcId- content id of the Knowledge Center to movecommunityId- id of community under which to move the Knowledge Center- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this actionIllegalRecursionException- if the destination is a descendant of the item you are movingInvalidStateException- Deprecated. If the move succeeds, the KC will be updated to a Community KC.
-
moveKnowledgeCenters
@Write(K_CONTENT) void moveKnowledgeCenters(Long[] kcIds, Long communityId) throws InvalidContentException, PrivilegeException, IllegalRecursionException, InvalidStateException Moves KCs to a community. This method will also update the Content Objects to reflect the changes to the columns of Type and Quota. If the move succeeds, the KCs will be updated to Community KCs.- Parameters:
kcIds- content ids of the Knowledge Centers to movecommunityId- id of community under which to move the Knowledge Centers- Throws:
InvalidContentException- if an invalid content item is referencedPrivilegeException- if the user does not have permission to take this actionIllegalRecursionException- if the destination is a descendant of the item you are movingInvalidStateException- Deprecated. If the move succeeds, the KC will be updated to a Community KC.
-
validateTypedValues
@Read(K_CONTENT) boolean validateTypedValues(TypedValue[] typedValues) throws InvalidDocumentException, InvalidFolderException, InvalidKnowledgeCenterException, InvalidCommunityException Validates given TypedValues. This method is free to throw an exception or to return false if any TypedValue passed is invalid for this engine. This engine supports: AppianType.DOCUMENT AppianType.FOLDER AppianType.KNOWLEDGE_CENTER AppianType.COMMUNITY AppianType.DOCUMENT_OR_FOLDER- Parameters:
typedValues-- Returns:
- true if valid, false if invalid
- Throws:
InvalidDocumentExceptionInvalidFolderExceptionInvalidKnowledgeCenterExceptionInvalidCommunityException
-
getIdByUuid
@Read(K_CONTENT) Long getIdByUuid(@ConvertWith(com.appiancorp.kougar.mapper.parameters.UuidParameterConverter.class) String uuid) Gets a content id by UUID. The version returned is NOT always the current version (ContentConstants.VERSION_CURRENT). Consider usinggetVersionId(String, Integer)instead.- Parameters:
uuid- content UUID- Returns:
- content id or
nullif the UUID is not found - See Also:
-
constants for System UUIDs
-
getIdsByUuid
@Read(K_CONTENT) Long[] getIdsByUuid(@ConvertWith(com.appiancorp.kougar.mapper.parameters.UuidParameterConverter[][].class) String[] uuids) Gets content ids by UUID. The versions returned are NOT always the current version (ContentConstants.VERSION_CURRENT).- Parameters:
uuids- content UUIDs- Returns:
- content ids or
nullitems for UUIDs not found - Throws:
NullPointerException- ifuuidsisnull- See Also:
-
constants for System UUIDs
-
getDatatypeIds
Gets the datatype ids that content ids map to. For example, a content object withContentConstants.TYPE_RULEtype andContentConstants.SUBTYPE_RULE_QUERYsubtype maps to aAppianType.QUERY_RULEdatatype- Parameters:
contentIds- content ids- Returns:
- datatype ids mappped to the content objects specified by the given content ids
-
getDocumentInputStream
@Read({K_CONTENT,OBJECT_STORE}) DocumentInputStream getDocumentInputStream(long id) throws InvalidContentException, AppianStorageException Opens a stream to a Document allowing for the caller to read its contents.- Parameters:
id- the content ID of the version of the document; usegetVersionId(Long, Integer)to obtain the id of the version of the document- Returns:
- DocumentInputStream containing the content of the document
- Throws:
InvalidContentException- if an invalid content item is referencedAppianStorageException- if an error occurs while opening the input stream for the file- See Also:
-
getDocumentInputStream
@Read({K_CONTENT,OBJECT_STORE}) DocumentInputStream[] getDocumentInputStream(long[] ids) throws InvalidContentException, AppianStorageException Opens streams to multiple Documents allowing the caller to read their contents.- Parameters:
ids- the content IDs of the versions of the documents; usegetVersionIds(Long, Integer[])to obtain the ids of the versions of the document- Returns:
- DocumentInputStream[] containing the contents of the documents
- Throws:
InvalidContentException- if an invalid content item is referencedAppianStorageException- if an error occurs while opening an input stream for a file- See Also:
-
uploadDocument
@Write({K_CONTENT,OBJECT_STORE}) ContentUploadOutputStream uploadDocument(Document doc, Integer unique) throws InvalidContentException, StorageLimitException, PrivilegeException, InsufficientNameUniquenessException, DuplicateUuidException, AppianStorageException Creates a document and provides an output stream to which the document's content should be written. The document is created using thecreateApproval(Content, Integer)API. The caller must write the document's data to the returned output stream and complete the upload by callingContentUploadOutputStream.close(). Invoking the stream's close method will calculate the size of the data written to the stream and save it as metadata for the document.- Parameters:
doc- The Document to create.unique- How unique the name must be.- Returns:
- The output stream to which the document's data should be written.
- Throws:
InvalidContentExceptionStorageLimitExceptionPrivilegeExceptionInsufficientNameUniquenessExceptionDuplicateUuidExceptionAppianStorageException
-
browsePaging(Long, ContentFilter, int, int, Integer, Integer)instead