Flex and LiveCycle Forms Sample
Installation Instructions

Marcel Boucher
mboucher@adobe.com
September 18, 2006

Before you start...

You will need the following applications

Installing the application...

Step 1. Unzip the LCFFlex-Sample.zip to the drive where you installed Flex Data Services 2 [REQUIRED]
Make sure that you have the "use folder information" - the zip file was built using the complete FDS2 folder structure.

C:\>fds2
     |-jrun4
         |-servers
              |-default
                  |-SERVER-INF            [contains the JRUN server configuration files]
                  |-flex
                      |-LCFFlex           [contains the Flex application files]
                      |   |-forms         [contains the XDP templates from Adobe Designer
                      |   |-data          [contains some sample XML data to be merged with the forms]
                      |-WEB-INF
                          |-classes
                          |  |-LCFFlex    [contains compiled servlets that invoke LiveCycle Forms]
                          |  |-utilities  [contains some utility classes used by the application]
                          |-src           [contains the configuration settings used in this installation as well as build.xml]
                             |-LCFFlex    [contains the servlet source files]
                             |-utilties   [contains the utility class source files]

Step 2. Update the web.xml file. [REQUIRED]
This step will to enable JRUN to execute RenderFormServlet and ProcessFormServlet which will execute the calls to LiveCycle Forms.
Open the web.xml.mappings file located in the src folder (see above) and copy the servlet definitions mappings from this file and paste them into the the web.xml file located in the WEB-INF folder.

Step 3. Update the remote-config.xml file. [REQUIRED]
This step will enable the application to invoke the FileUtils java object which provides the listFilesFromURL() function as well as other file I/O actions.
Open the remote-config.xml.destination file located in the src folder and copy the FileUtils destination definition and paste it into the the remote-config.xml file located in the flex folder under the WEB-INF folder.

Step 4. Copy and Edit the LCFFlex.properties file. [REQUIRED]
This step will allow you to edit the configuration settings used by the java objects without having to recompile them.
Copy the LCFFlex.properties file from the src folder to the WEB-INF folder so it can be found by the classloader. Once the file has been copied, open it using a text editor and change the FormServer.SoapEndPoint property to match your configuration.
NOTE: The useJMS is set to false by default. If you do not wish to use JMS to update the performance chart, leave this setting to false and you may skip the following configuration steps.

Step 5. Copy the LiveCycle Forms and Apache Axis client libraries [REQUIRED]
This step will make the LiveCycle Forms and Apache Axis (Web Service support) client libraries available to the applications so that it will be able to invoke the LiveCycle Forms web service interface.
From the LiveCycle Forms installation, copy the following files to the WEB-INF/lib folder:

LiveCycle Forms Apache Axis
adobe-common.jar axis.jar
formserver-client.jar commons-discovery-0.2.jar
um-client.jar jax-rpc.jar
  saaj.jar
  wsdl4j-1.5.1,jar

Step 6. Update the jrun-resources.xml file [OPTIONAL]
This step will configure a new JMS topic which will be used to send realtime performance updates to the Flex application which will display the performance numbers in a chart.
Open the jrun-resources.xml.topic file located in the src folder and copy the contents of this file and paste it in the jrun-resources.xml file located in the SERVER-INF folder.

Step 7 . Updated the messaging-config.xml file [OPTIONAL, REQUIRED to use JMS]
This step will configure Flex to communicate with the JMS topic that we just defined in the previous step.
Open the messaging-config.xml.destination file located in the src folder. Copy and paste the contents of this file in the messaging-config.xml file located in WEB-INF/flex/.

Step 8 . Enable JMS to send realtime performance data [OPTIONAL, REQUIRED to use JMS]
Open the LCFFlex.properties file that you copied to the WEB-INF folder in step 4. Change the useJMS property from false to true. If you used the same JMS topic settings included in the src files, then you should not need to make any further changes.

Step 9 . Re-compiling the Java classes and servlets [OPTIONAL]
If you need to make any changes to the java classes or servlets that are provided in this sample, edit the files located in the src folder. I have provided a build.xml file that can be used with Apache Ant to recompile the source files. The build file will compile the source files and copy them to the appropriate locations in the classes folder.

Step 10 . Start the Application Server(s) and test the sample.
Start the application server running LiveCycle Forms, then start the Integrated Flex Server. Once both application servers are running, access the sample application using this url: http://localhost:8700/flex/LCFFlex