Interface FolderService
- All Superinterfaces:
com.appiancorp.services.ContextSensitiveService,Service
This interface provides services for other applications using methods related to collaboration folders
Methods of service classes can all throw the unchecked exception
ServiceException if any
system-level error (for example, server failure) occurs, and will in general
throw a checked exception (InvalidXXXException) when an entity
to be retrieved is inaccessible, instead of returning null.
Exceptions to this paradigm (including the use of ResultList as
described below) are noted. All checked exceptions extend
AppianException.
It may be necessary to retrieve a subset of results as opposed to an entire
collection, and also to sort the subset by some property of the returned
object. "Paging" methods which return a
ResultPage are provided in certain
instances for this purpose. The ResultPage will contain the
sorted subset of results
(via Result.getResults()), and the
total number of items in the available result set
(via ResultPage.getAvailableItems()).
It may also be necessary to retrieve some results, even if all results
cannot be retrieved (for instance, some of the entities corresponding
to a list of entity IDs may no longer exist). Methods which return a
ResultList are provided for this
purpose. The Result.getResults()
method in this case will return all results which can be retrieved. In
addition, there will be a list of result codes
(ResultList.getResultCodes()) that
represent the successful retrieval of an entity, or, if the entity could
not be retrieved, the reason for the failure. See the CODE_XXX
constants in ResultList for details.
-
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.Fields inherited from interface com.appiancorp.services.ContextSensitiveService
SET_SERVICE_CONTEXT_METHOD_NAME -
Method Summary
Modifier and TypeMethodDescriptionvoidaddFoldersToFavorites(Long[] foids_) Deprecated.Adds multiple folders to the current user's "Favorites" list.voidaddFolderToFavorites(Long foid_) Deprecated.Adds a folder to the current user's "Favorites" list.Long[]approveChangesForFolder(Long foid_) Deprecated.Approves the creation or deletion of a folder (within a knowledge center for which changes require approval).Long[]approveChangesForFolders(Long[] foids_) Deprecated.Approves the creation or deletion of multiple folders (within a knowledge center for which changes require approval).createFolder(Folder folder_) Deprecated.Creates a new folderLong[]createFolders(Folder[] folders_) Deprecated.Creates multiple foldersvoiddeleteFolder(Long foid_) Deprecated.Deletes a foldervoiddeleteFolders(Long[] foids_) Deprecated.Deletes multiple foldersfindAdministratableFoldersPaging(String folderName_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.Finds folder for which the current user is an administrator (ie has an access level ofFolder.ACCESS_LEVEL_ADMINISTRATIVE) and which match the given folder name.findReadableFoldersPaging(String folderName_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.Finds folder for which the current user has read privileges or greater (ie an access level ofFolder.ACCESS_LEVEL_READ_ONLYorFolder.ACCESS_LEVEL_READ_WRITEorFolder.ACCESS_LEVEL_ADMINISTRATIVE) and which match the given folder name.findWritableFoldersPaging(String folderName_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.Finds folder for which the current user has author privileges or greater (ie an access level ofFolder.ACCESS_LEVEL_READ_WRITEorFolder.ACCESS_LEVEL_ADMINISTRATIVE) and which match the given folder name.intgetAccessLevelForFolder(Long foid_) Deprecated.Retrieves the current user's access level for a folderint[]getAccessLevelForFolders(Long[] foids_) Deprecated.Retrieves the current user's access levels for multiple foldersDocument[]getChildDocuments(Long foid_, Integer sortOrder_, String sortColumn_, int startIndex_, int scrollLength_) getChildDocumentsPaging(Long foid_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.Retrieves the direct child documents of a folderFolder[]getChildFolders(Long foid_, Integer sortOrder_, String sortColumn_, int startIndex_, int scrollLength_) getChildFoldersPaging(Long foid_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.Retrieves the direct child folders of a folderDeprecated.Long[]Deprecated.getDescendantDocumentsOfFolderPaging(Long folderId_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.Get a flat list of all documents in a given folder and its subfoldersgetDescendantDocumentsOfFoldersPaging(Long[] folderIds_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.Get a flat list of all documents in a list of folders and their subfoldersDocument[]getDocumentsByName(Long folderId, String name) Deprecated.This call will retrieve all documents of a given folder that have a given name.Folder[]getFavoriteFolders(Integer sortOrder_, String sortColumn_) getFavoriteFoldersPaging(int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.Retrieve all the folders that are in the current user's "Favorites" list.Deprecated.Gets information about a folderDeprecated.Long[]Deprecated.Folder[]getFolders(Long[] foids_) getFoldersList(Long[] folderIds_) Deprecated.Returns a ResultList containing error codes for each value supplied in the parameter andFolderobjects for each value which corresponds to a valid foldergetFoldersPaging(Long[] foids_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.Gets Information about multiple foldersgetFullPathStringToFolder(Long folderId_, String pathSeparator_) Deprecated.Gets the path to a folder through the Collaboration navigation tree.String[]getFullPathStringToFolders(Long[] folderIds_, String pathSeparator_) Deprecated.Gets the path to a list of folders through the Collaboration navigation tree.Deprecated.This call will retrieve the folder named ###my_process_views under the current users private knowledge center.Deprecated.This call will retrieve the folder named ###my_reports under the current users private knowledge center.Deprecated.This call will retrieve the folder named ###my_task_views under the current users private knowledge center.Folder[]getParentFolders(Long foid_) getParentFoldersPaging(Long foid_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.Retrieves the breadcrumbs to a folder (that is, the parent folders of a given folder, and also the folder itself).Deprecated.This call will retrieve the folder named ###personalized_task_views under the current users private knowledge center.getRoleMapForFolder(Long foid_) Deprecated.Retrieves theCollaborationRoleMapfor a given foldergetSystemFolderId(String name) Deprecated.getTreeViewForFolder(Long folderId_, int descendantDepth_) Deprecated.Get the tree pivoted at a particular folder.getTreeViewForFolders(Long[] folderIds_, int descendantDepth_) Deprecated.Get the trees pivoted at particular folders.getWritableFoldersForFolderPaging(Long folderId_, int startPosition_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.Retrieves a list of sub-folders of a folder, for which the current user has an access level ofFolder.ACCESS_LEVEL_READ_WRITEorFolder.ACCESS_LEVEL_ADMINISTRATIVEbooleanisFolderEmpty(Long foid_) Deprecated.Checks whether a folder contains any children (documents or sub-folders)voidrejectChangesForFolder(Long foid_) Deprecated.Rejects the creation or deletion of a folder (within a knowledge center for which changes require approval).voidrejectChangesForFolders(Long[] foids_) Deprecated.Rejects the creation or deletion of multiple folders (within a knowledge center for which changes require approval).voidremoveFolderFromFavorites(Long foid_) Deprecated.Removes a folder from the current user's "Favorites" listvoidremoveFoldersFromFavorites(Long[] foids_) Deprecated.Removes multiple folders from the current user's "Favorites" listvoidsetRoleMapForFolder(Long foid_, CollaborationRoleMap crm_) Deprecated.Set theCollaborationRoleMapfor a given folder If the role map is not set for a folder, by default it inherits the permissions specified in the role map from its parent knowledge centervoidsetSystemFolderId(String name, Long id) Deprecated.usecreateFolder(Folder)with a pre-populated UUIDsuggest(String query, int maxItems, SuggestParam[] params, Boolean groupResults) Deprecated.suggest(String query, int maxItems, SuggestParam[] params, Boolean groupResults, Long[] allowList) Deprecated.voidupdateFolder(Folder folder_) Deprecated.Updates a foldervoidupdateFolders(Folder[] folders_) Deprecated.Updates the information stored about multiple foldersvoidupdateForumForFolder(Folder folder_) Deprecated.Updates the forum ID associated with a foldervoidupdateForumForFolders(Folder[] folders_) Deprecated.Updates the forums associated with an array of foldersMethods inherited from interface com.appiancorp.services.ContextSensitiveService
setServiceContext
-
Field Details
-
getFolder$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getFolders$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getFoldersPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
createFolder$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
createFolders$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
updateFolder$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
updateFolders$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
updateForumForFolder$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
updateForumForFolders$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
deleteFolder$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
deleteFolders$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
approveChangesForFolder$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
approveChangesForFolders$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
rejectChangesForFolder$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
rejectChangesForFolders$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
isFolderEmpty$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getParentFolders$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getParentFoldersPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getChildFolders$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getChildFoldersPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getWritableFoldersForFolderPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getChildDocuments$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getChildDocumentsPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getFavoriteFolders$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getFavoriteFoldersPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
addFolderToFavorites$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
addFoldersToFavorites$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
removeFolderFromFavorites$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
removeFoldersFromFavorites$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAccessLevelForFolder$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getAccessLevelForFolders$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
setRoleMapForFolder$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getRoleMapForFolder$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getTreeViewForFolder$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getTreeViewForFolders$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getDescendantDocumentsOfFolderPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getDescendantDocumentsOfFoldersPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
findAdministratableFoldersPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
findWritableFoldersPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
findReadableFoldersPaging$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getFullPathStringToFolder$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getFullPathStringToFolders$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getFoldersList$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getSystemFolderId$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
setSystemFolderId$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getMyTaskViewFolder$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getMyProcessViewFolder$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getMyReportsFolder$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getPersonalizedTaskViewsFolder$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getDocumentsByName$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getContentIdForFolderId$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getContentIdsForFolderIds$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getFolderIdForContentId$UPDATES
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
-
getFolderIdsForContentIds$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:
-
-
Method Details
-
getFolder
@Read(K_COLLAB) Folder getFolder(Long foid_) throws InvalidFolderException, InvalidUserException, PrivilegeException Deprecated.Gets information about a folder- Parameters:
foid_- the unique ID of the folder- Returns:
- a
Folderobject representing the folder with unique ID - Throws:
InvalidFolderException- if no folder with the given ID existsInvalidUserException- if user calling this method is invalidPrivilegeException- if the current user's access level to the folder is not one ofFolder.ACCESS_LEVEL_READ_ONLY,Folder.ACCESS_LEVEL_READ_WRITEorFolder.ACCESS_LEVEL_ADMINISTRATIVEServiceException- if any system-level error occurs
-
getFolders
@Deprecated @Read(K_COLLAB) Folder[] getFolders(Long[] foids_) throws InvalidFolderException, InvalidUserException, PrivilegeException Gets information about multiple folders- Parameters:
foids_- a list of unique IDs of the folders- Returns:
- an array of
Folderobjects representing the folders with unique IDs - Throws:
InvalidFolderException- if at least one of the IDs does not refer to an existing folderInvalidUserException- if the user calling this method is invalidPrivilegeException- if the current user's access level to one of the folders is not one ofFolder.ACCESS_LEVEL_READ_ONLY,Folder.ACCESS_LEVEL_READ_WRITEorFolder.ACCESS_LEVEL_ADMINISTRATIVEServiceException- if any system-level error occurs
-
getFoldersPaging
@Read(K_COLLAB) ResultPage getFoldersPaging(Long[] foids_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidFolderException, InvalidUserException, PrivilegeException Deprecated.Gets Information about multiple folders- Parameters:
foids_- a list of unique IDs of the foldersstartIndex_- 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 theSORT_BY_XXXconstants inFolder.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
Folderobjects representing the folders with the unique IDs - Throws:
InvalidFolderException- if at least one of the IDs does not correspond to a valid folderInvalidUserException- if the user calling this method is invalidPrivilegeException- if the current user's access level to one of the folders is not one ofFolder.ACCESS_LEVEL_READ_ONLY,Folder.ACCESS_LEVEL_READ_WRITEorFolder.ACCESS_LEVEL_ADMINISTRATIVEServiceException- if any system-level error occurs
-
createFolder
@Write(K_COLLAB) Long createFolder(Folder folder_) throws InvalidUserException, PrivilegeException, InvalidKnowledgeCenterException Deprecated.Creates a new folderNOTE: The only fields that are actually used in the create are
name,searchable,knowledgeCenterIdandparentFolderId. All other fields are ignored.- Parameters:
folder_- aFolderobject which should contain all of the information required to create a valid folder. Minimum required fields:name,searchable,knowledgeCenterId- Returns:
- the ID of the created folder
- Throws:
InvalidUserException- if the user calling this method is invalidPrivilegeException- if the current user's access level to the knowledge center in which this folder is to be created is not one ofKnowledgeCenter.ACCESS_LEVEL_READ_WRITEorKnowledgeCenter.ACCESS_LEVEL_ADMINISTRATIVEInvalidKnowledgeCenterException- if theknowledgeCenterIdfield of the folder does not refer to a valid knowledge centerServiceException- if any system-level error occurs
-
createFolders
@Write(K_COLLAB) Long[] createFolders(Folder[] folders_) throws InvalidUserException, PrivilegeException, InvalidKnowledgeCenterException Deprecated.Creates multiple foldersNOTE: The only fields that are actually used in the create are
name,searchable,knowledgeCenterIdandparentFolderId. All other fields are ignored.- Parameters:
folders_- an array ofFolderobjects which should contain all of the information required to create valid folders. Minimum required fields:name,searchable,knowledgeCenterId- Throws:
InvalidUserException- if the user calling this method is invalidPrivilegeException- if the current user's access level to the knowledge center in which one of the folders is to be created is not one ofKnowledgeCenter.ACCESS_LEVEL_READ_WRITEorKnowledgeCenter.ACCESS_LEVEL_ADMINISTRATIVEInvalidKnowledgeCenterException- if theknowledgeCenterIdfield of one of the folders does not refer to a valid knowledge centerServiceException- if any system-level error occurs
-
updateFolder
@Write(K_COLLAB) void updateFolder(Folder folder_) throws InvalidFolderException, InvalidUserException, PrivilegeException Deprecated.Updates a folder- Parameters:
folder_- aFolderobject which should contain all of the information required to update a folder Minimum required fields:nameandid. The fields that can be updated using this call arename,idandforum. All other fields will be ignored.- Throws:
InvalidFolderException- if the folder does not existInvalidUserException- if the user calling this method is invalidPrivilegeException- if the current user's access level to the folder is not one ofFolder.ACCESS_LEVEL_READ_WRITEorFolder.ACCESS_LEVEL_ADMINISTRATIVEServiceException- if any system-level error occurs
-
updateFolders
@Write(K_COLLAB) void updateFolders(Folder[] folders_) throws InvalidFolderException, InvalidUserException, PrivilegeException Deprecated.Updates the information stored about multiple folders- Parameters:
folders_- an array ofFolderobjects, each of which should contain all of the information required to update the folder. Minimum required fields:nameandid. The fields that can be updated using this call arename,idandforum. All other fields will be ignored.- Throws:
InvalidFolderException- if one of the folders does not existInvalidUserException- if the user calling this method is invalidPrivilegeException- if the current user's access level to one of the folders is not one ofFolder.ACCESS_LEVEL_READ_WRITEorFolder.ACCESS_LEVEL_ADMINISTRATIVEServiceException- if any system-level error occurs
-
updateForumForFolder
@Write(K_COLLAB) void updateForumForFolder(Folder folder_) throws InvalidFolderException, PrivilegeException Deprecated.Updates the forum ID associated with a folder- Parameters:
folder_- aFolderobject which should contain the updated forum ID and the minimum required fields to update a folder. Minimum required fields:id. The fields that can be updated using this call areidandforum. All other fields will be ignored. Ifforumis set tonull, this call will remove any forum associations.- Throws:
InvalidFolderException- if the folder does not existPrivilegeException- if 1) the current user does not have access to the folder (his access leve is not one ofFolder.ACCESS_LEVEL_READ_ONLY,Folder.ACCESS_LEVEL_READ_WRITEorFolder.ACCESS_LEVEL_ADMINISTRATIVE) or 2) the current user is not an administrator of the folder and a forum currently exists for the folderServiceException- if any system-level error occurs
-
updateForumForFolders
@Write(K_COLLAB) void updateForumForFolders(Folder[] folders_) throws InvalidFolderException, PrivilegeException Deprecated.Updates the forums associated with an array of folders- Parameters:
folders_- an array ofFolderobjects which should contain the updated forum information and the minimum required fields for updating a folder. Minimum required fields:id. The fields that can be updated using this call areidandforum. All other fields will be ignored. Ifforumis set tonull, this call will remove any forum associations.- Throws:
InvalidFolderException- if any of the folders does not existPrivilegeException- if 1) the current user does not have access to one of the folders (his access leve is not one ofFolder.ACCESS_LEVEL_READ_ONLY,Folder.ACCESS_LEVEL_READ_WRITEorFolder.ACCESS_LEVEL_ADMINISTRATIVE) or 2) the current user is not an administrator of one of the folders and a forum currently exists for the folderServiceException- if any system-level error occurs
-
deleteFolder
@Write(K_COLLAB) void deleteFolder(Long foid_) throws InvalidFolderException, InvalidUserException, NotEmptyException, PrivilegeException Deprecated.Deletes a folder- Parameters:
foid_- the unique ID of the folder to be deleted- Throws:
InvalidFolderException- if theFolderspecified byfoid_does not existInvalidUserException- if the user calling this method is invalidNotEmptyException- if the folders contains documents or sub-foldersPrivilegeException- if the currentUseris not an administrator or the creator of the folder.ServiceException- if any system-level error occurs
-
deleteFolders
@Write(K_COLLAB) void deleteFolders(Long[] foids_) throws InvalidFolderException, InvalidUserException, NotEmptyException, PrivilegeException Deprecated.Deletes multiple folders- Parameters:
foids_- a list containing the unique IDs of theFolderobjects to be deleted- Throws:
InvalidFolderException- if any of the folders specified byfoids_do not existInvalidUserException- if the user calling this method is invalidNotEmptyException- if any of the folders contain documents or sub-foldersPrivilegeException- if the currentUseris not an administrator or creator of all of the foldersServiceException- if any system-level error occurs
-
approveChangesForFolder
@Write(K_COLLAB) Long[] approveChangesForFolder(Long foid_) throws InvalidUserException, InvalidDataFormatException, PrivilegeException, InvalidFolderException Deprecated.Approves the creation or deletion of a folder (within a knowledge center for which changes require approval). To approve creation of a folder, pass the ID of the folder. To approve deletion of a folder, pass (-1 * (folder ID)).- Parameters:
foid_- the unique ID of the folder, or the negation of the ID of the folder, depending on whether approval is being done for creation or deletion- Returns:
- the IDs of the folders (the current folder or any of its sub-folders) that could not be deleted because they are not empty (they contain documents or subfolders).
- Throws:
InvalidUserException- if the user calling this method is invalidPrivilegeException- if the currentUseris not an administrator of theKnowledgeCenterto which this folder belongsInvalidFolderException- if theFolderdoes not existInvalidDataFormatException- if the folder id provided isnullServiceException- if any system-level error occurs
-
approveChangesForFolders
@Write(K_COLLAB) Long[] approveChangesForFolders(Long[] foids_) throws InvalidUserException, PrivilegeException, InvalidFolderException, InvalidDataFormatException Deprecated.Approves the creation or deletion of multiple folders (within a knowledge center for which changes require approval). To approve creation of a folder, pass the ID of the folder. To approve deletion of a folder, pass (-1 * (folder ID)).- Parameters:
foids_- a list containing the unique IDs of the folders, or the negation of the IDs of the folders, depending on whether approval is being done for creation or deletion- Returns:
- the IDs of the folders (any of the folders in
foids_or any of their subfolders) which could not be deleted because they are not empty (they contain documents or subfolders) - Throws:
InvalidUserException- if the user calling this method is invalidPrivilegeException- if the currentUseris not an administrator of theKnowledgeCenterobjects to which these folders belongInvalidFolderException- if any of theFolderobjects specified byfoids_do not existInvalidDataFormatException- if one or more folder ids provided arenullServiceException- if any system-level error occurs
-
rejectChangesForFolder
@Write(K_COLLAB) void rejectChangesForFolder(Long foid_) throws InvalidUserException, PrivilegeException, InvalidFolderException, InvalidDataFormatException, NotEmptyException Deprecated.Rejects the creation or deletion of a folder (within a knowledge center for which changes require approval). To reject creation of a folder, pass the ID of the folder. To reject deletion of a folder, pass (-1 * (folder ID)).- Parameters:
foid_- the unique ID of the folder, or the negation of the ID of the folder, depending on whether rejection is being done for creation or deletion- Throws:
InvalidUserException- if the user calling this method is invalidPrivilegeException- if the currentUseris not an administrator of theKnowledgeCenterto which this folder belongsInvalidFolderException- if theFolderspecified byfoid_does not existNotEmptyException- if theFolderis not empty, and the change is a creation (meaning the rollback would delete the folder)InvalidDataFormatException- if the folder id provided isnullServiceException- if any system-level error occurs
-
rejectChangesForFolders
@Write(K_COLLAB) void rejectChangesForFolders(Long[] foids_) throws InvalidUserException, PrivilegeException, InvalidFolderException, InvalidDataFormatException, NotEmptyException Deprecated.Rejects the creation or deletion of multiple folders (within a knowledge center for which changes require approval). To reject creation of a folder, pass the ID of the folder. To reject deletion of a folder, pass (-1 * (folder ID)).- Parameters:
foids_- a list containing the unique IDs of the folders, or the negation of the IDs of the folders, depending on whether rejection is being done for creation or deletion- Throws:
InvalidUserException- if the user calling this method is invalidPrivilegeException- if the currentUseris not an administrator of theKnowledgeCenterobjects to which these folders belongInvalidFolderException- if any of the folders specified byfoids_does not existNotEmptyException- if any of the folders is not empty, and the change is a creation (meaning the rollback would delete the folder)InvalidDataFormatException- if one or more folder ids provided arenullServiceException- if any system-level error occurs
-
isFolderEmpty
Deprecated.Checks whether a folder contains any children (documents or sub-folders)- Parameters:
foid_- the unique ID of the folder- Returns:
- true if the
Folderis empty, false otherwise - Throws:
InvalidFolderException- if the folder specified byfoid_does not existServiceException- if any system-level error occurs
-
getParentFolders
Deprecated.Retrieves the breadcrumbs to a folder (that is, the parent folders of a given folder, and also the folder itself). The top level parent will be returned in the first index of the array; the folder corresponding tofoid_will be returned in the last index of the array. If the folder has no parents, an array of length 1, containing the folder corresponding tofoid_will be returned.- Parameters:
foid_- the unique ID of the folder whose parents are to be retrieved- Returns:
- the parent folders of the folder with the given ID, and also the
folder referenced by
foid_ - Throws:
InvalidFolderException- if the folder specified byfoid_does not existServiceException- if any system-level error occurs
-
getParentFoldersPaging
@Read(K_COLLAB) ResultPage getParentFoldersPaging(Long foid_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidFolderException Deprecated.Retrieves the breadcrumbs to a folder (that is, the parent folders of a given folder, and also the folder itself). If the folder has no parents, an array of length 1, containing the folder corresponding tofoid_will be returned.- Parameters:
foid_- the unique ID of the folder whose parents are to be retrievedstartIndex_- 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 theSORT_BY_XXXconstants inFolder.sortOrder_- the order in which to sort the results. This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- a
ResultPagecontaining an array ofFolderobjects representing the parents of the specified folder,and also the folder referenced byfoid_ - Throws:
InvalidFolderException- if the folder specified byfoid_does not existServiceException- if any system-level error occurs
-
getChildFolders
@Deprecated @Read(K_COLLAB) Folder[] getChildFolders(Long foid_, Integer sortOrder_, String sortColumn_, int startIndex_, int scrollLength_) throws InvalidFolderException, PrivilegeException Deprecated.Retrieves the direct child folders of a folder- Parameters:
foid_- the unique ID of the parent foldersortOrder_- the order in which to sort the results. This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDINGsortColumn_- the column by which the results will be sorted. This is one of theSORT_COLUMN_XXXproperties inFolderstartIndex_- the index into the collection of total results at which to start. Negative numbers are treated as zeros.scrollLength_- the number of results to return. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.- Returns:
- the direct child folders of the folder specified by
foid_ - Throws:
InvalidFolderException- if the folder specified byfoid_does not existPrivilegeException- if the currentUserdoes not have at least read access to the folder and its children.
-
getChildFoldersPaging
@Read(K_COLLAB) ResultPage getChildFoldersPaging(Long foid_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidFolderException, InvalidUserException, PrivilegeException Deprecated.Retrieves the direct child folders of a folder- Parameters:
foid_- the unique ID of the parent folderstartIndex_- 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 theSORT_BY_XXXconstants inFolder.sortOrder_- the order in which to sort the results. This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- a
ResultPagecontaining an array ofFolderobjects representing the child folders of the folder - Throws:
InvalidFolderException- if the folder specified byfoid_does not existInvalidUserException- if the user calling this method is invalidPrivilegeException- if currentUserdoes not have at least read access to the folder and its children.ServiceException- if any system-level error occurs
-
getWritableFoldersForFolderPaging
@Read(K_COLLAB) ResultPage getWritableFoldersForFolderPaging(Long folderId_, int startPosition_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidUserException, PrivilegeException Deprecated.Retrieves a list of sub-folders of a folder, for which the current user has an access level ofFolder.ACCESS_LEVEL_READ_WRITEorFolder.ACCESS_LEVEL_ADMINISTRATIVE- Parameters:
folderId_- the unique ID of the folder whose sub-folders are to be retrievedstartPosition_- 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 theSORT_BY_XXXconstants inFolder.sortOrder_- the order in which to sort the results. This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- a
ResultPagecontaining an array ofFolderobjects which represent the writable folders for a user - Throws:
InvalidUserException- if the user calling this method is invalidPrivilegeException- if currentUserdoes not have at least read access to the folder and its children.ServiceException- if any system-level error occurs
-
getChildDocuments
@Deprecated @Read(K_COLLAB) Document[] getChildDocuments(Long foid_, Integer sortOrder_, String sortColumn_, int startIndex_, int scrollLength_) throws InvalidFolderException, InvalidUserException, PrivilegeException Deprecated.Retrieves the direct child documents of a folder- Parameters:
foid_- the unique ID of the folder whose child documents are to be retrievedsortOrder_- the order in which to sort the results. This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDINGsortColumn_- the column by which the results will be sorted. This is one of theSORT_COLUMN_XXXproperties inDocumentstartIndex_- the index into the collection of total results at which to start. Negative numbers are treated as zeros.scrollLength_- the number of results to return. UseConstants.COUNT_ALLto return the entire collection, but this is STRONGLY discouraged.- Throws:
InvalidFolderException- if the folder specified byfoid_does not existInvalidUserException- if the user calling this method is invalidPrivilegeException- if currentUserdoes not have at least read access to the folder.ServiceException- if any system-level error occurs
-
getChildDocumentsPaging
@Read(K_COLLAB) ResultPage getChildDocumentsPaging(Long foid_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidFolderException, InvalidDocumentException, PrivilegeException, InvalidKnowledgeCenterException Deprecated.Retrieves the direct child documents of a folder- Parameters:
foid_- the unique ID of the folder whose child documents are to be retrievedstartIndex_- 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 theSORT_BY_XXXconstants inDocumentsortOrder_- the order in which to sort the results. This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- a
ResultPagecontaining an array ofDocumentobjects representing the child documents of the folder - Throws:
InvalidFolderException- if the folder specified byfoid_does not existPrivilegeException- if currentUserdoes not have at least read access to the folder.ServiceException- if any system-level error occursInvalidDocumentExceptionInvalidKnowledgeCenterException
-
getFavoriteFolders
@Deprecated @Read(K_COLLAB) Folder[] getFavoriteFolders(Integer sortOrder_, String sortColumn_) throws InvalidUserException Retrieve all the folders that are in the current user's "Favorites" list.- Parameters:
sortOrder_- the order in which to sort the returned list of folders. This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDINGsortColumn_- the field of theFolderby which to sort the returned list of folders. This is one ofSORT_COLUMN_XXXinFolder- Returns:
- the current user's favorite folders
- Throws:
InvalidUserException- if the user calling this method is invalidServiceException- if any system-level error occurs
-
getFavoriteFoldersPaging
@Read(K_COLLAB) ResultPage getFavoriteFoldersPaging(int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidUserException Deprecated.Retrieve all the folders that are in the current user's "Favorites" list.- 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 theSORT_BY_XXXconstants inFolder.sortOrder_- the order in which to sort the results. This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- a
ResultPagecontaining an array of folders in the current user's "Favorites" list - Throws:
InvalidUserException- if the user calling this method is invalidServiceException- if any system-level error occurs
-
addFolderToFavorites
@Write(K_COLLAB) void addFolderToFavorites(Long foid_) throws InvalidUserException, InvalidFolderException Deprecated.Adds a folder to the current user's "Favorites" list.- Parameters:
foid_- the unique ID of the folder to be added- Throws:
InvalidFolderException- if theFolderspecified byfoid_does not existInvalidUserException- if the user calling this method is invalidServiceException- if any system-level error occurs
-
addFoldersToFavorites
@Write(K_COLLAB) void addFoldersToFavorites(Long[] foids_) throws InvalidUserException, InvalidFolderException, InvalidDataFormatException Deprecated.Adds multiple folders to the current user's "Favorites" list.- Parameters:
foids_- a list of unique IDs representing the folders to be added- Throws:
InvalidUserException- if the user calling this method is invalidInvalidFolderException- if one of the folder IDs does not correspond to a valid folderServiceException- if any system-level error occursInvalidDataFormatException
-
removeFolderFromFavorites
@Write(K_COLLAB) void removeFolderFromFavorites(Long foid_) throws InvalidUserException, InvalidFolderException Deprecated.Removes a folder from the current user's "Favorites" list- Parameters:
foid_- the unique ID of the folder to be removed- Throws:
InvalidUserException- if the user calling this method is invalidInvalidFolderException- if the folder specified byfoid_does not existServiceException- if any system-level error occurs
-
removeFoldersFromFavorites
@Write(K_COLLAB) void removeFoldersFromFavorites(Long[] foids_) throws InvalidUserException, InvalidFolderException, InvalidDataFormatException Deprecated.Removes multiple folders from the current user's "Favorites" list- Parameters:
foids_- a list of unique IDs for the folders to be removed- Throws:
InvalidUserException- if the user calling this method is invalidInvalidFolderException- if theFolderspecified byfoid_does not existServiceException- if any system-level error occursInvalidDataFormatException
-
getAccessLevelForFolder
Deprecated.Retrieves the current user's access level for a folder- Parameters:
foid_- the unique ID of the folder- Returns:
- The current user's access level for the folder. This will be one of:
- Throws:
InvalidFolderException- if the folder specified byfoid_does not existServiceException- if any system-level error occurs
-
getAccessLevelForFolders
Deprecated.Retrieves the current user's access levels for multiple folders- Parameters:
foids_- a list of unique IDs of the folders- Returns:
- The current user's access levels for the folders. Each access level will be one of:
- Throws:
InvalidFolderException- if the folder specified byfoid_does not existServiceException- if any system-level error occurs
-
setRoleMapForFolder
@Write(K_COLLAB) void setRoleMapForFolder(Long foid_, CollaborationRoleMap crm_) throws InvalidFolderException, InvalidGroupException, InvalidUserException, PrivilegeException Deprecated.Set theCollaborationRoleMapfor a given folder If the role map is not set for a folder, by default it inherits the permissions specified in the role map from its parent knowledge center- Parameters:
foid_- the unique ID for a foldercrm_- theCollaborationRoleMapobject containing the new roles to set- Throws:
InvalidFolderException- if the folder specified byfoid_does not existInvalidGroupException- if any group in the role map is invalidInvalidUserException- if any user in the role map is invalidPrivilegeException- if the current user is not an administrator of the given folderServiceException- if any system-level error occurs
-
getRoleMapForFolder
@Read(K_COLLAB) CollaborationRoleMap getRoleMapForFolder(Long foid_) throws InvalidFolderException, PrivilegeException Deprecated.Retrieves theCollaborationRoleMapfor a given folder- Parameters:
foid_- the unique ID for a folder- Returns:
- the
CollaborationRoleMapobject containing the roles for the folder - Throws:
PrivilegeException- if the current user does not have enough privileges to view the role mapInvalidFolderException- if the folder specified byfoid_does not existServiceException- if any system-level error occurs
-
getTreeViewForFolder
@Read(K_COLLAB) TreePivot getTreeViewForFolder(Long folderId_, int descendantDepth_) throws InvalidUserException, PrivilegeException, InvalidFolderException Deprecated.Get the tree pivoted at a particular folder. Each node in the tree will have itsdataproperty populated with the local object type value of the local object that it represents (eg, forDocumentnodes, thedataproperty of the node will be populated withLocalObjectTypeMapping.TYPE_DOCUMENT)- Parameters:
folderId_- the unique ID for aFolderdescendantDepth_- the number of levels below the root that should be returned. UseConstants.COUNT_ALLto return all levels below the root.- Returns:
- the
TreePivotobject which represents a tree whose root is theFolderspecified byfolderId_. The data in theTreePivottree areDocumentandFolderobjects. The breadcrumbs contained in theTreePivotgo all the way up to the community - Throws:
InvalidUserException- if the user calling this method is invalidPrivilegeException- if the currentUserdoes not have at least read access to all the returned folders.InvalidFolderException- if the folder specified byfoid_does not existServiceException- if any system-level error occurs
-
getTreeViewForFolders
@Read(K_COLLAB) TreePivot[] getTreeViewForFolders(Long[] folderIds_, int descendantDepth_) throws InvalidUserException, PrivilegeException, InvalidFolderException Deprecated.Get the trees pivoted at particular folders. Each node in a tree will have itsdataproperty populated with the local object type value of the local object that it represents (eg, forDocumentnodes, thedataproperty of the node will be populated withLocalObjectTypeMapping.TYPE_DOCUMENT)- Parameters:
folderIds_- an array of unique IDs which each represent aFolderdescendantDepth_- the number of levels below the root that should be returned for each tree. UseConstants.COUNT_ALLto return all levels below the root.- Returns:
- an array of
TreePivotobjects, each of which represents a tree whose root is theFolderspecified by a folder ID - Throws:
InvalidUserException- if the user calling this method is invalidPrivilegeException- if the currentUserdoes not have at least read access to all root folders and all other returned folders.InvalidFolderException- if theFolderspecified byfoid_does not existServiceException- if any system-level error occurs
-
getDescendantDocumentsOfFolderPaging
@Read(K_COLLAB) ResultPage getDescendantDocumentsOfFolderPaging(Long folderId_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidUserException, InvalidFolderException Deprecated.Get a flat list of all documents in a given folder and its subfolders- Parameters:
folderId_- the unique ID of theFolderstartIndex_- 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 theSORT_BY_XXXconstants inDocument.sortOrder_- the order in which to sort the results. This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- a ResultPage containing an array of
Documentobjects representing the document descendants of the folder with IDfolderId_ - Throws:
InvalidUserException- if the user calling this method is invalidInvalidFolderException- if theFolderspecified byfoid_does not existServiceException- if any system-level error occurs
-
getDescendantDocumentsOfFoldersPaging
@Read(K_COLLAB) ResultPage getDescendantDocumentsOfFoldersPaging(Long[] folderIds_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) throws InvalidUserException, InvalidFolderException Deprecated.Get a flat list of all documents in a list of folders and their subfolders- Parameters:
folderIds_- a list of the unique IDs of the foldersstartIndex_- 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 theSORT_BY_XXXconstants inDocument.sortOrder_- the order in which to sort the results. This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- a ResultPage containing an array of
Documentobjects representing the document descendants of the folders - Throws:
InvalidUserException- if the user calling this method is invalidInvalidFolderException- if the folder specified byfoid_does not existServiceException- if any system-level error occurs
-
findAdministratableFoldersPaging
@Read(K_COLLAB) ResultPage findAdministratableFoldersPaging(String folderName_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.Finds folder for which the current user is an administrator (ie has an access level ofFolder.ACCESS_LEVEL_ADMINISTRATIVE) and which match the given folder name.- Parameters:
folderName_- the folder name to be matched. A folder will match if its name contains the value offolderName_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 theSORT_BY_XXXconstants inFolder.sortOrder_- the order in which to sort the results. This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- a
ResultPagecontaining an array ofFolderobjects which match the given criteria - Throws:
ServiceException- if any system-level error occurs
-
findWritableFoldersPaging
@Read(K_COLLAB) ResultPage findWritableFoldersPaging(String folderName_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.Finds folder for which the current user has author privileges or greater (ie an access level ofFolder.ACCESS_LEVEL_READ_WRITEorFolder.ACCESS_LEVEL_ADMINISTRATIVE) and which match the given folder name.- Parameters:
folderName_- the folder name to be matched. AFolderwill match if its name contains the value offolderName_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 theSORT_BY_XXXconstants inFolder.sortOrder_- the order in which to sort the results. This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- a
ResultPagecontaining an array ofFolderobjects which match the given criteria - Throws:
ServiceException- if any system-level error occurs
-
findReadableFoldersPaging
@Read(K_COLLAB) ResultPage findReadableFoldersPaging(String folderName_, int startIndex_, int batchSize_, Integer sortProperty_, Integer sortOrder_) Deprecated.Finds folder for which the current user has read privileges or greater (ie an access level ofFolder.ACCESS_LEVEL_READ_ONLYorFolder.ACCESS_LEVEL_READ_WRITEorFolder.ACCESS_LEVEL_ADMINISTRATIVE) and which match the given folder name.- Parameters:
folderName_- the folder name to be matched. AFolderwill match if its name contains the value offolderName_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 theSORT_BY_XXXconstants inFolder.sortOrder_- the order in which to sort the results. This is one ofConstants.SORT_ORDER_ASCENDINGorConstants.SORT_ORDER_DESCENDING- Returns:
- a
ResultPagecontaining an array ofFolderobjects which match the given criteria - Throws:
ServiceException- if any system-level error occurs
-
getFullPathStringToFolder
@Read(K_COLLAB) String getFullPathStringToFolder(Long folderId_, String pathSeparator_) throws InvalidUserException, PrivilegeException, InvalidFolderException Deprecated.Gets the path to a folder through the Collaboration navigation tree. For example, if folder 'mySubfolder' exists within folder 'myFolder', within knowledge center 'myKC', within community 'myCommunity', the return value will be "myCommunity/myKC/myFolder/mySubfolder", assuming apathSeparator_of "/". If theFolderexisted within a privateKnowledgeCenter, the return value would be "/myKC/myFolder/mySubfolder".- Parameters:
folderId_- the unique ID of the folderpathSeparator_- the string which will be used to separate entries in the path- Returns:
- the full path to the folder
- Throws:
InvalidUserException- if the user calling this method is invalidPrivilegeException- if the currentUserdoes not have at least read access to the folderInvalidFolderException- if the folder specified byfolderId_does not existServiceException- if any system-level error occurs
-
getFullPathStringToFolders
@Read(K_COLLAB) String[] getFullPathStringToFolders(Long[] folderIds_, String pathSeparator_) throws InvalidUserException, PrivilegeException, InvalidFolderException Deprecated.Gets the path to a list of folders through the Collaboration navigation tree. For example, if folder 'mySubfolder' exists within folder 'myFolder', within knowledge center 'myKC', within community 'myCommunity', the return value for that folder will be "/myCommunity/myKC/myFolder/mySubfolder", assuming apathSeparator_of "/". If the folder existed within a private knowledge center, the return value would be "/myKC/myFolder/mySubfolder".- Parameters:
folderIds_- the unique IDs of the folderspathSeparator_- the string which will be used to separate entries in the paths- Returns:
- the full paths to the folders
- Throws:
InvalidUserException- if the user calling this method is invalidPrivilegeException- if the currentUserdoes not have at least read access to all the folders passed to this methodInvalidFolderException- if any offolderIdsdoes not refer to a valid folderServiceException- if any system-level error occurs
-
getFoldersList
Deprecated.Returns a ResultList containing error codes for each value supplied in the parameter andFolderobjects for each value which corresponds to a valid folder- Parameters:
folderIds_- unique Ids of folders to retrieve- Returns:
- an
Integerarray of result codes and an array ofFolderobjects for all valid folders. The possible result codes are any of theCODE_XXXorCOLLAB_CODE_XXXconstants inResultList - Throws:
InvalidDataFormatException- if null is passed in
-
getSystemFolderId
Deprecated.This is a small wrapper on Content's getSystemId, but returns the content id as a folder id.- Parameters:
name- A case-insensitive system name, currently one of: image_folder_id leader_message_channel_image_folder_id priority_image_folder_id indicator_image_folder_id- Returns:
- the id of the folder.
- Throws:
InvalidFolderException- if the string is not recognized.
-
setSystemFolderId
@Deprecated @Write(K_COLLAB) void setSystemFolderId(String name, Long id) throws InvalidFolderException Deprecated.usecreateFolder(Folder)with a pre-populated UUIDStores and associates the specifiedidvalue with the specifiednamekey.- Parameters:
name- A case-insensitive system name.id- The folder id.- Throws:
InvalidFolderException- if the string is not recognized.
-
getMyTaskViewFolder
Deprecated.This call will retrieve the folder named ###my_task_views under the current users private knowledge center. Note that the key ###my_task_views is used as this folder name to support internationalization. (See private kc for details). If the current user doesnt have either a private kc or a my task view folder, one or both of these enitities will be created in k and the new folder returned. Therefore this method has the potential for updates.- Returns:
- The
Folder.
-
getMyProcessViewFolder
Deprecated.This call will retrieve the folder named ###my_process_views under the current users private knowledge center. Note that the key ###my_process_views is used as this folder name to support internationalization. (See private kc for details). If the current user doesnt have either a private kc or a my process view folder, one or both of these enitities will be created in k and the new folder returned. Therefore this method has the potential for updates.- Returns:
- The
Folder.
-
getMyReportsFolder
Deprecated.This call will retrieve the folder named ###my_reports under the current users private knowledge center. Note that the key ###my_reports is used as this folder name to support internationalization. (See private kc for details). If the current user doesnt have either a private kc or a my reports folder, one or both of these enitities will be created in k and the new folder returned. Therefore this method has the potential for updates.- Returns:
- The
Folder.
-
getPersonalizedTaskViewsFolder
Deprecated.This call will retrieve the folder named ###personalized_task_views under the current users private knowledge center. Note that the key ###personalized_task_views is used as this folder name to support internationalization. (See private kc for details). If the current user doesnt have either a private kc or a personalized.task.views folder, one or both of these enitities will be created in k and the new folder returned. Therefore this method has the potential for updates.- Returns:
- The
Folder.
-
getDocumentsByName
Deprecated.This call will retrieve all documents of a given folder that have a given name.- Parameters:
folderId- The unique ID of the foldername- The name of the documents that are to be retrieved- Returns:
- An array of
Documents
-
getContentIdForFolderId
Deprecated. -
getContentIdsForFolderIds
Deprecated. -
getFolderIdForContentId
Deprecated. -
getFolderIdsForContentIds
Deprecated. -
suggest
@Read(K_COLLAB) String suggest(String query, int maxItems, SuggestParam[] params, Boolean groupResults) Deprecated.- Parameters:
query-maxItems-params- list of information on what is being suggested and what format the results should be in. valid types are folder, document.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_COLLAB) String suggest(String query, int maxItems, SuggestParam[] params, Boolean groupResults, Long[] allowList) Deprecated.- Parameters:
query-maxItems-params- list of information on what is being suggested and what format the results should be in. valid types are folder, document.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
-
ContentServiceinstead.