Highlighted

Is there no supporting documentation for the Services shipped with Workbench? (generatePDFOutput in

Avatar

16-10-2008

I'm trying to build a process that saves a form (as completed by a user) to the server's file system. The generatePDFOutput Service isn't working (runs forever) and the help pages do nothing much more than list the property fields names. Surely it isn't uncommon to want to save a copy of the form before or when the process completes?



Any and all help is welcome!

Replies

Highlighted

Avatar

Avatar

Jasmin_Charbonn

Avatar

Jasmin_Charbonn

Jasmin_Charbonn

16-10-2008

You can use the Write operations from the File Utilities service (under Foundation)to write things to the file system.



Jasmin
Highlighted

Avatar

17-10-2008

Thank you Jasmin. I have looked at the File Utilities but it appears that I first need to merge the user's data into the form and store it in variable of type 'document'. I can then pass the variable as input to the Write Document service. Using generatePDFOutput to create the document variable doesn't seem to work.



Any examples or documentation links would be greatly appreciated.



John
Highlighted

Avatar

Avatar

Jasmin_Charbonn

Avatar

Jasmin_Charbonn

Jasmin_Charbonn

17-10-2008

I don't have time to find the doc, but ultimately, generatePDFOutput has three main property.



Form: This is URL to the form template. If you use the repository, then it'll be somtehign like /myFolfer/MyForm.xdp



Content Root: This is where the xdp are stored. If you use the built-in repository then you put repository://



Data: If you need to merge data with the form.



JAsmi
Highlighted

Avatar

04-11-2008

I guess it's safe to say that there is no useful documentation? Adobe support (Platinum) has yet to come up with anything...
Highlighted

Avatar

Avatar

Jasmin_Charbonn

Avatar

Jasmin_Charbonn

Jasmin_Charbonn

04-11-2008

John,

There's plenty of documentation available out there.



Did you try to read the documents at http://www.adobe.com/support/documentation/en/livecycle/



The LiveDocs contain a bunch on information that couls be useful. See http://livedocs.adobe.com/livecycle/8.2/programLC/programmer/help/wwhelp/wwhimpl/js/html/wwhelp.htm?...



Also for the services in Workbench you can do a search in the Workbech help. This is what you would find for generatePDFOutput:



Generates a PDF or a PDF/A output stream given a form design and data to merge with the form design.



For information about the General and Route Evaluation property groups, see Common operation properties.



Input

Properties to specify a form design, data, and PDF options.



Transformation Format

A TransformationFormat value that specifies the format to which the document is transformed. Valid string values are PDF and PDFA. The default is PDF.



Form

A string value that represents the name of the form design used to generate an output stream. There is no default.



Content Root

A string value that represents the root for the form design and its collateral files. There is no default.



PDF Output Options

(Optional) A PDFOutputOptionsSpec object that contains run-time values that the Output service uses.



If you provide a literal value, you must specify the following groups of properties.



General



XCI URI: A string value that specifies the XCI file to use. There is no default.



Character Set: A string value that represents the character set used to encode the output byte stream. There is no default.



Locale: A string value that represents the locale to use. There is no default.



Batch



Record Name: A string value that represents the element name that identifies the beginning of a batch of records. There is no default.



Record Level: An integer value that represents the XML element level that contains the record data. The default is 1.



Generate Multiple Streams: A boolean value that specifies whether the operation creates a single output stream or multiple output streams. A value of True indicates that the operation creates multiple output streams. A default of False indicates that the operation is limited to a single output stream.



Rules



Pattern Match Size: An integer value that represents the number of bytes to use from the beginning of the input data file to scan for the pattern strings. The default is 500. For information about working with search rules, see Designing Forms for Output ES.



Pattern Matching Rules: A list of search rules that scan the input data file for a pattern and associates the data with a specific form design. There are no defaults. For information about working with search rules, Designing Forms for Output ES.



Destination



Output Location URI: A string value that represents the URI of the file and path to save the output file to. There is no default.



Printer Name: A string value that represents the name of the printer. The LiveCycle ES server must access to the specified printer. There is no default.



LPD URI: A string value that represents the URI of the Line Printer Daemon (LPD) to use when the network has an LP daemon running. There is no default.



LPD Printer Name: A string value that represents the name of the printer on the specified Line Printer Daemon (LPD) URI when the network has an LP daemon running. There is no default.



MetaData



Meta Data Spec File: A string value that represents the URI of the meta data spec file. This value is used to generate metadata. There is no default.



Record ID XPath: A string value that represents the XPath expression value of the node that contains the record identifier. There is no default.



Generate Record Level Meta Data: A boolean value that specifies whether the meta data file for each record is generated. The default is False.



Render Options

(Optional) A RenderOptionsSpec-OutputService value that specifies how the output is rendered. The render options that you see if you provide a literal value depend on the value selected for the Transformation Format property.



When you select a value of PDF for the Transformation Format property, the following render options are available.

PDF Version: The PDF version produced by the service. Valid values are 1.5, 1.6, 1.7, and Auto. There is no default.



Acrobat Version: Select a value to specify the Acrobat version that is required to view the PDF form that is rendered. The following values are supported:



Acrobat and Adobe Reader 6 or later: The client must have Acrobat 6 or later.



Acrobat and Adobe Reader 7.0 or later: The client must have Acrobat 7 or later.



Acrobat and Adobe Reader 7.0.5 or later: The client must have Acrobat 7.0.5 or later.



Acrobat and Adobe Reader 8 or later: The client must have Acrobat 8.0 or later.



Acrobat and Adobe Reader 8.1 or later: The client must have Acrobat 8.1 or later.



Acrobat and Adobe Reader 9 or later: The client must have Acrobat 9.0 or later.



Auto: The Forms service determines version to use.



Tagged PDF: A boolean value that specifies whether the operation produces a tagged PDF. This value is not valid for PDF/A output because PDF/A 1A is always tagged and PDF/A 1B is never tagged. The default is False.



Linearized PDF: A boolean value that specifies whether the operation produces a PDF optimized for for fast viewing in a web browser. The default is False.



Render At Client: Enables the delivery of PDF content by using the client-side rendering capability of Acrobat 7.0 or later. Valid values are Auto, Yes, and No.



Debug Enabled: A boolean value that specifies whether the Debug Enabled option is enabled.



When you select a value of PDF/A for the Transformation Format property, the following render options are available.

Linearized PDF: A boolean value that specifies whether the operation produces a PDF optimized for for fast viewing in a web browser. The default is False.



Debug Enabled: A boolean value that specifies whether the debugging is enabled. The default is False.



PDF/A Revision Number: A string value that represents the PDF/A revision number. The default is Revision_1.



PDF/A Conformance: A string value that specifies the conformance level with the PDF/A-1 specification to use. Valid values are A and B. The default is A.



Input Data

(Optional) A document value that represents the data to be merged with the form design.



If you provide a literal value, clicking the ellipsis button opens the Open dialog box, in which you can select a file from a local computer or network location.



Output

Properties to specify where to store the results of the operation.



PDF Output

The location to store the PDF output. The data type is document.



Meta Data Document

The location to store the metadata. The data type is document.



Status Document

The location to store the status result of the operation. The data type is document.



Output Result

The location to store the results of the operation. The data type is OutputResult.
Highlighted

Avatar

04-11-2008

Yes, thank you - but when you think you've entered valid parameters and the component doesn't work (runs endlessly until forced to terminate), how do you figure out where the problem is? Some simple supporting examples that are known to work would allow us to verify that the component isn't broken and that we're simply doing something wrong. To date, I see no evidence that anyone has successfully used generatePDFOutput. Adobe support certainly hasn't suggested they have...
Highlighted

Avatar

Avatar

Jasmin_Charbonn

Avatar

Jasmin_Charbonn

Jasmin_Charbonn

04-11-2008

OK,

I'll get you going.



Tell me the settings you're using and the error you're getting. There must be something in the log from the application server if there is an error.



The record and playback feature might also be useful to track the exception.



Let me know,



Jasmin
Highlighted

Avatar

05-11-2008

Thanks for the offer Jasmin. The problem is that generatePDFOutput runs with my parameters but never completes. It doesn't stall or error out...



I'll examine the logs again but I'm pretty sure nothing gets reported. Adminui shows me that the process is "running" and that's where it stays until I force it to terminate.
Highlighted

Avatar

Avatar

Jasmin_Charbonn

Avatar

Jasmin_Charbonn

Jasmin_Charbonn

05-11-2008

Does it create an output? It shouldn't just run without completing.



Still let me know your parameters. Maybe I'll see something.



Jasmin