Search
Close this search box.

Налаштування Acumatica: Автоматизація та вдосконалення робочого процесу розробки. Частина II

Огляд утиліти налаштування Acumatica (ACU)

Sprinterra з гордістю представляє інструмент автоматизації робочого процесу розробки Acumatica: ACUCustomizationutil. Спочатку створений як внутрішній інструмент, його основна мета - впорядкувати процес розробки. Для публічного доступу первинний репозиторій доступний за адресою ACUCustomizationUtil.

Щоб заглибитися в технічні аспекти цієї утиліти, ось ресурси з документацією:

Розроблена на базі C# .NET версії 7, утиліта інтегрує декілька пакетів, зокрема:

System.CommandLine

2.0.0-beta4.22272.1

Spectre.Console

0.47.1-preview.0.6

Serilog.Sinks.File

5.0.1-dev-00947

Serilog.Sinks.Console

4.1.1-dev-00910

Serilog.Розширення.Хостинг

7.0.0

Microsoft.Data.Sqlclient

5.2.0-preview1.23109.1

FluentValidation

11.5.2

Ошатний.

2.0.123

ACU з першого погляду

ACU - це інструмент на основі CLI, створений для спрощення рутинних завдань, пов'язаних з налаштуваннями Acumatica. Він являє собою структуру команд, категорично організовану для зручності використання. Кожна команда більш детально описана в Командна довідка.

Він охоплює чотири групи команд, що відповідають діям з:

  • ERP: Керування версіями Acumatica ERP, включаючи встановлення та видалення.
  • Сайт: Керування операціями з екземплярами Acumatica, від інсталяції до оновлення.
  • Src: Отримання вихідних кодів налаштувань, створення бібліотек розширень і створення пакунків налаштувань.
  • Пкг: Нагляд за завантаженням, публікацією, пошуком та управлінням користувацькими пакунками.
ACU має вбудовану довідкову систему. Це дозволяє користувачам швидко отримати список підкоманд і параметрів для кожної команди. Щоб викликати довідку, користувачі можуть скористатися такими опціями, як -?, -h, й --Допоможіть.. Зразок запиту на довідкову інформацію наведено нижче.

Показати початковий розділ довідкової системи:

 

PS C:\Users\aslusar> acu /?

Acumatica customization util - інструмент для роботи з налаштуваннями

Авторське право Sprinterra(c) 2023

Використання:

  acu [команда] [опції] [параметри].

Варіанти:

  -config Параметр шляху до файлу конфігурації [за замовчуванням: acu.json].

  -user-config Параметр шляху до файлу конфігурації користувача [за замовчуванням: acu.json.user].

  -version Показати інформацію про версію

  -?, -h, -help Показати довідку та інформацію про використання

Команди:

  erp Робота з ERP-системою Acumatica.

  сайт Робота з екземпляром Acumatica.

  src Робота з вихідним кодом кастомізації.

  pkg Робота з пакетом кастомізації.

“`

Відобразіть на екрані ерп можна скористатися розділом довідки команди:

 

PS C:\Users\aslusar> acu erp /?

Acumatica customization util - інструмент для роботи з налаштуваннями

Авторське право Sprinterra(c) 2023

 

Використання:

  acu erp [команда] [опції] [параметри].

 

Варіанти:

  -config Параметр шляху до файлу конфігурації [за замовчуванням: acu.json].

  -user-config Параметр шляху до файлу конфігурації користувача [за замовчуванням: acu.json.user].

  -?, -h, -help Показати довідку та інформацію про використання

 

Команди:

  завантажити Завантажити інсталяцію ERP.

  встановити   Встановити ERP.

  видалити    Видалити ERP.

Відображення розділу довідкової системи src командування зробити підкоманди:

 

PS C:\Users\aslusar> acu src make /?

Acumatica customization util - інструмент для роботи з налаштуваннями

Авторське право Sprinterra(c) 2023

 

Використання:

  acu src make [опції]

 

Варіанти:

  -source Directory Каталог джерел елементів кастомізації

  -pkgName Назва пакунка

  -pkgDirectory Каталог призначення пакунків

  -mode Режим для пакунка make: QA|ISV

  -config Параметр шляху до файлу конфігурації [за замовчуванням: acu.json].

  -user-config Параметр шляху до файлу конфігурації користувача [за замовчуванням: acu.json.user].

  -?, -h, -help Показати довідку та інформацію про використання

Гнучка система конфігурації

Конфігурація в ACU складається з різних елементів:

  • - Головний конфігураційний файл (за замовчуванням: acu.json)
  • - Файл конфігурації користувача (за замовчуванням: acu.json.user)
  • - Параметри конфігурації для конкретних команд

Детальна інформація про елементи конфігурації доступна в Довідковий посібник з конфігурації і Командна довідка. Зверніть увагу: якщо ви використовуєте імена файлів за замовчуванням, немає необхідності вказувати їх повторно (--config і --user-config) за допомогою параметрів командного рядка.

Основи конфігурації

Використовувати конфігурацію дуже просто. Просто створіть файл acu.json і, якщо потрібно, файл acu.json.user і розмістіть їх у кореневому каталозі конфігурації. Вони слугують основою для ваших індивідуальних налаштувань та уподобань.

Може виникнути ситуація, коли ви працюєте з утилітою без конфігураційних файлів або вам потрібно внести разові зміни до вже існуючої конфігурації. У таких випадках на допомогу приходять командні опції. Вони забезпечують гнучкість адаптації на льоту, гарантуючи, що утиліта відповідатиме вашим нагальним потребам.

Варто зазначити, що при одночасній активації декількох елементів конфігурації спостерігається ієрархія. Командні опції завжди мають пріоритет, займаючи перше місце. З іншого боку, файл acu.json знаходиться в основі ієрархії пріоритетів, гарантуючи, що ваші базові налаштування будуть збережені, якщо їх не буде явно перевизначено.

Наприклад, у наведеній нижче конфігурації підсумкове значення буде таким C:\Acumatica\Sites\AcutestUtil

Налаштування Acumatica ERP

Але в конфігурації з використанням тільки конфігураційних файлів результат буде іншим

D:\ACU\inst\AcuTestUtil

Налаштування Acumatica ERP

Дизайн, орієнтований на користувача

Філософія дизайну інструменту зосереджена на зручності та ефективності роботи користувачів. Після створення конфігурацій і збереження їх у файлі, користувачі можуть покладатися на інтуїтивно зрозумілі команди для навігації та виконання необхідних завдань. Така ефективність означає менше часу на пошук потрібної команди і більше часу на налаштування Acumatica.

Крім того, ми розуміємо цінність оперативної допомоги. Саме тому ми вбудували інтерактивну систему допомоги безпосередньо в утиліту. Незалежно від того, де і що ви робите, підказки знаходяться на відстані одного натискання клавіші.

Ось блок-схема робочого процесу розробки кастомізації Acumatica від перша частина цієї серії. Якщо поглянути на неї крізь призму автоматизації, що працює за допомогою ACUCustomizationUtilвесь процес набуває нового виміру.

Схема робочого процесу розробки кастомізації Acumatica

Як бачите, колись нудні завдання - чи то налаштування робочого простору, чи то повторювані дії на кшталт збирання пакунків або вилучення вихідного коду налаштувань - перетворилися на автоматизовані процеси, і все це завдяки можливостям ACUCustomizationUtil корисність.

Підводячи підсумки

Тепер ви знайомі з основними функціональними можливостями ACUCustomizationUtil - інтуїтивно зрозумілий, але потужний інструмент. Його безшовна інтеграція командних опцій і гнучкість можуть змінити правила гри для різних налаштувань проекту. Хочете побачити його в дії? Слідкуйте за новинами третя частина, де ми продемонструємо реальні приклади автоматизації за допомогою цього інструменту!

Підпишіться на нашу розсилку

Отримуйте найновішу інформацію про експоненціальні технології прямо на вашу скриньку

ukUkrainian