Rationalizing links

Links in PDF documents can refer to other documents. Such links are called cross-document links. When the user clicks such a link in a viewer application such as Acrobat, the location in the other document is displayed.

When assembling documents, some source documents may have cross-document links to documents that are represented by other sources in the assembly. In this example, suppose that you have two documents called chapter1.pdf and chapter2.pdf and want to assemble them using the following DDX.

Example: Assembling documents with cross-document links

<PDF result="book.pdf">

	<PDF source="chapter1.pdf"/>

	<PDF source="chapter2.pdf"/>

</PDF>

Suppose further that chapter1.pdf contains one or more cross-document links to chapter2.pdf and chapter2.pdf contains one or more cross-document links to chapter1.pdf. In this case, you may want to have the links refer to the destination in the result document, rather than pointing to an external document.

A difficulty with doing this is that the names of source elements in DDX have no necessary relationship to the original file names. If LiveCycle PDF Assembler encounters a link whose destination is a file called chapter2.pdf, it does not assume that this file is the same as the PDF source element chapter2.pdf.

You must explicitly specify the source names that correspond to file names that appear in cross-document links. To do this, you use the LinkAlias element as a child of a PDF source, as shown in this example.

Example: Specifying link aliases

<PDF result="book.pdf">

	<PDF source="chapter1.pdf" baseDocument="true">

		<LinkAlias>Chapter1</LinkAlias>

		<LinkAlias>chapter1.pdf</LinkAlias>

	</PDF>

	<PDF source="chapter2.pdf">

		<LinkAlias>Chapter2</LinkAlias>

		<LinkAlias>chapter2.pdf></LinkAlias>

	</PDF>

</PDF>

For example, any cross-document links in the base document to files named "Chapter2" or "chapter2.pdf" would be resolved to refer to the correct location in the result document.

 

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/assemblePDFComments.98.7.html

Add Comment