User manual MACROMEDIA COLDFUSION MX 7.0.2-USING COLDFUSION MX WITH FLEX 2

[. . . ] Using ColdFusion MX with Flex 2 Trademarks 1 Step RoboPDF, ActiveEdit, ActiveTest, Authorware, Blue Sky Software, Blue Sky, Breeze, Breezo, Captivate, Central, ColdFusion, Contribute, Database Explorer, Director, Dreamweaver, Fireworks, Flash, FlashCast, FlashHelp, Flash Lite, FlashPaper, Flash Video Encoder, Flex, Flex Builder, Fontographer, FreeHand, Generator, HomeSite, JRun, MacRecorder, Adobe Systems Incorporated, MXML, RoboEngine, RoboHelp, RoboInfo, RoboPDF, Roundtrip, Roundtrip HTML, Shockwave, SoundEdit, Studio MX, UltraDev, and WebHelp are either registered trademarks or trademarks of Adobe Systems Incorporated and may be registered in the United States or in other jurisdictions including internationally. Other product names, logos, designs, titles, words, or phrases mentioned within this publication may be trademarks, service marks, or trade names of Adobe Systems Incorporated or other entities and may be registered in certain jurisdictions including internationally. Third-Party Information This guide contains links to third-party websites that are not under the control of Adobe Systems Incorporated, and Adobe Systems Incorporated is not responsible for the content on any linked site. If you access a third-party website mentioned in this guide, then you do so at your own risk. [. . . ] ---> > <cfreturn true> > <cfelseif ArrayLen(fillArgs) EQ 1> > <!--- This is a search fill. ---> > <cfset search = fillArgs[1]> > <cfset first = item. getFirstName()> > <cfset last = item. getLastName()> > <!--- If the first or last name contains the search string, ---> > <cfif (FindNoCase(search, first) NEQ 0) OR (FindNoCase(search, last) > NEQ 0)> > <!--- this record is in the fill. ---> > <cfreturn true> > <cfelse> > <!--- this record is NOT in the fill. ---> > <cfreturn false> > </cfif> > </cfif> > > <!--- By default, do the fill. ---> > <cfreturn true> > </cffunction> Authentication To authenticate users when using the Flex Data Service Assembler, you use the Flex setRemoteCredentials() method on the DataService object. The credentials, which are in the FlexSession object, are passed to the ColdFusion application, where you can use the cflogin tag to perform authentication. Alternatively, you can set credentials in the Flex destination, although this is not the recommended way to do so. 44 Using the Flex Data Service Assembler You can set the cerdentials by doing either of the following: Specifying credentials in ActionScript Specifying credentials in the Flex destination Specifying credentials in ActionScript To specify credentials in ActionScript, you use the setRemoteCredentials() method, as in the following example: ds = new DataService("mydest"); ds. setRemoteCredentials("wilsont", "password"); Specifying credentials in the Flex destination To specify credentials in the Flex destination, you edit the data-management-config. xml file that is in the WEB-INF/flex folder of the server on which you want to run the Flex application. . In the <properties> element, you include the <remote-username> and <remotepassword> elements, as follows: <destination id="cfcontact"> <adapter ref="coldfusion-dao" /> <channels> <channel ref="cf-dataservice-rtmp" /> </channels> <properties> <source>samples. contact. ContactAssembler</source> <scope>application</scope> <remote-username>wilsont</remote-username> <remote-password>password</remote-password> . . . /properties> </destination> Enabling SSL You can encrypt communication between ColdFusion and Flex by enabling Secure Sockets Layer (SSL). (You do not need a certificate signed by a Certificate Authority, although if you do use one, you do not need to configure Flex as indicated in the steps below. ) The information in the keystore is encrypted and can be accessed only with the password that you specify. To create the keystore, you use the Java keytool utility, which is included in your Java Runtime Environment (JRE). Enabling SSL 45 To enable SSL, you do the following: Create the keystore Configure Flex Enable SSL in the ColdFusion MX Administrator To create the keystore: 1. Generate the SSL server (ColdFusion) keystore file by using the keytool utility, with a command similar to the following: keytool -genkey -v -alias FlexAssembler -dname "cn=FlexAssembler" keystore cf. keystore -keypass mypassword -storepass mypassword The following table describes the parameters of the keytool utility that you use: Parameter -alias Description The name of the keystore entry. You can use any name for this, as long as you are consistent when referring to it. The Distinguished Name, which contains the Common Name (cn) of the server. Generates detailed certificate information. -dname -keystore -keypass -storepass -rfc -file -v Next, you place the certificate you created in the file that the JVM uses to decide what certificates to trust. The file in which you put the certificate, (usually named cacerts), is located in the JRE, under the lib/security folder. To configure Flex: 1. Export the keystore to a certificate by using the keytool utility, with a command similar to the following: keytool -export -v -alias FlexAssembler -keystore cf. keystore -rfc -file cf. cer 2. Import the certificate into the JRE cacerts file for your server by using the keytool utility, with a command similar to the following: keytool -import -v -alias FlexAssembler -file cf. cer -keystore C:\fds2\UninstallerData\jre\lib\security\cacerts 46 Using the Flex Data Service Assembler The previous example specifies the location of the keystore for Flex Data Services with integrated JRun, installed using the default settings. If you are using a different server, specify the location of the cacerts file for the JRE that you are using. For example, if you are using JBoss, you specify the keystore location as $JAVA_HOME/jre/lib/security/ cacerts. To enable SSL in the ColdFusion MX Administrator: 1. In the ColdFusion MX Administrator, select Data & Services > Flex Integration, and specify the keystore file in the Full Path to Keystore text box. Select the Enable RMI over SSL for Data Management option, and then click Submit Changes. If you specify an invalid keystore file or password, ColdFusion does not enable SSL, and disables Flex Data Management Support. 2. 3. Data translation The following table lists the ColdFusion data types and the corresponding Adobe Flash or ActionScript data type: [arrays become lists - which are AS arrayCollections; ask mike] ColdFusion data type String Array Struct Query CFC Flash data type String [] = Array {} = untyped Object Array of untyped Objects Class = typed Object (if a matching ActionScript class exists, otherwise the CFC becomes a generic untyped Object (map) in ActionScript) ActionScript Date ActionScript String ActionScript Numeric ActionScript XML Object CFC Date CFC String CFC Numeric ColdFusion XML Object Data translation 47 Example application This section describes creating a Flex application that uses the ColdFusion Data Service adapter and Flex Data Service assembler so that a ColdFusion component handles the backend database management. You can download the source code for the files that are included in the Flex sample Contact application from "Using ColdFusion with Flex ­ Part 1: Creating and Running a Contact Manager Application. " In addition, you can view the code for the Flex sample Contact appliation in "The Flex Contact Manager Application" on page 62. Create the Value Object CFC. NO TE To make creating the CFCs easier, ColdFusion MX 7. 0. 2 includes wizards that you can use in Flex Builder. For more information, see Chapter 5, "Using the ColdFusion Extensions for Flex Builder". 4. [. . . ] The assembler CFC is required to take advantage of the Flex Data Services feature To use the RDS CRUD wizard: 1. In Flex Builder, go to the RDS Dataview by doing the following: a. Enter the project folder where you want to save the CFC in the CFC Folder text box. Enter the CFC package in the CFC Package Name text box. 86 Using the ColdFusion Extensions for Flex Builder 6. 7. (Optional) Select the Primary Key column if a primary key is not defined in the database. [. . . ]