ZCRMSDK 1.0.4 → 3.0.0

data/src/com/zoho/crm/api/territories/response_handler.rb

@@ -0,0 +1,10 @@
+module Territories
+  module ResponseHandler
+
+    # Creates an instance of ResponseHandler
+    def initialize
+    end
+
+
+  end
+end

data/src/com/zoho/crm/api/territories/response_wrapper.rb

@@ -0,0 +1,83 @@
+require_relative '../record/info'
+require_relative '../util/model'
+
+module Territories
+  require_relative 'response_handler'
+  class ResponseWrapper
+    include Util::Model
+    include ResponseHandler
+
+    # Creates an instance of ResponseWrapper
+    def initialize
+      @territories = nil
+      @info = nil
+      @key_modified = Hash.new
+    end
+
+      # The method to get the territories
+      # @return An instance of Array
+
+    def territories
+      @territories
+    end
+
+      # The method to set the value to territories
+      # @param territories [Array] An instance of Array
+
+    def territories=(territories)
+      if territories!=nil and !territories.is_a? Array
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: territories EXPECTED TYPE: Array', nil, nil)
+      end
+      @territories = territories
+      @key_modified['territories'] = 1
+    end
+
+      # The method to get the info
+      # @return An instance of Record::Info
+
+    def info
+      @info
+    end
+
+      # The method to set the value to info
+      # @param info [Record::Info] An instance of Record::Info
+
+    def info=(info)
+      if info!=nil and !info.is_a? Record::Info
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: info EXPECTED TYPE: Info', nil, nil)
+      end
+      @info = info
+      @key_modified['info'] = 1
+    end
+
+      # The method to check if the user has modified the given key
+      # @param key [String] A String
+      # @return A Integer value
+
+    def is_key_modified(key)
+      if key!=nil and !key.is_a? String
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: key EXPECTED TYPE: String', nil, nil)
+      end
+      if @key_modified.key?(key)
+        return @key_modified[key]
+      end
+
+      nil
+    end
+
+      # The method to mark the given key as modified
+      # @param key [String] A String
+      # @param modification [Integer] A Integer
+
+    def set_key_modified(key, modification)
+      if key!=nil and !key.is_a? String
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: key EXPECTED TYPE: String', nil, nil)
+      end
+      if modification!=nil and !modification.is_a? Integer
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: modification EXPECTED TYPE: Integer', nil, nil)
+      end
+      @key_modified[key] = modification
+    end
+
+  end
+end

data/src/com/zoho/crm/api/territories/territories_operations.rb

@@ -0,0 +1,47 @@
+require_relative '../exception/sdk_exception'
+require_relative '../util/api_response'
+require_relative '../util/common_api_handler'
+require_relative '../util/constants'
+
+module Territories
+  class TerritoriesOperations
+
+    # Creates an instance of TerritoriesOperations
+    def initialize
+    end
+
+      # The method to get territories
+      # @return An instance of APIResponse
+    # @raise SDKException
+    def get_territories
+      handler_instance = Handler::CommonAPIHandler.new
+      api_path = ''
+      api_path = api_path + '/crm/v2.1/settings/territories'
+      handler_instance.api_path = api_path
+      handler_instance.http_method = Constants::REQUEST_METHOD_GET
+      handler_instance.category_method = 'READ'
+      require_relative 'response_handler'
+      handler_instance.api_call(ResponseHandler.name, 'application/json')
+    end
+
+      # The method to get territory
+      # @param id [Integer] A Integer
+      # @return An instance of APIResponse
+    # @raise SDKException
+    def get_territory(id)
+      if !id.is_a? Integer
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: id EXPECTED TYPE: Integer', nil, nil)
+      end
+      handler_instance = Handler::CommonAPIHandler.new
+      api_path = ''
+      api_path = api_path + '/crm/v2.1/settings/territories/'
+      api_path = api_path + id.to_s
+      handler_instance.api_path = api_path
+      handler_instance.http_method = Constants::REQUEST_METHOD_GET
+      handler_instance.category_method = 'READ'
+      require_relative 'response_handler'
+      handler_instance.api_call(ResponseHandler.name, 'application/json')
+    end
+
+  end
+end

data/src/com/zoho/crm/api/territories/territory.rb

@@ -0,0 +1,272 @@
+require_relative '../custom_views/criteria'
+require_relative '../users/user'
+require_relative '../util/model'
+
+module Territories
+  class Territory
+    include Util::Model
+
+    # Creates an instance of Territory
+    def initialize
+      @created_time = nil
+      @modified_time = nil
+      @manager = nil
+      @account_rule_criteria = nil
+      @deal_rule_criteria = nil
+      @name = nil
+      @modified_by = nil
+      @description = nil
+      @id = nil
+      @created_by = nil
+      @reporting_to = nil
+      @permission_type = nil
+      @key_modified = Hash.new
+    end
+
+      # The method to get the created_time
+      # @return An instance of DateTime
+
+    def created_time
+      @created_time
+    end
+
+      # The method to set the value to created_time
+      # @param created_time [DateTime] An instance of DateTime
+
+    def created_time=(created_time)
+      if created_time!=nil and !created_time.is_a? DateTime
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: created_time EXPECTED TYPE: DateTime', nil, nil)
+      end
+      @created_time = created_time
+      @key_modified['created_time'] = 1
+    end
+
+      # The method to get the modified_time
+      # @return An instance of DateTime
+
+    def modified_time
+      @modified_time
+    end
+
+      # The method to set the value to modified_time
+      # @param modified_time [DateTime] An instance of DateTime
+
+    def modified_time=(modified_time)
+      if modified_time!=nil and !modified_time.is_a? DateTime
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: modified_time EXPECTED TYPE: DateTime', nil, nil)
+      end
+      @modified_time = modified_time
+      @key_modified['modified_time'] = 1
+    end
+
+      # The method to get the manager
+      # @return An instance of Users::User
+
+    def manager
+      @manager
+    end
+
+      # The method to set the value to manager
+      # @param manager [Users::User] An instance of Users::User
+
+    def manager=(manager)
+      if manager!=nil and !manager.is_a? Users::User
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: manager EXPECTED TYPE: User', nil, nil)
+      end
+      @manager = manager
+      @key_modified['manager'] = 1
+    end
+
+      # The method to get the account_rule_criteria
+      # @return An instance of CustomViews::Criteria
+
+    def account_rule_criteria
+      @account_rule_criteria
+    end
+
+      # The method to set the value to account_rule_criteria
+      # @param account_rule_criteria [CustomViews::Criteria] An instance of CustomViews::Criteria
+
+    def account_rule_criteria=(account_rule_criteria)
+      if account_rule_criteria!=nil and !account_rule_criteria.is_a? CustomViews::Criteria
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: account_rule_criteria EXPECTED TYPE: Criteria', nil, nil)
+      end
+      @account_rule_criteria = account_rule_criteria
+      @key_modified['account_rule_criteria'] = 1
+    end
+
+      # The method to get the deal_rule_criteria
+      # @return An instance of CustomViews::Criteria
+
+    def deal_rule_criteria
+      @deal_rule_criteria
+    end
+
+      # The method to set the value to deal_rule_criteria
+      # @param deal_rule_criteria [CustomViews::Criteria] An instance of CustomViews::Criteria
+
+    def deal_rule_criteria=(deal_rule_criteria)
+      if deal_rule_criteria!=nil and !deal_rule_criteria.is_a? CustomViews::Criteria
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: deal_rule_criteria EXPECTED TYPE: Criteria', nil, nil)
+      end
+      @deal_rule_criteria = deal_rule_criteria
+      @key_modified['deal_rule_criteria'] = 1
+    end
+
+      # The method to get the name
+      # @return A String value
+
+    def name
+      @name
+    end
+
+      # The method to set the value to name
+      # @param name [String] A String
+
+    def name=(name)
+      if name!=nil and !name.is_a? String
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: name EXPECTED TYPE: String', nil, nil)
+      end
+      @name = name
+      @key_modified['name'] = 1
+    end
+
+      # The method to get the modified_by
+      # @return An instance of Users::User
+
+    def modified_by
+      @modified_by
+    end
+
+      # The method to set the value to modified_by
+      # @param modified_by [Users::User] An instance of Users::User
+
+    def modified_by=(modified_by)
+      if modified_by!=nil and !modified_by.is_a? Users::User
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: modified_by EXPECTED TYPE: User', nil, nil)
+      end
+      @modified_by = modified_by
+      @key_modified['modified_by'] = 1
+    end
+
+      # The method to get the description
+      # @return A String value
+
+    def description
+      @description
+    end
+
+      # The method to set the value to description
+      # @param description [String] A String
+
+    def description=(description)
+      if description!=nil and !description.is_a? String
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: description EXPECTED TYPE: String', nil, nil)
+      end
+      @description = description
+      @key_modified['description'] = 1
+    end
+
+      # The method to get the id
+      # @return A Integer value
+
+    def id
+      @id
+    end
+
+      # The method to set the value to id
+      # @param id [Integer] A Integer
+
+    def id=(id)
+      if id!=nil and !id.is_a? Integer
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: id EXPECTED TYPE: Integer', nil, nil)
+      end
+      @id = id
+      @key_modified['id'] = 1
+    end
+
+      # The method to get the created_by
+      # @return An instance of Users::User
+
+    def created_by
+      @created_by
+    end
+
+      # The method to set the value to created_by
+      # @param created_by [Users::User] An instance of Users::User
+
+    def created_by=(created_by)
+      if created_by!=nil and !created_by.is_a? Users::User
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: created_by EXPECTED TYPE: User', nil, nil)
+      end
+      @created_by = created_by
+      @key_modified['created_by'] = 1
+    end
+
+      # The method to get the reporting_to
+      # @return An instance of Territory
+
+    def reporting_to
+      @reporting_to
+    end
+
+      # The method to set the value to reporting_to
+      # @param reporting_to [Territory] An instance of Territory
+
+    def reporting_to=(reporting_to)
+      if reporting_to!=nil and !reporting_to.is_a? Territory
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: reporting_to EXPECTED TYPE: Territory', nil, nil)
+      end
+      @reporting_to = reporting_to
+      @key_modified['reporting_to'] = 1
+    end
+
+      # The method to get the permission_type
+      # @return A String value
+
+    def permission_type
+      @permission_type
+    end
+
+      # The method to set the value to permission_type
+      # @param permission_type [String] A String
+
+    def permission_type=(permission_type)
+      if permission_type!=nil and !permission_type.is_a? String
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: permission_type EXPECTED TYPE: String', nil, nil)
+      end
+      @permission_type = permission_type
+      @key_modified['permission_type'] = 1
+    end
+
+      # The method to check if the user has modified the given key
+      # @param key [String] A String
+      # @return A Integer value
+
+    def is_key_modified(key)
+      if key!=nil and !key.is_a? String
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: key EXPECTED TYPE: String', nil, nil)
+      end
+      if @key_modified.key?(key)
+        return @key_modified[key]
+      end
+
+      nil
+    end
+
+      # The method to mark the given key as modified
+      # @param key [String] A String
+      # @param modification [Integer] A Integer
+
+    def set_key_modified(key, modification)
+      if key!=nil and !key.is_a? String
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: key EXPECTED TYPE: String', nil, nil)
+      end
+      if modification!=nil and !modification.is_a? Integer
+        raise SDKException.new(Constants::DATA_TYPE_ERROR, 'KEY: modification EXPECTED TYPE: Integer', nil, nil)
+      end
+      @key_modified[key] = modification
+    end
+
+  end
+end

data/src/com/zoho/crm/api/user_signature.rb

@@ -0,0 +1,27 @@
+require_relative '../../api/logger/sdk_logger'
+# This class represents the CRM user email.
+class UserSignature
+  attr_reader :email
+
+  # Creates an UserSignature class instance with the specified user email.
+  # @param email [String] A String containing the CRM user email
+  # @raise SDKException
+  def initialize(email)
+    require_relative 'util/constants'
+
+    error = {}
+
+    if (email.match Constants::EMAIL_REGEX).nil?
+      error[Constants::ERROR_HASH_FIELD] = Constants::EMAIL
+
+      error[Constants::ERROR_HASH_EXPECTED_TYPE] = Constants::EMAIL
+
+      ex = SDKException.new(Constants::USER_SIGNATURE_ERROR, nil, error, nil)
+
+      raise ex
+
+    end
+
+    @email = email
+  end
+end

data/src/com/zoho/crm/api/users/action_handler.rb

@@ -0,0 +1,10 @@
+module Users
+  module ActionHandler
+
+    # Creates an instance of ActionHandler
+    def initialize
+    end
+
+
+  end
+end