Specify Parsing of DNIS Data
$dnis_scan chan|AD 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 CFHWL 'Channels' pages. 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 CFHWL for the channel, and is ignored in other circumstances.
The parameters on this command are used as follows:
| chan | The channel number or channel group(s) affected, or * for all channels. |
| AD | Use the keyword AD to cause the command to be applied to the fax number held for the user in Active Directory, before the number is matched with the incoming DNIS value on receipt of a fax. You should of course avoid AD as a channel group name. When automatic lookup is specified in the CopiaFacts AD interface, the incoming DNIS value is expected to be a partial number supplied from a PBX; this special AD $dnis_scan command is not applied to the incoming DID value, but one with a chan parameter is applied to the incoming DID before matching. The specified scan pattern is used for matching only: the value of for example ADU_facsimileTelephoneNumber is always the full content of the AD property. |
| 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). |
Default: None - required for DID types 2 and 3.
Examples:
$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.
