Step 1: Creating an Extension Library for MYOB Acumatica

You need to develop a commerce connector in an extension library, which you include in an MYOB Acumatica customization package.

1. Creating an Extension Library for MYOB Acumatica

  1. On the main menu of the Customization Project Editor, click Extension Library > Create New.

    The Create Extension Library dialog box opens.

  2. Specify the location and name of the Visual Studio project that will contain the extension library.
  3. Click OK to close the dialog box and start the process of creating the library.

For details about the creation of an extension library, see To Create an Extension Library.

MYOB Acumatica Customization Platform adds the default references to the project of the extension library, such as PX.Data and PX.Common. For the creation of a commerce connector, you also need to add the references to the MYOB Acumatica commerce libraries, as described below.

2. Adding References to the Extension Library

  1. In the project of the extension library, add references to the following assemblies located in the Bin folder of the MYOB Acumatica instance:
    • PX.Commerce.Core.dll: Required for the implementation of any commerce connector
    • PX.Commerce.Objects.dll: Required for the implementation of any commerce connector
    • PX.Commerce.BigCommerce.dll: Necessary only if you want to use particular features implemented for the BigCommerce connector
    • PX.Api.ContractBased.dll: Necessary only if you implement custom classes for MYOB Acumatica entities, as described in Step 2: Creating Classes for MYOB Acumatica Entities
    • PX.Data.BQL.Fluent.dll: Necessary only if you use fluent BQL queries instead of traditional BQL queries
  2. Add references to the following external libraries:
    Important: You need to use the same version of the library as the one located in the Bin folder.
    • RestSharp
    • CommonServiceLocator
    • Microsoft.Bcl.AsyncIntefaces
    • Newtonsoft.Json
    • Serilog
  3. Build the project.

Now you will include the dll file of the extension library, which is located in the Bin folder of the website, in the customization project.

3. Including the Library in the Customization Project

  1. Open the customization project in the Customization Project Editor. (See To Open a Project for details.)
  2. Click Files in the navigation pane to open the Custom Files page.
  3. On the page toolbar, click Add New Record.
  4. In the Add Files dialog box, which opens, find the file in the table and select the check box in the Selected column for it.
    Note:
    • You can select multiple custom files to add them to the project at the same time.
    • For any files other than the ones placed in the Bin folder, you can click Refresh on the toolbar of the Add Files dialog box to make the system update the list of files in the table. If you have changed files in the Bin folder of the website, you should refresh the page in the browser.
  5. In the dialog box, click Save to save each selected file to the customization project as a File item.