SUI_SetEntryChars allows for alphanumeric codes where each character and digit is
pronounced. You pass a list of valid characters and use SUI_GetSpoken2 to retrieve the
response.

Example

Each position is separated by a semicolon, and each allowed character for that position is delimited by a slash ("/"). Valid characters are A-Z, "-" and 0-9. A maximum of ten characters is allowed. Specify an optional character by enclosing all options in parantheses.

SUI_SetEntryChars ("A/B/C;-;1/2;(X/Y)") `e.g. "A-1", "B-2", "C-2X", etc.

You can also use the pound symbol (#) to specify any digit from 0-9:

SUI_SetEntryChars ("X/Y/Z;#") `e.g. "X1", "Z8", etc.

Alpha characters can be specified in groups. For example, you have a Customer Number field, which is always the state abbreviation and a four-digit number:

SUI_SetEntryChars ("CA/NV/WA/OR;#;#;#;#) `e.g. "CA1234", "WA4321", etc.

This approach is necessary because of the many mis-recognitions involving alpha characters A-Z. It is common for similar-sounding letters to be confused with one another, such as "C" and "Z".

It isn't often that you will be able to predict all possible combinations of numbers/letters in such a data element, but this is offered for when you can.