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
Top Related