Interface DocumentService

All Superinterfaces:
com.appiancorp.services.ContextSensitiveService, Service

@Deprecated public interface DocumentService extends com.appiancorp.services.ContextSensitiveService
Deprecated.
Use the class ContentService instead.
Defines methods for managing collaboration documents. Documents are stored within collaboration folders. The security attached to a document is set from the security the document's parent folder. Documents can also be set to expire - expiration days is a configurable property of the knowledge center in which the document resides.

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.

See Also:
  • Field Details

    • createDocument$UPDATES

      static final boolean createDocument$UPDATES
      Deprecated.
      See Also:
    • createDocuments$UPDATES

      static final boolean createDocuments$UPDATES
      Deprecated.
      See Also:
    • updateDocument$UPDATES

      static final boolean updateDocument$UPDATES
      Deprecated.
      See Also:
    • updateDocuments$UPDATES

      static final boolean updateDocuments$UPDATES
      Deprecated.
      See Also:
    • updateForumForDocument$UPDATES

      static final boolean updateForumForDocument$UPDATES
      Deprecated.
      See Also:
    • updateForumForDocuments$UPDATES

      static final boolean updateForumForDocuments$UPDATES
      Deprecated.
      See Also:
    • deleteDocument$UPDATES

      static final boolean deleteDocument$UPDATES
      Deprecated.
      See Also:
    • deleteDocuments$UPDATES

      static final boolean deleteDocuments$UPDATES
      Deprecated.
      See Also:
    • getDocument$UPDATES

      static final boolean getDocument$UPDATES
      Deprecated.
      See Also:
    • getDocumentsPaging$UPDATES

      static final boolean getDocumentsPaging$UPDATES
      Deprecated.
      See Also:
    • getDocuments$UPDATES

      static final boolean getDocuments$UPDATES
      Deprecated.
      See Also:
    • moveDocument$UPDATES

      static final boolean moveDocument$UPDATES
      Deprecated.
      See Also:
    • moveDocuments$UPDATES

      static final boolean moveDocuments$UPDATES
      Deprecated.
      See Also:
    • unlockDocument$UPDATES

      static final boolean unlockDocument$UPDATES
      Deprecated.
      See Also:
    • lockDocument$UPDATES

      static final boolean lockDocument$UPDATES
      Deprecated.
      See Also:
    • createLink$UPDATES

      static final boolean createLink$UPDATES
      Deprecated.
      See Also:
    • createLinks$UPDATES

      static final boolean createLinks$UPDATES
      Deprecated.
      See Also:
    • deleteLink$UPDATES

      static final boolean deleteLink$UPDATES
      Deprecated.
      See Also:
    • deleteLinks$UPDATES

      static final boolean deleteLinks$UPDATES
      Deprecated.
      See Also:
    • createVersion$UPDATES

      static final boolean createVersion$UPDATES
      Deprecated.
      See Also:
    • createVersions$UPDATES

      static final boolean createVersions$UPDATES
      Deprecated.
      See Also:
    • deleteVersion$UPDATES

      static final boolean deleteVersion$UPDATES
      Deprecated.
      See Also:
    • deleteVersions$UPDATES

      static final boolean deleteVersions$UPDATES
      Deprecated.
      See Also:
    • getVersion$UPDATES

      static final boolean getVersion$UPDATES
      Deprecated.
      See Also:
    • getVersionsPaging$UPDATES

      static final boolean getVersionsPaging$UPDATES
      Deprecated.
      See Also:
    • getVersions$UPDATES

      static final boolean getVersions$UPDATES
      Deprecated.
      See Also:
    • getAllVersionsForDocument$UPDATES

      static final boolean getAllVersionsForDocument$UPDATES
      Deprecated.
      See Also:
    • getAllVersionsForDocumentPaging$UPDATES

      static final boolean getAllVersionsForDocumentPaging$UPDATES
      Deprecated.
      See Also:
    • approveChangesForDocument$UPDATES

      static final boolean approveChangesForDocument$UPDATES
      Deprecated.
      See Also:
    • approveChangesForDocuments$UPDATES

      static final boolean approveChangesForDocuments$UPDATES
      Deprecated.
      See Also:
    • rejectChangesForDocument$UPDATES

      static final boolean rejectChangesForDocument$UPDATES
      Deprecated.
      See Also:
    • rejectChangesForDocuments$UPDATES

      static final boolean rejectChangesForDocuments$UPDATES
      Deprecated.
      See Also:
    • approveChangesForVersion$UPDATES

      static final boolean approveChangesForVersion$UPDATES
      Deprecated.
      See Also:
    • approveChangesForVersions$UPDATES

      static final boolean approveChangesForVersions$UPDATES
      Deprecated.
      See Also:
    • rejectChangesForVersion$UPDATES

      static final boolean rejectChangesForVersion$UPDATES
      Deprecated.
      See Also:
    • rejectChangesForVersions$UPDATES

      static final boolean rejectChangesForVersions$UPDATES
      Deprecated.
      See Also:
    • getFavoriteDocuments$UPDATES

      static final boolean getFavoriteDocuments$UPDATES
      Deprecated.
      See Also:
    • getFavoriteDocumentsPaging$UPDATES

      static final boolean getFavoriteDocumentsPaging$UPDATES
      Deprecated.
      See Also:
    • addDocumentToFavorites$UPDATES

      static final boolean addDocumentToFavorites$UPDATES
      Deprecated.
      See Also:
    • addDocumentsToFavorites$UPDATES

      static final boolean addDocumentsToFavorites$UPDATES
      Deprecated.
      See Also:
    • removeDocumentFromFavorites$UPDATES

      static final boolean removeDocumentFromFavorites$UPDATES
      Deprecated.
      See Also:
    • removeDocumentsFromFavorites$UPDATES

      static final boolean removeDocumentsFromFavorites$UPDATES
      Deprecated.
      See Also:
    • downloadDocument$UPDATES

      static final boolean downloadDocument$UPDATES
      Deprecated.
      See Also:
    • downloadDocuments$UPDATES

      static final boolean downloadDocuments$UPDATES
      Deprecated.
      See Also:
    • undeleteDocument$UPDATES

      static final boolean undeleteDocument$UPDATES
      Deprecated.
      See Also:
    • unexpireDocuments$UPDATES

      static final boolean unexpireDocuments$UPDATES
      Deprecated.
      See Also:
    • validateDocumentIds$UPDATES

      static final boolean validateDocumentIds$UPDATES
      Deprecated.
      See Also:
    • validateDocumentId$UPDATES

      static final boolean validateDocumentId$UPDATES
      Deprecated.
      See Also:
    • searchDocuments$UPDATES

      static final boolean searchDocuments$UPDATES
      Deprecated.
      See Also:
    • searchDocumentsPaging$UPDATES

      static final boolean searchDocumentsPaging$UPDATES
      Deprecated.
      See Also:
    • getViewableDocumentsPaging$UPDATES

      static final boolean getViewableDocumentsPaging$UPDATES
      Deprecated.
      See Also:
    • getDocumentsList$UPDATES

      static final boolean getDocumentsList$UPDATES
      Deprecated.
      See Also:
    • getSystemDocumentId$UPDATES

      static final boolean getSystemDocumentId$UPDATES
      Deprecated.
      See Also:
    • setSystemDocumentId$UPDATES

      static final boolean setSystemDocumentId$UPDATES
      Deprecated.
      See Also:
    • suggest$UPDATES

      static final boolean suggest$UPDATES
      Deprecated.
      See Also:
    • getContentIdForDocumentId$UPDATES

      static final boolean getContentIdForDocumentId$UPDATES
      Deprecated.
      See Also:
    • getContentIdsForDocumentIds$UPDATES

      static final boolean getContentIdsForDocumentIds$UPDATES
      Deprecated.
      See Also:
    • getDocumentIdForContentId$UPDATES

      static final boolean getDocumentIdForContentId$UPDATES
      Deprecated.
      See Also:
    • getDocumentIdsForContentIds$UPDATES

      static final boolean getDocumentIdsForContentIds$UPDATES
      Deprecated.
      See Also:
  • Method Details