Package com.logicaldoc.gui.frontend.client.services

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 Detail

      • 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

      • getAttributes

        GUIAttribute[] getAttributes​(long templateId)
                      throws ServerException
        Retrieves all attributes of the specified template
        Parameters:
        templateId - identifier of the template
        Returns:
        the attributes
        Throws:
        ServerException - an error happened in the server application

      • getVersionsById

        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​(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​(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​(long[] inDocIds,
                   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​(long[] ids)
     throws ServerException
        Deletes a selection of documents
        Parameters:
        ids - identifiers of the documents
        Throws:
        ServerException - an error happened in the server application

      • deleteFromTrash

        void deleteFromTrash​(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

      • makeImmutable

        void makeImmutable​(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​(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​(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​(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​(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​(long docId)
       throws ServerException
        Checks out the document
        Parameters:
        docId - identifier of the document
        Throws:
        ServerException - an error happened in the server application

      • addDocuments

        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

      • indexDocuments

        void indexDocuments​(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​(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​(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​(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​(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​(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

      • 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 note)
         throws ServerException
        Updates a document note on the given document
        Parameters:
        docId - identifier of the document
        noteId - identifier of the note
        note - text of the note
        Throws:
        ServerException - an error happened in the server application

      • getNotes

        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,
               GUIDocumentNote[] notes,
               Collection<String> types)
        throws ServerException
        Saves a set of notes
        Parameters:
        docId - identifier of the document
        notes - the notes to save
        types - optional filter for the note type
        Throws:
        ServerException - an error happened in the server application

      • deleteNotes

        void deleteNotes​(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

        void bulkUpdate​(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
        Throws:
        ServerException - an error happened in the server application

      • createWithContent

        GUIDocument createWithContent​(GUIDocument vo,
                              String content)
                       throws ServerException
        Creates a new empty document
        Parameters:
        vo - the value object to use as template
        content - the text body of the new document
        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