Cradle to Grave ReportingECHi-Converter

Background• As of Avaya CMS Release 13 the External Call History

Interface (ECHi) is provided without additional charge

• You may configure this feature yourself, or engage Avaya Global Services to do so

• The files that Avaya CMS provides natively are binary encoded, so you may decode or:

• Pay Avaya ~USD$6K to provide an adaptor that outputs ASCII CSV files (+ services to install)

• Use the opensource ECHi-Converter!

ECHI-Converter @ RubyForge.org

•Open Source (LGPL)•Written in Ruby Scripting Language•Converts CMS/ECHI

•Binary -> ASCII•Or parses ASCII/CSV

•Inserts into database•Leverages ActiveRecord•Uses transactions on a per file basis•May insert into Oracle, MS-SQL, MySQL, Postgres, SQLite, etc

Homepage: http://echi-converter.rubyforge.org/Google Group:http://groups.google.com/group/echi-converter

ECHI-Converter

1. AVAYA pushes to FTP server2. ECHI-Converter pulls from FTP server and places file in ‘ToProcess’ directory3. ECHI-Converter either converts from binary, or parses CSV and inserts into the configured database4. ECHI-Converter then copies the files locally to a ‘Processed’ directory as a backup5. ECHI-Converter then writes to a Log table in Oracle

AVAYA CMS

ECHI-Converter

VMWare Image(CentOS v5.0)

Database Server(Oracle, MS-SQL, MySQL, etc)

1. AVAYA pushes to FTP server2. ECHI-Converter pulls from FTP server and places file in ‘ToProcess’ directory3. ECHI-Converter either converts from binary, or parses CSV and inserts into the configured database4. ECHI-Converter then copies the files locally to a ‘Processed’ directory as a backup5. ECHI-Converter then writes to a Log table in Oracle

AVAYA CMS

ECHI-Converter

External Call History

VMWare Image(CentOS v5.0)

FTPServer

Database Server(Oracle, MS-SQL, MySQL, etc)

1. AVAYA pushes to FTP server2. ECHI-Converter pulls from FTP server and places file in ‘ToProcess’ directory3. ECHI-Converter either converts from binary, or parses CSV and inserts into the configured database4. ECHI-Converter then copies the files locally to a ‘Processed’ directory as a backup5. ECHI-Converter then writes to a Log table in Oracle

PREP

PCO_ECHIRECORD

PC)_ECHILOG

ECHIConverter

AVAYA CMS

ECHI-Converter

External Call History

VMWare Image(CentOS v5.0)

FTPServer

Database Server(Oracle, MS-SQL, MySQL, etc)

1. AVAYA pushes to FTP server2. ECHI-Converter pulls from FTP server and places file in ‘ToProcess’ directory3. ECHI-Converter either converts from binary, or parses CSV and inserts into the configured database4. ECHI-Converter then copies the files locally to a ‘Processed’ directory as a backup5. ECHI-Converter then writes to a Log table in Oracle

1

PREP

PCO_ECHIRECORD

PC)_ECHILOG

ECHIConverter

AVAYA CMS

ECHI-Converter

External Call History

VMWare Image(CentOS v5.0)

FTPServer

Database Server(Oracle, MS-SQL, MySQL, etc)

1. AVAYA pushes to FTP server2. ECHI-Converter pulls from FTP server and places file in ‘ToProcess’ directory3. ECHI-Converter either converts from binary, or parses CSV and inserts into the configured database4. ECHI-Converter then copies the files locally to a ‘Processed’ directory as a backup5. ECHI-Converter then writes to a Log table in Oracle

1

PREP

PCO_ECHIRECORD

PC)_ECHILOG

ECHIConverter

2

AVAYA CMS

ECHI-Converter

External Call History

VMWare Image(CentOS v5.0)

FTPServer

Database Server(Oracle, MS-SQL, MySQL, etc)

1. AVAYA pushes to FTP server2. ECHI-Converter pulls from FTP server and places file in ‘ToProcess’ directory3. ECHI-Converter either converts from binary, or parses CSV and inserts into the configured database4. ECHI-Converter then copies the files locally to a ‘Processed’ directory as a backup5. ECHI-Converter then writes to a Log table in Oracle

3

1

PREP

PCO_ECHIRECORD

PC)_ECHILOG

ECHIConverter

2

AVAYA CMS

ECHI-Converter

External Call History

VMWare Image(CentOS v5.0)

FTPServer

Database Server(Oracle, MS-SQL, MySQL, etc)

1. AVAYA pushes to FTP server2. ECHI-Converter pulls from FTP server and places file in ‘ToProcess’ directory3. ECHI-Converter either converts from binary, or parses CSV and inserts into the configured database4. ECHI-Converter then copies the files locally to a ‘Processed’ directory as a backup5. ECHI-Converter then writes to a Log table in Oracle

4

3

1

Files PREP

PCO_ECHIRECORD

PC)_ECHILOG

ECHIConverter

2

AVAYA CMS

ECHI-Converter

External Call History

VMWare Image(CentOS v5.0)

FTPServer

Database Server(Oracle, MS-SQL, MySQL, etc)

5

1. AVAYA pushes to FTP server2. ECHI-Converter pulls from FTP server and places file in ‘ToProcess’ directory3. ECHI-Converter either converts from binary, or parses CSV and inserts into the configured database4. ECHI-Converter then copies the files locally to a ‘Processed’ directory as a backup5. ECHI-Converter then writes to a Log table in Oracle

4

3

1

Files PREP

PCO_ECHIRECORD

PC)_ECHILOG

ECHIConverter

2

Failure Recovery

• ECHi-Converter starts a new database transaction at the start of each individual file

• Once that file is complete it commits the transaction and copies the file to the ‘files/processed/’ directory (appropriate date/year subdirectory)

• If a failure occurs during processing a file, the transaction is rolled back and the file left in the ‘files/to_process’ directory

• Upon restart of the utility, it will begin processing the files again without duplicating information in the database

Important Fields• CALLID - TA unique number assigned to this call and all its call segments.

• UCID - The Universal Call Identifier - a unique number assigned to this call segmentwithin the customer network.

• SEGMENTID - The number identifying the call segment. Segment numbers are from 1 up to the number of segments in the call.

• SEGSTART - The UNIX time and date when the call segment started.

• SEGSTOP - The UNIX time and date when the call segment ended.

• FIRSTVDN - The number of the first VDN associated with the call segment. This will be blank for calls not associated with a VDN.

• VDN2 through VDN9 - The first 8 VDNs and the last VDN associated with a call. segment.

Avaya ECH ReferenceCMS External Call History_ECHI.pdf

Avaya ECH ReferenceCMS External Call History_ECHI.pdf