rnsap 0.4.12 → 0.4.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b35aa190956b167918511e84b534034701cdea79ee940424591e60ed68a7d96
-  data.tar.gz: 23a084ebde89a980aa0fe853441bce758aff0b38a95c6c5f7763eb1efd1c3120
+  metadata.gz: 518529f9e547d8d03ddb437b6d47c252f4308cf041ba4433abdca14c5b996e4a
+  data.tar.gz: 9386f9252f74b52f5a8c428829903492001b75db909f072021833d2e21121851
 SHA512:
-  metadata.gz: 16f4f3ea24bcd5ba41a4b7286c452bbef39a62ed209cdaac55e04800d5ebf7cc2c38d8c41fa7fddb9db08513d03d72873147a9fcc6a051f26b81e0ab652272b7
-  data.tar.gz: 643ac428662750cf029c6b1e69febfc9180cd9318e1014e1f13359d788c996014416429091db7c20766a9ed13065e1959f4d14fa734b5e6e02341488683b181b
+  metadata.gz: 7227e483f630884901000f031f846b97f24b4d9697362c534a29707dcb80cd0a95881bd16ce99165959f70e45a4b5eb65feb959048928b5f3408126222fd5fec
+  data.tar.gz: 60b5d19b5f5a3b0cfb4e21a1daddfcda9ce8c048496dfe3566236fc0ef4e8bf14b5525e4b55a84d83a59acc46fc7e2d2fb049450f96793632b908532f90e9216

data/lib/auth.rb

@@ -0,0 +1,131 @@
+# Class to handle authorization related SAP information
+# @author Rogerio Nascimento (26/03/2021)
+class Auth
+
+  # Return a list of users with authorization 
+  # for an object
+  # @param json containing authorization object and optionaly
+  #        the tuples with field and value to be checked
+  # @return [Array] an array of strings with the list of users 
+  def self.for_object(*options)
+    users = []
+    conn, obj, field1, value1, field2, value2 = validate_options(options)
+    return users unless conn && obj
+
+    ## Busca o AUTH na tabela UST12
+    ust12_list = Auth.auth_list(conn, obj, field1, value1, field2, value2)
+    return users unless ust12_list
+
+    ## Busca o PROFN na tabela UST10S
+    ust10s_list = Auth.profile_list(conn, obj, ust12_list)
+
+    ## Busca os Usuários na tabela UST04
+    Auth.user_list(conn, obj, ust10s_list)
+  end
+
+  #
+  # Select Authorization roles for the Profile
+  # @param list List of profiles to be searched
+  # @return Array<string> with list of authorizations
+  def self.profiles_for_composite(conn, list = [])
+    return [] if list.empty?
+
+    fname = conn.conn.get_function('SIAG_PROF_GET_AUTH')
+    fcall = fname.get_function_call
+
+    fcall[:IV_PROFILE_TYPE] = 'C'
+    list.each do |prof|
+      row = fcall[:IT_PROFILE_RANGE].new_row
+      row[:SIGN] = 'I'
+      row[:OPTION] = 'EQ'
+      row[:LOW] = prof
+    end
+
+    fcall.invoke
+
+    ret = []
+    fcall[:ET_COMPOSITE_PROFILE].each do |row|
+      ret.push(row[:SINGLE_PROFILE])
+    end
+
+    ret
+  end
+
+
+  private 
+
+  def self.validate_options(options)
+    return [] if options.empty?
+    params = options.first
+
+    conn = params[:conn]
+    obj = params[:obj]
+
+    return [] unless conn && obj
+    return [] unless conn.class.name == 'RnSap::Sap'
+
+    field1 = params[:field1]
+    value1 = params[:value1]
+    field2 = params[:field2]
+    value2 = params[:value2]
+
+    [conn, obj, field1, value1, field2, value2]
+  end
+
+  def self.auth_list( conn, obj, field1, value1, field2, value2)
+    
+    fields = ['AUTH']
+    filter = ["OBJCT = '#{obj}' "]
+    if field1 && value1
+      filter.push(" AND ( FIELD = '#{field1}' AND ( VON = '*' OR VON = '#{value1}' ) ")
+      if field2 && value2
+        filter.push(" OR FIELD = '#{field2}' AND ( VON = '*' OR VON = '#{value2}' ) )")
+      else
+        filter.push( ')')
+      end
+    end  
+
+    conn.read_table('UST12', fields, filter)
+  end
+
+  def self.profile_list( conn, obj, ust12_list)
+    sap_all = 'SAP_ALL'
+    profiles = Auth.profiles_for_composite(conn, [sap_all])
+    profiles.push(sap_all)
+
+    fields = ['PROFN']
+    filter = ["OBJCT = '#{obj}' AND AUTH IN ("]
+    profiles.each do |prof|
+      filter.push( "'#{prof}'  ,  ")
+    end
+    ust12_list.each do |ust|
+      filter.push( "'#{ust.auth}'  ,  ")
+    end
+    filter = filter.uniq
+
+    new_last = "#{filter.last[0..(filter.last.length - 4)]} )"
+    filter = filter[0..-1].push(new_last)
+
+    conn.read_table('UST10S', fields, filter)
+  end
+
+  def self.user_list(conn, obj, ust10s_list)
+    users = []
+    fields = ['BNAME']
+    filter = ['PROFILE IN (']
+    filter.push("'SAP_ALL' ,  ")
+    ust10s_list.each do |ust|
+      filter.push("'#{ust.profn}' ,  ")
+    end
+    new_last = "#{filter.last[0..(filter.last.length - 4)]} )"
+    filter = filter[0..-1].push(new_last)
+
+    ust04_list = conn.read_table('UST04', fields, filter)
+
+    ust04_list.each do |ust|
+      users.push( ust.bname )
+    end
+
+    users.uniq.sort
+  end
+end

data/lib/currency.rb

@@ -0,0 +1,35 @@
+class Currency
+
+  def self.convert_amount_from_to(conn, amount, from_curr, to_curr, date)
+    convert_currency_amount({conn: conn, amount: amount, from_curr: from_curr, to_curr: to_curr, date: date})
+  end
+  def self.convert_currency_amount(*options)
+    
+    return 0.0 unless options
+    return 0.0 unless options.class == Array
+
+    params = options.first
+
+    rate_type = params[:rate_type] ? params[:rate_type] : 'M'
+    date = params[:date] ? params[:date] : Date.today
+    conn = params[:conn]
+    from_curr = params[:from_curr]
+    to_curr = params[:to_curr]
+    amount = params[:amount]
+
+    return 0.0 unless (conn && from_curr && to_curr && amount)
+
+    fname = conn.conn.get_function('RPM_CONVERT_CURRENCY_AMOUNT')
+    fcall = fname.get_function_call
+
+    fcall[:IV_RATE_TYPE] = rate_type
+    fcall[:DATE] = date
+    fcall[:IV_FROM_CURR] = from_curr
+    fcall[:IV_TO_CURR] = to_curr
+    fcall[:IV_AMOUNT] = amount
+
+    fcall.invoke
+    
+    fcall[:EV_AMOUNT].to_f
+  end
+end

data/lib/preq_release_items/all.rb

@@ -0,0 +1 @@
+require 'preq_release_items/requisition_items'

data/lib/preq_release_items/requisition_items.rb

@@ -0,0 +1,174 @@
+ class RequisitionItems
+ 	# @return [String] Purchase Requisition Number
+	attr_accessor :preq_no
+	# @return [Integer] Item number of purchase requisition
+	attr_accessor :preq_item
+	# @return [String] Purchase Requisition Document Type
+	attr_accessor :doc_type
+	# @return [String] Purchasing Group
+	attr_accessor :pur_group
+	# @return [String] Name of Person Who Created the Object
+	attr_accessor :created_by
+	# @return [String] Name of requisitioner/requester
+	attr_accessor :preq_name
+	# @return [Date] Requisition (Request) Date
+	attr_accessor :preq_date
+	# @return [String] Short Text
+	attr_accessor :short_text
+	# @return [String] Material Number
+	attr_accessor :material
+	# @return [String] Material number corresponding to manufacturer part number
+	attr_accessor :pur_mat
+	# @return [String] Plant
+	attr_accessor :plant
+	# @return [String] Storage Location
+	attr_accessor :store_loc
+	# @return [String] Requirement Tracking Number
+	attr_accessor :trackingno
+	# @return [String] Material Group
+	attr_accessor :mat_grp
+	# @return [String] Supplying (issuing) plant in case of stock transport order
+	attr_accessor :suppl_plnt
+	# @return [Float] Purchase requisition quantity
+	attr_accessor :quantity
+	# @return [Integer] Purchase requisition unit of measure
+	attr_accessor :unit
+	# @return [String] Date type (day, week, month, interval)
+	attr_accessor :del_datcat
+	# @return [Date] Item delivery date
+	attr_accessor :deliv_date
+	# @return [Date] Purchase Requisition Release Date
+	attr_accessor :rel_date
+	# @return [Float] Goods receipt processing time in days
+	attr_accessor :gr_pr_time
+	# @return [Float] Price in purchase requisition
+	attr_accessor :c_amt_bapi
+	# @return [Float] Price unit
+	attr_accessor :price_unit
+	# @return [String] Item category in purchasing document
+	attr_accessor :item_cat
+	# @return [String] Account Assignment Category
+	attr_accessor :acctasscat
+	# @return [String] Distribution indicator for multiple account assignment
+	attr_accessor :distrib
+	# @return [String] Partial invoice indicator
+	attr_accessor :part_inv
+	# @return [String] Goods Receipt Indicator
+	attr_accessor :gr_ind
+	# @return [String] Goods Receipt, Non-Valuated
+	attr_accessor :gr_non_val
+	# @return [String] Invoice receipt indicator
+	attr_accessor :ir_ind
+	# @return [String] Required Vendor
+	attr_accessor :des_vendor
+	# @return [String] Fixed vendor
+	attr_accessor :fixed_vend
+	# @return [String] Purchasing Organization
+	attr_accessor :purch_org
+	# @return [String] Number of principal purchase agreement
+	attr_accessor :agreement
+	# @return [Integer] Item number of principal purchase agreement
+	attr_accessor :agmt_item
+	# @return [String] Number of purchasing info record
+	attr_accessor :info_rec
+	# @return [String] Number of quota arrangement
+	attr_accessor :quota_arr
+	# @return [Integer] Quota arrangement item
+	attr_accessor :quotarritm
+	# @return [String] MRP Controller
+	attr_accessor :mrp_contr
+	# @return [String] BOM explosion number
+	attr_accessor :bomexpl_no
+	# @return [Date] Date of last resubmission
+	attr_accessor :last_resub
+	# @return [Float] Resubmission interval of purchase requisition
+	attr_accessor :resubmis
+	# @return [Float] Number of resubmissions
+	attr_accessor :no_resub
+	# @return [String] Valuation Type
+	attr_accessor :val_type
+	# @return [String] Special Stock Indicator
+	attr_accessor :spec_stock
+	# @return [Integer] Purchase Order Unit of Measure
+	attr_accessor :po_unit
+	# @return [String] Revision level
+	attr_accessor :rev_lev
+	# @return [Integer] Package number
+	attr_accessor :pckg_no
+	# @return [String] Kanban indicator
+	attr_accessor :kanban_ind
+	# @return [String] Use Requisition Price in Purchase Order
+	attr_accessor :po_price
+	# @return [Integer] Configuration (internal object number)
+	attr_accessor :int_obj_no
+	# @return [String] Promotion
+	attr_accessor :promotion
+	# @return [String] Batch Number
+	attr_accessor :batch
+	# @return [String] Material number used by vendor
+	attr_accessor :vend_mat
+	# @return [Float] Quantity ordered against this purchase requisition
+	attr_accessor :ordered
+	# @return [String] Currency Key
+	attr_accessor :currency
+	# @return [String] Mfr part profile
+	attr_accessor :manuf_prof
+	# @return [String] Manufacturer Part Number
+	attr_accessor :manu_mat
+	# @return [String] Manufacturer number
+	attr_accessor :mfr_no
+	# @return [String] External manufacturer code name or number
+	attr_accessor :mfr_no_ext
+	# @return [String] Category of delivery date
+	attr_accessor :del_datcat_ext
+	# @return [String] ISO Currency Code
+	attr_accessor :currency_iso
+	# @return [String] Item Category in Purchasing Document
+	attr_accessor :item_cat_ext
+	# @return [String] ISO code for unit of measure in purchase requisition
+	attr_accessor :preq_unit_iso
+	# @return [String] Order unit in ISO code
+	attr_accessor :po_unit_iso
+	# @return [String] Overall release of purchase requisitions
+	attr_accessor :general_release
+	# @return [String] Long Material Number for MATERIAL Field
+	attr_accessor :material_external
+	# @return [String] External GUID for MATERIAL Field
+	attr_accessor :material_guid
+	# @return [String] Version Number for MATERIAL Field
+	attr_accessor :material_version
+	# @return [String] Long Material Number for PUR_MAT Field
+	attr_accessor :pur_mat_external
+	# @return [String] External GUID for PUR_MAT Field
+	attr_accessor :pur_mat_guid
+	# @return [String] Version Number for PUR_MAT Field
+	attr_accessor :pur_mat_version
+	# @return [String] Purchase Requisition Blocked
+	attr_accessor :req_blocked
+	# @return [String] Reason for Item Block
+	attr_accessor :reason_blocking
+	# @return [String] Procuring Plant
+	attr_accessor :procuring_plant
+	# @return [String] Commitment Item
+	attr_accessor :cmmt_item
+	# @return [String] Funds Center
+	attr_accessor :funds_ctr
+	# @return [String] Fund
+	attr_accessor :fund
+	# @return [String] Document number for earmarked funds
+	attr_accessor :res_doc
+	# @return [Integer] Earmarked Funds: Document Item
+	attr_accessor :res_item
+	# @return [String] Functional Area
+	attr_accessor :func_area
+	# @return [String] Grant
+	attr_accessor :grant_nbr
+	# @return [String] Obsolete
+	attr_accessor :fund_long
+	# @return [String] FM: Budget Period
+	attr_accessor :budget_period
+	# @return [String] Material Number (40 Characters, needed f. technical reasons)
+	attr_accessor :material_long
+	# @return [String] Material number corresponding to MPN (technically required)
+	attr_accessor :pur_mat_long
+ end

data/lib/rnsap.rb

@@ -2,11 +2,14 @@
 
 require 'nwrfc'
 require 'read_table/table_column'
+require 'auth'
+require 'currency'
 
 require 'return'
 
 require 'preq_detail/all'
 require 'preq_release_info/all'
+require 'preq_release_items/all'
 
 require 'po_detail/all'
 require 'po_release_info/all'
@@ -161,6 +164,7 @@ module RnSap
             value = wa[pos].to_f
             eval("obj.#{field} = #{value}")
           elsif DATE_TYPES.include?(column.type)
+            value = wa[pos]
             if value.nil? || value == '00000000'
               eval("obj.#{field} = nil")
             else
@@ -298,6 +302,29 @@ module RnSap
       end
     end
 
+    def preq_release_items(group = '', code = '')
+      fname = @conn.get_function('BAPI_REQUISITION_GETITEMSREL')
+      fcall = fname.get_function_call
+
+      fcall[:REL_GROUP] = group
+      fcall[:REL_CODE] = code
+      fcall[:ITEMS_FOR_RELEASE] = 'X'
+
+      fcall.invoke
+
+      tb_return = get_object_list(fcall[:RETURN], Return)
+      requisition_items = get_object_list(fcall[:REQUISITION_ITEMS], RequisitionItems)
+
+      retcode = tb_return.detect{|r| r.type == 'E'} 
+
+      if retcode
+        api_return_error(retcode)
+      else
+        api_return_success(requisition_items)
+      end
+
+    end
+
     def po_detail(po = 0, acc_assignment = "", item_text = "", header_text = "", delivery_address = "", version = "", services = "", serialnumbers = "", invoiceplan = "")
       #-- Execute BAPI_PO_GETDETAIL1
       fn_po_detail = @conn.get_function('BAPI_PO_GETDETAIL1')
@@ -440,6 +467,43 @@ module RnSap
 
     end
 
+    ##
+    # Gets a list of users with authorization for a given
+    # authorization object and content
+    # @params:
+    # - obj [String] SAP authorization Object
+    #                   Ex: for Purchase Requisitions M_EINK_FRG
+    # - field1 [String] Object authorization's field. 
+    #                   Ex: for Release Group FRGGR
+    # - value1 [String] Field Value
+    #                   Ex: any valid Release Group in the instalation
+    # - field2 [String] Object authorization's field. 
+    #                   Ex: for Release Code FRGCO
+    # - value2 [String] Field Value
+    #                   Ex: any valid Release Code in the instalation
+    # @return [Array] Array of strings with the SAP userids
+    def users_for_auth_object(obj, field1, value1, field2, value2)
+      Auth.for_object(
+        conn: self, 
+        obj: obj, 
+        field1: field1, 
+        value1: value1, 
+        field2: field2, 
+        value2: value2,
+      )
+    end
+
+    def currency_conversion(amount = 0.0, from_curr = 'EUR', to_curr = 'USD', date = Date.today)
+      Currency.convert_currency_amount(
+        conn: self, 
+        amount: amount, 
+        from_curr: from_curr, 
+        to_curr: to_curr, 
+        date: date
+      )
+    end
+    
+
     def api_return_success(obj=nil )
       UtilHelper.api_return(0, 'Success!', obj)
     end
@@ -452,10 +516,11 @@ module RnSap
       UtilHelper.api_return(rc, message, obj, exception)
     end
 
-    private
 
+    private
     attr_writer :conn
 
+  
     # Dumps to the output the content of an object
     def dump_instance_variables(obj)
       puts "Class: #{obj.class} -> #{obj}"
@@ -464,6 +529,8 @@ module RnSap
       end
     end
 
+    KLASS_LIST = {}
+
     # Dynamically returns a class instance with the name 'name' and with each
     # of its fields as an attribute
     # @param name [String] name of the intended class instance
@@ -471,7 +538,13 @@ module RnSap
     # @return [Object] instance of the object 'Name'
     def get_class_instance(name, fields)
       # puts "Class name: #{name}"
-      klass = Object.const_set(name, Class.new).new # , Struct.new(*attributes)
+      pre_created = KLASS_LIST[name]
+      if pre_created
+        klass = pre_created.new
+      else
+        KLASS_LIST[name] = Object.const_set(name, Class.new)
+        klass = KLASS_LIST[name].new # , Struct.new(*attributes)
+      end
       fields.each do |field|
         klass.class.module_eval { attr_accessor field.downcase }
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rnsap
 version: !ruby/object:Gem::Version
-  version: 0.4.12
+  version: 0.4.17
 platform: ruby
 authors:
 - Rogerio Nascimento
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-03-26 00:00:00.000000000 Z
+date: 2021-04-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nwrfc
@@ -38,13 +38,15 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: By encapsulating SAPs NW RFC library calls, Ruby routines can access
-  SAP power in a simpler manner
+description: By encapsulating SAPs NW RFC library calls, Ruby routines achieve SAP
+  bunsiness functionalitys power in a simpler manner
 email:
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- lib/auth.rb
+- lib/currency.rb
 - lib/helper/rfc_helper.rb
 - lib/helper/util_helper.rb
 - lib/po_detail/all.rb
@@ -91,6 +93,8 @@ files:
 - lib/preq_release_info/preq_release_final.rb
 - lib/preq_release_info/preq_release_posted.rb
 - lib/preq_release_info/preq_release_prerequisites.rb
+- lib/preq_release_items/all.rb
+- lib/preq_release_items/requisition_items.rb
 - lib/read_table/table_column.rb
 - lib/return.rb
 - lib/rnsap.rb
@@ -118,5 +122,5 @@ requirements: []
 rubygems_version: 3.2.3
 signing_key:
 specification_version: 4
-summary: Facilitates SAP RFC calls in Ruby
+summary: Encapsulates SAP RFC calls in Ruby
 test_files: []