Class: Bamboozled::API::Employee

Inherits:
Base
  • Object
show all
Defined in:
lib/bamboozled/api/employee.rb

Instance Attribute Summary

Attributes inherited from Base

#api_key, #subdomain

Instance Method Summary collapse

Methods inherited from Base

#initialize

Constructor Details

This class inherits a constructor from Bamboozled::API::Base

Instance Method Details

#add(employee_details) ⇒ Object 



66
67
68
69
70
71
 
# File 'lib/bamboozled/api/employee.rb', line 66

def add(employee_details)
  details = generate_xml(employee_details)
  options = {body: details}

  request(:post, "employees/", options)
end

#all(fields = nil) ⇒ Object 



5
6
7
8
9
10
11
12
13
14
15
16
17
 
# File 'lib/bamboozled/api/employee.rb', line 5

def all(fields = nil)
  response = request(:get, "employees/directory")

  if fields.nil? || fields == :default
    Array(response['employees'])
  else
    employees = []
    response['employees'].map{|e| e['id']}.each do |id|
      employees << find(id, fields)
    end
    employees
  end
end

#all_fields ⇒ Object 



47
48
49
 
# File 'lib/bamboozled/api/employee.rb', line 47

def all_fields
  %w(address1 address2 age bestEmail birthday city country dateOfBirth department division eeo employeeNumber employmentHistoryStatus ethnicity exempt firstName flsaCode fullName1 fullName2 fullName3 fullName4 fullName5 displayName gender hireDate homeEmail homePhone id jobTitle lastChanged lastName location maritalStatus middleName mobilePhone nickname payChangeReason payGroup payGroupId payRate payRateEffectiveDate payType ssn sin state stateCode status supervisor supervisorId supervisorEId terminationDate workEmail workPhone workPhonePlusExtension workPhoneExtension zipcode photoUploaded rehireDate standardHoursPerWeek bonusDate bonusAmount bonusReason bonusComment commissionDate commisionDate commissionAmount commissionComment).join(',')
end

#find(employee_id, fields = nil) ⇒ Object 



19
20
21
22
23
24
 
# File 'lib/bamboozled/api/employee.rb', line 19

def find(employee_id, fields = nil)
  fields = all_fields if fields == :all
  fields = fields.join(',') if fields.is_a?(Array)

  request(:get, "employees/#{employee_id}?fields=#{fields}")
end

#last_changed(date = "2011-06-05T00:00:00+00:00", type = nil) ⇒ Object 



26
27
28
29
30
31
32
33
 
# File 'lib/bamboozled/api/employee.rb', line 26

def last_changed(date = "2011-06-05T00:00:00+00:00", type = nil)
  query = Hash.new
  query[:since] = date.respond_to?(:iso8601) ? date.iso8601 : date
  query[:type] = type unless type.nil?

  response = request(:get, "employees/changed", query: query)
  response["employees"]
end

#photo_binary(employee_id) ⇒ Object 



51
52
53
 
# File 'lib/bamboozled/api/employee.rb', line 51

def photo_binary(employee_id)
  request(:get, "employees/#{employee_id}/photo/small")
end

#photo_url(employee) ⇒ Object 



55
56
57
58
59
60
61
62
63
64
 
# File 'lib/bamboozled/api/employee.rb', line 55

def photo_url(employee)
  if (Float(employee) rescue false)
    e = find(employee, ['workEmail', 'homeEmail'])
    employee = e['workEmail'].nil? ? e['homeEmail'] : e['workEmail']
  end

  digest = Digest::MD5.new
  digest.update(employee.strip.downcase)
  "http://#{@subdomain}.bamboohr.com/employees/photos/?h=#{digest}"
end

#time_off_estimate(employee_id, end_date) ⇒ Object 



42
43
44
45
 
# File 'lib/bamboozled/api/employee.rb', line 42

def time_off_estimate(employee_id, end_date)
  end_date = end_date.strftime("%F") unless end_date.is_a?(String)
  request(:get, "employees/#{employee_id}/time_off/calculator?end=#{end_date}")
end

#update(bamboo_id, employee_details) ⇒ Object 



73
74
75
76
77
78
 
# File 'lib/bamboozled/api/employee.rb', line 73

def update(bamboo_id, employee_details)
  details = generate_xml(employee_details)
  options = { body: details }

  request(:post, "employees/#{bamboo_id}", options)
end