Documentation

Document processing (since 2.9.0)

Document processing feature implements download/edit/upload cycle for particular document, that is already on the server.

The worklfow is:

Download document from supplied location using HTTP GET request.
Store document onto local file system temporary file.
Invoke associated native editor for that document. Following scenarios possible:
- Editor locks file while document is being edited (this is true for microsoft word/excel, but generally not for text editors).
  Jumploader waits until editor release document (generally this happens when document is closed), check if document was modified (comparing file CRC, length and modified before and after editor) and update upload file status to "ready", so user can start upload. If document was not modified then upload queue file will receive "error" status with "Not modified" message.
- Editor fails to execute or doesn't lock file.
  Jumploader will monitor file for modification (modified timestamp or length changed) as long as it remains in the queue. As soon as modification detected, file status will be updated to "ready".
Modified file uploaded to server (manually by user or automatically, if autoUpload flag specified).

Method arguments are:

Parameter	Description
key	General purpose sttring data, can be accessed using IUploadFile.getKey() or written using IUploadFile.setKey( String key )
downloadLocation	The address (full URL) to download document from. It is recommended to specify special token {rnd} in query string (which will be replaced with random number when performing request) to prevent caching. For example: http://server/content?docId=123&x={rnd} will result with smth. like http://server/content?docId=123&x=18274682356283
uploadLocation	The address (full URL) of upload handler. If null, default upload URL will be used.
filename	The file name to use for naming local file and siaply in upload queue.
options	Document processing options — multipurpose configuration string formatted like: key1=value1;key2;key3;key4... Please note, some keys do not accept values. Known keys are: autoUpload — shows whether upload should start automatically after document edit; nocrc — CRC should not be calculated to check whether file has been modified or not; removeDocumentWhileEditing — document removed from transfer queue while being edited; readOnly — set read only flag to downloaded file to prevent document modification (proper editor should respect that); editImage — use jumploader internal image editor;

Demo pages:

advertising