queri 0.0.3 → 0.0.4

data/lib/queri/stats/details_of_answered_calls.rb

@@ -0,0 +1,11 @@
+module Queri
+  class Stats
+    class DetailsOfAnsweredCalls
+      @@xml_code = "DetailsDO"
+
+      def self.xml_code
+        @@xml_code
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/all_calls_by_stints.rb

@@ -0,0 +1,24 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class AllCallsByStints < Queri::Stats
+        include CompositeReportHelpers
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".StintsOkKo"
+          end
+
+          def key_translations
+            Hash[
+              :number_of_stints, "Number of stints",
+              :number_of_calls, "N. Calls",
+              :percentage_of_calls, "&nbsp;",
+              :placeholder_for_bar_graph, "..."
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/call_overview.rb

@@ -0,0 +1,29 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class CallOverview < Queri::Stats
+        include CompositeReportHelpers
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".OverviewOkKo"
+          end
+
+          def key_translations
+            Hash[
+              :empty, "&nbsp;",
+              :queue, "Queue",
+              :number_of_calls_to_hit_queue, "Calls offered",
+              :calls_answered, "Calls answered",
+              :calls_unanswered, "Calls lost",
+              :average_call_duration, "Average call length:",
+              :total_call_duration, "Total call length:",
+              :average_call_waiting_time, "Average call waiting time:",
+              :total_call_waiting_time, "Total waiting time:"
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/calls_fully_within_the_given_time_interval.rb

@@ -0,0 +1,82 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class CallsFullyWithinTheGivenTimeInterval
+        attr_reader :response
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".ReportKoFully"
+          end
+
+          def query_method
+            Stats.query_method
+          end
+
+          def key_translations
+            Hash[
+              :calls_fully_within_the_given_time_interval, "Calls fully within the given time interval:",
+              :calls_unanswered, "N.of unanswered calls:",
+              :average_call_waiting_time, "Average wait time before disconnection:",
+              :minimum_call_waiting_time, "Min wait time before disconnection:",
+              :maximum_call_waiting_time, "Max wait time before disconnection:",
+              :total_call_waiting_time, "Total wait time before disconnection:",
+              :average_initial_queue_position, "Average initial position",
+              :minimum_initial_queue_position, "Min initial position",
+              :maximum_initial_queue_position, "Max initial position",
+              :queue_position_coverage, "Coverage",
+              :average_final_queue_position, "Average queue position at disconnection:",
+              :minimum_final_queue_position, "Min queue position at disconnection:",
+              :maximum_final_queue_position, "Max queue position at disconnection:"
+            ]
+          end
+
+          def keys
+            key_translations.keys
+          end
+        end
+
+        def initialize *args
+          raise ArgumentError, "expected arguments: queues(Array), period_start(Time), period_end(Time)" unless valid_args?(args)
+          @queues, @period_start, @period_end = normalize_times(*args)
+          @response = parse_response
+        end
+
+        private
+
+          def valid_args? args
+            valid = true
+            valid = false if args[0].class != Array
+            valid = false if args[1].class != Time
+            valid = false if args[2].class != Time
+            if valid and args[0].empty?
+              raise ArgumentError, "queues array cannot be empty"
+            end
+            return valid
+          end
+
+          def normalize_times queues, period_start, period_end
+            if period_start > period_end
+              tmp = period_start
+              period_start = period_end
+              period_end = tmp
+            end
+            return [queues, period_start, period_end]
+          end
+
+          def parse_response
+            r = Queri.send_request(@queues, self, @period_start, @period_end)
+            xml_keys_to_human_readable_keys = self.class.key_translations.invert
+            r.each_with_index do |metric,i|
+              if i > 0
+                metric[0] = xml_keys_to_human_readable_keys[ metric[0] ]
+              end
+            end
+            r.shift
+            Hash[*r.flatten]
+          end
+
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/disconnection_causes.rb

@@ -0,0 +1,24 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class DisconnectionCauses < Queri::Stats
+        include CompositeReportHelpers
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".DiscCauses"
+          end
+
+          def key_translations
+            Hash[
+              :disconnection_cause, "Cause",
+              :number_of_calls, "N. Calls",
+              :percentage_of_calls, "&nbsp;",
+              :placeholder_for_bar_graph, "..."
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/dnis_used.rb

@@ -0,0 +1,24 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class DnisUsed < Queri::Stats
+        include CompositeReportHelpers
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".DnisKo"
+          end
+
+          def key_translations
+            Hash[
+              :dnis, "DNIS",
+              :number_of_calls, "N. Calls",
+              :percentage_of_calls, "&nbsp;",
+              :placeholder_for_bar_graph, "..."
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/dnis_used_for_all_calls.rb

@@ -0,0 +1,24 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class DnisUsedForAllCalls < Queri::Stats
+        include CompositeReportHelpers
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".DnisOkKo"
+          end
+
+          def key_translations
+            Hash[
+              :dnis, "DNIS",
+              :number_of_calls, "N. Calls",
+              :percentage_of_calls, "&nbsp;",
+              :placeholder_for_bar_graph, "..."
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/enter_queue_position.rb

@@ -0,0 +1,24 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class EnterQueuePosition < Queri::Stats
+        include CompositeReportHelpers
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".QPosKo"
+          end
+
+          def key_translations
+            Hash[
+              :initial_queue_position, "Position at enter",
+              :number_of_calls, "N. Calls",
+              :percentage_of_calls, "&nbsp;",
+              :placeholder_for_bar_graph, "..."
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/enter_queue_position_for_all_calls.rb

@@ -0,0 +1,24 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class EnterQueuePositionForAllCalls < Queri::Stats
+        include CompositeReportHelpers
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".QPosOkKo"
+          end
+
+          def key_translations
+            Hash[
+              :initial_queue_position, "Position at enter",
+              :number_of_calls, "N. Calls",
+              :percentage_of_calls, "&nbsp;",
+              :placeholder_for_bar_graph, "..."
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/inclusive_answered_service_level_agreement.rb

@@ -0,0 +1,25 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class InclusiveAnsweredServiceLevelAgreement < Queri::Stats
+        include CompositeReportHelpers
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".InclusiveAnswSLA"
+          end
+
+          def key_translations
+            Hash[
+              :time_interval, "Hangup",
+              :calls_taken_in_time_interval, "N. Calls",
+              :calls_between_lower_interval, "Delta",
+              :percentage_of_calls_within_interval, "&nbsp;",
+              :placeholder_for_bar_graph, "..."
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/inclusive_service_level_agreement.rb

@@ -0,0 +1,25 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class InclusiveServiceLevelAgreement < Queri::Stats
+        include CompositeReportHelpers
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".InclusiveSLA"
+          end
+
+          def key_translations
+            Hash[
+              :time_interval, "Hangup",
+              :calls_taken_in_time_interval, "N. Calls",
+              :calls_between_lower_interval, "Delta",
+              :percentage_of_calls_within_interval, "Percent",
+              :placeholder_for_bar_graph, "..."
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/ivr_selection.rb

@@ -0,0 +1,28 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class IvrSelection < Queri::Stats
+        include CompositeReportHelpers
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".IvrKo"
+          end
+
+          def key_translations
+            Hash[
+              :ivr_selection, "IVR",
+              :number_of_calls, "N. Calls",
+              :percentage_of_calls, "&nbsp;",
+              :placeholder_for_bar_graph, "...",
+              :total_duration_of_call_in_ivr, "Total Duration",
+              :average_duration_of_call_in_ivr, "Average Duration",
+              :minimum_duration_of_call_in_ivr, "Min Duration",
+              :maximum_duration_of_call_in_ivr, "Max Duration"
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/ivr_selection_for_all_calls.rb

@@ -0,0 +1,24 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class IvrSelectionForAllCalls < Queri::Stats
+        include CompositeReportHelpers
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".IvrOkKo"
+          end
+
+          def key_translations
+            Hash[
+              :ivr_selection, "IVR",
+              :number_of_calls, "N. Calls",
+              :percentage_of_calls, "&nbsp;",
+              :placeholder_for_bar_graph, "..."
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/unanswered_calls_by_key_press.rb

@@ -0,0 +1,24 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class UnansweredCallsByKeyPress < Queri::Stats
+        include CompositeReportHelpers
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".ReportKoKeyPress"
+          end
+
+          def key_translations
+            Hash[
+              :key_pressed, "Key",
+              :number_of_calls, "N. Calls",
+              :percentage_of_calls, "&nbsp;",
+              :placeholder_for_bar_graph, "..."
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/unanswered_calls_by_queue.rb

@@ -0,0 +1,25 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class UnansweredCallsByQueue < Queri::Stats
+        include CompositeReportHelpers
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".UnansByQueue"
+          end
+
+          def key_translations
+            Hash[
+              :empty_column, "&nbsp;",
+              :queue, "Queue",
+              :number_of_calls, "N. Calls",
+              :percentage_of_calls, "&nbsp;",
+              :placeholder_for_bar_graph, "..."
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/unanswered_calls_by_stints.rb

@@ -0,0 +1,24 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class UnansweredCallsByStints < Queri::Stats
+        include CompositeReportHelpers
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".StintsKo"
+          end
+
+          def key_translations
+            Hash[
+              :number_of_stints, "Number of stints",
+              :number_of_calls, "N. Calls",
+              :percentage_of_calls, "&nbsp;",
+              :placeholder_for_bar_graph, "..."
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/unanswered_calls_distribution_by_length.rb

@@ -0,0 +1,26 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class UnansweredCallsDistributionByLength < Queri::Stats
+        include CompositeReportHelpers
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".UnansByLen"
+          end
+
+          def key_translations
+            Hash[
+              :time_interval, "Hangup",
+              :calls_taken_in_time_interval, "N. Calls",
+              :calls_between_lower_interval, "Delta",
+              :percentage_of_calls_within_interval, "Percent",
+              :percentage_of_all_calls, "Of Offered",
+              :placeholder_for_bar_graph, "..."
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/queri/stats/unanswered_calls/unanswered_outbound_calls_by_agent.rb

@@ -0,0 +1,24 @@
+module Queri
+  class Stats
+    class UnansweredCalls
+      class UnansweredOutboundCallsByAgent < Queri::Stats
+        include CompositeReportHelpers
+
+        class << self
+          def xml_code
+            UnansweredCalls.xml_code + ".OutboundKo"
+          end
+
+          def key_translations
+            Hash[
+              :agent, "Agent",
+              :number_of_calls, "N. Calls",
+              :percentage_of_calls, "&nbsp;",
+              :placeholder_for_bar_graph, "..."
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/queri/stats.rb

@@ -1,9 +1,26 @@
 module Queri
   class Stats
+    include ArgHelpers
+
+    attr_reader :response
+
     @@query_method = "QM.stats"
 
-    def self.query_method
-      @@query_method
+    class << self
+      def query_method
+        @@query_method
+      end
+
+      def keys
+        key_translations.keys
+      end
     end
+
+    def initialize *args
+      raise ArgumentError, "expected arguments: queues(Array), period_start(Time), period_end(Time)" unless valid_args?(args)
+      @queues, @period_start, @period_end = normalize_times(*args)
+      @response = parse_response
+    end
+
   end
 end

data/lib/queri/version.rb

@@ -1,3 +1,3 @@
 module Queri
-  VERSION = "0.0.3"
+  VERSION = "0.0.4"
 end

data/spec/stats/agents_and_sessions/agent_availability_spec.rb

@@ -1,4 +1,4 @@
-require File.join( File.dirname(__FILE__), '..', '..', 'spec_helper' )
+require 'spec_helper'
 
 describe Queri::Stats::AgentsAndSessions::AgentAvailability do
   let(:report_class) { Queri::Stats::AgentsAndSessions::AgentAvailability }

data/spec/stats/agents_and_sessions/agents_and_sessions_spec.rb

@@ -1,4 +1,4 @@
-require File.join( File.dirname(__FILE__), '..', '..', 'spec_helper' )
+require 'spec_helper'
 
 describe Queri::Stats::AgentsAndSessions do
   let(:report_class) { Queri::Stats::AgentsAndSessions }

data/spec/stats/answered_calls/agents_on_queue_spec.rb

@@ -1,4 +1,4 @@
-require File.join( File.dirname(__FILE__), '..', '..', 'spec_helper' )
+require 'spec_helper'
 
 describe Queri::Stats::AnsweredCalls::AgentsOnQueue do
   let(:report_class) { Queri::Stats::AnsweredCalls::AgentsOnQueue }

data/spec/stats/answered_calls/all_calls_spec.rb

@@ -1,4 +1,4 @@
-require File.join( File.dirname(__FILE__), '..', '..', 'spec_helper' )
+require 'spec_helper'
 
 describe Queri::Stats::AnsweredCalls::AllCalls do
   let(:report_class) { Queri::Stats::AnsweredCalls::AllCalls }

data/spec/stats/answered_calls/answered_calls_spec.rb

@@ -1,4 +1,4 @@
-require File.join( File.dirname(__FILE__), '..', '..', 'spec_helper' )
+require 'spec_helper'
 
 describe Queri::Stats::AnsweredCalls do
   let(:report_class) { Queri::Stats::AnsweredCalls }

data/spec/stats/details_of_answered_calls/details_of_answered_calls_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe Queri::Stats::DetailsOfAnsweredCalls do
+  let(:report_class) { Queri::Stats::DetailsOfAnsweredCalls }
+
+  it_behaves_like "a report class"
+end

data/spec/stats/details_of_answered_calls/queue_details_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe Queri::Stats::DetailsOfAnsweredCalls::QueueDetails do
+  let(:report_class) { Queri::Stats::DetailsOfAnsweredCalls::QueueDetails }
+  let(:xml_code) { report_class.xml_code }
+
+  before { Queri.configure_with(File.join(File.dirname(__FILE__), '..', '..', 'config.yml')) }
+
+  it_behaves_like "a report class"
+
+  it_behaves_like "a report method"
+
+  it_behaves_like "a queuemetrics report"
+
+  it_behaves_like "a stats report"
+
+  describe "An instance of", Queri::Stats::DetailsOfAnsweredCalls::QueueDetails do
+    it_behaves_like "an agent-level report instance"
+  end
+end

data/spec/stats/unanswered_calls/all_calls_by_stints_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+describe Queri::Stats::UnansweredCalls::AllCallsByStints do
+  let(:report_class) { Queri::Stats::UnansweredCalls::AllCallsByStints }
+  let(:xml_code) { report_class.xml_code }
+
+  before do
+    Queri.configure_with(File.join(File.dirname(__FILE__), '..', '..', 'config.yml'))
+  end
+
+  it_behaves_like "a report class"
+
+  it_behaves_like "a report method"
+
+  it_behaves_like "a queuemetrics report"
+
+  it_behaves_like "a stats report"
+
+  describe "An instance of", Queri::Stats::UnansweredCalls::AllCallsByStints do
+    it_behaves_like "a composite aggregate report instance"
+  end
+end

data/spec/stats/unanswered_calls/call_overview_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+describe Queri::Stats::UnansweredCalls::CallOverview do
+  let(:report_class) { Queri::Stats::UnansweredCalls::CallOverview }
+  let(:xml_code) { report_class.xml_code }
+
+  before do
+    Queri.configure_with(File.join(File.dirname(__FILE__), '..', '..', 'config.yml'))
+  end
+
+  it_behaves_like "a report class"
+
+  it_behaves_like "a report method"
+
+  it_behaves_like "a queuemetrics report"
+
+  it_behaves_like "a stats report"
+
+  describe "An instance of", Queri::Stats::UnansweredCalls::CallOverview do
+    it_behaves_like "a composite aggregate report instance"
+  end
+end