echi-converter 0.3.6 → 0.3.7
Sign up to get free protection for your applications and to get access to all the features.
- data/History.txt +12 -1
- data/Manifest.txt +6 -0
- data/README.txt +39 -17
- data/config/application.yml +8 -3
- data/config/extended_version12.yml +49 -1
- data/config/extended_version13.yml +58 -10
- data/config/extended_version14.yml +330 -0
- data/config/install_files.yml +6 -0
- data/config/standard_version12.yml +58 -10
- data/config/standard_version13.yml +58 -10
- data/config/standard_version14.yml +294 -0
- data/db/migrate/009_create_echi_acds.rb +27 -0
- data/db/migrate/010_create_echi_splits.rb +27 -0
- data/db/migrate/011_create_echi_trunk_groups.rb +27 -0
- data/db/migrate/012_create_echi_vectors.rb +27 -0
- data/examples/db_connect_test.rb +1 -1
- data/lib/database.rb +12 -0
- data/lib/echi-converter.rb +118 -47
- data/lib/echi-converter/version.rb +1 -1
- data/website/index.html +27 -11
- data/website/index.txt +21 -9
- metadata +10 -4
data/website/index.txt
CHANGED
@@ -5,47 +5,53 @@ h1. → 'echi-converter'
|
|
5
5
|
|
6
6
|
h2. The ECHI (External Call History Interface) Converter
|
7
7
|
|
8
|
-
Provides a Ruby based utility for fetching Avaya CMS / ECHI files in binary/ASCII form from an FTP server, converting them, if necessary, to ASCII and then inserting them into a database via ActiveRecord.
|
8
|
+
Provides a Ruby based utility for fetching Avaya CMS / ECHI files in binary/ASCII form from an FTP server, converting them, if necessary, to ASCII and then inserting them into a database via ActiveRecord. With this
|
9
|
+
utility you only need the standard Avaya CMS Release 13 or better without any additional software or utilities
|
10
|
+
from Avaya, as this utility will process either binary or ASCII output from the Avaya CMS.
|
9
11
|
|
10
12
|
h2. Status
|
11
13
|
|
12
|
-
This is
|
14
|
+
This release is now in production use within Call Centers using the Avaya CMS. The utility successfully and reliably imports the data provided by the Avaya CMS ECHI into various databases, including Oracle and MySQL. This provides the repository of call segments that may then be used to provide detailed Cradle to Grave reporting for the call center.
|
13
15
|
|
14
16
|
|
15
17
|
h2. Features
|
16
18
|
|
17
19
|
The utility provides the following capabilities:
|
18
20
|
|
19
|
-
# Support of ActiveRecord (means you may use Oracle, MySQL, MS-SQL, Postgres, DB2, etc)
|
21
|
+
# Support of ActiveRecord (means you may use Oracle, MySQL, MS-SQL, Postgres, DB2, ODBC, etc)
|
20
22
|
# Generate your schema via ActiveRecord Migrations
|
21
23
|
# Fetch Binary or ASCII CSV files from the Avaya CMS platform via FTP
|
22
|
-
# Convert from the defined Binary format to ASCII
|
23
24
|
# Insert the records into the defined database table using database transactions, via ActiveRecord, on a per file basis to support recovery on failure
|
24
25
|
# Change schema structure via YML configuration file to accommodate various releases of the ECHI format
|
25
|
-
# Supports inserting data from the various '.dat' files provided
|
26
|
-
# Runs as a daemon (via fork) on
|
26
|
+
# Supports inserting data from the various '.dat' files provided by the Avaya CMS
|
27
|
+
# Runs as a daemon (via fork) on Posix and a service on Windows
|
28
|
+
# Has a watchdog process on Posix or you may set a service watch on Windows
|
27
29
|
# Allows for multiple FTP sessions to be used for greater performance (via "green threads":http://en.wikipedia.org/wiki/Green_threads)
|
28
30
|
|
29
31
|
# Table names:
|
30
32
|
## echi_records - stores all ECHI data
|
31
33
|
## echi_logs - stores a log entry for each file processed
|
34
|
+
## echi_acds - stores the data from the acd.dat file
|
32
35
|
## echi_agents - stores the data from the agname.dat file
|
33
36
|
## echi_aux_reasons - stores the data from the aux_rsn.dat file
|
34
37
|
## echi_cwcs - stores data from the cwc.dat file
|
38
|
+
## echi_splits - stores data from the split.dat file
|
39
|
+
## echi_trunk_groups - stores data from the tkgrp.dat file
|
35
40
|
## echi_vdns - stores data from the vdn.dat file
|
41
|
+
## echi_vectors - stores data from the vector.dat file
|
36
42
|
|
37
43
|
|
38
44
|
h2. Requirements
|
39
45
|
|
40
46
|
# "Ruby v1.8.6+":http://www.ruby-lang.org/
|
41
|
-
# "Rubygems
|
47
|
+
# "Rubygems v1.0.1+":http://www.rubygems.org/
|
42
48
|
# "ActiveRecord v1.15.3+":http://activerecord.rubyforge.org/
|
43
49
|
# "ActiveSupport v1.4.2+":http://activesupport.rubyforge.org/
|
44
50
|
# "Daemons v1.0.7+":http://daemons.rubyforge.org/
|
45
51
|
# "FasterCSV v1.2.0+":http://fastercsv.rubyforge.org/
|
46
52
|
# "Rake v0.7.3+":http://rake.rubyforge.org/
|
47
53
|
# "UUIDTools v1.0.1+":http://sporkmonger.com/projects/uuidtools/
|
48
|
-
# "Win32-service v.0.5.
|
54
|
+
# "Win32-service v.0.5.x - *ONLY* - ":http://win32utils.rubyforge.org/ (Manual install for Windows only)
|
49
55
|
# "Hoe v1.2.2+":http://rubyforge.org/projects/seattlerb/
|
50
56
|
|
51
57
|
|
@@ -70,13 +76,14 @@ Once you have installed a project into your preferred directory, you then need t
|
|
70
76
|
## Select which schema you would like to use (ie - extended_version12.yml) based on what you have in place
|
71
77
|
# config/database.yml
|
72
78
|
## Change to match your local database and database login credentials, full ActiveRecord support
|
79
|
+
## Note: Your database user and database must exist before running rake, as rake will then create the schema
|
73
80
|
|
74
81
|
Once this is complete, then simply run these commands from the project directory:
|
75
82
|
|
76
83
|
# rake migrate (creates the tables required for the system)
|
77
84
|
# echi-converter (starts the server daemon, refer to its usage)
|
78
85
|
|
79
|
-
Note: When using a Windows FTP server, you must configure the FTP server to provide a UNIX directory listing format
|
86
|
+
Note: When using a Windows FTP server, you must configure the FTP server to provide a UNIX directory listing format.
|
80
87
|
|
81
88
|
h2. Usage
|
82
89
|
|
@@ -151,3 +158,8 @@ This code is free to use under the terms of the LGPL license.
|
|
151
158
|
h2. Contact
|
152
159
|
|
153
160
|
Comments are welcome. Send an email to "jason [at] goecke.net":mailto:jason@goecke.net.
|
161
|
+
|
162
|
+
h2. Other Recommended Open Source Projects
|
163
|
+
|
164
|
+
# Asterisk - is the world's leading open source PBXi, telephony engine, and telephony applications toolkit, link "here.":http://www.asterisk.org
|
165
|
+
# Adhersion - is an open-source, unconventional voice framework that ties technologies together neatly, link "here.":http://www.adhearsion.com
|
metadata
CHANGED
@@ -1,15 +1,15 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: echi-converter
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.3.
|
5
|
-
platform:
|
4
|
+
version: 0.3.7
|
5
|
+
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Jason Goecke
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
11
|
|
12
|
-
date:
|
12
|
+
date: 2008-03-25 00:00:00 -07:00
|
13
13
|
default_executable:
|
14
14
|
dependencies:
|
15
15
|
- !ruby/object:Gem::Dependency
|
@@ -105,8 +105,10 @@ files:
|
|
105
105
|
- config/database.yml
|
106
106
|
- config/extended_version12.yml
|
107
107
|
- config/extended_version13.yml
|
108
|
+
- config/extended_version14.yml
|
108
109
|
- config/standard_version12.yml
|
109
110
|
- config/standard_version13.yml
|
111
|
+
- config/standard_version14.yml
|
110
112
|
- config/install_files.yml
|
111
113
|
- db/migrate/001_create_echi_records.rb
|
112
114
|
- db/migrate/002_create_echi_logs.rb
|
@@ -116,6 +118,10 @@ files:
|
|
116
118
|
- db/migrate/006_create_echi_aux_reasons.rb
|
117
119
|
- db/migrate/007_create_echi_cwcs.rb
|
118
120
|
- db/migrate/008_create_echi_vdns.rb
|
121
|
+
- db/migrate/009_create_echi_acds.rb
|
122
|
+
- db/migrate/010_create_echi_splits.rb
|
123
|
+
- db/migrate/011_create_echi_trunk_groups.rb
|
124
|
+
- db/migrate/012_create_echi_vectors.rb
|
119
125
|
- bin/echi-converter
|
120
126
|
- examples/extended_version12/chr0003
|
121
127
|
- examples/extended_version12/chr0003.txt
|
@@ -145,7 +151,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
145
151
|
requirements: []
|
146
152
|
|
147
153
|
rubyforge_project: echi-converter
|
148
|
-
rubygems_version: 0.
|
154
|
+
rubygems_version: 1.0.1
|
149
155
|
signing_key:
|
150
156
|
specification_version: 2
|
151
157
|
summary: ECHI Conversion Utility - Provides a utility to fetch Avaya CMS / ECHI binary files, convert them and insert into a database table via ActiveRecord
|