|
To use LiveCycle Data Services ES 2.6.1 with ColdFusion
9, you need to manually install it after completing your ColdFusion
9 installation.
Before you proceed, download LCDS2.6.1_for_CF9.zip from the
Adobe website or copy it from the ColdFusion 9 DVD and extract it.
Note: The following instructions use the term “lcds_install_root”
to refer to the installation home directory for LiveCycle Data Services
ES 2.6.1.
Before you start the installation:
Shut down ColdFusion 9 server if its running.
Copy the ColdFusion9/lib/flex-messaging*.jar files to a backup
location. For a multiserver installation or a J2EE installation,
these files are located in the WEB-INF/cfusion/lib directory.
Copy the lcds_install_root/resources/lib/flex-messaging*.jar
files and overwrite them in the ColdFusion /lib directory.
Copy "LCDS2.6.1_for_CF9/WEB-INF/flex/jars/cfdataservicesadapter.jar"
to ColdFusion WEB-INF/flex/jars.
Copy the following SWC libraries from lcds_install_root/resources/frameworks
to the ColdFusion9 directory:
/libs/fds.swc file to
the /WEB-INF/flex/libs directory
/libs/player/playerfds.swc file to the /WEB-INF/flex/libs/player/
directory
/locale/en_US/fds_rb.swc file over the /WEB-INF/flex/locale/en_US/ directory
Now, you can either use new Enhanced Flash Remoting of ColdFusion9
or Old Flash Remoting (ColdFusion8).
The advantages of using new Enhanced Flash Remoting include:
Enhanced Flash Remoting supports circular references
for objects, which are not supported in old Flash Remoting (ColdFusion
8).
Enhanced Flash Remoting is significantly faster than the
old Flash Remoting.
For ColdFusion 8 Flash Remoting:
Copy your ColdFusion 8 WEB-INF/flex/ *.xml config files
to ColdFusion 9 WEB-INF/flex/ folder
Start ColdFusion server.
For Enhanced Flash Remoting of ColdFusion 9
Copy *.xml files from LCDS2.6.1_for_CF9/WEB-INF/flex
directory to the ColdFusion 9 WEB-INF/flex/ directory.
If your LiveCycle Data Services applications use the RTMP
channel, open the ColdFusion WEB-INF/flex/services-config.xml file
and uncomment "cf-rtmp" channel. By default, it is commented.
If your old channels (in service-config.xml) has the <instantiate-types> present
under <serialization> xml tag, then either remove <instantiate-types>,
or set it to true. Also set the <enable-small-messages> to
false.
Either of the following samples of the <serialization>
constructs is expected at channel level. Sample 1:
<serialization>
<instantiate-types>true</instantiate-types>
<enable-small-messages>false</enable-small-messages>
</serialization>
Sample 2:
<serialization>
<enable-small-messages>false</enable-small-messages>
</serialization>
Even if you bypass the XML-based
channel configurations and create a custom channel as shown in the
following client side code, you must set “enableSmallMessages” flag
to false.
<mx:ChannelSet id="myChannelSet" >
<mx:channels>
<mx:AMFChannel enableSmallMessages="false" url="http://localhost:8500/flex2gateway/cfamfpolling" id="cfAMFPolling" pollingEnabled="true" pollingInterval="8"/>
</mx:channels>
</mx:ChannelSet>
Add your data management destinations from the old file to
the new data-management-config.xml file. In ColdFusion 9 release,
there are a few changes in the destination and channel structure
due to changes in the serialization process.
The following
properties have been moved from destination to channel level. You
need to move these properties under
<channel-definition
>
<properties>
<coldfusion>
from
<destination> level in the data-management-config.xml file.
These steps also apply to destinations defined in other *-config.xml
files:
<access>
<use-mappings>
<method-access-level>
</access>
<use-accessors>
<use-structs>
<property-case>
<force-cfc-lowercase>
<force-query-lowercase>
<force-struct-lowercase>
</property-case>
For details, see Changes
in the XML configuration files for Flash Remoting in ColdFusion
9 in Developing ColdFusion Applications.
Deploy your LCDS/Flex applications after recompiling them
using new *-config.xml files, which contain the mentioned changes.
Start ColdFusion server.
|
|
|
