class Bamboozled::API::Employee

Public Instance Methods

add(employee_details) click to toggle source
# File lib/bamboozled/api/employee.rb, line 104
def add(employee_details)
  details = generate_xml(employee_details)
  options = {body: details}

  request(:post, "employees/", options)
end
add_file(employee_id, file_details) click to toggle source
# File lib/bamboozled/api/employee.rb, line 122
def add_file(employee_id, file_details)
  post_file("employees/#{employee_id}/files", file_details)
end
add_table_row(employee_id, table_name, table_row_data) click to toggle source
# File lib/bamboozled/api/employee.rb, line 41
def add_table_row(employee_id, table_name, table_row_data)
  details = generate_xml(table_row_data)
  options = {body: details}
  request(:post, "employees/#{employee_id}/tables/#{table_name}", options)
end
add_time_off_policies(employee_id, policies) click to toggle source
# File lib/bamboozled/api/employee.rb, line 78
def add_time_off_policies(employee_id, policies)
  allowed_keys = %i[timeOffPolicyId accrualStartDate]
  policies = policies.map { |policy| policy.keep_if { |k, _| allowed_keys.include? k } }

  options = {
    body: policies.to_json
  }

  request(:put, "employees/#{employee_id}/time_off/policies", options)
end
all(fields = nil) click to toggle source
# 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
files(employee_id) click to toggle source
# File lib/bamboozled/api/employee.rb, line 118
def files(employee_id)
  request(:get, "employees/#{employee_id}/files/view/")
end
find(employee_id, fields = nil) click to toggle source
# File lib/bamboozled/api/employee.rb, line 19
def find(employee_id, fields = nil)
  fields = FieldCollection.wrap(fields).to_csv

  request(:get, "employees/#{employee_id}?fields=#{fields}&onlyCurrent=false")
end
last_changed(date = "2011-06-05T00:00:00+00:00", type = nil) click to toggle source
# File lib/bamboozled/api/employee.rb, line 25
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) click to toggle source
# File lib/bamboozled/api/employee.rb, line 89
def photo_binary(employee_id)
  request(:get, "employees/#{employee_id}/photo/small")
end
photo_url(employee) click to toggle source
# File lib/bamboozled/api/employee.rb, line 93
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
table_data(employee_id, table_name) click to toggle source
# File lib/bamboozled/api/employee.rb, line 53
def table_data(employee_id, table_name)
  request(:get, "employees/#{employee_id}/tables/#{table_name}")
end
time_off_balance_adjustment(employee_id, params) click to toggle source
# File lib/bamboozled/api/employee.rb, line 62
def time_off_balance_adjustment(employee_id, params)
  allowed_parameters = %i[date timeOffTypeId amount note]
  params = params.keep_if { |k, _| allowed_parameters.include? k }

  options = {
    body: params.to_json,
    headers: { "Content-Type" => "application/json" }
  }

  request(:put, "employees/#{employee_id}/time_off/balance_adjustment", options)
end
time_off_estimate(employee_id, end_date) click to toggle source
# File lib/bamboozled/api/employee.rb, line 57
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
time_off_policies(employee_id) click to toggle source
# File lib/bamboozled/api/employee.rb, line 74
def time_off_policies(employee_id)
  request(:get, "employees/#{employee_id}/time_off/policies", { api_version: 'v1_1' })
end
update(bamboo_id, employee_details) click to toggle source
# File lib/bamboozled/api/employee.rb, line 111
def update(bamboo_id, employee_details)
  details = generate_xml(employee_details)
  options = { body: details }

  request(:post, "employees/#{bamboo_id}", options)
end
update_table_row(employee_id, table_name, row_id, table_row_data) click to toggle source
# File lib/bamboozled/api/employee.rb, line 47
def update_table_row(employee_id, table_name, row_id, table_row_data)
  details = generate_xml(table_row_data)
  options = {body: details}
  request(:post, "employees/#{employee_id}/tables/#{table_name}/#{row_id}", options)
end

Private Instance Methods

generate_xml(employee_details) click to toggle source
# File lib/bamboozled/api/employee.rb, line 128
def generate_xml(employee_details)
  "".tap do |xml|
    xml << "<employee>"
    employee_details.each do |k, v|
      if v.is_a?(Hash)
        value = Integer(v[:value], exception: false) ? v[:value] : v[:value].encode(xml: :text)
        xml <<  "<field id='#{k}' currency='#{v[:currency]}'>#{value}</field>"
      else
        value = Integer(v, exception: false) ? v : v.encode(xml: :text)
        xml << "<field id='#{k}'>#{value}</field>"
      end
    end
    xml << "</employee>"
  end
end