Using wvrsysconf to define VoIP parameters

The wvrsysconf utility provides direct manipulation of the telephony parameters that are used in system configuration. It does this by exporting the parameters and their values in the form of an XML document. It also creates an XML Schema Definition (XSD) file that contains any restrictions on the permitted values for the parameters.

Figure 1 shows how wvrsysconf creates Document Object Model (DOM) representations of the telephony parameters held in the Blueworx Voice Response database, and then exports these to the XML data file ( wvrSysConf.xml is the default name), and the XML schema definition file (wvrSysConf.xsd).

Note: To be able to run wvrsysconf, you must first download and install the xml4c5_4_0-aix_510-xlc_50.tar.gz libraries from the alphaworks website at http://www.alphaworks.ibm.com/aw.nsf/download/xml4c.

Figure 1. Using wvrsysconf to export XML data and XML schema definition files
This diagram shows how wvrsysconf creates Document Object Model (DOM) representations of the telephony parameters held in the database, and then exports these to an XML data file called wvrsysconf.xml and an XML schema definition file called wvrsysconf.xsd.

This diagram shows how wvrsysconf creates Document Object Model (DOM) representations of the telephony parameters held in the database, and then exports these to an XML data file called wvrsysconf.xml and an XML schema definition file called wvrsysconf.xsd.

You can edit the XML data file (using your preferred editor) to change the required parameters to the values you want. Once complete, you can then validate the file against the permitted values that are held in wvrSysConf.xsd, using a standard XML/XSD validation tool, such as that provided in WebSphere Developer Studio.

Once you have a valid XML document, you can use wvrsysconf again to import the document into the Blueworx Voice Response database. At the time of the import, a new schema definition file is created, and this is used to re-validate the XML data. This process is shown in Figure 2.

Figure 2. Using wvrsysconf to import and validate XML data
This diagram shows how wvrsysconf imports a valid xml documents into the database. At the time of the import, a new schema definition file is created, and this is used to revalidate the XML data before it is stored in the database.

This diagram shows how wvrsysconf imports a valid xml documents into the database. At the time of the import, a new schema definition file is created, and this is used to revalidate the XML data before it is stored in the database.

Note:

wvrSysConf.xsd is a read-only file and cannot be imported; the definitions it contains cannot be changed by using wvrsysconf.
Some Blueworx Voice Response parameters use rules that represent constructs such as “Maximum volume must be greater than minimum volume”. These rules cannot be expressed in XML schema syntax, and so their validation is done during the import, after the main validation of the parameter data against the schema definitions. Values that are only valid in stepped increments (for example 5, 10 ,15, 20) also cannot be expressed in schema syntax. Such values are rounded down to the nearest increment on import, after the validation of the parameter data against the schema definitions. If rounding does occur, a warning is displayed.