Specify Document Description or Menu Prompt

$image_desc playback_option|filename

This command identifies the voice description to be played when a fax-on-demand or IVR infobox is selected. This might be the description of the document selected, or for a menu infobox would be the spoken text of the menu prompt. It is suggested that you use the $script command in the same IIF to document the text to be spoken.

The parameter on this command is used as follows:

playback_option one of the following keywords:
digits the actual digits entered by the caller to select this infobox will be played (e.g. "You have selected document number 1 2 3"). Note that this string may include leading zeros, or may not be the same as the current infobox number if look-up has been used on the $infobox command. This selection is always overridden if there is a .VOX file with a matching filename in the same directory as the infobox file, in which case this file is played instead of the digits.
standard the file with the image file number and with .WAV or .VOX extension will be played (e.g. 00000123.VOX). In this case the .WAV or .VOX file is used even if it was found in an image directory searched earlier in the $image_locn sequence.
vmsg_dir as for standard but the file will be obtained from the voice message directory specified in the user profile (or overridden by system variable VMSG_DIR) instead of from the image directory. This implies that your image descriptions are held with your system messages, and allows the same image to have descriptions in multiple languages, determined by which user profile is in use.
none no description will be played and the caller will not be asked to confirm the selected infobox number.
filename the full pathname of the file containing the voice description for this image. @ variables allow the selection of an image-description filename using the expansion of the contents of a variable to build the filename. For Diva, TE Systems or Copia VoIP calls, this single parameter can contain up to eight pathnames, separated by + and surrounded by a single pair of double-quotes, for files to be concatenated.

When a $play_var command appears in the same .IIF file, the $image_desc command must either be omitted or specified as the default, digits. The $play_var command can be used to speak a custom sentence instead of an image description.

Default: digits, unless there is a matching .WAV or .VOX file in the same directory as the image file.

Messages played: After playing a description, standard voice prompt 6 is played to request confirmation of the selection from the caller. For documents which require a description but no request for confirmation, you should create an infobox of $type voice to play the description and transfer from it using $next_box to a second IIF containing the $image_file name and an $image_desc "none" command. If the entire application is to operate in this way, use the $polling command to suppress all confirmations.

Examples:

$image_desc S ; search for standard description to play

$image_desc none ; no description

$image_desc @FFBASE\voice\123.vox ; specific voice description

$image_desc digits ; speak digits if no voice file found

Image 999 has a description but no confirmation of the selection is to be requested from the caller.

; File 00000999.iif

$image_type voice

$image_desc standard

$next_box img999

; File img999.iif

$image_type fax_image

$image_desc none

$image_file @FFBASE\image\00000999.TIF

Diva, TE Systems and Copia VoIP calls can use the following:

$image_desc "@FFBASE\file1.wav+@FFBASE\file2.wav"