First time here? First time here? Newsletter Signup Newsletter
Search tutorials
Author: Ben Johnson

Simple Formatting

For our list box component, we will simply display the employee’s first and last name to the user. We will also bind the employee’s Employee ID to each item so it can be referenced when sending data to the server in the future. Although we will not be sending any data to the server, it is best practice to attach an identifier to component items so you will be able to send useful data to the server if the need arises.

For a simple data transformation such as this, DataGlue’s bindFormatStrings() function works great. The function accepts the component to bind to, the data and two formatting strings for the label and data fields of the component:

bindFormatStrings ( component, recordset, labelFormatString, dataFormatString)

The formatting strings use a similar syntax to how ColdFusion outputs variables. Within the string, wrap your recordset column names with pound signs (#) to have them output with data. As DataGlue iterates through the recordset and creates list box items or combo box items, the column names will be replaced with data for the column within each row. The example in Listing 1 shows an example of formatting strings and their respective output for a set of data.

Listing 1 Input data: ROW 1: EmployeeID: 4, FirstName: John, LastName: Doe ROW 2: EmployeeID: 7, FirstName: Jane, LastName: Johnson ROW 3: EmployeeID: 2, FirstName: Jack, LastName: Smith

Example 1
Formatting String: “#FirstName# #LastName#”
	John Doe
	Jane Johnson
	Jack Smith

Example 2
Formatting String: “#LastName#, #FirstName# (#EmployeeID#)”
Doe, John (4)
Johnson, Jane (7)
Smith, Jack (2)

Assuming we setup the Flash Remoting parameters correctly and we’ve made our service call to the Employee component’s getAllEmployees() method, the recordset of employees will be sent to our callback function, getAllEmployees_result(). Listing 2 shows the callback function and the call to DataGlue’s bindFormatStrings() method to bind our data to our list box. The bindFormatStrings method will format the list box item’s label to show the first and last name of the employee and will bind the EmployeeID to each list box item.

Listing 2

// getAllEmployees_result
// The callback function for the getAllEmployees() Flash Remoting call.
// result – recordset object with columns: EmployeeID
//						   FirstName
//						   LastName
//						   Department
//						   MonthsWithCompany
// NOTE: Department & MonthsWithCompany field are not used so they are
//       simply ignored.
function getAllEmployees_Result (result) {
	DataGlue.bindFormatStrings( employeesListBox,
					 “#FirstName# #LastName#”,
					 “#EmployeeID#” )
» Level Intermediate

Added: 2002-08-16
Rating: 7 Votes: 20
(10 being the highest)
» Author
Ben Johnson has been programming for seven years and creating web applications for the past two years. He is currently an information architect for Architekture.com, creating web applications using Flash and ColdFusion.
» Download
Download the files used in this tutorial.
» Forums
More help? Search our boards for quick answers!
Featured Flash FLA
» Author: Inocreato
» Title: RaiseTheBlocks
» Description: Raise all the blocks to win the game
Featured Sound Loops
Image for equalize

Audio Player

» Author: TomCat Carty
» Title: The Wood
» Description: Just a little game ending or it can maybe be looped. Recorders with music box and percussion to give the feel of well, I don't know, the woods? Free to use, just credit me. thank you
Latest Font
» Author: Fábio FAFERS
» Description: I created this font for free use. Everyone can apply it in personal or business texts. Its free, but I want to be communicated in case of business use. Donations are accepted to keep the project of free fonts alive! Thank you all
Featured Sound Fx
Image for equalize

Audio Player

» Author: Davisigner
» Description: Hmm... what to say about this one? It's reminiscent of the closing notes of the opening music from the Three Stooges done in a church organ style with a closing cymbal crash. I'll give this one away gratis, but feel free to check out my free loops and potential upcoming license-mandated ones over in the respective part of Flashkit.