Specify Parsing of DNIS Data

$dnis_scan line pattern skip use

This command is used principally to specify how to extract DID and autocall data from the DNIS string supplied in a PRI ISDN environment. It is most often used in applications where a fax-on-demand document or application service is selected automatically from the number dialed by the caller, without any request interaction. It also allows for ISDN environments where the DNIS number presented may or may not have a city and/or international prefix, depending on the source of the call.

In addition, the command may be used to specify scanning of an in-band (DTMF) presentation of DNIS data, which will have been specified with the 'SDID' checkbox in the CopiaFacts Configurator 'Lines' pages. This facility was added in CopiaFacts engine release 7.2.  For more information, see also Using Caller Number and Called Number.

The command is required for the correct operation of DID type 2 or 3 ('use DNIS Scan') when this is specified in the Configurator for the line, and is ignored in other circumstances.

The parameters on this command are used as follows:

line the line group(s) affected, or * for all lines. For Hardware DID only, a line group name of dtiBx where x is 1 to 8 has special significance as described below.
pattern the fixed digits to search for in the DNIS string, and from which the following positional parameters will be based. To start by using the first digit of the DNIS string (and with no characters skipped), enter an empty string at this point (two adjacent double-quote characters).
skip the number of digits to skip after finding the pattern in the presented DNIS string.  The 'skip' value is only used when a non-empty pattern has been supplied and found.
use the number of digits to use for DID purposes (selection of user profile).  Any further following digits are then used for document or mailbox selection (see $auto_call).

Special-purpose line-group names of the form dtiBx where x is 1 to 8 (and which should not be defined as a normal line group) indicate 'any line which is dynamically connected to an incoming call on a telephony channel of board x'. This allows multiple E1 spans in the same node to be connected to separate incoming lines which may have different DNIS attributes. To use the same DTI board numbers in different CopiaFacts nodes, use commands like '$if @node = M1' to condition the $dnis_scan commands in the configuration file.

Default: None - required for DID types 2 and 3.


$dnis_scan DIGITAL 745 0 1 ; use next digit after 745 as DID

$dnis_scan DIGITAL "" 0 3  ; use digits 1-3 of DNIS as DID.