Creating a CCXML file

For each CCXML file that you want to create you must create a project in which you will place all the files for the application.  Besides CCXML files, these might include VoiceXML files, grammar files, ECMAScript Object files, pre-recorded audio files, and pronunciation files.

Tip: Filenames are case-sensitive. The CCXML browser URLs should be case-consistent to avoid duplicate loads.  For example, do not name one file A.ccxml and another a.ccxml.

Here are the steps required to create a CCXML file:

  1. If you do not have a project in which your CCXML file will reside, create a project (any project type is supported).  Otherwise, select the desired project in the Navigator.
  2. You can create a folder in which to place your CCXML file. To do this, select File> New > Other > Simple, select Folder, and type the folder name.  Folders are optional containers for organizing files within a project.
  3. From the File menu, select New > Other > Voice > CCXML File.
  4. Select how you want to create it (from scratch, resulting in an empty file) or with DTD assistance
  5. Click the Next button.
  6. Type your new file name (the default extension for a CCXML file is .ccxml) and select the parent folder where you want the new file placed.
    • Optional: Click Advanced (available in some installed products) to reveal or hide a section of the wizard used to create a linked file. Check the Link to file in the file system check box if you want the new file to reference a file in the file system. In the field below the check box, enter a file path or the name of a path variable. Click Browse to locate a file in the file system. Click Variables if you want to use a path variable to reference a file system file.
  7. Click the Finish button to create the file and launch the associated editor.
  8. Note: The file that is created will either be empty or contain skeleton code. This is based on how you elected to create the file.
  9. If you created the file based on a DTD, basic file information is added in the Editor screen. The DOCTYPE declaration is automatically added below the XML processing instruction (<?xml...). The DOCTYPE is necessary to enable validation and Content Assist.
  10. Note: Some interpreters may require that the DOCTYPE statement be removed.

After the file is created you can continue by adding valid tags and attributes. When you finish, save your file. If XML Validation is enabled on you project (default), any structural or DTD compliance issues will be shown in the problems view and with markers in your document.

Using the Edit menu

Use options in the the lowest section of the Edit menu or the right-click contextual menu to assist with viewing and editing your file. You can select menu options such as the following (some options are not available, depending on the open editor):

Using Content Assist

The Content Assist function assist in development by opening a pop-up window that provides a list of valid tags for the element or attribute at the cursor location. Cintent Assist is used by placing the cursor at a position in the file where you want assistance and holding down the Ctrl key and pressing the Space bar.

Additional information on CCXML development

Information on developing CCXML applications is available in the current Specifications document:

Related Information
What is CCXML?
Content assist in CCXML editor
Color coding in CCXML editor
Validating a CCXML file

Legal notices.