Difference between revisions of "GenerateDocument"
From AgileApps Support Wiki
imported>Aeric |
imported>Aeric |
||
(23 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
{{DISPLAYTITLE:generateDocument}} | {{DISPLAYTITLE:generateDocument}} | ||
Generates a document based on an HTML [[Create an HTML Document Template|Document Template]]. | Generates a document based on an HTML [[Create an HTML Document Template|Document Template]]. | ||
Line 11: | Line 5: | ||
:<syntaxhighlight lang="java" enclose="div"> | :<syntaxhighlight lang="java" enclose="div"> | ||
Result result; | Result result; | ||
result = Functions.generateDocument(String | result = Functions.generateDocument(String object, String recordID, | ||
String | String templateID, String format); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
'''Parameters''' | '''Parameters''' | ||
:; | :;object:The name or identifier of the object that contains the record of interest. | ||
:;recordID:The identifier of the | :;recordID:The identifier of the record to pass to the template. | ||
:; | :;printTemplate:The identifier of the [[Document Template]]. | ||
:;format: | ::To get the template ID: | ||
:::* Go to '''[[File:GearIcon.png]] > Objects > {object} > Document Templates''' | |||
:::* Click the Wrench icon to edit the view or create a new one | |||
:::* Add the recordID field to the view | |||
:::* In the listing, find the ID of the Document Template you'll be using | |||
:;format:<tt>CONSTANTS.DOCUMENT.HTML</tt> -or- <tt>CONSTANTS.DOCUMENT.PDF</tt> | |||
::This option applies to HTML and PDF templates. Word templates always produce Word files. PowerPoint templates produce PowerPoint files. | |||
'''Return''' | '''Return''' | ||
:[[Result Class|<tt>Result</tt> object]] | |||
[[ | ;Usage: | ||
::* Get the object name from the [[Object Properties]] | |||
::* Get the template name from the [[Document Template]] | |||
::* Get the record ID from the [[incoming parameters]] | |||
::* Use <tt>result.getID()</tt> to retrieve the document ID | |||
::* Pass it to the [[getDocument]] method to get a {{^PlatformFileBean}} that contains the document | |||
;Example:This example calls <tt>generateDocument</tt> | ;Example:This example calls <tt>generateDocument</tt> on a case to create an HTML document. | ||
:<syntaxhighlight lang="java" enclose="div"> | :<syntaxhighlight lang="java" enclose="div"> | ||
String | String printTemplate = ""; // Code this value | ||
String | String recordID = ""; // Get this value from incoming parameters | ||
// | ... | ||
Result result = Functions.generateDocument("cases", recordID, printTemplate, CONSTANTS.DOCUMENT.HTML); | |||
Result result = Functions.generateDocument(" | |||
int resultCode = result.getCode(); | int resultCode = result.getCode(); | ||
if(resultCode < 0) | if(resultCode < 0) | ||
Line 38: | Line 43: | ||
String msg = "Some Message"; | String msg = "Some Message"; | ||
Logger.info(msg + ":\n" + result.getMessage(), "Doc"); // Log details | Logger.info(msg + ":\n" + result.getMessage(), "Doc"); // Log details | ||
Functions.throwError(msg + "."); // Error | Functions.throwError(msg + "."); // Error message | ||
} | } | ||
else | else | ||
{ | { | ||
// | String doc_id = result.getID(); | ||
PlatformFileBean file = Functions.getDocument(doc_id); | |||
// Additional business logic... | |||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
<noinclude> | <noinclude> | ||
[[Category: | [[Category:Java API]] | ||
</noinclude> | </noinclude> |
Latest revision as of 22:46, 26 June 2014
Generates a document based on an HTML Document Template.
Syntax
- <syntaxhighlight lang="java" enclose="div">
Result result; result = Functions.generateDocument(String object, String recordID,
String templateID, String format);
</syntaxhighlight>
Parameters
- object
- The name or identifier of the object that contains the record of interest.
- recordID
- The identifier of the record to pass to the template.
- printTemplate
- The identifier of the Document Template.
- To get the template ID:
- format
- CONSTANTS.DOCUMENT.HTML -or- CONSTANTS.DOCUMENT.PDF
- This option applies to HTML and PDF templates. Word templates always produce Word files. PowerPoint templates produce PowerPoint files.
Return
- Usage
-
- Get the object name from the Object Properties
- Get the template name from the Document Template
- Get the record ID from the incoming parameters
- Use result.getID() to retrieve the document ID
- Pass it to the getDocument method to get a PlatformFileBean that contains the document
- Example
- This example calls generateDocument on a case to create an HTML document.
- <syntaxhighlight lang="java" enclose="div">
String printTemplate = ""; // Code this value String recordID = ""; // Get this value from incoming parameters
...
Result result = Functions.generateDocument("cases", recordID, printTemplate, CONSTANTS.DOCUMENT.HTML); int resultCode = result.getCode(); if(resultCode < 0) {
String msg = "Some Message"; Logger.info(msg + ":\n" + result.getMessage(), "Doc"); // Log details Functions.throwError(msg + "."); // Error message
} else {
String doc_id = result.getID(); PlatformFileBean file = Functions.getDocument(doc_id);
// Additional business logic...
} </syntaxhighlight>