• 2 The Graphical Script Editor • Scripts • Optional Blocks – Variables • Get DTMF String
2.4.11.9 Get DTMF String
Here you can prompt the caller to enter a string via DTMF and then store the values detected in a variable. Using the parameters, you can define the key used to end the entry and the maximum length of the string. In addition, you can define the maximum period of time to be waited for the detection of other keys (timeout).
The action will be terminated, when
*the input of DTMF keys has been completed, either by the defined end key or when the maximum length has been exceeded,
*when the timeout has expired, or
*if the connection has been terminated.
Under "Properties", all three tabs "General", "Parameters" and "Connections" tabs are available for this block.
This is how you define the parameters for “Get DTMF String”
1 If you would like to play the caller a request to enter the DTMF tones, activate “Play sound file during DTMF detection”.
You have several options:
*From the dropdown list select a file.
*Browse your hard drive by clicking on .
When searching, you can also choose a file in MP3 format. Upon selection, the MP3 file will automatically be converted into the WAV format and saved in the database on the SwyxServer. The converted files are therefore available for use later. During the conversion process, the Info dialog "Please wait, the file is being converted into WAV format" will open.
*Click on, to listen to the selected file. Click on to stop playing the file.
*To record a new announcement, click on : You will now be prompted to enter a file name. The “Start Recording” window will appear. Click on “Start” to begin recording the announcement. Stop recording by clicking on .
*To delete the selected file, click on .
* 
The WAV files, which the administrator has made available to all users, have the extension “(Template)” in the file name. These templates cannot be deleted.
 
2 Select the variable, in which the string should be saved.
In doing so, define whether the character entered should be saved in a variable and whether
*the contents of the variable should be replaced, or
*whether it should be appended to the contents of the variable.
3 Now enter the value for ending the entry:
*If the caller should end his entry with a specific character, activate the first option and indicate which character should be used.
*If you would like to define the maximum length of the string, activate the second option and enter a value. The entry of the character will then be completed automatically.
4 Then enter the amount of time, which is allowed to pass until the next DTMF character is detected (timeout).
5 Click on “OK”.
The “Get DTMF String” block can be seen in the script window and it available for further processing.
Links
On this tab you will find all outputs associated with this block. The outputs are described as follows:
Output
Explanation
Key 0 -9, *, #
This exit is chosen if the appropriate character (0-9,#,*) has been detected.
Timeout
This exit is chosen if no tones were detected within the time limit (timeout).
Disconnected
This exit is selected if the connection is disconnected.
In the first column "Visible", you can define whether each output should be shown in the script window.
* 
The "Visible" column is only used to define the visibility of the links in the script window. This setting helps to maintain the clarity of the script. You cannot remove outputs, i.e. the connections must be kept, otherwise an error will occur in the script.
 
The second column "Default" contains the default name of the output. This provides information about events during the execution of a block so that additional appropriate connections can be created. This fixed name cannot be changed. You can assign your own identifying names to the various contact surfaces in the column "Link name". This name will later appear in the block in the grid interface.
In the last column "Linked to" you see which block input this output is connected to. Here you have the option of selecting a link from a select list, which contains all available blocks.