exact_target_sdk 0.3.0 → 0.4.0

data/CHANGELOG.rdoc

@@ -1,5 +1,10 @@
 = ExactTarget SDK
 
+== Version 0.4.0
+* Implementing Retrieve method
+* Implementing FilterPart objects
+* New implementation for Result classes that makes all properties available
+
 == Version 0.3.0
 * Implementing Update method
 

data/README.rdoc

@@ -10,9 +10,9 @@ outlined in the guide linked above are used. This is done in an attempt to be
 as transparent as possible, so that the API may be used by referring only to
 the guide linked above.
 
-Note this SDK is currently very incomplete, allowing you only to create and
-update subscribers and trigger sends. The framework is in place, however, to
-very easily implement new objects by simply declaring their properties.
+Note this SDK is currently quite incomplete, supporting only a subset of the
+possible objects and methods. The framework is in place, however, to very
+easily implement new objects by simply declaring their properties.
 
 == Synopsis:
 

data/lib/exact_target_sdk.rb

@@ -6,8 +6,14 @@ module ExactTargetSDK
   autoload :APIObject, 'exact_target_sdk/api_object'
   autoload :Attribute, 'exact_target_sdk/attribute'
   autoload :Client, 'exact_target_sdk/client'
+  autoload :ComplexFilterPart, 'exact_target_sdk/complex_filter_part'
   autoload :CreateResponse, 'exact_target_sdk/create_response'
   autoload :CreateResult, 'exact_target_sdk/create_result'
+  autoload :FilterPart, 'exact_target_sdk/filter_part'
+  autoload :Result, 'exact_target_sdk/result'
+  autoload :RetrieveResponse, 'exact_target_sdk/retrieve_response'
+  autoload :RetrieveResult, 'exact_target_sdk/retrieve_result'
+  autoload :SimpleFilterPart, 'exact_target_sdk/simple_filter_part'
   autoload :Subscriber, 'exact_target_sdk/subscriber'
   autoload :TriggeredSend, 'exact_target_sdk/triggered_send'
   autoload :TriggeredSendDefinition, 'exact_target_sdk/triggered_send_definition'

data/lib/exact_target_sdk/api_object.rb

@@ -69,6 +69,10 @@ class APIObject
       @properties || []
     end
 
+    def type_name
+      name.split('::').last
+    end
+
     private
 
     # Stores the given property name to be used at render time.
@@ -93,7 +97,7 @@ class APIObject
   #
   # May be overridden.
   def type_name
-    self.class.name.split('::').last
+    self.class.type_name
   end
 
   # By default, runs validation and executes #render_properties!.
@@ -120,7 +124,7 @@ class APIObject
 
   def render_property!(property_name, property_value, xml)
     if property_value.is_a?(APIObject)
-      xml.__send__(property_name) do
+      xml.__send__(property_name, { "xsi:type" => property_value.type_name } ) do
         property_value.render!(xml)
       end
     elsif property_value.is_a?(Array)

data/lib/exact_target_sdk/client.rb

@@ -64,6 +64,45 @@ class Client
     CreateResponse.new(response)
   end
 
+  # Invokes the Retrieve method.
+  #
+  # Note that this implementation abstracts away the useless RetrieveRequest
+  # sub-wrapper, and introduces a RequestResponse wrapper to contain the
+  # output parameters.
+  #
+  # Does not currently support requests that have too many results for one
+  # batch.
+  #
+  # Possible exceptions are:
+  #   HTTPError         if an HTTP error (such as a timeout) occurs
+  #   SOAPFault         if a SOAP fault occurs
+  #   Timeout           if there is a timeout waiting for the response
+  #   InvalidAPIObject  if any of the provided objects don't pass validation
+  #
+  # Returns a RetrieveResponse object.
+  def Retrieve(object_type_name, filter, *properties)
+    object_type_name = object_type_name.type_name if object_type_name.respond_to?(:type_name)
+    response = execute_request 'Retrieve' do |xml|
+      xml.RetrieveRequestMsg do
+        xml.RetrieveRequest do
+          xml.Options
+
+          xml.ObjectType object_type_name
+
+          properties.each do |property|
+            xml.Properties(property)
+          end
+
+          xml.Filter "xsi:type" => filter.type_name do
+            filter.render!(xml)
+          end
+        end
+      end
+    end
+
+    RetrieveResponse.new(response)
+  end
+
   # Invokes the Update method.
   #
   # The provided arguments should each be sub-classes of APIObject, and each

data/lib/exact_target_sdk/complex_filter_part.rb

@@ -0,0 +1,9 @@
+module ExactTargetSDK
+class ComplexFilterPart < FilterPart
+
+  property 'LeftOperand', true
+  property 'LogicalOperator', true
+  property 'RightOperand', true
+
+end
+end

data/lib/exact_target_sdk/create_result.rb

@@ -1,23 +1,4 @@
-require 'active_support/inflector'
-
 module ExactTargetSDK
-class CreateResult
-
-  PROPERTIES = [
-    'StatusCode',
-    'StatusMessage',
-    'ErrorCode'
-  ]
-
-  PROPERTIES.each do |property|
-    attr_reader property
-  end
-
-  def initialize(hash)
-    PROPERTIES.each do |property|
-      instance_variable_set("@#{property}", hash[property.underscore.to_sym])
-    end
-  end
-
+class CreateResult < Result
 end
 end

data/lib/exact_target_sdk/filter_part.rb

@@ -0,0 +1,6 @@
+module ExactTargetSDK
+
+class FilterPart < APIObject
+end
+
+end

data/lib/exact_target_sdk/result.rb

@@ -0,0 +1,15 @@
+require 'active_support/inflector'
+
+module ExactTargetSDK
+class Result
+
+  def initialize(hash)
+    @result = hash
+  end
+
+  def method_missing(symbol, *args)
+    @result[symbol.to_s.underscore.to_sym]
+  end
+
+end
+end

data/lib/exact_target_sdk/retrieve_response.rb

@@ -0,0 +1,25 @@
+module ExactTargetSDK
+class RetrieveResponse
+
+  attr_reader :OverallStatus, :RequestID, :Results
+
+  def initialize(response)
+    response = response.to_hash[:retrieve_response_msg]
+    @OverallStatus = response[:overall_status]
+    @RequestID = response[:request_id]
+    @Results = []
+
+    results = if response[:results].is_a? Array
+      response[:results]
+    elsif response[:results].is_a? Hash
+      [ response[:results] ]
+    else
+      []
+    end
+    results.each do |result|
+      @Results << RetrieveResult.new(result)
+    end
+  end
+
+end
+end

data/lib/exact_target_sdk/retrieve_result.rb

@@ -0,0 +1,4 @@
+module ExactTargetSDK
+class RetrieveResult < Result
+end
+end

data/lib/exact_target_sdk/simple_filter_part.rb

@@ -0,0 +1,9 @@
+module ExactTargetSDK
+class SimpleFilterPart < FilterPart
+
+  property 'Property', true
+  property 'SimpleOperator', true
+  array_property 'Value'
+
+end
+end

data/lib/exact_target_sdk/update_result.rb

@@ -1,23 +1,4 @@
-require 'active_support/inflector'
-
 module ExactTargetSDK
-class UpdateResult
-
-  PROPERTIES = [
-    'StatusCode',
-    'StatusMessage',
-    'ErrorCode'
-  ]
-
-  PROPERTIES.each do |property|
-    attr_reader property
-  end
-
-  def initialize(hash)
-    PROPERTIES.each do |property|
-      instance_variable_set("@#{property}", hash[property.underscore.to_sym])
-    end
-  end
-
+class UpdateResult < Result
 end
 end

data/lib/exact_target_sdk/version.rb

@@ -1,3 +1,3 @@
 module ExactTargetSDK
-  VERSION = '0.3.0'
+  VERSION = '0.4.0'
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: exact_target_sdk
 version: !ruby/object:Gem::Version 
-  hash: 19
+  hash: 15
   prerelease: 
   segments: 
   - 0
-  - 3
+  - 4
   - 0
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors: 
 - David Dawson
@@ -91,10 +91,16 @@ files:
 - lib/exact_target_sdk/api_object.rb
 - lib/exact_target_sdk/attribute.rb
 - lib/exact_target_sdk/client.rb
+- lib/exact_target_sdk/complex_filter_part.rb
 - lib/exact_target_sdk/config.rb
 - lib/exact_target_sdk/create_response.rb
 - lib/exact_target_sdk/create_result.rb
 - lib/exact_target_sdk/errors.rb
+- lib/exact_target_sdk/filter_part.rb
+- lib/exact_target_sdk/result.rb
+- lib/exact_target_sdk/retrieve_response.rb
+- lib/exact_target_sdk/retrieve_result.rb
+- lib/exact_target_sdk/simple_filter_part.rb
 - lib/exact_target_sdk/subscriber.rb
 - lib/exact_target_sdk/triggered_send.rb
 - lib/exact_target_sdk/triggered_send_definition.rb