queri 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 612927a2b34f04be0e348fe2e912d394c76f090f
-  data.tar.gz: 4190fbb0234b4030c19d99c27b657f46ed04aa83
+  metadata.gz: 81573e2933bacb797683dfda3f935882e6754f07
+  data.tar.gz: 9da9459034980ce147cb498b850aa783ec41bfd1
 SHA512:
-  metadata.gz: 94e0ac64d458d469c8cf265ba2ba992ce9dff4b6db946a92b86352540159a886923ca83d29b4f51e9c864cef890ef680df96a05ea2448d2cc7da4e3bb43b7601
-  data.tar.gz: 5dbf0d3d62ccfa59d13b0585fe29646ef9b30da8ba7460debc9a2aeff502894936817c5056fa0d09005eace22ecc95c725a6fe3f0d27962d0710ee7a2d55c294
+  metadata.gz: 5b0184f3413c0d6cdb93564fa5239549adb704abb4e37e201aaf4cf5ee1bccbd299b09c2e3ea7c9b526d85da12b1587ba8a1924f82a2b88260508d4570ae71c9
+  data.tar.gz: b76246a5b1b0c5e1c2e5d7ba532be82eef0cdff49d2122f33f1e0e0a2db4df93f0392438ba0801b5dd075c88bc33f0b3d598614a3431761864e55f3491ffd710

data/README.md

@@ -55,7 +55,7 @@ Currently returns analyses from two methods: QM.stats and QM.realtime.
       * AnsweredCallsByDirection
       * AnsweredCallsByQueue
       * AnsweredCallsByStints
-      * CallsFullyWithinGivenTimeInterval
+      * CallsFullyWithinTheGivenTimeInterval
       * DisconnectionCauses
       * DnisUsed
       * IvrSelection
@@ -66,8 +66,27 @@ Currently returns analyses from two methods: QM.stats and QM.realtime.
     * DetailsOfAgentSessionsAndPauses
       * DetailOfAgentSessions
       * DetailOfAgentPauses
+    * DetailsOfAnsweredCalls
+      * QueueDetails
     * UnansweredCalls
       * AllCalls
+      * AllCallsByStints
+      * CallOverview
+      * CallsFullyWithinTheGivenTimeInterval
+      * DisconnectionCauses
+      * DnisUsed
+      * DnisUsedForAllCalls
+      * EnterQueuePosition
+      * EnterQueuePositionForAllCalls
+      * InclusiveAnsweredServiceLevelAgreement
+      * InclusiveServiceLevelAgreement
+      * IvrSelection
+      * IvrSelectionForAllCalls
+      * UnansweredCallsByKeyPress
+      * UnansweredCallsByQueue
+      * UnansweredCallsByStints
+      * UnansweredCallsDistributionByLength
+      * UnansweredOutboundCallsByAgent
   * Realtime
     * Agents
     * Queues
@@ -93,13 +112,17 @@ Composite aggregate reports return an Array of Hashes, each Hash corresponding t
         * AgentAvailability
       * AnsweredCalls
         * AgentsOnQueue
+        * MusicOnHoldByAgent
+      * DetailsOfAnsweredCalls
+        * QueueDetails
+      * UnansweredCalls
+        * UnansweredOutboundCallsByAgent
+        * UnansweredCallsByKeyPress
     * Realtime
       * Agents
       * Queues
   * Composite agent-level reports
     * Stats
-      * AnsweredCalls
-        * MusicOnHoldByAgent
       * DetailsOfAgentSessionsAndPauses
         * DetailOfAgentSessions
         * DetailOfAgentPauses
@@ -107,9 +130,10 @@ Composite aggregate reports return an Array of Hashes, each Hash corresponding t
     * Stats
       * AnsweredCalls
         * AllCalls
-        * CallsFullyWithinGivenTimeInterval
+        * CallsFullyWithinTheGivenTimeInterval
       * UnansweredCalls
         * AllCalls
+        * CallsFullyWithinTheGivenTimeInterval
   * Composite aggregate reports
     * Stats
       * AnsweredCalls
@@ -122,6 +146,21 @@ Composite aggregate reports return an Array of Hashes, each Hash corresponding t
         * QueuePosition
         * ServiceLevelAgreement
         * Transfers
+      * UnansweredCalls
+        * AllCallsByStints
+        * CallOverview
+        * DisconnectionCauses
+        * DnisUsed
+        * DnisUsedForAllCalls
+        * EnterQueuePosition
+        * EnterQueuePositionForAllCalls
+        * InclusiveAnsweredServiceLevelAgreement
+        * InclusiveServiceLevelAgreement
+        * IvrSelection
+        * IvrSelectionForAllCalls
+        * UnansweredCallsByQueue
+        * UnansweredCallsByStints
+        * UnansweredCallsDistributionByLength
 
 ## Contributing
 

data/lib/queri/aggregate_report_helpers.rb

@@ -0,0 +1,15 @@
+module AggregateReportHelpers
+  private
+
+    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

data/lib/queri/arg_helpers.rb

@@ -0,0 +1,24 @@
+module ArgHelpers
+
+  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
+end

data/lib/queri/composite_agent_level_report_helpers.rb

@@ -0,0 +1,19 @@
+module CompositeAgentLevelReportHelpers
+  private
+
+    def parse_response
+      r = Queri.send_request(@queues, self, @period_start, @period_end)
+      xml_keys_to_human_readable_keys = self.class.key_translations.invert
+      new_keys = r.shift.map {|k| xml_keys_to_human_readable_keys[k]}
+      agent_metrics = []
+      r.each do |agent|
+        agent_metrics << Hash[new_keys.zip(agent)]
+      end
+      agents = agent_metrics.map {|a| a[:agent]}.uniq
+      parsed_metrics = Hash.new
+      agents.each do |agent|
+        parsed_metrics[agent] = agent_metrics.select {|m| m[:agent] == agent}
+      end
+      return parsed_metrics
+    end
+end

data/lib/queri/composite_report_helpers.rb

@@ -0,0 +1,14 @@
+module CompositeReportHelpers
+  private
+
+    def parse_response
+      r = Queri.send_request(@queues, self, @period_start, @period_end)
+      xml_keys_to_human_readable_keys = self.class.key_translations.invert
+      new_keys = r.shift.map {|k| xml_keys_to_human_readable_keys[k]}
+      agent_metrics = []
+      r.each do |agent|
+        agent_metrics << Hash[new_keys.zip(agent)]
+      end
+      return agent_metrics
+    end
+end

data/lib/queri/stats/agents_and_sessions/agent_availability.rb

@@ -1,18 +1,14 @@
 module Queri
   class Stats
     class AgentsAndSessions
-      class AgentAvailability
-        attr_reader :response
+      class AgentAvailability < Queri::Stats
+        include CompositeReportHelpers
 
         class << self
           def xml_code
             AgentsAndSessions.xml_code + ".AgentAvail"
           end
 
-          def query_method
-            Stats.query_method
-          end
-
           def key_translations
             Hash[
               :level, "Level",
@@ -26,50 +22,7 @@ module Queri
               :placeholder_for_bar_graph, "..."
             ]
           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
-            new_keys = r.shift.map {|k| xml_keys_to_human_readable_keys[k]}
-            agent_metrics = []
-            r.each do |agent|
-              agent_metrics << Hash[new_keys.zip(agent)]
-            end
-            return agent_metrics
-          end
       end
     end
   end

data/lib/queri/stats/answered_calls/agents_on_queue.rb

@@ -1,18 +1,14 @@
 module Queri
   class Stats
     class AnsweredCalls
-      class AgentsOnQueue
-        attr_reader :response
+      class AgentsOnQueue < Queri::Stats
+        include CompositeReportHelpers
 
         class << self
           def xml_code
             AnsweredCalls.xml_code + ".AgentsOnQueue"
           end
 
-          def query_method
-            Stats.query_method
-          end
-
           def key_translations
             Hash[
               :agent, "Agent",
@@ -23,50 +19,7 @@ module Queri
               :average_call_time, "Average call time"
             ]
           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
-            new_keys = r.shift.map {|k| xml_keys_to_human_readable_keys[k]}
-            agent_metrics = []
-            r.each do |agent|
-              agent_metrics << Hash[new_keys.zip(agent)]
-            end
-            return agent_metrics
-          end
       end
     end
   end

data/lib/queri/stats/answered_calls/all_calls.rb

@@ -1,18 +1,14 @@
 module Queri
   class Stats
     class AnsweredCalls
-      class AllCalls
-        attr_reader :response
+      class AllCalls < Queri::Stats
+        include AggregateReportHelpers
 
         class << self
           def xml_code
             AnsweredCalls.xml_code + ".RiassAllCalls"
           end
 
-          def query_method
-            Stats.query_method
-          end
-
           def key_translations
             Hash[
               :calls_answered, "N. calls answered by operators:",
@@ -30,51 +26,7 @@ module Queri
               :queue_position_coverage, "Coverage"
             ]
           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

data/lib/queri/stats/answered_calls/answered_calls_by_direction.rb

@@ -1,18 +1,14 @@
 module Queri
   class Stats
     class AnsweredCalls
-      class AnsweredCallsByDirection
-        attr_reader :response
+      class AnsweredCallsByDirection < Queri::Stats
+        include CompositeReportHelpers
 
         class << self
           def xml_code
             AnsweredCalls.xml_code + ".AnsweredcallsByDirection"
           end
 
-          def query_method
-            Stats.query_method
-          end
-
           def key_translations
             Hash[
               :direction_icon, "&nbsp;",
@@ -22,52 +18,7 @@ module Queri
               :placeholder_for_bar_graph, "..."
             ]
           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
-            new_keys = r.shift.map {|k| xml_keys_to_human_readable_keys[k]}
-            agent_metrics = []
-            r.each do |agent|
-              agent_metrics << Hash[new_keys.zip(agent)]
-            end
-            return agent_metrics
-          end
-
       end
     end
   end

data/lib/queri/stats/answered_calls/answered_calls_by_queue.rb

@@ -1,18 +1,14 @@
 module Queri
   class Stats
     class AnsweredCalls
-      class AnsweredCallsByQueue
-        attr_reader :response
+      class AnsweredCallsByQueue < Queri::Stats
+        include CompositeReportHelpers
 
         class << self
           def xml_code
             AnsweredCalls.xml_code + ".AnsweredcallsByQueue"
           end
 
-          def query_method
-            Stats.query_method
-          end
-
           def key_translations
             Hash[
               :empty_column, "&nbsp;",
@@ -22,52 +18,7 @@ module Queri
               :placeholder_for_bar_graph, "..."
             ]
           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
-            new_keys = r.shift.map {|k| xml_keys_to_human_readable_keys[k]}
-            agent_metrics = []
-            r.each do |agent|
-              agent_metrics << Hash[new_keys.zip(agent)]
-            end
-            return agent_metrics
-          end
-
       end
     end
   end

data/lib/queri/stats/answered_calls/answered_calls_by_stints.rb

@@ -1,18 +1,14 @@
 module Queri
   class Stats
     class AnsweredCalls
-      class AnsweredCallsByStints
-        attr_reader :response
+      class AnsweredCallsByStints < Queri::Stats
+        include CompositeReportHelpers
 
         class << self
           def xml_code
             AnsweredCalls.xml_code + ".StintsOk"
           end
 
-          def query_method
-            Stats.query_method
-          end
-
           def key_translations
             Hash[
               :number_of_stints, "Number of stints",
@@ -21,52 +17,7 @@ module Queri
               :placeholder_for_bar_graph, "..."
             ]
           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
-            new_keys = r.shift.map {|k| xml_keys_to_human_readable_keys[k]}
-            agent_metrics = []
-            r.each do |agent|
-              agent_metrics << Hash[new_keys.zip(agent)]
-            end
-            return agent_metrics
-          end
-
       end
     end
   end

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

@@ -1,18 +1,14 @@
 module Queri
   class Stats
     class AnsweredCalls
-      class CallsFullyWithinTheGivenTimeInterval
-        attr_reader :response
+      class CallsFullyWithinTheGivenTimeInterval < Queri::Stats
+        include AggregateReportHelpers
 
         class << self
           def xml_code
             AnsweredCalls.xml_code + ".RiassFullyWithin"
           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:",
@@ -31,51 +27,7 @@ module Queri
               :queue_position_coverage, "Coverage"
             ]
           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