-------------------------------------------------------------------------------
README: SADE DE IMPLEMENTATION
-------------------------------------------------------------------------------

Full name:    South African Directory Enquiries (SADE) Application

Description:  Asterisk Gateway Interface (AGI) script implementing the 
              Directory Enquiries application

Version:      1.0 release

Size:         60KB

URL:          http://rma.nwu.ac.za/
              Any queries with regard to updated versions can be directed to
              rma@nwu.ac.za.

-------------------------------------------------------------------------------

This data is shared under the Creative Commons Attribution 3.0 Unported 
(CC BY 3.0) license. For more information see license.txt

When using these prompts, please cite:
  Charl van Heerden, Marelie Davel and Etienne Barnard, "Performance analysis 
  of a multilingual directory enquiries application", in Proc. Annual Symp. 
  Pattern Recognition Association of South Africa (PRASA), pp 258-263, 
  Cape Town, South Africa, November 2014.

bibtex:
@inproceedings{vanheerden14dePerformanceAnalysis,
  author    = {Charl van Heerden, Marelie Davel and Etienne Barnard},
  title     = {Performance analysis of a multilingual directory enquiries
               application},
  booktitle = {Proc. Annual Symp. Pattern Recognition Association of South 
               Africa (PRASA)},
  pages     = {258--263},
  address   = {Cape Town, South Africa},
  year      = {2014},
  month     = {November}
}

-------------------------------------------------------------------------------

DETAILED INFORMATION

DESCRIPTION:

The script [sade_recognise.agi] is typically copied to 
/var/lib/asterisk/agi-bin/ and then associated with a particular number in 
/etc/asterisk/extensions.conf.

For example, the code snippet mapping sade_recognise.agi to a particular
telephone number in /etc/asterisk/extensions.conf, may look like this:

---------------------------------------------------
exten => 1364,1,Goto(0878051364,1)
exten => 0878051364,1,Verbose(DAC SADE recognition)
exten => 0878051364,n,Ringing
exten => 0878051364,n,Set(CHANNEL(language)=sade)
exten => 0878051364,n,AGI(sade_recognise.agi)
exten => 0878051364,n(done),Hangup
---------------------------------------------------

For more information on the Asterisk Gateway Interface Class perl module,
see: http://search.cpan.org/~jamesgol/asterisk-perl/lib/Asterisk/AGI.pm

-------------------------------------------------------------------------------

DIRECTORY/FILE STRUCTURE AND DETAIL:

The SADE DE implementation is implemented as an AGI script.

sade.v1.0
└── trunk
    └── ivr
        └── sade_recognise.agi

In addition, three configuration files used by the AGI script are also included:

sade.v1.0
└── trunk
    └── ivr
        └── disambiguation.info

	This file identifies municipalities which may have to be disambiguated,
        and if so, how this should happen.

sade.v1.0
└── trunk
    └── ivr
        └── municipalities.info

	Provides the telephone number for each municipality.

sade.v1.0
└── trunk
    └── ivr
        └── sade.conf

        SADE application configuration file.

sade.v1.0
└── trunk
    └── ivr
        ├── extensions.conf
        ├── license.txt
        ├── mrcp.conf
        ├── README.de_implementation.v1.0.txt
        └── unimrcpserver.xml

        README and UniMRCP / Asterisk specific configuration files.

0 directories, 9 files

-------------------------------------------------------------------------------

ADDITIONAL DOCUMENTATION:

[1]     Charl van Heerden, Marelie Davel and Etienne Barnard, "Performance
        analysis of a multilingual directory enquiries application", in Proc. 
        Annual Symp. Pattern Recognition Association of South Africa (PRASA), 
        pp 258-263, Cape Town, South Africa, November 2014.

-------------------------------------------------------------------------------

