bc
Adobe® Acrobat®
Adobe LiveCycle™ Designer
Version 7.0
Converting Acrobat® JavaScript for Use in 
LiveCycle™ Designer Forms
Auto bookmark pdf - add, remove, update PDF bookmarks in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your C# Project with Rapid PDF Internal Navigation Via Bookmark and Outline
how to add bookmarks on pdf; bookmarks in pdf from word
Auto bookmark pdf - VB.NET PDF bookmark library: add, remove, update PDF bookmarks in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your VB.NET Project with Rapid PDF Internal Navigation Via Bookmark and Outline
bookmark pdf reader; bookmarks pdf files
© 2005 Adobe Systems Incorporated. All rights reserved.
Adobe® Acrobat® Adobe LiveCycle™ 7.0 Designer Converting Acrobat JavaScript for Use in LiveCycle Designer Forms for Microsoft® 
Windows®, UNIX®, and Linux®
Edition 1.0, June 2005
If this guide is distributed with software that includes an end user agreement, this guide, as well as the software described in it, is furnished 
under license and may be used or copied only in accordance with the terms of such license. Except as permitted by any such license, no part 
of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, 
or otherwise, without the prior written permission of Adobe Systems Incorporated. Please note that the content in this guide is protected 
under copyright law even if it is not distributed with software that includes an end user license agreement. 
The content of this guide is furnished for informational use only, is subject to change without notice, and should not be construed as a 
commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or 
inaccuracies that may appear in the informational content contained in this guide. 
Please remember that existing artwork or images that you may want to include in your project may be protected under copyright law. The 
unauthorized incorporation of such material into your new work could be a violation of the rights of the copyright owner. Please be sure to 
obtain any permission required from the copyright owner.
Any references to company names and company logos in sample material or in the sample forms included in this software are for 
demonstration purposes only and are not intended to refer to any actual organization. 
Adobe, the Adobe logo, LiveCycle, and Reader are either registered trademarks or trademarks of Adobe Systems Incorporated in the United 
States and/or other countries. 
IBM is a trademark of International Business Machines Corporation in the United States and/or other countries.
Linux is a registered trademark of Linus Torvalds. 
Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.
UNIX is a registered trademark of The Open Group.
All other trademarks are the property of their respective owners.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.
Notice to U.S. Government End Users. The Software and Documentation are “Commercial Items,” as that term is defined at 48 C.F.R. §2.101, 
consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation,” as such terms are used in 48 C.F.R. 
§12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1 through 227.7202-4, as applicable, 
the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users 
(a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. 
Unpublished-rights reserved under the copyright laws of the United States. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 
95110-2704, USA. For U.S. Government End Users, Adobe agrees to comply with all applicable equal opportunity laws including, if 
appropriate, the provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of 
1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60, 
60-250, and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.
VB.NET PDF Form Data fill-in library: auto fill-in PDF form data
to PDF. Image: Remove Image from PDF Page. Image Link: Edit URL. Bookmark: Edit Bookmark. Metadata: Edit, Delete Data: Read, Extract Field Data. Data: Auto Fill-in
bookmarks in pdf files; create pdf bookmarks
C# PDF Form Data fill-in Library: auto fill-in PDF form data in C#
|. Home ›› XDoc.PDF ›› C# PDF: Auto Fill-in Field Data. C#.NET Demo Code: Auto Fill-in Field Data to PDF in C#.NET. Add necessary references:
excel print to pdf with bookmarks; create bookmarks in pdf from excel
3
Contents
Preface..........................................................................................................................................4
Purpose..............................................................................................................................................................................................4
Audience............................................................................................................................................................................................4
Contents............................................................................................................................................................................................4
1 Converting Acrobat Forms ContainingJavaScript...................................................................7
LiveCycle Designer.........................................................................................................................................................................7
Acrobat and LiveCycle Designer scripting object models..............................................................................................7
Object model differences that affect scripting..................................................................................................................10
Strategy and options...................................................................................................................................................................10
Converting an Acrobat form....................................................................................................................................................11
2 Using Acrobat JavaScript in LiveCycle Designer Forms.........................................................14
Using Acrobat JavaScript in a LiveCycle Designer Form................................................................................................14
A Acrobat JavaScript Conversion Table......................................................................................19
B Getting Started with LiveCycleDesignerForms.....................................................................34
Interfacing with a database......................................................................................................................................................40
C LiveCycle Designer UI Form Logic Example.............................................................................43
VB.NET Create PDF from Excel Library to convert xlsx, xls to PDF
to PDF. Image: Remove Image from PDF Page. Image Link: Edit URL. Bookmark: Edit Bookmark. Metadata: Edit, Delete Data: Read, Extract Field Data. Data: Auto Fill-in
acrobat split pdf bookmark; creating bookmarks in pdf from word
C# PDF Library SDK to view, edit, convert, process PDF file for C#
RasterEdge PDF SDK for .NET package offers robust APIs for editing PDF document hyperlink (url) and quick navigation link in PDF bookmark.
edit pdf bookmarks; how to add bookmarks to pdf document
4
Preface
Purpose
This document explains how to convert JavaScript contained in Adobe® Acrobat® Professional and Acrobat 
Standard forms for use in Adobe LiveCycle™ Designer forms.
Acrobat forms and LiveCycle Designer forms have different scripting object models, although most of the 
Acrobat forms model is supported in LiveCycle Designer forms. This document describes the differences 
and explains how to handle the conversion to help make the conversion as easy and effective as possible.
Information about the general process of converting from Acrobat to LiveCycle Designer forms is available 
in the help section of LiveCycle Designer under the topic Importing Forms from Other Applications.
Audience
This document is intended for form developers who need to convert Acrobat forms containing JavaScript, 
into LiveCycle Designer forms. 
This document may also be useful for form developers who are creating new XML forms and need to add 
Acrobat JavaScript using LiveCycle Designer. 
Contents
In addition to this Preface, this document contains the following chapters:
Chapter 1: “Converting Acrobat Forms ContainingJavaScript
” — Introduces conversion issues, and 
explains how the scripting object models differ. It also discusses how to approach the scripting 
conversion, and how to deal with performance issues.
Chapter 2:”Using Acrobat JavaScript in LiveCycle Designer Forms
” — Describes how Acrobat 
JavaScript can be used in LiveCycle Designer forms, and how to use it to complement LiveCycle 
Designer functionality.
Appendix A:“Acrobat JavaScript Conversion Table
“ — Lists the most commonly used Acrobat 
JavaScript objects and their LiveCycle Designer form equivalent. Specifies the Acrobat JavaScript 
expressions that will or will not work in a LiveCycle Designer form, and which can optionally be 
converted.
Appendix B:”Getting Started with LiveCycleDesignerForms
” — Discusses important issues related to 
events and script levels in LiveCycle Designer forms, as well as how to handle database connections.
Appendix C: “LiveCycle Designer UI Form Logic Example
” — Gives an example of the type of logic 
which can be added using the LiveCycle Designer UI, without the use of scripting. The only example 
given is for a Text field object, and does not attempt to cover all types of objects. 
VB.NET PDF File Split Library: Split, seperate PDF into multiple
Split PDF document by PDF bookmark and outlines in VB.NET. Independent component for splitting PDF document in preview without using external PDF control.
pdf export bookmarks; bookmark page in pdf
C# PDF Convert to Word SDK: Convert PDF to Word library in C#.net
key. Quick to remove watermark and save PDF text, image, table, hyperlink and bookmark to Word without losing format. Powerful components
delete bookmarks pdf; add bookmarks to pdf online
Adobe Acrobat Adobe LiveCycle Designer
Preface
Converting Acrobat JavaScript for Use in LiveCycle Designer Forms
Terminology     5
Terminology
The following terms are used in this document.
Acrobat form 
A form created in Acrobat, as opposed to one created in LiveCycle Designer. 
Acrobat forms use the Acrobat form object model; they are saved as a PDF file; 
and they export/import FDF, XFDF, or XML data.
FDF 
Form Data Format. A file format used by Acrobat forms as a data interchange 
format.
FormCalc 
An LiveCycle forms calculation language based on the XML form object model. It 
is easier to learn and use than JavaScript. FormCalc works both server-side and 
client-side for PDF forms. For LiveCycle Designer forms that will be published as 
HTML forms, it can only be used server-side because the language is not 
supported by Internet browsers. 
form environment  The application space in which the form is running (even if it is HTML in a 
browser, the environment being the browser).
Generally, Acrobat JavaScript (used in a LiveCycle Designer form) allows you to 
manipulate the form environment; LiveCycle Designer JavaScript allows you to 
manipulate the form contents and appearance.
LiveCycle Designer 
form 
An XML form created by using LiveCycle Designer. LiveCycle Designer forms use 
the XML form object model; they can be saved as either PDF or XDP files.
LiveCycle Forms 
The LiveCycle server product that deploys dynamic electronic forms over the 
web. (Formerly known as LiveCycle Forms Server.)
LiveCycle Designer 
JavaScript 
A scripting language supported by LiveCycle Designer which supports the native 
XML form object model. 
LiveCycle Designer 
user interface (UI) 
form logic 
Form features and business logic that you can add by using the LiveCycle 
Designer UI. The result is expressed as XML code as an integral part of the form 
definition.
PDF 
Portable document format. Used as a file format to package LiveCycle Designer 
forms so they can be viewed using Adobe Reader®.
script object 
The LiveCycle Designer script object is an object used to store JavaScript 
functions that can be called from multiple locations in a form. Equivalent to 
Acrobat JavaScript document-level JavaScript.
SOM 
Scripting object model. LiveCycle Designer forms support the LiveCycle Designer 
SOM and parts of the Acrobat SOM.
XDP 
XML data package. A file format option you can create in LiveCycle Designer that 
is used to submit the form design, data, annotations, or other relevant data to 
Adobe LiveCycle Forms to render the form at run time. Must be used if the form 
will initiate server-side processing.
XML Scripting 
Object Model 
The scripting object model used for the XML forms supported by LiveCycle 
server products and by LiveCycle Designer. Both LiveCycle Designer JavaScript 
and FormCalc scripting allow manipulation of the XML scripting object model. 
C# Create PDF from Word Library to convert docx, doc to PDF in C#.
Able to get word count in PDF pages. Change Word hyperlink to PDF hyperlink and bookmark. Free online Word to PDF converter without email.
pdf bookmark editor; bookmark pdf in preview
How to C#: Basic SDK Concept of XDoc.PDF for .NET
XDoc.PDF for .NET allows C# developers to edit hyperlink of PDF document, including editing PDF url links and quick navigation link in bookmark/outline.
create bookmarks pdf files; auto bookmark pdf
Adobe Acrobat Adobe LiveCycle Designer
Preface
Converting Acrobat JavaScript for Use in LiveCycle Designer Forms
Other useful documentation     6
Other useful documentation
The documents listed in this section are referenced in this technical note. 
The following documents are available from the Adobe Solutions Network Web site
.
Acrobat JavaScript
Acrobat JavaScript Scripting Guide 
Acrobat JavaScript Reference 
LiveCycle Designer Forms / JavaScript
Adobe XML Form Object Model 2.2 Reference 
LiveCycle Designer web page for developers
http://partners.adobe.com/public/developer/livecycle/topic_designer.html
LiveCycle Designer and Adobe LiveCycle Form Server
See product Help modules for both product.
Conventions used in this document
Font
Used for
Examples
monospaced
Paths and filenames
C:\templates\mytmpl.fm 
Code examples set off from 
plain text
These are variable declarations:
AVMenu commandMenu,helpMenu;
blue 
Live links to web pages
The Adobe website URL is:
http://www.adobe.com
Live links to sections within this 
document
See 
Converting Acrobat Forms 
ContainingJavaScript
” on page7
italic
LiveCycle Designer Help topics
FormCalc User Reference 
Document titles that are not live 
links
Acrobat and PDF Library API Overview 
New terms
User space specifies coordinates for... 
7
1
Converting Acrobat Forms ContainingJavaScript
This chapter describes the process of converting Acrobat forms to LiveCycle Designer forms, and explains 
the differences between the Acrobat and LiveCycle Designer form object models. It also discusses the 
available options for implementing equivalent form logic in LiveCycle Designer forms.
LiveCycle Designer
LiveCycle Designer lets you build intelligent forms either by using the LiveCycle Designer UI to add form 
logic or by adding JavaScript or FormCalc scripting to the form. The resulting form logic can greatly 
enhance usability and workflow efficiency, for example, by validating data when it is entered and by 
allowing users to work offline.
LiveCycle Designer allows you to create all aspects of the layout, design, and form features, in one 
application. By using LiveCycle Designer, you can avoid the need to go back to a separate layout 
application and then having to recreate the form objects every time an update is made. 
After you have created a form in LiveCycle Designer, it can be saved as a PDF file that contains the XML 
form data. You can also save it as an XDP (XML data package) file, which can be used with LiveCycle Forms; 
or the form can be served as either a PDF or HTML form.
You can also use LiveCycle Designer to import an Acrobat form and convert it into a LiveCycle Designer 
form. This document describes how to plan and execute the conversion process to help you get the 
desired results.
Acrobat and LiveCycle Designer scripting object models
LiveCycle Designer forms support both the Acrobat and the LiveCycle Designer scripting object models 
(SOM). Although most Acrobat JavaScript will work in a LiveCycle Designer form, it is important to 
understand why some expressions will not work, and what options you have when converting (see 
Understanding the Acrobat and LiveCycle Designer form object models
” on page14
).
A simple summary of the two scripting languages would be:
Acrobat JavaScript can be used in a LiveCycle Designer form to handle many tasks related to the form 
environment
; for example you can use it to add attachments, bookmarks, and annotations; search or 
spell check the form; create reports; or access and manipulate metadata. Acrobat JavaScript uses the 
Acrobat forms object model; in a LiveCycle Designer form, it cannot be used to do things like set field 
values, add new fields, or delete pages.
Note:To add Acrobat JavaScript to a LiveCycle Designer form, you must use LiveCycle Designer; you 
cannot use Acrobat. When you view an XML form in Acrobat, all JavaScript tools will be 
grayed-out.
LiveCycle Designer JavaScript can be used to control all aspects of form structure and data. It uses 
the LiveCycle native XML forms object model.
Because of the differences between the two scripting models, there is not a lot of overlap, and hence the 
two object models can be used in a complementary manner. 
Adobe Acrobat Adobe LiveCycle Designer
Converting Acrobat Forms ContainingJavaScript
Converting Acrobat JavaScript for Use in LiveCycle Designer Forms
JavaScript conversion categories     8
JavaScript conversion categories
One of the first steps in the conversion process is to determine how much of the Acrobat JavaScript can be 
used in the LiveCycle Designer form, and how much must be converted to one of the LiveCycle Designer 
options. 
Acrobat JavaScript can be classified into one of three categories with respect to whether it will work in a 
LiveCycle Designer form, as shown in the following table.
The goal should be to convert all Acrobat JavaScript to one of the LiveCycle Designer form logic options 
shown in the table in 
JavaScript conversion options
” on page8
, and use Acrobat JavaScript only for the 
tasks that only it can handle.
There are two main reasons to convert to LiveCycle Designer JavaScript:
The XML data in the form is the true representation of the form appearance and data. If you script 
against the Acrobat scripting model, there is a danger that the PDF and the XML representations might 
not stay aligned with each other.
As the XML form object model is expanded to include additional functionality, it is possible that the 
new functions might replace Acrobat JavaScript functions. By converting to LiveCycle Designer logic, 
you will avoid having deprecated code in your forms.
The Acrobat JavaScripts that should be retained are those that deal with the form’s environment and 
peripheral operations such as adding attachments or multimedia, performing searches or creating reports, 
and handling document metadata.
Appendix A: 
Acrobat JavaScript Conversion Table
” on page19
can be used to determine the category for 
each JavaScript expression, which will help you to plan whether or not the code should be converted.
JavaScript conversion options
Five options for how the logic expressed by Acrobat JavaScript can potentially be implemented in a 
LiveCycle Designer form are shown below. 
Acrobat JavaScript
Action
1. Will work in LiveCycle Designer 
forms, and there is no LiveCycle 
Designer JavaScript equivalent.
Acrobat JavaScript must be enabled (see 
Testing Acrobat 
JavaScript in LiveCycle Designer
” on page18
); doc object code 
must be converted as explained in 
Using Acrobat JavaScript in 
LiveCycle Designer Forms
” on page14
, and be thoroughly 
tested.
2. Will work in LiveCycle Designer 
forms, but conversion to 
LiveCycle Designer JavaScript is 
possible.
If the Acrobat JavaScript can be converted to LiveCycle Designer 
JavaScript, it should be converted (see reasons below).
For Acrobat JavaScript code that will be retained, see 
Using 
Acrobat JavaScript in LiveCycle Designer Forms
” on page14
.
For Acrobat JavaScript that you need to convert, you must 
decide which conversion option to use, as shown in 
JavaScript 
conversion options
” on page8
.”
3. Will not work in LiveCycle 
Designer forms, so it must be 
converted.
Decide which LiveCycle Designer UI form logic option to use, as 
shown in 
JavaScript conversion options
” on page8
.”
Adobe Acrobat Adobe LiveCycle Designer
Converting Acrobat Forms ContainingJavaScript
Converting Acrobat JavaScript for Use in LiveCycle Designer Forms
JavaScript conversion options     9
Note:This document focuses on only the two JavaScript options; for information on the other choices, see 
LiveCycle Designer Help.
The following describes the conversion options shown in illustration above.
Acrobat JavaScript — Most Acrobat JavaScript that does not change the appearance or content of the 
form, will work in a LiveCycle Designer form. Acrobat JavaScript can handle a variety of tasks that 
cannot be done using LiveCycle Designer JavaScript, so you can use it to complement what you can do 
with LiveCycle Designer JavaScript.
Note:See 
Acrobat JavaScript not supported in LiveCycle Designer forms
” on page17
for an overview 
of the expressions that will not work. 
LiveCycle Designer JavaScript — Uses the native scripting object model for LiveCycle Designer 
forms. It can handle all tasks related to structure and content. Converting to LiveCycle Designer 
JavaScript usually requires a steeper learning curve, but the knowledge gained can be applied to all 
future form development.
LiveCycle Designer UI form logic — The form developer can implement a variety of form functions 
and logic using the LiveCycle Designer UI. The resulting logic is expressed in XML as an integral part of 
the form, without any need for scripting. The advantage is that it can be implemented more easily and 
without a specialist programmer. However, if any aspect of the task must be customized, then scripting 
must be used. Appendix C, 
LiveCycle Designer UI Form Logic Example
” on page43
illustrates 
examples of logic that can be added for a text field object (for example) using the LiveCycle Designer 
UI.
FormCalc scripting — FormCalc is a simple calculation language that facilitates fast and efficient form 
design without requiring knowledge of traditional scripting techniques. It contains a range of built-in 
functions for dates and times, mathematics, finance logic, handling strings, and for web operations.
FormCalc is especially useful for situations where many calculations need to be performed, as it is more 
efficient than using JavaScript. It can be used alongside LiveCycle Designer and Acrobat JavaScript. It 
cannot be used for client-side HTML calculations as no FormCalc engine is present.
Another option is that some functions can be handled by server-side processing, but that i usually not 
handled by Acrobat JavaScript in the original form, hence it is beyond the scope of this document.
Acrobat JavaScript
Designer UI
form logic
Acrobat
Forms
JavaScript
LiveCycle Designer
JavaScript
FormCalc
Adobe Acrobat Adobe LiveCycle Designer
Converting Acrobat Forms ContainingJavaScript
Converting Acrobat JavaScript for Use in LiveCycle Designer Forms
Object model differences that affect scripting     10
Object model differences that affect scripting
In addition to the basic architectural differences between Acrobat and LiveCycle Designer form objects, 
the table below lists topics that are especially important to consider for forms migration because they are 
likely to directly affect scripting.
Many aspects of the above operations can be handled without using scripting because the logic can be set 
using the LiveCycle Designer UI. Appendix C, 
LiveCycle Designer UI Form Logic Example
” on page43
shows examples of the type of logic that can be added to a Text field object using the LiveCycle Designer 
UI.
Strategy and options
Some scripting conversions will be straightforward, such as when Acrobat JavaScript is the only way to do 
a particular task, but other JavaScript may present some choices you’ll have to make as to how to best 
implement similar logic in the LiveCycle Designer form.
Ideally, you should convert as much Acrobat JavaScript as possible, and use Acrobat JavaScript only for 
those functions that only it can handle.
Other factors which might influence your choices include the available resources (that is, available 
programming skills), your design goals, and schedule constraints. For example, if the priority is high 
Topic
Acrobat forms
LiveCycle Designer forms
Events 
Events can be used to 
trigger actions on the 
form, page, or field levels.
LiveCycle Designer model for events is similar to that 
of Acrobat, but it has more levels and offers more 
control. Form events can be used to trigger actions 
on the form, subform, page, and field levels.
LiveCycle 
Designer 
subforms 
Not available in Acrobat 
forms. Acrobat fields are 
static.
LiveCycle Designer subforms allow the form to 
expand or contract based on the amount of data that 
must be handled, such as for the result of a data 
merging process or as a result of entries. 
Form submission In Acrobat forms, form 
submission is done using 
JavaScript.
The LiveCycle Designer UI offers more choices and 
control over how submissions are handled in 
LiveCycle Designer forms without using scripting.
Data connections In Acrobat forms, most 
data connections are 
handled using JavaScript. 
LiveCycle Designer allows you set up Web Services 
Definition Language (WSDL) connections, and bind 
that web service to form fields. 
Field naming 
conventions 
In Acrobat, fields with the 
same name are considered 
the same field and always 
share the same value.
In LiveCycle Designer, duplicate field names are 
allowed in the XML tree structure, so the fields need 
not have the same value for all fields that share the 
same name. When converting, field names need to be 
checked to make sure scripts behave as planned.
Security 
In Acrobat, security related 
to signatures is handled by 
using JavaScript; security 
settings for the PDF file is 
set using the Acrobat UI.
You can use LiveCycle Designer to add signature 
fields and other security measures, but security is 
mainly handled by setting security options in Acrobat 
and by using Acrobat JavaScript.
Documents you may be interested
Documents you may be interested