Completing the state table

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.

  1. From the Welcome window, select Applications —> State Tables
  2. 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.
  3. 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.

  4. Validate & Save the state table. If necessary, debug errors and try again.