Immediate Return for a SOA with New and Exciting Purposes

Web 2.0 & Enterprise Mashups

Subscribe to Web 2.0 & Enterprise Mashups: eMailAlertsEmail Alerts newslettersWeekly Newsletters
Get Web 2.0 & Enterprise Mashups: homepageHomepage mobileMobile rssRSS facebookFacebook twitterTwitter linkedinLinkedIn

Enterprise Mashups Authors: Andy Thurai, Hovhannes Avoyan, David Weinberger, RealWire News Distribution, Tomohiro Iizuka

Related Topics: Enterprise Mashups, Adobe AIR on Ulitzer, Open Web Magazine

Enterprise Mashups: Article

Using the Adobe Flex Toolkit for

New integration opportunities

In April 2007 Adobe and announced the availability of the Flex toolkit for Apex,'s on-demand programming language and API for interaction with their hosted CRM solution. This toolkit makes it simple to build Flex applications that interact with your database.

The benefits of using Flex are numerous: create far more effective and efficient dashboards for your sales team, build "mashup" user interfaces that bring data together from Salesforce and your enterprise systems, and improve the overall usability of with tools you're already comfortable with.

The API itself is rather simple. Using the toolkit you can execute query operations (create, update, delete), run full-text searches, pull back metadata on your Salesforce environment (tabs, controls, layout information), send e-mail messages, and work with the workflow engine. The most useful aspect of the API is the query operations, so we'll focus on that in the following sample application "sfQuery."

Getting Started
The toolkit is surprisingly easy to get started with. Simply download it from, unzip the swc file to a convenient location, and add it to your Flex application's build path (see Figure 1).

Add a reference to the Salesforce namespace to your mx:Application tag as indicated below:

<mx:Application xmlns:mx=""
xmlns:salesforce="com.salesforce.*" layout="absolute" >

To create a connection to the servers, add this line of code to your application:

<salesforce:Connection id="apex"/>

That's the extent of the configuration of your application. We can now use the connection (referenced as "apex") to interact with the Apex platform.

SOQL: The Salesforce Object Query Language
While this isn't necessarily directly related to the toolkit, it's important to understand some of the peculiarities of SOQL. SOQL is very much like SQL, but with a few key differences. For example, wildcards aren't permitted in your field list in a select statement. Aggregate expressions are basically not supported except for count(), but even that's limited. The biggest difference to be forewarned about is how SOQL handles what we traditionally think of as "join" statements. Instead of returning a table of data, SOQL returns nested result sets from the child tables in a join statement. They refer to this approach as "SOQL relationships." Outer join capability is expected to be included in the Spring 2007 release of Apex. I recommend that you read to understand just what you can (and can't) do in SOQL in more detail. It's not difficult to make up the difference in ActionScript, but it sure feels weird knowing you're doing something in code that you could do much easier in SQL!
Anyway, back to the demo:

Doing Stuff
Our demo application will be a simple SOQL query testing application so we can learn the SOQL syntax. You've already created your connection object, so to activate it we have to log in. Prepare a LoginRequest object by populating the username and password fields. Notice that we're defining a callback function (loginResult) that will be fired off when the login response from the servers is received.

private function login():void
var lr:LoginRequest = new LoginRequest;
// username/password used when logging in interactively
lr.username = username.text;
lr.password = pwd.text;
// server_url and session_id used when deployed in the salesforce environment
// lr.server_url = Application.application.parameters.server_url;
// lr.session_id = Application.application.parameters.session_id;
lr.callback = new AsyncResponder(loginResult);

Our callback function is rather simple in this example - all we're doing is changing states. Now that we're logged in let's enter a quick SOQL query:

SELECT Account.Name,
(SELECT Contact.FirstName, Contact.LastName FROM Account.Contacts)
FROM Account

This query will retrieve all contacts for each account in our Salesforce database when the "Execute Query" button is clicked.

   private function executeQuery():void
        new AsyncResponder(function (qr:QueryResult):void
txtQueryOutput.text = ObjectUtil.toString(qr.records);

The query() function takes an SOQL statement as the first argument and a callback function as its second. We'll pass the query off to the "apex" connection object and wait for a response. Stylistic comment: rather than define the callback in another function as I did with the loginResult function, I opted to define it inline as an anonymous function. Either method works; the decision as to which way you do this is purely personal.

Once we get the data back we'll use the ObjectUtil class to dump out the returned object as a string in the larger text area. If the query failed, we'd get an error and no results would render. Just like that we now have a quick SOQL statement tester that can help us build our future Flex/Apex applications.

More Stories By Stephen Rittler

Stephen Rittler is the president of Countermarch Systems LLC, a company dedicated to improving alumni relations in higher education through the proper application of CRM tools, social networking and process improvement through technology. His company has developed effective solutions for clients in education, government, publishing and manufacturing. He is a Certified Advanced ColdFusion MX developer and has contributed to the CF community through his writing, leadership of the Philadelphia ColdFusion User Group and presentations on a variety of topics. Steve is a musician at heart but has yet to figure out how to play his saxophone and code at the same time. You can read his blog at

Comments (0)

Share your thoughts on this story.

Add your comment
You must be signed in to add a comment. Sign-in | Register

In accordance with our Comment Policy, we encourage comments that are on topic, relevant and to-the-point. We will remove comments that include profanity, personal attacks, racial slurs, threats of violence, or other inappropriate material that violates our Terms and Conditions, and will block users who make repeated violations. We ask all readers to expect diversity of opinion and to treat one another with dignity and respect.