Interface DocumentService

All Superinterfaces:
com.google.gwt.user.client.rpc.RemoteService
All Known Implementing Classes:
DocumentServiceImpl

@RemoteServiceRelativePath("document") public interface DocumentService extends com.google.gwt.user.client.rpc.RemoteService
The client side stub for the Document Service. This service allows r/w operations on documents.
Since:
6.0
Author:
Marco Meschieri - LogicalDOC
  • Method Details

    • getById

      GUIDocument getById(long docId) throws ServerException
      Retrieves a specific document by its ID
      Parameters:
      docId - identifier of the document
      Returns:
      the document retrieved by the server application
      Throws:
      ServerException - an error happened in the server application
    • save

      GUIDocument save(GUIDocument document) throws ServerException
      Saves the document in the DB
      Parameters:
      document - The document to save
      Returns:
      The saved document
      Throws:
      ServerException - an error happened in the server application
    • validate

      void validate(GUIDocument document) throws ServerException
      Validates the metadata
      Parameters:
      document - The document to validate
      Throws:
      ServerException - in case of invalid instance, this exception contains the errors
    • rename

      GUIDocument rename(long documentId, String name) throws ServerException
      Renames the given document
      Parameters:
      documentId - identifier of the documents
      name - the new document's filename
      Returns:
      The updated document
      Throws:
      ServerException - an error happened in the server application
    • getVersionsById

      List<GUIVersion> getVersionsById(long id1, long id2) throws ServerException
      Retrieves two specific versions by its ID
      Parameters:
      id1 - identifier of the first version
      id2 - identifier of the second version
      Returns:
      the two versions
      Throws:
      ServerException - an error happened in the server application
    • sendAsEmail

      String sendAsEmail(GUIEmail email, String locale) throws ServerException
      Sends a document as email(attachment or download ticket)
      Parameters:
      email - the email to send
      locale - the locale specification
      Returns:
      "ok" otherwise an error code
      Throws:
      ServerException - an error happened in the server application
    • extractEmail

      GUIEmail extractEmail(long docId, String fileVersion) throws ServerException
      Extracts the email representation from a .eml or .msg file
      Parameters:
      docId - the identifier of the mail document
      fileVersion - the File Version
      Returns:
      the email representation
      Throws:
      ServerException - an error happened in the server application
    • saveEmailAttachment

      GUIDocument saveEmailAttachment(long docId, String fileVersion, String attachmentFileName) throws ServerException
      Extracts an email attachment and saves it in the same folder of the document
      Parameters:
      docId - the identifier of the mail document
      fileVersion - the File Version
      attachmentFileName - name of the attachment
      Returns:
      the just created document
      Throws:
      ServerException - an error happened in the server application
    • updateLink

      void updateLink(long id, String type) throws ServerException
      Updates the links type
      Parameters:
      id - The link identifier
      type - The new type to be set
      Throws:
      ServerException - an error happened in the server application
    • deleteLinks

      void deleteLinks(List<Long> ids) throws ServerException
      Deletes a selection of links
      Parameters:
      ids - identifiers of the links
      Throws:
      ServerException - an error happened in the server application
    • deleteVersions

      GUIDocument deleteVersions(List<Long> ids) throws ServerException
      Deletes a selection of versions
      Parameters:
      ids - identifiers of the versions
      Returns:
      the document the deleted versions belongs to
      Throws:
      ServerException - an error happened in the server application
    • linkDocuments

      void linkDocuments(List<Long> inDocIds, List<Long> outDocIds) throws ServerException
      Links a set of documents
      Parameters:
      inDocIds - identifiers of the documents for the IN direction
      outDocIds - identifiers of the documents for the OUT direction
      Throws:
      ServerException - an error happened in the server application
    • delete

      void delete(List<Long> ids) throws ServerException
      Deletes a selection of documents
      Parameters:
      ids - identifiers of the documents
      Throws:
      ServerException - an error happened in the server application
    • destroyDocuments

      void destroyDocuments(List<Long> ids) throws ServerException
      Permanently deletes a selection of documents, no restore will be possible later
      Parameters:
      ids - identifiers of the documents
      Throws:
      ServerException - an error happened in the server application
    • deleteFromTrash

      void deleteFromTrash(List<Long> ids) throws ServerException
      Deletes a selection of documents from trash
      Parameters:
      ids - identifiers of documents
      Throws:
      ServerException - an error happened in the server application
    • emptyTrash

      void emptyTrash() throws ServerException
      Clear the user's trash
      Throws:
      ServerException - an error happened in the server application
    • makeImmutable

      void makeImmutable(List<Long> docIds, String comment) throws ServerException
      Makes immutable a set of documents
      Parameters:
      docIds - identifiers of the documents
      comment - the commit
      Throws:
      ServerException - an error happened in the server application
    • archiveDocuments

      void archiveDocuments(List<Long> docIds, String comment) throws ServerException
      Archives a set of documents
      Parameters:
      docIds - identifiers of the documents
      comment - the commit
      Throws:
      ServerException - an error happened in the server application
    • archiveFolder

      long archiveFolder(long folderId, String comment) throws ServerException
      Archives the documents in a folder
      Parameters:
      folderId - identifier of the folder
      comment - a comment for the action
      Returns:
      number of records added to the archive
      Throws:
      ServerException - an error happened in the server application
    • convert

      GUIDocument convert(long docId, String fileVersion, String format) throws ServerException
      Converts a document in a given format
      Parameters:
      docId - identifier of the document to convert
      fileVersion - version of the file
      format - the format to convert to (e.g.: pdf, txt, ...
      Returns:
      the converted document
      Throws:
      ServerException - an error happened in the server application
    • countDocuments

      long countDocuments(List<Long> folderIds, int status) throws ServerException
      Counts the documents in a given status contained the specified folder's trees
      Parameters:
      folderIds - identifiers of the folders
      status - a filter on the document's status
      Returns:
      the count
      Throws:
      ServerException - an error happened in the server application
    • unlock

      void unlock(List<Long> docIds) throws ServerException
      Unlocks a set of documents
      Parameters:
      docIds - identifiers of the documents
      Throws:
      ServerException - an error happened in the server application
    • lock

      void lock(List<Long> docIds, String comment) throws ServerException
      Locks a set of documents
      Parameters:
      docIds - identifiers of the documents
      comment - the comment to the lock
      Throws:
      ServerException - an error happened in the server application
    • checkout

      void checkout(List<Long> docIds) throws ServerException
      Checks out the document
      Parameters:
      docIds - identifiers of the documents
      Throws:
      ServerException - an error happened in the server application
    • addDocuments

      List<GUIDocument> addDocuments(String language, long folderId, boolean importZip, String charset, boolean immediateIndexing, Long templateId) throws ServerException
      Adds new documents previously uploaded
      Parameters:
      language - The language applied to all documents
      folderId - The destination folder identifier
      importZip - If .zip files have to be unpacked and the contained documents imported
      charset - Charset to use to process the .zip files
      immediateIndexing - If the documents must be immediately indexed
      templateId - The documents template
      Returns:
      The list of created documents
      Throws:
      ServerException - an error happened in the server application
    • addDocuments

      List<GUIDocument> addDocuments(boolean importZip, String charset, boolean immediateIndexing, GUIDocument metadata) throws ServerException
      Throws:
      ServerException
    • createDownloadTicket

      List<String> createDownloadTicket(long docId, int type, String suffix, Integer expireHours, Date expireDate, Integer maxDownloads, Integer maxViews) throws ServerException
      Creates a download ticket
      Parameters:
      docId - identifier of the document
      type - the ticket type (0='download' 2='view')
      suffix - the suffix(null or 'pdf')
      expireHours - how many validity hours
      expireDate - the exact expiration date
      maxDownloads - maximum number of allowed downloads
      maxViews - maximum number of allowed views
      Returns:
      the generated ticket ID, a sample URL using the browser's URL, a sample URL using the server.url setting
      Throws:
      ServerException - an error happened in the server application
    • deleteTicket

      void deleteTicket(long ticketId) throws ServerException
      Throws:
      ServerException
    • enableTicket

      void enableTicket(long ticketId) throws ServerException
      Throws:
      ServerException
    • disableTicket

      void disableTicket(long ticketId) throws ServerException
      Throws:
      ServerException
    • indexDocuments

      void indexDocuments(List<Long> docIds) throws ServerException
      Indexes the given set of documents
      Parameters:
      docIds - The set of documents to index
      Throws:
      ServerException - an error happened in the server application
    • checkin

      GUIDocument checkin(GUIDocument document, boolean major) throws ServerException
      Checks-in a new document version
      Parameters:
      document - The document to update
      major - True if this is a major version
      Returns:
      The updated document
      Throws:
      ServerException - an error happened in the server application
    • checkinContent

      GUIDocument checkinContent(long docId, String content) throws ServerException
      Checks-in a new document's text content
      Parameters:
      docId - identifier of the document
      content - content of the file
      Returns:
      the document
      Throws:
      ServerException - an error happened in the server application
    • replaceFile

      void replaceFile(long docId, String fileVersion, String comment) throws ServerException
      Replaces the file associated to a given version
      Parameters:
      docId - the identifier of the document
      fileVersion - the file version
      comment - the comment
      Throws:
      ServerException - an error happened in the server application
    • promoteVersion

      GUIDocument promoteVersion(long docId, String version) throws ServerException
      If you promote a prior version, what it does is make it the default version again. (regardless of there being many versions)
      Parameters:
      docId - the identifier of the document
      version - version specification
      Returns:
      the document
      Throws:
      ServerException - an error happened in the server application
    • createDocument

      GUIDocument createDocument(GUIDocument document, String content) throws ServerException
      Creates a new document with the given text content
      Parameters:
      document - the document to create
      content - the contents
      Returns:
      the created document
      Throws:
      ServerException - an error happened in the server application
    • getContentAsString

      String getContentAsString(long docId) throws ServerException
      Retrieves the document's content as a string
      Parameters:
      docId - identifier of the document
      Returns:
      the document's extracted content
      Throws:
      ServerException - an error happened in the server application
    • restore

      void restore(List<Long> docIds, long folderId) throws ServerException
      Restores a given document
      Parameters:
      docIds - identifiers of the documents
      folderId - identifier of the folder in which to restore the documents
      Throws:
      ServerException - an error happened in the server application
    • unarchiveDocuments

      void unarchiveDocuments(List<Long> docIds) throws ServerException
      Restores a given set of archived documents
      Parameters:
      docIds - identifiers of the documents
      Throws:
      ServerException - an error happened in the server application
    • addBookmarks

      void addBookmarks(List<Long> targetIds, int type) throws ServerException
      Adds new bookmarks
      Parameters:
      targetIds - identfiers of the documents or folders to bookmark
      type - the type of bookmark (0 = document, 1 = folder)
      Throws:
      ServerException - an error happened in the server application
    • deleteBookmarks

      void deleteBookmarks(List<Long> bookmarkIds) throws ServerException
      Deletes a set of bookmarks
      Parameters:
      bookmarkIds - identifiers of the bookmarks to delete
      Throws:
      ServerException - an error happened in the server application
    • updateBookmark

      void updateBookmark(GUIBookmark bookmark) throws ServerException
      Updates a single bookmark's data
      Parameters:
      bookmark - the bookmark to update
      Throws:
      ServerException - an error happened in the server application
    • markHistoryAsRead

      void markHistoryAsRead(String event) throws ServerException
      Marks as read the histories related to the current user and the given event.
      Parameters:
      event - The history event to mark as read
      Throws:
      ServerException - an error happened in the server application
    • markUnindexable

      void markUnindexable(List<Long> docIds) throws ServerException
      Marks a set of documents as unindexable
      Parameters:
      docIds - identifiers of the documents
      Throws:
      ServerException - an error happened in the server application
    • markIndexable

      void markIndexable(List<Long> docIds, int policy) throws ServerException
      Marks a set of documents as indexable
      Parameters:
      docIds - identifiers of the documents
      policy - indexing policy: Constants.INDEX_TO_INDEX or Constants.INDEX_TO_INDEX_METADATA
      Throws:
      ServerException - an error happened in the server application
    • cleanUploadedFileFolder

      void cleanUploadedFileFolder() throws ServerException
      Cleans the uploaded files folder
      Throws:
      ServerException - an error happened in the server application
    • getRating

      GUIRating getRating(long docId) throws ServerException
      Retrieves the rating of the given document
      Parameters:
      docId - identifier of the document
      Returns:
      the rating retrieved by the server application
      Throws:
      ServerException - an error happened in the server application
    • saveRating

      int saveRating(GUIRating rating) throws ServerException
      Save a rating vote on a document
      Parameters:
      rating - the document's rating
      Returns:
      the new document rating value
      Throws:
      ServerException - an error happened in the server application
    • addNote

      long addNote(long docId, String note) throws ServerException
      Adds a new document note on the given document
      Parameters:
      docId - identifier of the document
      note - the note's text
      Returns:
      identifier of the created note
      Throws:
      ServerException - an error happened in the server application
    • updateNote

      void updateNote(long docId, long noteId, String fileVersion, String note) throws ServerException
      Updates a document note on the given document
      Parameters:
      docId - identifier of the document
      noteId - identifier of the note
      fileVersion - file version to bind the note to
      note - text of the note
      Throws:
      ServerException - an error happened in the server application
    • getNotes

      List<GUIDocumentNote> getNotes(long docId, String fileVersion, Collection<String> types) throws ServerException
      Retrieves the notes of a document
      Parameters:
      docId - identifier of the document
      fileVersion - file version specification
      types - optional filter for the note type
      Returns:
      the notes on the given version
      Throws:
      ServerException - an error happened in the server application
    • saveNotes

      void saveNotes(long docId, String fileVersion, List<GUIDocumentNote> notes, Collection<String> types) throws ServerException
      Saves a set of notes
      Parameters:
      docId - identifier of the document
      fileVersion - optional file version all the notes are bound to
      notes - the notes to save
      types - optional filter for the note type
      Throws:
      ServerException - an error happened in the server application
    • deleteNotes

      void deleteNotes(List<Long> ids) throws ServerException
      Deletes a selection of document notes
      Parameters:
      ids - identifiers of the notes
      Throws:
      ServerException - an error happened in the server application
    • bulkUpdate

      List<GUIDocument> bulkUpdate(List<Long> ids, GUIDocument vo, boolean ignoreEmptyFields) throws ServerException
      Applies to a selection of documents all the given data
      Parameters:
      ids - identifiers of the documents to update
      vo - the value object to use as template
      ignoreEmptyFields - flag to skip fields empty in the vo
      Returns:
      the updated documents
      Throws:
      ServerException - an error happened in the server application
    • createWithContent

      GUIDocument createWithContent(GUIDocument vo, String content, boolean checkout) throws ServerException
      Creates a new empty document
      Parameters:
      vo - the value object to use as template
      content - the text body of the new document
      checkout - if the new document must be checked out
      Returns:
      the created document
      Throws:
      ServerException - an error happened in the server application
    • setPassword

      void setPassword(long docId, String password) throws ServerException
      Puts a password protection to the document
      Parameters:
      docId - the identifier of the document to protect
      password - the password to assign
      Throws:
      ServerException - an error happened in the server application
    • unsetPassword

      void unsetPassword(long docId, String password) throws ServerException
      Removes the password protection from the document
      Parameters:
      docId - the identifier of the document to unprotect
      password - the password to clear
      Throws:
      ServerException - an error happened in the server application
    • unprotect

      boolean unprotect(long docId, String password) throws ServerException
      Checks if the document can be accessed with the given password
      Parameters:
      docId - the identifier of the document to unprotect
      password - the password to clear
      Returns:
      is the password is correct
      Throws:
      ServerException - an error happened in the server application
    • getUserRating

      GUIRating getUserRating(long docId) throws ServerException
      Retrieves the vote of the current user on the specified document
      Parameters:
      docId - the identifier of the document
      Returns:
      the rating
      Throws:
      ServerException - an error happened in the server application
    • deleteRating

      Integer deleteRating(long id) throws ServerException
      Deletes a vote
      Parameters:
      id - identifier of the rating to delete
      Returns:
      the result
      Throws:
      ServerException - an error happened in the server application
    • replaceAlias

      GUIDocument replaceAlias(long aliasId) throws ServerException
      Replaces an alias with a copy of the original file
      Parameters:
      aliasId - ID of the alias to replace
      Returns:
      the just created document
      Throws:
      ServerException - an error happened in the server application
    • deDuplicate

      void deDuplicate(Long folderId, boolean retainNewest) throws ServerException
      Convert duplicates with aliases, just one of the documents is maintained
      Parameters:
      folderId - optional ID of the folder to process
      retainNewest - true if the newest has to be retained, otherwise it will be the oldest.
      Throws:
      ServerException - an error happened in the server application
    • enforceFilesIntoFolderStorage

      void enforceFilesIntoFolderStorage(long folderId) throws ServerException
      Enforces that all the files in the given tree are stored in the storage configured in the owning folder. The process is asynchronous, at the end an internal message to the user will be sent to alert him about its end.
      Parameters:
      folderId - identifier of the tree root
      Throws:
      ServerException - an error happened in the server application
    • merge

      GUIDocument merge(List<Long> docIds, long targetFolderId, String fileName) throws ServerException
      Merges a set of documents into a single PDF
      Parameters:
      docIds - identifiers of the documents to merge
      targetFolderId - identifier of the folder that will receive the merged PDF
      fileName - file name of the merged file
      Returns:
      the newly created merged document
      Throws:
      ServerException - an error happened in the server application
    • updatePages

      int updatePages(long docId) throws ServerException
      Counts the pages of a document and updates the DB.
      Parameters:
      docId - identifier of the document
      Returns:
      number of pages
      Throws:
      ServerException - an error happened in the server application
    • getAllowedPermissions

      GUIAccessControlEntry getAllowedPermissions(List<Long> docIds) throws ServerException
      Gets the allowed permissions on a set of documents in regards of the current user
      Parameters:
      docIds - collection of the documents
      Throws:
      ServerException
    • saveACL

      void saveACL(GUIDocument document) throws ServerException
      Applies all security settings to document
      Parameters:
      document - The document that will contain the new security settings
      Throws:
      ServerException - an error happened in the server application
    • applyParentFolderSecurity

      void applyParentFolderSecurity(long docId) throws ServerException
      Applies all security settings from the folder to the document
      Parameters:
      docId - The document that will contain the new security settings
      Throws:
      ServerException - an error happened in the server application