Difference between revisions of "GetDocument"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{DISPLAYTITLE:__apiName__}}
{{DISPLAYTITLE:getDocument}}
Description...
Retrieves a document specified by its ID.


;Syntax:
;Syntax:
:<syntaxhighlight lang="java" enclose="div">
:<syntaxhighlight lang="java" enclose="div">
Result result = Functions.__apiName__(String objectName, String fields, String criteria);
Result result = Functions.getDocument(String documentID);  
Result result = Functions.__apiName__(String objectName, String fields, String criteria
                            [, Parameters params] );
Result result = Functions.__apiName__(String objectName, String fields, String criteria);
Result result = Functions.__apiName__(String objectName, String fields, String criteria,
                            String sortBy, String sortOrder,
                            String sortBy2, String sortOrder2,
                            int offset, int numberOfRows);
</syntaxhighlight>
</syntaxhighlight>


;Parameters:
;Parameters:
:;objectName:The object name or identifier
:'''documentID -''' The ID of a document stored in the platform.
:;fields:A comma-separated list of names of the fields to retrieve
:;criteria:A [[JAVA API:Filter Expressions in JAVA APIs|filter expression]] that specifies records to select.
:;params: An optional [[Parameters Class|Parameters]] object that contains additional parameters:
:::*''' param -''' ...


;Returns:
;Returns:
Line 26: Line 15:
;Usage:
;Usage:
:# Use <tt>result.getParameters()</tt> to get the params from the Result object.
:# Use <tt>result.getParameters()</tt> to get the params from the Result object.
:# Call <tt>getPlatformFileBean()<tt> on the params, passing the document ID as a string.
:# Call <tt>getPlatformFileBean()</tt> on the params, passing the document ID as a string.
:# If needed, call <tt>getBytes()</tt> on the PlatformFileBean to get document content in a byte array.  
:# If needed, call <tt>getBytes()</tt> on the PlatformFileBean to get document content in a byte array.  


;Example:This example logs the size and name associated with a document.
;Example:This example logs the size and name associated with a document.
:<syntaxhighlight lang="java" enclose="div">
:<syntaxhighlight lang="java" enclose="div">
Result result = getDocument(documentId);
Result result = Functions.getDocument(documentId);
Parameters params = result.getParameters();
Parameters params = result.getParameters();
PlatformFileBean file = params.getPlatformFileBean(documentId);
PlatformFileBean file = params.getPlatformFileBean(documentId);

Latest revision as of 00:37, 17 January 2014

Retrieves a document specified by its ID.

Syntax
Result result = Functions.getDocument(String documentID);
Parameters
documentID - The ID of a document stored in the platform.
Returns
Result object that contains the document in the form of a PlatformFileBean.
Usage
  1. Use result.getParameters() to get the params from the Result object.
  2. Call getPlatformFileBean() on the params, passing the document ID as a string.
  3. If needed, call getBytes() on the PlatformFileBean to get document content in a byte array.
Example
This example logs the size and name associated with a document.
Result result = Functions.getDocument(documentId);
Parameters params = result.getParameters();
PlatformFileBean file = params.getPlatformFileBean(documentId);
byte[] bytes = file.getBytes();
String msg = "Name:"+file.getName()+", size:"+file.getEncodedFileContent().length();
Logger.info(msg, "Document");