bullhorn-rails 0.1.0 → 0.1.1

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.1

data/bullhorn-rails.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = "bullhorn-rails"
-  s.version = "0.1.0"
+  s.version = "0.1.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Jack Thorsen"]
@@ -26,8 +26,17 @@ Gem::Specification.new do |s|
     "Rakefile",
     "VERSION",
     "bullhorn-rails-.gem",
+    "bullhorn-rails-0.1.0.gem",
     "bullhorn-rails.gemspec",
+    "lib/.DS_Store",
     "lib/bullhorn-rails.rb",
+    "lib/bullhorn/bullhorn.rb",
+    "lib/bullhorn/bullhorn/candidates.rb",
+    "lib/bullhorn/bullhorn/categories.rb",
+    "lib/bullhorn/bullhorn/client.rb",
+    "lib/bullhorn/bullhorn/files.rb",
+    "lib/bullhorn/bullhorn/jobs.rb",
+    "lib/bullhorn/bullhorn/util.rb",
     "spec/bullhorn-rails_spec.rb",
     "spec/spec_helper.rb"
   ]

data/lib/bullhorn/bullhorn.rb

@@ -0,0 +1,26 @@
+require 'savon'
+require 'open-uri'
+require 'net/https'
+
+require 'bullhorn/util'
+require 'bullhorn/client'
+require 'bullhorn/categories'
+
+module Bullhorn
+
+  Savon.configure do |config|
+
+    # TODO Add logger based on environment
+    # The default log level used by Savon is :debug.
+    config.log_level = :debug
+
+    # In a Rails application you might want Savon to use the Rails logger.
+    #config.logger = Rails.logger
+
+    # The XML logged by Savon can be formatted for debugging purposes.
+    # Unfortunately, this feature comes with a performance and is not
+    # recommended for production environments.
+    config.pretty_print_xml = true
+
+  end
+end

data/lib/bullhorn/bullhorn/candidates.rb

@@ -0,0 +1,171 @@
+module Bullhorn
+
+  class Candidates
+
+    class << self
+    
+      
+      ###--------------So I can set credentials from console
+      def credentials
+           Bullhorn::Client.username = '525.resumes'
+           Bullhorn::Client.password = 'scrub04k'
+           Bullhorn::Client.apiKey   = '943C63E3-FB1A-4089-A3813849B9626393'  
+      end
+
+      ###---------------- Find a Candidate by Id
+      def find_by id
+        (select_fields results(Bullhorn::Client.findMultiple find_multiple_request([id]))).first  
+      end
+    
+      
+      ###---------------- Find an array of Candidates by an array of Ids
+      def find_multiple_by ids
+        candidates = []
+        index = 1
+        while ids.page(index) != nil
+          candidate_detail_response = Bullhorn::Client.findMultiple candidate_detail_request(ids.page(index))
+          details = get_candidate_details_from(candidate_detail_response)
+          
+          details = [details] if !(details.class == Array)
+          select_fields resultsdetails
+          index += 1
+        end
+        candidates
+      end   
+      
+      ###----------------- Find a Candidate by Email
+      ###                  returns Candidate dto, or nil if not found
+      def query_by email
+        request = candidate_query_request
+        request[:query][:where] = "email='" + email + "'"
+        response=(Bullhorn::Client.query request).body[:query_response][:return]
+        find_by response[:ids] if response.has_key?(:ids)
+      end  
+      
+      ###----------------- Find a Candidate using a query string
+      def query_where conditions
+        candidate_query_request[:query][:where] = conditions
+        response=(Bullhorn::Client.query candidate_query_request).body[:query_response][:return]
+        find_by response[:ids] if response.has_key?(:ids)
+      end  
+      
+      
+      ###----------------- Gets first qty of Ids, for testing purposes  
+      def get_ids qty
+        get_id_response qty
+      end  
+      
+      ###----------------- Gets first qty of Ids, for testing purposes
+      def get_id_response qty
+        request = candidate_query_request
+        request[:query][:maxResults] = qty if qty
+        response = (Bullhorn::Client.query request).body[:query_response][:return][:ids]
+        response
+      end
+      
+      ###------------------- Save Candidate
+      def save candidate
+        request = save_request(candidate)
+        (Bullhorn::Client.save request).body[:save_response]
+      end  
+      
+      def default_candidate  
+      {
+        :address => {
+          :address1 => "",
+          :address2 => "",
+          :city => "",
+          :state => "",
+          :countryID => 1,
+          :zip => ""
+          },
+        :category_id => 45,                            #integer
+        :comments => "",   
+        :email => "",                         
+        :employee_type => "",
+        :first_name => "",
+        :is_deleted => 0,                               #boolean
+        :is_editable => 1,         #boolean
+        :last_name => "",
+        :name => "",
+        :owner_id => 43832,               #integer
+        :password => "hireminds123",
+        :preferred_contact => "",
+        :status => "",
+        :username => "",
+        :user_type_id => 35,  
+        :is_day_light_savings => true,
+        :mass_mail_opt_out => false,
+        :time_zone_offset_est => 0,
+        :day_rate => 0,
+        :day_rate_low => 0,
+        :degree_list => "",
+        :salary => 0,
+        :travel_limit => 0,
+        :will_relocate => false,
+        :work_authorized => true,
+      }  
+      end
+         
+      protected
+      
+      def results response
+        response.body[:find_multiple_response][:return][:dtos]
+      end  
+      
+      def api operation, body
+        Bullhorn::Client.api operation, body
+      end
+      
+      def select_fields response
+        candidates = []
+        response = [response] if !(response.kind_of?(Array))
+        response.each do |dto|
+          candidate = dto                        
+          candidates << candidate
+        end 
+        candidates 
+      end
+      
+      def find_candidate_request id
+      {
+        :entity => 'Candidate',
+        :id => id,
+        :attributes! => { :id => {"xsi:type" => "xsd:int"}}
+      }
+      end
+      
+      def find_multiple_request page_of_ids
+      {
+        :entityName => "Candidate",
+        :ids => page_of_ids,
+        :attributes! => { :ids => { "xsi:type" => "xsd:int" } }
+      }
+      end
+      
+      def candidate_query_request 
+        {:query => {:entityName => "Candidate", :maxResults => 10}} 
+      end
+      
+      def save_request candidate
+      {
+        :dto => candidate,
+        :attributes! => {
+          :dto => {
+            "xsi:type"=>"ns4:candidateDto", 
+            "xmlns:xsi"=>"http://www.w3.org/2001/XMLSchema-instance", 
+            "xmlns:ns4"=>"http://candidate.entity.bullhorn.com/"
+          }
+        }
+      }  
+      end
+      
+      def clean_up response
+       response
+      end
+    
+    #----------------------------------------------------
+
+    end
+  end
+end

data/lib/bullhorn/bullhorn/categories.rb

@@ -0,0 +1,51 @@
+module Bullhorn
+
+  class Categories
+
+    class << self
+
+      def all
+        response = Bullhorn::Client.query category_id_request
+        ids = get_ids_from response
+        get_category_names_from ids
+      end
+
+      protected
+
+      def category_id_request
+        { :query => { :entityName => "Category" } }
+      end
+
+      def category_detail_request page_of_ids
+        {
+          :entityName => "Category",
+          :ids => page_of_ids,
+          :attributes! => { :ids => { "xsi:type" => "xsd:int" } }
+        }
+      end
+
+      def get_ids_from response
+        response[:query_response][:return][:ids]
+      end
+
+      def get_category_details_from page_of_category_results
+        page_of_category_results[:find_multiple_response][:return][:dtos]
+      end
+
+      def get_category_names_from ids
+        categories = []
+        index = 1
+
+        while ids.page(index) != nil
+          category_detail_response = Bullhorn::Client.findMultiple category_detail_request(ids.page(index))
+
+          get_category_details_from(category_detail_response).each { |c| categories << {:id => c[:category_id], :name => c[:name].titleize} }
+
+          index += 1
+        end
+
+        categories
+      end      
+    end
+  end
+end

data/lib/bullhorn/bullhorn/client.rb

@@ -0,0 +1,174 @@
+module Bullhorn
+
+  class Client
+
+    class NoCredentials < StandardError; end
+
+    class << self
+      
+      attr_writer :username, :password, :apiKey
+      
+      def api operation, body
+        client = connection
+        session = @session
+        client.request :tns, operation.to_sym do
+          body[:session] = session
+          soap.body = body
+        end
+      end
+      
+      def get_entity_files body
+        client = connection
+        session = @session
+        client.request :tns, :getEntityFiles do
+          body[:session] = session
+          soap.body = body
+        end
+      end    
+      
+      def parse body
+        client = connection
+        session = @session
+        client.request :tns, :parseResume do
+          body[:session] = session
+          soap.body = body
+        end
+      end
+      
+      def add_file body
+        client = connection
+        session = @session
+        client.request :tns, :addFile do
+          body[:session] = session
+          soap.body = body
+        end
+      end    
+      
+      def update_file body
+        client = connection
+        session = @session
+        client.request :tns, :updateFile do
+          body[:session] = session
+          soap.body = body
+        end
+      end  
+      
+      def findCandidate body
+        client = connection
+        session = @session
+        client.request :findCandidate do
+          body[:session] = session
+          soap.body = body
+        end
+      end
+      
+      def save body
+        client = connection
+        session = @session
+        client.request :save do
+          body[:session] = session
+          soap.body = body
+        end
+      end
+      
+      def query body
+        client = connection
+        session = @session
+        client.request :query do
+          body[:session] = session
+          soap.body = body
+        end
+      end
+      
+      def getFile body
+        client = connection
+        session = @session
+        client.request :tns, :getFile do
+          body[:session] = session
+          soap.body = body
+        end
+      end
+
+      def findMultiple body
+        client = connection
+        session = @session
+        client.request :tns, :findMultiple do
+          body[:session] = session
+          soap.body = body
+        end
+      end
+      
+      def getAssociationIds body
+        client = connection
+        session = @session
+        client.request :tns, :getAssociationIds do
+          body[:session] = session
+          soap.body = body
+        end
+      end
+      
+      def eventsSubscribe body
+        client = connection
+        session = @session
+        client.request :tns, :eventsSubscribe do
+          body[:session] = session
+          soap.body = body
+        end
+      end    
+          
+      def eventsUnsubscribe body
+        client = connection
+        session = @session
+        client.request :tns, :eventsUnsubscribe do
+          body[:session] = session
+          soap.body = body 
+        end
+       end
+          
+       def eventsGetEvents body
+        client = connection
+        session = @session
+        client.request :tns, :eventsGetEvents do
+          body[:session] = session
+          soap.body = body
+        end
+      end    
+      
+      
+
+      def connection
+
+        raise NoCredentials if @username.nil?
+        raise NoCredentials if @password.nil?
+        raise NoCredentials if @apiKey.nil?
+
+        @connection ||= new_connection
+      end
+
+      def new_connection
+        @connection = Savon.client "https://api.bullhornstaffing.com/webservices-2.5/?wsdl"
+        authenticate
+      end
+
+      def authenticate
+        username = @username
+        password = @password
+        apiKey = @apiKey
+        response = @connection.request :start_session do
+          soap.body = {
+            :username => username, 
+            :password => password,
+            :apiKey => apiKey
+          }
+        end
+
+        @session = response.body[:start_session_response][:return][:session]
+        @connection
+      end
+
+      def clear_connection
+        @connection = nil
+      end
+    end
+  end
+end

data/lib/bullhorn/bullhorn/files.rb

@@ -0,0 +1,195 @@
+module Bullhorn
+
+  class Files
+
+    class << self
+
+      #--------- Upload a new File and attach it to a Candidate (New) Returns new File Id
+      def add file, entity_id=114755, entity_name="Candidate" 
+        response = (Bullhorn::Client.add_file file_request(file, entity_name, entity_id)).body[:add_file_response][:return][:id]
+        
+      end
+      
+      #---------- Upload a replacement to a File attached to a Candidate (Udate)
+      def update file, entity_id=114755, entity_name="Candidate" 
+        Bullhorn::Client.update_file file_request(file)
+      end
+      
+      #---------- Get list of all Files' meta data attached to a Candidate (Index)
+      #---------- Returns:    :comments, :content_sub_type, :content_type, :id, :name, :type
+      def get_entity_files entity_id = 114755, entity = "Candidate"
+        response = (Bullhorn::Client.get_entity_files get_entity_files_request(entity_id, entity)).body[:get_entity_files_response][:return][:api_entity_metas]
+      end  
+      
+      #---------- Get a File specified by its Id (Show) Returns File
+      def get_file_by id, entity_id=114775, entity_name="Candidate" 
+        (Bullhorn::Client.getFile get_file_request(id, entity_name, entity_id)).body[:get_file_response][:return][:file_data]
+      end
+      
+      #---------- Delete all files for a Candidate
+      def delete_all candidate_id
+        (get_entity_files candidate_id).each do |file|
+          Bullhorn::Client.api "deleteFile", delete_file_request(file, candidate_id)
+        end  
+      end
+      
+      
+      
+      ###--------- Find a Candidate by Email or create a new Candidate, 
+      ###          then update Candidate fields with resume file and save
+      def store file_by_candidate
+        sum = []
+        response = (Bullhorn::Candidates.query_by file_by_candidate[:email]) || Bullhorn::Candidates.default_candidate
+        candidate = {
+          :address => response[:address],
+          :categoryID => response[:category_id],                            #integer
+          :comments => response[:comments],   
+          :email => response[:email],                         
+          :employeeType => response[:employee_type],
+          :firstName => response[:first_name],
+          :isDeleted => response[:is_deleted],                               #boolean
+          :isEditable => response[:is_editable],         #boolean
+          :lastName => response[:last_name],
+          :name => response[:name],
+          :ownerID => response[:owner_id],               #integer
+          :password => response[:password],
+          :preferredContact => response[:preferred_contact],
+          :status => response[:status],
+          :username => response[:username], 
+          :userTypeID => response[:user_type_id],         
+          :isDayLightSavings => response[:is_day_light_savings],
+          :massMailOptOut => response[:mass_mail_opt_out],
+          :timeZoneOffsetEST => response[:time_zone_offset_est],
+          :dayRate => response[:day_rate],
+          :dayRateLow => response[:day_rate_low],
+          :degreeList => response[:degree_list],
+          :salary => response[:salary],
+          :travelLimit => response[:travel_limit],
+          :willRelocate => response[:will_relocate],
+          :workAuthorized => response[:work_authorized],
+      
+          :attributes! => {
+            :categoryID => {"xsi:type" => "xs:int"},
+            :isDeleted => {"xsi:type" => "xs:boolean"},
+            :isEditable => {"xsi:type" => "xs:boolean"},
+            :ownerID => {"xsi:type" => "xs:int"},
+            :userTypeID => {"xsi:type" => "xs:int"},
+            :isDayLightSavings => {"xsi:type" => "xs:boolean"},
+          }
+        }
+        file_by_candidate.each do |key, value|
+          if (value.class != HashWithIndifferentAccess)
+            candidate[key.camelize(:lower).to_sym] = value if (value && (value != ""))
+          else
+            value.each do |k, v|
+              candidate[key.to_sym][k.to_sym] = v if (v != (nil || "" || " ")) 
+            end    
+          end  
+        end
+        
+        ###--------- Clean up DTO
+        candidate.delete(:attachment)
+        if response.has_key?(:user_id)
+          sum << "has id"
+          sum << (candidate[:userID] = response[:user_id])
+          candidate[:attributes!][:userID] = {"xsi:type" => "xs:int"}
+        else  
+          sum << "no id"
+          candidate[:username] = candidate[:email]
+          sum << candidate[:username]
+          sum << candidate[:lastName]
+          candidate[:password] = "hireminds766"
+        end 
+        [:"@xmlns:xsi", :"@xmlns:ns4", :"@xsi:type", :alerts].each do |key|
+          candidate.delete(key)
+        end  
+        
+        Bullhorn::Candidates.save candidate
+        
+        
+        sum << candidate
+      end  
+      
+      ###---------- Parse a Resume or return nil if parsing fails
+      def parse resume
+        request = {:base64ChunkedResume => resume}
+        response = nil
+        index = 15
+        
+        #--- Bullhorn's parseResume sometimes does't return the proper result.  Keep trying up to index times until captured
+        while index > 0 do
+          index -= 1
+          response = (Bullhorn::Client.parse request).body[:parse_resume_response][:return][:hr_xml]
+          return response if response
+        end 
+        nil
+      end
+        
+   
+    
+      protected
+      
+      def delete_file_request file, entity_id, entity = "Candidate"
+      {
+        :entityName => entity,
+        :entityId => entity_id.to_i,
+        :fileId => file[:id],
+        :attributes! => {
+          :fileId => {"xsi:type" => "xsd:int"},
+          :entityId => {"xsi:type" => "xsd:int"}
+        }
+      }
+      end
+      
+      def get_file_request id, entity_name, entity_id
+      {
+        :entityName => entity_name,
+        :entityId => entity_id,
+        :fileId => id,
+        :attributes! => { 
+          :entity_Id => { "xsi:type" => "xsd:int" }, 
+          :fileId => { "xsi:type" => "xsd:int" }
+          }
+      }
+      end
+      
+      def file_request file, entity_name="Candidate", entity_id=114755
+        {
+          :fileMetaData => {
+            :comments => "Uploaded file",
+            :contentSubType => "",
+            :contentType => file[:content_type],
+            :name => file[:filename],
+            :type => "Resume",
+            },
+          :fileContent => Base64.encode64(file[:document]),
+          :entityName => entity_name,
+          :entityId => entity_id,
+          :attributes! => { :entityId => {"xsi:type" => "xsd:int"}}
+        }
+      end
+      
+      def get_entity_files_request entity_id, entity
+      {
+        :entityName => entity,
+        :entityId => entity_id,
+        :attributes! => { :entityId => {"xsi:type" => "xsd:int"}}
+      }
+      end
+      
+      def save_request file
+      {
+        :dto => file,
+        :attributes! => {
+          :dto => {
+            "xsi:type"=>"ns4:fileDto", 
+            "xmlns:xsi"=>"http://www.w3.org/2001/XMLSchema-instance", 
+            "xmlns:ns4"=>"http://file.entity.bullhorn.com/"
+          }
+        }
+      }  
+      end
+     
+    end
+  end
+end

data/lib/bullhorn/bullhorn/jobs.rb

@@ -0,0 +1,168 @@
+module Bullhorn
+
+  class Jobs
+
+    class << self
+
+      # Get all Jobs
+      def all
+        response = Bullhorn::Client.query open_approved_job_id_request
+        ids = get_ids_from response
+        get_jobs_from ids
+      end
+      
+      # Get Job Description Array from Id Array 
+      def fetch_job_descriptions job_ids
+        get_jobs_from job_ids
+      end  
+      
+      def fetch_job_description job_id
+        get_job_from job_id
+      end  
+      
+      # Get Nested Hash of Category ID's by Job ID
+      def fetch_category_ids_from_job_ids job_ids
+        get_category_ids_from_job_ids job_ids
+      end  
+      
+      def subscribe
+        Bullhorn::Client.eventsSubscribe subscribe_request #[:body][:subscription_meta_data]
+      end
+      
+      def unsubscribe
+        (Bullhorn::Client.eventsUnsubscribe unsubscribe_request).body[:events_unsubscribe_response][:return][:unsubscribed]
+      end
+      
+      def new_events
+        event_response = (Bullhorn::Client.eventsGetEvents get_events_request).body[:events_get_events_response][:return][:results]
+        if event_response
+          if event_response[:events].kind_of?(Array)
+            event_response[:events]
+          else
+            return [event_response[:events]]
+          end
+        else
+          puts "NO EVENTS?"
+        end  
+      end  
+
+      protected
+
+      def open_approved_job_id_request 
+        { :query => { :entityName => "JobOrder", :where => "isOpen=1 AND isPublic=1 AND (status='Accepting Candidates' OR status='Website Only')"} }
+      end
+      
+      def get_category_ids_from_job_ids job_ids
+        responses = []
+        job_ids.each do |job_id|
+          job_id_response = Bullhorn::Client.getAssociationIds category_ids_from_job_id_request(job_id)
+          responses << {job_id => job_id_response.body[:get_association_ids_response][:return][:ids]}
+        end  
+        responses
+      end
+      
+      def get_events_request
+        {
+          :subscriptionId => "JobOrderEvent",
+          :max_events => 2
+        }
+      end  
+      
+      def subscribe_request
+        {
+          :subscriptionId => "JobOrderEvent",
+          :criteria => {
+              :entityNames => "JobOrder",
+              :entityEventTypes => "INSERTED"
+            },
+          :attributes! => {
+              :criteria => {
+                  "xmlns:xsi" => "http://www.w3.org/2001/XMLSchema-instance",
+                  "xmlns:ns4" => "http://subscription.dataevent.bullhorn.com/",
+                  "xsi:type" => "ns4:entityEventSubscriptionCriteria"
+                }
+            }
+        }
+      end
+      
+      def unsubscribe_request
+        {
+          :subscriptionId => "JobOrderEvent"
+        }
+      end
+      
+      def category_ids_from_job_id_request job_id
+        {
+          :entityName => "JobOrder",
+          :id => job_id,
+          :attributes! => { :id => {"xsi:type" => "xsd:int"}},
+          :associationName => "categories"
+          }
+      end
+      
+      def job_detail_request page_of_ids
+        {
+          :entityName => "JobOrder",
+          :ids => page_of_ids,
+          :attributes! => { :ids => { "xsi:type" => "xsd:int" } }
+        }
+      end
+
+      def get_ids_from response
+        response[:query_response][:return][:ids]
+      end
+      
+      def job_detail job
+        {
+          :id => job[:job_order_id].to_i,
+          :title => job[:title], 
+          :years => job[:years_required], 
+          :added => job[:date_added],
+          :description => remove_html(job[:public_description]),
+          :site => job[:on_site],
+          :employment => job[:employment_type],
+          :status => job[:status],
+          :is_open => job[:is_open],
+          :is_public => job[:is_public]
+        }
+      end
+
+      def get_job_details_from page_of_job_results
+        page = page_of_job_results[:find_multiple_response][:return][:dtos]
+        
+      end
+      
+      def remove_html html 
+        html
+        
+      end
+      
+      def get_job_from id
+        job_detail_response = Bullhorn::Client.findMultiple job_detail_request([id])
+        job_detail(get_job_details_from(job_detail_response))
+      end
+      
+      def get_jobs_from ids
+        jobs = []
+        index = 1
+        while ids.page(index) != nil
+          job_detail_response = Bullhorn::Client.findMultiple job_detail_request(ids.page(index))
+          details = get_job_details_from(job_detail_response)
+          
+          details = [details] if !(details.class == Array)
+          puts details
+          details.each do |job|
+            puts job.inspect
+            jobs << job_detail(job) 
+          end 
+          
+          index += 1
+        end
+        
+        
+        
+        jobs
+      end
+    end
+  end
+end

data/lib/bullhorn/bullhorn/util.rb

@@ -0,0 +1,9 @@
+class Array
+  def page(pg, offset = 5)
+    self[((pg-1)*offset)..((pg*offset)-1)]
+  end
+  
+  def smaller_page(pg, offset = 5)
+    self[((pg-1)*offset)..((pg*offset)-1)]
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bullhorn-rails
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
   prerelease: 
 platform: ruby
 authors:
@@ -108,8 +108,17 @@ files:
 - Rakefile
 - VERSION
 - bullhorn-rails-.gem
+- bullhorn-rails-0.1.0.gem
 - bullhorn-rails.gemspec
+- lib/.DS_Store
 - lib/bullhorn-rails.rb
+- lib/bullhorn/bullhorn.rb
+- lib/bullhorn/bullhorn/candidates.rb
+- lib/bullhorn/bullhorn/categories.rb
+- lib/bullhorn/bullhorn/client.rb
+- lib/bullhorn/bullhorn/files.rb
+- lib/bullhorn/bullhorn/jobs.rb
+- lib/bullhorn/bullhorn/util.rb
 - spec/bullhorn-rails_spec.rb
 - spec/spec_helper.rb
 homepage: http://github.com/jthorsen/bullhorn-rails
@@ -127,7 +136,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -1890872409753848389
+      hash: 444463454353317294
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: