Result elements

Each DDX document typically contains, as children of the DDX element, one or more result elements. A result element has a result attribute and represents data being returned.

Note: The PDFsFromBookmarks element is an exception: a result element that does not have a result attribute. (See Disassembling PDF documents.)

The example from above is repeated here. It has a single PDF result element, which means that the Assembler service creates a stream named doc1.pdf, representing a PDF document, and returns it to the client.

<PDF result="doc1.pdf"> 

	<PDF source="doc2.pdf"/>

	<PDF source="doc3.pdf"/>

</PDF>

In addition to the PDF element, the following element types can contain a result attribute: Bookmarks, Links, Comments, FileAttachments, and Metadata. The following example has three result elements: two that return PDF and one that returns bookmarks.

Example: Result elements

<DDX>

	<PDF result="doc1.pdf">

		<!-- Additional elements here -->

	</PDF>

	<PDF result="doc2.pdf">

		<!-- Additional elements here -->

	</PDF>

	<Bookmarks result="doc3.xml">

		<!-- Additional elements here -->

	</Bookmarks>

</DDX>

Result elements must be direct children of the DDX element. They have no content initially but take their content from their children, which can include the following elements:

•	Source elements specifying various types of content (see Source elements)

•	Filter elements (see Filter elements)

•	Other elements providing additional pages, page content or modifications to existing content.

Result elements have a return attribute that can be either true (the default) or false. If true, the result is returned to you as a stream (see Input and output). You can set this attribute to false if you do not need the data returned. This is typically the case if the result is being used later in the DDX document as a source element for a subsequent result element.

Note: The FileAttachments and PackageFiles result elements do not have a return attribute, but have an extract attribute that serves a similar purpose (see Working with File Attachments).

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/livecycle/es/sdkHelp/programmer/sdkHelp/assemblePDFDDX_basics.95.5.html

Add Comment