peoplegroup-connectors 0.1.80 → 0.1.84

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1657c1be5b83e1b2d1f0a1e84a3c624a5ab0a83c3225501c3f4d07e38ac7f8c4
-  data.tar.gz: b5a16f29f83019c45e384cbb82b3cf97f67d6684b113073d870ea9d6d3ce4e85
+  metadata.gz: d7b209e2b46bd29b7be1271663fd28481fbe7daacbef93cb3aa03b8dc347fbd3
+  data.tar.gz: 6b706bf6f0832fe48e0c1ef6f87930df6cab343283eda0278107d5de4f17a97c
 SHA512:
-  metadata.gz: cbf02b91924e3bad79e6bcbcd03f9894e41cf28d7778d0e0086f0c9b5e319c880f8cd7b9e1a62fbf0f6f003d79826d352fb238cea291a1968a72bb2983fcabc0
-  data.tar.gz: 4a51bfe8a81f8ebd01c3ed80b5ca638a1a7488634a77c48e8cd50c5459d20c80d4a1232a2843f6e2313b18ddaa4b125209330f04900429ce3bedb85e1adee7aa
+  metadata.gz: 227ca7a129132f47d14dfaea54126658f4f387fa108f7e6cc518f95f27f49467e146e453e6e2c8c5975034b1a0cc60718347b6f40fe64c2e8a0f880b1cb9468b
+  data.tar.gz: 4e391bac4beb51a6342b660ded941cace9a32a48ad2924c1b1ab176aeab663d33b464d7efb06393d559455f97c0edfb387a5299696776dafb12e855744991b78

data/data/email_mapper.yml

@@ -1,7 +1,5 @@
 - slack_email: cristiano
   bamboo_email: ccasella
-- slack_email: kencjohnston
-  bamboo_email: kjohnston
 - slack_email: jmeshell
   bamboo_email: jporter
 - slack_email: mjacob

data/lib/peoplegroup/connectors/hris.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+# The HRIS module makes Workday responses look like BambooHR responses
+module PeopleGroup
+  module Connectors
+    class Hris
+      EmployeeNotFoundError = Class.new(StandardError)
+
+      def initialize
+        @workday = Workday.new
+      end
+
+      def employees
+        @workday.workers.map { |worker| format_worker(worker) }
+      end
+
+      def get_employee_details(id)
+        employees.find { |emp| emp['id'] == id.to_s }
+      end
+      alias_method :get_team_member_details, :get_employee_details
+
+      def get_employee_details!(id)
+        employee_details = get_employee_details(id)
+        raise EmployeeNotFoundError, "No employee found with id #{id}" if employee_details.nil?
+
+        employee_details
+      end
+
+      def get_employee(id)
+        format_worker(@workday.get_worker(id))
+      end
+
+      def get_employee!(id)
+        employee = get_employee(id)
+        raise EmployeeNotFoundError, "No employee found with id #{id}" if employee.nil?
+
+        employee
+      end
+
+      private
+
+      # Convert Workday worker to BambooHR employee
+      def format_worker(worker)
+        return nil if worker.nil?
+
+        {
+          'id' => worker.dig(:worker_data, :worker_id),
+          'firstName' => worker.dig(:worker_data, :personal_data, :name_data, :legal_name_data, :name_detail_data, :first_name),
+          'lastName' => worker.dig(:worker_data, :personal_data, :name_data, :legal_name_data, :name_detail_data, :last_name),
+          'preferredName' => worker.dig(:worker_data, :personal_data, :name_data, :preferred_name_data, :name_detail_data, :first_name),
+          'customPreferredLastName' => worker.dig(:worker_data, :personal_data, :name_data, :preferred_name_data, :name_detail_data, :last_name),
+          **format_emails(worker),
+          'status' => worker.dig(:worker_data, :employment_data, :worker_status_data, :active) == '1' ? 'Active' : 'Inactive',
+          'hireDate' => worker.dig(:worker_data, :employment_data, :worker_status_data, :hire_date).to_s,
+          'jobTitle' => worker.dig(:worker_data, :employment_data, :worker_job_data, :position_data, :position_title)
+        }
+      end
+
+      def format_emails(worker)
+        formatted_emails = {
+          'workEmail' => nil,
+          'homeEmail' => nil
+        }
+
+        email_addresses = worker.dig(:worker_data, :personal_data, :contact_data, :email_address_data)
+
+        return formatted_emails if email_addresses.nil?
+
+        # If there is only one email, Workday returns a hash
+        # If there are more than one, Workday returns an array of hashes
+        # rubocop:disable Style/ArrayCoercion
+        email_addresses = [email_addresses] unless email_addresses.is_a?(Array)
+        # rubocop:enable Style/ArrayCoercion
+
+        email_addresses.each do |email_address_data|
+          email_type = email_address_data.dig(:usage_data, :type_data, :type_reference, :id).second
+          formatted_emails['workEmail'] = email_address_data[:email_address] if email_type == 'WORK'
+          formatted_emails['homeEmail'] = email_address_data[:email_address] if email_type == 'HOME'
+        end
+
+        formatted_emails
+      end
+    end
+  end
+end

data/lib/peoplegroup/connectors/version.rb

@@ -2,6 +2,6 @@
 
 module PeopleGroup
   module Connectors
-    VERSION = '0.1.80'
+    VERSION = '0.1.84'
   end
 end

data/lib/peoplegroup/connectors/workday.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+require 'savon'
+
+module PeopleGroup
+  module Connectors
+    class Workday
+      attr_accessor :client, :subdomain, :tenant
+
+      API_VERSION = 'v37.0'
+      MAX_RESULTS_PER_PAGE = 999
+
+      EmployeeNotFoundError = Class.new(StandardError)
+
+      def initialize
+        @subdomain = ENV['WORKDAY_SUBDOMAIN']
+        @tenant = ENV['WORKDAY_TENANT']
+        isu_username = ENV['WORKDAY_ISU_USERNAME']
+        isu_password = ENV['WORKDAY_ISU_PASSWORD']
+        soap_debug_logs_enabled = ENV['WORKDAY_SOAP_DEBUG_LOGS'].present?
+
+        @client = Savon.client(
+          wsdl: "https://#{@subdomain}.workday.com/ccx/service/#{@tenant}/Human_Resources/#{API_VERSION}?wsdl",
+          log: soap_debug_logs_enabled,
+          wsse_auth: ["#{isu_username}@#{@tenant}", isu_password],
+          pretty_print_xml: true,
+          convert_request_keys_to: :camelcase,
+          env_namespace: :env,
+          namespace_identifier: nil,
+          namespaces: {
+            'xmlns' => nil,
+            'xmlns:env' => 'http://schemas.xmlsoap.org/soap/envelope/',
+            'xmlns:xsd' => 'http://www.w3.org/2001/XMLSchema',
+            'xmlns:wsse' => 'http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd'
+          }
+        )
+      end
+
+      def workers
+        retry_on_error do
+          @workers ||= auto_paginated_call(:get_workers, { message_tag: 'wd:Get_Workers_Request', attributes: attributes })
+        end
+      end
+
+      def get_worker(id)
+        message = {
+          'wd:Request_References' => {
+            'wd:Worker_Reference' => {
+              'wd:ID' => id,
+              attributes!: {
+                'wd:ID' => {
+                  'wd:type' => 'Employee_ID'
+                }
+              }
+            }
+          },
+          attributes!: {
+            'wd:Request_References' => {
+              'wd:Skip_Non_Existing_Instances' => 'true',
+              'wd:Ignore_Invalid_References' => 'true'
+            }
+          }
+        }
+
+        retry_on_error do
+          auto_paginated_call(:get_workers, { message_tag: 'wd:Get_Workers_Request', message: message, attributes: attributes })
+        end
+      end
+
+      private
+
+      def retry_on_error(&block)
+        Utils.retry_on_error(errors: [Net::ReadTimeout], delay: 3, &block)
+      end
+
+      def auto_paginated_call(operation_name, locals = {}, &block)
+        data = nil
+        page = 1
+
+        loop do
+          message = locals[:message] || {}
+          message_with_pagination_parameters = { **message, **pagination_parameters(page) }
+          response = @client.call(operation_name, { **locals, message: message_with_pagination_parameters }, &block)
+
+          # The response hash contains only one key named after the operation performed
+          # eg. get_workers_response
+          _operation_response_name, operation_result = response.to_hash.first
+
+          page = operation_result.dig(:response_results, :page).to_i
+          total_pages = operation_result.dig(:response_results, :total_pages).to_i
+
+          # The operation data hash contains only one key named after the Workday object(s) retrieved
+          # eg. worker
+          _object_label, partial_data = operation_result[:response_data].first
+
+          if page == 1
+            data = partial_data
+          else
+            data.concat(partial_data)
+          end
+
+          break if page == total_pages
+
+          page += 1
+        end
+
+        data
+      end
+
+      def pagination_parameters(page = 1, results_per_page = MAX_RESULTS_PER_PAGE)
+        {
+          'wd:Response_Filter' => {
+            'wd:Page' => page,
+            'wd:Count' => results_per_page
+          }
+        }
+      end
+
+      def attributes
+        {
+          'xmlns:wd' => 'urn:com.workday/bsvc',
+          'wd:version' => API_VERSION
+        }
+      end
+    end
+  end
+end

data/lib/peoplegroup/connectors.rb

@@ -7,6 +7,8 @@ require_relative 'connectors/slack'
 require_relative 'connectors/pto_roots'
 require_relative 'connectors/bamboo'
 require_relative 'connectors/greenhouse'
+require_relative 'connectors/workday'
+require_relative 'connectors/hris'
 require_relative 'utils'
 
 module PeopleGroup

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: peoplegroup-connectors
 version: !ruby/object:Gem::Version
-  version: 0.1.80
+  version: 0.1.84
 platform: ruby
 authors:
 - lien van den steen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-11 00:00:00.000000000 Z
+date: 2022-01-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gitlab
@@ -94,6 +94,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: savon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.12.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.12.1
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -179,9 +193,11 @@ files:
 - lib/peoplegroup/connectors/gitlab.rb
 - lib/peoplegroup/connectors/google_sheets.rb
 - lib/peoplegroup/connectors/greenhouse.rb
+- lib/peoplegroup/connectors/hris.rb
 - lib/peoplegroup/connectors/pto_roots.rb
 - lib/peoplegroup/connectors/slack.rb
 - lib/peoplegroup/connectors/version.rb
+- lib/peoplegroup/connectors/workday.rb
 - lib/peoplegroup/utils.rb
 homepage: https://gitlab.com/gitlab-com/people-group/peopleops-eng/connectors-gem
 licenses: