Acumatica Customization Util (ACU)

Current version: 23.10.17.38782

Designed by: Sprinterra

General info

Acumatica Customization Utility (ACU) is a utility designed to automate everyday routine tasks related to the creation and maintenance of built-in applications (customization packages) of ERP Acumatica.

ACU is a CLI application that implements a system of commands that are intuitively structured according to their functional purpose and allow you to perform conveniently the necessary actions when creating and maintaining customization packages. A complete description of all available commands and their corresponding options can be found in the ACU Reference.xlsx document.

ACU allows to perform the following actions (by groups of commands):

• ERP: download of installation package of the required version, install of ERP Acumatica (supports installation of multiple versions), delete of ERP Acumatica.

• Site: install the Acumatica instance, upgrade instance or database, delete the Acumatica instance.

• Src: get the source code of the customization package from the instance, build the extension library code, make the customization package (three modes are supported - normal, build for ISV, build for QA).

• Pkg: upload and publish custom packages to the site, get the package from the site, unpublish all packages.

Project structure

ACUCustomizationUtil
├───doc                              Project documentation
├───proj                             Test project
│   ├───cst
│   ├───pkg
│   └───src
│       └───ACUCustomization
└───src
    └───ACUCustomizationUtil         Main project
        ├───Builders
        │   ├───Commands             Commands
        │   │   ├───Binders          Parameter binders
        │   │   └───Common
        │   ├───DI                   DI
        │   └───Log                  Logger
        ├───Common
        ├───Configuration            Code for Configuration by services
        │   ├───ACU
        │   ├───Erp
        │   ├───Package
        │   ├───Site
        │   └───Src
        ├───Connected Services       SOAP Service
        │   └───AcuSOAP
        ├───Extensions               Extention methods
        ├───Helpers                  Command helpers
        │   ├───CommonTypes
        │   └───Proxy
        ├───JSON                     JSON custom converters
        ├───Properties
        ├───Services                 Command Services
        │   ├───ERP
        │   ├───Package
        │   ├───Site
        │   └───Src
        └───Validators               Command Validators
            ├───Erp
            ├───Package
            ├───Site
            └───Src

Documentation

• ACU User Guide
• ACU Command Reference
• ACU Configuration Reference
• ACU Project Configuration Guide

Settings required to work with the Test Project

The solution includes a test project ACUCustomization, which is located in the folder proj. For more details on how to use this project and what settings should be made, please refer to the document ACU Test Project Guide.

How to get the utility executable file

The correct way to get the utility executable is to put the publishing configuration into a folder and run that configuration. These actions are described in more detail in the document ACU Package Guide

Support and bug fixes

If you have any issue with the app functionality, feel free to post an issue in this repo - for now, I am intended to maintain this app as long as I don't feel it is stable enough.

If you need to modify the application to your requirements, or you have ideas for improving the functionality or code, feel free to contact the developers by e-mail. To make your request faster, please specify "ACUCUstomizatoinUtil" in the subject line.