Use this procedure to invoke a custom server from a voice application
state table. The state table will include states that call the custom
server, send input data to the server, and retrieve the output data
for the voice application.
Note that SendData and ReceiveData actions must be alternated in
the state table. Since there is a single buffer allocated for data
sent with SendData and ReceiveData, you cannot execute multiple SendData
actions without intervening ReceiveData actions. The two exceptions
to this are that multiple ReceiveData actions are required to collect
data from a single SendData, see Multiple instances of output parameters, and, secondly, that if
the SendData parameter Host Response Time Limit is set to 0 then no
matching ReceiveData is necessary or allowed.
Note: Any variables used by the custom server that need to be defined
to the calling state table must be defined in the custom server first,
then the state table. Variables that are defined first in the state
table, then the custom server, need to be redefined to the state table.
For an example of a state table that invokes a custom server, see
CustomServerSample in the Blueworx Voice Response for AIX:
Designing and Managing State Table Applications information.
- From the Welcome window, select Applications —>
State Tables
- Open the state table: Select and Open the
state table. The system displays the State Table window, showing the
states in the selected state table.
- Add or change states: Change existing states or add new
states that interact with the custom server as needed.
The actions
that you use to interact with custom servers are:
- OpenHostServerLink: Establishes a connection
to a custom server.
- GetFindData: Requests a list of items
that match or begin with a specified generic key.
- SendData: Sends request data to the
custom server.
- ReceiveData: Receives responses from
the custom server.
- RecordVoiceToHost: Allows a custom server
to retrieve voice data from the telephony channel.
- PlayVoiceFromHost: Allows a custom server
to play voice data on the telephony channel.
- CloseServerHostLink: Closes the session
and disconnects the link to the custom server.
For a description of state table actions see the Blueworx Voice Response for AIX:
Application Development using State Tables information.
- Validate & Save the state table.
If necessary, debug errors and try again.