Rendering rights-enabled forms using the web service API

To render a rights-enabled form using the web service API, perform the following tasks:

1.	Include project files

•	Create Java proxy classes that consume the Forms service WSDL. For information, see Creating Java proxy classes using Apache Axis.

•	Include the Java proxy classes into your class path.

2.	Create a Forms Client API object

Create a FormsService object and set authentication values.

3.	Set usage rights run-time options

•	Create a ReaderExtensionSpec object by using its constructor.

•	Specify the alias of the credential by invoking the ReaderExtensionSpec object’s setReCredentialAlias method and specify a string value that represents the alias value.

•

Set each usage right by invoking the corresponding method that belongs to the ReaderExtensionSpec object. However, you can only set a usage right if the credential that you reference allows you to do so. That is, you cannot set a usage right if the credential does not allow you to set it. To set the usage right that enables a user to fill in form fields and save the form, invoke the ReaderExtensionSpec object’s setReFillIn method and pass true.

4.	Render a rights-enabled form

Invoke the FormsService object’s renderPDFFormWithUsageRights method and pass the following values:

•	A string value that specifies the form design name, including the file name extension. If you are referencing a form design that is saved in the LiveCycle ES repository, ensure that you specify the / character before the file name.

•	A BLOB object that contains data to merge with the form. If you do not want to merge data with the form, then you must pass a BLOB object that is based on an empty XML data source. You cannot pass a BLOB object that is null; otherwise, an exception is thrown.

•	A PDFFormRenderSpec object that stores run-time options. For information about this object, see LiveCycle ES API References.

•	A ReaderExtensionSpec object that stores usage rights run-time options.

•	A URLSpec object that contains URI values that are required by the Forms service. For information, see Specify URI values.

The renderPDFFormWithUsageRights method returns a FormsResult object that contains a form data stream that must be written to the client web browser.

5.	Write the form data stream to the client web browser

•	Create a BLOB object that contains form data by invoking the FormsResult object’s getOutputContent method.

•	Get the content type of the BLOB object by invoking its getContentType method.

•	Set the javax.servlet.http.HttpServletResponse object’s content type by invoking its setContentType method and passing the content type of the BLOB object.

•	Create a javax.servlet.ServletOutputStream object used to write the form data stream to the client web browser by invoking the javax.servlet.http.HttpServletResponse object’s getOutputStream method.

•	Create a byte array and populate it by invoking the BLOB object’s getBinaryData method. This task assigns the content of the FormsResult object to the byte array.

•	Invoke the javax.servlet.http.HttpServletResponse object’s write method to send the form data stream to the client web browser. Pass the byte array to the write method.

View Quick Start

Current page: http://livedocs.adobe.com/livecycle/es/sdkHelp/programmer/sdkHelp/renderingUsageRights.37.4.html