cb-api 1.3.6 → 2.0.0

data/lib/cb/clients/company_api.rb

@@ -1,39 +0,0 @@
-require 'json'
-
-module Cb
-	class CompanyApi
-		#############################################################
-		## Retrieve a company by did
-		## 
-		## For detailed information around this API please visit:
-		## http://api.careerbuilder.com/CompanyDetailsInfo.aspx
-		#############################################################
-		def self.find_by_did(did)
-      my_api = Cb::Utils::Api.new()
-      json_hash = my_api.cb_get(Cb.configuration.uri_company_find, :query => {:CompanyDID => did, :hostsite=> Cb.configuration.host_site})
-
-      if json_hash.has_key?('Results')
-          if json_hash['Results'].has_key?('CompanyProfileDetail')
-			      company = CbCompany.new(json_hash['Results']['CompanyProfileDetail'])
-          end
-          my_api.append_api_responses(company, json_hash['Results'])
-      end
-
-      my_api.append_api_responses(company, json_hash)
-
-
-      return company
-		end
-
-		def self.find_for(obj)
-			if obj.is_a?(String)
-				did = obj
-			elsif obj.is_a?(Cb::CbJob)
-				did = obj.company_did
-			end
-			did ||= ''
-
-			find_by_did did unless did.empty?
-		end
-	end
-end

data/lib/cb/clients/education_api.rb

@@ -1,37 +0,0 @@
-require 'json'
-
-module Cb
-	class EducationApi
-		#############################################################
-		## Retrieve Education codes by country code
-		## 
-		## For detailed information around this API please visit:
-		## http://api.careerbuilder.com/EducationCodes.aspx
-		#############################################################
-		def self.get_for(country)
-			Cb::Utils::Country.is_valid? country ? country : 'US'
-
-			my_api = Cb::Utils::Api.new()
-
-      json_hash = my_api.cb_get(Cb.configuration.uri_education_code, :query => {:countrycode => country})
-
-			codes = []
-      if json_hash.has_key?('ResponseEducationCodes')
-
-        if json_hash['ResponseEducationCodes'].has_key?('EducationCodes') &&
-            json_hash['ResponseEducationCodes']['EducationCodes'].has_key?('Education')
-
-            json_hash['ResponseEducationCodes']['EducationCodes']['Education'].each do | education |
-              codes << Cb::CbEducation.new(education)
-            end
-        end
-
-        my_api.append_api_responses(codes, json_hash['ResponseEducationCodes'])
-      end
-
-      my_api.append_api_responses(codes, json_hash)
-
-      return codes
-		end
-	end
-end

data/lib/cb/clients/email_subscription_api.rb

@@ -1,68 +0,0 @@
-require 'json'
-
-module Cb
-  class EmailSubscriptionApi
-    #############################################################
-    ## Retrieve subscription values for a user
-    ##
-    ## For detailed information around this API please visit:
-    ## http://api.careerbuilder.com/usersubscriptionretrieve.aspx
-    #############################################################
-    def self.retrieve_by_did(did, host_site = '')
-      my_api = Cb::Utils::Api.new()
-      json_hash = my_api.cb_get(Cb.configuration.uri_subscription_retrieve, :query => {:ExternalID => did, :Hostsite => host_site})
-
-      if json_hash.has_key?('SubscriptionValues') && !json_hash['SubscriptionValues'].nil?
-        subscription = CbEmailSubscription.new(json_hash['SubscriptionValues'])
-        my_api.append_api_responses(subscription, json_hash['SubscriptionValues'])
-      end
-      my_api.append_api_responses(subscription, json_hash)
-
-      return subscription
-    end
-
-
-    #############################################################
-    ## Update subscription values for a user
-    ##
-    ## For detailed information around this API please visit:
-    ## http://api.careerbuilder.com/usersubscriptionretrieve.aspx
-    #############################################################
-    def self.modify_subscription ext_id, host_site, career_resources, product_sponsor_info, applicant_survey_invites, job_recs, unsubscribe_all
-      if unsubscribe_all && unsubscribe_all != 'false'
-        career_resources = product_sponsor_info = applicant_survey_invites = job_recs = false.to_s
-      end
-
-      career_resources = career_resources.nil? ? 'false' : career_resources
-      product_sponsor_info = product_sponsor_info.nil? ? 'false' : product_sponsor_info
-      applicant_survey_invites = applicant_survey_invites.nil? ? 'false' : applicant_survey_invites
-      job_recs = job_recs.nil? ? 'false' : job_recs
-      unsubscribe_all = unsubscribe_all.nil? ? 'false' : unsubscribe_all
-
-      my_api = Cb::Utils::Api.new()
-
-      xml_body = "<Request>"
-      xml_body += "<DeveloperKey>" + Cb.configuration.dev_key.to_s + "</DeveloperKey>"
-      xml_body += "<ExternalID>" + ext_id.to_s + "</ExternalID>"
-      xml_body += "<Hostsite>" + host_site.to_s + "</Hostsite>"
-      xml_body += "<CareerResources>" + career_resources.to_s + "</CareerResources>"
-      xml_body += "<ProductSponsorInfo>" + product_sponsor_info.to_s + "</ProductSponsorInfo>"
-      xml_body += "<ApplicantSurveyInvites>" + applicant_survey_invites.to_s + "</ApplicantSurveyInvites>"
-      xml_body += "<JobRecs>" + job_recs.to_s + "</JobRecs>"
-      xml_body += "<UnsubscribeAll>" + unsubscribe_all.to_s + "</UnsubscribeAll>"
-      xml_body += "</Request>"
-
-
-      json_hash = my_api.cb_post(Cb.configuration.uri_subscription_modify,
-                                  :body => xml_body)
-
-      if json_hash.has_key?('SubscriptionValues') && !json_hash['SubscriptionValues'].nil?
-        subscription = CbEmailSubscription.new(json_hash['SubscriptionValues'])
-        my_api.append_api_responses(subscription, json_hash['SubscriptionValues'])
-      end
-      my_api.append_api_responses(subscription, json_hash)
-      return subscription
-    end
-
-  end
-end

data/lib/cb/clients/employee_types_api.rb

@@ -1,48 +0,0 @@
-require "json"
-
-module Cb
-	class EmployeeTypesApi
-
-		def self.search
-			my_api = Cb::Utils::Api.new()
-			json_hash = my_api.cb_get(Cb.configuration.uri_employee_types)
-			
-			return array_of_objects_from_hash(json_hash, my_api)
-		end
-
-		def self.search_by_host_site(hostsite)
-			my_api = Cb::Utils::Api.new()
-			json_hash = my_api.cb_get(Cb.configuration.uri_employee_types, :query => {:CountryCode => hostsite})
-
-			return array_of_objects_from_hash(json_hash, my_api)
-		end
-
-		private
-		def self.array_of_objects_from_hash(json_hash, my_api)
-
-			employee_types = []
-			if json_hash.has_key?('ResponseEmployeeTypes')
-        if json_hash['ResponseEmployeeTypes'].has_key?('EmployeeTypes') &&
-            !json_hash['ResponseEmployeeTypes']['EmployeeTypes'].nil?
-
-          if json_hash['ResponseEmployeeTypes']['EmployeeTypes']['EmployeeType'].is_a?(Array)
-
-            json_hash['ResponseEmployeeTypes']['EmployeeTypes']['EmployeeType'].each do |et|
-              employee_types << CbEmployeeType.new(et)
-            end
-
-          elsif json_hash['ResponseEmployeeTypes']['EmployeeTypes']['EmployeeType'].is_a?(Hash) && json_hash.length < 2
-            employee_types << CbEmployeeType.new(json_hash['ResponseEmployeeTypes']['EmployeeTypes']['EmployeeType'])
-          end
-
-        end
-        my_api.append_api_responses(employee_types, json_hash['ResponseEmployeeTypes'])
-      end
-
-      my_api.append_api_responses(employee_types, json_hash)
-			
-			return employee_types
-		end
-
-	end
-end

data/lib/cb/clients/job_api.rb

@@ -1,70 +0,0 @@
-require 'json'
-
-module Cb
-  class JobApi
-
-    #############################################################
-    ## Run a job search against the given criteria
-    ##
-    ## For detailed information around this API please visit:
-    ##
-    #############################################################
-    def self.search(*args)
-      args = args[0] if args.is_a?(Array) && args.count == 1
-      my_api = Cb::Utils::Api.new()
-      json_hash = my_api.cb_get(Cb.configuration.uri_job_search, :query => args)
-
-      jobs = Array.new
-      if !json_hash['ResponseJobSearch'].nil? && !json_hash['ResponseJobSearch']['Results'].nil?
-        job_results = json_hash['ResponseJobSearch']['Results']['JobSearchResult']
-        job_results = [job_results] if !job_results.is_a?(Array)
-        job_results.each { |job_hash| jobs.push(CbJob.new(job_hash)) }
-        my_api.append_api_responses(jobs, json_hash['ResponseJobSearch'])
-
-        if response_has_search_metadata?(json_hash['ResponseJobSearch'])
-          my_api.append_api_responses(jobs, json_hash['ResponseJobSearch']['SearchMetaData']['SearchLocations']['SearchLocation'])
-        end
-      end
-
-      my_api.append_api_responses(jobs, json_hash)
-
-      return jobs
-    end
-
-    #############################################################
-    ## Retrieve a job by did
-    ##
-    ## For detailed information around this API please visit:
-    ## http://api.careerbuilder.com/JobInfo.aspx
-    #############################################################
-    def self.find_by_criteria(criteria)
-      my_api = Cb::Utils::Api.new()
-      params = my_api.class.criteria_to_hash(criteria)
-      json_hash = my_api.cb_get(Cb.configuration.uri_job_find, :query => params)
-
-      if json_hash.has_key?('ResponseJob')
-        if json_hash['ResponseJob'].has_key?('Job')
-          job = CbJob.new(json_hash['ResponseJob']['Job'])
-        end
-        my_api.append_api_responses(job, json_hash['ResponseJob'])
-      end
-      my_api.append_api_responses(job, json_hash)
-
-      return job
-    end
-
-    def self.find_by_did(did)
-      criteria = Cb::JobDetailsCriteria.new()
-      criteria.did = did
-      return find_by_criteria(criteria)
-    end
-
-    private
-
-    def self.response_has_search_metadata?(response_hash)
-      response_hash['SearchMetaData'] &&
-      response_hash['SearchMetaData']['SearchLocations'] &&
-      response_hash['SearchMetaData']['SearchLocations']['SearchLocation']
-    end
-  end # JobApi
-end # Cb

data/lib/cb/clients/job_branding_api.rb

@@ -1,24 +0,0 @@
-require 'nori'
-
-module Cb
-
-	class JobBrandingApi
-
-		def self.find_by_id id
-		  my_api = Cb::Utils::Api.new
-
-		  json_hash = my_api.cb_get Cb.configuration.uri_job_branding, :query => { :id => id }
-
-      if json_hash.has_key? 'Branding'
-        branding = CbJobBranding.new json_hash['Branding']
-        my_api.append_api_responses(branding, json_hash['Branding'])
-      end
-
-      my_api.append_api_responses(branding, json_hash)
-
-		  return branding
-		end
-
-	end
-
-end

data/lib/cb/clients/recommendation_api.rb

@@ -1,98 +0,0 @@
-require 'json'
-
-module Cb
-  class RecommendationApi
-    #############################################################
-    ## Get recommendations for a job
-    ##
-    ## For detailed information around this API please visit:
-    ## http://api.careerbuilder.com/Recommendations.aspx
-    #############################################################
-    def self.for_job(did, countlimit = '25', site_id = '', co_brand = '')
-      my_api = Cb::Utils::Api.new()
-      json_hash = my_api.cb_get(Cb.configuration.uri_recommendation_for_job,
-                                  :query => {:JobDID => did, :CountLimit => countlimit, :SiteID => site_id,
-                                             :CoBrand => co_brand, :HostSite => Cb.configuration.host_site})
-
-      jobs = []
-      if json_hash.has_key?('ResponseRecommendJob')
-        if json_hash['ResponseRecommendJob'].has_key?('RecommendJobResults') &&
-           !json_hash['ResponseRecommendJob']['RecommendJobResults'].nil?
-
-          json_hash['ResponseRecommendJob']['RecommendJobResults']['RecommendJobResult'].each do |cur_job|
-            jobs << CbJob.new(cur_job)
-          end
-          my_api.append_api_responses(jobs, json_hash['ResponseRecommendJob']['Request'])
-        end
-        my_api.append_api_responses(jobs, json_hash['ResponseRecommendJob'])
-      end
-      my_api.append_api_responses(jobs, json_hash)
-
-      return jobs
-    end
-
-    #############################################################
-    ## Get recommendations for a user
-    ##
-    ## For detailed information around this API please visit:
-    ## http://api.careerbuilder.com/Recommendations.aspx
-    #############################################################
-    def self.for_user(external_id, countlimit = '25', site_id = '', co_brand = '')
-      my_api = Cb::Utils::Api.new()
-      json_hash = my_api.cb_get(Cb.configuration.uri_recommendation_for_user,
-                                  :query => {:ExternalID => external_id, :CountLimit => countlimit, :SiteID => site_id, :CoBrand => co_brand,
-                                             :HostSite => Cb.configuration.host_site})
-
-      jobs = []
-      if json_hash.has_key?('ResponseRecommendUser')
-
-        if json_hash['ResponseRecommendUser'].has_key?('RecommendJobResults') &&
-          !json_hash['ResponseRecommendUser']['RecommendJobResults'].nil?
-
-          json_hash['ResponseRecommendUser']['RecommendJobResults']['RecommendJobResult'].each do |cur_job|
-            jobs << CbJob.new(cur_job)
-          end
-
-          my_api.append_api_responses(jobs, json_hash['ResponseRecommendUser']['Request'])
-        end
-
-        my_api.append_api_responses(jobs, json_hash['ResponseRecommendUser'])
-      end
-
-      my_api.append_api_responses(jobs, json_hash)
-
-      return jobs
-    end
-
-    #############################################################
-    ## Get recommendations for a company
-    ##
-    ## For detailed information around this API please visit:
-    ## http://api.careerbuilder.com/Recommendations.aspx
-    #############################################################
-    def self.for_company(company_did)
-      my_api = Cb::Utils::Api.new()
-      json_hash = my_api.cb_get(Cb.configuration.uri_recommendation_for_company,
-                                  :query => {:CompanyDID => company_did})
-
-      jobs = []
-      if json_hash.has_key?('Results')
-
-        if json_hash['Results'].has_key?('JobRecommendation')
-
-          json_hash['Results']['JobRecommendation']['Jobs'].each do |cur_job|
-            jobs << CbJob.new(cur_job)
-          end
-
-          my_api.append_api_responses(jobs, json_hash['Results']['JobRecommendation'])
-        end
-
-        my_api.append_api_responses(jobs, json_hash['Results'])
-
-      end
-      my_api.append_api_responses(jobs, json_hash)
-
-      return jobs
-    end
-  end
-end

data/lib/cb/clients/resume_api.rb

@@ -1,185 +0,0 @@
-require 'json'
-
-module Cb
-  class ResumeApi
-    #############################################################
-    ## Retrieve resumes a user owns.
-    ##
-    ## Returns an array of resumes with external id and
-    ## title set.
-    ##
-    ## Note: This does not load the resume, a subsequent resume
-    ## retrieve is required.
-    ##
-    ## For detailed information around this API please visit:
-    ## http://www.careerbuilder.com/api/ResumeInfo.aspx
-    #############################################################
-    def self.own_all(external_user_id, ignore_host_site = false)
-      my_api = Cb::Utils::Api.new
-      params = {"ExternalUserID" => external_user_id}
-      if ignore_host_site
-        params['IgnoreHostSite'] = 'true'
-      end
-      json_hash = my_api.cb_get(Cb.configuration.uri_resume_own_all, :query => params)
-
-      resumes = []
-
-      if json_hash.has_key?('ResponseOwnResumes') && json_hash['ResponseOwnResumes'].has_key?('Resumes')
-        json_hash['ResponseOwnResumes']['Resumes']['Resume'].each do |resume_hash|
-          resume = Cb::CbResume.new resume_hash
-          resume.external_resume_id = resume_hash['ExternalID']
-          resume.external_user_id = external_user_id
-          resumes << resume
-        end
-      end
-
-      return resumes
-    end
-
-    #############################################################
-    ## Retrieve the contents of a resume by external id.
-    ##
-    ## For detailed information around this API please visit:
-    ## http://www.careerbuilder.com/api/ResumeInfo.aspx
-    #############################################################
-    def self.retrieve_by_id resume_external_id, external_user_id
-      my_api = Cb::Utils::Api.new
-      params = {"ExternalID" => external_id, "ExternalUserID" => external_user_id}
-      json_hash = my_api.cb_get(Cb.configuration.uri_resume_retrieve, :query => params)
-
-      if json_hash.has_key?('ResponseRetrieve') && json_hash['ResponseRetrieve'].has_key?('Resume')
-        resume = Cb::CbResume.new json_hash['ResponseRetrieve']['Resume']
-        my_api.append_api_responses resume, json_hash['ResponseRetrieve']
-      end
-
-      return resume
-    end
-
-    #############################################################
-    ## Retrieve the contents of a resume.
-    ##
-    ## For detailed information around this API please visit:
-    ## http://www.careerbuilder.com/api/ResumeInfo.aspx
-    #############################################################
-    def self.retrieve resume
-      my_api = Cb::Utils::Api.new
-      params = {"ExternalID" => resume.external_resume_id, "ExternalUserID" => resume.external_user_id}
-      json_hash = my_api.cb_get(Cb.configuration.uri_resume_retrieve, :query => params)
-
-      if json_hash.has_key?('ResponseRetrieve') && json_hash['ResponseRetrieve'].has_key?('Resume')
-        resume = resume.set_attributes json_hash['ResponseRetrieve']['Resume']
-        my_api.append_api_responses resume, json_hash['ResponseRetrieve']
-      end
-
-      return resume
-    end
-
-    #############################################################
-    ## TODO: Create a resume
-    ##
-    ## For detailed information around this API please visit:
-    ## http://www.careerbuilder.com/api/ResumeInfo.aspx
-    #############################################################
-    def self.create resume
-      my_api = Cb::Utils::Api.new
-      json_hash = my_api.cb_post(Cb.configuration.uri_resume_create, :body => make_create_xml(resume))
-    end
-
-    #############################################################
-    ## TODO: Update a resume
-    ##
-    ## For detailed information around this API please visit:
-    ## http://www.careerbuilder.com/api/ResumeInfo.aspx
-    #############################################################
-    def self.update resume
-      my_api = Cb::Utils::Api.new
-      json_hash = my_api.cb_post(Cb.configuration.uri_resume_update, :body => make_update_xml(resume))
-    end
-
-    #############################################################
-    ## TODO: Delete a resume
-    ##
-    ## For detailed information around this API please visit:
-    ## http://www.careerbuilder.com/api/ResumeInfo.aspx
-    #############################################################
-    def self.delete resume
-      my_api = Cb::Utils::Api.new
-      json_hash = my_api.cb_post(Cb.configuration.uri_resume_delete, :body => make_delete_xml(resume))
-    end
-
-    private
-    def make_create_xml(resume)
-      xml = "<Request>"
-      xml += "<DeveloperKey>#{Cb.configuration.dev_key}</DeveloperKey>"
-      xml += "<ExternalID>#{resume.resume_external_id}</ExternalID>"
-      xml += "<Test>false</Test>"
-      xml += "<ExternalUserID>#{resume.user_external_id}</ExternalUserID>"
-      cd = self.new_record? ? Date.current : self.created_at
-      md = self.new_record? ? Date.current : self.updated_at
-      xml += "<CreatedDT>#{cd.xmlschema}</CreatedDT>"
-      xml += "<ModifiedDT>#{md.xmlschema}</ModifiedDT>"
-      xml += "<Certifications>#{resume.certifications * ','}</Certifications>"
-      xml += "<ShowContactInfo>#{resume.show_contact_info}</ShowContactInfo>"
-      xml += "<Title>#{resume.title.xmlsafe}</Title>"
-      xml += "<ResumeText>#{resume.resume_text.xmlsafe}</ResumeText>"
-      xml += "<Visibility>#{resume.visibility.to_s.downcase}</Visibility>"
-      xml += "<CanRelocateNationally>#{resume.can_relocate_nationally.to_s.downcase}</CanRelocateNationally>"
-      xml += "<CanRelocateInternationally>#{resume.can_relocate_internationally.to_s.downcase}</CanRelocateInternationally>"
-      xml += "<TotalYearsExperience>#{resume.total_years_experience.to_i}</TotalYearsExperience>"
-      xml += "<HostSite>#{Cb.configuration.host_site}</HostSite>"
-      xml += "<DesiredJobTypes>#{resume.desired_job_type}</DesiredJobTypes>" unless resume.desired_job_type.blank?
-      xml += "<DesiredJobTypes>ETFE</DesiredJobTypes>" if resume.desired_job_type.blank?
-      xml += "<RecentPayAmount>#{resume.recent_pay_amount.money_to_string}</RecentPayAmount>" unless resume.recent_pay_amount.blank?
-      xml += "<RecentPayType>#{resume.recent_pay_type.downcase}</RecentPayType>" unless resume.recent_pay_type.blank?
-
-      xml += "<CompanyExperiences>"
-      resumes.company_experiences.each do |experience|
-        xml += "<CompanyExperience>"
-        xml += "<CompanyName>#{experience.company_name.xmlsafe}</CompanyName>"
-        xml += "<JobTitle>#{experience.job_title.xmlsafe}</JobTitle>"
-        xml += "<StartDate>#{experience.start_date.to_s}</StartDate>" unless experience.start_date.blank?
-        xml += "<EndDate>#{experience.end_date.to_s}</EndDate>" unless experience.end_date.blank?
-        xml += "<EndDate>1970-01-01</EndDate>" if experience.end_date.blank?
-        xml += "<Details>#{experience.details.xmlsafe}</Details>"
-        xml += "</CompanyExperience>"
-      end
-      xml += "</CompanyExperiences>"
-      xml += "<Educations>"
-      resume.educations.each do |education|
-        xml += "<Education>"
-        xml += "<SchoolName>#{education.school_name.xmlsafe}</SchoolName>"
-        xml += "<Major>#{education.major.xmlsafe}</Major>"
-        xml += "<DegreeCode>#{education.degree_code}</DegreeCode>"
-        xml += "<GraduationDate>#{education.graduation_date.to_s}</GraduationDate>" unless education.graduation_date.blank?
-        #Never actually needed:
-        #xml += "<GPA>#{education.gpa.to_i}</GPA>"
-        xml += "</Education>"
-      end
-      xml += "</Educations>"
-      xml += "<Languages>"
-      resume.languages.each do |language|
-        xml += "<Language>#{language}</Language>"
-      end
-      xml += "</Languages>"
-      xml += "</Request>"
-      xml
-    end
-
-    def make_update_xml(resume)
-      make_create_xml resume
-    end
-
-    def make_delete_xml(resume)
-      raise "external_resume_id is undefined in CbResume." if resume.external_resume_id.blank?
-      raise "external_user_id is undefined in CbResume." if resume.external_user_id.blank?
-
-      xml = '<Request>'
-      xml += "<DeveloperKey></DeveloperKey>"
-      xml += "<ExternalID>#{resume.external_resume_id}</ExternalID>"
-      xml += "<Test>#{resume.test}</Test>"
-      xml += "<ExternalUserID>#{resume.external_user_id}</ExternalUserID>"
-      xml += '</Request>'
-      xml
-    end
-  end
-end