Developer Documentation Library > Dialer SDK > Features > Sample records and fields
 
Sample records and fields
Sample records are made up of sample fields. Each sample field corresponds to a column in a database table. Each sample record has a unique sample ID. The sample ID is a Unicode string of up to 64 characters and digits.
Sample IDs are important in communication between the dialing provider and dialer. As discussed with the project ID, many dialers have more restrictions on sample IDs. Dialing providers are welcome to translate sample IDs into versions that meet the dialer requirements.
The entire sample record, including all fields, is passed to the dialing provider as SampleRecordXml. The dialer might find some of the sample fields useful:
CallOutcome (last call outcome for the record)
ConnectCount (count of connects)
NoAnswerCount (count of no answers)
TryCount and AppointmentTryCount (total number of tries)
For a full list of required sample fields that are always available, see Sample table.
The InternalDialerFlags sample field has been added for your use. This field can contain Name=Value pairs that you need to store after calling the record, and might be useful when the record is dialed again.
The SampleRecordXml that is sent to the dialing provider must be returned in its entirety. The dialing provider can add or modify fields in the sample record but there is additional information in the sample record XML that is needed when the record is returned (for example, the quota engine identifier).
See also
Features