CRTP URI Protocol Syntax

The CRTP protocol references files uploaded in the Cisco Unified CCX repositories. In the syntax:

Angle brackets indicate appropriate content to be specified in place of the syntax example word.
Square brackets indicate an argument is optional:

The syntax for specifying the CRTP URI protocol is as follows:

crtp:/<repository>[/<languages>]/<path>[?<params>][#<ref>]

where:

Command Argument

Specifies

<repository>

The name of the Cisco Unified CCX repository from which you want to get a resource. The current Cisco Unified CCX repositories are of two types:

System repositories only contain resources that are preloaded and used by the system. They cannot be modified. The system repositories are:
- SPrompts
- SGrammars
- SDocuments
- SScripts
User repositories are not preloaded and can be modified by the user. The user repositories are:
- Prompts
- Grammars
- Documents
- Scripts
Note

In CRS 4.0, you cannot access scripts with the CRTP protocol.

<languages>

Optional. A priority ordered list of languages, each separated by a “,” (comma).

Languages specified here have priority over the system default locale language. If no languages are specified here, then the system configured default language is used for the search.

Each accepted language is defined as a locale string composed of a 2-letter ISO 639 code representing the locale's language. For example, “en” is for English.

If you specify a language region or country after the language, then you need to add a dash (“-”) after the locale, and follow it with the 2-letter ISO 3166 code representing the locale's region or country. For example “en-US” for English in the United States.

In the CRTP specification, you must replace any underscore “_” used in a Cisco Unified CCX repository name with a dash (“-”). This is defined by the RFC 1766 standard.

Optionally, following the region specification is another dash and variant code, if there is such. For example: “en-US-NY” for New York English.

The list of languages must be prefixed with the string "lang," For example: "lang,en-US,en-GB"

<path>

Any valid path to a file within a Cisco Unified CCX repository as defined in the Cisco Unified CCX Expression Editor syntax.

Enter a path just like you would specify a subdirectory in a URL in HTML.

Note	In an HTTP URL and in a CRTP URL, a path does not include the computer disk drive.

For example: if the file “grammar.grxml” exists in the User grammar repository under a folder named myApp, the CRTP URI would be as follows:

crtp:/grammar/myApp/grammar.grxml

Note	In Cisco Unified CCX 4.0, Only the script repository does not support directories. All other repositories do support directories.

<params>

Two optional query parameters:

Specifies the data at the end of the path when it is other than a file.

Format: [?]accept=query

Where

? specifies the start of the query part of the URL.

query specifies a value of mime type or a comma separated mime list.

Mime (Multipurpose Internet Mail Extensions) is a standard for multi-part, multimedia (non-textual data, such as graphics and audio) electronic mail messages and World Wide Web hypertext documents on the Internet.

index

Returns the grammar specified in the index of a compound grammar. The index is 0 based. A compound grammar is similar to an array of grammars indexed from 0 to n.

Format: &Index=x[,n]

where:

& separates the index string from the rest of the query string preceding the ampersand.

x is an index entry number. There can be more than one.

n is the last index entry number. Multiple index entries are separated by commas and are used to recursively access a grammar in a compound grammar.

You can dereference (access the indexed grammar in) a recursive compound grammar (a compound grammar defined within another compound grammar) by supplying multiple indexes, each separated by commas. For example: &index=0,2,1

<ref>

Optional. An anchor reference, beginning with the pound sign (#), linking to a section within a file.