developergarden_sdk 0.0.8.1 → 0.9.0

data/README

@@ -1,72 +1,22 @@
 == developergarden_sdk
 This library provides access to open development services of the Deutsche Telekom AG.
 For more details about the services see
+
  http://www.developergarden.com
 
 Depending on your operating system you might want to skip the "sudo" command prior to the
 commands listed here.
 
-=== Dependencies
-In order to use this library the following dependencies need to be met: 
-  Ruby 1.8.6
-  Ruby Gems >= 1.3.1
-
-There might be issues with Ruby 1.8.7 regarding to curb so it is highly recommended to use Ruby 1.8.6.
-
-==== Gems
-The following gems need to be installed:
-* handsoap (Version 0.2.8)
-* nokogiri
-* httpclient (Version 2.1.14)
-* htmlentities
-
-=== Install the handsoap gem
-For production use the official release of handsoap should be installed.
-More information about handsoap can be found at:
- http://github.com/troelskn/handsoap/tree/master
- 
-==== Install official handsoap release
- gem sources -a http://gems.github.com
- sudo gem install troelskn-handsoap 
-
-==== Install handsoap developer version
-If you want to use the bleeding edge version of handsoap proceed as follows.
-Note that you do not need to perform these steps if you have already installed the official release!
-
-Checkout handsoap from github
- git clone git://github.com/troelskn/handsoap.git
-
-Install jeweler
- sudo gem install jeweler
-
-Build handsoap package
- cd handsoap_git_repo
- rake build
-
-Install the resulting gem file
- cd pkg
- sudo gem install handsoap-0.2.7.gem
-
-Attention: if you you use the development version you might need to change the gem statement in
-   basic_service.rb from
-
-   gem 'troelskn-handsoap'
 
-   to
+=== Installation
+ sudo gem install developergarden_sdk
 
-   gem 'handsoap'
-
-=== Installation of the developergarden_sdk Gem
-Install the gem using the following command
- gem install developergarden_sdk-0.0.x.gem
-
-Where x stands for the current version. For the version 0.0.4 this could look like this:
- gem install developergarden_sdk-0.0.x.gem
+Dependent gems will be installed automatically.
 
 === Basic usage
 You can use the gem from pure Ruby applications and of course from Ruby on Rails apps as well.
 
-==== To use the gem from your Ruby app:
+==== To use the gem from your Ruby app
 
  require 'rubygems'
  gem 'developergarden_sdk'
@@ -87,7 +37,48 @@ You can use the gem from pure Ruby applications and of course from Ruby on Rails
 
  sms = SmsService::SmsService.new("<USER>@t-online.de", "<PASSWORD>")
  sms_response = sms.send_sms("+49177 0000001", "Your message text.", "RubySDK", ServiceEnvironment.PRODUCTION, "")
- 
+
+
+=== Ruby Example to perform an ip location request
+
+ require 'rubygems'
+ gem 'developergarden_sdk'
+ require 'token_Service/token_service'
+ require 'ip_location_service/ip_location_service'
+
+ @ip_location_service = IpLocationService::IpLocationService.new("<USER>@t-online.de", "<PASSWORD>")
+
+ ip = IpLocationService::IpAddress.new("93.222.255.58")
+ response = @ip_location_service.locate_ip(ip, ServiceEnvironment.PRODUCTION)
+
+ puts response.ip_address_locations.first.address
+ puts response.ip_address_locations.first.is_in_region.country_code
+ puts response.ip_address_locations.first.is_in_region.region_name
+
+ # If you except a single ip location (if you have passed a single ip to look up)
+ # then you can use the following way to access the location
+ puts response.ip_address_location.address
+ puts response.ip_address_location.is_in_region.country_code
+ puts response.ip_address_location.is_in_region.region_name
+
+=== Ruby Example to perform a local search
+ require 'rubygems'
+ gem 'developergarden_sdk'
+ require 'token_Service/token_service'
+
+ @service = LocalSearchService::LocalSearchService.new("<USER>@t-online.de", "<PASSWORD>")
+
+ search_parameter = {
+   :what => "music",
+   :near => "Konstanz"
+ }
+ response = @service.local_search(search_parameter, ServiceEnvironment.MOCK)
+
+ # Show response xml
+ puts response.search_result.to_xml
+ results_where_locs_where = response.search_result.xpath("//RESULTS/WHERE_LOCS/WHERE").first
+ lat = results_where_locs_where["LAT"]
+ puts lat
 
 ==== To use your gem from your Ruby on Rails app
 In your environment.rb add the following line in the config block:
@@ -117,53 +108,6 @@ In your environment.rb add the following line in the config block:
 In order to see more examples have a look the unit tests included in the gem's source code.
 You might also want to have a look at the actual source code and source code comments.
 
-=== Debug
-Per default all generated and received soap xml messages are not visible. These can be print to stdout for debugging
-purposes by starting the ruby interpreter with the -d option. You will then see all http xml soap requests and responses.
-This can be done by invoking your ruby app by using a shebang like this:
- #!/usr/bin/ruby -d
-
-=== Testing
-Before you run the tests you will need to modify config/test_settings.yml by entering your developer garden credentials.
-
-Executing tests will be done in the "sandbox" or "mock" environment which are free of charge.
-Be ware that the services itself have quotas on these test environments so your tests may fail after a while.
-The quotas are on a daily basis so they should pass again the next day.
-
-Failures when reaching the SANDBOX QUOTA might look like this:
- 0030 quotas have exceeded
-
-Phone numbers in test files are fictive and for testing purposes only.
-
-The testsuite can be run by invoking the test raketask.
- cd /home/yourhome/developergarden_sdk
- rake test
-
-In order to run a single test perform the following command:
- cd /home/yourhome/developergarden_sdk/lib
- ruby -d ../test/voice_call_service_test.rb --name teardown_call
-
-==== QuotaService
-* QuotaService can be tested as it is. There is no need to pass an environment such as "production" or "sandbox" because
-it is free of charge.
-
-==== SmsService
-* SmsService can be tested using the "sandbox" environment. Be aware that there is a 5 credit quota per day. So you can
-send 5 test sms per day. After that you will receive a corresponding quota error message.
-
-==== VoiceCallService
-* In the "sandbox" environment there is a quota limit of 5 calls per day (each up to 10 sec) for the VoiceCallService
-* In the "production" environment a call may not last more than 60 minutes. After 60 min the call will be cancelled.
-* There is also a quota for the "mock" environment.
-
-For more information about service environments have a look at the documentation at http://www.developergarden.com
-
-=== Build the developergarden_sdk gem
-You can build the gem by invoking the gem rake task
- rake gem
-The resulting gem will be generated to the pkg/ directory and can be installed like this:
- sudo gem install developergarden_sdk-0.0.6.gem
-Depending on the current version number you will need to adapt the gem filename correspondingly.
 
 ==More Information
 More information about developer garden services can be found at:

data/Rakefile

@@ -13,7 +13,7 @@ require 'fileutils'
 
 spec = Gem::Specification.new do |s|
   s.name = 'developergarden_sdk'
-  s.version = '0.0.8.1'
+  s.version = '0.9.0'
   s.homepage = 'http://www.developergarden.com'
   s.has_rdoc = true
   s.extra_rdoc_files = ['README', 'LICENSE']
@@ -25,8 +25,8 @@ spec = Gem::Specification.new do |s|
 
   # GEM dependencies
   s.add_dependency 'httpclient', '= 2.1.5.2'
-  s.add_dependency 'nokogiri', '>= 1.3.1'
-  s.add_dependency 'troelskn-handsoap', '= 0.2.8'
+  s.add_dependency 'nokogiri', '>= 1.4.0'
+  s.add_dependency 'handsoap', '= 1.1.4'
   s.add_dependency 'htmlentities', '>= 4.0.0'
 
   s.files = %w(LICENSE README Rakefile) + Dir.glob("{bin,lib,spec}/**/*")
@@ -57,6 +57,8 @@ end
 
 desc "update_plugin"
 task :update_plugin do
+  sh %{ rm -R plugin/developergarden_sdk/lib/* }
+  sh %{ rm -R plugin/developergarden_sdk/test/* }
   sh %{ cp -R lib/* plugin/developergarden_sdk/lib/ }
   sh %{ cp -R test/* plugin/developergarden_sdk/test/ }
 end

data/lib/authenticated_service.rb

@@ -4,7 +4,11 @@ require File.dirname(__FILE__) + '/token_service/token_service'
 # Base service for all services demanding a security token.
 class AuthenticatedService < BasicService
 
-  def initialize(username, password)
+  # Constructor
+  # ===Parameters
+  # <tt>username</tt>:: Username, such as myuser@t-online.de
+  # <tt>password</tt>:: Password
+  def initialize(username, password, environment = ServiceEnvironment.SANDBOX)
     super(username, password)
 
     @token_service = TokenService::TokenService.new(@username, @password)

data/lib/basic_response.rb

@@ -14,10 +14,8 @@ class BasicResponse
   # <tt>raise_exception_on_error</tt>:: Xml as returned by a <tt>status</tt>-method call.  
   def initialize(response_xml, raise_exception_on_error = true)
     doc = response_xml.document
-
-    @error_code      = doc.xpath("//errorCode").text
-    @error_message   = doc.xpath("//errorMessage").text
-
+    @error_code      = doc.xpath("//errorCode").to_s || doc.xpath("//statusCode").to_s
+    @error_message   = doc.xpath("//errorMessage").to_s || doc.xpath("//statusMessage").to_s
     raise_on_error(response_xml) if raise_exception_on_error
   end
 

data/lib/basic_service.rb

@@ -1,5 +1,5 @@
 require 'rubygems'
-gem 'troelskn-handsoap'
+gem 'handsoap'
 
 require 'handsoap'
 require File.dirname(__FILE__) + '/common/xml_tools'
@@ -7,14 +7,19 @@ require File.dirname(__FILE__) + '/service_environment'
 
 # Implements basic logic used by developer garden ruby service implementations.
 class BasicService < Handsoap::Service
-  
+
   @@SERVICE_ID = "https://odg.t-online.de"
 
   # Create some namespaces
-  on_create_document do |doc|
+  def on_create_document(doc)
     doc.alias 'ns1', "http://sts.idm.telekom.com/schema/"
     doc.alias 'xmlns:ns2', "Security"
-  end                     
+  end
+
+  # Create the namespace for a later use in parse_token_data
+  def on_response_document(doc)
+    doc.add_namespace 'schema', 'http://sts.idm.telekom.com/schema/'
+  end
 
   # Constructor
   # ===Parameters
@@ -39,9 +44,9 @@ class BasicService < Handsoap::Service
   # <tt>doc</tt>:: Request XmlMason document.
   # <tt>security_token</tt>:: Security tokens as plain text gathered using the TokenService.
   def build_service_header(doc, security_token)
-    header = build_security_header_common(doc)
-    security = header.find("Security")
-    security.set_value( security_token, :raw)
+    header = build_security_header_common(doc) do |security|
+      security.set_value( security_token, :raw)
+    end
     return header
   end
 
@@ -51,21 +56,22 @@ class BasicService < Handsoap::Service
   # The header of the given document will be enhanced so there is no need to
   # process the returning value.
   # ===Parameters
-  # <tt>doc</tt>:: Request XmlMason document.  
-  def build_security_header_common(doc)
-    
+  # <tt>doc</tt>:: Request XmlMason document.
+  def build_security_header_common(doc, &block)
+
     # Get the header element
     header = doc.find('Header')
 
     # Add plain security element
-    header.add('Security')
+    header.add('Security') do |security|
+
+      # Set namespace
+      security.set_attr("xmlns", "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd")
+      security.set_attr("env:mustUnderstand", "1")
 
-    # Find security element for further enhancement
-    security = header.find('Security')
+      security = yield(security)
+    end
 
-    # Set namespace
-    security.set_attr("xmlns", "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd")
-    security.set_attr("env:mustUnderstand", "1")
     return header
   end
 
@@ -75,14 +81,33 @@ class BasicService < Handsoap::Service
   # <tt>response</tt>:: Response as returned from a <tt>getTokens</tt> call, for example.
   #
   # ==Return
-  # Returns the security token as plain text to be inserted into a security header build with <tt>build_security_header_common</tt>. 
-  def get_token_data_from_response(response)
-
-    # nokogiri document. Unfortunately it is unable to parse the returning xml completely.
-    # Especially the body is not parsed completely.
+  # Returns the security token as plain text to be inserted into a security header build with <tt>build_security_header_common</tt>.
+  def parse_token_data(response)
     doc = response.document
-    intermediate_token = doc.xpath("//schema:tokenData", "schema" => 'http://sts.idm.telekom.com/schema/').inner_text
+
+    # Get the XmlQueryFront object which is a subclass of an array.
+    intermediate_token = doc.xpath("//schema:tokenData", "schema" => 'http://sts.idm.telekom.com/schema/').to_s
+
+    # The first element is a NokogiriDriver-Object which mixes in the XmlElement module.
+    # In order to preserve the CDATA ...
+    #= xml_element
+    #puts intermediate_token
 
     return intermediate_token
   end
+
+  # Performs a xpath query in the given namespace for the given document and query string.
+  # === Parameters
+  # <tt>schema</tt>:: Schema to be searched in such as <tt>'http://iplocation.developer.telekom.com/schema/'</tt>
+  # <tt>doc</tt>:: XmlQueryFront document.
+  # <tt>query_string</tt>:: Element to look for
+  # <tt>global_search</tt>:: Searches within all levels using "//" if <tt>global_search = true</tt>.
+  def self.xpath_query_for_schema(schema, doc, query_string, global_search = true)
+    xpath_query = ""
+    xpath_query = "//" if global_search
+    xpath_query += "schema:#{query_string}"
+
+    # Only search if there's at least one element
+    doc.xpath(xpath_query, "schema" => schema)
+  end
 end

data/lib/conference_call_service/add_conference_template_participant_response.rb

@@ -0,0 +1,19 @@
+require File.dirname(__FILE__) + '/../basic_response'
+
+module ConferenceCallService
+  class AddConferenceTemplateParticipantResponse < BasicResponse
+    attr_accessor :participant_id
+    
+    # Constructor
+    # ===Parameters
+    # <tt>response_xml</tt>:: Xml as returned by the corresponding method call.
+    # <tt>raise_exception_on_error</tt>:: Raise an exception if an error occurs or not?
+    def initialize(response_xml, raise_exception_on_error = true)
+      doc = response_xml.document
+      @error_code =     ConferenceCallService.xpath_query(doc, "statusCode").to_s
+      @error_message =  ConferenceCallService.xpath_query(doc, "statusMessage").to_s
+      @participant_id =  ConferenceCallService.xpath_query(doc, "participantId").to_s
+      raise_on_error(response_xml) if raise_exception_on_error
+    end
+  end
+end

data/lib/conference_call_service/commit_conference_response.rb

@@ -0,0 +1,17 @@
+require File.dirname(__FILE__) + '/../basic_response'
+
+module ConferenceCallService
+  class CommitConferenceResponse < BasicResponse
+
+    # Constructor.
+    # ===Parameters
+    # <tt>response_xml</tt>:: Xml as returned by the corresponding method call.
+    # <tt>raise_exception_on_error</tt>:: Raise an exception if an error occurs or not?
+    def initialize(response_xml, raise_exception_on_error = true)
+      doc = response_xml.document
+      @error_code = ConferenceCallService.xpath_query(doc, "statusCode").to_s
+      @error_message = ConferenceCallService.xpath_query(doc, "statusMessage").to_s
+      raise_on_error(response_xml) if raise_exception_on_error
+    end
+  end
+end

data/lib/conference_call_service/conference_call_service.rb

@@ -0,0 +1,481 @@
+require File.dirname(__FILE__) + '/../authenticated_service'
+require File.dirname(__FILE__) + '/conference_constants'
+require File.dirname(__FILE__) + '/conference_details'
+require File.dirname(__FILE__) + '/conference_schedule'
+require File.dirname(__FILE__) + '/get_conference_list_response'
+require File.dirname(__FILE__) + '/create_conference_response'
+require File.dirname(__FILE__) + '/commit_conference_response'
+require File.dirname(__FILE__) + '/get_conference_status_response'
+require File.dirname(__FILE__) + '/new_participant_response'
+require File.dirname(__FILE__) + '/participant_details'
+require File.dirname(__FILE__) + '/remove_participant_response'
+require File.dirname(__FILE__) + '/remove_conference_response'
+require File.dirname(__FILE__) + '/get_running_conference_response'
+require File.dirname(__FILE__) + '/participant'
+require File.dirname(__FILE__) + '/get_conference_template_list_response'
+require File.dirname(__FILE__) + '/create_conference_template_response'
+require File.dirname(__FILE__) + '/update_participant_response'
+require File.dirname(__FILE__) + '/update_conference_response'
+require File.dirname(__FILE__) + '/get_conference_template_response'
+require File.dirname(__FILE__) + '/remove_conference_template_response'
+require File.dirname(__FILE__) + '/get_conference_template_participant_response'
+require File.dirname(__FILE__) + '/remove_conference_template_participant_response'
+require File.dirname(__FILE__) + '/add_conference_template_participant_response'
+require File.dirname(__FILE__) + '/update_conference_template_participant_response'
+require File.dirname(__FILE__) + '/update_conference_template_response'
+require File.dirname(__FILE__) + '/get_participant_status_response'
+
+
+Handsoap.http_driver = :httpclient
+
+# Print http and soap requests and reponses if ruby has been started with -d option.
+Handsoap::Service.logger = $stdout if $DEBUG
+
+
+module ConferenceCallService
+
+  # Client to access the developer garden conference call service.
+  #
+  # See also:
+  # * https://www.developergarden.com/openapi/conferencecall
+  # * http://www.developergarden.com/static/docu/de/ch04s02s02.html 
+  class ConferenceCallService < AuthenticatedService
+    @@CONFERENCE_CALL_SCHEMA = 'http://ccs.developer.telekom.com/schema/'
+
+    @@CONFERENCE_CALL_SCHEMA_SERVICE_ENDPOINT = {
+            :uri => "https://gateway.developer.telekom.com/p3gw-mod-odg-ccs/services/ccsPort",
+            :version => 1
+    }
+
+    endpoint @@CONFERENCE_CALL_SCHEMA_SERVICE_ENDPOINT
+
+    # Add namespaces to the handsoap XmlMason document.
+    def on_create_document(doc)
+      super(doc)
+      doc.alias 'cc', @@CONFERENCE_CALL_SCHEMA
+    end
+
+    # Stores the created conference to the conference call server.
+    # ===Parameters
+    # <tt>conference_id</tt>:: id of the interest conference
+    # <tt>environment</tt>:: Service environment as defined in ServiceEnvironment.
+    def commit_conference(conference_id, environment = ServiceEnvironment.MOCK)
+      response_xml = invoke_authenticated("cc:commitConference") do |request, doc|
+        request.add('commitConferenceRequest') do |commit_request, doc|
+          commit_request.add('conferenceId', conference_id)
+          commit_request.add('environment', environment)
+        end
+      end
+
+      response = CommitConferenceResponse.new(response_xml)
+    end
+
+    # Creates a new conference.
+    # ===Parameters
+    # <tt>owner_id</tt>:: Return only items owned by the given user such as "max.mustermann".
+    # <tt>detail</tt>:: Specifies the conference details like max duration, name and description.
+    # <tt>schedule</tt>:: Specifies when the conference will take place and if its going to be repeated on a regular basis.    
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.        
+    def create_conference(owner_id, detail, schedule = nil, environment = ServiceEnvironment.MOCK, account = nil)
+      response_xml = invoke_authenticated("cc:createConference") do |request, doc|
+        request.add('createConferenceRequest') do |create_request|
+          create_request.add('environment', environment)
+          create_request.add('ownerId', owner_id.to_s)
+          create_request.add('detail') do |detail_request|
+            detail.add_to_handsoap_xml(detail_request)
+          end
+
+          # schedule
+          if schedule then
+            create_request.add('schedule') do |schedule_request|
+              schedule.add_to_handsoap_xml(schedule_request)
+            end
+          end
+
+          create_request.add('account', account) if (account && !account.empty?)
+        end
+      end
+
+      response = CreateConferenceResponse.new(response_xml)
+    end
+
+
+    # Retrieves spatial information about the given ip address.
+    # ===Parameters
+    # <tt>owner_id</tt>:: Return only items owned by the given user such as "max.mustermann".
+    # <tt>what</tt>:: Constraints of the list to be retrieved.
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.
+    # <tt>account</tt>:: IP address for which to perform an ip location.
+    def get_conference_list(owner_id, what = ConferenceConstants.CONFERENCE_LIST_ALL, environment = ServiceEnvironment.MOCK, account = nil)
+
+      response_xml = invoke_authenticated("cc:getConferenceList") do |request, doc|
+        request.add('getConferenceListRequest') do |list_request|
+          list_request.add('environment', environment)
+          list_request.add('what', what.to_s)
+          list_request.add('ownerId', owner_id.to_s)
+          list_request.add('account', account) if (account && !account.empty?)
+        end
+      end
+
+      response = GetConferenceListResponse.new(response_xml)
+      return response
+    end
+
+    # Retrieves that status of the given conference.
+    # ===Parameters
+    # <tt>conference_id</tt>:: 
+    # <tt>what</tt>:: Contraints of the list to be retrieved.
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.        
+    def get_conference_status(conference_id, what = ConferenceConstants.CONFERENCE_LIST_ALL, environment = ServiceEnvironment.MOCK, account = nil)
+      response_xml = invoke_authenticated("cc:getConferenceStatus") do |request, doc|
+        request.add('getConferenceStatusRequest') do |status_request|
+          status_request.add('environment', environment)
+          status_request.add('what', what.to_s)
+          status_request.add('conferenceId', conference_id.to_s)
+          status_request.add('account', account) if (account && !account.empty?)
+        end
+      end
+
+      response = GetConferenceStatusResponse.new(response_xml)
+      return response
+    end
+
+    # Retrieves the status of the given participant in the specified conference.
+    # ===Parameters
+    # <tt>conference_id</tt>:: Id of the intended conference.
+    # <tt>participant_id</tt>:: Id of the desired participant.
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.
+    def get_participant_status(conference_id, participant_id, environment = ServiceEnvironment.MOCK, account = nil)
+      response_xml = invoke_authenticated("cc:getParticipantStatus") do |request, doc|
+        request.add('getParticipantStatusRequest') do |new_participant_request|
+          new_participant_request.add('environment', environment)
+          new_participant_request.add('account', account) if (account && !account.empty?)
+          new_participant_request.add('conferenceId', conference_id.to_s)
+          new_participant_request.add('participantId', participant_id)
+        end
+      end
+
+      response = GetParticipantStatusResponse.new(response_xml)        
+    end
+
+    # Adds the given participant to the specified conference.
+    # ===Parameters                                                                                                ra
+    # <tt>conference_id</tt>:: Id of the intended conference.
+    # <tt>participant</tt>:: Details of the participant to be added. 
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.
+    def new_participant(conference_id, participant, environment = ServiceEnvironment.MOCK, account = nil)
+      response_xml = invoke_authenticated("cc:newParticipant") do |request, doc|
+        request.add('newParticipantRequest') do |new_participant_request|
+          new_participant_request.add('environment', environment)
+          new_participant_request.add('account', account) if (account && !account.empty?)
+          new_participant_request.add('conferenceId', conference_id.to_s)
+          new_participant_request.add('participant') do |participant_request|
+            participant.add_to_handsoap_xml(participant_request)
+          end
+        end
+      end
+
+      response = NewParticipantResponse.new(response_xml)
+    end
+
+    # Updates the settings for the given participant of the given conference call.
+    # ===Parameters
+    # <tt>conference_id</tt>:: id of the interest conference
+    # <tt>participant_id</tt>:: id of the coming participant
+    # <tt>participant_detail</tt>:: Details of the coming participant
+    # <tt>action</tt>:: Action to performed for the given participant. Actions are mute, umute and redial.
+    #                   See ConferenceConstants for the corresponding constants.
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.
+    def update_participant(conference_id, participant_id, participant_detail = nil, action = nil, environment = ServiceEnvironment.MOCK, account = nil)
+      response_xml = invoke_authenticated("cc:updateParticipant") do |request, doc|
+        request.add('updateParticipantRequest') do |update_participant_request|
+          update_participant_request.add('environment', environment)
+          update_participant_request.add('account', account) if (account && !account.empty?)
+          update_participant_request.add('conferenceId', conference_id.to_s)
+          update_participant_request.add('participantId', participant_id.to_s)
+          update_participant_request.add('action', action.to_s) if action
+
+          if participant_detail then
+            update_participant_request.add('participant') do |participant_request|
+              participant_detail.add_to_handsoap_xml(participant_request)
+            end
+          end
+        end
+      end
+
+      response = UpdateParticipantResponse.new(response_xml)
+    end
+
+    # Removes the given conference.
+    # ===Parameters
+    # <tt>conference_id</tt>:: id of the removed conference
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.
+    def remove_conference(conference_id, environment = ServiceEnvironment.MOCK, account = nil)
+      response_xml = invoke_authenticated("cc:removeConference") do |request, doc|
+        request.add('removeConferenceRequest') do |remove_conference_request|
+          remove_conference_request.add('environment', environment)
+          remove_conference_request.add('conferenceId', conference_id.to_s)
+          remove_conference_request.add('account', account) if (account && !account.empty?)
+        end
+      end
+
+      response = RemoveConferenceResponse.new(response_xml)
+    end
+
+    # Retrieves that status of the given conference.
+    # ===Parameters
+    # <tt>conference_id</tt>::
+    # <tt>what</tt>:: Contraints of the list to be retrieved.
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.    
+    def remove_participant(conference_id, participant_id, environment = ServiceEnvironment.MOCK, account = nil)
+      response_xml = invoke_authenticated("cc:removeParticipant") do |request, doc|
+        request.add('removeParticipantRequest') do |remove_request|
+          remove_request.add('environment', environment)
+          remove_request.add('account', account) if (account && !account.empty?)
+          remove_request.add('conferenceId', conference_id.to_s)
+          remove_request.add('participantId', participant_id.to_s)
+        end
+      end
+
+      response = RemoveParticipantResponse.new(response_xml)
+    end
+
+    # Updates an existing conference.
+    # ===Parameters
+    # <tt>conference_id</tt>:: Id of the conference
+    # <tt>conference_details</tt>:: Id of the conference
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.
+    def update_conference(conference_id, conference_details = nil, schedule = nil, initiator_id = nil, environment = ServiceEnvironment.MOCK, account = nil)
+      response_xml = invoke_authenticated("cc:updateConference") do |request, doc|
+        request.add('updateConferenceRequest') do |remove_request|
+          remove_request.add('environment', environment)
+          remove_request.add('account', account) if (account && !account.empty?)
+          remove_request.add('conferenceId', conference_id.to_s)
+          remove_request.add('initiatorId', initiator_id.to_s)
+
+          if conference_details then
+            remove_request.add('detail') do |detail_request|
+              conference_details.add_to_handsoap_xml(detail_request)
+            end
+          end
+
+          if schedule then
+            remove_request.add('schedule') do |schedule_request|
+              schedule.add_to_handsoap_xml(schedule_request)
+            end
+          end
+        end
+      end
+
+      response = UpdateConferenceResponse.new(response_xml)
+    end
+
+    # Tell whether a conference is running
+    # ===Parameters
+    # <tt>conference_id</tt>:: id of the maybe running conference
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.
+    def get_running_conference(conference_id, environment = ServiceEnvironment.MOCK,  account = nil)
+      response_xml = invoke_authenticated("cc:getRunningConference") do |request, doc|
+        request.add('getRunningConferenceRequest') do |get_running_conference_request|
+          get_running_conference_request.add('environment', environment)
+          get_running_conference_request.add('conferenceId', conference_id.to_s)
+          get_running_conference_request.add('account', account) if (account && !account.empty?)
+        end
+      end
+
+      response = GetRunningConferenceResponse.new(response_xml)
+    end
+
+    # Creates a conference template.
+    # ===Parameters
+    # <tt>owner_id</tt>:: id of the owner of the conference template
+    # <tt>detail</tt>: details of the conference template. ConferenceDetails Type
+    # <tt>participants</tt>: optional parameter of the type ParticipantDetail
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.
+    def create_conference_template(owner_id, detail, participants = nil, environment = ServiceEnvironment.MOCK,  account = nil)
+      response_xml = invoke_authenticated("cc:createConferenceTemplate") do |request, doc|
+        request.add('createConferenceTemplateRequest') do |create_conference_template_request|
+          create_conference_template_request.add('environment', environment)
+          create_conference_template_request.add('account', account) if (account && !account.empty?)
+          create_conference_template_request.add('ownerId', owner_id.to_s)
+          create_conference_template_request.add('detail') do |detail_request|
+            detail.add_to_handsoap_xml(detail_request)
+          end
+
+          if participants then
+            participants.each do |participant|
+              create_conference_template_request.add('participants') do |participant_request|
+                participant.add_to_handsoap_xml(participant_request)
+              end
+            end
+          end
+        end
+      end
+
+      response = CreateConferenceTemplateResponse.new(response_xml)
+    end
+
+    # Returns the confernece template with the given id.    
+    # ===Parameters
+    # <tt>template_id</tt>::
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.
+    def get_conference_template(template_id, environment = ServiceEnvironment.MOCK,  account = nil)
+      response_xml = invoke_authenticated("cc:getConferenceTemplate") do |request, doc|
+        request.add('getConferenceTemplateRequest') do |get_conference_template_request|
+          get_conference_template_request.add('environment', environment)
+          get_conference_template_request.add('templateId', template_id.to_s)
+          get_conference_template_request.add('account', account) if (account && !account.empty?)
+        end
+      end
+      
+      response = GetConferenceTemplateResponse.new(response_xml)
+    end
+
+    # Updates the specified conference with the given parameters.
+    # ===Parameters
+    # <tt>template_id</tt>:: id of the updated template
+    # <tt>initiator_id</tt>:: id of the initiator of the conference
+    # <tt>details</tt>:: details of the conference template
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.
+    def update_conference_template(template_id, initiator_id, detail, environment = ServiceEnvironment.MOCK,  account = nil)
+      response_xml = invoke_authenticated("cc:updateConferenceTemplate") do |request, doc|
+        request.add('updateConferenceTemplateRequest') do |update_conference_template_request|
+          update_conference_template_request.add('environment', environment)
+          update_conference_template_request.add('templateId', template_id.to_s)
+          update_conference_template_request.add('initiatorId', initiator_id.to_s)
+          update_conference_template_request.add('detail') do |detail_request|
+            detail.add_to_handsoap_xml(detail_request)
+          end
+          update_conference_template_request.add('account', account) if (account && !account.empty?)
+        end
+      end
+
+      response = UpdateConferenceTemplateResponse.new(response_xml)
+    end
+
+    # ===Parameters
+    # <tt>template_id</tt>:: template of the removed conference
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.
+    def remove_conference_template(template_id, environment = ServiceEnvironment.MOCK,  account = nil)
+      response_xml = invoke_authenticated("cc:removeConferenceTemplate") do |request, doc|
+        request.add('getConferenceTemplateRequest') do |remove_conference_template_request|
+          remove_conference_template_request.add('environment', environment)
+          remove_conference_template_request.add('templateId', template_id.to_s)
+          remove_conference_template_request.add('account', account) if (account && !account.empty?)
+        end
+      end
+      
+      response = RemoveConferenceTemplateResponse.new(response_xml)
+    end
+
+    # Give the list of the templates of the given conference owner
+    # ===Parameters
+    # <tt>owner_id</tt>:: id of the owner of the requested conference
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.
+    def get_conference_template_list(owner_id, environment = ServiceEnvironment.MOCK,  account = nil)
+      response_xml = invoke_authenticated("cc:getConferenceTemplateList") do |request, doc|
+        request.add('getConferenceTemplateListRequest') do |get_conference_template_list_request|
+          get_conference_template_list_request.add('environment', environment)
+          get_conference_template_list_request.add('ownerId', owner_id.to_s)
+          get_conference_template_list_request.add('account', account) if (account && !account.empty?)
+        end
+      end
+
+      response = GetConferenceTemplateListResponse.new(response_xml)
+    end
+
+    # Give the list of the templates of the given conference owner
+    # ===Parameters
+    # <tt>template_id</tt>:: id of the template in which we call the participant
+    # <tt>participant_id</tt>:: id of the called participant
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.
+    def get_conference_template_participant(template_id, participant_id, environment = ServiceEnvironment.MOCK, account = nil)
+       response_xml = invoke_authenticated("cc:getConferenceTemplateParticipant") do |request, doc|
+        request.add('getConferenceTemplateParticipantRequest') do |get_conference_template_participant_request|
+          get_conference_template_participant_request.add('environment', environment)
+          get_conference_template_participant_request.add('templateId', template_id.to_s)
+          get_conference_template_participant_request.add('participantId', participant_id.to_s)
+          get_conference_template_participant_request.add('account', account) if (account && !account.empty?)
+        end
+      end
+
+      response = GetConferenceTemplateParticipantResponse.new(response_xml)
+    end
+
+    # Update the details of a given participant
+    # ===Parameters
+    # <tt>template_id</tt>:: id of the template in which we call the participant
+    # <tt>participant_id</tt>:: id of the changed participant
+    # <tt>participant</tt>:: details of the changed participant
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.
+    def update_conference_template_participant(template_id, participant_id, participant, environment = ServiceEnvironment.MOCK, account = nil)
+      response_xml = invoke_authenticated("cc:updateConferenceTemplateParticipant") do |request, doc|
+        request.add('updateConferenceTemplateParticipantRequest') do |update_conference_template_participant_request|
+          update_conference_template_participant_request.add('environment', environment)
+          update_conference_template_participant_request.add('templateId', template_id.to_s)
+          update_conference_template_participant_request.add('participantId', participant_id.to_s)
+          update_conference_template_participant_request.add('participant') do |participant_request|
+            participant.add_to_handsoap_xml(participant_request)
+          end
+          update_conference_template_participant_request.add('account', account) if (account && !account.empty?)
+        end
+      end
+
+      response = UpdateConferenceTemplateParticipantResponse.new(response_xml)
+    end
+
+    # Give the list of the templates of the given conference owner
+    # ===Parameters
+    # <tt>template_id</tt>:: id of the template in which we call the participant
+    # <tt>participant_id</tt>:: id of the called participant
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.
+    def remove_conference_template_participant(template_id, participant_id, environment = ServiceEnvironment.MOCK, account = nil)
+       response_xml = invoke_authenticated("cc:removeConferenceTemplateParticipant") do |request, doc|
+        request.add('removeConferenceTemplateParticipantRequest') do |remove_conference_template_participant_request|
+          remove_conference_template_participant_request.add('environment', environment)
+          remove_conference_template_participant_request.add('templateId', template_id.to_s)
+          remove_conference_template_participant_request.add('participantId', participant_id.to_s)
+          remove_conference_template_participant_request.add('account', account) if (account && !account.empty?)
+        end
+      end
+
+      response = RemoveConferenceTemplateParticipantResponse.new(response_xml)
+    end
+
+    # Give the list of the templates of the given conference owner
+    # ===Parameters
+    # <tt>template_id</tt>:: conference in which will be added the participant
+    # <tt>participant</tt>:: participant who will be added to the conference
+    # <tt>environment</tt>:: Service environment as defined in ServiceLevel.
+    def add_conference_template_participant(template_id, participant, environment = ServiceEnvironment.MOCK, account = nil)
+       response_xml = invoke_authenticated("cc:addConferenceTemplateParticipant") do |request, doc|
+        request.add('addConferenceTemplateParticipantRequest') do |add_conference_template_participant_request|
+          add_conference_template_participant_request.add('environment', environment)
+          add_conference_template_participant_request.add('templateId', template_id.to_s)
+          add_conference_template_participant_request.add('participant') do |participant_request|
+            participant.add_to_handsoap_xml(participant_request)
+          end
+          add_conference_template_participant_request.add('account', account) if (account && !account.empty?)
+        end
+      end
+
+      response = AddConferenceTemplateParticipantResponse.new(response_xml)
+    end
+
+
+    #### Static Methods
+
+    def self.CONFERENCE_CALL_SCHEMA
+      return @@CONFERENCE_CALL_SCHEMA
+    end
+
+    # Performs a xpath query in the ip location namespace for the given document and query string.
+    # === Parameters
+    # <tt>doc</tt>:: XmlQueryFront document.
+    # <tt>query_string</tt>:: Element to look for
+    # <tt>global_search</tt>:: Searches within all levels using "//" if <tt>global_search = true</tt>.
+    def self.xpath_query(doc, query_string, global_search = true)
+      self.xpath_query_for_schema(@@CONFERENCE_CALL_SCHEMA, doc, query_string, global_search)
+    end
+  end
+end