business-central 1.0.0

data/lib/business_central/object/helper.rb

@@ -0,0 +1,15 @@
+module BusinessCentral
+  module Object
+    module Helper
+      def object(object_name, *params)
+        define_method(object_name) do |argument=nil|
+          object = "@#{object_name}_cache".to_sym
+          if !instance_variable_defined?(object)
+            instance_variable_set(object, BusinessCentral::Object.const_get("#{object_name.to_s.to_camel_case(true)}".to_sym).new(self, argument))
+          end
+          instance_variable_get(object)
+        end
+      end
+    end
+  end
+end

data/lib/business_central/object/item.rb

@@ -0,0 +1,50 @@
+module BusinessCentral
+  module Object
+    class Item < Base
+      OBJECT = 'items'.freeze
+
+      OBJECT_VALIDATION = {
+        number: {
+          maximum_length: 20
+        },
+        display_name: {
+          maximum_length: 100
+        },
+        type: {
+          required: true,
+          inclusive_of: [
+            'Inventory',
+            'Service',
+            'Non-Inventory'
+          ]
+        },
+        item_category_code: {
+          maximum_length: 20
+        },
+        gtin: {
+          maximum_length: 14
+        },
+        tax_group_code: {
+          maximum_length: 20
+        }
+      }.freeze
+
+      OBJECT_METHODS = [
+        :get,
+        :post,
+        :patch,
+        :delete
+      ].freeze
+
+      def initialize(client, company_id:)
+        super(client, company_id: company_id)
+        @parent_path = [
+          {
+            path: 'companies',
+            id: company_id
+          }
+        ]
+      end
+    end
+  end
+end

data/lib/business_central/object/purchase_invoice.rb

@@ -0,0 +1,77 @@
+module BusinessCentral
+  module Object
+    class PurchaseInvoice < Base
+      OBJECT = 'purchaseInvoices'.freeze
+
+      OBJECT_VALIDATION = {
+        number: {
+          maximum_length: 20
+        },
+        invoice_date: {
+          date: true
+        },
+        vendor_invoice_number: {
+          maximum_length: 35
+        },
+        vendor_number: {
+          maximum_length: 20
+        },
+        vendor_name: {
+          maximum_length: 50
+        },
+        currency_code: {
+          maximum_length: 10
+        },
+        status: {
+          maximum_length: 20,
+          inclusion_of: [
+            'Draft',
+            'In Review',
+            'Open',
+            'Paid',
+            'Canceled',
+            'Corrective. Read-Only'
+          ]
+        },
+        payment_terms: {
+          maximum_length: 10
+        },
+        shipment_method: {
+          maximum_length: 10
+        },
+        pay_to_name: {
+          maximum_length: 100
+        },
+        pay_to_contact: {
+          maximum_length: 100
+        },
+        pay_to_vendor_number: {
+          maximum_length: 20
+        },
+        ship_to_name: {
+          maximum_length: 100
+        },
+        ship_to_contact: {
+          maximum_length: 100
+        }
+      }.freeze
+
+      OBJECT_METHODS = [
+        :get,
+        :post,
+        :patch,
+        :delete
+      ].freeze
+
+      def initialize(client, company_id:)
+        super(client, company_id: company_id)
+        @parent_path = [
+          {
+            path: 'companies',
+            id: company_id
+          }
+        ]
+      end
+    end
+  end
+end

data/lib/business_central/object/purchase_invoice_line.rb

@@ -0,0 +1,41 @@
+module BusinessCentral
+  module Object
+    class PurchaseInvoiceLine < Base
+      OBJECT = 'purchaseInvoiceLines'.freeze
+
+      OBJECT_VALIDATION = {
+        line_type: {
+          inclusion_of: [
+            'Comment',
+            'Account',
+            'Item',
+            'Resource',
+            'Fixed Asset',
+            'Charge'
+          ]
+        }
+      }.freeze
+
+      OBJECT_METHODS = [
+        :get,
+        :post,
+        :patch,
+        :delete
+      ].freeze
+
+      def initialize(client, company_id:, purchase_invoice_id:)
+        super(client, company_id: company_id)
+        @parent_path = [
+          {
+            path: 'companies',
+            id: company_id
+          },
+          {
+            path: 'purchaseInvoices',
+            id: purchase_invoice_id
+          }
+        ]
+      end
+    end
+  end
+end

data/lib/business_central/object/request.rb

@@ -0,0 +1,80 @@
+module BusinessCentral
+  module Object
+    class Request
+
+      def self.get(client, url)
+        request(:get, client, url)
+      end
+
+      def self.post(client, url, params)
+        request(:post, client, url, params: params)
+      end
+
+      def self.patch(client, url, etag, params)
+        request(:patch, client, url, etag: etag, params: params)
+      end
+
+      def self.delete(client, url, etag)
+        request(:delete, client, url, etag: etag)
+      end
+
+      private
+
+      def self.request(method, client, url, etag: '', params: {})
+        send do
+          uri = URI(url)
+          https = Net::HTTP.new(uri.host, uri.port);
+          https.use_ssl = true
+          request = Object.const_get("Net::HTTP::#{method.to_s.capitalize}").new(uri)
+          request['Content-Type'] = 'application/json'
+          request['Accept'] = 'application/json'
+          request['If-Match'] = etag if !etag.blank?
+          request.body = convert(params) if method == :post || method == :patch
+          if client.access_token
+            request['Authorization'] = "Bearer #{client.access_token.token}"
+          else
+            request.basic_auth(client.username, client.password)
+          end
+          https.request(request)
+        end
+      end
+
+      def self.convert(request = {})
+        result = {}
+        request.each do |key, value|
+          result[key.to_s.to_camel_case] = value 
+        end
+
+        return result.to_json
+      end
+
+      def self.send
+        begin
+          request = yield
+          response = Response.new(request.read_body.to_s).results
+
+          if Response.success?(request.code.to_i)
+            return response
+          elsif Response.deleted?(request.code.to_i)
+            return true
+          else
+            if Response.unauthorized?(request.code.to_i)
+              raise UnauthorizedException.new
+            else
+              if response[:error][:code].present?
+                case response[:error][:code]
+                  when  'Internal_CompanyNotFound'
+                    raise CompanyNotFoundException.new
+                  else
+                    raise ApiException.new("#{request.code} - #{response[:error][:code]} #{response[:error][:message]}")
+                end
+              else
+                raise ApiException.new("#{request.code} - API call failed")
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/business_central/object/response.rb

@@ -0,0 +1,60 @@
+module BusinessCentral
+  module Object
+    class Response
+      attr_reader :results
+
+      def initialize(response)
+        @results = nil
+        if !response.blank?
+          @response = JSON.parse(response)
+          if @response.has_key?('value')
+            @response = @response['value']
+          end
+          process
+        end
+      end
+
+      def self.success?(status)
+        status == 200 || status == 201
+      end
+
+      def self.deleted?(status)
+        status == 204
+      end
+
+      def self.unauthorized?(status)
+        status == 401
+      end
+
+      private
+
+      def process
+        if @response.is_a?(Array)
+          @results = []
+          @response.each do |data|
+            @results << convert(data)
+          end
+        elsif @response.is_a?(Hash)
+          @results = convert(@response)
+        end
+      end
+
+      def convert(data)
+        result = {}    
+        data.each do |key, value|
+          if key == "@odata.etag"
+            result[:etag] = value
+          elsif key == "@odata.context"
+            result[:context] = value
+          elsif value.is_a?(Hash)
+            result[key.to_snake_case.to_sym] = convert(value)
+          else
+            result[key.to_snake_case.to_sym] = value
+          end
+        end
+
+        return result
+      end
+    end
+  end
+end

data/lib/business_central/object/validation.rb

@@ -0,0 +1,54 @@
+module BusinessCentral
+  module Object
+    class Validation
+      def initialize(validation_rules, object_params)
+        @validation_rules = validation_rules
+        @object_params = object_params
+        @errors = []
+      end
+
+      def valid?
+        @validation_rules.each do |rules_key, rules_value|
+          rules_value.each do |validation_key, validation_value|
+            if required?(validation_key, validation_value, @object_params[rules_key].to_s)
+              @errors << { field: rules_key, message: 'is a required field'}
+            end
+
+            if exceeds_maximum_length?(validation_key, validation_value, @object_params[rules_key].to_s)
+              @errors << { field: rules_key, message: "has exceeded the maximum length #{validation_value}"}
+            end
+
+            if not_inclusive_of?(validation_key, validation_value, @object_params[rules_key].to_s)
+              @errors << { field: rules_key, message: "is not one of #{validation_value.join(', ')}"}
+            end
+
+            if date_type?(validation_key, validation_value, @object_params[rules_key])
+              @errors << { field: rules_key, message: 'is not a date'}
+            end
+          end
+        end
+
+        raise InvalidObjectException.new(@errors) if @errors.any?
+        return true
+      end
+
+      private
+
+      def required?(validation_rule, validation_value, value)
+        validation_rule == :required && validation_value == true && value.blank?
+      end
+
+      def exceeds_maximum_length?(validation_rule, validation_value, value)
+        validation_rule == :maximum_length && value.length > validation_value
+      end
+
+      def not_inclusive_of?(validation_rule, validation_value, value)
+        validation_rule == :inclusion_of && !validation_value.include?(value) && !value.blank?
+      end
+
+      def date_type?(validation_rule, validation_value, value)
+        validation_rule == :date && validation_value == true && !value.is_a?(Date) && !value.nil?
+      end
+    end
+  end
+end

data/lib/business_central/object/vendor.rb

@@ -0,0 +1,45 @@
+module BusinessCentral
+  module Object
+    class Vendor < Base
+      OBJECT = 'vendors'.freeze
+
+      OBJECT_VALIDATION = {
+        number: {
+          maximum_length: 20
+        },
+        display_name: {
+          maximum_length: 100
+        },
+        phone_number: {
+          maximum_length: 30
+        },
+        email: {
+          maximum_length: 80
+        },
+        website: {
+          maximum_length: 80
+        },
+        tax_registration_number: {
+          maximum_length: 20
+        }
+      }.freeze
+
+      OBJECT_METHODS = [
+        :get,
+        :post,
+        :patch,
+        :delete
+      ].freeze
+
+      def initialize(client, company_id:)
+        super(client, company_id: company_id)
+        @parent_path = [
+          {
+            path: 'companies',
+            id: company_id
+          }
+        ]
+      end
+    end
+  end
+end

data/lib/business_central/version.rb

@@ -0,0 +1,3 @@
+module BusinessCentral
+  VERSION = "1.0.0".freeze
+end

data/lib/core_ext/string.rb

@@ -0,0 +1,25 @@
+class String
+  def blank?
+    empty? || /\A[[:space:]]*\z/.match?(self)
+  end
+
+  # Convert string to CamelCase
+  def to_camel_case(uppercase_first_letter = false)
+    string = self
+    if uppercase_first_letter
+      string = string.sub(/^[a-z\d]*/) { |match| match.capitalize }
+    else
+      string = string.sub(/^(?:(?=\b|[A-Z_])|\w)/) { |match| match.downcase }
+    end
+    string.gsub(/(?:_|(\/))([a-z\d]*)/) { "#{$1}#{$2.capitalize}" }.gsub("/", "::")
+  end
+
+  # Convert string to snake_case
+  def to_snake_case
+    self.gsub(/::/, '/').
+    gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+    gsub(/([a-z\d])([A-Z])/,'\1_\2').
+    tr("-", "_").
+    downcase
+  end
+end