peoplegroup-connectors 0.1.79 → 0.1.83

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 385d25f529fc9ed922a8c747c4ccae2fedee02e72cdb5f22970f0286c915513b
-  data.tar.gz: 3c6ea2c367e42dd265a9bb807fcb1d6a692a34d74e9c14eb355ce08ce6992864
+  metadata.gz: cca763ed8852ce618ef4c82006488515f46a562ab9ec1b286a84391dfa3c4565
+  data.tar.gz: 0a433378f060adb81dbfb5dc4d27260ba16c61206a6fd29d182091ed3709f6b2
 SHA512:
-  metadata.gz: 9e6adf1ba7564a492ec135196b288f067b1402e2180aff5967c11f971fb384aeadd128da9b0b221edd42a9bdf69f64c0a080c0cd5663df69e63da9565bee239d
-  data.tar.gz: 1f43250b83cf8108fcbf5a417632494ca5c8d530a893cac6a5e9fa3c33ceffd98d1f37a355f6bb10a2851ff123f20444ba50be7e0db6c44ea6a06fe15c38463c
+  metadata.gz: 2af490e0c3e0d8156ba79a8e99e0e06a04308f0bb9fd499bea7650b2067e7b5174e161f310c7825ed5cd4a2bba47cca3c1dfe63b33f661823c96492d90118955
+  data.tar.gz: 14ceec93579b4370fd7eb6189ce2ebba9ace211ab98798ce2841b311605c57996c4139d2ee4b76f4e3e1ed6df97c7443102bb1ab774a473ca4f08553649060d4

data/data/email_mapper.yml

@@ -6,3 +6,5 @@
   bamboo_email: jporter
 - slack_email: mjacob
   bamboo_email: mgomez
+- slack_email: nprecilla
+  bamboo_email: ngarcia

data/lib/peoplegroup/connectors/gitlab.rb

@@ -84,7 +84,7 @@ module PeopleGroup
       end
 
       def update_variable(project, key, value, **opts)
-        retry_on_error { @client.update_variable(project, key, value, opts) }
+        retry_on_error { @client.update_variable(project, key, value, **opts) }
       end
 
       def find_or_create_epic(group_id, title, options = {})

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.79'
+    VERSION = '0.1.83'
   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.79
+  version: 0.1.83
 platform: ruby
 authors:
 - lien van den steen
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-10-25 00:00:00.000000000 Z
+date: 2021-12-07 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:
@@ -190,7 +206,7 @@ metadata:
   homepage_uri: https://gitlab.com/gitlab-com/people-group/peopleops-eng/connectors-gem
   source_code_uri: https://gitlab.com/gitlab-com/people-group/peopleops-eng/connectors-gem
   changelog_uri: https://gitlab.com/gitlab-com/people-group/peopleops-eng/connectors-gem
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -205,8 +221,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
-signing_key:
+rubygems_version: 3.2.3
+signing_key: 
 specification_version: 4
 summary: Library for our shared connectors.
 test_files: []