Testing a grammar

Testing the grammar ensures your application accepts the correct data. You can use Batch Grammar Test tool to test functions on multiple grammar or audio files, and they all appear as grammars when you run the test tool.

Before you begin the test, ensure that you have access to a remote or local MRCP server, verify that the server is started, and ensure that it is configured properly. To configure the server, click Windows > Preferences and from the Preferences window click Voice Tools > Speech Engines > WebSphere Voice Server (MRCP).

Before starting the test tool, save your grammar file and then follow these steps:

  1. Start the Batch Grammar Test tool in one of these ways:
    • Click File > New and in the Voice Tools section select Grammar Test Script. Enter a file name to create the Batch Grammar Test Script with the file extension GSXML and open a form based editor for that file;or
    • Double-click on a pre-existing Batch Grammar Test Script with the GSXML file extension in the Navigator view.
    • Click File > Open External File and open a Batch Grammar Test Script with the GSXML file extension that is not in the workspace.

      Wait for the system to access the MRCP server and load the grammar into the test tool, which opens, by default, in the lower right pane.

  2. From the Data tab, make changes to any Recognition Settings as needed and click Run Test. For more details on the Data tab, see Using the Data tab.
  3. The Progress view displays the Batch Grammar Test jobs that are currently queued. The jobs are run one at a time in first-in, first-out order. The job that is currently running displays a progress indicator to indicate the percentage through the overall test. You can use this view to cancel running or queued Test Runs by clicking the red box to the right of the test being run.
    Note: If you cancel a running job, the a message box is displayed asking if the test results that have been collected so far should be kept or deleted. The message text also indicates that if the option to keep the data is selected then the test can be resumed at a later time.
  4. Test results appear in the Results tab. For more details on the Results tab, see Using the Results tab.
  5. The Problems view displays errors and warnings resulting from the Grammar test and linked to the Grammar Script, if the script was run from the workspace. These problems persist until you fix the root cause and (re)run the grammar test.
  6. Look at the results in the Properties view, which are the same found in the Details table. Properties for the selected test (row) in the Details table are displayed in this view.
  7. If the contents of the file have been altered since the last save, select Save or Save as to save the test results in the file. Type a file name with TXT format, and select a location.
    Note: Click Open External File..., to open Batch Grammar Test Scripts (GSXML) that are not in the workspace by using this feature. This is useful for quickly analyzing data from another system without having to import it into the workspace. Files opened in this manner do not display problems in the problems view, since they are not Eclipse resources.