User Guide

74 Chapter 4: Using Flash Remoting Data in ActionScript
About record sets
A record set is a two-dimensional data table. The rows of the table correspond to individual data
records, such as the data for a particular product or employee. The columns of the table
correspond to different fields of a record, such as an employee’s title or a product color. The
following table shows a sample record set structure:
A RecordSet object represents a record set in Flash and contains the following elements:
• An array of records
• The names of the columns
• A reference to the application server, if the record set is pageable
Note: For information on pageable record sets, see “Delivering RecordSet data to Flash applications
in ColdFusion MX” on page 81.
Typically, service functions return RecordSet objects to your Flash application. However, you can
also use ActionScript RecordSet methods to create and manage record sets directly in
ActionScript. The ability to create a RecordSet object enables you to create custom client-side
data structures for use in Flash UI Components. For more information on using
RecordSet
methods, see “RecordSet methods” on page 75.
You access record set rows using the row index, much like in an array. Record indexes are relative.
The first record is at index 0, the second record is at index 1, and so on. If you insert a record into
a record set, all the indexes of all records in the RecordSet object starting with the index at which
you insert the new record get incremented by one.
RecordSet object records also have unique IDs that are never changed. If you insert a record in a
RecordSet object, it gets a new unique ID and all other record IDs are unchanged. If you delete a
record, its ID is deleted and is not reused. Flash Remoting uses this ID internally, and you cannot
use it to access a record, but you can use the
RecordSet.getItemID() method to determine the
ID for any record.
Note: You cannot send RecordSet objects to the application server.
lastName firstName emailAddress telExt
Smith Dave [e-mail] 3456
Basham Meredith [e-mail] 7890
Card Sean [e-mail] 1234
Randolph Themis [e-mail] 5678
Sykes Andrew [e-mail] 9012