ContentService
instead.@Deprecated
public interface DocumentService
extends com.appiancorp.services.ContextSensitiveService
Documents can have symbolic links, ie there can be a link to a document in a different location than where the document itself resides. A link provides direct access to the document and it is removed if the real document is removed.
Documents can be versioned using the createVersion()
or
createVersions()
methods which add new versions to an existing
document.
A document can also be locked, which prevents anyone from making changes to it (however, it is still accessible for viewing).
NOTE: This service does not actually write any documents to disk - it only provides functionality for storing and handling document metadata, so documents must still be manually written to disk. The path on disk to which a document should be written is obtained from doc.getInternalFilename() method. Note that this field is only populated when creating a new document object, creating a new version or retrieving the Documents with DocumentService.downloadDocument().
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.
Document
Modifier and Type | Field and Description |
---|---|
static boolean |
addDocumentsToFavorites$UPDATES
Deprecated.
|
static boolean |
addDocumentToFavorites$UPDATES
Deprecated.
|
static boolean |
approveChangesForDocument$UPDATES
Deprecated.
|
static boolean |
approveChangesForDocuments$UPDATES
Deprecated.
|
static boolean |
approveChangesForVersion$UPDATES
Deprecated.
|
static boolean |
approveChangesForVersions$UPDATES
Deprecated.
|
static boolean |
createDocument$UPDATES
Deprecated.
|
static boolean |
createDocuments$UPDATES
Deprecated.
|
static boolean |
createLink$UPDATES
Deprecated.
|
static boolean |
createLinks$UPDATES
Deprecated.
|
static boolean |
createVersion$UPDATES
Deprecated.
|
static boolean |
createVersions$UPDATES
Deprecated.
|
static boolean |
deleteDocument$UPDATES
Deprecated.
|
static boolean |
deleteDocuments$UPDATES
Deprecated.
|
static boolean |
deleteLink$UPDATES
Deprecated.
|
static boolean |
deleteLinks$UPDATES
Deprecated.
|
static boolean |
deleteVersion$UPDATES
Deprecated.
|
static boolean |
deleteVersions$UPDATES
Deprecated.
|
static boolean |
downloadDocument$UPDATES
Deprecated.
|
static boolean |
downloadDocuments$UPDATES
Deprecated.
|
static boolean |
getAllVersionsForDocument$UPDATES
Deprecated.
|
static boolean |
getAllVersionsForDocumentPaging$UPDATES
Deprecated.
|
static boolean |
getContentIdForDocumentId$UPDATES
Deprecated.
|
static boolean |
getContentIdsForDocumentIds$UPDATES
Deprecated.
|
static boolean |
getDocument$UPDATES
Deprecated.
|
static boolean |
getDocumentIdForContentId$UPDATES
Deprecated.
|
static boolean |
getDocumentIdsForContentIds$UPDATES
Deprecated.
|
static boolean |
getDocuments$UPDATES
Deprecated.
|
static boolean |
getDocumentsList$UPDATES
Deprecated.
|
static boolean |
getDocumentsPaging$UPDATES
Deprecated.
|
static boolean |
getFavoriteDocuments$UPDATES
Deprecated.
|
static boolean |
getFavoriteDocumentsPaging$UPDATES
Deprecated.
|
static boolean |
getSystemDocumentId$UPDATES
Deprecated.
|
static boolean |
getVersion$UPDATES
Deprecated.
|
static boolean |
getVersions$UPDATES
Deprecated.
|
static boolean |
getVersionsPaging$UPDATES
Deprecated.
|
static boolean |
getViewableDocumentsPaging$UPDATES
Deprecated.
|
static boolean |
lockDocument$UPDATES
Deprecated.
|
static boolean |
moveDocument$UPDATES
Deprecated.
|
static boolean |
moveDocuments$UPDATES
Deprecated.
|
static boolean |
rejectChangesForDocument$UPDATES
Deprecated.
|
static boolean |
rejectChangesForDocuments$UPDATES
Deprecated.
|
static boolean |
rejectChangesForVersion$UPDATES
Deprecated.
|
static boolean |
rejectChangesForVersions$UPDATES
Deprecated.
|
static boolean |
removeDocumentFromFavorites$UPDATES
Deprecated.
|
static boolean |
removeDocumentsFromFavorites$UPDATES
Deprecated.
|
static boolean |
searchDocuments$UPDATES
Deprecated.
|
static boolean |
searchDocumentsPaging$UPDATES
Deprecated.
|
static boolean |
setSystemDocumentId$UPDATES
Deprecated.
|
static boolean |
suggest$UPDATES
Deprecated.
|
static boolean |
undeleteDocument$UPDATES
Deprecated.
|
static boolean |
unexpireDocuments$UPDATES
Deprecated.
|
static boolean |
unlockDocument$UPDATES
Deprecated.
|
static boolean |
updateDocument$UPDATES
Deprecated.
|
static boolean |
updateDocuments$UPDATES
Deprecated.
|
static boolean |
updateForumForDocument$UPDATES
Deprecated.
|
static boolean |
updateForumForDocuments$UPDATES
Deprecated.
|
static boolean |
validateDocumentId$UPDATES
Deprecated.
|
static boolean |
validateDocumentIds$UPDATES
Deprecated.
|
Modifier and Type | Method and Description |
---|---|
void |
addDocumentsToFavorites(java.lang.Long[] doids_)
Deprecated.
Adds multiple documents to the current user's list of favourites.
|
void |
addDocumentToFavorites(java.lang.Long doid_)
Deprecated.
Adds a document to the current user's list of favorites.
|
void |
approveChangesForDocument(java.lang.Long doid_)
Deprecated.
Approves the changes for a document; to approve creation of a document,
pass the id of the document, to approve deletion of a document, pass
(-1 * (document id)).
|
void |
approveChangesForDocuments(java.lang.Long[] doids_)
Deprecated.
Approves changes for multiple documents; to approve creation of a
document, pass the id of the document, to approve deletion of a
document, pass (-1 * (document id)).
|
void |
approveChangesForVersion(java.lang.Long doid_,
java.lang.Integer vid_)
Deprecated.
Approves changes made for a specific version of a document; to approve
creation of a version, pass the id of the document directly, to approve
deletion of a version, pass (-1 * (document id)).
|
void |
approveChangesForVersions(java.lang.Long[] doids_,
java.lang.Integer[] vids_)
Deprecated.
Approves changes made for specific versions of multiple documents;
approves the passed version of the corresponding document (ie each
index in
doids_ maps to an index in vids_ ). |
Document |
createDocument(Document doc_)
Deprecated.
Create a document.
|
Document[] |
createDocuments(Document[] docs_)
Deprecated.
Create multiple documents.
|
void |
createLink(java.lang.Long docId_,
java.lang.Long foid_)
Deprecated.
Creates a symbolic link to a document.
|
void |
createLinks(java.lang.Long[] docIds_,
java.lang.Long foid_)
Deprecated.
Creates a list of symbolic links to documents.
|
void |
createLinks(java.lang.Long[] docIds_,
java.lang.Long[] foids_)
Deprecated.
Creates multiple symbolic links to documents in a list of folders; a
single link is created in each of the folders (ie each index in
docIds_ maps to an index in foids_ ). |
Document |
createVersion(Document document_)
Deprecated.
Creates a new version of a document.
|
Document[] |
createVersions(Document[] documents_)
Deprecated.
Creates new versions of multiple documents.
|
void |
deleteDocument(java.lang.Long doid_)
Deprecated.
Use the method
#deactivate(Long, Boolean) instead. |
void |
deleteDocuments(java.lang.Long[] doids_)
Deprecated.
Use the method
#deactivate(Long[], Boolean) instead. |
void |
deleteLink(java.lang.Long docId_,
java.lang.Long foId_)
Deprecated.
Deletes a symbolic link to a document from a folder.
|
void |
deleteLinks(java.lang.Long[] docIds_,
java.lang.Long foId_)
Deprecated.
Deletes multiple symbolic links from a folder.
|
void |
deleteVersion(java.lang.Long doid_,
java.lang.Integer versionId_)
Deprecated.
Use the method
#deactivateVersion(Long, Integer, Boolean) instead. |
void |
deleteVersions(java.lang.Long doid_,
java.lang.Integer[] versionIds_)
Deprecated.
Use the method
#deactivateVersions(Long, Integer[], Boolean) instead. |
Document |
downloadDocument(java.lang.Long doid_,
java.lang.Integer vid_,
int adminOverride_)
Deprecated.
Download a document.
|
Document[] |
downloadDocuments(java.lang.Long[] doids_,
java.lang.Integer vid_,
int adminOverride_)
Deprecated.
Download multiple documents.
|
Document[] |
getAllVersionsForDocument(java.lang.Long doid_)
|
ResultPage |
getAllVersionsForDocumentPaging(java.lang.Long doid_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Gets all versions of a document, paging.
|
java.lang.Long |
getContentIdForDocumentId(java.lang.Long id_)
Deprecated.
Returns the Content Id given a Document Id.
|
java.lang.Long[] |
getContentIdsForDocumentIds(java.lang.Long[] id_)
Deprecated.
Returns the Content Id given a Document Id.
|
Document |
getDocument(java.lang.Long doid_)
Deprecated.
Retrieves a document (without the internalFilename property populated).
|
java.lang.Long |
getDocumentIdForContentId(java.lang.Long id_)
Deprecated.
Returns the document Id given a content Id.
|
java.lang.Long[] |
getDocumentIdsForContentIds(java.lang.Long[] id_)
Deprecated.
Returns the document Id given a content Id.
|
Document[] |
getDocuments(java.lang.Long[] doids_)
|
ResultList |
getDocumentsList(java.lang.Long[] docIds_)
Deprecated.
Gets the specified documents, returning the valid results even if all
the results cannot be retrieved (for instance, if some of the documents
corresponding to the ids no longer exist).
|
ResultPage |
getDocumentsPaging(java.lang.Long[] doids_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Retrieves several documents (without the internalFilename property populated).
|
Document[] |
getFavoriteDocuments(java.lang.Integer sortOrder_,
java.lang.String sortColumn_)
|
ResultPage |
getFavoriteDocumentsPaging(int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Retrieves the list of the current user's favorite documents, paging.
|
java.lang.Long |
getSystemDocumentId(java.lang.String name_)
Deprecated.
|
Document |
getVersion(java.lang.Long doid_,
java.lang.Integer versionId_)
Deprecated.
Gets a specific version of a document.
|
Document[] |
getVersions(java.lang.Long doid_,
java.lang.Integer[] versionIds_)
|
ResultPage |
getVersionsPaging(java.lang.Long doid_,
java.lang.Integer[] versionIds_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Gets specific versions of a document, paging.
|
ResultPage |
getViewableDocumentsPaging(java.lang.Long[] documentIds_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Gets the documents that the current user is allowed to access from a list
of documents.
|
void |
lockDocument(java.lang.Long doid_)
Deprecated.
Locks a document.
|
void |
moveDocument(java.lang.Long docid_,
java.lang.Long newFolderId_)
Deprecated.
Moves a document to another folder.
|
void |
moveDocuments(java.lang.Long[] docids_,
java.lang.Long newFolderId_)
Deprecated.
Moves multiple documents to another folder.
|
void |
rejectChangesForDocument(java.lang.Long doid_)
Deprecated.
Rejects changes made to a document; to reject creation of a
document, pass the id of the document, to reject deletion of a
document, pass (-1 * (document id)).
|
void |
rejectChangesForDocuments(java.lang.Long[] doids_)
Deprecated.
Rejects changes made to multiple documents; to reject creation of a
document, pass the id of the document, to reject deletion of a
document, pass (-1 * (document id)).
|
void |
rejectChangesForVersion(java.lang.Long doid_,
java.lang.Integer vid_)
Deprecated.
Rejects the changes made for a specific version of a document; to reject
creation of a version, pass the id of the document directly, to reject
deletion of a version, pass (-1 * (document id)).
|
void |
rejectChangesForVersions(java.lang.Long[] doids_,
java.lang.Integer[] vids_)
Deprecated.
Rejects changes made for specific versions of multiple documents; to
reject creation of a version, pass the id of the document directly, to
reject deletion of a version, pass (-1 * (document id)).
|
void |
removeDocumentFromFavorites(java.lang.Long doid_)
Deprecated.
Removes a document from the current user's list of favorites.
|
void |
removeDocumentsFromFavorites(java.lang.Long[] doids_)
Deprecated.
Removes multiple documents from the current user's list of favorites.
|
Document[] |
searchDocuments(java.lang.String searchTerm_,
int startIndex_,
int scrollLength_)
|
ResultPage |
searchDocumentsPaging(java.lang.String searchTerm_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Search for documents by name.
|
void |
setSystemDocumentId(java.lang.String name_,
java.lang.Long id_)
Deprecated.
use
createDocument(Document) with a pre-populated UUID |
java.lang.String |
suggest(java.lang.String query_,
int maxItems_,
SuggestParam[] params_,
java.lang.Boolean groupResults_)
Deprecated.
|
java.lang.String |
suggest(java.lang.String query_,
int maxItems_,
SuggestParam[] params_,
java.lang.Boolean groupResults_,
java.lang.Long[] allowList)
Deprecated.
|
void |
undeleteDocument(java.lang.Long doid_)
Deprecated.
Reactivates (undeletes) a document (NOTE: This method does not currently
check whether the user has permission to reactivate the document).
|
void |
unexpireDocuments(java.lang.Long kcid_,
java.lang.Long[] doids_)
Deprecated.
Unexpires multiple documents.
|
void |
unlockDocument(java.lang.Long doid_)
Deprecated.
Unlocks a document.
|
void |
updateDocument(Document doc_)
Deprecated.
Updates a document.
|
void |
updateDocuments(Document[] docs_)
Deprecated.
Updates multiple documents.
|
void |
updateForumForDocument(Document doc_)
Deprecated.
Updates the discussion forum associated with a document.
|
void |
updateForumForDocuments(Document[] docs_)
Deprecated.
Updates the discussion forums associated with multiple documents.
|
java.lang.Integer |
validateDocumentId(java.lang.Long id_)
Deprecated.
Validates a document ID.
|
java.lang.Integer[] |
validateDocumentIds(java.lang.Long[] ids_)
Deprecated.
Validates document ids.
|
static final boolean createDocument$UPDATES
static final boolean createDocuments$UPDATES
static final boolean updateDocument$UPDATES
static final boolean updateDocuments$UPDATES
static final boolean updateForumForDocument$UPDATES
static final boolean updateForumForDocuments$UPDATES
static final boolean deleteDocument$UPDATES
static final boolean deleteDocuments$UPDATES
static final boolean getDocument$UPDATES
static final boolean getDocumentsPaging$UPDATES
static final boolean getDocuments$UPDATES
static final boolean moveDocument$UPDATES
static final boolean moveDocuments$UPDATES
static final boolean unlockDocument$UPDATES
static final boolean lockDocument$UPDATES
static final boolean createLink$UPDATES
static final boolean createLinks$UPDATES
static final boolean deleteLink$UPDATES
static final boolean deleteLinks$UPDATES
static final boolean createVersion$UPDATES
static final boolean createVersions$UPDATES
static final boolean deleteVersion$UPDATES
static final boolean deleteVersions$UPDATES
static final boolean getVersion$UPDATES
static final boolean getVersionsPaging$UPDATES
static final boolean getVersions$UPDATES
static final boolean getAllVersionsForDocument$UPDATES
static final boolean getAllVersionsForDocumentPaging$UPDATES
static final boolean approveChangesForDocument$UPDATES
static final boolean approveChangesForDocuments$UPDATES
static final boolean rejectChangesForDocument$UPDATES
static final boolean rejectChangesForDocuments$UPDATES
static final boolean approveChangesForVersion$UPDATES
static final boolean approveChangesForVersions$UPDATES
static final boolean rejectChangesForVersion$UPDATES
static final boolean rejectChangesForVersions$UPDATES
static final boolean getFavoriteDocuments$UPDATES
static final boolean getFavoriteDocumentsPaging$UPDATES
static final boolean addDocumentToFavorites$UPDATES
static final boolean addDocumentsToFavorites$UPDATES
static final boolean removeDocumentFromFavorites$UPDATES
static final boolean removeDocumentsFromFavorites$UPDATES
static final boolean downloadDocument$UPDATES
static final boolean downloadDocuments$UPDATES
static final boolean undeleteDocument$UPDATES
static final boolean unexpireDocuments$UPDATES
static final boolean validateDocumentIds$UPDATES
static final boolean validateDocumentId$UPDATES
static final boolean searchDocuments$UPDATES
static final boolean searchDocumentsPaging$UPDATES
static final boolean getViewableDocumentsPaging$UPDATES
static final boolean getDocumentsList$UPDATES
static final boolean getSystemDocumentId$UPDATES
static final boolean setSystemDocumentId$UPDATES
static final boolean suggest$UPDATES
static final boolean getContentIdForDocumentId$UPDATES
static final boolean getContentIdsForDocumentIds$UPDATES
static final boolean getDocumentIdForContentId$UPDATES
static final boolean getDocumentIdsForContentIds$UPDATES
Document createDocument(Document doc_) throws InvalidUserException, InvalidFolderException, InvalidDocumentException, PrivilegeException, StorageLimitException
doc_
- a Document
object which should contain all of
the information required to create a valid document.
name
,
description
(can be null
or "", if not set),
extension
, size
, folderId
, and
status
.InvalidUserException
- if the user calling this method is invalidInvalidFolderException
- if the folder ID specified by the document
does not correspond to a valid folderInvalidDocumentException
- if the document does not contain all
of the required informationPrivilegeException
- if the current user is neither an editor nor
an administrator of the folderStorageLimitException
- if the current user is not an administrator
and will exceed his/her quota on a community KC by creating this
document in itServiceException
- if any system-level error occursDocument[] createDocuments(Document[] docs_) throws InvalidUserException, InvalidFolderException, InvalidDocumentException, PrivilegeException, StorageLimitException
docs_
- an array of Document
objects which should
contain all of the information required to create valid documents.
name
,
description
(can be null
or "", if not set),
extension
, size
, folderId
, and
status
.InvalidUserException
- if the user calling this method is invalidInvalidFolderException
- if the folder ID specified by any of the
documents does not correspond to a valid folderInvalidDocumentException
- if any of the documents does not contain
all of the required informationPrivilegeException
- if the current user is neither an editor nor
an administrator of the folderStorageLimitException
- if the current user is not an administrator
and will exceed his/her quota on a community KC by creating this
document in itServiceException
- if any system-level error occursvoid updateDocument(Document doc_) throws InvalidUserException, PrivilegeException, InvalidDocumentException, InvalidFolderException
doc_
- a Document
object, which should contain all of
the information required to update a document.
name
,
description
(can be an empty String
),
extension
, size
, folderId
,
status
and id
.InvalidUserException
- if the user calling this method is invalidPrivilegeException
- if the current user is neither an editor nor
an administrator of the folderInvalidDocumentException
- if the ID of the document does not
correspond to a valid documentInvalidFolderException
- if the folder ID specified by the document
does not correspond to a valid folderServiceException
- if any system-level error occursvoid updateDocuments(Document[] docs_) throws InvalidUserException, PrivilegeException, InvalidDocumentException, InvalidFolderException
docs_
- an array of Document
objects, which should each
contain all of the information required to update a document.
name
,
description
(can be an empty String
),
extension
, size
, folderId
,
status
and id
.InvalidUserException
- if the user calling this method is invalidPrivilegeException
- if the current user is neither an editor nor
an administrator of the folderInvalidDocumentException
- if the ID of any of the documents does not
correspond to a valid documentInvalidFolderException
- if the folder ID specified by any of the
documents does not correspond to a valid folderServiceException
- if any system-level error occursvoid updateForumForDocument(Document doc_) throws InvalidDocumentException, PrivilegeException
doc_
- a Document
object which should contain the
updated discussion forum information. The fields that should be populated
on the document are: id
and forum
. All other
fields will be ignored. If forum
is set to null
,
any forum associations are removed.InvalidDocumentException
- if the ID of the document does not
correspond to a valid documentPrivilegeException
- if 1) the current user does not have access to
the folder containing the document or 2) the current user is not an
editor of the folder containing the document, and a forum currently
exists for the documentServiceException
- if any system-level error occursvoid updateForumForDocuments(Document[] docs_) throws InvalidDocumentException, PrivilegeException
docs_
- a list of Document
object which should contain the
updated discussion forum information. The fields that should be populated
on each document are: id
and forum
. All other
fields will be ignored. If forum
is set to null
,
any forum associations are removed.InvalidDocumentException
- if the ID of any of the documents does not
correspond to a valid documentPrivilegeException
- if 1) the current user does not have access to
the folder containing one of the documents or 2) the current user
is not an editor of the folder containing one of the documents, and
a forum currently exists for the documentServiceException
- if any system-level error occurs@Deprecated void deleteDocument(java.lang.Long doid_) throws InvalidUserException, PrivilegeException, InvalidDocumentException
#deactivate(Long, Boolean)
instead.#undelete(Long)
.doid_
- the ID of the document to be deleted.InvalidUserException
- if the user calling this method is invalidPrivilegeException
- if the current user is not
an administrator of the folder or the owner of the documentInvalidDocumentException
- if the ID does not correspond to a valid
documentServiceException
- if any system-level error occurs@Deprecated void deleteDocuments(java.lang.Long[] doids_) throws InvalidUserException, PrivilegeException, InvalidDocumentException
#deactivate(Long[], Boolean)
instead.#undelete(Long)
.doids_
- the IDs of the documents to be deleted.InvalidUserException
- if the user calling this method is invalidPrivilegeException
- if the current user is not
an administrator of the folder or the owner of the documentsInvalidDocumentException
- if any of the IDs does not correspond to
a valid documentServiceException
- if any system-level error occursDocument getDocument(java.lang.Long doid_) throws InvalidDocumentException, PrivilegeException, InvalidUserException
downloadDocument
method.doid_
- the ID of the document.InvalidDocumentException
- if the ID does not correspond to a valid
documentPrivilegeException
- if the current user does not have viewing
privileges to the folderInvalidUserException
- if the user calling this method is invalidServiceException
- if any system-level error occursResultPage getDocumentsPaging(java.lang.Long[] doids_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidDocumentException, PrivilegeException, InvalidUserException
downloadDocument
method.doids_
- an array of unique document IDs.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. Negative numbers will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants
in Document
.sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing a list of
Document
objects, representing the documents with the given
IDs (without the internalFilename property set). If you need the
internalFilename property, use the downloadDocument
methodInvalidDocumentException
- if any of the IDs does not correspond to
a valid documentPrivilegeException
- if the current user does not have viewing
privileges to the folder(s)InvalidUserException
- if the user calling this method is invalidServiceException
- if any system-level error occurs@Deprecated Document[] getDocuments(java.lang.Long[] doids_) throws InvalidDocumentException, PrivilegeException, InvalidUserException
getDocumentsPaging(java.lang.Long[], int, int, java.lang.Integer, java.lang.Integer)
.downloadDocuments
methoddoids_
- an array of unique document IDs.InvalidDocumentException
- if any of the IDs does not correspond to
a valid documentPrivilegeException
- if the current user context does not have the
rights to perform this operationInvalidUserException
- if the user calling this method is invalidServiceException
- if any system-level error occursvoid moveDocument(java.lang.Long docid_, java.lang.Long newFolderId_) throws InvalidUserException, PrivilegeException, InvalidFolderException, InvalidDocumentException
docid_
- The id of the document to be moved.newFolderId_
- The id of the folder to move the document to.InvalidUserException
- if the user calling this method is invalidPrivilegeException
- if the current user is not an administrator
of both the old and new knowledge centersInvalidFolderException
- if the folder does not existServiceException
- if any system-level error occursInvalidDocumentException
void moveDocuments(java.lang.Long[] docids_, java.lang.Long newFolderId_) throws InvalidUserException, PrivilegeException, InvalidFolderException, InvalidDocumentException
docids_
- An array of ids of the documents to be moved.newFolderId_
- The id of the folder to move the documents to.InvalidUserException
- if the user calling this method is invalidPrivilegeException
- if the current user is not an administrator
of both the old and new knowledge centersInvalidFolderException
- if the folder does not existInvalidDocumentException
- if one or more of the documents does
not exist, or has been deletedServiceException
- if any system-level error occursvoid unlockDocument(java.lang.Long doid_) throws InvalidUserException, InvalidDocumentException, PrivilegeException
doid_
- The id of the document to unlock.PrivilegeException
- if the current user is not an administrator
of the folder nor the person who locked the documentInvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if the document does not exist, or has
been deletedServiceException
- if any system-level error occursvoid lockDocument(java.lang.Long doid_) throws InvalidUserException, PrivilegeException, InvalidDocumentException
doid_
- The id of the document to lock.PrivilegeException
- if the current user is neither an editor
nor an administrator of the folderInvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if the document does not exist, or has
been deletedServiceException
- if any system-level error occursvoid createLink(java.lang.Long docId_, java.lang.Long foid_) throws InvalidUserException, PrivilegeException, InvalidDocumentException, InvalidFolderException
docId_
- The id of the document to create the link to.foid_
- The id of the folder where the link should be created.PrivilegeException
- if the current user is not an administrator
of both the folder containing the document and the folder where the link
is being createdInvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if the document does not exist, or has
been deletedInvalidFolderException
- if the folder does not existServiceException
- if any system-level error occursvoid createLinks(java.lang.Long[] docIds_, java.lang.Long foid_) throws InvalidUserException, PrivilegeException, InvalidDocumentException, InvalidFolderException
docIds_
- The ids of the documents to create the links to.foid_
- The id of the folder where the links should be created.PrivilegeException
- if the current user is not an administrator
of both the folder containing the document and the folder where the links
are being createdInvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if any document does not exist, or has
been deletedInvalidFolderException
- if the folder does not existServiceException
- if any system-level error occursvoid createLinks(java.lang.Long[] docIds_, java.lang.Long[] foids_) throws InvalidUserException, PrivilegeException, InvalidDocumentException, InvalidFolderException
docIds_
maps to an index in foids_
).docIds_
- The ids of the documents to create the links to.foids_
- The ids of the folders where the links should be created.
This array must be the same size as the docIds
array.InvalidUserException
- if the user calling this method is invalidPrivilegeException
- if the current user is not an administrator
of both the folder containing the document and the folder where the links
are being createdInvalidDocumentException
- if any of the documents does not exist,
or has been deletedInvalidFolderException
- if any of the folders does not existServiceException
- if any system-level error occursvoid deleteLink(java.lang.Long docId_, java.lang.Long foId_) throws InvalidUserException, PrivilegeException, InvalidDocumentException, InvalidFolderException
docId_
- The id of the document to which the link points.foId_
- The id of the folder which contains the link.PrivilegeException
- if the current user is not an administrator of
the folder or the owner of the linkInvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if the document does not exist, or has
been deletedInvalidFolderException
- if the folder does not existServiceException
- if any system-level error occursvoid deleteLinks(java.lang.Long[] docIds_, java.lang.Long foId_) throws InvalidUserException, PrivilegeException, InvalidDocumentException, InvalidFolderException
docIds_
- An array of ids of the documents to which the links point.foId_
- The id of the folder which contains the links.PrivilegeException
- f the current user is not an administrator of
the folder or the owner of the linksInvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if any of the documents does not exist,
or has been deletedInvalidFolderException
- if the folder does not existServiceException
- if any system-level error occursDocument createVersion(Document document_) throws InvalidUserException, PrivilegeException, InvalidDocumentException, InvalidFolderException, StorageLimitException, InvalidOperationException
document_
- A Document
object which should contain all
of the information required to create a valid document (see
createDocument(com.appiancorp.suiteapi.collaboration.Document)
). The id
field of the
passed object should be the id of the document for which the new version
is being created.Document
object representing the new version of
the document.InvalidUserException
- if the current user context is not foundInvalidFolderException
- if the folder specified by the document
does not existInvalidDocumentException
- if the document ID does not correspond to
a valid documentPrivilegeException
- if the current user is neither an editor nor
an administrator of the folderInvalidOperationException
- if the document is pending approval,
or has been checked outStorageLimitException
- if there is no space on the filesystem to store
the document versionServiceException
- if any system-level error occursDocument[] createVersions(Document[] documents_) throws InvalidUserException, PrivilegeException, InvalidDocumentException, InvalidFolderException, StorageLimitException, InvalidOperationException
documents_
- An array of Document
objects which should
contain all of the information required to create valid documents (see
createDocument(com.appiancorp.suiteapi.collaboration.Document)
). The id
field of each
passed objects should be the id of the document for which a new version
is being created.Document
objects representing the new
versions of the documentsInvalidUserException
- if the current user context is not foundInvalidFolderException
- if the folder specified by any of the
documents does not existInvalidDocumentException
- if any of the document IDs does not
correspond to a valid documentPrivilegeException
- if the current user is neither an editor nor
an administrator of the folderInvalidOperationException
- if any of the documents is pending
approval, or has been checked outStorageLimitException
- if there is no space on the filesystem to
store the document versionsServiceException
- if any system-level error occurs@Deprecated void deleteVersion(java.lang.Long doid_, java.lang.Integer versionId_) throws InvalidUserException, PrivilegeException, InvalidDocumentException
#deactivateVersion(Long, Integer, Boolean)
instead.doid_
- The id of a document.versionId_
- The version number of the document version to be deleted.PrivilegeException
- if the current user is not the administrator of
the fodler or the owner of the versionInvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if the document does not exist, or has
been deleted, or if the specified version does not existServiceException
- if any system-level error occurs@Deprecated void deleteVersions(java.lang.Long doid_, java.lang.Integer[] versionIds_) throws InvalidUserException, PrivilegeException, InvalidDocumentException
#deactivateVersions(Long, Integer[], Boolean)
instead.doid_
- The id of a document.versionIds_
- The version numbers of the document versions to be
deleted.PrivilegeException
- if the current user is not the administrator of
the fodler or the owner of the versionsInvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if the document does not exist, or has
been deleted, or if any of the specified versions does not existServiceException
- if any system-level error occursDocument getVersion(java.lang.Long doid_, java.lang.Integer versionId_) throws InvalidDocumentException, PrivilegeException, InvalidVersionException
doid_
- The id of a document.versionId_
- The version number of the document version to retrieve.Document
object representing the specified
version of the document.InvalidDocumentException
- if the document does not exist, or has
been deleted, or if the specified version does not existPrivilegeException
- if the current user does not have viewing
privileges to the folderInvalidVersionException
- if the passed version id is invalidServiceException
- if any system-level error occursResultPage getVersionsPaging(java.lang.Long doid_, java.lang.Integer[] versionIds_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidDocumentException, PrivilegeException, InvalidVersionException
doid_
- The id of a document.versionIds_
- An array containing the version numbers of the
document versions to retrieve.startIndex_
- The index into the collection of total results at
which to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Negative numbers will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in Document
.sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing a list of
Document
objects, which hold information about the specified
versions of the document with the passed id.InvalidDocumentException
- if the document does not exist, or has
been deleted, or if any of the specified versions does not existPrivilegeException
- if the current user does not have viewing
privileges to the folderInvalidVersionException
- if any one of the passed version ids is
invalidServiceException
- if any system-level error occurs@Deprecated Document[] getVersions(java.lang.Long doid_, java.lang.Integer[] versionIds_) throws InvalidDocumentException, PrivilegeException, InvalidVersionException
getVersionsPaging(java.lang.Long, java.lang.Integer[], int, int, java.lang.Integer, java.lang.Integer)
.doid_
- The id of a document.versionIds_
- An array containing the version numbers of the
document versions to retrieve.Document
objects representing the
specified versions of the document.InvalidDocumentException
- if the document does not exist, or has
been deleted, or if any of the specified versions does not existPrivilegeException
- if the current user does not have viewing
privileges to the folderInvalidVersionException
- if any one of the passed version ids is
invalidServiceException
- if any system-level error occurs@Deprecated Document[] getAllVersionsForDocument(java.lang.Long doid_) throws InvalidDocumentException, PrivilegeException
getAllVersionsForDocumentPaging(java.lang.Long, int, int, java.lang.Integer, java.lang.Integer)
.doid_
- The id of a document.Document
objects representing all the
document's versions.InvalidDocumentException
- if the document does not exist or has
been deletedPrivilegeException
- if the current user does not have viewing
privileges to the folderServiceException
- if any system-level error occursResultPage getAllVersionsForDocumentPaging(java.lang.Long doid_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidDocumentException, PrivilegeException
doid_
- The id of a document.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. Negative numbers will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in Document
.sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing a list of
Document
objects, which hold information about each of the
versions of the document with the passed id.InvalidDocumentException
- if the document does not exist, or has
been deletedPrivilegeException
- if the current user does not have viewing
privileges to the folderServiceException
- if any system-level error occursvoid approveChangesForDocument(java.lang.Long doid_) throws InvalidUserException, PrivilegeException, InvalidDocumentException
doid_
- The id of the document to approve creation or the
negation of the document id to approve deletion.PrivilegeException
- if the current user is not an administrator
of the KC containing the documentInvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if the document does not exist, or has
been deletedServiceException
- if any system-level error occursvoid approveChangesForDocuments(java.lang.Long[] doids_) throws InvalidUserException, PrivilegeException, InvalidDocumentException
doids_
- An array of ids of the documents to approve; to approve
creation of a document, pass the id of the document, to approve deletion
of a document, pass (-1 * (document id)).PrivilegeException
- if the current user is not an administrator
of the KC containing the documentInvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if any of the documents does not exist,
or has been deletedServiceException
- if any system-level error occursvoid rejectChangesForDocument(java.lang.Long doid_) throws InvalidUserException, PrivilegeException, InvalidDocumentException
doid_
- The id of a document; to reject creation of a
document, pass the id of the document directly, to reject deletion of a
document, pass (-1 * (document id)).PrivilegeException
- if the current user is not an administrator
of the KC containing the documentInvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if the document does not exist, or has
been deletedServiceException
- if any system-level error occursvoid rejectChangesForDocuments(java.lang.Long[] doids_) throws InvalidUserException, PrivilegeException, InvalidDocumentException
doids_
- An array of ids of documents; to reject creation of a
document, pass the id of the document directly, to reject deletion of a
document, pass (-1 * (document id)).PrivilegeException
- if the current user is not an administrator
of the KC containing the documentInvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if any of the documents does not exist,
or has been deletedServiceException
- if any system-level error occursvoid approveChangesForVersion(java.lang.Long doid_, java.lang.Integer vid_) throws InvalidUserException, PrivilegeException, InvalidDocumentException
doid_
- The id of a document; to approve creation of a version, pass
the id of the document directly, to approve deletion of a version, pass
(-1 * (document id)).vid_
- The version number of the document version to approve.PrivilegeException
- if the current user is not an administrator
of the KC containing the documentInvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if the document does not exist, or has
been deleted, or if the specified version does not existServiceException
- if any system-level error occursvoid approveChangesForVersions(java.lang.Long[] doids_, java.lang.Integer[] vids_) throws InvalidUserException, PrivilegeException, InvalidDocumentException
doids_
maps to an index in vids_
).
To approve creation of a version, pass the id of the document
directly, to approve deletion of a version, pass (-1 * (document id)).doids_
- An array of ids of documents; to approve creation of a
version, pass the id of the document directly, to approve deletion of a
version, pass (-1 * (document id)).vids_
- An array of the version numbers of the document versions
to approve. This should be the same size as the doids
array.PrivilegeException
- if the current user is not an administrator
of the KC containing the documentInvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if any of the documents does not exist,
or has been deleted, or if the specified version does not existServiceException
- if any system-level error occursvoid rejectChangesForVersion(java.lang.Long doid_, java.lang.Integer vid_) throws InvalidUserException, PrivilegeException, InvalidDocumentException
doid_
- The id of a document; to reject creation of a version, pass
the id of the document directly, to reject deletion of a version, pass
(-1 * (document id)).vid_
- The version number of the document version.InvalidUserException
- if the user calling this method is invalidPrivilegeException
- if the current user is not an administrator
of the KC containing the documentInvalidDocumentException
- if the document does not exist, or has
been deleted, or if the specified version does not existServiceException
- if any system-level error occursvoid rejectChangesForVersions(java.lang.Long[] doids_, java.lang.Integer[] vids_) throws InvalidUserException, PrivilegeException, InvalidDocumentException
doids_
- An array of ids of documents; to reject creation of a
version, pass the id of the document directly, to reject deletion of a
version, pass (-1 * (document id)).vids_
- An array of the version numbers of the document versions.
This should be the same size as the doids
array.PrivilegeException
- if the current user is not an administrator
of the KC containing the documentInvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if any of the documents does not exist,
or has been deleted, or if the specified version does not existServiceException
- if any system-level error occurs@Deprecated Document[] getFavoriteDocuments(java.lang.Integer sortOrder_, java.lang.String sortColumn_) throws InvalidUserException
sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.sortColumn_
- The field of the Document
object by
which to sort the returned list of documents. This is one of the
SORT_BY_XX
in Document
InvalidUserException
- if the user calling this method is invalidServiceException
- if any system-level error occursResultPage getFavoriteDocumentsPaging(int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidUserException
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. Negative numbers will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in Document
.sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing a list of
Document
objects, representing those documents that are the
current user's favorites.InvalidUserException
- if the user calling this method is invalidServiceException
- if any system-level error occursvoid addDocumentToFavorites(java.lang.Long doid_) throws InvalidUserException, InvalidDocumentException
doid_
- The id of the document to add to favorites.InvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if the document does not exist,
or has been deletedServiceException
- if any system-level error occursvoid addDocumentsToFavorites(java.lang.Long[] doids_) throws InvalidUserException, InvalidDocumentException, InvalidDataFormatException
doids_
- An array of ids of the documents to add to favorites.InvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if any of the documents does not exist,
or has been deletedInvalidDataFormatException
- if doids_ is null.ServiceException
- if any system-level error occursvoid removeDocumentFromFavorites(java.lang.Long doid_) throws InvalidUserException, InvalidDocumentException
doid_
- The id of the document to remove from favorites.InvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if the document does not exist,
or has been deletedServiceException
- if any system-level error occursvoid removeDocumentsFromFavorites(java.lang.Long[] doids_) throws InvalidUserException, InvalidDocumentException, InvalidDataFormatException
doids_
- An array of ids of the documents to remove from favorites.InvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if any of the documents does not exist,
or has been deletedInvalidDataFormatException
- if doids_ is null.ServiceException
- if any system-level error occursDocument downloadDocument(java.lang.Long doid_, java.lang.Integer vid_, int adminOverride_) throws InvalidDocumentException, PrivilegeException, InvalidOperationException
fileSystemId
of the returned document is:
getDocument(java.lang.Long)
method should be used to return document metadata (not
logged as a download and security is more strict), while this method will allow
downloads from low security knowledge centers, and the download will be logged.doid_
- The id of the document to be downloaded.vid_
- The version number of the document version to be downloaded (use
Document.CURRENT_VERSION
for the current version;
otherwise version numbers start at 1).adminOverride_
- Should usually be set to 0. Set to 1 to allow any user to
see a document to which he/she ordinarily does not have viewing rights.Document
object representing the downloaded document.PrivilegeException
- if the current user does not have viewing privileges to
the folderInvalidDocumentException
- if the document does not exist, or has expiredInvalidOperationException
- if the document is pending changes approvalServiceException
- if any system-level error occursDocument[] downloadDocuments(java.lang.Long[] doids_, java.lang.Integer vid_, int adminOverride_) throws InvalidDocumentException, PrivilegeException
fileSystemId
of the returned
documents is:
getDocumentsPaging(java.lang.Long[], int, int, java.lang.Integer, java.lang.Integer)
method should be used to return document metadatas
(not logged as a download and security is more strict), while this method will
allow downloads from low security knowledge centers, and the download will be
logged.doids_
- The ids of the documents to be downloaded.vid_
- The version number of the documents' version to be downloaded (use
Document.CURRENT_VERSION
for the current version;
otherwise version numbers start at 1).adminOverride_
- Should usually be set to 0. Set to 1 to allow any user to
see a document to which he/she ordinarily does not have viewing rights.Document
objects representing the downloaded
documents.PrivilegeException
- if the current user does not have viewing privileges to
the folderInvalidDocumentException
- if any of the documents does not exist, or has
expiredServiceException
- if any system-level error occursvoid undeleteDocument(java.lang.Long doid_) throws InvalidUserException, InvalidDocumentException, PrivilegeException
doid_
- The id of the document to reactivate.InvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if the document does not existPrivilegeException
- if the current user is not an administrator
of the folder or the owner of the documentServiceException
- if any system-level error occursvoid unexpireDocuments(java.lang.Long kcid_, java.lang.Long[] doids_) throws PrivilegeException, InvalidUserException, InvalidDocumentException, InvalidKnowledgeCenterException
kcid_
- The id of the knowledge center containing the documents.doids_
- The ids of the documents to be unexpired.InvalidUserException
- if the user calling this method is invalidInvalidDocumentException
- if any of the documents does not exist,
or has been deletedInvalidKnowledgeCenterException
- if the passed knowledge center
or the knowledge center referenced by any of the documents is invalidPrivilegeException
- if the current user is not an administrator
of the folder or the owner of the documentsServiceException
- if any system-level error occursjava.lang.Integer[] validateDocumentIds(java.lang.Long[] ids_)
ids_
- An array of document ids to be validated.Integer[]
of '0's and '1's corresponding to
the array of document ids that was passed as argument. '1' means 'valid',
while '0' means Invalid.ServiceException
- if any system-level error occursjava.lang.Integer validateDocumentId(java.lang.Long id_)
id_
- The document id to validate.Integer
that is either '0' (if the passed id is
invalid) or '1' (if the passed id is valid).ServiceException
- if any system-level error occurs@Deprecated Document[] searchDocuments(java.lang.String searchTerm_, int startIndex_, int scrollLength_) throws InvalidUserException
searchDocumentsPaging(java.lang.String, int, int, java.lang.Integer, java.lang.Integer)
.searchTerm_
- The string representing the name of the document for
which to search. A document will match if its name contains
the value of searchTerm_
.startIndex_
- The starting index of the first Document
to return.scrollLength_
- The number of consecutive Document
objects to return after the first.Document
objects whose names match the
specified search term.InvalidUserException
- if the user calling this method is invalidServiceException
- if any system-level error occursResultPage searchDocumentsPaging(java.lang.String searchTerm_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidUserException
searchTerm_
- The string representing the document name for
which to search. A document will match if its name contains
the value of searchTerm_
.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. Negative numbers will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in Document
.sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing a list of
Document
objects, representing those documents whose names
match the specified search term.InvalidUserException
- if the user calling this method is invalidServiceException
- if any system-level error occursResultPage getViewableDocumentsPaging(java.lang.Long[] documentIds_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidUserException, InvalidDocumentException
documentIds_
- A list of ids of documents.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. Negative numbers will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- The property by which the results should be sorted.
This should be one of the SORT_BY_XXX
constants defined
in Document
.sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing a list of
Document
objects, representing those documents which the
current user is allowed to access.InvalidUserException
- if the current user does not existInvalidDocumentException
- if any of the documents is invalidServiceException
- if any system-level error occursResultList getDocumentsList(java.lang.Long[] docIds_)
docIds_
- The ids of the documents to retrieve.ResultList
containing documents and result codes.
the Result.getResults()
method
should be used to get all the documents that were successfully retrieved.
In addition
ResultList.getResultCodes()
can be
used to get the list of result codes corresponding to each of the
specified document ids. Each code represents the successful retrieval of a
document, or, if the document could not be retrieved, the reason for the
failure. Each code will be one of the CODE_XXX
or
COLLAB_CODE_XXX
constants in ResultList
ResultList
,
Result
@Deprecated java.lang.Long getSystemDocumentId(java.lang.String name_) throws InvalidDocumentException
ContentService.getIdByUuid(String)
and
getDocumentIdForContentId(Long)
name
- A case-insensitive system name.InvalidDocumentException
- if the string is not recognized@Deprecated void setSystemDocumentId(java.lang.String name_, java.lang.Long id_) throws InvalidDocumentException
createDocument(Document)
with a pre-populated UUIDid
value with the specified
name
key.name
- A case-insensitive system name.id
- The document id.InvalidDocumentException
- if the string is not recognizedjava.lang.String suggest(java.lang.String query_, int maxItems_, SuggestParam[] params_, java.lang.Boolean groupResults_)
query
- maxItems
- params
- list of information on what is being suggested and what format
the results should be in. valid types are 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.java.lang.String suggest(java.lang.String query_, int maxItems_, SuggestParam[] params_, java.lang.Boolean groupResults_, java.lang.Long[] allowList)
query
- maxItems
- params
- list of information on what is being suggested and what format
the results should be in. valid types are 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.java.lang.Long getContentIdForDocumentId(java.lang.Long id_)
id_
- the document id.java.lang.Long[] getContentIdsForDocumentIds(java.lang.Long[] id_)
id_
- the document id.java.lang.Long getDocumentIdForContentId(java.lang.Long id_)
id_
- the document id.java.lang.Long[] getDocumentIdsForContentIds(java.lang.Long[] id_)
id_
- the document id.Copyright © 2003-2024 Appian Corporation. All Rights Reserved.