business-central 1.0.1 → 1.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a33078b9f42de6667181a50991b793edcc2bdedb118be70e26fdfe9224e23ba6
-  data.tar.gz: cd67e00b86499bc25fa912a8ff662991c809f13add9f892611591e45e04453bf
+  metadata.gz: 8a9fce53948fe9fcc7fead040e9f2a3c11df882dc59ebe5db8add78fe4b9c396
+  data.tar.gz: 34c62baa8d371b776fae566c97c935467c7c3ee86cd2d3d36c4a22824257c16e
 SHA512:
-  metadata.gz: 1e2616ef4f1cb78780924fe1741dcceb97ab02460b0838dccc0f94eb1fd990a4c1a8ac72e6a4a87a1189c1834557fa2efa0755f207eb6aa399d815802f663374
-  data.tar.gz: 5d3a27c2fcfcaaabb52832382a90d74527fdb8c5c5adf4cda26c5e2be48b52a5bcda500b8733eb52406c8f3be8c958379c833a3571aca4954f8b0e51a13f627e
+  metadata.gz: 2d2acefa8f9086e59343fa0d25ff74f3c9782f20ac719983c5fcbc958ccaaf15fdd1ff28c9defd087d096ed89eb4ecc990c2a1e5e815f24f49217defba06fae3
+  data.tar.gz: f0978a52503c33b618a8d8a6df09c112dc0d4457c3665d67945de478d8ceb5e5e84a9b216d8190f016be62da92b2e5d521890f0532bc4a4d0bd1ee69aa91edfa

data/README.md

@@ -26,6 +26,22 @@ This gem supports both authentication methods:
 
 https://docs.microsoft.com/en-us/dynamics-nav/api-reference/v1.0/endpoints-apis-for-dynamics
 
+```Ruby
+require 'business_central'
+
+client = BusinessCentral::Client.new(
+    username: '<username>',                 # Basic authentication username
+    password: '<password>',                 # Basic authentication password
+    url: '<url>',                           # URL for API defaults to https://api.businesscentral.dynamics.com/v2.0/production/api/v1.0
+    web_service_url: '<url>',               # URL for custom web services defaults to https://api.businesscentral.dynamics.com/v2.0/production/ODataV4 
+    application_id: '<application_id>',     # Oauth2 authentication application ID
+    secret_key: '<application_secret_key>', # OAuth2 authentication application secret key
+    oauth2_login_url: '<url>',              # OAuth2 authentication login URL defaults to https://login.microsoftonline.com/common
+    default_company_id: '<company_id>',     # Default company ID used in all requests (if required)
+    debug: false                            # Output requests to console
+)
+```
+
 ### Basic Authentication:
 
 https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-develop-connect-apps#setting-up-basic-authentication
@@ -36,26 +52,27 @@ require 'business_central'
 client = BusinessCentral::Client.new(
     username: '<username>',
     password: '<password>',
-    url: '<url>'
+    url: '<url>',
+    default_company_id: '11111111-2222-3333-4444-555555555555'
 )
 
 # Find all vendors
-vendors = client.vendor(company_id: '3a502065-2a08-4c3b-9468-fb83642d3d3a').find_all
+vendors = client.vendor.all
 
 # Find vendor by ID
-vendor = client.vendor(company_id: '3a502065-2a08-4c3b-9468-fb83642d3d3a').find_by_id('3f445b08-2ffd-4f9d-81a0-b82f0d9714c4')
+vendor = client.vendor.find('3f445b08-2ffd-4f9d-81a0-b82f0d9714c4')
 
 # Query vendor by display name
-vendor = client.vendor(company_id: '3a502065-2a08-4c3b-9468-fb83642d3d3a').where("displayName eq 'First Up Consultants'")
+vendor = client.vendor.where("displayName eq 'First Up Consultants'")
 
 # Create a new vendor
-vendor = client.vendor(company_id: '3a502065-2a08-4c3b-9468-fb83642d3d3a').create({ display_name: 'hello testing new vendor' })
+vendor = client.vendor.create({ display_name: 'hello testing new vendor' })
 
 # Update an existing vendor by ID
-vendor = client.vendor(company_id: '3a502065-2a08-4c3b-9468-fb83642d3d3a').update('3f445b08-2ffd-4f9d-81a0-b82f0d9714c4', { phone_number: '1112' })
+vendor = client.vendor.update('3f445b08-2ffd-4f9d-81a0-b82f0d9714c4', { phone_number: '1112' })
 
 # Delete a vendor
-client.vendor(company_id: '3a502065-2a08-4c3b-9468-fb83642d3d3a').destroy('f0730ada-b315-ea11-a813-000d3ad21e99')
+client.vendor.destroy('f0730ada-b315-ea11-a813-000d3ad21e99')
 ```
 
 ### Oauth2 Authentication
@@ -67,10 +84,10 @@ require 'business_central'
 
 # Create client - used to connect to the API
 client = BusinessCentral::Client.new(
-    tenant_id: '<tenant_id>',
     application_id: '<application_id>',
     secret_key: '<application_secret_key>',
-    url: '<url>'
+    url: '<url>',
+    default_company_id: '11111111-2222-3333-4444-555555555555'
 )
 
 # Controller endpoint 1
@@ -87,22 +104,48 @@ client.authorize_from_token(
 )
 
 # Find all vendors
-vendors = client.vendor(company_id: '3a502065-2a08-4c3b-9468-fb83642d3d3a').find_all
+vendors = client.vendor.all
 
 # Find vendor by ID
-vendor = client.vendor(company_id: '3a502065-2a08-4c3b-9468-fb83642d3d3a').find_by_id('3f445b08-2ffd-4f9d-81a0-b82f0d9714c4')
+vendor = client.vendor.find('3f445b08-2ffd-4f9d-81a0-b82f0d9714c4')
 
 # Query vendor by display name
-vendor = client.vendor(company_id: '3a502065-2a08-4c3b-9468-fb83642d3d3a').where("displayName eq 'First Up Consultants'")
+vendor = client.vendor.where("displayName eq 'First Up Consultants'")
 
 # Create a new vendor
-vendor = client.vendor(company_id: '3a502065-2a08-4c3b-9468-fb83642d3d3a').create({ display_name: 'hello testing' })
+vendor = client.vendor.create({ display_name: 'hello testing' })
 
 # Update an existing vendor by ID
-vendor = client.vendor(company_id: '3a502065-2a08-4c3b-9468-fb83642d3d3a').update('3f445b08-2ffd-4f9d-81a0-b82f0d9714c4', { phone_number: '1112' })
+vendor = client.vendor.update('3f445b08-2ffd-4f9d-81a0-b82f0d9714c4', { phone_number: '1112' })
 
 # Delete a vendor
-client.vendor(company_id: '3a502065-2a08-4c3b-9468-fb83642d3d3a').destroy('f0730ada-b315-ea11-a813-000d3ad21e99')
+client.vendor.destroy('f0730ada-b315-ea11-a813-000d3ad21e99')
+```
+
+### OData Web Services
+
+https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/webservices/odata-web-services
+
+```Ruby
+require 'business_central'
+
+client = BusinessCentral::Client.new(
+    username: '<username>',
+    password: '<password>',
+    web_service_url: '<url>'
+)
+
+# Query a record 
+company = client.web_service.object("Company('?')/Purchase_Order", 'My Company').get
+
+# Create a record
+client.web_service.object("Company('?')/Purchase_Order", 'My Company').post({})
+
+# Update a record
+client.web_service.object("Company('?')/Purchase_Order", 'My Company').patch({})
+
+# Delete a record
+client.web_service.object("Company('?')/Purchase_Order", 'My Company').delete
 ```
 
 ## Development

data/lib/business_central.rb

@@ -5,23 +5,68 @@ require 'json'
 
 require 'core_ext/string'
 
-require 'business_central/object/helper'
+require 'business_central/object/argument_helper'
+require 'business_central/object/url_helper'
+require 'business_central/object/object_helper'
+
 require 'business_central/object/base'
 require 'business_central/object/validation'
 require 'business_central/object/response'
 require 'business_central/object/request'
+require 'business_central/object/filter_query'
+require 'business_central/object/url_builder'
 
 require 'business_central/object/account'
 require 'business_central/object/aged_account_payable'
 require 'business_central/object/aged_account_receivable'
+require 'business_central/object/attachment'
 require 'business_central/object/cash_flow_statement'
 require 'business_central/object/balance_sheet'
 require 'business_central/object/company'
 require 'business_central/object/company_information'
-require 'business_central/object/vendor'
+require 'business_central/object/country_region'
+require 'business_central/object/currency'
+require 'business_central/object/customer'
+require 'business_central/object/customer_financial_detail'
+require 'business_central/object/customer_payment'
+require 'business_central/object/customer_payment_journal'
+require 'business_central/object/customer_sale'
+require 'business_central/object/default_dimension'
+require 'business_central/object/dimension'
+require 'business_central/object/dimension_line'
+require 'business_central/object/dimension_value'
+require 'business_central/object/employee'
+require 'business_central/object/general_ledger_entry'
+require 'business_central/object/income_statement'
+require 'business_central/object/irs1099_code'
 require 'business_central/object/item'
+require 'business_central/object/item_category'
+require 'business_central/object/journal'
+require 'business_central/object/journal_line'
+require 'business_central/object/payment_method'
+require 'business_central/object/payment_term'
+require 'business_central/object/picture'
 require 'business_central/object/purchase_invoice'
 require 'business_central/object/purchase_invoice_line'
+require 'business_central/object/retained_earning_statement'
+require 'business_central/object/sales_invoice'
+require 'business_central/object/sales_invoice_line'
+require 'business_central/object/sales_credit_memo'
+require 'business_central/object/sales_credit_memo_line'
+require 'business_central/object/sales_order'
+require 'business_central/object/sales_order_line'
+require 'business_central/object/sales_quote'
+require 'business_central/object/sales_quote_line'
+require 'business_central/object/shipment_method'
+require 'business_central/object/subscription'
+require 'business_central/object/tax_area'
+require 'business_central/object/tax_group'
+require 'business_central/object/time_registration_entry'
+require 'business_central/object/trial_balance'
+require 'business_central/object/units_of_measure'
+require 'business_central/object/vendor'
+require 'business_central/object/vendor_purchase'
 
 require 'business_central/exceptions'
 require 'business_central/client'
+require 'business_central/web_service'

data/lib/business_central/client.rb

@@ -1,99 +1,142 @@
+# frozen_string_literal: true
+
 module BusinessCentral
   class Client
-    extend BusinessCentral::Object::Helper
+    extend BusinessCentral::Object::ObjectHelper
+
+    DEFAULT_LOGIN_URL = 'https://login.microsoftonline.com/common'
 
-    DEFAULT_URL = 'https://api.businesscentral.dynamics.com/v1.0/api/beta'.freeze
+    DEFAULT_URL = 'https://api.businesscentral.dynamics.com/v2.0/production/api/v1.0'
 
-    attr_reader :tenant_id,
-                :username,
+    attr_reader :username,
                 :password,
                 :application_id,
                 :secret_key,
                 :url,
-                :oauth2_client
+                :web_service_url,
+                :oauth2_login_url,
+                :oauth2_access_token,
+                :default_company_id,
+                :debug
 
-    alias_method :access_token, :oauth2_client
+    alias access_token oauth2_access_token
 
     object :account
     object :aged_account_payable
     object :aged_account_receivable
+    object :attachment
     object :balance_sheet
     object :cash_flow_statement
     object :company
     object :company_information
-    object :vendor
+    object :country_region
+    object :currency
+    object :customer
+    object :customer_financial_detail
+    object :customer_payment
+    object :customer_payment_journal
+    object :customer_sale
+    object :default_dimension
+    object :dimension
+    object :dimension_line
+    object :dimension_value
+    object :employee
+    object :general_ledger_entry
+    object :income_statement
+    object :irs1099_code
     object :purchase_invoice
     object :purchase_invoice_line
     object :item
+    object :item_category
+    object :journal
+    object :journal_line
+    object :payment_method
+    object :payment_term
+    object :picture
+    object :retained_earning_statement
+    object :sales_invoice
+    object :sales_invoice_line
+    object :sales_credit_memo
+    object :sales_credit_memo_line
+    object :sales_order
+    object :sales_order_line
+    object :sales_quote
+    object :sales_quote_line
+    object :shipment_method
+    object :subscription
+    object :tax_area
+    object :tax_group
+    object :time_registration_entry
+    object :trial_balance
+    object :units_of_measure
+    object :vendor
+    object :vendor_purchase
 
     def initialize(options = {})
       opts = options.dup
-      @tenant_id = opts.delete(:tenant_id)
       @username = opts.delete(:username)
       @password = opts.delete(:password)
       @url = opts.delete(:url) || DEFAULT_URL
+      @web_service_url = opts.delete(:web_service_url)
       @application_id = opts.delete(:application_id)
       @secret_key = opts.delete(:secret_key)
+      @oauth2_login_url = opts.delete(:oauth2_login_url) || DEFAULT_LOGIN_URL
+      @default_company_id = opts.delete(:default_company_id)
+      @debug = opts.delete(:debug) || false
     end
 
     def authorize(params = {}, oauth_authorize_callback: '')
       params[:redirect_uri] = oauth_authorize_callback
       begin
         oauth2_client.auth_code.authorize_url(params)
-      rescue Oauth2::Error => error
-        handle_error(error)
+      rescue OAuth2::Error => e
+        handle_error(e)
       end
     end
 
     def request_token(code = '', oauth_token_callback: '')
-      begin
-        oauth2_client.auth_code.get_token(code, redirect_uri: oauth_token_callback)
-      rescue OAuth2::Error => error
-        handle_error(error)
-      end
+      oauth2_client.auth_code.get_token(code, redirect_uri: oauth_token_callback)
+    rescue OAuth2::Error => e
+      handle_error(e)
     end
 
     def authorize_from_token(token: '', refresh_token: '', expires_at: nil, expires_in: nil)
-      @oauth2_client = OAuth2::AccessToken.new(
+      @oauth2_access_token = OAuth2::AccessToken.new(
         oauth2_client,
         token,
         refresh_token: refresh_token,
         expires_at: expires_at,
-        expires_in: expires_in,
+        expires_in: expires_in
       )
     end
 
     def refresh_token
-      @oauth2_client.refresh!
+      @oauth2_access_token.refresh!
+    end
+
+    def web_service
+      @web_service ||= BusinessCentral::WebService.new(client: self, url: web_service_url)
     end
 
     private
 
     def oauth2_client
-      if @oauth2_client.nil?
-        @oauth2_client = OAuth2::Client.new(
-          @application_id,
-          @secret_key,
-          {
-            site: "https://login.windows.net/#{@tenant_id}",
-            authorize_url: 'oauth2/authorize?resource=https://api.businesscentral.dynamics.com',
-            token_url: 'oauth2/token?resource=https://api.businesscentral.dynamics.com'
-          }
-        )
-      end
-        
-      return @oauth2_client
+      OAuth2::Client.new(
+        @application_id,
+        @secret_key,
+        site: @oauth2_login_url,
+        authorize_url: 'oauth2/authorize?resource=https://api.businesscentral.dynamics.com',
+        token_url: 'oauth2/token?resource=https://api.businesscentral.dynamics.com'
+      )
     end
 
     def handle_error(error)
-      if error.code.present?
-        case error.code
-          when 'invalid_client'
-            raise InvalidClientException.new
-        end
-      else
-        raise ApiException.new(error.message)
+      raise ApiException, error.message if error.code.nil?
+
+      case error.code
+      when 'invalid_client'
+        raise InvalidClientException
       end
     end
   end
-end
+end

data/lib/business_central/exceptions.rb

@@ -1,10 +1,11 @@
-module BusinessCentral
+# frozen_string_literal: true
 
+module BusinessCentral
   class BusinessCentralError < StandardError; end
 
   class InvalidClientException < BusinessCentralError
     def message
-      'Invalid application setup'
+      'Invalid client setup'
     end
   end
 
@@ -13,9 +14,7 @@ module BusinessCentral
       @message = message
     end
 
-    def message
-      @message
-    end
+    attr_reader :message
   end
 
   class CompanyNotFoundException < BusinessCentralError
@@ -30,15 +29,19 @@ module BusinessCentral
     end
   end
 
+  class NotFoundException < BusinessCentralError
+    def message
+      'Not Found - The URL provided cannot be found'
+    end
+  end
+
   class InvalidObjectException < BusinessCentralError
     def initialize(errors)
       @errors = errors
     end
 
     def message
-      @errors.each do |error|
-        "#{error[:field]} - #{error[:message]}"
-      end
+      @errors.each { |error| "#{error[:field]} - #{error[:message]}" }
     end
   end
 
@@ -49,7 +52,24 @@ module BusinessCentral
     end
 
     def message
-      "#{method} method is currently not support. Allowed methods are: #{allowed_methods.join(', ')}"
+      methods_allowed = @allowed_methods.join(', ')
+      "#{@method} method is currently not support. Allowed methods are: #{methods_allowed}"
+    end
+  end
+
+  class InvalidArgumentException < BusinessCentralError
+    def initialize(message)
+      @message = message
+    end
+
+    def message
+      "Invalid argument entered - #{@message}"
+    end
+  end
+
+  class InvalidObjectURLException < BusinessCentralError
+    def message
+      'Object URL missing for request'
     end
   end
-end
+end