WiKi - UserSide - Вклад [ru]

Версії 3.21

2026-07-12T13:11:10Z

IronBot: [IronBot] Sync UK localization from RU

[[Versions_3.21_EN|en]] | '''uk''' | [[Версии_3.21|ru]]

Версії гілки [[3.21_UK|3.21]]

Див. також: [[Версії_ERP_"USERSIDE"|Версії ERP "USERSIDE"]]

== 3.21.14 (у розробці) ==
* У списку будинків додано фільтрацію за наявністю/відсутністю споруди зв'язку на будинку
* Додано нове право для профілів співробітників: "Налаштування - Статуси завдань"
* У календарі робіт додано фільтри для налаштування власного порядку/наявності підрозділів і співробітників у календарі
* Перероблено розділ зі списком підрозділів. Змінено зовнішній вигляд, додано швидкий пошук за співробітником/підрозділом
* Під час створення нового будинку в блоці вибору адреси нова адреса одразу підставляється без перезавантаження поточної сторінки
* Під час пошуку в блоці вибору адреси в результатах виводяться не лише будинки, а й інші типи адресних об'єктів, що дозволяє також швидко додавати нові будинки, вулиці тощо
* Доопрацьовано зовнішній вигляд картки завдання для мобільних пристроїв
* Виправлено швидкість роботи карти покриття під час відображення шару "Співробітники та автотранспорт"
* Виправлено фільтрацію у списку будинків ''(у деяких випадках)''
* Виправлено перегляд PDF-файлів у браузері ''(у деяких випадках)''
* Виправлено фільтрацію списку абонентів-боржників
* Виправлено відображення розділу "Налаштування-Адреси" для співробітників з обмеженим доступом за географією
* Виправлено відображення волокон на схемі комутації за наявності мітки на волокні
* Виправлено помилку під час відображення завдань поточного дня в календарі робіт ''(у деяких випадках)''

== 3.21.13 - 10.07.2026 ==
* '''Під час приходу ТМЦ тепер можна одразу вказувати кілька різних найменувань ТМЦ'''
* Доопрацювання у відображенні виконаних завдань у календарі
* У схемі комутації для дільників і ODF/кросів у меню об'єктів додано кнопки дій, як і в картках цих об'єктів ''(редагування, видалення, структурна схема тощо)''
* Виправлено комутацію у схемі комутації ''(у деяких випадках)''
* Виправлено дублювання запитів під час автооновлення рівня сигналу на ONU під час відкриття її картки
* Виправлено зовнішній вигляд відображення історії за завданням
* Виправлено редагування налаштувань карти покриття ''(у деяких випадках)''
* Виправлено вибір об'єктів на глобальній схемі комутації ''(у деяких випадках)''
* Виправлено перевірку прав доступу до списку ONU для співробітників
* Виправлено зовнішній вигляд картки стійки/шафи в темній схемі інтерфейсу

== 3.21.12 - 09.07.2026 ==
* Доопрацьовано метод API->[[API_redirect_UK|redirect]]
* Під час розділення ТМЦ на кілька частин за наявності прикріплених файлів вони закріплюються за всіма ТМЦ
* Доопрацьовано діалог додавання кабельної лінії з-під споруди зв'язку
* Додано параметр налаштування "Відображати виконані завдання з прозорістю (%)"
* Виправлено роботу параметра налаштування "Відображати виконані завдання сірим кольором"
* Виправлено виведення поля для зазначення MAC-адреси під час приходу ТМЦ
* Виправлено роботу залежностей додаткових полів
* Виправлено роботу з прикріпленими файлами в операціях з автотранспортом
* Виправлено перехід до налаштування полів таблиці споруд зв'язку
* Виправлено зовнішній вигляд інформації за завданнями у вкладці "Тех. підтримка" у картці абонента
* Виправлено помилки під час перегляду історії дій користувачів ''(у деяких випадках)''
* Виправлено помилку під час відкриття діалогового вікна вибору ТМЦ для інтеграції
* Виправлено переміщення позицій об'єктів на глобальній схемі комутації
* Виправлено зазначення резервів для кабельних ліній
* Виправлено помилку під час приходу ТМЦ та автопризначення інвентарних номерів ''(у деяких випадках)''
* Виправлено налаштування доступу до адрес для співробітників

== 3.21.11 - 08.07.2026 ==
* Виправлено зовнішній вигляд налаштування таблиці прав для типів завдань
* Виправлено зміну позиції окремої схеми комутації споруди зв'язку на загальній глобальній схемі комутації
* Виправлено фільтрацію завдань у розділі "Мої завдання" ''(у деяких випадках)''
* Виправлено зміну координат адресного об'єкта з-під картки будинку
* Виправлено сортування виконавців під час створення завдання
* Виправлено зміну координат сектора для радіообладнання
* Виправлено перевірку прав доступу під час відкриття картки пристрою ''(у деяких випадках)''
* Виправлено приховування/відображення споруди зв'язку на карті покриття

== 3.21.10 - 07.07.2026 ==
* Додано метод API->call->[[API_call_UK#edit|edit]]
* Додано нові права для профілів користувачів "Власники (доступ до фінансової інформації)" та "Орендарі (доступ до фінансової інформації)"
* '''Реалізовано передачу ТМЦ співробітнику з підтвердженням отримання/відмови від отримання співробітником'''
* У групових діях за спорудами зв'язку створення спільного завдання/окремих завдань реалізовано через стандартний діалог додавання завдання
* Виправлено позначення завдання як прочитаного в новинах під час відкриття картки завдання
* Виправлено відображення дати останньої операції за ТМЦ у списку ТМЦ за об'єктом
* Виправлено генерацію документа на друк з-під картки завдання
* Виправлено комутацію вільних волокон кабелів між собою ''(у деяких випадках)''
* Виправлено редагування координат у лінії зв'язку
* Виправлено виведення сторонніх артефактів у глобальній схемі комутації ''(у деяких випадках)''
== 3.21.9 - 06.07.2026 ==
* У виключення для SMS-розсилок додано можливість виключати абонентів із певним періодом від'ємного балансу
* У статистиці "Проблемні будинки/абоненти" додано можливість налаштовувати власні фільтри
* У налаштуваннях типу завдань у секції додаткових полів окремо вказуються типи додаткових полів, які можна використовувати під час зміни статусу завдань. А в налаштуваннях статусів завдань додано властивість "Вивести додаткові поля"
* Додано можливість автоматично створювати завдання на роботу для невідповіджених телефонних викликів
* Зміну пароля користувача винесено в окреме діалогове вікно

== 3.21.8 - 04.07.2026 ==
* Доопрацьовано метод API->customer->[[API_customer_UK#get_customers_id|get_customers_id]]
* Доробки зовнішнього вигляду завдань у календарі робіт
* У групових діях за абонентами: створення завдань тепер використовує повноцінний діалог зазначення властивостей для створюваних завдань
* Оптимізація структурної схеми
* Виправлено помилку під час встановлення умов у SMS-розсилці ''(у деяких випадках)''
* Виправлено зазначення власних координат для абонента
* Виправлено помилку під час збереження системного пристрою
* Виправлено виведення об'єктів на глобальній схемі комутації ''(у деяких випадках)''
* Виправлено комутацію кабельної лінії до пристрою у схемі комутації абонента
* Виправлено зміну довільних координат для обладнання
* Виправлено роботу фільтра за виключенням тарифу в SMS-розсилці

== 3.21.7 - 03.07.2026 ==
* Режим планування в календарі робіт
* Виправлено пошук у списку споруд зв'язку ''(у деяких випадках)''
* Виправлено відображення прикріплених файлів у картці споруди зв'язку за наявності прав лише на читання
* Виправлено перегляд/формування SMS-розсилок ''(у деяких випадках)''
* Виправлено відображення рівнів сигналів для ONU ''(у деяких випадках)''
* Виправлено відображення затухань на структурній схемі для OLT ''(у деяких випадках)''
* Виправлено помилку під час перегляду історії за співробітниками ''(у деяких випадках)''
* Виправлено неправильне виведення дати активності у спливній підказці на мапі покриття за автотранспортом
* Виправлено можливість виключення абонента із завдання

== 3.21.6 - 02.07.2026 ==
* Додано історію використання IP-адрес
* Доопрацьовано використання лінійки на мапі покриття
* Виправлено зовнішній вигляд кабельних ліній на мапі покриття залежно від налаштувань міток ''(у деяких випадках)''
* Виправлено список обладнання у віджеті головної сторінки "Неактивні комутатори"
* Виправлено додавання нових схем споруд зв'язку на глобальну схему комутації
* Виправлено пошук за базою обладнання під час додавання найменування ТМЦ у каталозі товарів
* Виправлено очищення комутації портів обладнання ''(у деяких випадках)''
* Виправлено помилку у звіті щодо залишків ТМЦ ''(у деяких випадках)''
* Виправлено зазначення довільних запасів/об'єктів на маршруті кабельної лінії
* Виправлено перемикання комутації в порт іншого пристрою на споруді зв'язку
* Виправлено відображення об'єктів на мапі покриття у групових операціях за спорудами зв'язку
* Виправлено зміну шляху комутації у схемі комутації ''(у деяких випадках)''

== 3.21.5 - 01.07.2026 ==
* Додано сповіщення під час редагування завдання ''(налаштовується)''
* Доробка зі знімання інформації за інтерфейсами ONU
* Доопрацьовано зовнішній вигляд портів обладнання для темної схеми
* Для типів завдань додано можливість вказати дії з ТМЦ: передавати з абонента на вибраний склад потрібні ТМЦ, що знаходяться в абонента
* Виправлено швидкий пошук обладнання потрібної категорії у списку обладнання
* Виправлено вибір інших пристроїв на цій споруді зв'язку в діалоговому вікні перемикання порту
* Виправлено відображення доступних складів для співробітника ''(у деяких випадках)''
* Виправлено помилку під час перегляду картки ТМЦ ''(у деяких випадках)''
* Виправлено автовибір будинку під час додавання споруди зв'язку з картки будинку
* Виправлено перегляд списку опитуваних пристроїв у модулі usm_observer
* Виправлено можливість зміни кольору з'єднання між пристроями у схемі комутації

== 3.21.4 - 30.06.2026 ==
* Доопрацьовано метод API->attach->[[API_attach_UK#upload|upload]]
* Додано окремий профіль email-сповіщень для надсилання повідомлень абонентам-юридичним особам
* Доопрацьовано сортування у списку споруд зв'язку за будинком
* Календар робіт відкривається на поточній даті
* Доробка календаря завдань для випадків, коли кілька завдань призначаються на один час
* Впроваджено багаторівневі групи типів завдань
* У новинах за завданнями додано можливість частково позначати події як прочитані, а також групувати новини за завданнями
* В автоматизації за завданнями додано можливість надсилати Email абонентам ''(за налаштовуваними шаблонами)''
* Доопрацьовано виведення спливного сповіщення під час призначення підрозділу співробітника на завдання
* Виправлено відображення блока з прикріпленими файлами у власних розділах за права лише на читання
* Виправлено перехід у картку абонента з мапи покриття
* Виправлено помилку під час налаштування доступності статусів для профілів співробітників у картці типу завдання
* Виправлено фільтрацію за датами у списку завдань ''(у деяких випадках)''
* Виправлено відображення автора завдання у списку завдань
* Виправлено відображення поля "Нотатки" у картці споруди зв'язку
* Виправлено помилку під час спроби видалення адресного об'єкта ''(у деяких випадках)''
* Виправлено можливість вимкнення/увімкнення порту пристрою
* Виправлено перегляд глобальних схем комутації ''(у деяких випадках)''

== 3.21.3 - 28.06.2026 ==
* Доопрацьовано метод API->inventory->[[API_inventory_UK#transfer_inventory|transfer_inventory]]
* Доопрацьовано метод API->commutation->[[API_commutation_UK#delete|commutation]]
* Доопрацьовано метод API->node->[[API_node_UK#get|get]]
* Доопрацьовано метод API->address->[[API_address_UK#get_house|get_house]]
* Для завдання планувальника "Розсилання інформації про зниження резервів на складі" додано можливість указувати варіанти надсилання "E-mail/Messenger", а також у картці співробітника в розділі "Сповіщення" можна вказати варіанти отримання цієї розсилки
* У списку ТМЦ у картці завдання додано можливість одразу передавати всі ТМЦ вибраному отримувачу
* У додаткових полях із типом "Вибір зі списку" додано швидкий пошук значення
* Доопрацьовано використання явно вказаних координат під час редагування картки будівлі та вибору полігона/точки
* Виправлено створення кабельних ліній до будівлі з мапи покриття
* Виправлено помилку під час переходу до розділу Налаштування - Модулі ''(у деяких випадках)''
* Виправлено групування у списку завдань ''(у деяких випадках)''
* Виправлено видалення напису зі схеми комутації
* Виправлено роботу параметра "Відображати у селекторах/пошуку звільнених співробітників протягом N днів після їх звільнення"
* Виправлено перевірку доступності складів під час вибору ТМЦ при виконанні завдання
* Виправлено роботу змінної "Виводити завдання за датою фактичного виконання"
* Виправлено використання колірних налаштувань зовнішнього вигляду типів завдань у календарі
* Виправлено пошук на мапі покриття ''(підставляння поточного населеного пункту у вікні пошуку)''
* Виправлено перехід із картки клієнта на мапу з координатами будівлі клієнта
* Виправлено збереження інтерфейсів/стекування в картці пристрою

== 3.21.2 - 26.06.2026 ==
* Доопрацьовано метод API->address->[[API_address_UK#get_house|get_house]]
* Під час передавання ТМЦ із картки клієнта можна вибрати субрахунок, на який передаємо
* Під час створення/зміни завдання для будівлі виводиться інформація про мітки на будівлі та примітку до будівлі
* Під час створення завдання за ланцюжком можна окремо вказати потрібного довільного виконавця/підрозділ
* У масовому передаванні ТМЦ тепер створюються об'єднані операції передавання, а не кожна окремо
* У списку завдань у групуванні результатів фільтрації додано варіант "Дата виконання (місяць)"
* Виправлено помилку під час створення завдання ''(у деяких випадках)''
* Виправлено зміну координат у картці будівлі, споруди зв'язку, клієнта ''(у деяких випадках)''
* Виправлено формування назви споруди зв'язку під час вибору поверху будівлі ''(у деяких випадках)''
* Виправлено обробку посилань у текстових значеннях додаткових полів
* Виправлено призначення виконавців під час створення завдання ''(у деяких випадках)''

== 3.21.1 - 25.06.2026 ==
* Доопрацьовано центрування мапи під час редагування полігона/будівлі на мапі покриття
* Виправлено відображення глобальних схем комутації ''(у деяких випадках)''
* Виправлено експорт у XLS списку кабельних ліній ''(у деяких випадках)''
* Виправлено коректне відображення клієнтів на логічній схемі будівлі ''(у деяких випадках)''
* Виправлено вибір батьківських об'єктів під час додавання будівлі з мапи покриття
* Виправлено прикріплення клієнта під час додавання нового завдання для клієнта
* Виправлення невеликих помилок

== 3.21.0 - 23.06.2026 ==
* Реліз версії

== 3.21.0-beta.7 - 21.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.6 - 20.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.5 - 17.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.4 - 13.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.3 - 07.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.2 - 30.05.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.1 - 24.05.2026 ==
* Перелік змін див. у [[3.21_UK|3.21]]

Версії 3.20

2026-07-12T13:11:10Z

IronBot: [IronBot] Sync UK localization from RU

[[Versions 3.20 EN|en]] | '''uk''' | [[Версии_3.20|ru]]

Версії гілки [[3.20_UK|3.20]]

Також див.: [[Версії ERP "USERSIDE"]]

== 3.20.26 (у розробці) ==
* Виправлено генерацію/транслітерацію логіна співробітника під час створення ''(у деяких випадках)''
* Виправлено помилку під час побудови звіту щодо залишків ТМЦ за завданнями
* Виправлено помилку під час перегляду графіка зростання абонентів ''(у деяких випадках)''
* Невеликі зміни та виправлення помилок

== 3.20.25 - 24.06.2026 ==
* Доопрацьовано відображення запланованих кабельних ліній на мапі покриття відповідно до налаштувань кольору за щільністю кабелю
* Виправлено помилку з відображенням списку кабельних ліній ''(у деяких випадках)''
* Виправлення невеликих помилок та змін

== 3.20.24 - 27.05.2026 ==
* Виправлення невеликих помилок та змін

== 3.20.23 - 27.04.2026 ==
* Додано метод API->call->[[API_call_UK#agent_call|agent_call]]
* Додано метод API->chapter->[[API_chapter_UK#link_add|link_add]]
* Додано метод API->chapter->[[API_chapter_UK#link_get|link_get]]
* Додано метод API->chapter->[[API_chapter_UK#link_remove|link_remove]]
* Доопрацьовано метод API->call->[[API_call_UK#add|add]]
* Доопрацьовано метод API->task->[[API_task_UK#edit|edit]]
* У виконаних завданнях також відображається ознака "Прострочено" під час порушенні термінів робіт
* Виправлена помилка з входом у календар робіт ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.20.22 - 04.04.2026 ==
* Виправлено вибір порожнього значення в типі завдань для реєстрації телефоном
* Оптимізаційні роботи
* Виправлення невеликих помилок

== 3.20.21 - 11.03.2026 ==
* Виправлено відображення лічильника помилок на інтерфейсах пристроїв ''(у деяких випадках)''
* Виправлено налаштування шаблонів SMS-повідомлень для абонентів у завданнях
* Оптимізаційні роботи
* Виправлення невеликих помилок

== 3.20.20 - 22.02.2026 ==
* Оптимізована робота розділу "Мої завдання"
* Виправлено порушення розмітки головного меню в деяких випадках

== 3.20.19 - 08.02.2026 ==
* Виправлення невеликих помилок

== 3.20.18 - 23.01.2026 ==
* Оптимізація звіту за складу "Оборотно-сальдова відомість"
* Виправлення невеликих помилок

== 3.20.17 - 31.12.2025 ==
* Додано метод API->task->[[API_task_UK#add_node_to_task|add_node_to_task]]
* Додано метод API->task->[[API_task_UK#remove_node_from_task|remove_node_from_task]]
* Виправлено виконання ланцюжка завдань ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.20.16 - 14.12.2025 ==
* Виправлена помилка з фільтрацією за секції ТМЦ у списку операцій за складу
* Виправлення невеликих помилок

== 3.20.15 - 06.12.2025 ==
* Для ланцюжків завдань/автоматизації в типах завдань додано можливість вказівки дробового інтервалу годинника
* Виправлення невеликих помилок

== 3.20.14 - 29.11.2025 ==
* Доопрацювання API взаємозв'язку з Binotel
* Виправлення невеликих помилок

== 3.20.13 - 22.11.2025 ==
* Виправлення невеликих помилок

== 3.20.12 - 15.11.2025 ==
* Додано параметр налаштування "Масштабувати ширину кабельної лінії на схемі комутації в залежності від довжини назви"
* Допрацьовано відображення невідомих ONU за OLT у віджеті головної сторінки
* Виправлення інших невеликих помилок

== 3.20.11 - 08.11.2025 ==
* Виправлення помилки під час вході в розділ Custom-повідомлень ''(у деяких випадках)''
* Виправлення помилки під час вході в налаштування інтерфейсів/стекування за пристрої ''(у деяких випадках)''
* Виправлена неможливість комутації між ODF/кросами у майстрі комутацій
* Виправлення деяких помилок міграції

== 3.20.10 - 07.11.2025 ==
* Додано метод API->vehicle->[[API_vehicle_UK#add|add]]
* Додано метод API->vehicle->[[API_vehicle_UK#edit|edit]]
* Додано метод API->vehicle->[[API_vehicle_UK#delete|delete]]
* У картці спорудження зв'язку в блоці з прикріпленими файлами-зображеннями можна швидко зробити зображення основним фото для цього об'єкта ''(без необхідності переходити до редагування)''
* У картці кабельної лінії додано можливість створити завдання з цією лінією або додати лінію до існуючого завдання
* Доопрацьовано сортування за додатковими полями у власних розділах
* Виправлена фільтрація за найменуванням ТМЦ у списку ТМЦ
* Виправлено відображення шарів обладнання на карті покриття
* Виправлення інших невеликих помилок

== 3.20.9 - 14.09.2025 ==
* Доопрацювання перевірки прав доступу до ONU
* Виправлена помилка під час пошуку абонента під час передачі ТМЦ ''(у деяких випадках)''
* Виправлено оновлення на базі серійних номерів для ONU під час опитуванні OLT ''(у деяких випадках)''

== 3.20.8 - 06.09.2025 ==
* Додано метод API->billing->[[API_billing_UK#refresh_date_update|refresh_date_update]]
* Оптимізовано інтерфейс редагування/додавання адресної одиниці ''(актуально для розгалужених адресних структур)''
* У картці завдання додані посилання на перегляд зв'язаних абонентів із спорудами зв'язку та з кабельними лініями
* Виправлена перевірка на статус батьківського завдання в автоматизації дій із завдань ''(у деяких випадках)''
* Виправлено відображення спливаючої підказки в календарі завдань під час горизонтальному скролі
* Виправлено призначення співробітників у підрозділ ''(у деяких випадках)''

== 3.20.7 - 25.08.2025 ==
* '''Глибока переробка операцій із транспорту. Різні типи, контроль пробігу, терміни. Повідомлення на головну сторінку та список транспорту. Ведення історії змін в операціях '''
* Історія дій щодо потенційного абонента переноситься в історію дій звичайного абонента під час їх об'єднанні
* При гарячій заміні пристрою можна вказати збереження історії MAC-адрес на портах обладнання
* У групових діях за списком абонентів додано можливість очищення комутації
* Технічні міграції даних ядра
* Виправлена фільтрація FDB-таблиці з пристрою ''(у деяких випадках)''
* Виправлена помилка під час обмеженні співробітнику доступу за конкретною IP-адресою
* Виправлено перевірку прав на доступ до ONU

== 3.20.6 - 15.08.2025 ==
* ''' Окремі SMS-профілі для роботи. Наприклад, для кожної SMS-розсилки можна вказати окремий SMS-профіль ''(власне альфа-ім'я, інший оператор...)'''''
* Виділено окремі права доступу до ONU на перегляд та зміну
* Виправлено відображення великої кількості розділів блокнота у списку розділів
* Виправлено оновлення інформації під час додавання/виключенні споруди зв'язку в завданні

== 3.20.5 - 08.08.2025 ==
* Додано метод API->address->[[API_address_UK#get_building_type|get_building_type]]
* Додано параметр налаштування "Будівлі. Шаблон спливаючого повідомлення на карті"
* Доопрацьовано інтерфейс зміни нотатки, типу адаптера та з'єднання для волокна кабельної лінії
* Перероблено інтерфейс додавання споруд зв'язку та кабельних ліній у завдання під час створення завдання
* Підкориговано перевірку прав доступу до табеля робіт
* Доопрацьовано тарифікацію співробітникам за завдання у відомості робіт за участю в завданні понад 5 співробітників
* Виправлена помилка фільтрації за будівлі у списку операцій за складом ''(у деяких випадках)''

== 3.20.4 - 04.08.2025 ==
* Додано метод API->cross->[[API_cross_UK#edit_adapter|edit_adapter]]
* Доопрацьовано метод API->task->[[API_address_UK#edit_address|edit_address]]
* Додано параметр налаштування "Заблокувати виконання автоматизації/ланцюжка завдань під час поверненні завдання зі статусу із системною роллю "Відкладено"
* У списку завдань додано угруповання завдань за вулиці або населеному пункту
* Доопрацювання збереження прикріплених файлів до коментарів за завданням
* Невеликі виправлення та доопрацювання

== 3.20.3 - 27.07.2025 ==
* Доопрацьовано метод API->task->[[API_task_UK#change_state|change_state]]
* Додано параметр налаштування "З'єднання на дільниках вважати механічними"
* У налаштуваннях типів завдань для ТМЦ можна вказати, що переміщати всі ТМЦ після закриття на зв'язану будівлю
* У ланцюжках/автоматизації за типами завдань додано можливість додаткової умови "Статус дочірнього/батьківського завдання" для варіантів дій "Батьківське/Дочірнє завдання. Змінити статус на"
* У картці будівлі у списку ТМЦ додано інформацію про дату встановлення ТМЦ на будівлі та можливість експорту в XLS та у версію для друку
* У картці можна скопіювати всі прикріплені файли з іншого завдання
* У картці абонента додано пряме посилання на перегляд його маршруту комутації
* Для профілів співробітників можна обмежити максимальну кількість записів на сторінці ''(у таблицях/списках)''
* У фільтр зі споруд зв'язку додано можливість вибірки за відсутнім власним значком на карті
* У списку операцій за складу в селекторах вибору контрагента додано можливість вказівки конкретної будівлі
* У групових діях за будівлях додано можливість зміни індивідуального кольору на карті
* У групових діях за будинках можна змінити менеджера на порожнє значення ''(видалити менеджера)''
* Виправлено сортування за адресою у списку завдань ''(у деяких випадках)''
* Виправлена можливість одночасно відкласти завдання та вказати довільний коментар

== 3.20.2 - 18.07.2025 ==
* Додано метод API->task->[[API_task_UK#add_cable_line_to_task|add_cable_line_to_task]]
* Додано метод API->task->[[API_task_UK#remove_cable_line_from_task|remove_cable_line_from_task]]
* Список підключених ONU на OLT можна виводити на друк або експортувати до XLS
* Для споруд зв'язку та кабельних ліній додано можливість у групових діях змінювати нотатки
* У шаблоні спливаючої підказки на завдання на карті покриття можна відображати дату створення завдання, дату оновлення, текст останнього коментаря
* У ланцюжках/автоматизації за типами завдань додано дію "Абоненти. Виключити"
* Для ланцюжків/автоматизації в типах завдань додана можливість відключати автопризначуваних виконавців під час створення нового завдання за ланцюжку
* Доопрацьовано відображення посилань в описі типу завдань у картці завдання
* Виправлена фільтрація абонентів, що залежать від кросу/odf ''(у деяких випадках)''

== 3.20.1 - 12.07.2025 ==
* У списку будівель доданий фільтр за будівлях, у яких знято позначку "Відображати на карті"
* Виправлена неможливість відкрити картку автотранспорту зі списку
* Виправлено пошук за найменуванням кабельної лінії під час створення завдання ''(у деяких випадках)''
* Виправлення відображення інформації про абонента у списку завдань ''(у деяких випадках)''

== 3.20 - 09.07.2025 ==
* Реліз версії 3.20
* Список змін див. [[3.20_UK|3.20]]

Versions 3.21 EN

2026-07-12T13:11:10Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[Версії_3.21|uk]] | [[Версии_3.21|ru]]

Versions of the [[3.21_EN|3.21]] branch

Also see: [[Versions_of_ERP_"USERSIDE"|ERP "USERSIDE" versions]]

== 3.21.14 (in development) ==
* Building list filtering now supports filtering by the presence or absence of a communications installation on the building
* Added a new employee profile right: "Settings - Task statuses"
* Work calendar filters now let users configure their own order and visibility of departments and employees in the calendar
* Reworked the department list section. The appearance was changed, and quick search by employee/department was added
* When creating a new building in the address selection block, the new address is inserted immediately without reloading the current page
* Search results in the address selection block now show buildings and other address object types, making it faster to add new buildings, streets, and similar objects
* Improved the task card appearance on mobile devices
* Fixed coverage map performance when displaying the "Employees and vehicles" layer
* Fixed filtering in the building list ''(in some cases)''
* Fixed PDF file preview in the browser ''(in some cases)''
* Fixed filtering in the debtor customer list
* Fixed display of the "Settings-Addresses" section for employees with geography-limited access
* Fixed fiber rendering on the commutation scheme when a fiber has a label
* Fixed an error when displaying current-day tasks in the work calendar ''(in some cases)''

== 3.21.13 - 10.07.2026 ==
* '''When receiving inventory, multiple different inventory item names can now be specified at once'''
* Improved display of completed tasks in the calendar
* In the commutation scheme, splitters and distribution frames now have action buttons in object menus, as in the object cards ''(edit, delete, structural scheme, and so on)''
* Fixed commutation in the commutation scheme ''(in some cases)''
* Fixed duplicate requests during automatic ONU signal level refresh when opening an ONU card
* Fixed the task history appearance
* Fixed editing coverage map settings ''(in some cases)''
* Fixed object selection on the global commutation scheme ''(in some cases)''
* Fixed access-right checks for the ONU list for employees
* Fixed the rack/cabinet card appearance in the dark interface theme

== 3.21.12 - 09.07.2026 ==
* Improved API->[[API_redirect_EN|redirect]] method
* When splitting inventory into several parts, attached files are linked to all resulting inventory items
* Improved the cable line add dialog opened from a communications installation
* Added the setting parameter "Display completed tasks with opacity (%)"
* Fixed the "Display completed tasks in gray" setting parameter
* Fixed display of the MAC address field when receiving inventory
* Fixed additional field dependency handling
* Fixed attached-file handling in vehicle operations
* Fixed navigation to communications installation table field settings
* Fixed task information appearance on the "Technical support" tab in the customer card
* Fixed errors when viewing user action history ''(in some cases)''
* Fixed an error when opening the inventory selection dialog for integration
* Fixed moving object positions on the global commutation scheme
* Fixed reserve specification for cable lines
* Fixed an error when receiving inventory and auto-assigning inventory numbers ''(in some cases)''
* Fixed employee access settings for addresses

== 3.21.11 - 08.07.2026 ==
* Fixed the appearance of the task type rights settings table
* Fixed changing the position of a separate communications installation commutation scheme on the shared global commutation scheme
* Fixed task filtering in the "My tasks" section ''(in some cases)''
* Fixed changing address object coordinates from the building card
* Fixed assignee sorting when creating a task
* Fixed changing sector coordinates for radio equipment
* Fixed access-right checks when opening a device card ''(in some cases)''
* Fixed hiding/showing a communications installation on the coverage map

== 3.21.10 - 07.07.2026 ==
* Added API->call->[[API_call_EN#edit|edit]] method
* Added new user profile rights "Owners (access to financial information)" and "Tenants (access to financial information)"
* '''Implemented inventory transfer to an employee with employee confirmation of receipt/refusal'''
* In group actions for communications installations, creating a common task or separate tasks now creates tasks through the standard task-add dialog
* Fixed marking a task as read in news when opening the task card
* Fixed display of the latest inventory operation date in the list of inventory by object
* Fixed document print generation from the task card
* Fixed commutation of free cable fibers to each other ''(in some cases)''
* Fixed editing coordinates for a communication line
* Fixed display of stray artifacts on the global commutation scheme ''(in some cases)''
== 3.21.9 - 06.07.2026 ==
* SMS mailing exclusions can now exclude customers with a specific period of negative balance
* The "Problem buildings/customers" statistics can now use custom filters
* In task type settings, the additional fields section now separately specifies the additional field types that can be used when changing task status. Task status settings also now include the "Display additional fields" property
* Added the ability to automatically create a work task for unanswered phone calls
* User password changes were moved to a separate dialog window

== 3.21.8 - 04.07.2026 ==
* Improved API method API->customer->[[API_customer_EN#get_customers_id|get_customers_id]]
* Improved the appearance of tasks in the work calendar
* In group actions for customers, task creation now uses a full dialog for specifying properties of the tasks being created
* Optimized the structural scheme
* Fixed setting conditions in SMS mailings ''(in some cases)''
* Fixed setting custom coordinates for a customer
* Fixed saving a system device
* Fixed object display on the global commutation scheme ''(in some cases)''
* Fixed commutating a cable line to a device in the customer's commutation scheme
* Fixed changing custom coordinates for equipment
* Fixed the tariff exclusion filter in SMS mailings

== 3.21.7 - 03.07.2026 ==
* Planning mode in the work calendar
* Fixed search in the communications installation list ''(in some cases)''
* Fixed attached-file display in a communications installation card when the user has read-only rights
* Fixed viewing/creating SMS mailings ''(in some cases)''
* Fixed signal level display for ONU ''(in some cases)''
* Fixed attenuation display on the structural scheme for OLT ''(in some cases)''
* Fixed an error when viewing employee history ''(in some cases)''
* Fixed incorrect activity date output in the coverage map tooltip for transport
* Fixed the ability to exclude a customer from a task

== 3.21.6 - 02.07.2026 ==
* Added IP address usage history
* Improved use of the ruler on the coverage map
* Fixed cable line appearance on the coverage map according to tag settings ''(in some cases)''
* Fixed the equipment list in the "Inactive switches" home-page widget
* Fixed adding new communications installation schemes to the global commutation scheme
* Fixed equipment database search when adding an inventory item name to the product catalog
* Fixed clearing equipment port commutation ''(in some cases)''
* Fixed an error in the inventory balance report ''(in some cases)''
* Fixed specifying custom reserves/objects on a cable line route
* Fixed switching commutation to a port of another device on a communications installation
* Fixed object display on the coverage map in group operations for communications installations
* Fixed changing the commutation path in the commutation scheme ''(in some cases)''

== 3.21.5 - 01.07.2026 ==
* Added notifications when editing a task ''(configurable)''
* Improved collecting information from ONU interfaces
* Improved equipment port appearance for the dark theme
* Task types can now specify actions with inventory: transfer the required inventory currently assigned to a customer from that customer to the selected warehouse
* Fixed quick search by the required equipment category in the equipment list
* Fixed selection of other devices on the same communications installation in the port switching dialog
* Fixed display of warehouses available to an employee ''(in some cases)''
* Fixed an error when viewing an inventory item card ''(in some cases)''
* Fixed automatic building selection when adding a communications installation from a building card
* Fixed viewing the list of polled devices in the usm_observer module
* Fixed the ability to change the color of a connection between devices in the commutation scheme

== 3.21.4 - 30.06.2026 ==
* Improved API method API->attach->[[API_attach_EN#upload|upload]]
* Added a separate email notification profile for sending messages to corporate customers
* Improved sorting by building in the communications installation list
* The work calendar opens on the current date
* Improved the task calendar for cases where several tasks are scheduled for the same time
* Implemented multilevel task type groups
* Task news can now partially mark events as read and group news by task
* Task automation can now send Email messages to customers ''(using configurable templates)''
* Improved popup notification output when assigning an employee department to a task
* Fixed attached-file block display in custom sections when the user has read-only rights
* Fixed opening a customer card from the coverage map
* Fixed an error when configuring status availability for employee profiles in a task type card
* Fixed filtering by dates in the task list ''(in some cases)''
* Fixed task author display in the task list
* Fixed display of the "Notes" field in the communications installation card
* Fixed an error when trying to delete an address object ''(in some cases)''
* Fixed the ability to disable/enable a device port
* Fixed viewing global commutation schemes ''(in some cases)''

== 3.21.3 - 28.06.2026 ==
* Improved API method API->inventory->[[API_inventory_EN#transfer_inventory|transfer_inventory]]
* Improved API method API->commutation->[[API_commutation_EN#delete|commutation]]
* Improved API method API->node->[[API_node_EN#get|get]]
* Improved API method API->address->[[API_address_EN#get_house|get_house]]
* The scheduler task "Send low-stock information" can now specify the delivery options "E-mail/Messenger"; the employee card also now lets you specify delivery options for this mailing in the "Notifications" section
* The inventory list in the task card can now transfer all inventory items to the selected recipient at once
* Quick value search was added to custom fields of the "List selection" type
* Improved the use of explicitly specified coordinates when editing a building card and selecting a polygon/point
* Fixed creating cable lines to a building from the coverage map
* Fixed an error when opening Settings - Modules ''(in some cases)''
* Fixed grouping in the task list ''(in some cases)''
* Fixed deleting a label from the switching scheme
* Fixed the "Show dismissed employees in selectors/search for N days after dismissal" parameter
* Fixed warehouse availability checks when selecting inventory items during task execution
* Fixed the "Show tasks by actual completion date" variable
* Fixed using task-type appearance color settings in the calendar
* Fixed coverage-map search ''(substituting the current locality in the search window)''
* Fixed navigation from a customer card to the map with the customer's building coordinates
* Fixed saving interfaces/stacking in the device card

== 3.21.2 - 26.06.2026 ==
* Improved API method API->address->[[API_address_EN#get_house|get_house]]
* When transferring inventory from a customer card, the sub-account receiving the inventory can now be selected
* When creating/editing a task for a building, information about building tags and the building note is shown
* When creating a task in a chain, a specific custom assignee/department can be specified separately
* Bulk inventory transfer now creates combined transfer operations instead of separate operations for each item
* The task list filter-result grouping now has a "Completion date (month)" option
* Fixed an error when creating a task ''(in some cases)''
* Fixed changing coordinates in building, communications installation, and customer cards ''(in some cases)''
* Fixed generation of communications-installation names when selecting a building floor ''(in some cases)''
* Fixed link handling in text values of custom fields
* Fixed assigning assignees when creating a task ''(in some cases)''

== 3.21.1 - 25.06.2026 ==
* Improved map centering when editing a polygon/building on the coverage map
* Fixed displaying global switching schemes ''(in some cases)''
* Fixed exporting the cable line list to XLS ''(in some cases)''
* Fixed correct rendering of customers on the building logical scheme ''(in some cases)''
* Fixed selecting parent objects when adding a building from the coverage map
* Fixed attaching a customer when adding a new task for a customer
* Fixed minor bugs

== 3.21.0 - 23.06.2026 ==
* Version release

== 3.21.0-beta.7 - 21.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.6 - 20.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.5 - 17.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.4 - 13.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.3 - 07.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.2 - 30.05.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.1 - 24.05.2026 ==
* See the list of changes in [[3.21_EN|3.21]]

Versions 3.20 EN

2026-07-12T13:11:10Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[Версії_3.20|uk]] | [[Версии_3.20|ru]]

Branch versions [[3.20_EN|3.20]]

Also see: [[Versions of ERP "USERSIDE"]]

== 3.20.26 (in development) ==
* Fixed employee login generation/transliteration on creation ''(in some cases)''
* Fixed an error when building the inventory balance by tasks report
* Fixed an error when viewing the customer growth chart ''(in some cases)''
* Minor changes and bug fixes

== 3.20.25 - 24.06.2026 ==
* Improved the display of planned cable lines on the coverage map according to cable-density color settings
* Fixed a bug with displaying the cable line list ''(in some cases)''
* Fixed minor bugs and changes

== 3.20.24 - 27.05.2026 ==
* Fixed minor bugs and changes

== 3.20.23 - 27.04.2026 ==
* Added API method->call->[[API_call_EN#agent_call|agent_call]]
* Added API method->chapter->[[API_chapter_EN#link_add|link_add]]
* Added API method->chapter->[[API_chapter_EN#link_get|link_get]]
* Added API method->chapter->[[API_chapter_EN#link_remove|link_remove]]
* Improved API method->call->[[API_call_EN#add|add]]
* Improved API method->task->[[API_task_EN#edit|edit]]
* Completed tasks now also show the "Overdue" flag when work deadlines are missed
* Fixed a bug when opening the work calendar ''(in some cases)''
* Fixed minor bugs

== 3.20.22 - 04.04.2026 ==
* Fixed selecting an empty value in the task type for registration by phone
* Optimization work
* Fixed minor bugs

== 3.20.21 - 11.03.2026 ==
* Fixed display of the error counter on equipment interfaces ''(in some cases)''
* Fixed SMS message template settings for customers in tasks
* Optimization work
* Fixed minor bugs

== 3.20.20 - 22.02.2026 ==
* Optimized the "My tasks" section
* Fixed broken main menu layout in some cases

== 3.20.19 - 08.02.2026 ==
* Fixed minor bugs

== 3.20.18 - 23.01.2026 ==
* Optimized the warehouse report "Turnover balance sheet"
* Fixed minor bugs

== 3.20.17 - 31.12.2025 ==
* Added API method->task->[[API task#add_node_to_task|add_node_to_task]]
* Added API method->task->[[API task#remove_node_from_task|remove_node_from_task]]
* Fixed execution of task chain ''(in some cases)''
* Fixed minor bugs

== 3.20.16 - 14.12.2025 ==
* Fixed a bug with filtering by inventory section in the warehouse operations list
* Fixed minor bugs

== 3.20.15 - 06.12.2025 ==
* For task chains/automation in task types, added the ability to specify fractional hour intervals
* Fixed minor bugs

== 3.20.14 - 29.11.2025 ==
* Improvements to the API interface with Binotel
* Fixed minor bugs

== 3.20.13 - 22.11.2025 ==
* Fixed minor bugs

== 3.20.12 - 15.11.2025 ==
* Added the setting "Scale the width of the cable line on the switching diagram depending on the length of the name"
* Improved the display of unknown ONUs by OLT in the main page widget
* Fixed other minor bugs

== 3.20.11 - 08.11.2025 ==
* Fixed an error when entering the Custom notifications section ''(in some cases)''
* Fixed an error when entering the device interface/stacking settings ''(in some cases)''
* Fixed the inability to switch between ODF/crosses in the switching master
* Fixed some migration errors

== 3.20.10 - 07.11.2025 ==
* Added API method->vehicle->[[API vehicle#add|add]]
* Added API method->vehicle->[[API vehicle#edit|edit]]
* Added API method->vehicle->[[API vehicle#delete|delete]]
* In the communication installations card, in the block with attached image files, it is possible to quickly make an image the main photo for this object ''(without having to go to editing)''
* In the cable line card, the ability to create a task with this line or add a line to an existing task has been added
* Sorting by additional fields in custom sections has been improved
* Filtering by inventory item name in the inventory list has been fixed
* The display of equipment layers on the coverage map has been fixed
* Other minor bugs have been fixed

== 3.20.9 - 14.09.2025 ==
* Improved verification of access rights to ONU
* Fixed a bug when searching for a user during the transfer of inventory items ''(in some cases)''
* Fixed an update in the serial number database for ONU when polling OLT ''(in some cases)''

== 3.20.8 - 06.09.2025 ==
* Added API method->billing->[[API billing#refresh_date_update|refresh_date_update]]
* Optimised interface for editing/adding address units ''(relevant for branched address structures)''
* Links to view users associated with communication installations and cable lines have been added to the task card
* Fixed checking for parent task status in task automation ''(in some cases)''
* Fixed display of pop-up hints in the task calendar when scrolling horizontally
* Fixed assignment of employees to a department ''(in some cases)''

== 3.20.7 - 25.08.2025 ==
* '''In-depth processing of transport operations. Various types, mileage control, deadlines. Notification on the main page and transport list. Keeping a history of changes in operations'''
* The history of actions for a potential user is transferred to the history of actions for a regular user when they are merged
* During hot replacement of a device, you can specify to save the history of MAC addresses on equipment ports
* The ability to clear switching has been added to group actions on the user list
* Technical migration of core data
* Fixed filtering of the FDB table by device ''(in some cases)''
* Fixed a bug when restricting an employee's access to a specific IP address
* Fixed ONU access rights verification

== 3.20.6 - 15.08.2025 ==
* ''' Separate SMS profiles for work. For example, you can specify a separate SMS profile for each SMS mailing ''(your own alpha name, different operator, etc.)'''''
* Separated ONU access rights for viewing and editing
* Fixed display of a large number of notebook sections in the section list
* Fixed information update when adding/removing a communication facility in a task

== 3.20.5 - 08.08.2025 ==
* Added API method->address->[[API address#get_building_type|get_building_type]]
* Added the "Buildings. Pop-up message template on the map" setting
* Improved the interface for changing notes, adapter types, and connections for fibre cable lines
* Redesigned the interface for adding communication structures and cable lines to a task when creating a task
* Corrected the verification of access rights to the work schedule
* Improved the billing of employees for tasks in the work schedule when more than 5 employees are involved in the task
* Fixed a bug in filtering by building in the list of warehouse operations ''(in some cases)''

== 3.20.4 - 04.08.2025 ==
* Added API method->cross->[[API cross#edit_adapter|edit_adapter]]
* Added API method->task->[[API address#edit_address|edit_address]]
* Added a setting parameter "Block automation/task chain execution when returning a task from the status with the system role 'Pending' "
* Added grouping of tasks by street or location to the task list
* Improved saving of files attached to task comments
* Minor fixes and improvements

== 3.20.3 - 27.07.2025 ==
* Added API method->task->[[API task#change_state|change_state]]
* The "Consider connections on dividers as mechanical" configuration parameter has been added
* In the task type settings for inventory items, you can specify that all inventory items should be moved to the associated building after closing
* In chains/automation by task type, the additional condition "Child/parent task status" has been added for the action options "Parent/Child task. Change status to"
* Information about the date of installation of inventory items on the building and the ability to export to XLS and printable versions has been added to the building card in the inventory list
* All attached files from another task can be copied to the card
* A direct link to view the customer's switching route has been added to the customer card
* For employee profiles, you can limit the maximum number of entries on the page (in tables/lists)
* The filter for communication facilities now includes the option to select by missing custom icon on the map
* In the list of warehouse operations in the counterparty selection selectors, the ability to specify a specific building has been added
* In group actions for buildings, the ability to change the individual colour on the map has been added
* In group actions for buildings, you can change the manager to the empty value ''(delete manager)''
* Fixed sorting by address in the task list ''(in some cases)''
* Fixed the ability to simultaneously postpone a task and specify an arbitrary comment

== 3.20.2 - 18.07.2025 ==
* Added API method->task->[[API task#add_cable_line_to_task|add_cable_line_to_task]]
* Added API method->task->[[API task#remove_cable_line_from_task|remove_cable_line_from_task]]
* The list of connected ONUs on the OLT can be printed or exported to XLS
* For communication installations and cable lines the possibility to change notes in group actions has been added
* In the template of the tooltip on the task on the coverage map it is possible to display the date of task creation, update date, text of the last comment
* In chains/automation by task type, added action "Customers. Exclude."
* In chains/automation by task types, added possibility to disable auto-assigned executors when creating a new task in a chain
* Improved displaying of links in the description of a task type in the task card
* Fixed filtering of customers that depend on cross/odf ''(in some cases)''

== 3.20.1 - 12.07.2025 ==
* In the list of buildings, added filter for buildings with "Display on map" unchecked
* Fixed inability to open a vehicle card from the list
* Fixed search by cable line name when task is created ''(in some cases)''
* Fixed display of customer information in the task list ''(in some cases)''

== 3.20 - 09.07.2025 ==
* Release version 3.20
* For a list of changes see [[3.20_EN|3.20]]

3.21 UK

2026-07-12T13:10:33Z

IronBot: [IronBot] Sync UK localization from RU

[[3.21_EN|en]] | '''uk''' | [[3.21|ru]]

Дата випуску: '''червень 2026'''

''Основні зміни: https://promo.userside.eu/321/''

Див. також:
* [[Оновлення 3.21|Оновлення до версії 3.21]]
* [[Версії ERP "USERSIDE"]] | [[Версії 3.21|Версії 3.21]]

== Перелік змін ==

'''Особливої важливості:'''
* [[PWA (застосунок)|PWA ''(застосунок)'']]
* Автоматична побудова [[Бізнес-процес|схеми бізнес-логіки/робочого процесу]] для типів завдань на основі ланцюжків/автоматизації
* [[Календар|Оновлений календар]] завдань та [[Інтеграція з Google-календарем|інтеграція з Google-календарем]]
* Окремий [[Масова передача ТМЦ|інтерфейс для швидкої передачі ТМЦ]] через сканування або введення штрихкодів, серійних номерів тощо ''(зокрема з підтримкою сканування штрихкодів камерою мобільного пристрою)''
* [[Схема комутації#anchor_321|Снапшоти схем комутації]] виводяться на основній схемі та формуються безпосередньо під час операцій комутації/розриву комутації на споруді зв'язку
* У схемі комутації створення з'єднань, видалення та зміна ламаної з'єднання виконуються без перезавантаження й очікування сторінки ''(на практиці це пришвидшило роботу у 2-10 разів)''
* Панель на головній сторінці з [[Список завдань#anchor_321|лічильниками фільтрів за завданнями/показниками KPI]]
* "Фізичне" [[Підписання документів з абонентами|підписання документів з абонентами/клієнтами]] на планшетах ''(мобільних пристроях)''
* Реалізовано автооновлення GPS-позиції транспорту на мапі в реальному часі ''(кожні N секунд)''
* Віджет на головну сторінку: [[Статистика_UK#anchor_321|найпроблемніші абоненти та будинки]]
* Нова [[Структурна схема|структурна схема]]. Масштабування, збереження у SVG
* [[Internal API UK|Internal API]] v2. Подієва система в ERP
* Підтримка обліку IPv6 для обладнання та абонентів
* Оновлений UI/UX

'''Абоненти/клієнти:'''
* Реалізовано масовий імпорт потенційних абонентів
* У групових діях за абонентами додано можливість надіслати SMS
* '''В умовах SMS-розсилки можна додавати конкретних абонентів'''
* В SMS-розсилці додано фільтр "Ігнорувати відмову від отримання SMS"
* У груповому надсиланні email абонентам додано різні шаблони з даними про абонента
* У листуванні з абонентом можна вимкнути відображення коментарів за завданнями
* Додано зберігання історії статусів абонентів
* Додано історію використання IP-адрес
* Список абонентів:
** '''У фільтрі підтримується режим "і/або"'''
** '''У фільтрі додано можливість включати/виключати умови ''(раніше можна було лише включати)'''''
** Додано фільтр "Абоненти, включені в обладнання"
** Додано фільтр за номером завдання. Також у картці завдання, де прикріплено від 3 абонентів, додано посилання на цей фільтр
** У списку абонентів додано можливість відображати поле "Менеджер"
** У списку залежних абонентів від пристрою/споруди зв'язку також враховуються абоненти, які не скомутовані, але мають пристрої ''(наприклад ONU)'', залежні від батьківського об'єкта

'''Обладнання:'''
* '''Додано вкладки в картці комутатора/обладнання'''
* Якщо для пристрою не вказано IP-адресу, він має один порт і при цьому підключений до вищого керованого комутатора, то в таблиці портів цього пристрою виводитиметься SNMP-інформація з порту вищого пристрою
* PON:
** '''Історія зміни рівня сигналу ONU тепер виводиться у вигляді графіка'''
** Для списку підключених ONU можна налаштувати порядок і відображення полів
** У картці OLT на портах виводиться лічильник кількості ONU на них
* Можна вказувати відсотки поділу для запланованих дільників
* У таблиці дільників додано поле "Кількість зайнятих адаптерів"
* У картці VLAN додано можливість вручну додавати пристрої

'''Схема комутації:'''
* Написи на схемі комутації можна повертати під кутом
* Під час додавання дільника зі схеми комутації більше не відбувається перехід у картку дільника: користувач залишається у схемі
* У майстрі комутації додано можливість комутації пристроїв
* Для кросу/ODF у схемі комутації додано можливість швидко змінювати підписи для всіх портів одразу
* Для запланованих комутацій у схемі перепланування додано можливість змінювати маршрут вручну
* Для мобільних пристроїв перетягування ліній комутації типово заблоковане під час відкриття сторінки

'''Завдання:'''
* Впроваджено багаторівневі групи типів завдань
* Оновлений [[Календар|календар завдань]]:
** '''перетягування завдань ''(зміна часу робіт)'''''
** можна змінювати строк виконання завдання ''(перетягувати нижню межу)''
** тижневий/місячний режим для підрозділів і співробітників
** режим "підрозділ"/"+співробітники"/"+співробітники і підрозділи"
** 15/30/60 хвилин ''(раніше тільки слоти по 1 годині)''
** позначається факт високого пріоритету, а також можна налаштовувати шаблон інформації для заголовка завдання і тіла завдання
* '''Перевірка існування раніше прикріпленого файла в завданнях і коментарях до завдання ''(щоб запобігти спробам співробітників прикріплювати старі файли, видаючи їх за нові)'''''
* У картці завдання додано можливість однією кнопкою передати ТМЦ із доступних цьому співробітнику
* Новий спецтип для типів завдань: "Роботи з боржниками"
* У картці завдання виводиться рядок з координатами і швидким переходом на Google-мапу
* Під час створення дочірнього завдання з картки завдання додано можливість копіювати ''(використовувати)'' також файли з батьківського завдання
* Дороблено відображення інформації про ТМЦ у списку ТМЦ під час зміни статусу завдання
* "Робочі нотатки" розширено з будинків на будь-який адресний об'єкт

* Нові параметри налаштування:
** "У картці завдання сортувати абонентів за порядком їх додавання в завдання"
** "Інтервал для відображення завдань у розділі "Мої завдання" (днів)"
** "Заблокувати виконання автоматизації/ланцюжка завдань під час повернення завдання зі статусу із системною роллю "Відкладено"

* Ланцюжки завдань/автоматизація:
** Додано додаткову умову "Завдання. Мітка"
** Додано варіанти дій:
*** "Батьківське завдання (найперше в ланцюжку). Змінити статус на"
*** "Батьківське завдання (усі в ланцюжку). Змінити статус на"
*** "ТМЦ. Передати в батьківське завдання"
*** "ТМЦ. Передати в дочірнє завдання"
*** "Перенесення значень додаткових полів у картку будинку"

* Список завдань:
** У списку завдань виводяться мініатюри прикріплених файлів ''(параметр налаштування)''
** Фільтр завдань:
*** додано режими "і/або"
*** розширено фільтр за номером батьківського завдання
*** розширено фільтр за "Виконано зі строком виконання понад..."
*** розширено фільтр за номером батьківського завдання
*** додано фільтр за значенням чек-листа
** У списку завдань додано групові дії:
*** "Абоненти - Відкрити список"
*** "Призначити власника"
*** "Виключити власника"

'''Склад:'''
* Реалізовано передачу ТМЦ співробітнику з підтвердженням отримання/відмови від отримання співробітником
* '''Під час приходу ТМЦ тепер можна одразу вказувати кілька різних найменувань ТМЦ'''
* '''В операціях за складом додано фільтрацію за "Адреса (з об'єктами)", що дозволяє вибрати операції передачі ТМЦ на всі об'єкти цієї території'''
* '''У списку ТМЦ додано можливість фільтрації за будь-яким адресним об'єктом ''(включно з усім підпорядкуванням)'' ''(область, місто, вулиця...)'''''
* У списку ТМЦ виводиться підсумковий рядок із загальною вартістю/закупівельною вартістю
* У звіті щодо залишків ТМЦ назви позицій ТМЦ зроблено посиланнями для швидкого перегляду списку цих ТМЦ
* Групи для постачальників
* Додано можливість надсилати повідомлення співробітнику в Messenger/Telegram під час передачі ТМЦ йому під звіт/з-під звіту
* Під час розділення ТМЦ додано можливість одразу вказувати MAC-адреси/серійні номери для цих ТМЦ

'''Покриття:'''
* Реалізовано автооновлення GPS-позиції транспорту на мапі в реальному часі ''(кожні N секунд)''. Додано параметр налаштування "Інтервал оновлення позиції транспорту на мапі"
* '''Коли на мапі кілька об'єктів накладено один на одного ''(споруди зв'язку в одній точці/багато муфт на опорі... або кабельні лінії проходять поруч)'', то під час наведення на це скупчення об'єктів воно розкривається з можливістю вибрати потрібний'''
* Доробка відображення на мапі кабельних ліній, які проходять через екран, але мають кінцеві точки поза поточною областю відображення
* Нова лінійка на мапі
* Новий тип об'єктів на мапу: "Посилання"
* У спливних підказках на полігонах на мапі виводяться значення додаткових полів
* У списку будинків додано можливість виведення поля з відсотком проникнення, поле "Нотатки" і фільтр за цим полем

'''Споруди зв'язку:'''
* Для споруди зв'язку можна вказати приховування її з мапи покриття
* Для типів споруд зв'язку додано параметр "Під час додавання об'єкта пропонувати новий номер"
* У макеті шафи/стійки у спливних підказках на пристроях додано відображення серійного/інвентарних номерів

'''Кабельні лінії:'''
* У списку кабельних ліній додано фільтр за додатковими полями
* У групових діях із заміни марки кабелю в списку кабельних ліній додано можливість під час цієї дії замінювати кольори модулів/волокон/провідників у кабелі відповідно до нової марки кабелю

'''Співробітники:'''
* Налаштування в персональному налаштуванні: додаткові кнопки для лівого меню в мобільній версії, зокрема власні посилання
* Нові права в профілях співробітників:
** Перегляд/зміна інформації про постачальників
** Перегляд/зміна штрафів і премій персоналу
** Налаштування - Статуси завдань

'''API:'''
* '''Можна створювати окремі [[UserSide API Key UK|API-ключі]] тільки для операцій читання даних'''
* '''Усі запити на запис/зміну даних тепер мають надсилатися лише через POST'''
* У запиті не повинно бути сторонніх параметрів. Якщо сторонній параметр присутній, запит повертатиме помилку
* Доопрацьовано метод API->address->[[API_address_UK#edit_address|edit_address]]
* Доопрацьовано метод API->attach->[[API_attach_UK#add|add]]
* Додано метод API->attach->[[API_attach_UK#upload|upload]]

'''Транспорт:'''
* '''Глибоко перероблено операції за транспортом. Різні типи, контроль пробігу, строків. Повідомлення на головну сторінку і список транспорту. Ведення історії змін в операціях'''

'''Інше:'''
* PHP 8.4
* Додано локалізації: албанська, узбецька, таджицька. Численні виправлення в поточних локалізаціях.
* '''Модуль [[usm_asterisk]] тепер підтримує передачу записів дзвінків і можливість прослуховувати їх в інтерфейсі ERP'''
* Перехід із числових ID на рядкові UUID в об'єктах ''(числові ID для частини об'єктів залишено як додаткові довідкові)''
* Новий редактор WYSIWYG
* '''Темна схема інтерфейсу ''(з підтримкою автоматичного перемикання)'''''
* '''Редагування значень додаткових полів у картках об'єктів прямо в режимі перегляду ''(без потреби переходити в редагування)'''''
* '''Перероблено блок роботи з прикріпленими файлами'''
** Повністю інші можливості, галерея, дії тощо
** Для мобільних пристроїв швидка кнопка "Фотографувати"
** Для мобільних пристроїв велика кнопка додавання файлів
** Блок Ctrl+V для роботи з буфером обміну тепер підтримує вставлення кількох зображень і файлів будь-яких форматів ''(а не лише зображень)''
* Нове ліве адаптивне меню з можливістю приховування/відкриття
* '''Додано кнопки в лівому меню для мобільних пристроїв:'''
** "Моя позиція на мапі"
** QR-код
** Штрихкод ''(+ може подавати звуковий сигнал під час сканування)''. Якщо є такий ТМЦ, відкривається картка ТМЦ; якщо немає прав до ТМЦ, але є таке обладнання, відкривається картка обладнання. Інакше відкривається список пошуку
** Три кнопки для власних посилань
** Кнопки поділитися посиланням/відкрити посилання
* '''Опція "Конвертувати HEIC-файли в JPEG" і власне підтримка роботи з .heic файлами на льоту'''
* Розділ "Блокнот" трансформувався в налаштовуваний власний розділ. Це значно розширює його функціональність
* Нова бібліотека генерації штрихкодів ''(у SVG-форматі)''
* Дороблено звіт за надходженнями коштів: групування за населеними пунктами, а також за населеними пунктами + місяцями, і можливість детального перегляду списку платежів
* У групових діях за об'єктами кнопка "Застосувати" тепер містить кількість позначених об'єктів і блокується, якщо не вибрано дію/об'єкти
* Селектор вибору дати/дати-часу: виправлено локалізацію під поточну мову
* Превентивно впроваджено рішення для забезпечення сумісності з датами після 2038 року ''("Unix 2038 bug")''
* Окремі SMS-профілі для роботи. Наприклад, для кожної SMS-розсилки можна вказати окремий SMS-профіль ''(власне альфа-ім'я, інший оператор...)''
* У списках об'єктів у фільтрацію за значеннями додаткових полів додано варіанти фільтрації "більше" і "менше"
* Нові версії зовнішніх [[Модулі|модулів]]

* Інші зміни: див. https://wiki.userside.eu/3.20

API call UK

2026-07-12T13:10:33Z

IronBot: [IronBot] Sync UK localization from RU

[[API_call_EN|en]] | '''uk''' | [[API call|ru]]

Розділ '''[[API_UK|API]]''' ERP "UserSide"

Призначення: Дзвінки

Додаткові параметри:
action - підкатегорія запиту ''(можливе значення: див. нижче)''

== Підкатегорії ==

==== add ====

''Доопрацьовано у: 3.21.0 (додано параметр line)''

''Доопрацьовано у: 3.20.23 (додано параметри caller_id_name і direction, додано можливість змінювати запис про дзвінок на підставі phone_system_uuid)''

''Додано у: 3.18beta1''

Опис: Створення запису про дзвінок / зміна інформації про дзвінок на підставі phone_system_uuid
Обов'язкові параметри:
number - номер абонента, що викликає
Необов'язкові параметри:
answer_number - номер, що викликається
caller_id_name - ім'я абонента, що викликає
date_add - дата виклику
direction - напрямок виклику ''(in|out)''
line - номер або назва вхідної лінії для вхідного дзвінка або номер вихідної лінії для вихідного дзвінка
phone_system_uuid - ID виклику в зовнішній системі телефонії



==== dial ====

''Додано у: 3.21.0''

Опис: Передавання вхідного виклику отримувачу (на виклик ще не відповіли)
Обов'язкові параметри:
phone_system_uuid - ID виклику в зовнішній системі телефонії
answer_number - номер, що викликається
Необов'язкові параметри:
line - номер або назва вхідної лінії для вхідного дзвінка або номер вихідної лінії для вихідного дзвінка
number - номер абонента, що викликає

==== edit ====

''Додано у: 3.21.10''

Опис: Редагування виклику
Обов'язкові параметри:
id - id виклику
Необов'язкові параметри:
description - текст коментаря
description_employee_id - id співробітника, який залишив коментар

==== get ====

''Додано у: 3.16dev3''

Опис: Список дзвінків
Обов'язкові параметри:
немає
Необов'язкові параметри:
date_from - дата й час дзвінка (з)
date_to - дата й час дзвінка (до)

==== hangup ====

''Додано у: 3.18beta1''

Опис: Фіксація факту завершення дзвінка
Обов'язкові параметри:
id - ID виклику
АБО
phone_system_uuid - ID виклику в зовнішній системі телефонії
Необов'язкові параметри:
record_url - посилання на запис виклику

==== transfer_call ====

''Додано у: 3.18beta1''

Опис: Передавання інформації про дзвінок і самого дзвінка іншому співробітнику
Обов'язкові параметри:
id - ID виклику
АБО
phone_system_uuid - ID виклику в зовнішній системі телефонії
Необов'язкові параметри:
answer_number - номер, що викликається

3.21 EN

2026-07-12T13:10:33Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[3.21_UK|uk]] | [[3.21|ru]]

Release date: '''June 2026'''

''Main changes: https://promo.userside.eu/321/''

See also:
* [[Upgrade_3.21|Upgrade to version 3.21]]
* [[Versions of ERP "USERSIDE"]] | [[Versions 3.21 EN|Versions 3.21]]

== List of changes ==

'''High-priority changes:'''
* [[PWA (application)|PWA ''(application)'']]
* Automatic building of a [[Business process|business logic/workflow diagram]] for task types based on task chains and automation
* Updated task [[Calendar|calendar]] and [[Google Calendar integration|Google Calendar integration]]
* A separate [[Bulk inventory transfer|interface for fast inventory transfer]] by scanning or entering barcodes, serial numbers, and other identifiers ''(including barcode scanning with a mobile device camera)''
* [[Switching scheme#anchor_321|Switching scheme snapshots]] are shown on the main scheme and are generated directly during switching/disconnection operations on a communications installation
* In the switching scheme, creating connections and deleting or changing a connection polyline is performed without reloading or waiting for the page ''(in practice, this made work 2-10 times faster)''
* A home-page panel with [[Work schedule#anchor_321|task filter counters/KPI indicators]]
* "Physical" [[Document signing with customers|document signing by customers/clients]] on tablets ''(mobile devices)''
* Automatic real-time GPS position updates for transport on the map ''(every N seconds)''
* Home-page widget with [[Statistics#anchor_321|the most problematic customers and buildings]]
* New [[Structural scheme|structural scheme]]. Scaling and SVG export
* [[Internal API EN|Internal API]] v2. Event system in ERP
* IPv6 accounting support for equipment and customers
* Updated UI/UX

'''Customers/clients:'''
* Added mass import of potential customers
* Added the ability to send SMS in group actions for customers
* '''Specific customers can be added to SMS mailing conditions'''
* Added the "Ignore SMS opt-out" filter to SMS mailings
* Added different customer-data templates for group email sending to customers
* Customer correspondence can hide comments from tasks
* Added customer status history storage
* Added IP address usage history
* Customer list:
** '''The filter now supports "and/or" mode'''
** '''The filter can now include/exclude conditions ''(previously it could only include them)'''''
** Added the "Customers included in equipment" filter
** Added filtering by task number. The task card also shows a link to this filter when at least three customers are attached to the task
** The customer list can display the "Manager" field
** The list of customers dependent on a device/communications installation also includes customers that are not commutated but have devices ''(for example ONU)'' that depend on the parent object

'''Equipment:'''
* '''Added tabs to the switch/equipment card'''
* If a device has no IP address, has one port, and is connected to an upstream managed switch, the port table for that device shows SNMP information from the upstream device port
* PON:
** '''ONU signal level history is now displayed as a chart'''
** The order and displayed fields can be configured for the list of connected ONUs
** The OLT card now shows an ONU counter on ports
* Split percentages can be specified for planned splitters
* Added the "Number of occupied adapters" field to the splitters table
* Devices can be added manually in the VLAN card

'''Switching scheme:'''
* Labels on the switching scheme can be rotated
* When adding a splitter from the switching scheme, the user no longer leaves the scheme for the splitter card
* The switching wizard can now switch devices
* Added the ability to quickly change labels for all ports at once for a distribution frame/ODF in the switching scheme
* Planned commutations in the replanning scheme can now have their route changed manually
* On mobile devices, dragging switching lines is blocked by default when the page is opened

'''Tasks:'''
* Implemented multilevel task type groups
* Updated task [[Calendar|calendar]]:
** '''dragging tasks ''(changing work time)'''''
** task due time can be changed ''(by dragging the lower boundary)''
** weekly/monthly mode for departments and employees
** modes: "department" / "+ employees" / "+ employees and departments"
** 15/30/60 minutes ''(previously only one-hour slots)''
** high priority is marked, and the information template for the task title and task body can be configured
* '''Checks whether a previously attached file still exists in tasks and task comments ''(to prevent employees from attaching old files as if they were new)'''''
* The task card can transfer inventory available to the employee with one button
* Added a new special type for task types: "Work with debtors"
* The task card shows a row with coordinates and a quick link to Google Maps
* When creating a child task from the task card, files from the parent task can also be copied ''(used)''
* Improved display of inventory information in the inventory list when the task status changes
* "Work notes" were extended from buildings to any address object

* New settings:
** "Sort customers in the task card by the order in which they were added to the task"
** "Interval for displaying tasks in the My tasks section (days)"
** "Block execution of task automation/chain when a task is returned from a status with the system role Deferred"

* Task chains/automation:
** Added the additional condition "Task. Tag"
** Added action variants:
*** "Parent task (the very first in the chain). Change status to"
*** "Parent task (all in the chain). Change status to"
*** "Inventory. Transfer to parent task"
*** "Inventory. Transfer to child task"
*** "Transfer custom field values to the building card"

* Task list:
** The task list can show thumbnails of attached files ''(setting)''
** Task filter:
*** added "and/or" modes
*** expanded filter by parent task number
*** expanded filter by "Completed with due time over..."
*** expanded filter by parent task number
*** added filtering by checklist value
** Added group actions in the task list:
*** "Customers - Open list"
*** "Assign owner"
*** "Remove owner"

'''Warehouse:'''
* Implemented inventory transfer to an employee with employee confirmation of receipt/refusal
* '''When receiving inventory, multiple different inventory item names can now be specified at once'''
* '''Warehouse operations now have filtering by "Address (with objects)", which allows selecting inventory transfer operations for all objects in that area'''
* '''The inventory list can now be filtered by any address object ''(including the full hierarchy)'' ''(region, city, street, etc.)'''''
* The inventory list shows a totals row with total cost/purchase cost
* In the inventory balance report, report item names are links for quickly viewing the corresponding inventory list
* Added groups for suppliers
* Added the ability to send an employee a Messenger/Telegram message when inventory is transferred to or from that employee's accountability
* When splitting inventory, MAC addresses/serial numbers can be specified for the resulting items immediately

'''Coverage:'''
* Added automatic real-time GPS position updates for transport on the map ''(every N seconds)''. Added the "Transport position update interval on the map" setting
* '''When several objects overlap on the map ''(communications installations at one point, many closures on one pole, cable lines running next to each other, etc.)'', hovering over this cluster expands it so the required object can be selected'''
* Improved display of cable lines that pass through the visible map area while their endpoints are outside the current view
* Added a new ruler on the map
* Added a new map object type: "Link"
* Popup hints on map polygons now show custom field values
* The building list can show the penetration percentage field and the "Notes" field, and a filter for this field was added

'''Communications installations:'''
* A communications installation can be hidden from the coverage map
* Added the "Suggest a new number when adding an object" parameter for communications installation types
* In the cabinet/rack layout, popup hints on devices now show serial/inventory numbers

'''Cable lines:'''
* Added filtering by custom fields in the cable line list
* In group actions for replacing the cable brand in the cable line list, this action can also replace module/fiber/conductor colors in the cable according to the new cable brand

'''Employees:'''
* Added a personal setting for extra buttons in the left menu of the mobile version, including custom links
* New rights in employee profiles:
** View/change supplier information
** View/change employee fines and bonuses
** Settings - Task statuses

'''API:'''
* '''Separate [[UserSide API Key EN|API keys]] can now be created for read-only operations'''
* '''All requests that write or modify data must now be sent only through POST'''
* Requests must not include extra parameters. If an extra parameter is present, the request returns an error
* Improved API method API->address->[[API_address_EN#edit_address|edit_address]]
* Improved API method API->attach->[[API_attach_EN#add|add]]
* Added API method API->attach->[[API_attach_EN#upload|upload]]

'''Transport:'''
* '''Transport operations were deeply reworked. Different types, mileage and deadline control, home-page and transport-list notifications, and operation change history are now supported'''

'''Other:'''
* PHP 8.4
* Added Albanian, Uzbek, and Tajik localizations. Multiple fixes in existing localizations.
* '''The [[usm_asterisk]] module now supports transferring call recordings and listening to them in the ERP interface'''
* Switched objects from numeric IDs to string UUIDs ''(numeric IDs remain for some objects as additional reference values)''
* New WYSIWYG editor
* '''Dark interface theme ''(with automatic switching support)'''''
* '''Custom field values can be edited directly in object cards while viewing them ''(without switching to edit mode)'''''
* '''Reworked attached-file block'''
** Completely different capabilities, gallery, actions, and more
** Quick "Take photo" button for mobile devices
** Large file-add button for mobile devices
** The Ctrl+V clipboard block now supports pasting multiple images and files of any format ''(not only images)''
* New adaptive left menu with hide/show support
* '''Added buttons to the left menu for mobile devices:'''
** "My position on the map"
** QR code
** Barcode ''(and it can beep while scanning)''. If such an inventory item exists, its card opens; if there are no rights to the inventory item but such equipment exists, the equipment card opens. Otherwise, the search list opens
** Three buttons for custom links
** Buttons to share/open a link
* '''Added the "Convert HEIC files to JPEG" option and on-the-fly .heic file support'''
* The "Notebook" section was transformed into a configurable custom section. This significantly expands its functionality
* New barcode generation library ''(SVG format)''
* Improved the cash receipts report: grouping by settlements and by settlements + months, plus detailed payment list viewing
* In group actions for objects, the "Apply" button now shows the number of selected objects and is blocked if no action/objects are selected
* The date/date-time selector localization was fixed for the current language
* A compatibility solution for dates after 2038 was implemented preventively ''("Unix 2038 bug")''
* Separate SMS profiles for work. For example, each SMS mailing can use a separate SMS profile ''(custom alpha name, different operator, etc.)''
* Object-list filters by custom field values now include "greater than" and "less than" variants
* New versions of external [[Modules_EN|modules]]

* Other changes: see https://wiki.userside.eu/3.20

API call EN

2026-07-12T13:10:22Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[API_call_UK|uk]] | [[API call|ru]]

Section '''[[API_EN|API]]''' ERP "UserSide"

Purpose: Calls

Additional parameters:
action - request subcategory ''(possible value: see below)''

== Subcategories ==

==== add ====

''Improved in: 3.21.0 (added line parameter)''

''Improved in: 3.20.23 (added the caller_id_name and direction parameters, added the ability to update a call record based on phone_system_uuid)''

''Added in: 3.18beta1''

Description: Creating a call record / updating call information based on phone_system_uuid
Required parameters:
number - caller's number
Optional parameters:
answer_number - called number
caller_id_name - caller's name
date_add - call date
direction - call direction ''(in|out)''
line - number or name of the incoming line for an incoming call, or outgoing line number for an outgoing call
phone_system_uuid - call ID in the external telephony system



==== dial ====

''Added in: 3.21.0''

Description: Transfer an incoming call to the recipient (the call has not been answered yet)
Required parameters:
phone_system_uuid - call ID in the external telephony system
answer_number - called number
Optional parameters:
line - number or name of the incoming line for an incoming call, or outgoing line number for an outgoing call
number - caller's number

==== edit ====

''Added in: 3.21.10''

Description: Editing a call
Required parameters:
id - call id
Optional parameters:
description - comment text
description_employee_id - id of the employee who left the comment

==== get ====

'' Added in: 3.16dev3''

Description: Call list
Required parameters:
None
Optional parameters:
date_from - date and time of the call (from)
date_to - date and time of the call (to)

==== hangup ====

''Added in: 3.18beta1''

Description: Fixing the fact that a call has ended
Required parameters:
id - call id
OR
phone_system_uuid - call ID in external telephony system
Optional parameters:
record_url - reference to the call record

==== transfer_call ====

''Added in: 3.18beta1''

Description: Transmit information and call to another employee
Required parameters:
id - call id
OR
phone_system_uuid - call ID in external telephony system
Optional parameters:
answer_number - called number

3.21 UK

2026-07-06T13:59:48Z

IronBot: [IronBot] Sync UK localization from RU

[[3.21_EN|en]] | '''uk''' | [[3.21|ru]]

Дата випуску: '''червень 2026'''

''Основні зміни: https://promo.userside.eu/321/''

Див. також:
* [[Оновлення 3.21|Оновлення до версії 3.21]]
* [[Версії ERP "USERSIDE"]] | [[Версії 3.21|Версії 3.21]]

== Перелік змін ==

'''Особливої важливості:'''
* [[PWA (застосунок)|PWA ''(застосунок)'']]
* Автоматична побудова [[Бізнес-процес|схеми бізнес-логіки/робочого процесу]] для типів завдань на основі ланцюжків/автоматизації
* [[Календар|Оновлений календар]] завдань та [[Інтеграція з Google-календарем|інтеграція з Google-календарем]]
* Окремий [[Масова передача ТМЦ|інтерфейс для швидкої передачі ТМЦ]] через сканування або введення штрихкодів, серійних номерів тощо ''(зокрема з підтримкою сканування штрихкодів камерою мобільного пристрою)''
* [[Схема комутації#anchor_321|Снапшоти схем комутації]] виводяться на основній схемі та формуються безпосередньо під час операцій комутації/розриву комутації на споруді зв'язку
* У схемі комутації створення з'єднань, видалення та зміна ламаної з'єднання виконуються без перезавантаження й очікування сторінки ''(на практиці це пришвидшило роботу у 2-10 разів)''
* Панель на головній сторінці з [[Список завдань#anchor_321|лічильниками фільтрів за завданнями/показниками KPI]]
* "Фізичне" [[Підписання документів з абонентами|підписання документів з абонентами/клієнтами]] на планшетах ''(мобільних пристроях)''
* Реалізовано автооновлення GPS-позиції транспорту на мапі в реальному часі ''(кожні N секунд)''
* Віджет на головну сторінку: [[Статистика_UK#anchor_321|найпроблемніші абоненти та будинки]]
* Нова [[Структурна схема|структурна схема]]. Масштабування, збереження у SVG
* [[Internal API UK|Internal API]] v2. Подієва система в ERP
* Підтримка обліку IPv6 для обладнання та абонентів
* Оновлений UI/UX

'''Абоненти/клієнти:'''
* Реалізовано масовий імпорт потенційних абонентів
* У групових діях за абонентами додано можливість надіслати SMS
* '''В умовах SMS-розсилки можна додавати конкретних абонентів'''
* В SMS-розсилці додано фільтр "Ігнорувати відмову від отримання SMS"
* У груповому надсиланні email абонентам додано різні шаблони з даними про абонента
* У листуванні з абонентом можна вимкнути відображення коментарів за завданнями
* Додано зберігання історії статусів абонентів
* Додано історію використання IP-адрес
* Список абонентів:
** '''У фільтрі підтримується режим "і/або"'''
** '''У фільтрі додано можливість включати/виключати умови ''(раніше можна було лише включати)'''''
** Додано фільтр "Абоненти, включені в обладнання"
** Додано фільтр за номером завдання. Також у картці завдання, де прикріплено від 3 абонентів, додано посилання на цей фільтр
** У списку абонентів додано можливість відображати поле "Менеджер"
** У списку залежних абонентів від пристрою/споруди зв'язку також враховуються абоненти, які не скомутовані, але мають пристрої ''(наприклад ONU)'', залежні від батьківського об'єкта

'''Обладнання:'''
* '''Додано вкладки в картці комутатора/обладнання'''
* Якщо для пристрою не вказано IP-адресу, він має один порт і при цьому підключений до вищого керованого комутатора, то в таблиці портів цього пристрою виводитиметься SNMP-інформація з порту вищого пристрою
* PON:
** '''Історія зміни рівня сигналу ONU тепер виводиться у вигляді графіка'''
** Для списку підключених ONU можна налаштувати порядок і відображення полів
** У картці OLT на портах виводиться лічильник кількості ONU на них
* Можна вказувати відсотки поділу для запланованих дільників
* У таблиці дільників додано поле "Кількість зайнятих адаптерів"
* У картці VLAN додано можливість вручну додавати пристрої

'''Схема комутації:'''
* Написи на схемі комутації можна повертати під кутом
* Під час додавання дільника зі схеми комутації більше не відбувається перехід у картку дільника: користувач залишається у схемі
* У майстрі комутації додано можливість комутації пристроїв
* Для кросу/ODF у схемі комутації додано можливість швидко змінювати підписи для всіх портів одразу
* Для запланованих комутацій у схемі перепланування додано можливість змінювати маршрут вручну
* Для мобільних пристроїв перетягування ліній комутації типово заблоковане під час відкриття сторінки

'''Завдання:'''
* Впроваджено багаторівневі групи типів завдань
* Оновлений [[Календар|календар завдань]]:
** '''перетягування завдань ''(зміна часу робіт)'''''
** можна змінювати строк виконання завдання ''(перетягувати нижню межу)''
** тижневий/місячний режим для підрозділів і співробітників
** режим "підрозділ"/"+співробітники"/"+співробітники і підрозділи"
** 15/30/60 хвилин ''(раніше тільки слоти по 1 годині)''
** позначається факт високого пріоритету, а також можна налаштовувати шаблон інформації для заголовка завдання і тіла завдання
* '''Перевірка існування раніше прикріпленого файла в завданнях і коментарях до завдання ''(щоб запобігти спробам співробітників прикріплювати старі файли, видаючи їх за нові)'''''
* У картці завдання додано можливість однією кнопкою передати ТМЦ із доступних цьому співробітнику
* Новий спецтип для типів завдань: "Роботи з боржниками"
* У картці завдання виводиться рядок з координатами і швидким переходом на Google-мапу
* Під час створення дочірнього завдання з картки завдання додано можливість копіювати ''(використовувати)'' також файли з батьківського завдання
* Дороблено відображення інформації про ТМЦ у списку ТМЦ під час зміни статусу завдання
* "Робочі нотатки" розширено з будинків на будь-який адресний об'єкт

* Нові параметри налаштування:
** "У картці завдання сортувати абонентів за порядком їх додавання в завдання"
** "Інтервал для відображення завдань у розділі "Мої завдання" (днів)"
** "Заблокувати виконання автоматизації/ланцюжка завдань під час повернення завдання зі статусу із системною роллю "Відкладено"

* Ланцюжки завдань/автоматизація:
** Додано додаткову умову "Завдання. Мітка"
** Додано варіанти дій:
*** "Батьківське завдання (найперше в ланцюжку). Змінити статус на"
*** "Батьківське завдання (усі в ланцюжку). Змінити статус на"
*** "ТМЦ. Передати в батьківське завдання"
*** "ТМЦ. Передати в дочірнє завдання"
*** "Перенесення значень додаткових полів у картку будинку"

* Список завдань:
** У списку завдань виводяться мініатюри прикріплених файлів ''(параметр налаштування)''
** Фільтр завдань:
*** додано режими "і/або"
*** розширено фільтр за номером батьківського завдання
*** розширено фільтр за "Виконано зі строком виконання понад..."
*** розширено фільтр за номером батьківського завдання
*** додано фільтр за значенням чек-листа
** У списку завдань додано групові дії:
*** "Абоненти - Відкрити список"
*** "Призначити власника"
*** "Виключити власника"

'''Склад:'''
* Реалізовано передачу ТМЦ співробітнику з підтвердженням отримання/відмови від отримання співробітником
* '''В операціях за складом додано фільтрацію за "Адреса (з об'єктами)", що дозволяє вибрати операції передачі ТМЦ на всі об'єкти цієї території'''
* '''У списку ТМЦ додано можливість фільтрації за будь-яким адресним об'єктом ''(включно з усім підпорядкуванням)'' ''(область, місто, вулиця...)'''''
* У списку ТМЦ виводиться підсумковий рядок із загальною вартістю/закупівельною вартістю
* У звіті щодо залишків ТМЦ назви позицій ТМЦ зроблено посиланнями для швидкого перегляду списку цих ТМЦ
* Групи для постачальників
* Додано можливість надсилати повідомлення співробітнику в Messenger/Telegram під час передачі ТМЦ йому під звіт/з-під звіту
* Під час розділення ТМЦ додано можливість одразу вказувати MAC-адреси/серійні номери для цих ТМЦ

'''Покриття:'''
* Реалізовано автооновлення GPS-позиції транспорту на мапі в реальному часі ''(кожні N секунд)''. Додано параметр налаштування "Інтервал оновлення позиції транспорту на мапі"
* '''Коли на мапі кілька об'єктів накладено один на одного ''(споруди зв'язку в одній точці/багато муфт на опорі... або кабельні лінії проходять поруч)'', то під час наведення на це скупчення об'єктів воно розкривається з можливістю вибрати потрібний'''
* Доробка відображення на мапі кабельних ліній, які проходять через екран, але мають кінцеві точки поза поточною областю відображення
* Нова лінійка на мапі
* Новий тип об'єктів на мапу: "Посилання"
* У спливних підказках на полігонах на мапі виводяться значення додаткових полів
* У списку будинків додано можливість виведення поля з відсотком проникнення, поле "Нотатки" і фільтр за цим полем

'''Споруди зв'язку:'''
* Для споруди зв'язку можна вказати приховування її з мапи покриття
* Для типів споруд зв'язку додано параметр "Під час додавання об'єкта пропонувати новий номер"
* У макеті шафи/стійки у спливних підказках на пристроях додано відображення серійного/інвентарних номерів

'''Кабельні лінії:'''
* У списку кабельних ліній додано фільтр за додатковими полями
* У групових діях із заміни марки кабелю в списку кабельних ліній додано можливість під час цієї дії замінювати кольори модулів/волокон/провідників у кабелі відповідно до нової марки кабелю

'''Співробітники:'''
* Налаштування в персональному налаштуванні: додаткові кнопки для лівого меню в мобільній версії, зокрема власні посилання
* Нові права в профілях співробітників:
** Перегляд/зміна інформації про постачальників
** Перегляд/зміна штрафів і премій персоналу

'''API:'''
* '''Можна створювати окремі [[UserSide API Key UK|API-ключі]] тільки для операцій читання даних'''
* '''Усі запити на запис/зміну даних тепер мають надсилатися лише через POST'''
* У запиті не повинно бути сторонніх параметрів. Якщо сторонній параметр присутній, запит повертатиме помилку
* Доопрацьовано метод API->address->[[API_address_UK#edit_address|edit_address]]
* Доопрацьовано метод API->attach->[[API_attach_UK#add|add]]
* Додано метод API->attach->[[API_attach_UK#upload|upload]]

'''Транспорт:'''
* '''Глибоко перероблено операції за транспортом. Різні типи, контроль пробігу, строків. Повідомлення на головну сторінку і список транспорту. Ведення історії змін в операціях'''

'''Інше:'''
* PHP 8.4
* Додано локалізації: албанська, узбецька, таджицька. Численні виправлення в поточних локалізаціях.
* '''Модуль [[usm_asterisk]] тепер підтримує передачу записів дзвінків і можливість прослуховувати їх в інтерфейсі ERP'''
* Перехід із числових ID на рядкові UUID в об'єктах ''(числові ID для частини об'єктів залишено як додаткові довідкові)''
* Новий редактор WYSIWYG
* '''Темна схема інтерфейсу ''(з підтримкою автоматичного перемикання)'''''
* '''Редагування значень додаткових полів у картках об'єктів прямо в режимі перегляду ''(без потреби переходити в редагування)'''''
* '''Перероблено блок роботи з прикріпленими файлами'''
** Повністю інші можливості, галерея, дії тощо
** Для мобільних пристроїв швидка кнопка "Фотографувати"
** Для мобільних пристроїв велика кнопка додавання файлів
** Блок Ctrl+V для роботи з буфером обміну тепер підтримує вставлення кількох зображень і файлів будь-яких форматів ''(а не лише зображень)''
* Нове ліве адаптивне меню з можливістю приховування/відкриття
* '''Додано кнопки в лівому меню для мобільних пристроїв:'''
** "Моя позиція на мапі"
** QR-код
** Штрихкод ''(+ може подавати звуковий сигнал під час сканування)''. Якщо є такий ТМЦ, відкривається картка ТМЦ; якщо немає прав до ТМЦ, але є таке обладнання, відкривається картка обладнання. Інакше відкривається список пошуку
** Три кнопки для власних посилань
** Кнопки поділитися посиланням/відкрити посилання
* '''Опція "Конвертувати HEIC-файли в JPEG" і власне підтримка роботи з .heic файлами на льоту'''
* Розділ "Блокнот" трансформувався в налаштовуваний власний розділ. Це значно розширює його функціональність
* Нова бібліотека генерації штрихкодів ''(у SVG-форматі)''
* Дороблено звіт за надходженнями коштів: групування за населеними пунктами, а також за населеними пунктами + місяцями, і можливість детального перегляду списку платежів
* У групових діях за об'єктами кнопка "Застосувати" тепер містить кількість позначених об'єктів і блокується, якщо не вибрано дію/об'єкти
* Селектор вибору дати/дати-часу: виправлено локалізацію під поточну мову
* Превентивно впроваджено рішення для забезпечення сумісності з датами після 2038 року ''("Unix 2038 bug")''
* Окремі SMS-профілі для роботи. Наприклад, для кожної SMS-розсилки можна вказати окремий SMS-профіль ''(власне альфа-ім'я, інший оператор...)''
* У списках об'єктів у фільтрацію за значеннями додаткових полів додано варіанти фільтрації "більше" і "менше"
* Нові версії зовнішніх [[Модулі|модулів]]

* Інші зміни: див. https://wiki.userside.eu/3.20

Версії 3.21

2026-07-06T13:59:48Z

IronBot: [IronBot] Sync UK localization from RU

[[Versions_3.21_EN|en]] | '''uk''' | [[Версии_3.21|ru]]

Версії гілки [[3.21_UK|3.21]]

Див. також: [[Версії_ERP_"USERSIDE"|Версії ERP "USERSIDE"]]

== 3.21.10 (у розробці) ==
* У групових діях за спорудами зв'язку: створення загального завдання/окремих завдань тепер створює завдання через стандартний діалог додавання завдання

== 3.21.9 - 06.07.2026 ==
* У виключення для SMS-розсилок додано можливість виключати абонентів із певним періодом від'ємного балансу
* У статистиці "Проблемні будинки/абоненти" додано можливість налаштовувати власні фільтри
* У налаштуваннях типу завдань у секції додаткових полів окремо вказуються типи додаткових полів, які можна використовувати під час зміни статусу завдань. А в налаштуваннях статусів завдань додано властивість "Вивести додаткові поля"
* Додано можливість автоматично створювати завдання на роботу для невідповіджених телефонних викликів
* Зміну пароля користувача винесено в окреме діалогове вікно

== 3.21.8 - 04.07.2026 ==
* Доопрацьовано метод API->customer->[[API_customer_UK#get_customers_id|get_customers_id]]
* Доробки зовнішнього вигляду завдань у календарі робіт
* У групових діях за абонентами: створення завдань тепер використовує повноцінний діалог зазначення властивостей для створюваних завдань
* Оптимізація структурної схеми
* Виправлено помилку під час встановлення умов у SMS-розсилці ''(у деяких випадках)''
* Виправлено зазначення власних координат для абонента
* Виправлено помилку під час збереження системного пристрою
* Виправлено виведення об'єктів на глобальній схемі комутації ''(у деяких випадках)''
* Виправлено комутацію кабельної лінії до пристрою у схемі комутації абонента
* Виправлено зміну довільних координат для обладнання
* Виправлено роботу фільтра за виключенням тарифу в SMS-розсилці

== 3.21.7 - 03.07.2026 ==
* Режим планування в календарі робіт
* Виправлено пошук у списку споруд зв'язку ''(у деяких випадках)''
* Виправлено відображення прикріплених файлів у картці споруди зв'язку за наявності прав лише на читання
* Виправлено перегляд/формування SMS-розсилок ''(у деяких випадках)''
* Виправлено відображення рівнів сигналів для ONU ''(у деяких випадках)''
* Виправлено відображення затухань на структурній схемі для OLT ''(у деяких випадках)''
* Виправлено помилку під час перегляду історії за співробітниками ''(у деяких випадках)''
* Виправлено неправильне виведення дати активності у спливній підказці на мапі покриття за автотранспортом
* Виправлено можливість виключення абонента із завдання

== 3.21.6 - 02.07.2026 ==
* Додано історію використання IP-адрес
* Доопрацьовано використання лінійки на мапі покриття
* Виправлено зовнішній вигляд кабельних ліній на мапі покриття залежно від налаштувань міток ''(у деяких випадках)''
* Виправлено список обладнання у віджеті головної сторінки "Неактивні комутатори"
* Виправлено додавання нових схем споруд зв'язку на глобальну схему комутації
* Виправлено пошук за базою обладнання під час додавання найменування ТМЦ у каталозі товарів
* Виправлено очищення комутації портів обладнання ''(у деяких випадках)''
* Виправлено помилку у звіті щодо залишків ТМЦ ''(у деяких випадках)''
* Виправлено зазначення довільних запасів/об'єктів на маршруті кабельної лінії
* Виправлено перемикання комутації в порт іншого пристрою на споруді зв'язку
* Виправлено відображення об'єктів на мапі покриття у групових операціях за спорудами зв'язку
* Виправлено зміну шляху комутації у схемі комутації ''(у деяких випадках)''

== 3.21.5 - 01.07.2026 ==
* Додано сповіщення під час редагування завдання ''(налаштовується)''
* Доробка зі знімання інформації за інтерфейсами ONU
* Доопрацьовано зовнішній вигляд портів обладнання для темної схеми
* Для типів завдань додано можливість вказати дії з ТМЦ: передавати з абонента на вибраний склад потрібні ТМЦ, що знаходяться в абонента
* Виправлено швидкий пошук обладнання потрібної категорії у списку обладнання
* Виправлено вибір інших пристроїв на цій споруді зв'язку в діалоговому вікні перемикання порту
* Виправлено відображення доступних складів для співробітника ''(у деяких випадках)''
* Виправлено помилку під час перегляду картки ТМЦ ''(у деяких випадках)''
* Виправлено автовибір будинку під час додавання споруди зв'язку з картки будинку
* Виправлено перегляд списку опитуваних пристроїв у модулі usm_observer
* Виправлено можливість зміни кольору з'єднання між пристроями у схемі комутації

== 3.21.4 - 30.06.2026 ==
* Доопрацьовано метод API->attach->[[API_attach_UK#upload|upload]]
* Додано окремий профіль email-сповіщень для надсилання повідомлень абонентам-юридичним особам
* Доопрацьовано сортування у списку споруд зв'язку за будинком
* Календар робіт відкривається на поточній даті
* Доробка календаря завдань для випадків, коли кілька завдань призначаються на один час
* Впроваджено багаторівневі групи типів завдань
* У новинах за завданнями додано можливість частково позначати події як прочитані, а також групувати новини за завданнями
* В автоматизації за завданнями додано можливість надсилати Email абонентам ''(за налаштовуваними шаблонами)''
* Доопрацьовано виведення спливного сповіщення під час призначення підрозділу співробітника на завдання
* Виправлено відображення блока з прикріпленими файлами у власних розділах за права лише на читання
* Виправлено перехід у картку абонента з мапи покриття
* Виправлено помилку під час налаштування доступності статусів для профілів співробітників у картці типу завдання
* Виправлено фільтрацію за датами у списку завдань ''(у деяких випадках)''
* Виправлено відображення автора завдання у списку завдань
* Виправлено відображення поля "Нотатки" у картці споруди зв'язку
* Виправлено помилку під час спроби видалення адресного об'єкта ''(у деяких випадках)''
* Виправлено можливість вимкнення/увімкнення порту пристрою
* Виправлено перегляд глобальних схем комутації ''(у деяких випадках)''

== 3.21.3 - 28.06.2026 ==
* Доопрацьовано метод API->inventory->[[API_inventory_UK#transfer_inventory|transfer_inventory]]
* Доопрацьовано метод API->commutation->[[API_commutation_UK#delete|commutation]]
* Доопрацьовано метод API->node->[[API_node_UK#get|get]]
* Доопрацьовано метод API->address->[[API_address_UK#get_house|get_house]]
* Для завдання планувальника "Розсилання інформації про зниження резервів на складі" додано можливість указувати варіанти надсилання "E-mail/Messenger", а також у картці співробітника в розділі "Сповіщення" можна вказати варіанти отримання цієї розсилки
* У списку ТМЦ у картці завдання додано можливість одразу передавати всі ТМЦ вибраному отримувачу
* У додаткових полях із типом "Вибір зі списку" додано швидкий пошук значення
* Доопрацьовано використання явно вказаних координат під час редагування картки будівлі та вибору полігона/точки
* Виправлено створення кабельних ліній до будівлі з мапи покриття
* Виправлено помилку під час переходу до розділу Налаштування - Модулі ''(у деяких випадках)''
* Виправлено групування у списку завдань ''(у деяких випадках)''
* Виправлено видалення напису зі схеми комутації
* Виправлено роботу параметра "Відображати у селекторах/пошуку звільнених співробітників протягом N днів після їх звільнення"
* Виправлено перевірку доступності складів під час вибору ТМЦ при виконанні завдання
* Виправлено роботу змінної "Виводити завдання за датою фактичного виконання"
* Виправлено використання колірних налаштувань зовнішнього вигляду типів завдань у календарі
* Виправлено пошук на мапі покриття ''(підставляння поточного населеного пункту у вікні пошуку)''
* Виправлено перехід із картки клієнта на мапу з координатами будівлі клієнта
* Виправлено збереження інтерфейсів/стекування в картці пристрою

== 3.21.2 - 26.06.2026 ==
* Доопрацьовано метод API->address->[[API_address_UK#get_house|get_house]]
* Під час передавання ТМЦ із картки клієнта можна вибрати субрахунок, на який передаємо
* Під час створення/зміни завдання для будівлі виводиться інформація про мітки на будівлі та примітку до будівлі
* Під час створення завдання за ланцюжком можна окремо вказати потрібного довільного виконавця/підрозділ
* У масовому передаванні ТМЦ тепер створюються об'єднані операції передавання, а не кожна окремо
* У списку завдань у групуванні результатів фільтрації додано варіант "Дата виконання (місяць)"
* Виправлено помилку під час створення завдання ''(у деяких випадках)''
* Виправлено зміну координат у картці будівлі, споруди зв'язку, клієнта ''(у деяких випадках)''
* Виправлено формування назви споруди зв'язку під час вибору поверху будівлі ''(у деяких випадках)''
* Виправлено обробку посилань у текстових значеннях додаткових полів
* Виправлено призначення виконавців під час створення завдання ''(у деяких випадках)''

== 3.21.1 - 25.06.2026 ==
* Доопрацьовано центрування мапи під час редагування полігона/будівлі на мапі покриття
* Виправлено відображення глобальних схем комутації ''(у деяких випадках)''
* Виправлено експорт у XLS списку кабельних ліній ''(у деяких випадках)''
* Виправлено коректне відображення клієнтів на логічній схемі будівлі ''(у деяких випадках)''
* Виправлено вибір батьківських об'єктів під час додавання будівлі з мапи покриття
* Виправлено прикріплення клієнта під час додавання нового завдання для клієнта
* Виправлення невеликих помилок

== 3.21.0 - 23.06.2026 ==
* Реліз версії

== 3.21.0-beta.7 - 21.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.6 - 20.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.5 - 17.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.4 - 13.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.3 - 07.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.2 - 30.05.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.1 - 24.05.2026 ==
* Перелік змін див. у [[3.21_UK|3.21]]

Версії 3.20

2026-07-06T13:59:48Z

IronBot: [IronBot] Sync UK localization from RU

[[Versions 3.20 EN|en]] | '''uk''' | [[Версии_3.20|ru]]

Версії гілки [[3.20_UK|3.20]]

Також див.: [[Версії ERP "USERSIDE"]]

== 3.20.26 (у розробці) ==
* Виправлено генерацію/транслітерацію логіна співробітника під час створення ''(у деяких випадках)''
* Виправлено помилку під час побудови звіту щодо залишків ТМЦ за завданнями

== 3.20.25 - 24.06.2026 ==
* Доопрацьовано відображення запланованих кабельних ліній на мапі покриття відповідно до налаштувань кольору за щільністю кабелю
* Виправлено помилку з відображенням списку кабельних ліній ''(у деяких випадках)''
* Виправлення невеликих помилок та змін

== 3.20.24 - 27.05.2026 ==
* Виправлення невеликих помилок та змін

== 3.20.23 - 27.04.2026 ==
* Додано метод API->call->[[API_call_UK#agent_call|agent_call]]
* Додано метод API->chapter->[[API_chapter_UK#link_add|link_add]]
* Додано метод API->chapter->[[API_chapter_UK#link_get|link_get]]
* Додано метод API->chapter->[[API_chapter_UK#link_remove|link_remove]]
* Доопрацьовано метод API->call->[[API_call_UK#add|add]]
* Доопрацьовано метод API->task->[[API_task_UK#edit|edit]]
* У виконаних завданнях також відображається ознака "Прострочено" під час порушенні термінів робіт
* Виправлена помилка з входом у календар робіт ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.20.22 - 04.04.2026 ==
* Виправлено вибір порожнього значення в типі завдань для реєстрації телефоном
* Оптимізаційні роботи
* Виправлення невеликих помилок

== 3.20.21 - 11.03.2026 ==
* Виправлено відображення лічильника помилок на інтерфейсах пристроїв ''(у деяких випадках)''
* Виправлено налаштування шаблонів SMS-повідомлень для абонентів у завданнях
* Оптимізаційні роботи
* Виправлення невеликих помилок

== 3.20.20 - 22.02.2026 ==
* Оптимізована робота розділу "Мої завдання"
* Виправлено порушення розмітки головного меню в деяких випадках

== 3.20.19 - 08.02.2026 ==
* Виправлення невеликих помилок

== 3.20.18 - 23.01.2026 ==
* Оптимізація звіту за складу "Оборотно-сальдова відомість"
* Виправлення невеликих помилок

== 3.20.17 - 31.12.2025 ==
* Додано метод API->task->[[API_task_UK#add_node_to_task|add_node_to_task]]
* Додано метод API->task->[[API_task_UK#remove_node_from_task|remove_node_from_task]]
* Виправлено виконання ланцюжка завдань ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.20.16 - 14.12.2025 ==
* Виправлена помилка з фільтрацією за секції ТМЦ у списку операцій за складу
* Виправлення невеликих помилок

== 3.20.15 - 06.12.2025 ==
* Для ланцюжків завдань/автоматизації в типах завдань додано можливість вказівки дробового інтервалу годинника
* Виправлення невеликих помилок

== 3.20.14 - 29.11.2025 ==
* Доопрацювання API взаємозв'язку з Binotel
* Виправлення невеликих помилок

== 3.20.13 - 22.11.2025 ==
* Виправлення невеликих помилок

== 3.20.12 - 15.11.2025 ==
* Додано параметр налаштування "Масштабувати ширину кабельної лінії на схемі комутації в залежності від довжини назви"
* Допрацьовано відображення невідомих ONU за OLT у віджеті головної сторінки
* Виправлення інших невеликих помилок

== 3.20.11 - 08.11.2025 ==
* Виправлення помилки під час вході в розділ Custom-повідомлень ''(у деяких випадках)''
* Виправлення помилки під час вході в налаштування інтерфейсів/стекування за пристрої ''(у деяких випадках)''
* Виправлена неможливість комутації між ODF/кросами у майстрі комутацій
* Виправлення деяких помилок міграції

== 3.20.10 - 07.11.2025 ==
* Додано метод API->vehicle->[[API_vehicle_UK#add|add]]
* Додано метод API->vehicle->[[API_vehicle_UK#edit|edit]]
* Додано метод API->vehicle->[[API_vehicle_UK#delete|delete]]
* У картці спорудження зв'язку в блоці з прикріпленими файлами-зображеннями можна швидко зробити зображення основним фото для цього об'єкта ''(без необхідності переходити до редагування)''
* У картці кабельної лінії додано можливість створити завдання з цією лінією або додати лінію до існуючого завдання
* Доопрацьовано сортування за додатковими полями у власних розділах
* Виправлена фільтрація за найменуванням ТМЦ у списку ТМЦ
* Виправлено відображення шарів обладнання на карті покриття
* Виправлення інших невеликих помилок

== 3.20.9 - 14.09.2025 ==
* Доопрацювання перевірки прав доступу до ONU
* Виправлена помилка під час пошуку абонента під час передачі ТМЦ ''(у деяких випадках)''
* Виправлено оновлення на базі серійних номерів для ONU під час опитуванні OLT ''(у деяких випадках)''

== 3.20.8 - 06.09.2025 ==
* Додано метод API->billing->[[API_billing_UK#refresh_date_update|refresh_date_update]]
* Оптимізовано інтерфейс редагування/додавання адресної одиниці ''(актуально для розгалужених адресних структур)''
* У картці завдання додані посилання на перегляд зв'язаних абонентів із спорудами зв'язку та з кабельними лініями
* Виправлена перевірка на статус батьківського завдання в автоматизації дій із завдань ''(у деяких випадках)''
* Виправлено відображення спливаючої підказки в календарі завдань під час горизонтальному скролі
* Виправлено призначення співробітників у підрозділ ''(у деяких випадках)''

== 3.20.7 - 25.08.2025 ==
* '''Глибока переробка операцій із транспорту. Різні типи, контроль пробігу, терміни. Повідомлення на головну сторінку та список транспорту. Ведення історії змін в операціях '''
* Історія дій щодо потенційного абонента переноситься в історію дій звичайного абонента під час їх об'єднанні
* При гарячій заміні пристрою можна вказати збереження історії MAC-адрес на портах обладнання
* У групових діях за списком абонентів додано можливість очищення комутації
* Технічні міграції даних ядра
* Виправлена фільтрація FDB-таблиці з пристрою ''(у деяких випадках)''
* Виправлена помилка під час обмеженні співробітнику доступу за конкретною IP-адресою
* Виправлено перевірку прав на доступ до ONU

== 3.20.6 - 15.08.2025 ==
* ''' Окремі SMS-профілі для роботи. Наприклад, для кожної SMS-розсилки можна вказати окремий SMS-профіль ''(власне альфа-ім'я, інший оператор...)'''''
* Виділено окремі права доступу до ONU на перегляд та зміну
* Виправлено відображення великої кількості розділів блокнота у списку розділів
* Виправлено оновлення інформації під час додавання/виключенні споруди зв'язку в завданні

== 3.20.5 - 08.08.2025 ==
* Додано метод API->address->[[API_address_UK#get_building_type|get_building_type]]
* Додано параметр налаштування "Будівлі. Шаблон спливаючого повідомлення на карті"
* Доопрацьовано інтерфейс зміни нотатки, типу адаптера та з'єднання для волокна кабельної лінії
* Перероблено інтерфейс додавання споруд зв'язку та кабельних ліній у завдання під час створення завдання
* Підкориговано перевірку прав доступу до табеля робіт
* Доопрацьовано тарифікацію співробітникам за завдання у відомості робіт за участю в завданні понад 5 співробітників
* Виправлена помилка фільтрації за будівлі у списку операцій за складом ''(у деяких випадках)''

== 3.20.4 - 04.08.2025 ==
* Додано метод API->cross->[[API_cross_UK#edit_adapter|edit_adapter]]
* Доопрацьовано метод API->task->[[API_address_UK#edit_address|edit_address]]
* Додано параметр налаштування "Заблокувати виконання автоматизації/ланцюжка завдань під час поверненні завдання зі статусу із системною роллю "Відкладено"
* У списку завдань додано угруповання завдань за вулиці або населеному пункту
* Доопрацювання збереження прикріплених файлів до коментарів за завданням
* Невеликі виправлення та доопрацювання

== 3.20.3 - 27.07.2025 ==
* Доопрацьовано метод API->task->[[API_task_UK#change_state|change_state]]
* Додано параметр налаштування "З'єднання на дільниках вважати механічними"
* У налаштуваннях типів завдань для ТМЦ можна вказати, що переміщати всі ТМЦ після закриття на зв'язану будівлю
* У ланцюжках/автоматизації за типами завдань додано можливість додаткової умови "Статус дочірнього/батьківського завдання" для варіантів дій "Батьківське/Дочірнє завдання. Змінити статус на"
* У картці будівлі у списку ТМЦ додано інформацію про дату встановлення ТМЦ на будівлі та можливість експорту в XLS та у версію для друку
* У картці можна скопіювати всі прикріплені файли з іншого завдання
* У картці абонента додано пряме посилання на перегляд його маршруту комутації
* Для профілів співробітників можна обмежити максимальну кількість записів на сторінці ''(у таблицях/списках)''
* У фільтр зі споруд зв'язку додано можливість вибірки за відсутнім власним значком на карті
* У списку операцій за складу в селекторах вибору контрагента додано можливість вказівки конкретної будівлі
* У групових діях за будівлях додано можливість зміни індивідуального кольору на карті
* У групових діях за будинках можна змінити менеджера на порожнє значення ''(видалити менеджера)''
* Виправлено сортування за адресою у списку завдань ''(у деяких випадках)''
* Виправлена можливість одночасно відкласти завдання та вказати довільний коментар

== 3.20.2 - 18.07.2025 ==
* Додано метод API->task->[[API_task_UK#add_cable_line_to_task|add_cable_line_to_task]]
* Додано метод API->task->[[API_task_UK#remove_cable_line_from_task|remove_cable_line_from_task]]
* Список підключених ONU на OLT можна виводити на друк або експортувати до XLS
* Для споруд зв'язку та кабельних ліній додано можливість у групових діях змінювати нотатки
* У шаблоні спливаючої підказки на завдання на карті покриття можна відображати дату створення завдання, дату оновлення, текст останнього коментаря
* У ланцюжках/автоматизації за типами завдань додано дію "Абоненти. Виключити"
* Для ланцюжків/автоматизації в типах завдань додана можливість відключати автопризначуваних виконавців під час створення нового завдання за ланцюжку
* Доопрацьовано відображення посилань в описі типу завдань у картці завдання
* Виправлена фільтрація абонентів, що залежать від кросу/odf ''(у деяких випадках)''

== 3.20.1 - 12.07.2025 ==
* У списку будівель доданий фільтр за будівлях, у яких знято позначку "Відображати на карті"
* Виправлена неможливість відкрити картку автотранспорту зі списку
* Виправлено пошук за найменуванням кабельної лінії під час створення завдання ''(у деяких випадках)''
* Виправлення відображення інформації про абонента у списку завдань ''(у деяких випадках)''

== 3.20 - 09.07.2025 ==
* Реліз версії 3.20
* Список змін див. [[3.20_UK|3.20]]

Versions 3.21 EN

2026-07-06T13:59:48Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[Версії_3.21|uk]] | [[Версии_3.21|ru]]

Versions of the [[3.21_EN|3.21]] branch

Also see: [[Versions_of_ERP_"USERSIDE"|ERP "USERSIDE" versions]]

== 3.21.10 (in development) ==
* In group actions for communications installations, creating a common task or separate tasks now creates tasks through the standard task-add dialog

== 3.21.9 - 06.07.2026 ==
* SMS mailing exclusions can now exclude customers with a specific period of negative balance
* The "Problem buildings/customers" statistics can now use custom filters
* In task type settings, the additional fields section now separately specifies the additional field types that can be used when changing task status. Task status settings also now include the "Display additional fields" property
* Added the ability to automatically create a work task for unanswered phone calls
* User password changes were moved to a separate dialog window

== 3.21.8 - 04.07.2026 ==
* Improved API method API->customer->[[API_customer_EN#get_customers_id|get_customers_id]]
* Improved the appearance of tasks in the work calendar
* In group actions for customers, task creation now uses a full dialog for specifying properties of the tasks being created
* Optimized the structural scheme
* Fixed setting conditions in SMS mailings ''(in some cases)''
* Fixed setting custom coordinates for a customer
* Fixed saving a system device
* Fixed object display on the global commutation scheme ''(in some cases)''
* Fixed commutating a cable line to a device in the customer's commutation scheme
* Fixed changing custom coordinates for equipment
* Fixed the tariff exclusion filter in SMS mailings

== 3.21.7 - 03.07.2026 ==
* Planning mode in the work calendar
* Fixed search in the communications installation list ''(in some cases)''
* Fixed attached-file display in a communications installation card when the user has read-only rights
* Fixed viewing/creating SMS mailings ''(in some cases)''
* Fixed signal level display for ONU ''(in some cases)''
* Fixed attenuation display on the structural scheme for OLT ''(in some cases)''
* Fixed an error when viewing employee history ''(in some cases)''
* Fixed incorrect activity date output in the coverage map tooltip for transport
* Fixed the ability to exclude a customer from a task

== 3.21.6 - 02.07.2026 ==
* Added IP address usage history
* Improved use of the ruler on the coverage map
* Fixed cable line appearance on the coverage map according to tag settings ''(in some cases)''
* Fixed the equipment list in the "Inactive switches" home-page widget
* Fixed adding new communications installation schemes to the global commutation scheme
* Fixed equipment database search when adding an inventory item name to the product catalog
* Fixed clearing equipment port commutation ''(in some cases)''
* Fixed an error in the inventory balance report ''(in some cases)''
* Fixed specifying custom reserves/objects on a cable line route
* Fixed switching commutation to a port of another device on a communications installation
* Fixed object display on the coverage map in group operations for communications installations
* Fixed changing the commutation path in the commutation scheme ''(in some cases)''

== 3.21.5 - 01.07.2026 ==
* Added notifications when editing a task ''(configurable)''
* Improved collecting information from ONU interfaces
* Improved equipment port appearance for the dark theme
* Task types can now specify actions with inventory: transfer the required inventory currently assigned to a customer from that customer to the selected warehouse
* Fixed quick search by the required equipment category in the equipment list
* Fixed selection of other devices on the same communications installation in the port switching dialog
* Fixed display of warehouses available to an employee ''(in some cases)''
* Fixed an error when viewing an inventory item card ''(in some cases)''
* Fixed automatic building selection when adding a communications installation from a building card
* Fixed viewing the list of polled devices in the usm_observer module
* Fixed the ability to change the color of a connection between devices in the commutation scheme

== 3.21.4 - 30.06.2026 ==
* Improved API method API->attach->[[API_attach_EN#upload|upload]]
* Added a separate email notification profile for sending messages to corporate customers
* Improved sorting by building in the communications installation list
* The work calendar opens on the current date
* Improved the task calendar for cases where several tasks are scheduled for the same time
* Implemented multilevel task type groups
* Task news can now partially mark events as read and group news by task
* Task automation can now send Email messages to customers ''(using configurable templates)''
* Improved popup notification output when assigning an employee department to a task
* Fixed attached-file block display in custom sections when the user has read-only rights
* Fixed opening a customer card from the coverage map
* Fixed an error when configuring status availability for employee profiles in a task type card
* Fixed filtering by dates in the task list ''(in some cases)''
* Fixed task author display in the task list
* Fixed display of the "Notes" field in the communications installation card
* Fixed an error when trying to delete an address object ''(in some cases)''
* Fixed the ability to disable/enable a device port
* Fixed viewing global commutation schemes ''(in some cases)''

== 3.21.3 - 28.06.2026 ==
* Improved API method API->inventory->[[API_inventory_EN#transfer_inventory|transfer_inventory]]
* Improved API method API->commutation->[[API_commutation_EN#delete|commutation]]
* Improved API method API->node->[[API_node_EN#get|get]]
* Improved API method API->address->[[API_address_EN#get_house|get_house]]
* The scheduler task "Send low-stock information" can now specify the delivery options "E-mail/Messenger"; the employee card also now lets you specify delivery options for this mailing in the "Notifications" section
* The inventory list in the task card can now transfer all inventory items to the selected recipient at once
* Quick value search was added to custom fields of the "List selection" type
* Improved the use of explicitly specified coordinates when editing a building card and selecting a polygon/point
* Fixed creating cable lines to a building from the coverage map
* Fixed an error when opening Settings - Modules ''(in some cases)''
* Fixed grouping in the task list ''(in some cases)''
* Fixed deleting a label from the switching scheme
* Fixed the "Show dismissed employees in selectors/search for N days after dismissal" parameter
* Fixed warehouse availability checks when selecting inventory items during task execution
* Fixed the "Show tasks by actual completion date" variable
* Fixed using task-type appearance color settings in the calendar
* Fixed coverage-map search ''(substituting the current locality in the search window)''
* Fixed navigation from a customer card to the map with the customer's building coordinates
* Fixed saving interfaces/stacking in the device card

== 3.21.2 - 26.06.2026 ==
* Improved API method API->address->[[API_address_EN#get_house|get_house]]
* When transferring inventory from a customer card, the sub-account receiving the inventory can now be selected
* When creating/editing a task for a building, information about building tags and the building note is shown
* When creating a task in a chain, a specific custom assignee/department can be specified separately
* Bulk inventory transfer now creates combined transfer operations instead of separate operations for each item
* The task list filter-result grouping now has a "Completion date (month)" option
* Fixed an error when creating a task ''(in some cases)''
* Fixed changing coordinates in building, communications installation, and customer cards ''(in some cases)''
* Fixed generation of communications-installation names when selecting a building floor ''(in some cases)''
* Fixed link handling in text values of custom fields
* Fixed assigning assignees when creating a task ''(in some cases)''

== 3.21.1 - 25.06.2026 ==
* Improved map centering when editing a polygon/building on the coverage map
* Fixed displaying global switching schemes ''(in some cases)''
* Fixed exporting the cable line list to XLS ''(in some cases)''
* Fixed correct rendering of customers on the building logical scheme ''(in some cases)''
* Fixed selecting parent objects when adding a building from the coverage map
* Fixed attaching a customer when adding a new task for a customer
* Fixed minor bugs

== 3.21.0 - 23.06.2026 ==
* Version release

== 3.21.0-beta.7 - 21.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.6 - 20.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.5 - 17.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.4 - 13.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.3 - 07.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.2 - 30.05.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.1 - 24.05.2026 ==
* See the list of changes in [[3.21_EN|3.21]]

3.21 EN

2026-07-06T13:59:48Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[3.21_UK|uk]] | [[3.21|ru]]

Release date: '''June 2026'''

''Main changes: https://promo.userside.eu/321/''

See also:
* [[Upgrade_3.21|Upgrade to version 3.21]]
* [[Versions of ERP "USERSIDE"]] | [[Versions 3.21 EN|Versions 3.21]]

== List of changes ==

'''High-priority changes:'''
* [[PWA (application)|PWA ''(application)'']]
* Automatic building of a [[Business process|business logic/workflow diagram]] for task types based on task chains and automation
* Updated task [[Calendar|calendar]] and [[Google Calendar integration|Google Calendar integration]]
* A separate [[Bulk inventory transfer|interface for fast inventory transfer]] by scanning or entering barcodes, serial numbers, and other identifiers ''(including barcode scanning with a mobile device camera)''
* [[Switching scheme#anchor_321|Switching scheme snapshots]] are shown on the main scheme and are generated directly during switching/disconnection operations on a communications installation
* In the switching scheme, creating connections and deleting or changing a connection polyline is performed without reloading or waiting for the page ''(in practice, this made work 2-10 times faster)''
* A home-page panel with [[Work schedule#anchor_321|task filter counters/KPI indicators]]
* "Physical" [[Document signing with customers|document signing by customers/clients]] on tablets ''(mobile devices)''
* Automatic real-time GPS position updates for transport on the map ''(every N seconds)''
* Home-page widget with [[Statistics#anchor_321|the most problematic customers and buildings]]
* New [[Structural scheme|structural scheme]]. Scaling and SVG export
* [[Internal API EN|Internal API]] v2. Event system in ERP
* IPv6 accounting support for equipment and customers
* Updated UI/UX

'''Customers/clients:'''
* Added mass import of potential customers
* Added the ability to send SMS in group actions for customers
* '''Specific customers can be added to SMS mailing conditions'''
* Added the "Ignore SMS opt-out" filter to SMS mailings
* Added different customer-data templates for group email sending to customers
* Customer correspondence can hide comments from tasks
* Added customer status history storage
* Added IP address usage history
* Customer list:
** '''The filter now supports "and/or" mode'''
** '''The filter can now include/exclude conditions ''(previously it could only include them)'''''
** Added the "Customers included in equipment" filter
** Added filtering by task number. The task card also shows a link to this filter when at least three customers are attached to the task
** The customer list can display the "Manager" field
** The list of customers dependent on a device/communications installation also includes customers that are not commutated but have devices ''(for example ONU)'' that depend on the parent object

'''Equipment:'''
* '''Added tabs to the switch/equipment card'''
* If a device has no IP address, has one port, and is connected to an upstream managed switch, the port table for that device shows SNMP information from the upstream device port
* PON:
** '''ONU signal level history is now displayed as a chart'''
** The order and displayed fields can be configured for the list of connected ONUs
** The OLT card now shows an ONU counter on ports
* Split percentages can be specified for planned splitters
* Added the "Number of occupied adapters" field to the splitters table
* Devices can be added manually in the VLAN card

'''Switching scheme:'''
* Labels on the switching scheme can be rotated
* When adding a splitter from the switching scheme, the user no longer leaves the scheme for the splitter card
* The switching wizard can now switch devices
* Added the ability to quickly change labels for all ports at once for a distribution frame/ODF in the switching scheme
* Planned commutations in the replanning scheme can now have their route changed manually
* On mobile devices, dragging switching lines is blocked by default when the page is opened

'''Tasks:'''
* Implemented multilevel task type groups
* Updated task [[Calendar|calendar]]:
** '''dragging tasks ''(changing work time)'''''
** task due time can be changed ''(by dragging the lower boundary)''
** weekly/monthly mode for departments and employees
** modes: "department" / "+ employees" / "+ employees and departments"
** 15/30/60 minutes ''(previously only one-hour slots)''
** high priority is marked, and the information template for the task title and task body can be configured
* '''Checks whether a previously attached file still exists in tasks and task comments ''(to prevent employees from attaching old files as if they were new)'''''
* The task card can transfer inventory available to the employee with one button
* Added a new special type for task types: "Work with debtors"
* The task card shows a row with coordinates and a quick link to Google Maps
* When creating a child task from the task card, files from the parent task can also be copied ''(used)''
* Improved display of inventory information in the inventory list when the task status changes
* "Work notes" were extended from buildings to any address object

* New settings:
** "Sort customers in the task card by the order in which they were added to the task"
** "Interval for displaying tasks in the My tasks section (days)"
** "Block execution of task automation/chain when a task is returned from a status with the system role Deferred"

* Task chains/automation:
** Added the additional condition "Task. Tag"
** Added action variants:
*** "Parent task (the very first in the chain). Change status to"
*** "Parent task (all in the chain). Change status to"
*** "Inventory. Transfer to parent task"
*** "Inventory. Transfer to child task"
*** "Transfer custom field values to the building card"

* Task list:
** The task list can show thumbnails of attached files ''(setting)''
** Task filter:
*** added "and/or" modes
*** expanded filter by parent task number
*** expanded filter by "Completed with due time over..."
*** expanded filter by parent task number
*** added filtering by checklist value
** Added group actions in the task list:
*** "Customers - Open list"
*** "Assign owner"
*** "Remove owner"

'''Warehouse:'''
* Implemented inventory transfer to an employee with employee confirmation of receipt/refusal
* '''Warehouse operations now have filtering by "Address (with objects)", which allows selecting inventory transfer operations for all objects in that area'''
* '''The inventory list can now be filtered by any address object ''(including the full hierarchy)'' ''(region, city, street, etc.)'''''
* The inventory list shows a totals row with total cost/purchase cost
* In the inventory balance report, report item names are links for quickly viewing the corresponding inventory list
* Added groups for suppliers
* Added the ability to send an employee a Messenger/Telegram message when inventory is transferred to or from that employee's accountability
* When splitting inventory, MAC addresses/serial numbers can be specified for the resulting items immediately

'''Coverage:'''
* Added automatic real-time GPS position updates for transport on the map ''(every N seconds)''. Added the "Transport position update interval on the map" setting
* '''When several objects overlap on the map ''(communications installations at one point, many closures on one pole, cable lines running next to each other, etc.)'', hovering over this cluster expands it so the required object can be selected'''
* Improved display of cable lines that pass through the visible map area while their endpoints are outside the current view
* Added a new ruler on the map
* Added a new map object type: "Link"
* Popup hints on map polygons now show custom field values
* The building list can show the penetration percentage field and the "Notes" field, and a filter for this field was added

'''Communications installations:'''
* A communications installation can be hidden from the coverage map
* Added the "Suggest a new number when adding an object" parameter for communications installation types
* In the cabinet/rack layout, popup hints on devices now show serial/inventory numbers

'''Cable lines:'''
* Added filtering by custom fields in the cable line list
* In group actions for replacing the cable brand in the cable line list, this action can also replace module/fiber/conductor colors in the cable according to the new cable brand

'''Employees:'''
* Added a personal setting for extra buttons in the left menu of the mobile version, including custom links
* New rights in employee profiles:
** View/change supplier information
** View/change employee fines and bonuses

'''API:'''
* '''Separate [[UserSide API Key EN|API keys]] can now be created for read-only operations'''
* '''All requests that write or modify data must now be sent only through POST'''
* Requests must not include extra parameters. If an extra parameter is present, the request returns an error
* Improved API method API->address->[[API_address_EN#edit_address|edit_address]]
* Improved API method API->attach->[[API_attach_EN#add|add]]
* Added API method API->attach->[[API_attach_EN#upload|upload]]

'''Transport:'''
* '''Transport operations were deeply reworked. Different types, mileage and deadline control, home-page and transport-list notifications, and operation change history are now supported'''

'''Other:'''
* PHP 8.4
* Added Albanian, Uzbek, and Tajik localizations. Multiple fixes in existing localizations.
* '''The [[usm_asterisk]] module now supports transferring call recordings and listening to them in the ERP interface'''
* Switched objects from numeric IDs to string UUIDs ''(numeric IDs remain for some objects as additional reference values)''
* New WYSIWYG editor
* '''Dark interface theme ''(with automatic switching support)'''''
* '''Custom field values can be edited directly in object cards while viewing them ''(without switching to edit mode)'''''
* '''Reworked attached-file block'''
** Completely different capabilities, gallery, actions, and more
** Quick "Take photo" button for mobile devices
** Large file-add button for mobile devices
** The Ctrl+V clipboard block now supports pasting multiple images and files of any format ''(not only images)''
* New adaptive left menu with hide/show support
* '''Added buttons to the left menu for mobile devices:'''
** "My position on the map"
** QR code
** Barcode ''(and it can beep while scanning)''. If such an inventory item exists, its card opens; if there are no rights to the inventory item but such equipment exists, the equipment card opens. Otherwise, the search list opens
** Three buttons for custom links
** Buttons to share/open a link
* '''Added the "Convert HEIC files to JPEG" option and on-the-fly .heic file support'''
* The "Notebook" section was transformed into a configurable custom section. This significantly expands its functionality
* New barcode generation library ''(SVG format)''
* Improved the cash receipts report: grouping by settlements and by settlements + months, plus detailed payment list viewing
* In group actions for objects, the "Apply" button now shows the number of selected objects and is blocked if no action/objects are selected
* The date/date-time selector localization was fixed for the current language
* A compatibility solution for dates after 2038 was implemented preventively ''("Unix 2038 bug")''
* Separate SMS profiles for work. For example, each SMS mailing can use a separate SMS profile ''(custom alpha name, different operator, etc.)''
* Object-list filters by custom field values now include "greater than" and "less than" variants
* New versions of external [[Modules_EN|modules]]

* Other changes: see https://wiki.userside.eu/3.20

API attach UK

2026-07-06T13:59:03Z

IronBot: [IronBot] Sync UK localization from RU

[[API_attach_EN|en]] | '''uk''' | [[API attach|ru]]

Розділ '''[[API_UK|API]]''' ERP "UserSide"

Призначення: Робота з прикріпленими файлами

Додаткові параметри:
action - підкатегорія запиту ''(можливе значення: див. нижче)''

== Підкатегорії ==

==== add ====
''Доопрацьовано у: 3.21.0-beta.3 (виключено параметри src, name, comment, src_id)''

''Доопрацьовано у: 3.19.48 (додано параметр uuid)''

''Доопрацьовано у: 3.16.19 (додано параметри name і comment)''

''Доопрацьовано у: 3.16dev4 (до параметра object_type додано можливе значення cable_line)''

''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

''Доопрацьовано у: 3.15.42 (до параметра object_type додано можливе значення inventory)''

''Доопрацьовано у: 3.14.21 (до параметра object_type додано можливе значення customer)''

Опис: Додавання файла до об'єкта
Обов'язкові параметри:
object_type - тип об'єкта [cable_line|customer|node|task|task_comment|inventory]
object_id - id об'єкта, до якого прикріплювати файл
comment_id - id коментаря до завдання, до якого прикріплювати файл ''(для типу task_comment)''
uuid - uuid іншого файла, який уже завантажений і який потрібно прикріпити до іншого об'єкта
Необов'язкові параметри:
employee_id - id співробітника, від імені якого прикріпити файл
name - ім'я файла ''(довільний текст)'' ''(до версії 3.21)''
comment - нотатки/опис до файла ''(до версії 3.21)''
src_id - id методу/типу завантаження файла ''(довільно, на розсуд клієнта)'' ''(до версії 3.21)''

==== delete ====
''Доопрацьовано у: 3.19beta1 (виключено параметр id, додано параметр uuid)''

''Додано з: 3.12beta25''
Опис: Видалення файла
Обов'язкові параметри:
id - id файла ''(версії до 3.19)''
uuid - uuid файла ''(версія 3.19+)''
name - ім'я файла ''(без шляхів)''

==== get ====
''Доопрацьовано у: 3.20.23 (до параметра object_type додано можливе значення additional_field)''

''Доопрацьовано у: 3.19beta1 (виключено параметр id, додано параметр uuid)''

''Доопрацьовано у: 3.16dev4 (до параметра object_type додано можливе значення cable_line)''

''Доопрацьовано у: 3.15.42 (до параметра object_type додано можливе значення inventory)''

''Доопрацьовано у: 3.15.12 (додано параметри object_type і object_id)''

''Доопрацьовано у: 3.14.41 (додано параметри ext_name і int_name)''

''Додано з: 3.14.36''
Опис: Отримання інформації
Обов'язкові параметри ''(щось одне)'':
uuid - uuid файла ''(можна через кому)'' ''(версії 3.19+)''
id - id файла ''(можна через кому)'' ''(версії до 3.19)''
ext_name - зовнішнє ім'я файла ''(початкове)''
int_name - внутрішнє ім'я файла ''(як зберігається в системі)''
object_type - тип об'єкта [additional_field|cable_line|customer|inventory|node|task|task_comment] ''(використовується разом з object_id)''
object_id - id/uuid об'єкта, до якого прикріплений файл ''(використовується разом з object_type)''

==== get_file ====
''Доопрацьовано у: 3.19beta1 (виключено параметр id, додано параметр uuid)''

''Додано з: 3.14.57''

Опис: Виведення вмісту файла ''(у бінарному вигляді)''
Обов'язкові параметри:
uuid - uuid файла ''(версії 3.19+)''
id - id файла ''(версії до 3.19)''

==== get_file_temporary_link ====

''Доопрацьовано у: 3.19beta1 (виключено параметр id, додано параметр uuid)''

''Додано з: 3.17dev1''
Опис: Надання прямого тимчасового посилання для завантаження файла
Обов'язкові параметри:
uuid - uuid файла ''(версії 3.19+)''
id - id файла ''(версії до 3.19)''

==== upload ====

''Доопрацьовано у: 3.21.4 (додано параметр additional_field_id)''

''Додано з: 3.21.0-beta.3''

Опис: Завантаження (додавання) файла до об'єкта.

content-type=multipart/form-data

Обов'язкові параметри:
object_type - тип об'єкта [cable_line|customer|node|task|task_comment|inventory]
object_id - id об'єкта, до якого прикріплювати файл
comment_id - id коментаря до завдання, до якого прикріплювати файл ''(для object_type=task_comment)''
file - файл
Необов'язкові параметри:
additional_field_id - id додаткового поля ''(якщо потрібно прикріпити файл до додаткового поля об'єкта. Тип додаткового поля має бути "Файл")''
employee_id - id співробітника, від імені якого додати файл
name - ім'я файла ''(довільний текст)''
comment - нотатки/опис до файла
src_id - id методу/типу завантаження файла ''(довільно, на розсуд клієнта)''

API customer EN

2026-07-06T13:59:03Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[API_customer_UK|uk]] | [[API customer|ru]]

Section '''[[API_EN|API]]''' ERP "UserSide"

Purpose: Actions with customers. Most actions are relevant for [[Supported_billings|manual billing]].

Additional parameters:
action - subcategory of the request ''(possible value: see below)''

== Subcategories ==

==== add ====
''Modified in: 3.13.25 (added is_corporate parameter)''
Description: Add a customer
Optional parameters:
fio - name of the customer
codeti - customer id in the billing system
is_potential - flag - potential customer
is_corporate - flag - legal entity
billing_id - billing id
billing_customer_id - customer id in billing ''(required if this is not a potential customer)''

==== abon_hist ====
''Modified in: 3.17dev1 (excluded usercode parameter, added customer_id parameter)''

Description: Display customer transactions (financial and other)
Required parameters:
usercode - ''(for version 3.16 and earlier)'' customer ID
customer_id - ''(for version 3.17 and later)'' customer ID

==== change_balance ====
''Modified in: 3.16dev2 (removed operator_id parameter, added employee_id parameter)''

''Modified in: 3.13.22 (added operator_id parameter)''
Description: Change balance (income/expense operation)
Required parameters:
customer_id - customer ID
amount - Amount
comment - operation notes
Optional parameters:
employee_id - employee ID
operator_id - operator ID ''(before version 3.16dev2)''

==== change_billing ====
''Modified in: 3.16.23 (added billing_user_id parameter)''

''Added in: 3.12.48''

Description: Change billing
Required parameters:
customer_id - customer id
billing_id - billing id
Optional parameters:
billing_user_id - customer id in billing

==== change_date_connect ====
''Added in: 3.12.80''

Description: Change the connection date
Required parameters:
customer_id - customer ID
value - date

==== delete ====
''Added in: 3.14.21''
Description: Delete a customer
Required parameters:
id - customer ID

==== edit ====
''Modified in: 3.20.10 (added coordinates parameter)''

''Modified in: 3.16dev3 (added group_id parameter)''

''Modified in: 3.13.56 (added manager_id parameter)''

''Added in: 3.12rc2''

Description: Edit a customer
Required parameters:
id - customer ID
Optional parameters:
account_number - personal account number
agreement_date - agreement date
agreement_number - agreement number
apartment_number - flat number
comment - notes
coordinates - coordinates as text separated by comma ''(example: 47.839628,35.140553)''
date_activity - date of network activity
date_activity_inet - date of internet activity
date_connect - date of connection
email - email address
entrance - entrance number
flag_corporate - flag - legal entity
floor - floor
group_id - group id
house_id - house id
is_potential - flag - potential customer
login - login
manager_id - id of manager employee
name - name of customer
parent_id - id of parent customer ''(for the child customer)''
phone0 - mobile phone number
phone1 - home phone number
phone2 - additional phone number 1
phone3 - additional phone number 2
phone4 - additional phone number 3

==== get_activity_counter ====
''Added in: 3.12.81''
Description: Retrieve the counter of active customers
Required parameters:
type - counter type ''(Possible values: net, internet, personal_area)''

==== get_abon_id ====
''Modified in: 3.14.34 (added possible account value for data_typer parameter)''
Description: Retrieve customer ID from input data
Required parameters:
data_typer - type of data we are checking ''(possible values: account, billing_uid, codeti, dognumber, ip, login, mac, mail, phone)''
data_value - value
Optional parameters:
is_skip_old - flag - do not search among former customers

==== get_customer_group ====

''Added in: 3.19beta1''

Description: Get list of customer groups
Required parameters:
None
Optional parameters:
None

==== get_customers_id ====
''Modified in: 3.21.8 (added group_id parameter)''

''Modified in: 3.19.31 (added account_number parameter)''

''Modified in: 3.19.15 (added billing_uuid parameter)''

''Modified in: 3.18.36 (added manager_id parameter)''

''Modified in: 3.18.10 (added is_corporate parameter)''

''Modified in: 3.16dev3 (added parameters name, limit, is_like)''

''Modified in: 3.15.26 (added is_ex parameter)''

''Modified in: 3.14.71 (added dependence_device_id parameter)''

''Modified in: 3.14.58 (added balance_from, balance_to, state_id parameters)''

''Modified in: 3.14.41 (added date_connect_from and date_connect_to parameters)''

''Modified in: 3.14.5 (added address_unit_id parameter)''

''Modified in: 3.13.48 (added tariff_id parameter)''

''Modified in: 3.13.35 (added mark_id parameter)''

''Added in: 3.12.8''
Description: Retrieve list of customer IDs by incoming conditions
Required parameters:
None
Optional parameters ''(but at least one condition must be specified)'':
account_number - personal account number
address_unit_id - address unit id
appartment - number of the flat
balance_from - balance ''(from)''
balance_to - balance ''(to)''
billing_id - billing number id
billing_uuid - customer id in billing
date_connect_from - date of connection ''(from)''
date_connect_to - date of connection ''(to)''
dependence_device_id - id of the device the customers depend on
group_id - group id
house_id - house id
is_corporate - flag - a legal entity
is_ex - flag - former customers
manager_id - manager id ''(0 to search without manager)''
mark_id - mark id
name - name/title of customer
state_id - status id
tariff_id - tariff id
limit - maximum number of records to return in the response
is_like - flag - use substring comparison where possible ''(not a full match)''

==== get_data ====
Description: Retrieve customer information
Required parameters:
customer_id - customer ID
or
account_number - customer's personal account number
+
billing_id - billing ID

==== get_ip_port_device_commutation ====

''Added in: 3.12beta35''
Description: Get customer IP and MAC addresses with switch bindings ''(including for DHCP use)''

==== get_last_ip ====
Description: Get the last used IP address for customers

==== get_mac_history ====

''Added to: 3.16dev8''

Description: Get MAC address change history by customer
Required parameters:
customer_id - customer ID

==== get_max_agreement_number ====

''Added in: 3.12.3''
Description: Get the maximum occupied contract number ''(numeric)''
Optional parameters:
billing_id - billing id of customers among which to perform the selection

==== ip_add ====
''Modified in: 3.17.36 (added mac parameter)''

''Added in: 3.12.83''

Description: Add IP address
Required parameters:
customer_id - customer ID
value - IP
Optional parameters:
mac - MAC of the customer

==== ip_delete ====
''Modified in: 3.19beta1 (added possible value all to the value parameter)''

''Added in: 3.12.83''

Description: Delete IP address
Required parameters:
customer_id - customer ID
value - ip or "-1" for entries with no IP address ''(MAC address only)'' or "all" for all addresses

==== ip_subnet_add ====

''Added in: 3.14.71''

Description: Add an IP address subnet for a customer
Required parameters:
customer_id - customer ID
ip - initial ip address
subnet - subnet mask/VLSM ''(for example: 24)''

==== ip_subnet_delete ====

''Added to: 3.14.71''

Description: Delete an IP address subnet from a customer
Required parameters:
customer_id - customer ID
ip - initial ip address

==== list_tarif_available ====

''Excluded in: 3.13''

Description: List of tariffs available for customer tariff changes
Required parameters:
usercode - customer ID

==== mark_add ====
''Added in: 3.12.82''
Description: Add a mark to a customer
Required parameters:
customer_id - customer ID
mark_id - mark id

==== mark_delete ====
''Added in: 3.12.82''
Description: Delete a mark from a customer
Required parameters:
customer_id - customer ID
mark_id - mark id

==== msg ====
''Modified in: 3.17dev1 (usercode parameter removed, customer_id parameter added)''

''Modified in: 3.16dev3 (made usercode parameter optional)''

''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Modified in: 3.14.53 (added date_add_from, date_add_to, operator_id parameters)''

Description: Display correspondence with a customer
Optional parameters ''(at least one is required)'':
usercode - ''(for version 3.16 and earlier)'' customer ID
customer_id - ''(for version 3.17 and later)'' customer ID
date_add_from - date of message (from)
date_add_to - date of message (to)
is_answer - whether the message has an answer ''(1 - answered, 0 - not answered)''
is_archive - whether the message is archived
employee_id - id of the employee who authored the message
operator_id - id of the operator who authored the message ''(before version 3.16dev2)''

==== msg_add ====
''Added in: 3.13.25''
Description: Add a message from a customer
Required parameters:
customer_id - customer ID
text - Message text
Optional parameters:
is_arc - flag - put the message into the archive

==== pass_change ====
''Modified in: 3.17dev1 (usercode parameter removed, customer_id parameter added)''

''Modified in: 3.15.23 (pass_old parameter became optional)''

Description: Change password for logging in to the customer portal
Required parameters:
usercode - ''(for version 3.16 and earlier)'' customer ID
customer_id - ''(for version 3.17 and later)'' customer ID
pass_new - new password
Additional parameters:
pass_old - current password

==== service_add ====

''Added in: 3.18beta1''

Description: Add additional service
Required parameters:
customer_id - customer ID
service_id - id of additional service
Optional parameters:
price - individual price
comment - notes

==== service_remove ====

''Added in: 3.18beta1''

Description: Remove additional service
Required parameters:
customer_id - customer ID
service_id - id of additional service

==== set_mac_by_ip ====

''Added in: 3.12beta35''
Description: Set the MAC address for a customer's IP address
Required parameters:
ip - IP address of the customer (for example: 192.168.0.1)
mac - MAC address of the customer (for example: 00:11:22:33:44:55)

==== state_change ====

''Modified in: 3.17dev1 (removed usercode parameter, added customer_id parameter)''

''Added in: 3.12.8''

Description: Change a customer's service status
Required parameters:
usercode - ''(for version 3.16 and earlier)'' customer ID
customer_id - ''(for version 3.17 and later)'' customer ID
state_id - customer status ID (0 - stop, 1 - paused, 2 - active)

==== tarif_change ====

''Modified in: 3.17dev1 (excluded usercode parameter, added customer_id parameter)''

Description: Change a customer's tariff
Required parameters:
usercode - ''(for version 3.16 and earlier)'' customer ID
customer_id - ''(for version 3.17 and later)'' customer ID
tarif - new tariff ID

==== to_ex ====
''Modified in: 3.17dev1 (removed usercode parameter, added customer_id parameter)''

''Added in: 3.12.69''

Description: Move a customer to the ''Former customers'' category
Required parameters:
usercode - ''(for version 3.16 and earlier)'' customer ID
customer_id - ''(for version 3.17 and later)'' customer ID

==== to_normal ====
''Modified in: 3.17dev1 (removed usercode parameter, added customer_id parameter)''

''Added in: 3.12.90''

Description: Move a customer back to normal status (from "Former customers")
Required parameters:
usercode - ''(for version 3.16 and earlier)'' customer ID
customer_id - ''(for version 3.17 and later)'' customer ID

==== merge ====
''Added in: 3.19.33''

Description: Merge customers
Required parameters:
dst_id - main customer id
src_id - secondary customer id ''(whose information is moved to the main customer)''

==== msg_add_to_customer ====
''Added in: 3.19.45''

Description: Add a message from an employee to a customer
Required parameters:
employee_id - employee id
customer_id - customer id
text - Message text
Optional parameters:
is_arc - flag - put the message into the archive

Versions 3.20 EN

2026-07-06T13:59:03Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[Версії_3.20|uk]] | [[Версии_3.20|ru]]

Branch versions [[3.20_EN|3.20]]

Also see: [[Versions of ERP "USERSIDE"]]

== 3.20.26 (in development) ==
* Fixed employee login generation/transliteration on creation ''(in some cases)''
* Fixed an error when building the inventory balance by tasks report

== 3.20.25 - 24.06.2026 ==
* Improved the display of planned cable lines on the coverage map according to cable-density color settings
* Fixed a bug with displaying the cable line list ''(in some cases)''
* Fixed minor bugs and changes

== 3.20.24 - 27.05.2026 ==
* Fixed minor bugs and changes

== 3.20.23 - 27.04.2026 ==
* Added API method->call->[[API_call_EN#agent_call|agent_call]]
* Added API method->chapter->[[API_chapter_EN#link_add|link_add]]
* Added API method->chapter->[[API_chapter_EN#link_get|link_get]]
* Added API method->chapter->[[API_chapter_EN#link_remove|link_remove]]
* Improved API method->call->[[API_call_EN#add|add]]
* Improved API method->task->[[API_task_EN#edit|edit]]
* Completed tasks now also show the "Overdue" flag when work deadlines are missed
* Fixed a bug when opening the work calendar ''(in some cases)''
* Fixed minor bugs

== 3.20.22 - 04.04.2026 ==
* Fixed selecting an empty value in the task type for registration by phone
* Optimization work
* Fixed minor bugs

== 3.20.21 - 11.03.2026 ==
* Fixed display of the error counter on equipment interfaces ''(in some cases)''
* Fixed SMS message template settings for customers in tasks
* Optimization work
* Fixed minor bugs

== 3.20.20 - 22.02.2026 ==
* Optimized the "My tasks" section
* Fixed broken main menu layout in some cases

== 3.20.19 - 08.02.2026 ==
* Fixed minor bugs

== 3.20.18 - 23.01.2026 ==
* Optimized the warehouse report "Turnover balance sheet"
* Fixed minor bugs

== 3.20.17 - 31.12.2025 ==
* Added API method->task->[[API task#add_node_to_task|add_node_to_task]]
* Added API method->task->[[API task#remove_node_from_task|remove_node_from_task]]
* Fixed execution of task chain ''(in some cases)''
* Fixed minor bugs

== 3.20.16 - 14.12.2025 ==
* Fixed a bug with filtering by inventory section in the warehouse operations list
* Fixed minor bugs

== 3.20.15 - 06.12.2025 ==
* For task chains/automation in task types, added the ability to specify fractional hour intervals
* Fixed minor bugs

== 3.20.14 - 29.11.2025 ==
* Improvements to the API interface with Binotel
* Fixed minor bugs

== 3.20.13 - 22.11.2025 ==
* Fixed minor bugs

== 3.20.12 - 15.11.2025 ==
* Added the setting "Scale the width of the cable line on the switching diagram depending on the length of the name"
* Improved the display of unknown ONUs by OLT in the main page widget
* Fixed other minor bugs

== 3.20.11 - 08.11.2025 ==
* Fixed an error when entering the Custom notifications section ''(in some cases)''
* Fixed an error when entering the device interface/stacking settings ''(in some cases)''
* Fixed the inability to switch between ODF/crosses in the switching master
* Fixed some migration errors

== 3.20.10 - 07.11.2025 ==
* Added API method->vehicle->[[API vehicle#add|add]]
* Added API method->vehicle->[[API vehicle#edit|edit]]
* Added API method->vehicle->[[API vehicle#delete|delete]]
* In the communication installations card, in the block with attached image files, it is possible to quickly make an image the main photo for this object ''(without having to go to editing)''
* In the cable line card, the ability to create a task with this line or add a line to an existing task has been added
* Sorting by additional fields in custom sections has been improved
* Filtering by inventory item name in the inventory list has been fixed
* The display of equipment layers on the coverage map has been fixed
* Other minor bugs have been fixed

== 3.20.9 - 14.09.2025 ==
* Improved verification of access rights to ONU
* Fixed a bug when searching for a user during the transfer of inventory items ''(in some cases)''
* Fixed an update in the serial number database for ONU when polling OLT ''(in some cases)''

== 3.20.8 - 06.09.2025 ==
* Added API method->billing->[[API billing#refresh_date_update|refresh_date_update]]
* Optimised interface for editing/adding address units ''(relevant for branched address structures)''
* Links to view users associated with communication installations and cable lines have been added to the task card
* Fixed checking for parent task status in task automation ''(in some cases)''
* Fixed display of pop-up hints in the task calendar when scrolling horizontally
* Fixed assignment of employees to a department ''(in some cases)''

== 3.20.7 - 25.08.2025 ==
* '''In-depth processing of transport operations. Various types, mileage control, deadlines. Notification on the main page and transport list. Keeping a history of changes in operations'''
* The history of actions for a potential user is transferred to the history of actions for a regular user when they are merged
* During hot replacement of a device, you can specify to save the history of MAC addresses on equipment ports
* The ability to clear switching has been added to group actions on the user list
* Technical migration of core data
* Fixed filtering of the FDB table by device ''(in some cases)''
* Fixed a bug when restricting an employee's access to a specific IP address
* Fixed ONU access rights verification

== 3.20.6 - 15.08.2025 ==
* ''' Separate SMS profiles for work. For example, you can specify a separate SMS profile for each SMS mailing ''(your own alpha name, different operator, etc.)'''''
* Separated ONU access rights for viewing and editing
* Fixed display of a large number of notebook sections in the section list
* Fixed information update when adding/removing a communication facility in a task

== 3.20.5 - 08.08.2025 ==
* Added API method->address->[[API address#get_building_type|get_building_type]]
* Added the "Buildings. Pop-up message template on the map" setting
* Improved the interface for changing notes, adapter types, and connections for fibre cable lines
* Redesigned the interface for adding communication structures and cable lines to a task when creating a task
* Corrected the verification of access rights to the work schedule
* Improved the billing of employees for tasks in the work schedule when more than 5 employees are involved in the task
* Fixed a bug in filtering by building in the list of warehouse operations ''(in some cases)''

== 3.20.4 - 04.08.2025 ==
* Added API method->cross->[[API cross#edit_adapter|edit_adapter]]
* Added API method->task->[[API address#edit_address|edit_address]]
* Added a setting parameter "Block automation/task chain execution when returning a task from the status with the system role 'Pending' "
* Added grouping of tasks by street or location to the task list
* Improved saving of files attached to task comments
* Minor fixes and improvements

== 3.20.3 - 27.07.2025 ==
* Added API method->task->[[API task#change_state|change_state]]
* The "Consider connections on dividers as mechanical" configuration parameter has been added
* In the task type settings for inventory items, you can specify that all inventory items should be moved to the associated building after closing
* In chains/automation by task type, the additional condition "Child/parent task status" has been added for the action options "Parent/Child task. Change status to"
* Information about the date of installation of inventory items on the building and the ability to export to XLS and printable versions has been added to the building card in the inventory list
* All attached files from another task can be copied to the card
* A direct link to view the customer's switching route has been added to the customer card
* For employee profiles, you can limit the maximum number of entries on the page (in tables/lists)
* The filter for communication facilities now includes the option to select by missing custom icon on the map
* In the list of warehouse operations in the counterparty selection selectors, the ability to specify a specific building has been added
* In group actions for buildings, the ability to change the individual colour on the map has been added
* In group actions for buildings, you can change the manager to the empty value ''(delete manager)''
* Fixed sorting by address in the task list ''(in some cases)''
* Fixed the ability to simultaneously postpone a task and specify an arbitrary comment

== 3.20.2 - 18.07.2025 ==
* Added API method->task->[[API task#add_cable_line_to_task|add_cable_line_to_task]]
* Added API method->task->[[API task#remove_cable_line_from_task|remove_cable_line_from_task]]
* The list of connected ONUs on the OLT can be printed or exported to XLS
* For communication installations and cable lines the possibility to change notes in group actions has been added
* In the template of the tooltip on the task on the coverage map it is possible to display the date of task creation, update date, text of the last comment
* In chains/automation by task type, added action "Customers. Exclude."
* In chains/automation by task types, added possibility to disable auto-assigned executors when creating a new task in a chain
* Improved displaying of links in the description of a task type in the task card
* Fixed filtering of customers that depend on cross/odf ''(in some cases)''

== 3.20.1 - 12.07.2025 ==
* In the list of buildings, added filter for buildings with "Display on map" unchecked
* Fixed inability to open a vehicle card from the list
* Fixed search by cable line name when task is created ''(in some cases)''
* Fixed display of customer information in the task list ''(in some cases)''

== 3.20 - 09.07.2025 ==
* Release version 3.20
* For a list of changes see [[3.20_EN|3.20]]

API customer UK

2026-07-06T13:58:52Z

IronBot: [IronBot] Sync UK localization from RU

[[API_customer_EN|en]] | '''uk''' | [[API customer|ru]]

Розділ '''[[API_UK|API]]''' ERP "UserSide"

Призначення: Дії з абонентами. Більшість дій актуальна для [[Підтримувані білінги|ручних білінгів]].

Додаткові параметри:
action - підкатегорія запиту ''(можливе значення: див. нижче)''

== Підкатегорії ==

==== add ====
''Доопрацьовано у: 3.13.25 (додано параметр is_corporate)''
Опис: Додавання абонента
Необов'язкові параметри:
fio - найменування абонента
codeti - id абонента в білінгу
is_potential - прапорець - потенційний абонент
is_corporate - прапорець - юридична особа
billing_id - id білінгу ''(є обов'язковим, якщо це не потенційний абонент)''
billing_customer_id - id абонента в білінгу ''(є обов'язковим, якщо це не потенційний абонент)''

==== abon_hist ====
''Доопрацьовано у: 3.17dev1 (виключено параметр usercode, додано параметр customer_id)''

Опис: Виведення операцій з абонентом (фінансові та інші)
Обов'язкові параметри:
usercode - ''(для версії 3.16 і раніше)'' ID абонента
customer_id - ''(для версії 3.17 і пізніше)'' ID абонента

==== change_balance ====
''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

''Доопрацьовано у: 3.13.22 (додано параметр operator_id)''
Опис: Зміна балансу (операція приходу/витрати)
Обов'язкові параметри:
customer_id - ID абонента
amount - Сума
comment - Нотатки до операції
Необов'язкові параметри:
employee_id - ID співробітника
operator_id - ID оператора ''(до версії 3.16dev2)''

==== change_billing ====
''Доопрацьовано у: 3.16.23 (додано параметр billing_user_id)''

''Додано у: 3.12.48''

Опис: Зміна білінгу
Обов'язкові параметри:
customer_id - id абонента
billing_id - id білінгу
Необов'язкові параметри:
billing_user_id - id абонента в білінгу

==== change_date_connect ====

''Додано у: 3.12.80''

Опис: Зміна дати підключення
Обов'язкові параметри:
customer_id - ID абонента
value - дата

==== delete ====
''Додано у: 3.14.21''
Опис: Видалення абонента
Обов'язкові параметри:
id - id абонента

==== edit ====
''Доопрацьовано у: 3.20.10 (додано параметр coordinates)''

''Доопрацьовано у: 3.16dev3 (додано параметр group_id)''

''Доопрацьовано у: 3.13.56 (додано параметр manager_id)''

''Додано у: 3.12rc2''

Опис: Редагування абонента
Обов'язкові параметри:
id - id абонента
Необов'язкові параметри:
account_number - номер особового рахунку
agreement_date - дата договору
agreement_number - номер договору
apartment_number - номер квартири
comment - нотатки
coordinates - координати в текстовому вигляді через кому ''(приклад: 47.839628,35.140553)''
date_activity - дата активності в мережі
date_activity_inet - дата активності в інтернеті
date_connect - дата підключення
email - адрес електронної пошти
entrance - номер під'їзду
flag_corporate - прапорець - юридична особа
floor - поверх
group_id - id групи
house_id - id будинку
is_potential - прапорець - потенційний абонент
login - логін
manager_id - id співробітника-менеджера
name - найменування абонента
parent_id - id батьківського абонента ''(для дочірнього абонента)''
phone0 - номер мобільного телефона
phone1 - номер домашнього телефона
phone2 - номер додаткового телефона 1
phone3 - номер додаткового телефона 2
phone4 - номер додаткового телефона 3

==== get_activity_counter ====
''Додано у: 3.12.81''
Опис: Отримання лічильника активних абонентів
Обов'язкові параметри:
type - тип лічильника ''(можливі значення: net, internet, personal_area)''

==== get_abon_id ====
''Доопрацьовано у: 3.14.34 (для параметра data_typer додано можливе значення account)''
Опис: Отримання ID абонента за вхідними даними
Обов'язкові параметри:
data_typer - тип даних, які перевіряємо ''(можливі значення: account, billing_uid, codeti, dognumber, ip, login, mac, mail, phone)''
data_value - значення
Необов'язкові параметри:
is_skip_old - прапорець - не виконувати пошук серед колишніх абонентів

==== get_customer_group ====

''Додано у: 3.19beta1''

Опис: Отримання списку груп абонентів
Обов'язкові параметри:
немає
Необов'язкові параметри:
немає

==== get_customers_id ====
''Доопрацьовано у: 3.21.8 (додано параметр group_id)''

''Доопрацьовано у: 3.19.31 (додано параметр account_number)''

''Доопрацьовано у: 3.19.15 (додано параметр billing_uuid)''

''Доопрацьовано у: 3.18.36 (додано параметр manager_id)''

''Доопрацьовано у: 3.18.10 (додано параметр is_corporate)''

''Доопрацьовано у: 3.16dev3 (додано параметри name, limit, is_like)''

''Доопрацьовано у: 3.15.26 (додано параметр is_ex)''

''Доопрацьовано у: 3.14.71 (додано параметр dependence_device_id)''

''Доопрацьовано у: 3.14.58 (додано параметри balance_from, balance_to, state_id)''

''Доопрацьовано у: 3.14.41 (додано параметри date_connect_from і date_connect_to)''

''Доопрацьовано у: 3.14.5 (додано параметр address_unit_id)''

''Доопрацьовано у: 3.13.48 (додано параметр tariff_id)''

''Доопрацьовано у: 3.13.35 (додано параметр mark_id)''

''Додано у: 3.12.8''
Опис: Отримання списку ID абонентів за вхідними умовами
Обов'язкові параметри:
немає
Необов'язкові параметри ''(але має бути вказана хоча б одна умова)'':
account_number - номер особового рахунку
address_unit_id - id адресної одиниці
appartment - номер квартири
balance_from - баланс ''(з)''
balance_to - баланс ''(до)''
billing_id - id номера білінгу
billing_uuid - id абонента в білінгу
date_connect_from - дата підключення ''(з)''
date_connect_to - дата підключення ''(до)''
dependence_device_id - id пристрою, від якого залежать абоненти
group_id - id групи
house_id - id будинку
is_corporate - прапорець - юридична особа
is_ex - прапорець - колишні абоненти
manager_id - id менеджера ''(0 для пошуку без менеджера)''
mark_id - id мітки
name - ПІБ/назва абонента
state_id - id статусу
tariff_id - id тарифу
limit - максимальна кількість записів, які потрібно повернути у відповіді
is_like - прапорець - використовувати порівняння підрядка там, де це можливо ''(а не повний збіг)''

==== get_data ====
Опис: Отримання інформації за абонентом
Обов'язкові параметри:
customer_id - ID абонента
або
account_number - номер особового рахунку абонента
+
billing_id - ID білінгу

==== get_ip_port_device_commutation ====
''Додано у: 3.12beta35''
Опис: Отримання IP,MAC-адрес абонентів із прив'язкою до комутаторів ''(зокрема для роботи з DHCP)''

==== get_last_ip ====
Опис: Отримання останньої використаної IP-адреси для абонентів

==== get_mac_history ====

''Додано у: 3.16dev8''

Опис: Отримання історії зміни MAC-адрес за абонентом
Обов'язкові параметри:
customer_id - id абонента

==== get_max_agreement_number ====
''Додано у: 3.12.3''
Опис: Отримання максимального зайнятого номера договору ''(числового)''
Необов'язкові параметри:
billing_id - id білінгу абонентів, серед яких виконувати вибірку

==== ip_add ====

''Доопрацьовано у: 3.17.36 (додано параметр mac)''

''Додано у: 3.12.83''

Опис: Додавання IP-адреси
Обов'язкові параметри:
customer_id - ID абонента
value - IP
Необов'язкові параметри:
mac - MAC абонента

==== ip_delete ====

''Доопрацьовано у: 3.19beta1 (до параметра value додано можливе значення all)''

''Додано у: 3.12.83''

Опис: Видалення IP-адреси
Обов'язкові параметри:
customer_id - id абонента
value - ip або "-1" для записів без IP-адреси ''(тільки з MAC-адресою)'' або "all" для всіх адрес

==== ip_subnet_add ====

''Додано у: 3.14.71''

Опис: Додавання підмережі IP-адрес для абонента
Обов'язкові параметри:
customer_id - id абонента
ip - початкова IP-адреса
subnet - маска підмережі/VLSM ''(наприклад: 24)''

==== ip_subnet_delete ====

''Додано у: 3.14.71''

Опис: Видалення підмережі IP-адрес в абонента
Обов'язкові параметри:
customer_id - id абонента
ip - початкова IP-адреса

==== list_tarif_available ====

''Виключено у: 3.13''

Опис: Список тарифів, доступних абоненту для зміни
Обов'язкові параметри:
usercode - id абонента

==== mark_add ====
''Додано у: 3.12.82''
Опис: Додавання мітки на абонента
Обов'язкові параметри:
customer_id - id абонента
mark_id - id мітки

==== mark_delete ====
''Додано у: 3.12.82''
Опис: Видалення мітки з абонента
Обов'язкові параметри:
customer_id - id абонента
mark_id - id мітки

==== merge ====
''Додано у: 3.19.33''

Опис: Об'єднання абонентів
Обов'язкові параметри:
dst_id - id основного абонента
src_id - id вторинного абонента ''(інформацію якого переносимо до основного)''

==== msg ====
''Доопрацьовано у: 3.20.18 (додано параметри is_answer, is_archive)''

''Доопрацьовано у: 3.17dev1 (виключено параметр usercode, додано параметр customer_id)''

''Доопрацьовано у: 3.16dev3 (параметр usercode зроблено необов'язковим)''

''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

''Доопрацьовано у: 3.14.53 (додано параметри date_add_from, date_add_to, operator_id)''

Опис: Виведення листування з абонентом
Необов'язкові параметри ''(але має бути щось одне)'':
usercode - ''(для версії 3.16 і раніше)'' ID абонента
customer_id - ''(для версії 3.17 і пізніше)'' ID абонента
date_add_from - дата повідомлення (з)
date_add_to - дата повідомлення (до)
is_answer - чи була відповідь на повідомлення ''(1 - була відповідь, 0 - відповіді не було)''
is_archive - чи є повідомлення в архіві
employee_id - id співробітника-автора повідомлення
operator_id - id оператора-автора повідомлення ''(до версії 3.16dev2)''

==== msg_add ====
''Доопрацьовано у: 3.18.40 (додано параметр is_arc)''

''Додано у: 3.13.25''
Опис: Додавання повідомлення від абонента
Обов'язкові параметри:
customer_id - id абонента
text - Текст повідомлення
Необов'язкові параметри:
is_arc - прапорець - помістити повідомлення в архів

==== msg_add_to_customer ====
''Додано у: 3.19.45''

Опис: Додавання повідомлення від співробітника до абонента
Обов'язкові параметри:
employee_id - id співробітника
customer_id - id абонента
text - Текст повідомлення
Необов'язкові параметри:
is_arc - прапорець - помістити повідомлення в архів

==== pass_change ====
''Доопрацьовано у: 3.17dev1 (виключено параметр usercode, додано параметр customer_id)''

''Доопрацьовано у: 3.15.23 (параметр pass_old став необов'язковим)''

Опис: Зміна пароля для входу в особистий кабінет
Обов'язкові параметри:
usercode - ''(для версії 3.16 і раніше)'' ID абонента
customer_id - ''(для версії 3.17 і пізніше)'' ID абонента
pass_new - новий пароль
Додаткові параметри:
pass_old - поточний пароль

==== service_add ====

''Додано у: 3.18beta1''

Опис: Додавання додаткової послуги
Обов'язкові параметри:
customer_id - id абонента
service_id - id додаткової послуги
Необов'язкові параметри:
price - індивідуальна вартість
comment - нотатки

==== service_remove ====

''Додано у: 3.18beta1''

Опис: Видалення додаткової послуги
Обов'язкові параметри:
customer_id - id абонента
service_id - id додаткової послуги

==== set_mac_by_ip ====
''Додано у: 3.12beta35''
Опис: Вказання MAC-адреси для IP-адреси абонента
Обов'язкові параметри:
ip - IP-адреса абонента (наприклад: 192.168.0.1)
mac - MAC-адреса абонента (наприклад: 00:11:22:33:44:55)

==== state_change ====
''Доопрацьовано у: 3.17dev1 (виключено параметр usercode, додано параметр customer_id)''

''Додано у: 3.12.8''

Опис: Зміна статусу роботи в абонента
Обов'язкові параметри:
usercode - ''(для версії 3.16 і раніше)'' ID абонента
customer_id - ''(для версії 3.17 і пізніше)'' ID абонента
state_id - ID статусу абонента (0 - стоп, 1 - пауза, 2 - активний)

==== tarif_change ====
''Доопрацьовано у: 3.17dev1 (виключено параметр usercode, додано параметр customer_id)''

Опис: Зміна тарифу абонента
Обов'язкові параметри:
usercode - ''(для версії 3.16 і раніше)'' ID абонента
customer_id - ''(для версії 3.17 і пізніше)'' ID абонента
tarif - ID нового тарифу

==== to_ex ====
''Доопрацьовано у: 3.17dev1 (виключено параметр usercode, додано параметр customer_id)''

''Додано у: 3.12.69''

Опис: Переведення абонента в категорію "Колишні абоненти"
Обов'язкові параметри:
usercode - ''(для версії 3.16 і раніше)'' ID абонента
customer_id - ''(для версії 3.17 і пізніше)'' ID абонента

==== to_normal ====
''Доопрацьовано у: 3.17dev1 (виключено параметр usercode, додано параметр customer_id)''

''Додано у: 3.12.90''

Опис: Переведення абонента у звичайний статус (з "Колишніх абонентів")
Обов'язкові параметри:
usercode - ''(для версії 3.16 і раніше)'' ID абонента
customer_id - ''(для версії 3.17 і пізніше)'' ID абонента

API attach EN

2026-07-06T13:58:52Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[API_attach_UK|uk]] | [[API attach|ru]]

Section '''[[API_EN|API]]''' ERP "UserSide"

Purpose: Attached file management

Optional parameters:
action - request subcategory ''(possible value: see below)''

== Subcategories ==

==== add ====
''Modified in: 3.21.0-beta.3 (removed src, name, comment, and src_id parameters)''

''Modified in: 3.19.48 (added uuid parameter)''

''Modified in: 3.16.19 (added name and comment parameters)''

''Modified in: 3.16dev4 (added possible cable_line value to object_type parameter)''

''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Modified in: 3.15.42 (added possible value of inventory to object_type parameter)''

''Modified in: 3.14.21 (added possible value customer to object_type parameter)''

Description: Add a file to an object
Required parameters:
object_type - object type [cable_line|customer|node|task|task_comment|inventory]
object_id - id of the object to which to attach the file
comment_id - id of the task comment to which to attach the file ''(for task_comment type)''
uuid - UUID of another already uploaded file that should be attached to another object
Optional parameters:
employee_id - id of the employee on whose behalf to attach the file
name - file name ''(arbitrary text)'' ''(before version 3.21)''
comment - file notes/description ''(before version 3.21)''
src_id - id of file upload method/type ''(arbitrary, at the client's discretion)'' ''(before version 3.21)''

==== delete ====
''Modified in: 3.19beta1 (removed id parameter, added uuid parameter)''

''Added in: 3.12beta25''
Description: Delete a file
Required parameters:
id - id of file ''(version up to 3.19)''
uuid - uuid of file ''(version 3.19+)''
name - file name ''(no paths)''

==== get ====
''Modified in: 3.20.23 (added possible additional_field value to object_type parameter)''

''Modified in: 3.19beta1 (removed id parameter, added uuid parameter)''

''Modified in: 3.16dev4 (added possible cable_line value to object_type)''

''Modified in: 3.15.42 (added possible value of inventory to object_type parameter)''

''Modified in: 3.15.12 (added object_type and object_id parameters)''

''Modified in: 3.14.41 (added ext_name and int_name parameters)''

''Added in: 3.14.36''
Description: Retrieve information
Required parameters ''(one of the following)'':
uuid - uuid of file ''(comma separated)'' ''(version 3.19+)''
id - file id ''(comma separated)'' ''(versions prior to 3.19)''
ext_name - external file name ''(original)''
int_name - internal file name ''(as stored in the system)''
object_type - object type [additional_field|cable_line|customer|inventory|node|task|task_comment] ''(used together with object_id)''
object_id - id of the object to which the file is attached ''(used together with object_type)''

==== get_file ====
''Modified in: 3.19beta1 (removed id parameter, added uuid parameter)''

''Added in: 3.14.57''
Description: Output file contents ''(in binary form)''
Required parameters:
uuid - uuid of file ''(version 3.19+)''
id - file id ''(versions prior to 3.19)''

==== get_file_temporary_link ====
''Modified in: 3.19beta1 (removed id parameter, added uuid parameter)''

''Added in: 3.17dev1''
Description: Provide a direct temporary link to download the file
Required parameters:
uuid - uuid of file ''(version 3.19+)''
id - file id ''(versions prior to 3.19)''

==== upload ====

''Modified in: 3.21.4 (added additional_field_id parameter)''

''Added in: 3.21.0-beta.3''

Description: Upload (add) a file to an object.

content-type=multipart/form-data

Required parameters:
object_type - object type [cable_line|customer|node|task|task_comment|inventory]
object_id - id of the object to which to attach the file
comment_id - id of the task comment to which to attach the file ''(for object_type=task_comment)''
file - file
Optional parameters:
additional_field_id - id of the custom field ''(if the file should be attached to an object custom field. The custom field type must be "File")''
employee_id - id of the employee on whose behalf to add the file
name - file name ''(arbitrary text)''
comment - file notes/description
src_id - id of file upload method/type ''(arbitrary, at the client's discretion)''

Версії 3.20

2026-06-28T14:02:18Z

IronBot: [IronBot] Sync UK localization from RU

[[Versions 3.20 EN|en]] | '''uk''' | [[Версии_3.20|ru]]

Версії гілки [[3.20_UK|3.20]]

Також див.: [[Версії ERP "USERSIDE"]]

== 3.20.25 - 24.06.2026 ==
* Доопрацьовано відображення запланованих кабельних ліній на мапі покриття відповідно до налаштувань кольору за щільністю кабелю
* Виправлено помилку з відображенням списку кабельних ліній ''(у деяких випадках)''
* Виправлення невеликих помилок та змін

== 3.20.24 - 27.05.2026 ==
* Виправлення невеликих помилок та змін

== 3.20.23 - 27.04.2026 ==
* Додано метод API->call->[[API_call_UK#agent_call|agent_call]]
* Додано метод API->chapter->[[API_chapter_UK#link_add|link_add]]
* Додано метод API->chapter->[[API_chapter_UK#link_get|link_get]]
* Додано метод API->chapter->[[API_chapter_UK#link_remove|link_remove]]
* Доопрацьовано метод API->call->[[API_call_UK#add|add]]
* Доопрацьовано метод API->task->[[API_task_UK#edit|edit]]
* У виконаних завданнях також відображається ознака "Прострочено" під час порушенні термінів робіт
* Виправлена помилка з входом у календар робіт ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.20.22 - 04.04.2026 ==
* Виправлено вибір порожнього значення в типі завдань для реєстрації телефоном
* Оптимізаційні роботи
* Виправлення невеликих помилок

== 3.20.21 - 11.03.2026 ==
* Виправлено відображення лічильника помилок на інтерфейсах пристроїв ''(у деяких випадках)''
* Виправлено налаштування шаблонів SMS-повідомлень для абонентів у завданнях
* Оптимізаційні роботи
* Виправлення невеликих помилок

== 3.20.20 - 22.02.2026 ==
* Оптимізована робота розділу "Мої завдання"
* Виправлено порушення розмітки головного меню в деяких випадках

== 3.20.19 - 08.02.2026 ==
* Виправлення невеликих помилок

== 3.20.18 - 23.01.2026 ==
* Оптимізація звіту за складу "Оборотно-сальдова відомість"
* Виправлення невеликих помилок

== 3.20.17 - 31.12.2025 ==
* Додано метод API->task->[[API_task_UK#add_node_to_task|add_node_to_task]]
* Додано метод API->task->[[API_task_UK#remove_node_from_task|remove_node_from_task]]
* Виправлено виконання ланцюжка завдань ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.20.16 - 14.12.2025 ==
* Виправлена помилка з фільтрацією за секції ТМЦ у списку операцій за складу
* Виправлення невеликих помилок

== 3.20.15 - 06.12.2025 ==
* Для ланцюжків завдань/автоматизації в типах завдань додано можливість вказівки дробового інтервалу годинника
* Виправлення невеликих помилок

== 3.20.14 - 29.11.2025 ==
* Доопрацювання API взаємозв'язку з Binotel
* Виправлення невеликих помилок

== 3.20.13 - 22.11.2025 ==
* Виправлення невеликих помилок

== 3.20.12 - 15.11.2025 ==
* Додано параметр налаштування "Масштабувати ширину кабельної лінії на схемі комутації в залежності від довжини назви"
* Допрацьовано відображення невідомих ONU за OLT у віджеті головної сторінки
* Виправлення інших невеликих помилок

== 3.20.11 - 08.11.2025 ==
* Виправлення помилки під час вході в розділ Custom-повідомлень ''(у деяких випадках)''
* Виправлення помилки під час вході в налаштування інтерфейсів/стекування за пристрої ''(у деяких випадках)''
* Виправлена неможливість комутації між ODF/кросами у майстрі комутацій
* Виправлення деяких помилок міграції

== 3.20.10 - 07.11.2025 ==
* Додано метод API->vehicle->[[API_vehicle_UK#add|add]]
* Додано метод API->vehicle->[[API_vehicle_UK#edit|edit]]
* Додано метод API->vehicle->[[API_vehicle_UK#delete|delete]]
* У картці спорудження зв'язку в блоці з прикріпленими файлами-зображеннями можна швидко зробити зображення основним фото для цього об'єкта ''(без необхідності переходити до редагування)''
* У картці кабельної лінії додано можливість створити завдання з цією лінією або додати лінію до існуючого завдання
* Доопрацьовано сортування за додатковими полями у власних розділах
* Виправлена фільтрація за найменуванням ТМЦ у списку ТМЦ
* Виправлено відображення шарів обладнання на карті покриття
* Виправлення інших невеликих помилок

== 3.20.9 - 14.09.2025 ==
* Доопрацювання перевірки прав доступу до ONU
* Виправлена помилка під час пошуку абонента під час передачі ТМЦ ''(у деяких випадках)''
* Виправлено оновлення на базі серійних номерів для ONU під час опитуванні OLT ''(у деяких випадках)''

== 3.20.8 - 06.09.2025 ==
* Додано метод API->billing->[[API_billing_UK#refresh_date_update|refresh_date_update]]
* Оптимізовано інтерфейс редагування/додавання адресної одиниці ''(актуально для розгалужених адресних структур)''
* У картці завдання додані посилання на перегляд зв'язаних абонентів із спорудами зв'язку та з кабельними лініями
* Виправлена перевірка на статус батьківського завдання в автоматизації дій із завдань ''(у деяких випадках)''
* Виправлено відображення спливаючої підказки в календарі завдань під час горизонтальному скролі
* Виправлено призначення співробітників у підрозділ ''(у деяких випадках)''

== 3.20.7 - 25.08.2025 ==
* '''Глибока переробка операцій із транспорту. Різні типи, контроль пробігу, терміни. Повідомлення на головну сторінку та список транспорту. Ведення історії змін в операціях '''
* Історія дій щодо потенційного абонента переноситься в історію дій звичайного абонента під час їх об'єднанні
* При гарячій заміні пристрою можна вказати збереження історії MAC-адрес на портах обладнання
* У групових діях за списком абонентів додано можливість очищення комутації
* Технічні міграції даних ядра
* Виправлена фільтрація FDB-таблиці з пристрою ''(у деяких випадках)''
* Виправлена помилка під час обмеженні співробітнику доступу за конкретною IP-адресою
* Виправлено перевірку прав на доступ до ONU

== 3.20.6 - 15.08.2025 ==
* ''' Окремі SMS-профілі для роботи. Наприклад, для кожної SMS-розсилки можна вказати окремий SMS-профіль ''(власне альфа-ім'я, інший оператор...)'''''
* Виділено окремі права доступу до ONU на перегляд та зміну
* Виправлено відображення великої кількості розділів блокнота у списку розділів
* Виправлено оновлення інформації під час додавання/виключенні споруди зв'язку в завданні

== 3.20.5 - 08.08.2025 ==
* Додано метод API->address->[[API_address_UK#get_building_type|get_building_type]]
* Додано параметр налаштування "Будівлі. Шаблон спливаючого повідомлення на карті"
* Доопрацьовано інтерфейс зміни нотатки, типу адаптера та з'єднання для волокна кабельної лінії
* Перероблено інтерфейс додавання споруд зв'язку та кабельних ліній у завдання під час створення завдання
* Підкориговано перевірку прав доступу до табеля робіт
* Доопрацьовано тарифікацію співробітникам за завдання у відомості робіт за участю в завданні понад 5 співробітників
* Виправлена помилка фільтрації за будівлі у списку операцій за складом ''(у деяких випадках)''

== 3.20.4 - 04.08.2025 ==
* Додано метод API->cross->[[API_cross_UK#edit_adapter|edit_adapter]]
* Доопрацьовано метод API->task->[[API_address_UK#edit_address|edit_address]]
* Додано параметр налаштування "Заблокувати виконання автоматизації/ланцюжка завдань під час поверненні завдання зі статусу із системною роллю "Відкладено"
* У списку завдань додано угруповання завдань за вулиці або населеному пункту
* Доопрацювання збереження прикріплених файлів до коментарів за завданням
* Невеликі виправлення та доопрацювання

== 3.20.3 - 27.07.2025 ==
* Доопрацьовано метод API->task->[[API_task_UK#change_state|change_state]]
* Додано параметр налаштування "З'єднання на дільниках вважати механічними"
* У налаштуваннях типів завдань для ТМЦ можна вказати, що переміщати всі ТМЦ після закриття на зв'язану будівлю
* У ланцюжках/автоматизації за типами завдань додано можливість додаткової умови "Статус дочірнього/батьківського завдання" для варіантів дій "Батьківське/Дочірнє завдання. Змінити статус на"
* У картці будівлі у списку ТМЦ додано інформацію про дату встановлення ТМЦ на будівлі та можливість експорту в XLS та у версію для друку
* У картці можна скопіювати всі прикріплені файли з іншого завдання
* У картці абонента додано пряме посилання на перегляд його маршруту комутації
* Для профілів співробітників можна обмежити максимальну кількість записів на сторінці ''(у таблицях/списках)''
* У фільтр зі споруд зв'язку додано можливість вибірки за відсутнім власним значком на карті
* У списку операцій за складу в селекторах вибору контрагента додано можливість вказівки конкретної будівлі
* У групових діях за будівлях додано можливість зміни індивідуального кольору на карті
* У групових діях за будинках можна змінити менеджера на порожнє значення ''(видалити менеджера)''
* Виправлено сортування за адресою у списку завдань ''(у деяких випадках)''
* Виправлена можливість одночасно відкласти завдання та вказати довільний коментар

== 3.20.2 - 18.07.2025 ==
* Додано метод API->task->[[API_task_UK#add_cable_line_to_task|add_cable_line_to_task]]
* Додано метод API->task->[[API_task_UK#remove_cable_line_from_task|remove_cable_line_from_task]]
* Список підключених ONU на OLT можна виводити на друк або експортувати до XLS
* Для споруд зв'язку та кабельних ліній додано можливість у групових діях змінювати нотатки
* У шаблоні спливаючої підказки на завдання на карті покриття можна відображати дату створення завдання, дату оновлення, текст останнього коментаря
* У ланцюжках/автоматизації за типами завдань додано дію "Абоненти. Виключити"
* Для ланцюжків/автоматизації в типах завдань додана можливість відключати автопризначуваних виконавців під час створення нового завдання за ланцюжку
* Доопрацьовано відображення посилань в описі типу завдань у картці завдання
* Виправлена фільтрація абонентів, що залежать від кросу/odf ''(у деяких випадках)''

== 3.20.1 - 12.07.2025 ==
* У списку будівель доданий фільтр за будівлях, у яких знято позначку "Відображати на карті"
* Виправлена неможливість відкрити картку автотранспорту зі списку
* Виправлено пошук за найменуванням кабельної лінії під час створення завдання ''(у деяких випадках)''
* Виправлення відображення інформації про абонента у списку завдань ''(у деяких випадках)''

== 3.20 - 09.07.2025 ==
* Реліз версії 3.20
* Список змін див. [[3.20_UK|3.20]]

Versions 3.21 EN

2026-06-28T14:02:18Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[Версії_3.21|uk]] | [[Версии_3.21|ru]]

Versions of the [[3.21_EN|3.21]] branch

Also see: [[Versions_of_ERP_"USERSIDE"|ERP "USERSIDE" versions]]

== 3.21.4 (in development)
* Task news can now partially mark events as read and group news by task
* Task automation can now send Email messages to customers ''(using configurable templates)''

== 3.21.3 - 28.06.2026 ==
* Improved API method API->inventory->[[API_inventory_EN#transfer_inventory|transfer_inventory]]
* Improved API method API->commutation->[[API_commutation_EN#delete|commutation]]
* Improved API method API->node->[[API_node_EN#get|get]]
* Improved API method API->address->[[API_address_EN#get_house|get_house]]
* The scheduler task "Send low-stock information" can now specify the delivery options "E-mail/Messenger"; the employee card also now lets you specify delivery options for this mailing in the "Notifications" section
* The inventory list in the task card can now transfer all inventory items to the selected recipient at once
* Quick value search was added to custom fields of the "List selection" type
* Improved the use of explicitly specified coordinates when editing a building card and selecting a polygon/point
* Fixed creating cable lines to a building from the coverage map
* Fixed an error when opening Settings - Modules ''(in some cases)''
* Fixed grouping in the task list ''(in some cases)''
* Fixed deleting a label from the switching scheme
* Fixed the "Show dismissed employees in selectors/search for N days after dismissal" parameter
* Fixed warehouse availability checks when selecting inventory items during task execution
* Fixed the "Show tasks by actual completion date" variable
* Fixed using task-type appearance color settings in the calendar
* Fixed coverage-map search ''(substituting the current locality in the search window)''
* Fixed navigation from a customer card to the map with the customer's building coordinates
* Fixed saving interfaces/stacking in the device card

== 3.21.2 - 26.06.2026 ==
* Improved API method API->address->[[API_address_EN#get_house|get_house]]
* When transferring inventory from a customer card, the sub-account receiving the inventory can now be selected
* When creating/editing a task for a building, information about building tags and the building note is shown
* When creating a task in a chain, a specific custom assignee/department can be specified separately
* Bulk inventory transfer now creates combined transfer operations instead of separate operations for each item
* The task list filter-result grouping now has a "Completion date (month)" option
* Fixed an error when creating a task ''(in some cases)''
* Fixed changing coordinates in building, communications installation, and customer cards ''(in some cases)''
* Fixed generation of communications-installation names when selecting a building floor ''(in some cases)''
* Fixed link handling in text values of custom fields
* Fixed assigning assignees when creating a task ''(in some cases)''

== 3.21.1 - 25.06.2026 ==
* Improved map centering when editing a polygon/building on the coverage map
* Fixed displaying global switching schemes ''(in some cases)''
* Fixed exporting the cable line list to XLS ''(in some cases)''
* Fixed correct rendering of customers on the building logical scheme ''(in some cases)''
* Fixed selecting parent objects when adding a building from the coverage map
* Fixed attaching a customer when adding a new task for a customer
* Fixed minor bugs

== 3.21.0 - 23.06.2026 ==
* Version release

== 3.21.0-beta.7 - 21.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.6 - 20.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.5 - 17.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.4 - 13.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.3 - 07.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.2 - 30.05.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.1 - 24.05.2026 ==
* See the list of changes in [[3.21_EN|3.21]]

Версії 3.21

2026-06-28T14:02:18Z

IronBot: [IronBot] Sync UK localization from RU

[[Versions_3.21_EN|en]] | '''uk''' | [[Версии_3.21|ru]]

Версії гілки [[3.21_UK|3.21]]

Див. також: [[Версії_ERP_"USERSIDE"|Версії ERP "USERSIDE"]]

== 3.21.4 (у розробці)
* У новинах за завданнями додано можливість частково позначати події як прочитані, а також групувати новини за завданнями
* В автоматизації за завданнями додано можливість надсилати Email клієнтам ''(за налаштованими шаблонами)''

== 3.21.3 - 28.06.2026 ==
* Доопрацьовано метод API->inventory->[[API_inventory_UK#transfer_inventory|transfer_inventory]]
* Доопрацьовано метод API->commutation->[[API_commutation_UK#delete|commutation]]
* Доопрацьовано метод API->node->[[API_node_UK#get|get]]
* Доопрацьовано метод API->address->[[API_address_UK#get_house|get_house]]
* Для завдання планувальника "Розсилання інформації про зниження резервів на складі" додано можливість указувати варіанти надсилання "E-mail/Messenger", а також у картці співробітника в розділі "Сповіщення" можна вказати варіанти отримання цієї розсилки
* У списку ТМЦ у картці завдання додано можливість одразу передавати всі ТМЦ вибраному отримувачу
* У додаткових полях із типом "Вибір зі списку" додано швидкий пошук значення
* Доопрацьовано використання явно вказаних координат під час редагування картки будівлі та вибору полігона/точки
* Виправлено створення кабельних ліній до будівлі з мапи покриття
* Виправлено помилку під час переходу до розділу Налаштування - Модулі ''(у деяких випадках)''
* Виправлено групування у списку завдань ''(у деяких випадках)''
* Виправлено видалення напису зі схеми комутації
* Виправлено роботу параметра "Відображати у селекторах/пошуку звільнених співробітників протягом N днів після їх звільнення"
* Виправлено перевірку доступності складів під час вибору ТМЦ при виконанні завдання
* Виправлено роботу змінної "Виводити завдання за датою фактичного виконання"
* Виправлено використання колірних налаштувань зовнішнього вигляду типів завдань у календарі
* Виправлено пошук на мапі покриття ''(підставляння поточного населеного пункту у вікні пошуку)''
* Виправлено перехід із картки клієнта на мапу з координатами будівлі клієнта
* Виправлено збереження інтерфейсів/стекування в картці пристрою

== 3.21.2 - 26.06.2026 ==
* Доопрацьовано метод API->address->[[API_address_UK#get_house|get_house]]
* Під час передавання ТМЦ із картки клієнта можна вибрати субрахунок, на який передаємо
* Під час створення/зміни завдання для будівлі виводиться інформація про мітки на будівлі та примітку до будівлі
* Під час створення завдання за ланцюжком можна окремо вказати потрібного довільного виконавця/підрозділ
* У масовому передаванні ТМЦ тепер створюються об'єднані операції передавання, а не кожна окремо
* У списку завдань у групуванні результатів фільтрації додано варіант "Дата виконання (місяць)"
* Виправлено помилку під час створення завдання ''(у деяких випадках)''
* Виправлено зміну координат у картці будівлі, споруди зв'язку, клієнта ''(у деяких випадках)''
* Виправлено формування назви споруди зв'язку під час вибору поверху будівлі ''(у деяких випадках)''
* Виправлено обробку посилань у текстових значеннях додаткових полів
* Виправлено призначення виконавців під час створення завдання ''(у деяких випадках)''

== 3.21.1 - 25.06.2026 ==
* Доопрацьовано центрування мапи під час редагування полігона/будівлі на мапі покриття
* Виправлено відображення глобальних схем комутації ''(у деяких випадках)''
* Виправлено експорт у XLS списку кабельних ліній ''(у деяких випадках)''
* Виправлено коректне відображення клієнтів на логічній схемі будівлі ''(у деяких випадках)''
* Виправлено вибір батьківських об'єктів під час додавання будівлі з мапи покриття
* Виправлено прикріплення клієнта під час додавання нового завдання для клієнта
* Виправлення невеликих помилок

== 3.21.0 - 23.06.2026 ==
* Реліз версії

== 3.21.0-beta.7 - 21.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.6 - 20.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.5 - 17.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.4 - 13.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.3 - 07.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.2 - 30.05.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.1 - 24.05.2026 ==
* Перелік змін див. у [[3.21_UK|3.21]]

Versions 3.20 EN

2026-06-28T14:02:07Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[Версії_3.20|uk]] | [[Версии_3.20|ru]]

Branch versions [[3.20_EN|3.20]]

Also see: [[Versions of ERP "USERSIDE"]]

== 3.20.25 - 24.06.2026 ==
* Improved the display of planned cable lines on the coverage map according to cable-density color settings
* Fixed a bug with displaying the cable line list ''(in some cases)''
* Fixed minor bugs and changes

== 3.20.24 - 27.05.2026 ==
* Fixed minor bugs and changes

== 3.20.23 - 27.04.2026 ==
* Added API method->call->[[API_call_EN#agent_call|agent_call]]
* Added API method->chapter->[[API_chapter_EN#link_add|link_add]]
* Added API method->chapter->[[API_chapter_EN#link_get|link_get]]
* Added API method->chapter->[[API_chapter_EN#link_remove|link_remove]]
* Improved API method->call->[[API_call_EN#add|add]]
* Improved API method->task->[[API_task_EN#edit|edit]]
* Completed tasks now also show the "Overdue" flag when work deadlines are missed
* Fixed a bug when opening the work calendar ''(in some cases)''
* Fixed minor bugs

== 3.20.22 - 04.04.2026 ==
* Fixed selecting an empty value in the task type for registration by phone
* Optimization work
* Fixed minor bugs

== 3.20.21 - 11.03.2026 ==
* Fixed display of the error counter on equipment interfaces ''(in some cases)''
* Fixed SMS message template settings for customers in tasks
* Optimization work
* Fixed minor bugs

== 3.20.20 - 22.02.2026 ==
* Optimized the "My tasks" section
* Fixed broken main menu layout in some cases

== 3.20.19 - 08.02.2026 ==
* Fixed minor bugs

== 3.20.18 - 23.01.2026 ==
* Optimized the warehouse report "Turnover balance sheet"
* Fixed minor bugs

== 3.20.17 - 31.12.2025 ==
* Added API method->task->[[API task#add_node_to_task|add_node_to_task]]
* Added API method->task->[[API task#remove_node_from_task|remove_node_from_task]]
* Fixed execution of task chain ''(in some cases)''
* Fixed minor bugs

== 3.20.16 - 14.12.2025 ==
* Fixed a bug with filtering by inventory section in the warehouse operations list
* Fixed minor bugs

== 3.20.15 - 06.12.2025 ==
* For task chains/automation in task types, added the ability to specify fractional hour intervals
* Fixed minor bugs

== 3.20.14 - 29.11.2025 ==
* Improvements to the API interface with Binotel
* Fixed minor bugs

== 3.20.13 - 22.11.2025 ==
* Fixed minor bugs

== 3.20.12 - 15.11.2025 ==
* Added the setting "Scale the width of the cable line on the switching diagram depending on the length of the name"
* Improved the display of unknown ONUs by OLT in the main page widget
* Fixed other minor bugs

== 3.20.11 - 08.11.2025 ==
* Fixed an error when entering the Custom notifications section ''(in some cases)''
* Fixed an error when entering the device interface/stacking settings ''(in some cases)''
* Fixed the inability to switch between ODF/crosses in the switching master
* Fixed some migration errors

== 3.20.10 - 07.11.2025 ==
* Added API method->vehicle->[[API vehicle#add|add]]
* Added API method->vehicle->[[API vehicle#edit|edit]]
* Added API method->vehicle->[[API vehicle#delete|delete]]
* In the communication installations card, in the block with attached image files, it is possible to quickly make an image the main photo for this object ''(without having to go to editing)''
* In the cable line card, the ability to create a task with this line or add a line to an existing task has been added
* Sorting by additional fields in custom sections has been improved
* Filtering by inventory item name in the inventory list has been fixed
* The display of equipment layers on the coverage map has been fixed
* Other minor bugs have been fixed

== 3.20.9 - 14.09.2025 ==
* Improved verification of access rights to ONU
* Fixed a bug when searching for a user during the transfer of inventory items ''(in some cases)''
* Fixed an update in the serial number database for ONU when polling OLT ''(in some cases)''

== 3.20.8 - 06.09.2025 ==
* Added API method->billing->[[API billing#refresh_date_update|refresh_date_update]]
* Optimised interface for editing/adding address units ''(relevant for branched address structures)''
* Links to view users associated with communication installations and cable lines have been added to the task card
* Fixed checking for parent task status in task automation ''(in some cases)''
* Fixed display of pop-up hints in the task calendar when scrolling horizontally
* Fixed assignment of employees to a department ''(in some cases)''

== 3.20.7 - 25.08.2025 ==
* '''In-depth processing of transport operations. Various types, mileage control, deadlines. Notification on the main page and transport list. Keeping a history of changes in operations'''
* The history of actions for a potential user is transferred to the history of actions for a regular user when they are merged
* During hot replacement of a device, you can specify to save the history of MAC addresses on equipment ports
* The ability to clear switching has been added to group actions on the user list
* Technical migration of core data
* Fixed filtering of the FDB table by device ''(in some cases)''
* Fixed a bug when restricting an employee's access to a specific IP address
* Fixed ONU access rights verification

== 3.20.6 - 15.08.2025 ==
* ''' Separate SMS profiles for work. For example, you can specify a separate SMS profile for each SMS mailing ''(your own alpha name, different operator, etc.)'''''
* Separated ONU access rights for viewing and editing
* Fixed display of a large number of notebook sections in the section list
* Fixed information update when adding/removing a communication facility in a task

== 3.20.5 - 08.08.2025 ==
* Added API method->address->[[API address#get_building_type|get_building_type]]
* Added the "Buildings. Pop-up message template on the map" setting
* Improved the interface for changing notes, adapter types, and connections for fibre cable lines
* Redesigned the interface for adding communication structures and cable lines to a task when creating a task
* Corrected the verification of access rights to the work schedule
* Improved the billing of employees for tasks in the work schedule when more than 5 employees are involved in the task
* Fixed a bug in filtering by building in the list of warehouse operations ''(in some cases)''

== 3.20.4 - 04.08.2025 ==
* Added API method->cross->[[API cross#edit_adapter|edit_adapter]]
* Added API method->task->[[API address#edit_address|edit_address]]
* Added a setting parameter "Block automation/task chain execution when returning a task from the status with the system role 'Pending' "
* Added grouping of tasks by street or location to the task list
* Improved saving of files attached to task comments
* Minor fixes and improvements

== 3.20.3 - 27.07.2025 ==
* Added API method->task->[[API task#change_state|change_state]]
* The "Consider connections on dividers as mechanical" configuration parameter has been added
* In the task type settings for inventory items, you can specify that all inventory items should be moved to the associated building after closing
* In chains/automation by task type, the additional condition "Child/parent task status" has been added for the action options "Parent/Child task. Change status to"
* Information about the date of installation of inventory items on the building and the ability to export to XLS and printable versions has been added to the building card in the inventory list
* All attached files from another task can be copied to the card
* A direct link to view the customer's switching route has been added to the customer card
* For employee profiles, you can limit the maximum number of entries on the page (in tables/lists)
* The filter for communication facilities now includes the option to select by missing custom icon on the map
* In the list of warehouse operations in the counterparty selection selectors, the ability to specify a specific building has been added
* In group actions for buildings, the ability to change the individual colour on the map has been added
* In group actions for buildings, you can change the manager to the empty value ''(delete manager)''
* Fixed sorting by address in the task list ''(in some cases)''
* Fixed the ability to simultaneously postpone a task and specify an arbitrary comment

== 3.20.2 - 18.07.2025 ==
* Added API method->task->[[API task#add_cable_line_to_task|add_cable_line_to_task]]
* Added API method->task->[[API task#remove_cable_line_from_task|remove_cable_line_from_task]]
* The list of connected ONUs on the OLT can be printed or exported to XLS
* For communication installations and cable lines the possibility to change notes in group actions has been added
* In the template of the tooltip on the task on the coverage map it is possible to display the date of task creation, update date, text of the last comment
* In chains/automation by task type, added action "Customers. Exclude."
* In chains/automation by task types, added possibility to disable auto-assigned executors when creating a new task in a chain
* Improved displaying of links in the description of a task type in the task card
* Fixed filtering of customers that depend on cross/odf ''(in some cases)''

== 3.20.1 - 12.07.2025 ==
* In the list of buildings, added filter for buildings with "Display on map" unchecked
* Fixed inability to open a vehicle card from the list
* Fixed search by cable line name when task is created ''(in some cases)''
* Fixed display of customer information in the task list ''(in some cases)''

== 3.20 - 09.07.2025 ==
* Release version 3.20
* For a list of changes see [[3.20_EN|3.20]]

Установка

2026-06-23T12:46:47Z

IronBot: [IronBot] Repair localization links

<languages/>
[[Installation|en]] | [[Встановлення|uk]] | '''ru'''

'''ВНИМАНИЕ: Данная инструкция актуальна для версий ERP USERSIDE 3.19+'''
* [[Установка для версии 3.18|Инструкция для версии 3.18]]
* [[Установка для версии 3.17|Инструкция для версии 3.11-3.17]]
* [[Установка для версии 3.10 и более ранних|Инструкция для версии 3.10 и ранее]].

== Описание ==
В целях упрощения будут рассмотрены команды для операционной системы '''Linux Debian 13 (trixie)'''. Для опытных системных администраторов не составит труда использовать аналогичные команды для другой операционной системы. Если же вы не чувствуете себя уверено в администрировании операционных систем, то мы рекомендуем вам использовать операционную систему '''Debian''' либо '''Ubuntu Server LTS'''. Из-за их простоты, а также по причине того, что наша техническая поддержка значительно лучше разбирается в Debian-подобных дистрибутивах. Вероятность подсказать что-либо не касающееся ERP USERSIDE, но касающееся администрирования операционной системы, будет значительно выше, если у вас будет Debian или подобный дистрибутив на его основе.

С другой стороны, если вы опытный системный администратор и имеете навыки и опыт работы с Docker, возможно для вас будет более удобным вариант использования готового окружения на базе Docker-образов, которые мы подготовили специально, включив в них всё необходимое для работы ERP USERSIDE. В этом случае вам не придется ничего настраивать, кроме как выполнить простые настройки Docker-бандла https://github.com/userside/userside-docker.

== Требования ==
Для работы ERP USERSIDE необходимы различные системные приложения и службы, такие как интерпретатор языка PHP с набором расширений, WEB-сервер, система управления базами данных и прочие. В этом разделе будут перечислены такие требования в зависимости от версии ERP USERSIDE.

Также обратите внимание, что ваша операционная система должна быть сконфигурирована с корректным часовым поясом и локалью. От этого зависит правильность отображения информации и корректность сортировки.

Список требуемых расширений PHP содержит все расширения, не входящие в состав ядра PHP. Часть из этих расширений может поставляться вместе с основным пакетом PHP либо в составе пакета php-common, другая же часть должна быть установлена дополнительно.

=== 3.20 ===
* PHP 8.4-8.5
* Расширения PHP: ctype, gd, json, libxml, mbstring, openssl, pdo, pdo_pgsql, posix, simplexml, snmp, sockets, zlib, pcntl
* Дополнительные расширения PHP: ldap
* Python: ''Необходим Python3 любой поддерживаемой на данный момент версии. Статус версий можно посмотреть здесь: "[https://devguide.python.org/versions/ Status of Python versions]". Рекомендуется использовать версию с состоянием "security" или "bugfix". Версии отмеченные как "end-of-life" не поддерживаются. Отмеченные как "feature" не рекомендуется использовать.''
* Модули Python: pip, venv
* PostgreSQL: 16+ (желательно 18)
* Redis: 5+ (желательно 7)
* RabbitMQ: 3.13+ (желательно 4+)
* Supervisor

=== 3.19 (текущая стабильная) ===
* PHP: 8.3-8.4
* Расширения PHP: ctype, gd, json, libxml, mbstring, openssl, pdo, pdo_pgsql, posix, simplexml, snmp, sockets, zlib, pcntl
* Дополнительные расширения PHP: ldap, soap
* Python: ''Необходим Python3 любой поддерживаемой на данный момент версии. Статус версий можно посмотреть здесь: "[https://devguide.python.org/versions/ Status of Python versions]". Рекомендуется использовать версию с состоянием "security" или "bugfix". Версии отмеченные как "end-of-life" не поддерживаются. Отмеченные как "feature" не рекомендуется использовать.''
* Модули Python: pip, venv
* PostgreSQL: 12+ (желательно 16)
* Redis: 5+ (желательно 7)
* RabbitMQ: 3.10+ (желательно 3.13)
* Supervisor

== Основные договорённости ==
Каталог, в который устанавливается ERP USERSIDE - <code>/var/www/userside</code>. Внутри этого каталога должен быть подкаталог public, который является корневым каталогом для WEB-сервера. Если вы хотите использовать другой каталог для ERP USERSIDE, не забывайте вносить соответствующие исправления во все примеры из данной инструкции.

Создайте каталоги:
sudo mkdir -p /var/www/userside/public /var/log/usm_poller
sudo chown -R www-data:www-data /var/www/userside /var/log/usm_poller

Вам необходимо выделить доменное имя для ERP USERSIDE. В примерах ниже используется userside.mycompany.com, но вам необходимо будет заменить его на свое. Пропишите это доменное имя в /etc/hosts, если оно отличается от имени хоста, на котором производистя установка.

== Установка необходимых компонентов ==
Сперва установите утилиты, которые будут необходимы далее в процессе установки. Они необходимы для любой верии ERP USERSIDE. Вы можете копировать строки по одной и вставлять их в командную строку вашей операционной системы.

Следующие строки скопируйте и вставьте целиком:
<pre>
sudo tee /etc/apt/sources.list.d/contrib-non-free.list << EOL
deb http://deb.debian.org/debian/ $(lsb_release -sc) contrib non-free non-free-firmware
EOL

sudo apt update
sudo apt full-upgrade -y
sudo apt install -y gnupg ca-certificates lsb-release debian-archive-keyring debian-keyring libsnmp-dev snmp-mibs-downloader
</pre>

=== PostgreSQL ===
==== Альтернативный официальный репозиторий ====
Мы настоятельно рекомендуем использовать последнюю версию PostgreSQL, так как это всегда положительно сказывается на скорости работы. Добавьте в систему официальный репозиторий Postgres:
<pre>
sudo install -d /usr/share/postgresql-common/pgdg

sudo curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc --fail https://www.postgresql.org/media/keys/ACCC4CF8.asc

sudo sh -c 'echo "deb [signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc] https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'

sudo apt update
</pre>
Если у вас другая операционная система, вы можете найти необходимые команды для нее на [https://www.postgresql.org/download/ официальном сайте PostgreSQL].

==== Установка ====
'''Внимание!''' Перед установкой PostgreSQL в вашей операционной системе должна быть установлена ваша местная локаль и корректный часовой пояс! Это можно сделать и позже, но будет намного проще, если это будет сделано до установки PostgreSQL. Выполните следующую команду, чтобы убедиться, что нужная локаль присутствует:
locale -a

Если среди перечисленных нет вашей местной локали, то установите ее. Для этого достаточно отредактировать файл /etc/locale.gen убрав комментарии перед строкой (строками) с нужной локалью, а затем выполнить команду:
sudo locale-gen

Если вам нужно изменить локаль по умолчанию, то выполните:
sudo dpkg-reconfigure locales

Чтобы изменить часовой пояс, выполните:
sudo timedatectl set-timezone Europe/Kyiv

Теперь можно перейти к установке PostgreSQL:
sudo apt install -y postgresql-18 postgresql-18-postgis-3

==== Настройка ====
Создайте пользователя и базу данных для ERP USERSIDE. В примере ниже создается пользователь с именем userside и база данных с таким же именем. Если ваша локаль не uk_UA, не забудьте изменить команду. Затем к базе данных подключается расширение PostGis, необходимое для работы с географическими данными. После выполнения первой строки, вам необходимо будет дважды ввести пароль для нового пользователя - запишите этот пароль, он понадобится вам далее для установки ERP USERSIDE
<pre>
sudo -u postgres createuser userside -P
sudo -u postgres createdb -e -E "UTF-8" -l "uk_UA.UTF-8" -O userside -T template0 userside
sudo -u postgres psql -d userside -c "CREATE EXTENSION postgis"
</pre>

Если ваш PostgreSQL установлен '''на другом сервере''', то вам необходимо будет внести коррекции в файлы postgresql.conf и pg_hba.conf, расположенные в каталоге /etc/postgresql/16/main/. В файле postgresql.conf необходимо раскомментировать и изменить значение параметра <code>listen_addresses</code>, указав там все IP-адреса интерфейсов сервера, на которых он может принимать подключения к PostgreSQL. В файле pg_hba.conf необходимо в самом конце добавить строку по аналогии с предыдущими, указывающую, с какого адреса может подключаться пользователь ERP USERSIDE. Но если ваш PostgreSQL расположен на том же сервере, что и USERSIDE - нет необходимости вносить какие либо корректировки в эти файлы.

=== Redis ===
Стандартный репозиторий Debian 13 включает версию Redis 8.0.2. Эта версия подходит для работы ERP USERSIDE.

==== Установка ====
sudo apt install -y redis-server

==== Настройка ====
По умолчанию Redis принимает подключения без пароля, но мы настоятельно рекомендуем установить пароль. Так как пароль передается в открытом виде (Redis не предусматривает шифрования, т.к. делает упор на скорость обработки запросов и лишние этапы вроде шифрования не применяются), вам нужно создать действительно длинный и сложный пароль, например, используя утилиту '''openssl''' следующим образом:

openssl rand --hex 32

На выходе вы получите случайный набор из 32 байт в 16-ричном виде, который и будете использовать в качестве пароля. Далее нужно будет вместо слова '''MYPASSWORDHERE''' подставить эту сгенерированную строку. Запишите его. Далее в настройках вы будете указывать эту строку как пароль Redis.

Укажите полученный хэш парольной фразы в конфигурационном файле Redis:

sudo sed -i 's@^.*requirepass .*@requirepass MYPASSWORDHERE@g' /etc/redis/redis.conf

где вместо '''MYPASSWORDHERE''' укажите хэш парольной фразы поулченый ранее.

Также необходимо отключить таймаут (на некоторых версиях Redis он включен):

sudo sed -i 's@^timeout .*@timeout 0@' /etc/redis/redis.conf

Перезапустите Redis и убедитесь, что он работает (в ответ должны получить PONG):
<pre>
sudo systemctl restart redis
redis-cli -h 127.0.0.1 -p 6379 -a MYPASSWORDHERE ping
</pre>

=== RabbitMQ ===
Стандартный репозиторий Debian 13 включает старую версию RabbitMQ 4.0.5. Вы можете использовать ее — она поддерживается. Однако, эта версия относительно старая и лучшим вариантом будет установить новую версию из альтернативных репозиториев. На [https://www.rabbitmq.com/install-debian.html официальном сайте RabbitMQ] находится достаточно подробная информация по установке RabbitMQ для каждой операционной системы.

==== Добавление альтернативных репозиториев ====
Следующий блок скопируйте и вставьте целиком в командную строку
<pre>
curl -1sLf "https://keys.openpgp.org/vks/v1/by-fingerprint/0A9AF2115F4687BD29803A206B73A36E6026DFCA" \
| sudo gpg --dearmor \
| sudo tee /usr/share/keyrings/com.rabbitmq.team.gpg > /dev/null

sudo tee /etc/apt/sources.list.d/rabbitmq.list <<EOF
deb [arch=amd64 signed-by=/usr/share/keyrings/com.rabbitmq.team.gpg] https://deb1.rabbitmq.com/rabbitmq-server/debian/trixie trixie main
deb [arch=amd64 signed-by=/usr/share/keyrings/com.rabbitmq.team.gpg] https://deb2.rabbitmq.com/rabbitmq-server/debian/trixie trixie main
EOF

sudo apt update
</pre>

==== Установка ====
Убедитесь, что в /etc/hosts есть запись для имени вашего хоста. Отсутствие такрой записи (например, если вы изменили имя хоста после инсталляции) является основной ошибкой, возникающей при установке RabbitMQ. Так что лучше еще раз убедитесь, что запись соответствующая имени хосту имеется.
<pre>
sudo apt install -y erlang-base \
erlang-asn1 erlang-crypto erlang-eldap erlang-ftp erlang-inets \
erlang-mnesia erlang-os-mon erlang-parsetools erlang-public-key \
erlang-runtime-tools erlang-snmp erlang-ssl \
erlang-syntax-tools erlang-tftp erlang-tools erlang-xmerl

sudo apt install rabbitmq-server -y --fix-missing
</pre>

==== Установка необходимых дополнений ====
Следующие две строки выполняйте по одной за раз!
<pre>
sudo rabbitmq-plugins enable rabbitmq_management --offline

sudo rabbitmq-plugins enable rabbitmq_web_stomp --offline
</pre>

==== Настройка ====
Скопируйте и вставьте целиком следующий блок:
<pre>
sudo tee /etc/rabbitmq/rabbitmq.conf << EOF
listeners.tcp.default = 5672

consumer_timeout = 2400000

web_stomp.port = 15674
web_stomp.cowboy_opts.max_keepalive = 60
EOF
</pre>

Теперь нужно создать пользователей. Мы рекомендуем использовать '''три различных пользователя''': для администрирования сервера (полные права), для userside и модулей (полные права но без административных) и пользователя web-stomp для websocket (минимальные права на чтение определенных объектов брокера). Но вы можете создать только два: администратора, который также будете использоваться для USERSIDE, и пользователя для websocket. Это обязательно должны быть минимум два разных пользователя, так как пароль для websocket пользователя передается в браузер и может быть легко прочитан пользователем. Далее будет показан пример для рекомендуемых трех пользователей.

Создайте '''пользователя для администрирования''' RabbitMQ. В данном примере используется имя пользователя '''admin''' и пароль '''пароль_администратора'''. Пользователю сразу после создания присваивается тэг <code>administrator</code>, наделяющий пользователя максимальными правами администратора и затем устанавливаются разрешения для vhost <code>/</code> позволяющие полный доступ к конфигурированию, записи и чтению всего в пределах этого vhost*.
<pre>
sudo rabbitmqctl add_user "admin" "пароль_администратора"
sudo rabbitmqctl set_user_tags "admin" "administrator"
sudo rabbitmqctl set_permissions -p "/" "admin" ".*" ".*" ".*"
</pre>

Создайте '''пользователя, от имени которого будут работать ERP USERSIDE''' и модули. Пример для имени пользователя '''userside''' (наделять админскими правами этого пользователя не нужно):
<pre>
sudo rabbitmqctl add_user "userside" "пароль_системы"
sudo rabbitmqctl set_user_tags "userside" "monitoring"
sudo rabbitmqctl set_permissions -p "/" "userside" ".*" ".*" ".*"
</pre>

Создайте '''пользователя WebSTOMP'''. Он понадобится для использования уведомлений через WebSocket. Вместо '''websock-user''' вы можете указать другое имя пользователя. Вместо '''пароль_websocket''' укажите свой пароль, но этот пароль будет передаваться в открытом виде в браузер, так что не делайте его похожим на остальные пароли:
<pre>
sudo rabbitmqctl add_user "websock-user" "пароль_websocket"
sudo rabbitmqctl set_permissions -p "/" "websock-user" "^erp-stomp:id-.*" "" "^erp-stomp:id-.*"
</pre>

Внимание! Имя пользователя и пароль WebSTOMP вам нужно будет указать в настройках в интерфейсе USERSIDE (Меню: Настройки - Основные - Websocket).

''* vhost - это виртуальный хост внутри RabbitMQ, позволяющий разграничить различные варианты использования одного и того же сервера разными приложениями. Как, например, разные базы данных на одном сервере СУБД. vhost по умолчанию имеет имя / и почти всегда вам этого достаточно. Но если вы планируете, например, запустить несколько копий ERP USERSIDE на одном сервере, то для каждой копии вам нужно будет создать свой vhost и, соответственно, пользователей для него. Подробней обратитесь к [https://www.rabbitmq.com/vhosts.html официальному руководству].''

Перезапустите службу rabbitmq:
<pre>
sudo systemctl restart rabbitmq-server
</pre>

==== Управление ====
Одна из команд, приведенных выше, устанавливает в RabbitMQ модуль управления, предоставляющий удобный WEB-интерфейс для мониторинга, диагностики и управления сервером RabbitMQ. При помощи этого модуля можно осуществлять мониторинг сервера, следить за количеством сообщений в очередях и другими состояниями. Всё это можно делать и используя консольную утилиту <code>rabbitmqctl</code>, но использование WEB-интерфейса может быть значительно наглядней и удобней.

По умолчанию WEB-интерфейс управления доступен по адресу http://userside.mycompany.com:15672. Рекомендуем использовать фаервол, чтобы ограничить доступ к этому интерфейсу управления.

Подробнее о модуле управления можно [https://www.rabbitmq.com/management.html прочитать на официальном сайте RabbitMQ].

=== PHP ===
==== Альтернативный репозиторий ====
<pre>
sudo curl -sSLo /usr/share/keyrings/deb.sury.org-php.gpg https://packages.sury.org/php/apt.gpg
sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'
sudo apt update
</pre>

==== Установка ====
Выполните следующие команды:
<pre>
sudo apt install -y php8.4-{fpm,cli,common,curl,intl,mbstring,opcache,pgsql,readline,xml,zip,snmp,gd}
</pre>

Если вы планируете использовать LDAP, необходимо установить расширение php-ldap:
<pre>
sudo apt install -y php8.4-ldap
</pre>

==== Настройка ====
Далее приведены команды, вносящие изменения в файлы конфигурации.
<pre>
sudo sed -i "s@^;date.timezone.*@date.timezone = $(cat /etc/timezone)@" /etc/php/8.4/fpm/php.ini
sudo sed -i "s@^;date.timezone.*@date.timezone = $(cat /etc/timezone)@" /etc/php/8.4/cli/php.ini
sudo sed -i "s@;cgi.fix_pathinfo=1@cgi.fix_pathinfo=0@" /etc/php/8.4/fpm/php.ini
sudo sed -i "s@post_max_size = 8M@post_max_size = 100M@" /etc/php/8.4/fpm/php.ini
sudo sed -i "s@upload_max_filesize = 2M@upload_max_filesize = 100M@" /etc/php/8.4/fpm/php.ini
sudo sed -i "s@max_execution_time.*@max_execution_time = 300@" /etc/php/8.4/fpm/php.ini
sudo sed -i "s@^;request_terminate_timeout =.*@request_terminate_timeout = 300@" /etc/php/8.4/fpm/pool.d/www.conf

sudo systemctl restart php8.4-fpm
</pre>

=== NGINX ===
==== Альтернативный официальный репозиторий ====
Версия NGINX, поставляемая в репозитории Debian, полностью подходит для использования и нет необходимости в добавлении альтернативного репозитория. Однако, если вам хочется всегда иметь последнюю версию, то выполните следующие строки, чтобы добавить в операционную систему официальный репозиторий nginx:
<pre>
curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
| sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
http://nginx.org/packages/debian `lsb_release -cs` nginx" \
| sudo tee /etc/apt/sources.list.d/nginx.list
echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
| sudo tee /etc/apt/preferences.d/99nginx
sudo apt update
</pre>

Если у вас другая операционная система, вы можете найти необходимые команды для нее на официальном сайте NGINX: https://docs.nginx.com/nginx/admin-guide/installing-nginx/installing-nginx-open-source/

==== Установка ====
<pre>
sudo apt install -y nginx
</pre>

==== Настройка ====
<pre>
sudo sed -i "s@^user.*;@user www-data www-data;@" "/etc/nginx/nginx.conf"
sudo systemctl restart nginx
</pre>

Следующий пример настройки подразумевает, что ERP USERSIDE будет установлен в стандартный каталог системы <code>/var/www/userside</code>. Если вы желаете установить ERP USERSIDE в другой каталог, пожалуйста, не забывайте исправлять его во всех последующих примерах. Чтобы не ошибиться, мы рекомендуем использовать именно каталог <code>/var/www/userside</code>.

Теперь отредактируйте файл /etc/nginx/conf.d/default.conf. Либо удалите его и создайте файл с именем /etc/nginx/conf.d/userside.conf. В любом случае, не зависимо от вашего выбора, содержимое файла должно быть следующим (вместо userside.mycompany.com укажите свое доменное имя):
<pre>
server {
listen 80 default_server;
server_name userside.mycompany.com;
charset utf-8;
client_max_body_size 100M;

access_log /var/log/nginx/userside-access.log;
error_log /var/log/nginx/userside-error.log;

root /var/www/userside/public;
index index.php;

location = /favicon.ico { access_log off; log_not_found off; }
location = /robots.txt { access_log off; log_not_found off; }

location / {
try_files $uri $uri/ /index.php$is_args$args;
}

location ~* ^.+\.(css|ogg|ogv|svg|svgz|eot|otf|woff|mp4|ttf|rss|atom|jpg|jpeg|gif|png|ico|zip|tgz|gz|rar|bz2|doc|xls|exe|ppt|tar|mid|midi|bmp|rtf)$ {
access_log off;
log_not_found off;
expires max;
add_header Pragma public;
add_header Cache-Control "public";
}

location ~ \.php$ {
try_files $uri =404;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/run/php/php8.4-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_read_timeout 300;
include fastcgi_params;
}

location /ws {
proxy_pass http://127.0.0.1:15674/ws;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
proxy_set_header Host $host;
}

location ~ /\.ht { deny all; }
}
</pre>

Также, возможно, вы захотите настроить SSL и что-либо еще. Эта тема выходит за рамки данной инстуркции.

Если Вы установили RabbitMQ '''на другом сервере''', либо изменили значение порта WebSTOMP с 15674 на какой-то другой, то укажите IP-адрес сервера с RabbitMQ и номер порта в строке <code>proxy_pass http://127.0.0.1:15674/ws;</code>. Протокол должен оставаться http. Путь должен оставаться /ws.

Проверьте конфигурацию и если она в порядке перезагрузите nginx:
sudo nginx -t && sudo nginx -s reload

=== Python ===
''Необходим Python3 любой поддерживаемой на данный момент версии. Статус версий можно посмотреть здесь: "[https://devguide.python.org/versions/ Status of Python versions]". Рекомендуется использовать версию с состоянием "security" или "bugfix". Версии отмеченные как "end-of-life" не поддерживаются. Отмеченные как "feature" не рекомендуется использовать.''

Если у вас на хосте неподдерживаемая версия ("end-of-life"), то нужно обязательно [[Python-update|установить дополнительно]] более свежую версию Python.

==== Установка необходимых пакетов ====
sudo apt install -y python3-dev python3-pip python3-venv libffi-dev pkg-config

=== Supervisor ===
sudo apt install -y supervisor

== Загрузка и запуск инсталлятора ==

См. также: [[Инсталлятор|Справку по инсталлятору]]

1. перейти в каталог системы
cd /var/www/userside

2. загрузить скрипт-инсталлятор
curl -fsSL https://my.userside.eu/install.sh | sudo -u www-data bash

3. запустить инсталлятор
sudo -u www-data ./installer install

В процессе работы инсталлятор проверяет соответствие техническим требованиям, запрашивает параметры доступа и проверяет соединения со службами сервера.

Вы можете ввести любой доступный вам номер версии ERP USERSIDE для установки. Для этого можете ввести порядковый номер версии из списка (он содержит только последние версии каждой ветки) либо ввести номер версии целиком, если ее нет в списке.

По окончанию работы инсталлятора будет выведено сообщение об успешной установке.

Если вы произвели установку не от имени пользователя веб-сервера, то обязательно после окончания установки сделайте его владельцем всех файлов userside рекурсивно!

sudo chown -R www-data:www-data /var/www/userside

== Настройка после установки ==

=== Конфигурация системных служб ===
После установки необходимо скопировать примеры конфигурационных файлов системных служб и, при необходимости, настроить их (например, указать путь к каталогу userside, если он отличается от /var/www/userside). Выполните команды:
<pre>
sudo cp etc/us-core-worker.conf-example /etc/supervisor/conf.d/us-core-worker.conf
sudo cp microservice/poller/etc/usm_poller.conf-example /etc/supervisor/conf.d/usm_poller.conf
sudo cp etc/logrotate-example /etc/logrotate.d/userside
sudo cp microservice/poller/etc/logrotate-example /etc/logrotate.d/usm_poller
sudo cp etc/crontab-example /etc/cron.d/userside
</pre>

=== Установка необходимых зависимостей для usm_poller ===
Создайте виртуальное окружение venv для python и установите зависимые модули, как показано далее:
<pre>
cd /var/www/userside/microservice/poller
sudo -H python3 -m venv venv
sudo -H venv/bin/pip install -U pip
sudo -H venv/bin/pip install -U -r requirements.txt
</pre>

=== Запуск супервизора ===
Супервизор контролирует работу служб, указанных в его конфигурации. Для запуска супервизора выполните:
<pre>
sudo systemctl restart supervisor
</pre>
После запуска супервизора, спустя несколько секунд можно понаблюдать за состоянием всех контролируемых им служб. Все службы должны быть в состоянии RUNNING:
<pre>
sudo supervisorctl status
</pre>

== Сразу после установки ==
На этом установка ERP USERSIDE закончена. Теперь выполните следующие шаги:
* Откройте страницу системы '''<nowiki>http://userside.mydomain.com/</nowiki>''' и выполните вход ''(по умолчанию имя пользователя: Admin, пароль: 1234)''.
* Выполните настройку Websocket в разделе: Настройка - Основная - WebSocket. Включите и впишите имя пользователя и пароль WebStomp пользователя, которого вы создавали ранее в разделе RabbitMQ.
* Выполните основные настройки в разделе: [[Настройка - Основная|Настройка - Основная]].
* Настройте взаимодействие с [[Поддерживаемые биллинги|биллингом]] в соответствии с [[Настройка взаимодействия с биллингом|инструкциями]].
* Ознакомьтесь с инструкциями на странице: [[С чего начать?]].
* Настройте [[UserSide API Key|API-ключ]].

== Обновление системы ==
Мы стараемся делать все возможное, чтобы вероятность сквоздного обновления с любой версии до последней версии было успешным. Однако, иногда бывает так, что из-за каки-то старинных проблем со структурой базы данных, которые никогда не мешали работать раньше, может возникнуть ситуация, при которой сквоздное обновление невозможно. В таком случае вам придется обновляться поэтапно на каждую следующую последнюю версию. Например, с 3.14.80 сначала на 3.15.60, затем на 3.16.39 и так далее.

Перед обновлением обязательно прочитайте обо всех изменениях, которые необходимо выполнить для обновления для каждой версии, которая лежит между вашей и той, на которую вы собираетесь обновиться.

Мы рекомендуем сделать копию системы для безопасного проведения обновления. Обратитесь к разделу [[HOWTO: Клонирование USERSIDE]]. Вы всегда можете удалить копию и начать сначала. Это просто и безопасно. Но если вы желаете обновить работающую систему, то выполняйте его в моменты наименьшей нагрузки с запасом по времени, необходимым для аварийного восстановления, если вдруг что-то пойдет не так. Всегда обязательно делайте резервную копию базы данных и файлов перед обновлениями. Если обновление будет прервано, особенно на этапе миграции данных, то есть риск того, что восстановить корректно данные будет очень непросто или даже невозможно. В общем, ответственность за наличие актуальной резервной копии лежит целиком на вас.

==== Процесс обновления ====
Мы настоятельно рекомендуем выполнять тестовые обновления на [[HOWTO:_Клонирование_USERSIDE|копии системы]].

Для проведения обновления запустите инсталлятор в режиме install и следуйте инструкциям:
<pre>
cd /var/www/userside
sudo -u www-data ./installer install
</pre>

После обновления USERSIDE нужно обязательно обновить зависимости usm_poller:
<pre>
cd /var/www/userside/microservice/poller
sudo -H venv/bin/pip install -U pip
sudo -H venv/bin/pip install -U -r requirements.txt
</pre>

Теперь нужно перезапустить все службы, которолируемые супервизором и проследить чтобы все они запустились и были в состоянии RUNNING:
<pre>
sudo supervisorctl restart all
sudo supervisorctl status
</pre>

== Обслуживание системы ==
Для поддержания системы в рабочем состоянии и обеспечения надежной ее работы в будущем рекомендуется выполнять несколько простых дейсвтий:
* периодически создавать резервную копию базы данных
* периодически создавать резервную копию загруженных файлов (это можно сделать просто архивируя каталог /var/www/userside/var/attachments и файл .env)
* периодически наблюдать за производительностью сервера (при помощи htop, atop) и брокера RabbitMQ и принимать решения о масштабировании пулов fpm, фоновых процессов ядра и микросервисов

=== Резервное копирование ===
Установите периодическое резервное копирование базы данных и пользовательских файлов. Желательно минимум раз в сутки в моменты наименьшей нагрузки на сервер. В PostgreSQL существует два способа создать резервную копию базы данных: dump и sql-script. У каждого из них есть свои преимущества и недостатки. Первый создает безопасный дамп базы данных целиком, а второй создает SQL-скрипт, выполняя который можно восстановить как структуру так и данные. Рекомендуем обратиться к [https://www.postgresql.org/docs/current/app-pgdump.html документации по использованию команды pg_dump] для выбора более подходящего для вас способа или набора параметров.

Ниже приведены две команды для создания резервной копии базы данных — выбирайте одну из них и добавляйте в ваш crontab:
<pre>
# SQL-script
sudo -u postgres pg_dump --no-acl -Fp -Z 5 userside > /backup/userside.sql.gz

# DUMP
sudo -u postgres pg_dump --no-acl -Fc userside > /backup/userside.dump
</pre>

Для создания минимальной резервной копии '''файлов''' можно использовать следующую команду (для версии 3.15 и новее):
sudo tar -czf /backup/userside.tgz .env common/config/settings.json var/attachments
Этих файлов вместе с базой данных будет достаточно для восстановления работы USERSIDE. Но вы можете выполнять резервное копирование всего каталога /var/www/userside для большей надежности.

=== Восстановление из резервной копии ===
Для восстановления из дампа используется команда pg_restore. [https://postgrespro.ru/docs/postgresql/13/app-pgrestore Документация по использованию pg_restore]. Для восстановления из SQL-скрипта используется утилита psql. [https://www.postgresql.org/docs/current/app-psql.html Документация по использованию psql].

Перед восстановлением базы данных из резервной копии нужно обязательно остановить работу USERSIDE.

1. Остановить cron userside и всех модулей
<pre>
mkdir -p ~/cron
sudo mv /etc/cron.d/userside ~/cron
sudo mv /etc/cron.d/userside-modules ~/cron
</pre>
2. Остановить работу фоновых служб
<pre>
sudo supervisorctl stop all
</pre>
3. Остановить работу php-fpm
<pre>
sudo systemctl stop php8.4-fpm
</pre>
Только после этого можно приступать к восстановлению базы данных из резервной копии.

==== SQL-script ====
Для восстановления БД из резервной копии в виде SQL-скрипта, сначала нужно пересоздать базу данных, а затем восстановить в пустую базу данных резервную копию:
<pre>
sudo -u postgres dropdb userside
sudo -u postgres createdb -e -E "UTF-8" -l "uk_UA.UTF-8" -O userside -T template0 userside
sudo -u postgres psql -d userside -c "CREATE EXTENSION postgis"
gunzip < userside.sql.gz | sudo -u postgres psql -d userside -v ON_ERROR_STOP=1
</pre>

==== DUMP ====
Дамп содержит целиком базу данных со всеми ее элементами. Поэтому перед восстановлением базы данных из дампа её не должно существовать на сервере — удалите базу данных перед восстановлением из дампа. Также важно, чтобы пользователь базы данных (владелец всех элементов) уже существовал — создайте его перед восстановлением, если вы восстанавливаете базу данных на новом сервере, где нужного пользователя еще нет.

Также обратите внимание, что структура дампа может быть несовместима между разными версиями PostgreSQL. Это не обязательно так, но вполне вероятно.

Для восстановления из дампа используйте команды:
<pre>
sudo -u postgres dropdb userside
sudo -u postgres pg_restore --clean --if-exists --create --exit-on-error --dbname=postgres userside.dump
</pre>
Обратите внимание, что имя базы данных в команде обязательно должно быть '''postgres''', так как из дампа восстанавливается вся база данных целиком, а не ее содержимое.

==== После восстановления базы данных ====
После восстановления базы данных любым способом, необходимо очистить кэш ERP USERSIDE, т.к. в кэше теперь находятся данные, отличные от данных в базе. Перейтите в каталог /var/www/userside и выполните команду очистки кэша (первую, если используется пароль или вторую, если не используется):
<pre>
source /var/www/userside/.env && redis-cli -h $US_REDIS_HOST -p $US_REDIS_PORT -a $US_REDIS_PASSWORD -n $US_REDIS_DB FLUSHDB
source /var/www/userside/.env && redis-cli -h $US_REDIS_HOST -p $US_REDIS_PORT -n $US_REDIS_DB FLUSHDB
</pre>
Восстановите работу служб, которые были остановлены перед выполнением резервной копии:
<pre>
sudo mv ~/cron/* /etc/cron.d
sudo supervisorctl start all
sudo systemctl start php8.4-fpm
</pre>
Выполните команду восстановления, чтобы файлы системы соответствовали версии базы данных и проверить систему на целостность файлов.
<pre>
cd /var/www/userside
sudo -u www-data ./installer repair
</pre>

Installation

2026-06-23T12:46:46Z

IronBot: [IronBot] Sync EN localization from RU

<languages/>
'''en''' | [[Встановлення|uk]] | [[Установка|ru]]

'''ATTENTION: These instructions are valid for ERP USERSIDE versions 3.19+'''
* [[Installation for version 3.18|Instruction for version 3.18]]
* [[Installation for version 3.17|Instruction for version 3.11-3.17]]
* [[Installation for version 3.10 and earlier|Instruction for version 3.10 and earlier]].

== Description ==
For the sake of simplicity, the commands for the '''Linux Debian 13 (trixie)''' operating system will be considered. For experienced system administrators, it should not be difficult to use similar commands for another operating system. If you do not feel confident in administering operating systems, we recommend you to use '''Debian''' or '''Ubuntu Server LTS'''. Because of their simplicity and because our technical support is much more familiar with Debian-like distributions. The likelihood of being able to tell you something not related to ERP USERSIDE, but related to operating system administration, will be much higher if you have Debian or a similar distribution based on it.

On the other hand, if you are an experienced system administrator and have skills and experience with Docker, it may be more convenient for you to use a ready-made environment based on Docker images that we have prepared specially, including everything you need to run ERP USERSIDE. In this case, you will not have to configure anything, except to perform simple Docker-bundle settings https://github.com/userside/userside-docker.

== Requirements ==
ERP USERSIDE requires various system applications and services such as PHP interpreter with a set of extensions, WEB server, database management system and others. This section will list such requirements depending on the version of ERP USERSIDE.

Also note that your operating system must be configured with the correct time zone and locale. The correct display of information and correct sorting depends on this.

The list of required PHP extensions contains all extensions that are not part of the PHP core. Some of these extensions may come with the core PHP package or as part of the php-common package, while others must be installed additionally.

=== 3.20 ===
* PHP 8.4-8.5
* PHP extensions: ctype, gd, json, libxml, mbstring, openssl, pdo, pdo_pgsql, posix, simplexml, snmp, sockets, zlib, pcntl
* Additional PHP extensions: ldap
* Python: ''Requires Python3 of any currently supported version. The status of versions can be viewed here:"[https://devguide.python.org/versions/ Status of Python versions]". It is recommended to use a version with "security" or "bugfix" status. Versions marked as "end-of-life" are not supported. Versions marked as "feature" are not recommended.''
* Python modules: pip, venv
* PostgreSQL: 16+ (preferably 18)
* Redis: 5+ (preferably 7)
* RabbitMQ: 3.13+ (preferably 4+)
* Supervisor

=== 3.19 (current stable) ===
* PHP: 8.3-8.4
* PHP extensions: ctype, gd, json, libxml, mbstring, openssl, pdo, pdo_pgsql, posix, simplexml, snmp, sockets, zlib, pcntl
* Additional PHP extensions: ldap, soap
* Python: ''Requires Python3 of any currently supported version. The status of versions can be viewed here:"[https://devguide.python.org/versions/ Status of Python versions]". It is recommended to use a version with "security" or "bugfix" status. Versions marked as "end-of-life" are not supported. Versions marked as "feature" are not recommended.''
* Python modules: pip, venv
* PostgreSQL: 12+ (preferably 16)
* Redis: 5+ (preferably 7)
* RabbitMQ: 3.10+ (preferably 3.13)
* Supervisor

== Main agreements ==
The directory where ERP USERSIDE is installed is <code>/var/www/userside</code>. Inside this directory there should be a subdirectory public, which is the root directory for the WEB server. If you want to use a different directory for ERP USERSIDE, remember to make the appropriate corrections to all the examples in these instructions.

Create the directory:
sudo mkdir -p /var/www/userside/public /var/log/usm_poller
sudo chown -R www-data:www-data /var/www/userside /var/log/usm_poller

You will need to allocate a domain name for ERP USERSIDE. The examples below use userside.mycompany.com, but you will need to change it to your own. Write this domain name in /etc/hosts if it is different from the hostname of the installation.

== Installation of the required components ==
First install the utilities that will be required later in the installation process. They are required for any ERP USERSIDE program. You can copy the lines one at a time and paste them into the command line of your operating system.

Copy and paste the following lines in their entirety:
<pre>
sudo tee /etc/apt/sources.list.d/contrib-non-free.list << EOL
deb http://deb.debian.org/debian/ $(lsb_release -sc) contrib non-free non-free-firmware
EOL

sudo apt update
sudo apt full-upgrade -y
sudo apt install -y gnupg ca-certificates lsb-release debian-archive-keyring debian-keyring libsnmp-dev snmp-mibs-downloader
</pre>

=== PostgreSQL ===
==== Alternative official repository ====
We strongly recommend using the latest version of PostgreSQL, as this always has a positive impact on speed. Add the official Postgres repository to the system:
<pre>
sudo install -d /usr/share/postgresql-common/pgdg

sudo curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc --fail https://www.postgresql.org/media/keys/ACCC4CF8.asc

sudo sh -c 'echo "deb [signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc] https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'

sudo apt update
</pre>
If you have a different operating system, you can find the necessary commands for it at [https://www.postgresql.org/download/ official PostgreSQL website].

==== Installation ====
'''Attention!''' Before installing PostgreSQL, your operating system must have your local locale and correct time zone set! This can be done later, but it will be much easier if it is done before installing PostgreSQL. Run the following command to make sure the correct locale is present:
locale -a

If your local locale is not among those listed, then install it. To do this, simply edit the /etc/locale.gen file by removing the comments before the line(s) with the desired locale, and then run the command:
sudo locale-gen

If you need to change the default locale, run:
sudo dpkg-reconfigure locales

To change the time zone, execute:
sudo timedatectl set-timezone Europe/Kyiv

Now you can move on to the PostgreSQL installation:
sudo apt install -y postgresql-18 postgresql-18-postgis-3

==== Setting ====
Create a user and database for ERP USERSIDE. The example below creates a user named userside and a database with the same name. If your locale is not uk_UA, remember to change the command. The PostGis extension needed to work with geographic data is then connected to the database. After doing the first line, you will need to enter the password for the new user twice - make a note of this password, you will need it later to set up ERP USERSIDE
<pre>
sudo -u postgres createuser userside -P
sudo -u postgres createdb -e -E "UTF-8" -l "uk_UA.UTF-8" -O userside -T template0 userside
sudo -u postgres psql -d userside -c "CREATE EXTENSION postgis"
</pre>

If your PostgreSQL is installed '''on another server''', you will need to make corrections to the postgresql.conf and pg_hba.conf files located in the /etc/postgresql/16/main/ directory. In the postgresql.conf file, you must uncomment and change the value of the parameter <code>listen_addresses</code>, specifying there all IP addresses of the server interfaces on which it can accept connections to PostgreSQL. In the pg_hba.conf file you need to add a line at the very end, similar to the previous ones, indicating from which address the ERP USERSIDE user can connect. But if your PostgreSQL is located on the same server as USERSIDE - there is no need to make any adjustments to these files.

=== Redis ===
The Debian 13 standard repository includes Redis version 8.0.2. This version is suitable for running ERP USERSIDE.

==== Installation ====
sudo apt install -y redis-server

==== Setting ====
By default Redis accepts connections without a password, but we strongly recommend setting a password. Since the password is transmitted in the clear (Redis does not provide encryption because it focuses on speed of request processing and extra steps like encryption are not applied), you need to create a really long and complex password, for example, using the '''openssl''' utility as follows:

openssl rand --hex 32

The output will be a random set of 32 bytes in 16-character form, which you will use as a password. Next, you will need to substitute this generated string in place of the word '''MYPASSWORDHERE'''. Write it down. Then you will specify this string as the Redis password in the settings.

Specify the generated passphrase hash in the Redis configuration file:

sudo sed -i 's@^.*requirepass .*@requirepass MYPASSWORDHERE@g' /etc/redis/redis.conf

where instead of '''MYPASSWORDHERE''' specify the hash of the passphrase received earlier.

You should also disable timeout (on some versions of Redis it is enabled):

sudo sed -i 's@^timeout .*@timeout 0@' /etc/redis/redis.conf

Restart Redis and make sure it works (should get PONG in response):
<pre>
sudo systemctl restart redis
redis-cli -h 127.0.0.1 -p 6379 -a MYPASSWORDHERE ping
</pre>

=== RabbitMQ ===
The Debian 13 standard repository includes an older version of RabbitMQ 4.0.5. You can use it - it is supported. However, this version is relatively old and your best bet is to install a newer version from alternative repositories. The [https://www.rabbitmq.com/docs/install-debian official RabbitMQ website] has fairly detailed information on installing RabbitMQ for each operating system.

==== Adding alternative repositories ====
Copy and paste the following block in its entirety into the command line
<pre>
curl -1sLf "https://keys.openpgp.org/vks/v1/by-fingerprint/0A9AF2115F4687BD29803A206B73A36E6026DFCA" \
| sudo gpg --dearmor \
| sudo tee /usr/share/keyrings/com.rabbitmq.team.gpg > /dev/null

sudo tee /etc/apt/sources.list.d/rabbitmq.list <<EOF
deb [arch=amd64 signed-by=/usr/share/keyrings/com.rabbitmq.team.gpg] https://deb1.rabbitmq.com/rabbitmq-server/debian/trixie trixie main
deb [arch=amd64 signed-by=/usr/share/keyrings/com.rabbitmq.team.gpg] https://deb2.rabbitmq.com/rabbitmq-server/debian/trixie trixie main
EOF

sudo apt update
</pre>

==== Installation ====
Make sure that /etc/hosts has an entry for your hostname. The lack of such an entry (for example, if you changed the hostname after installation) is a major error that occurs when installing RabbitMQ. So it is better to make sure again that there is an entry for the hostname.
<pre>
sudo apt install -y erlang-base \
erlang-asn1 erlang-crypto erlang-eldap erlang-ftp erlang-inets \
erlang-mnesia erlang-os-mon erlang-parsetools erlang-public-key \
erlang-runtime-tools erlang-snmp erlang-ssl \
erlang-syntax-tools erlang-tftp erlang-tools erlang-xmerl

sudo apt install rabbitmq-server -y --fix-missing
</pre>

==== Installation of necessary add-ons ====
Do the next two lines one at a time!
<pre>
sudo rabbitmq-plugins enable rabbitmq_management --offline

sudo rabbitmq-plugins enable rabbitmq_web_stomp --offline
</pre>

==== Setting ====
Copy and paste the following block in its entirety:
<pre>
sudo tee /etc/rabbitmq/rabbitmq.conf << EOF
listeners.tcp.default = 5672

consumer_timeout = 2400000

web_stomp.port = 15674
web_stomp.cowboy_opts.max_keepalive = 60
EOF
</pre>

Now you need to create users. We recommend using '''three different users''': for server administration (full rights), for userside and modules (full rights but no administrative rights) and the web-stomp user for websocket (minimal rights to read certain broker objects). But you can only create two: an admin user, which will also be used for userside, and a user for websocket. These must necessarily be at least two different users, since the password for the websocket user is passed to the browser and can be easily read by the user. The following will show an example for the recommended three users.

Create a '''user for administration''' RabbitMQ. This example uses the username '''admin''' and password '''admin_password'''.
A tag <code>administrator</code> is assigned to the user immediately after creation, giving the user maximum administrator rights and then set permissions for vhost <code>/</code> allowing full access to configure, write and read everything within that vhost*.
<pre>
sudo rabbitmqctl add_user "admin" "admin_password"
sudo rabbitmqctl set_user_tags "admin" "administrator"
sudo rabbitmqctl set_permissions -p "/" "admin" ".*" ".*" ".*"
</pre>

Create a '''user on behalf of which ERP USERSIDE''' and modules will run. Example for the user name '''userside''' (you do not need to give admin rights to this user):
<pre>
sudo rabbitmqctl add_user "userside" "system_password"
sudo rabbitmqctl set_user_tags "userside" "monitoring"
sudo rabbitmqctl set_permissions -p "/" "userside" ".*" ".*" ".*"
</pre>

Create a '''WebSTOMP user''' . You will need it to use notifications via WebSocket. Instead of '''websock-user''' you can specify a different user name. Instead of '''password_websocket''' specify your password, but this password will be passed in the clear to the browser, so don't make it similar to other passwords:
<pre>
sudo rabbitmqctl add_user "websock-user" "password_websocket"
sudo rabbitmqctl set_permissions -p "/" "websock-user" "^erp-stomp:id-.*" "" "^erp-stomp:id-.*"
</pre>

Attention!: You will need to specify the WebSTOMP username and password in the settings in the USERSIDE interface (Menu: Settings - Main - Websocket).

''* vhost - is a virtual host within RabbitMQ that allows different applications to differentiate between different uses of the same server. Like, for example, different databases on the same DBMS server. The default vhost is named / and almost always this is enough for you. But if you plan, for example, to run multiple copies of ERP USERSIDE on the same server, then for each copy you will need to create a different vhost and, accordingly, users for it. Please refer to [https://www.rabbitmq.com/vhosts.html official manual] for more details.‘’

Restart the rabbitmq service:
<pre>
sudo systemctl restart rabbitmq-server
</pre>

==== Management ====
One of the commands above installs a management module in RabbitMQ that provides a convenient WEB interface to monitor, diagnose, and manage the RabbitMQ server. With this module you can monitor the server, keep track of the number of messages in queues and other statuses. All this can be done using the console utility as well <code>rabbitmqctl</code>, but using the WEB-interface can be much clearer and more convenient.

By default, the WEB management interface is available at http://userside.mycompany.com:15672. We recommend using a firewall to restrict access to this control interface.

More details about the control module can be [https://www.rabbitmq.com/management.html read on the official RabbitMQ website].

=== PHP ===
==== Alternative repository ====
<pre>
sudo curl -sSLo /usr/share/keyrings/deb.sury.org-php.gpg https://packages.sury.org/php/apt.gpg
sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'
sudo apt update
</pre>

==== Installation ====
Execute the following commands:
<pre>
sudo apt install -y php8.4-{fpm,cli,common,curl,intl,mbstring,opcache,pgsql,readline,xml,zip,snmp,gd}
</pre>

If you plan to use LDAP, you need to install the php-ldap extension:
<pre>
sudo apt install -y php8.4-ldap
</pre>

==== Setting ====
The following are commands that make changes to the configuration files.
<pre>
sudo sed -i "s@^;date.timezone.*@date.timezone = $(cat /etc/timezone)@" /etc/php/8.4/fpm/php.ini
sudo sed -i "s@^;date.timezone.*@date.timezone = $(cat /etc/timezone)@" /etc/php/8.4/cli/php.ini
sudo sed -i "s@;cgi.fix_pathinfo=1@cgi.fix_pathinfo=0@" /etc/php/8.4/fpm/php.ini
sudo sed -i "s@post_max_size = 8M@post_max_size = 100M@" /etc/php/8.4/fpm/php.ini
sudo sed -i "s@upload_max_filesize = 2M@upload_max_filesize = 100M@" /etc/php/8.4/fpm/php.ini
sudo sed -i "s@max_execution_time.*@max_execution_time = 300@" /etc/php/8.4/fpm/php.ini
sudo sed -i "s@^;request_terminate_timeout =.*@request_terminate_timeout = 300@" /etc/php/8.4/fpm/pool.d/www.conf

sudo systemctl restart php8.4-fpm
</pre>

=== NGINX ===
==== Alternative official repository ====
The version of NGINX supplied in the Debian repository is fully usable and there is no need to add an alternative repository. However, if you want to always have the latest version, run the following lines to add the official nginx repository to your operating system:
<pre>
curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
| sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
http://nginx.org/packages/debian `lsb_release -cs` nginx" \
| sudo tee /etc/apt/sources.list.d/nginx.list
echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
| sudo tee /etc/apt/preferences.d/99nginx
sudo apt update
</pre>

If you have a different operating system, you can find the necessary commands for it on the official NGINX website: https://docs.nginx.com/nginx/admin-guide/installing-nginx/installing-nginx-open-source/

==== Installation ====
<pre>
sudo apt install -y nginx
</pre>

==== Setting ====
<pre>
sudo sed -i "s@^user.*;@user www-data www-data;@" "/etc/nginx/nginx.conf"
sudo systemctl restart nginx
</pre>

The following configuration example assumes that the ERP USERSIDE will be set to the system's default directory <code>/var/www/userside</code>. If you wish to install ERP USERSIDE in a different directory, please remember to fix it in all subsequent examples. In order not to make a mistake, we recommend to use exactly the directory <code>/var/www/userside</code>.

Now edit the file /etc/nginx/conf.d/default.conf. Or delete it and create a file named /etc/nginx/conf.d/userside.conf. In either case, regardless of your choice, the contents of the file should be as follows (instead of userside.mycompany.com, specify your domain name):
<pre>
server {
listen 80 default_server;
server_name userside.mycompany.com;
charset utf-8;
client_max_body_size 100M;

access_log /var/log/nginx/userside-access.log;
error_log /var/log/nginx/userside-error.log;

root /var/www/userside/public;
index index.php;

location = /favicon.ico { access_log off; log_not_found off; }
location = /robots.txt { access_log off; log_not_found off; }

location / {
try_files $uri $uri/ /index.php$is_args$args;
}

location ~* ^.+\.(css|ogg|ogv|svg|svgz|eot|otf|woff|mp4|ttf|rss|atom|jpg|jpeg|gif|png|ico|zip|tgz|gz|rar|bz2|doc|xls|exe|ppt|tar|mid|midi|bmp|rtf)$ {
access_log off;
log_not_found off;
expires max;
add_header Pragma public;
add_header Cache-Control "public";
}

location ~ \.php$ {
try_files $uri =404;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/run/php/php8.4-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_read_timeout 300;
include fastcgi_params;
}

location /ws {
proxy_pass http://127.0.0.1:15674/ws;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
proxy_set_header Host $host;
}

location ~ /\.ht { deny all; }
}
</pre>

You may also want to configure SSL and something else. This topic is beyond the scope of this manual.

If you have installed RabbitMQ '''on another server''', or changed the value of the WebSTOMP port from 15674 to some other, then specify the IP address of the server with RabbitMQ and the port number in the line <code>proxy_pass http://127.0.0.1:15674/ws;</code>. The protocol must remain http. The path must remain /ws.

Check the configuration and if it is ok restart nginx:
sudo nginx -t && sudo nginx -s reload

=== Python ===
''Requires Python3 of any currently supported version. The status of versions can be viewed here:"[https://devguide.python.org/versions/ Status of Python versions]". It is recommended to use a version with "security" or "bugfix" status. Versions marked as "end-of-life" are not supported. Versions marked as "feature" are not recommended.''

If you have an unsupported version ("end-of-life") installed on your host, you should be sure to [[Python-update_EN|install additionally]] a more recent version of Python.

==== Installing the required packages ====
sudo apt install -y python3-dev python3-pip python3-venv libffi-dev pkg-config

=== Supervisor ===
sudo apt install -y supervisor

== Downloading and launching the installer ==

See also: [[Installer|Installer Help]]

1. navigate to the system catalogue
cd /var/www/userside

2. download the installer script
curl -fsSL https://my.userside.eu/install.sh | sudo -u www-data bash

3. run installer
sudo -u www-data ./installer install

During operation, the installer verifies compliance with technical requirements, requests access parameters, and checks connections to server services.

You can enter any ERP USERSIDE version number available to you for installation. To do this, you can enter the version number from the list (it contains only the latest version of each branch) or enter the entire version number if it is not on the list.

When the installer finishes, a message will be displayed indicating that the installation was successful.

If you did not install as a web server user, be sure to make that user the owner of all userside files recursively after the installation is complete!

sudo chown -R www-data:www-data /var/www/userside

== Setting up after installation ==

=== Configuration of system services ===
After installation, copy the sample configuration files of the system services and, if necessary, customise them (for example, specify the path to the userside directory if it is different from /var/www/userside). Run the commands:
<pre>
sudo cp etc/us-core-worker.conf-example /etc/supervisor/conf.d/us-core-worker.conf
sudo cp microservice/poller/etc/usm_poller.conf-example /etc/supervisor/conf.d/usm_poller.conf
sudo cp etc/logrotate-example /etc/logrotate.d/userside
sudo cp microservice/poller/etc/logrotate-example /etc/logrotate.d/usm_poller
sudo cp etc/crontab-example /etc/cron.d/userside
</pre>

=== Installation of necessary dependencies for usm_poller ===
Create a venv virtual environment for python and install the dependent modules as shown below:
<pre>
cd /var/www/userside/microservice/poller
sudo -H python3 -m venv venv
sudo -H venv/bin/pip install -U pip
sudo -H venv/bin/pip install -U -r requirements.txt
</pre>

=== Running the supervisor ===
The Supervisor controls the operation of the services specified in its configuration. To launch the supervisor, run the following:
<pre>
sudo systemctl restart supervisor
</pre>
After the supervisor is launched, after a few seconds you can observe the state of all the services it controls. All services must be in the RUNNING state:
<pre>
sudo supervisorctl status
</pre>

== Immediately after the installation ==
This completes the installation of ERP USERSIDE. Now perform the following steps:
* Open the system page '''<nowiki>http://userside.mydomain.com/</nowiki>''' and login ''(default username: Admin, password: 1234)''.
* Configure Websocket under: Settings - Main - WebSocket. Enable and enter the username and password of the WebStomp user you created earlier under RabbitMQ.
* Make main settings in the section: [[Settings_-_Main|Settings - Main]].
* Configure interaction with [[Supported_billings|billing]] according to the [[Setting_up_interactions_with_a_billing|instructions]].
* Read the instructions on the page: [[Start_EN|Where to start?]].
* Configure the [[UserSide_API_Key|API Key]].

== System upgrade ==
We try to do our best to ensure that the likelihood of an end-to-end upgrade from any version to the latest version is successful. However, it sometimes happens that due to some ancient problems with the database structure that never prevented you from working before, a situation may arise in which an end-to-end upgrade is not possible. In this case you will have to upgrade step by step to each next latest version. For example, from 3.14.80 first to 3.15.60, then to 3.16.39, and so on.

Before upgrading, be sure to read about all the changes you need to make to upgrade for each version that lies between yours and the one you are going to upgrade to.

We recommend making a copy of your system to safely perform the upgrade. Refer to [[HOWTO: USERSIDE cloning]]. You can always delete the copy and start over. This is easy and safe. But if you wish to upgrade a running system, perform it at times of least stress, with time to spare for disaster recovery if something goes wrong. Always be sure to back up your database and files before upgrading. If an update is interrupted, especially during the data migration phase, there is a risk that it will be very difficult or even impossible to restore the data correctly. In general, the responsibility for having an up-to-date backup lies entirely with you.

==== Upgrade process ====
We strongly recommend performing test upgrades on a [[HOWTO: USERSIDE cloning|copy of the system]].

To perform an upgrade, run the installer in install mode and follow the instructions:
<pre>
cd /var/www/userside
sudo -u www-data ./installer install
</pre>

After upgrading the USERSIDE, you should be sure to upgrade the usm_poller dependencies:
<pre>
cd /var/www/userside/microservice/poller
sudo -H venv/bin/pip install -U pip
sudo -H venv/bin/pip install -U -r requirements.txt
</pre>

Now we need to restart all the services that are supervised by the supervisor and make sure that all of them start and are in the RUNNING state:
<pre>
sudo supervisorctl restart all
sudo supervisorctl status
</pre>

== System maintenance ==
To keep the system up to date and to ensure reliable operation in the future, it is recommended that you follow a few simple steps:
* periodically back up the database
* periodically create a backup copy of uploaded files (this can be done simply by archiving the /var/www/userside/var/attachments directory and the .env file)
* periodically monitor server performance (using htop, atop) and the RabbitMQ broker and make decisions about scaling fpm pools, kernel background processes and microservices

=== Backup ===
Set up periodic backups of the database and user files. Preferably at least once a day when the server is least loaded. In PostgreSQL, there are two ways to back up the database: dump and sql-script. Each of them has its own advantages and disadvantages. The first one creates a secure dump of the entire database, while the second one creates a SQL script that can restore both structure and data. We recommend referring to [https://www.postgresql.org/docs/current/app-pgdump.html documentation on how to use the pg_dump command] for a more suitable method or set of parameters for you.

Below are two commands for creating a database backup - choose one of them and add it to your crontab:
<pre>
# SQL-script
sudo -u postgres pg_dump --no-acl -Fp -Z 5 userside > /backup/userside.sql.gz

# DUMP
sudo -u postgres pg_dump --no-acl -Fc userside > /backup/userside.dump
</pre>

To create a minimal backup of '''files''' you can use the following command (for version 3.15 and later):
sudo tar -czf /backup/userside.tgz .env common/config/settings.json var/attachments
These files together with the database will be enough to restore USERSIDE. But you can back up the entire /var/www/userside directory for more reliability.

=== Restoring from a backup ===
The pg_restore command is used to restore from a dump. [https://postgrespro.ru/docs/postgresql/13/app-pgrestore Documentation on using pg_restore]. The psql utility is used to restore from a SQL script. [https://www.postgresql.org/docs/current/app-psql.html Documentation on using psql].

Before restoring the database from a backup, you must be sure to stop USERSIDE.

1. Stop cron userside and all modules
<pre>
mkdir -p ~/cron
sudo mv /etc/cron.d/userside ~/cron
sudo mv /etc/cron.d/userside-modules ~/cron
</pre>
2. Stop running background services
<pre>
sudo supervisorctl stop all
</pre>
3. Stop php-fpm from running
<pre>
sudo systemctl stop php8.4-fpm
</pre>
Only then can you proceed to restore the database from a backup copy.

==== SQL-script ====
To restore a database from a backup as a SQL script, you must first recreate the database and then restore to an empty backup database:
<pre>
sudo -u postgres dropdb userside
sudo -u postgres createdb -e -E "UTF-8" -l "uk_UA.UTF-8" -O userside -T template0 userside
sudo -u postgres psql -d userside -c "CREATE EXTENSION postgis"
gunzip < userside.sql.gz | sudo -u postgres psql -d userside -v ON_ERROR_STOP=1
</pre>

==== DUMP ====
The dump contains the entire database with all its elements. Therefore, before restoring a database from a dump, it must not exist on the server - delete the database before restoring from a dump. It is also important that the database user (the owner of all items) already exists - create it before restoring if you are restoring the database on a new server where the required user does not exist yet.

Also note that the dump structure may not be compatible between different versions of PostgreSQL. This is not necessarily the case, but it is likely.

To restore from the dump, use the commands:
<pre>
sudo -u postgres dropdb userside
sudo -u postgres pg_restore --clean --if-exists --create --exit-on-error --dbname=postgres userside.dump
</pre>
Note that the database name in the command must be '''postgres''', because the entire database is restored from the dump, not its contents.

==== After restoring the database ====
After restoring the database in any way, you must clear the ERP USERSIDE cache, as the cache now contains different data from the database. Go to the /var/www/userside directory and run the clear cache command (first, if a password is used, or second, if it is not used):
<pre>
source /var/www/userside/.env && redis-cli -h $US_REDIS_HOST -p $US_REDIS_PORT -a $US_REDIS_PASSWORD -n $US_REDIS_DB FLUSHDB
source /var/www/userside/.env && redis-cli -h $US_REDIS_HOST -p $US_REDIS_PORT -n $US_REDIS_DB FLUSHDB
</pre>
Restore services that were stopped before performing the backup:
<pre>
sudo mv ~/cron/* /etc/cron.d
sudo supervisorctl start all
sudo systemctl start php8.4-fpm
</pre>
Run the restore command to make the system files match the database version and check the system for file integrity.
<pre>
cd /var/www/userside
sudo -u www-data ./installer repair
</pre>

Встановлення

2026-06-23T12:46:46Z

IronBot: [IronBot] Create UK localization from RU

<languages/>
[[Installation|en]] | '''uk''' | [[Установка|ru]]

'''УВАГА: ця інструкція актуальна для версій ERP USERSIDE 3.19+'''
* [[Встановлення для версії 3.18|Інструкція для версії 3.18]]
* [[Встановлення для версії 3.17|Інструкція для версії 3.11-3.17]]
* [[Встановлення для версії 3.10 і раніших|Інструкція для версії 3.10 і раніше]].

== Опис ==
Для спрощення будуть розглянуті команди для операційної системи '''Linux Debian 13 (trixie)'''. Для досвідчених системних адміністраторів не становитиме труднощів використати аналогічні команди для іншої операційної системи. Якщо ж ви не почуваєтеся впевнено в адмініструванні операційних систем, ми рекомендуємо використовувати '''Debian''' або '''Ubuntu Server LTS'''. Через їхню простоту, а також тому, що наша технічна підтримка значно краще розбирається в Debian-подібних дистрибутивах. Імовірність підказати щось, що не стосується ERP USERSIDE, але стосується адміністрування операційної системи, буде значно вищою, якщо у вас Debian або подібний дистрибутив на його основі.

З іншого боку, якщо ви досвідчений системний адміністратор і маєте навички та досвід роботи з Docker, можливо, зручнішим для вас буде варіант використання готового середовища на базі Docker-образів, які ми підготували спеціально, включивши до них усе необхідне для роботи ERP USERSIDE. У цьому випадку вам не доведеться нічого налаштовувати, крім виконання простих налаштувань Docker-бандла https://github.com/userside/userside-docker.

== Вимоги ==
Для роботи ERP USERSIDE потрібні різні системні застосунки та служби, зокрема інтерпретатор мови PHP з набором розширень, WEB-сервер, система керування базами даних тощо. У цьому розділі перелічені такі вимоги залежно від версії ERP USERSIDE.

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

Список потрібних розширень PHP містить усі розширення, які не входять до складу ядра PHP. Частина цих розширень може постачатися разом з основним пакетом PHP або у складі пакета php-common, інша частина має бути встановлена додатково.

=== 3.20 ===
* PHP 8.4-8.5
* Розширення PHP: ctype, gd, json, libxml, mbstring, openssl, pdo, pdo_pgsql, posix, simplexml, snmp, sockets, zlib, pcntl
* Додаткові розширення PHP: ldap
* Python: ''Потрібен Python3 будь-якої версії, що підтримується на цей момент. Статус версій можна переглянути тут: "[https://devguide.python.org/versions/ Status of Python versions]". Рекомендується використовувати версію зі станом "security" або "bugfix". Версії, позначені як "end-of-life", не підтримуються. Версії, позначені як "feature", використовувати не рекомендується.''
* Модулі Python: pip, venv
* PostgreSQL: 16+ (бажано 18)
* Redis: 5+ (бажано 7)
* RabbitMQ: 3.13+ (бажано 4+)
* Supervisor

=== 3.19 (поточна стабільна) ===
* PHP: 8.3-8.4
* Розширення PHP: ctype, gd, json, libxml, mbstring, openssl, pdo, pdo_pgsql, posix, simplexml, snmp, sockets, zlib, pcntl
* Додаткові розширення PHP: ldap, soap
* Python: ''Потрібен Python3 будь-якої версії, що підтримується на цей момент. Статус версій можна переглянути тут: "[https://devguide.python.org/versions/ Status of Python versions]". Рекомендується використовувати версію зі станом "security" або "bugfix". Версії, позначені як "end-of-life", не підтримуються. Версії, позначені як "feature", використовувати не рекомендується.''
* Модулі Python: pip, venv
* PostgreSQL: 12+ (бажано 16)
* Redis: 5+ (бажано 7)
* RabbitMQ: 3.10+ (бажано 3.13)
* Supervisor

== Основні домовленості ==
Каталог, у який встановлюється ERP USERSIDE, - <code>/var/www/userside</code>. Усередині цього каталогу має бути підкаталог public, який є кореневим каталогом для WEB-сервера. Якщо ви хочете використовувати інший каталог для ERP USERSIDE, не забувайте вносити відповідні виправлення в усі приклади з цієї інструкції.

Створіть каталоги:
sudo mkdir -p /var/www/userside/public /var/log/usm_poller
sudo chown -R www-data:www-data /var/www/userside /var/log/usm_poller

Вам потрібно виділити доменне ім'я для ERP USERSIDE. У прикладах нижче використовується userside.mycompany.com, але вам потрібно буде замінити його на своє. Пропишіть це доменне ім'я в /etc/hosts, якщо воно відрізняється від імені хоста, на якому виконується встановлення.

== Встановлення необхідних компонентів ==
Спочатку встановіть утиліти, які будуть потрібні далі в процесі встановлення. Вони потрібні для будь-якої версії ERP USERSIDE. Ви можете копіювати рядки по одному та вставляти їх у командний рядок вашої операційної системи.

Скопіюйте та вставте такі рядки повністю:
<pre>
sudo tee /etc/apt/sources.list.d/contrib-non-free.list << EOL
deb http://deb.debian.org/debian/ $(lsb_release -sc) contrib non-free non-free-firmware
EOL

sudo apt update
sudo apt full-upgrade -y
sudo apt install -y gnupg ca-certificates lsb-release debian-archive-keyring debian-keyring libsnmp-dev snmp-mibs-downloader
</pre>

=== PostgreSQL ===
==== Альтернативний офіційний репозиторій ====
Ми наполегливо рекомендуємо використовувати останню версію PostgreSQL, оскільки це завжди позитивно впливає на швидкість роботи. Додайте до системи офіційний репозиторій Postgres:
<pre>
sudo install -d /usr/share/postgresql-common/pgdg

sudo curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc --fail https://www.postgresql.org/media/keys/ACCC4CF8.asc

sudo sh -c 'echo "deb [signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc] https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'

sudo apt update
</pre>
Якщо у вас інша операційна система, необхідні команди для неї можна знайти на [https://www.postgresql.org/download/ офіційному сайті PostgreSQL].

==== Встановлення ====
'''Увага!''' Перед встановленням PostgreSQL у вашій операційній системі має бути встановлена ваша локальна локаль і коректний часовий пояс. Це можна зробити й пізніше, але буде значно простіше, якщо це виконати до встановлення PostgreSQL. Виконайте таку команду, щоб переконатися, що потрібна локаль присутня:
locale -a

Якщо серед перелічених немає вашої локальної локалі, встановіть її. Для цього достатньо відредагувати файл /etc/locale.gen, прибравши коментарі перед рядком або рядками з потрібною локаллю, а потім виконати команду:
sudo locale-gen

Якщо потрібно змінити локаль за замовчуванням, виконайте:
sudo dpkg-reconfigure locales

Щоб змінити часовий пояс, виконайте:
sudo timedatectl set-timezone Europe/Kyiv

Тепер можна перейти до встановлення PostgreSQL:
sudo apt install -y postgresql-18 postgresql-18-postgis-3

==== Налаштування ====
Створіть користувача та базу даних для ERP USERSIDE. У прикладі нижче створюється користувач з іменем userside і база даних з таким самим іменем. Якщо ваша локаль не uk_UA, не забудьте змінити команду. Потім до бази даних підключається розширення PostGis, потрібне для роботи з географічними даними. Після виконання першого рядка вам потрібно буде двічі ввести пароль для нового користувача - запишіть цей пароль, він знадобиться далі для встановлення ERP USERSIDE.
<pre>
sudo -u postgres createuser userside -P
sudo -u postgres createdb -e -E "UTF-8" -l "uk_UA.UTF-8" -O userside -T template0 userside
sudo -u postgres psql -d userside -c "CREATE EXTENSION postgis"
</pre>

Якщо PostgreSQL встановлений '''на іншому сервері''', потрібно буде внести корекції до файлів postgresql.conf і pg_hba.conf, розташованих у каталозі /etc/postgresql/16/main/. У файлі postgresql.conf потрібно розкоментувати та змінити значення параметра <code>listen_addresses</code>, вказавши там усі IP-адреси інтерфейсів сервера, на яких він може приймати підключення до PostgreSQL. У файлі pg_hba.conf потрібно в самому кінці додати рядок за аналогією з попередніми, який вказує, з якої адреси може підключатися користувач ERP USERSIDE. Але якщо PostgreSQL розташований на тому самому сервері, що й USERSIDE, вносити корективи в ці файли не потрібно.

=== Redis ===
Стандартний репозиторій Debian 13 містить Redis версії 8.0.2. Ця версія підходить для роботи ERP USERSIDE.

==== Встановлення ====
sudo apt install -y redis-server

==== Налаштування ====
За замовчуванням Redis приймає підключення без пароля, але ми наполегливо рекомендуємо встановити пароль. Оскільки пароль передається у відкритому вигляді (Redis не передбачає шифрування, бо орієнтований на швидкість обробки запитів, і додаткові кроки на кшталт шифрування не застосовуються), потрібно створити справді довгий і складний пароль, наприклад за допомогою утиліти '''openssl''':

openssl rand --hex 32

На виході буде випадковий набір із 32 байтів у шістнадцятковому вигляді, який ви використовуватимете як пароль. Далі потрібно підставити цей згенерований рядок замість слова '''MYPASSWORDHERE'''. Запишіть його. Потім ви вкажете цей рядок як пароль Redis у налаштуваннях.

Вкажіть згенерований пароль у конфігураційному файлі Redis:

sudo sed -i 's@^.*requirepass .*@requirepass MYPASSWORDHERE@g' /etc/redis/redis.conf

де замість '''MYPASSWORDHERE''' вкажіть отриманий раніше пароль.

Також слід вимкнути timeout (у деяких версіях Redis він увімкнений):

sudo sed -i 's@^timeout .*@timeout 0@' /etc/redis/redis.conf

Перезапустіть Redis і переконайтеся, що він працює (у відповідь має бути PONG):
<pre>
sudo systemctl restart redis
redis-cli -h 127.0.0.1 -p 6379 -a MYPASSWORDHERE ping
</pre>

=== RabbitMQ ===
Стандартний репозиторій Debian 13 містить старішу версію RabbitMQ 4.0.5. Її можна використовувати - вона підтримується. Однак ця версія відносно стара, тому краще встановити новішу версію з альтернативних репозиторіїв. На [https://www.rabbitmq.com/docs/install-debian офіційному сайті RabbitMQ] є досить докладна інформація щодо встановлення RabbitMQ для кожної операційної системи.

==== Додавання альтернативних репозиторіїв ====
Скопіюйте та вставте такий блок повністю в командний рядок:
<pre>
curl -1sLf "https://keys.openpgp.org/vks/v1/by-fingerprint/0A9AF2115F4687BD29803A206B73A36E6026DFCA" \
| sudo gpg --dearmor \
| sudo tee /usr/share/keyrings/com.rabbitmq.team.gpg > /dev/null

sudo tee /etc/apt/sources.list.d/rabbitmq.list <<EOF
deb [arch=amd64 signed-by=/usr/share/keyrings/com.rabbitmq.team.gpg] https://deb1.rabbitmq.com/rabbitmq-server/debian/trixie trixie main
deb [arch=amd64 signed-by=/usr/share/keyrings/com.rabbitmq.team.gpg] https://deb2.rabbitmq.com/rabbitmq-server/debian/trixie trixie main
EOF

sudo apt update
</pre>

==== Встановлення ====
Переконайтеся, що в /etc/hosts є запис для вашого hostname. Відсутність такого запису (наприклад, якщо ви змінили hostname після встановлення) є типовою помилкою під час встановлення RabbitMQ. Тому краще ще раз переконатися, що запис для hostname є.
<pre>
sudo apt install -y erlang-base \
erlang-asn1 erlang-crypto erlang-eldap erlang-ftp erlang-inets \
erlang-mnesia erlang-os-mon erlang-parsetools erlang-public-key \
erlang-runtime-tools erlang-snmp erlang-ssl \
erlang-syntax-tools erlang-tftp erlang-tools erlang-xmerl

sudo apt install rabbitmq-server -y --fix-missing
</pre>

==== Встановлення необхідних додатків ====
Наступні два рядки виконуйте по одному.
<pre>
sudo rabbitmq-plugins enable rabbitmq_management --offline

sudo rabbitmq-plugins enable rabbitmq_web_stomp --offline
</pre>

==== Налаштування ====
Скопіюйте та вставте такий блок повністю:
<pre>
sudo tee /etc/rabbitmq/rabbitmq.conf << EOF
listeners.tcp.default = 5672

consumer_timeout = 2400000

web_stomp.port = 15674
web_stomp.cowboy_opts.max_keepalive = 60
EOF
</pre>

Тепер потрібно створити користувачів. Ми рекомендуємо використовувати '''трьох різних користувачів''': для адміністрування сервера (повні права), для userside і модулів (повні права, але без адміністративних прав) і користувача web-stomp для websocket (мінімальні права на читання певних об'єктів брокера). Але можна створити лише двох: адміністратора, який також використовуватиметься для userside, і користувача для websocket. Обов'язково має бути щонайменше два різні користувачі, оскільки пароль користувача websocket передається в браузер і може бути легко прочитаний користувачем. Далі наведено приклад для рекомендованих трьох користувачів.

Створіть '''користувача для адміністрування''' RabbitMQ. У цьому прикладі використовується ім'я користувача '''admin''' і пароль '''admin_password'''.
Тег <code>administrator</code> призначається користувачу одразу після створення, надаючи максимальні адміністративні права, а потім задаються дозволи для vhost <code>/</code>, що дозволяють повний доступ до налаштування, запису й читання всього всередині цього vhost*.
<pre>
sudo rabbitmqctl add_user "admin" "admin_password"
sudo rabbitmqctl set_user_tags "admin" "administrator"
sudo rabbitmqctl set_permissions -p "/" "admin" ".*" ".*" ".*"
</pre>

Створіть '''користувача, від імені якого працюватимуть ERP USERSIDE''' і модулі. Приклад для імені користувача '''userside''' (адміністративні права цьому користувачу надавати не потрібно):
<pre>
sudo rabbitmqctl add_user "userside" "system_password"
sudo rabbitmqctl set_user_tags "userside" "monitoring"
sudo rabbitmqctl set_permissions -p "/" "userside" ".*" ".*" ".*"
</pre>

Створіть '''користувача WebSTOMP'''. Він знадобиться для використання сповіщень через WebSocket. Замість '''websock-user''' можна вказати інше ім'я користувача. Замість '''password_websocket''' вкажіть свій пароль, але цей пароль передаватиметься у відкритому вигляді в браузер, тому не робіть його схожим на інші паролі:
<pre>
sudo rabbitmqctl add_user "websock-user" "password_websocket"
sudo rabbitmqctl set_permissions -p "/" "websock-user" "^erp-stomp:id-.*" "" "^erp-stomp:id-.*"
</pre>

Увага: ім'я користувача та пароль WebSTOMP потрібно буде вказати в налаштуваннях інтерфейсу USERSIDE (Меню: Налаштування - Основні - Websocket).

''* vhost - це віртуальний хост у RabbitMQ, який дозволяє різним застосункам розмежовувати різні варіанти використання одного сервера. Так само, як, наприклад, різні бази даних на одному сервері СКБД. Типовий vhost має назву /, і майже завжди цього достатньо. Але якщо ви плануєте, наприклад, запускати кілька копій ERP USERSIDE на одному сервері, то для кожної копії потрібно створити окремий vhost і, відповідно, користувачів для нього. Докладніше див. [https://www.rabbitmq.com/vhosts.html в офіційному посібнику].''

Перезапустіть службу RabbitMQ:
<pre>
sudo systemctl restart rabbitmq-server
</pre>

==== Керування ====
Одна з команд вище встановлює модуль керування RabbitMQ, який надає зручний WEB-інтерфейс для моніторингу, діагностики та керування сервером RabbitMQ. За допомогою цього модуля можна стежити за сервером, кількістю повідомлень у чергах та іншими статусами. Усе це можна робити й за допомогою консольної утиліти <code>rabbitmqctl</code>, але WEB-інтерфейс може бути значно наочнішим і зручнішим.

За замовчуванням WEB-інтерфейс керування доступний за адресою http://userside.mycompany.com:15672. Ми рекомендуємо використовувати firewall для обмеження доступу до цього інтерфейсу керування.

Докладніше про модуль керування можна [https://www.rabbitmq.com/management.html прочитати на офіційному сайті RabbitMQ].

=== PHP ===
==== Альтернативний репозиторій ====
<pre>
sudo curl -sSLo /usr/share/keyrings/deb.sury.org-php.gpg https://packages.sury.org/php/apt.gpg
sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'
sudo apt update
</pre>

==== Встановлення ====
Виконайте такі команди:
<pre>
sudo apt install -y php8.4-{fpm,cli,common,curl,intl,mbstring,opcache,pgsql,readline,xml,zip,snmp,gd}
</pre>

Якщо ви плануєте використовувати LDAP, потрібно встановити розширення php-ldap:
<pre>
sudo apt install -y php8.4-ldap
</pre>

==== Налаштування ====
Нижче наведені команди, які вносять зміни до конфігураційних файлів.
<pre>
sudo sed -i "s@^;date.timezone.*@date.timezone = $(cat /etc/timezone)@" /etc/php/8.4/fpm/php.ini
sudo sed -i "s@^;date.timezone.*@date.timezone = $(cat /etc/timezone)@" /etc/php/8.4/cli/php.ini
sudo sed -i "s@;cgi.fix_pathinfo=1@cgi.fix_pathinfo=0@" /etc/php/8.4/fpm/php.ini
sudo sed -i "s@post_max_size = 8M@post_max_size = 100M@" /etc/php/8.4/fpm/php.ini
sudo sed -i "s@upload_max_filesize = 2M@upload_max_filesize = 100M@" /etc/php/8.4/fpm/php.ini
sudo sed -i "s@max_execution_time.*@max_execution_time = 300@" /etc/php/8.4/fpm/php.ini
sudo sed -i "s@^;request_terminate_timeout =.*@request_terminate_timeout = 300@" /etc/php/8.4/fpm/pool.d/www.conf

sudo systemctl restart php8.4-fpm
</pre>

=== NGINX ===
==== Альтернативний офіційний репозиторій ====
Версія NGINX, що постачається в репозиторії Debian, повністю придатна для використання, і додавати альтернативний репозиторій не потрібно. Однак якщо ви хочете завжди мати останню версію, виконайте такі рядки для додавання офіційного репозиторію nginx до вашої операційної системи:
<pre>
curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
| sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
http://nginx.org/packages/debian `lsb_release -cs` nginx" \
| sudo tee /etc/apt/sources.list.d/nginx.list
echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
| sudo tee /etc/apt/preferences.d/99nginx
sudo apt update
</pre>

Якщо у вас інша операційна система, необхідні команди для неї можна знайти на офіційному сайті NGINX: https://docs.nginx.com/nginx/admin-guide/installing-nginx/installing-nginx-open-source/

==== Встановлення ====
<pre>
sudo apt install -y nginx
</pre>

==== Налаштування ====
<pre>
sudo sed -i "s@^user.*;@user www-data www-data;@" "/etc/nginx/nginx.conf"
sudo systemctl restart nginx
</pre>

У наведеному нижче прикладі конфігурації передбачається, що ERP USERSIDE буде встановлена до типового системного каталогу <code>/var/www/userside</code>. Якщо ви хочете встановити ERP USERSIDE до іншого каталогу, не забудьте виправити це в усіх наступних прикладах. Щоб не помилитися, ми рекомендуємо використовувати саме каталог <code>/var/www/userside</code>.

Тепер відредагуйте файл /etc/nginx/conf.d/default.conf. Або видаліть його та створіть файл з назвою /etc/nginx/conf.d/userside.conf. У будь-якому разі, незалежно від вашого вибору, вміст файлу має бути таким (замість userside.mycompany.com вкажіть своє доменне ім'я):
<pre>
server {
listen 80 default_server;
server_name userside.mycompany.com;
charset utf-8;
client_max_body_size 100M;

access_log /var/log/nginx/userside-access.log;
error_log /var/log/nginx/userside-error.log;

root /var/www/userside/public;
index index.php;

location = /favicon.ico { access_log off; log_not_found off; }
location = /robots.txt { access_log off; log_not_found off; }

location / {
try_files $uri $uri/ /index.php$is_args$args;
}

location ~* ^.+\.(css|ogg|ogv|svg|svgz|eot|otf|woff|mp4|ttf|rss|atom|jpg|jpeg|gif|png|ico|zip|tgz|gz|rar|bz2|doc|xls|exe|ppt|tar|mid|midi|bmp|rtf)$ {
access_log off;
log_not_found off;
expires max;
add_header Pragma public;
add_header Cache-Control "public";
}

location ~ \.php$ {
try_files $uri =404;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/run/php/php8.4-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_read_timeout 300;
include fastcgi_params;
}

location /ws {
proxy_pass http://127.0.0.1:15674/ws;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
proxy_set_header Host $host;
}

location ~ /\.ht { deny all; }
}
</pre>

Також ви можете налаштувати SSL та інші параметри. Ця тема виходить за межі цієї інструкції.

Якщо RabbitMQ встановлений '''на іншому сервері''' або ви змінили значення порту WebSTOMP з 15674 на інше, вкажіть IP-адресу сервера з RabbitMQ і номер порту в рядку <code>proxy_pass http://127.0.0.1:15674/ws;</code>. Протокол має залишатися http. Шлях має залишатися /ws.

Перевірте конфігурацію та, якщо все гаразд, перезапустіть nginx:
sudo nginx -t && sudo nginx -s reload

=== Python ===
''Потрібен Python3 будь-якої версії, що підтримується на цей момент. Статус версій можна переглянути тут: "[https://devguide.python.org/versions/ Status of Python versions]". Рекомендується використовувати версію зі станом "security" або "bugfix". Версії, позначені як "end-of-life", не підтримуються. Версії, позначені як "feature", використовувати не рекомендується.''

Якщо на вашому хості встановлена непідтримувана версія ("end-of-life"), обов'язково [[Python-update_UK|встановіть додатково]] актуальнішу версію Python.

==== Встановлення потрібних пакетів ====
sudo apt install -y python3-dev python3-pip python3-venv libffi-dev pkg-config

=== Supervisor ===
sudo apt install -y supervisor

== Завантаження та запуск інсталятора ==

Також див.: [[Інсталятор|довідка з інсталятора]]

1. перейдіть до каталогу системи
cd /var/www/userside

2. завантажте скрипт інсталятора
curl -fsSL https://my.userside.eu/install.sh | sudo -u www-data bash

3. запустіть інсталятор
sudo -u www-data ./installer install

Під час роботи інсталятор перевіряє відповідність технічним вимогам, запитує параметри доступу та перевіряє підключення до серверних служб.

Ви можете ввести будь-який доступний вам номер версії ERP USERSIDE для встановлення. Для цього можна ввести номер версії зі списку (у ньому міститься лише остання версія кожної гілки) або ввести повний номер версії, якщо його немає у списку.

Після завершення роботи інсталятора буде показано повідомлення про успішне встановлення.

Якщо встановлення виконувалося не від імені користувача web-сервера, після завершення встановлення обов'язково зробіть цього користувача власником усіх файлів userside рекурсивно.

sudo chown -R www-data:www-data /var/www/userside

== Налаштування після встановлення ==

=== Налаштування системних служб ===
Після встановлення скопіюйте приклади конфігураційних файлів системних служб і за потреби налаштуйте їх (наприклад, вкажіть шлях до каталогу userside, якщо він відрізняється від /var/www/userside). Виконайте команди:
<pre>
sudo cp etc/us-core-worker.conf-example /etc/supervisor/conf.d/us-core-worker.conf
sudo cp microservice/poller/etc/usm_poller.conf-example /etc/supervisor/conf.d/usm_poller.conf
sudo cp etc/logrotate-example /etc/logrotate.d/userside
sudo cp microservice/poller/etc/logrotate-example /etc/logrotate.d/usm_poller
sudo cp etc/crontab-example /etc/cron.d/userside
</pre>

=== Встановлення необхідних залежностей для usm_poller ===
Створіть віртуальне середовище venv для Python і встановіть залежні модулі, як показано нижче:
<pre>
cd /var/www/userside/microservice/poller
sudo -H python3 -m venv venv
sudo -H venv/bin/pip install -U pip
sudo -H venv/bin/pip install -U -r requirements.txt
</pre>

=== Запуск supervisor ===
Supervisor контролює роботу служб, зазначених у його конфігурації. Щоб запустити supervisor, виконайте:
<pre>
sudo systemctl restart supervisor
</pre>
Після запуску supervisor за кілька секунд можна переглянути стан усіх служб, які він контролює. Усі служби мають бути в стані RUNNING:
<pre>
sudo supervisorctl status
</pre>

== Одразу після встановлення ==
На цьому встановлення ERP USERSIDE завершено. Тепер виконайте такі дії:
* Відкрийте сторінку системи '''<nowiki>http://userside.mydomain.com/</nowiki>''' і увійдіть ''(типовий логін: Admin, пароль: 1234)''.
* Налаштуйте Websocket у розділі: Налаштування - Основні - WebSocket. Увімкніть його та введіть ім'я користувача й пароль WebSTOMP-користувача, якого ви створили раніше в RabbitMQ.
* Виконайте основні налаштування в розділі: [[Налаштування_-_Основні|Налаштування - Основні]].
* Налаштуйте взаємодію з [[Підтримувані_білінги|білінгом]] згідно з [[Налаштування_взаємодії_з_білінгом|інструкцією]].
* Прочитайте інструкції на сторінці: [[Start_UK|З чого почати?]].
* Налаштуйте [[UserSide_API_Key_UK|API Key]].

== Оновлення системи ==
Ми намагаємося зробити все можливе, щоб наскрізне оновлення з будь-якої версії до останньої версії було успішним. Однак іноді через давні проблеми зі структурою бази даних, які раніше ніколи не заважали роботі, може виникнути ситуація, коли наскрізне оновлення неможливе. У такому випадку доведеться оновлюватися поетапно до кожної наступної останньої версії. Наприклад, з 3.14.80 спочатку до 3.15.60, потім до 3.16.39 і так далі.

Перед оновленням обов'язково прочитайте про всі зміни, які потрібно виконати для оновлення для кожної версії, що лежить між вашою поточною версією та тією, до якої ви збираєтеся оновитися.

Ми рекомендуємо зробити копію системи для безпечного проведення оновлення. Зверніться до розділу [[HOWTO: Клонування USERSIDE]]. Ви завжди можете видалити копію та почати спочатку. Це просто й безпечно. Але якщо ви хочете оновити робочу систему, виконуйте оновлення в моменти найменшого навантаження із запасом часу, потрібним для аварійного відновлення, якщо раптом щось піде не так. Завжди обов'язково робіть резервну копію бази даних і файлів перед оновленнями. Якщо оновлення буде перерване, особливо на етапі міграції даних, є ризик, що коректно відновити дані буде дуже непросто або навіть неможливо. Загалом відповідальність за наявність актуальної резервної копії повністю лежить на вас.

==== Процес оновлення ====
Ми наполегливо рекомендуємо виконувати тестові оновлення на [[HOWTO:_Клонування_USERSIDE|копії системи]].

Для проведення оновлення запустіть інсталятор у режимі install і дотримуйтесь інструкцій:
<pre>
cd /var/www/userside
sudo -u www-data ./installer install
</pre>

Після оновлення USERSIDE потрібно обов'язково оновити залежності usm_poller:
<pre>
cd /var/www/userside/microservice/poller
sudo -H venv/bin/pip install -U pip
sudo -H venv/bin/pip install -U -r requirements.txt
</pre>

Тепер потрібно перезапустити всі служби, які контролюються supervisor, і переконатися, що всі вони запустилися та перебувають у стані RUNNING:
<pre>
sudo supervisorctl restart all
sudo supervisorctl status
</pre>

== Обслуговування системи ==
Для підтримання системи в робочому стані та забезпечення її надійної роботи в майбутньому рекомендується виконувати кілька простих дій:
* періодично створювати резервну копію бази даних
* періодично створювати резервну копію завантажених файлів (це можна зробити, просто архівуючи каталог /var/www/userside/var/attachments і файл .env)
* періодично стежити за продуктивністю сервера (за допомогою htop, atop) і брокера RabbitMQ та приймати рішення щодо масштабування пулів fpm, фонових процесів ядра і мікросервісів

=== Резервне копіювання ===
Налаштуйте періодичне резервне копіювання бази даних і користувацьких файлів. Бажано мінімум раз на добу в моменти найменшого навантаження на сервер. У PostgreSQL існує два способи створити резервну копію бази даних: dump і sql-script. У кожного з них є свої переваги та недоліки. Перший створює безпечний дамп бази даних повністю, а другий створює SQL-скрипт, виконання якого дає змогу відновити як структуру, так і дані. Рекомендуємо звернутися до [https://www.postgresql.org/docs/current/app-pgdump.html документації з використання команди pg_dump] для вибору більш відповідного для вас способу або набору параметрів.

Нижче наведені дві команди для створення резервної копії бази даних - виберіть одну з них і додайте до вашого crontab:
<pre>
# SQL-script
sudo -u postgres pg_dump --no-acl -Fp -Z 5 userside > /backup/userside.sql.gz

# DUMP
sudo -u postgres pg_dump --no-acl -Fc userside > /backup/userside.dump
</pre>

Для створення мінімальної резервної копії '''файлів''' можна використати таку команду (для версії 3.15 і новіше):
sudo tar -czf /backup/userside.tgz .env common/config/settings.json var/attachments
Цих файлів разом із базою даних буде достатньо для відновлення роботи USERSIDE. Але для більшої надійності можна виконувати резервне копіювання всього каталогу /var/www/userside.

=== Відновлення з резервної копії ===
Для відновлення з дампа використовується команда pg_restore. [https://postgrespro.ru/docs/postgresql/13/app-pgrestore Документація з використання pg_restore]. Для відновлення з SQL-скрипта використовується утиліта psql. [https://www.postgresql.org/docs/current/app-psql.html Документація з використання psql].

Перед відновленням бази даних із резервної копії потрібно обов'язково зупинити роботу USERSIDE.

1. Зупинити cron userside і всіх модулів
<pre>
mkdir -p ~/cron
sudo mv /etc/cron.d/userside ~/cron
sudo mv /etc/cron.d/userside-modules ~/cron
</pre>
2. Зупинити роботу фонових служб
<pre>
sudo supervisorctl stop all
</pre>
3. Зупинити роботу php-fpm
<pre>
sudo systemctl stop php8.4-fpm
</pre>
Тільки після цього можна переходити до відновлення бази даних із резервної копії.

==== SQL-script ====
Для відновлення БД із резервної копії у вигляді SQL-скрипта спочатку потрібно пересоздати базу даних, а потім відновити резервну копію в порожню базу даних:
<pre>
sudo -u postgres dropdb userside
sudo -u postgres createdb -e -E "UTF-8" -l "uk_UA.UTF-8" -O userside -T template0 userside
sudo -u postgres psql -d userside -c "CREATE EXTENSION postgis"
gunzip < userside.sql.gz | sudo -u postgres psql -d userside -v ON_ERROR_STOP=1
</pre>

==== DUMP ====
Дамп містить базу даних повністю з усіма її елементами. Тому перед відновленням бази даних із дампа вона не повинна існувати на сервері - видаліть базу даних перед відновленням із дампа. Також важливо, щоб користувач бази даних (власник усіх елементів) уже існував - створіть його перед відновленням, якщо відновлюєте базу даних на новому сервері, де потрібного користувача ще немає.

Також зверніть увагу, що структура дампа може бути несумісною між різними версіями PostgreSQL. Це не обов'язково так, але цілком імовірно.

Для відновлення з дампа використовуйте команди:
<pre>
sudo -u postgres dropdb userside
sudo -u postgres pg_restore --clean --if-exists --create --exit-on-error --dbname=postgres userside.dump
</pre>
Зверніть увагу, що ім'я бази даних у команді обов'язково має бути '''postgres''', оскільки з дампа відновлюється вся база даних повністю, а не її вміст.

==== Після відновлення бази даних ====
Після відновлення бази даних будь-яким способом потрібно очистити кеш ERP USERSIDE, оскільки в кеші тепер містяться дані, відмінні від даних у базі. Перейдіть до каталогу /var/www/userside і виконайте команду очищення кешу (першу, якщо використовується пароль, або другу, якщо пароль не використовується):
<pre>
source /var/www/userside/.env && redis-cli -h $US_REDIS_HOST -p $US_REDIS_PORT -a $US_REDIS_PASSWORD -n $US_REDIS_DB FLUSHDB
source /var/www/userside/.env && redis-cli -h $US_REDIS_HOST -p $US_REDIS_PORT -n $US_REDIS_DB FLUSHDB
</pre>
Відновіть роботу служб, які були зупинені перед виконанням резервного копіювання:
<pre>
sudo mv ~/cron/* /etc/cron.d
sudo supervisorctl start all
sudo systemctl start php8.4-fpm
</pre>
Виконайте команду відновлення, щоб файли системи відповідали версії бази даних і щоб перевірити систему на цілісність файлів.
<pre>
cd /var/www/userside
sudo -u www-data ./installer repair
</pre>

Регламент технічної підтримки

2026-06-23T11:09:43Z

IronBot: [IronBot] Create UK localization from RU

[[Technical_support_regulations|en]] | '''uk''' | [[Регламент_технической_поддержки|ru]]

* Повідомлення про помилки та питання до технічної підтримки клієнти подають через портал https://my.userside.eu/ticket ''(далі - "Тікет-система")''

* Якщо звернення від клієнта надходить іншими каналами ''(пошта, дзвінки)'', клієнту буде запропоновано повторно подати його через "Тікет-систему"

* Не варто подавати різні питання в одному тікеті. Розв'язання таких тікетів може потребувати одночасної участі багатьох спеціалістів. Також можуть знадобитися уточнювальні питання. У підсумку тікет перетворюється на різнопланове спілкування на різні теми. Тому: один тікет - одне питання.

* Заявки служба технічної підтримки розглядає в будні дні з 9 до 18 ''(за винятком державних свят України)''. У неробочий час, вихідні та святкові дні заявки можуть розглядатися факультативно в черговому режимі

* Заявки можуть мати різний рівень складності, і від цього залежить час реагування на них. Можуть залучатися різні спеціалісти. Деякі питання можна розв'язати миттєво, деякі - не розв'язати й за тиждень. Жодна заявка не губиться, а завдяки "Тікет-системі" видно всю історію звернень від клієнтів

* Не розглядаються тікети від клієнтів, у яких закінчився оплачений строк технічної підтримки

* Першочергова увага надається повідомленням про помилки. Повідомлення зі звичайними питаннями до служби технічної підтримки розглядаються у другорядному порядку

* Тікети з консультаціями та повідомленнями про помилки приймаються тільки щодо останніх трьох версій ERP "UserSide" ''(на цей момент це версії '''3.19, 3.20 і 3.21''')''. У разі звернень щодо раніших версій питання клієнта по суті не розглядатиметься, і клієнту буде запропоновано оновитися до новішої версії

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

* Співробітники технічної підтримки ''(і розробники загалом)'' не мають доступу до систем ERP "UserSide" клієнта. У виняткових випадках, коли помилку або ситуацію неможливо повторити локально або потрібно розібратися з конкретною моделлю комутаційного обладнання, технічна підтримка може попросити тимчасовий доступ із конкретної IP-адреси до ERP "UserSide" клієнта. Після розв'язання питання клієнт має заблокувати наданий обліковий запис

* Не потрібно надавати співробітникам технічної підтримки доступ до ssh, ftp, баз даних тощо. Іноді технічна підтримка може попросити доступ до конкретного обладнання ''(комутатор, радіообладнання, OLT тощо)'' для дослідження або налагодження. Після розв'язання питання клієнт зобов'язаний закрити доступ до цього обладнання

* Клієнти можуть надсилати зауваження та пропозиції щодо роботи служби технічної підтримки на office@userside.eu

* Просимо поставитися з розумінням до того, що ми не навчаємо базового системного адміністрування та не надаємо технічну підтримку з усіх наявних IT-тем. Для цього у вас мають бути кваліфіковані співробітники

* '''Як ліричний відступ:''' під час кожного випуску оновлення ми докладаємо багато зусиль для тестування та налагодження програмного забезпечення. Ми не випускаємо оновлення з відомими нам помилками. Водночас клієнт нерідко може зіткнутися з очевидними ''(для нього)'' помилками, які проявилися тільки в нього ''(або в невеликої кількості інших клієнтів)''. Це може бути пов'язано з продуктивністю сервера, його налаштуваннями, версіями програмного забезпечення, а також зі специфікою використання функціональності системи - наявністю або відсутністю певних об'єктів, їх кількістю, порядком взаємодії та бізнес-процесами в компанії, особливостями географії та розташування об'єктів, моделями обладнання тощо. Ми не можемо об'єктивно протестувати такі речі. Тому пропонуємо ставитися до таких помилок і недоліків із розумінням. Програма постачається за загальноприйнятим принципом "AS IS", але ми обов'язково розглянемо кожне звернення клієнта та виправимо помилку, якщо вона підтвердиться.

Також див.: [[Пріоритетне обслуговування]]

Також див.: [[Послуги з встановлення або оновлення ERP|послуги зі встановлення або оновлення ERP]]

Також див.: [[FAQ._Чому_мої_заявки_на_доопрацювання_не_реалізовуються%3F|Чому мої заявки на доопрацювання не реалізовуються?]]

Technical support regulations

2026-06-23T11:09:40Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[Регламент_технічної_підтримки|uk]] | [[Регламент_технической_поддержки|ru]]

* Error reports and technical support questions are submitted by customers via the portal https://my.userside.eu/ticket ''(hereinafter referred to as the "Ticket System")''

* If the request from the customer comes through other channels ''(email, calls)'', the customer will be asked to resubmit it via the '' "Ticket System" ''

* You should not submit different questions in the same ticket. The resolution of such tickets may require the involvement of multiple specialists at the same time. It may also be required to have clarifying questions. As a result, the ticket turns into a variegated mess of communication on a variety of topics. Therefore: one ticket - one question

* Applications are resolved on weekdays from 9-18 ''(excluding public holidays in Ukraine)''. Outside working hours, weekends and public holidays, applications may be handled on an optional standby basis

* Requests can have varying levels of complexity and the response time depends on this. Different specialists may be involved. Some can be resolved instantly, some may not be resolved in a week. No one request is lost and due to the "Ticket System" the entire history of customer enquirers is visible

* Tickets from customers who have reached the end of their paid support period are not considered

* Priority is given to error reports. Messages with common questions to the technical support team are dealt with in a secondary order

* Only the last three versions of ERP "UserSide" (currently '''3.19''', '''3.20''' and '''3.21''') will be accepted for consultation and error reports. In case of queries on earlier versions, the merits of the customer's question will not be considered and the customer will be asked to upgrade to a more recent version

* Messages requesting improvements to the system are gratefully received and we will include them in our plans for development. However please take into account that the product is being finalized at our discretion and we are not under any obligation to do so. We summarize all customer requests, identify the most common, popular and interesting in our view, and implement them as far as possible

* The technical support staff ''(and developers in general)'' do not have access to ERP "UserSide" customer's systems. In exceptional cases, where an error or situation cannot be repeated locally or a specific model of switch equipment needs to be sorted out, technical support may request temporary access from a specific IP to the customer`s ERP "UserSide". Once the issue has been resolved, the customer is required to block the account provided

* There is no need to give technical support staff access to ssh, ftp, databases etc. Sometimes the technical support staff may request access to a specific equipment ''(switch, radio equipment, olt, etc.)'' for research or debugging purposes. Once the issue has been resolved, the customer is obliged to close access to this equipment

* Customers can send comments and suggestions on the technical support service to office@userside.eu

* Please be understanding, that we do not teach basic system administration or provide technical support on all existing IT topics. You must have qualified staff to do this

* '''As a lyrical digression:''' we put quite a lot of effort into testing and debugging the software each time an update is released. We do not release updates with bugs that we know about. However, very often a customer may encounter obvious ''(to them)'' errors that only they ''(or a small number of other customers)'' have experienced. This may be related to the server performance, it's settings, software versions, as well as to the specifics of using the software functionality - such as the presence or absence of any objects, their number, the order of interaction and business processes within the company, the peculiarities of geography and location of objects, equipment models, etc. We cannot objectively test such things. Therefore we suggest that such errors and deficiencies should be treated with understanding. The program is delivered according to the generally accepted "AS IS" principle, but we will be sure to examine each customer request and correct the error if it is confirmed.

See also: [[Priority service]]

See also: [[ERP_installation_or_upgrade_service|ERP installation or upgrade service]]

See also: [[FAQ._Why_are_my_revision_tickets_not_being_implemented%3F|Why are my revision tickets not being implemented?]]

Регламент технической поддержки

2026-06-23T11:09:27Z

IronBot: [IronBot] Repair localization links

[[Technical_support_regulations|en]] | [[Регламент_технічної_підтримки|uk]] | '''ru'''

* Сообщения об ошибках и вопросы по технической поддержке клиенты подают через портал https://my.userside.eu/ticket ''(далее - "Тикет-система")''

* Если обращение от клиента поступает по другим каналам ''(почта, звонки)'', то клиенту будет предложено переподать его через "Тикет-систему"

* Не стоит в одном тикете подавать разные вопросы. Решение подобных тикетов может потребовать участия одновременно множества специалистов. Могут также потребоваться уточняющие вопросы. В итоге тикет превращается в разноплановый винегрет общения на разную тематику. Поэтому: один тикет - один вопрос.

* Поступившие заявки служба технической поддержки решает в будние дни с 9-18 ''(за исключением государственных праздников Украины)''. В нерабочее время, в выходные и праздничные дни рассмотрение заявок может осуществляться факультативно в дежурном режиме

* Заявки могут иметь различный уровень сложности и от этого зависит время реагирования на них. Могут быть задействованы разные специалисты. Некоторые можно решить моментально, некоторые не решить и за неделю. Ни одна заявка не теряется и благодаря "Тикет-системе" видна вся история обращений от клиентов

* Не рассматриваются тикеты от клиентов у которых окончился оплаченный срок технической поддержки

* Первоочередное внимание оказывается сообщениям об ошибках. Сообщения с обычными вопросами к службе тех.поддержки решаются во второстепенном порядке

* Тикеты с консультациями и сообщения об ошибках принимаются только по последним трём версиям ERP "UserSide" ''(на данный момент это версии '''3.19, 3.20 и 3.21''')''. В случае обращений по более ранним версиям вопрос клиента по существу рассматриваться не будет и клиенту будет предложено обновиться на более свежую версию

* Сообщения с просьбами о доработке системы принимаются с благодарностью и мы их фиксируем в планы на доработку. Стоит, однако, учитывать, что доработка продукта ведётся по нашему усмотрению и мы не несём каких-то обязательств по этому поводу. Мы обобщаем все пожелания клиентов, вычленяем самые массовые, востребованные и интересные на наш взгляд, и реализуем их по мере возможности.

* У сотрудников технической поддержки ''(и у разработчиков в целом)'' нет доступа к клиентским системам ERP "UserSide". Они установлены на серверах у клиентов и только клиенты регулируют доступ в программу. В исключительных случаях, когда ошибку или ситуацию не удаётся повторить локально или требуется разобраться в работе конкретной модели коммутационного оборудования, техническая поддержка может запросить временный доступ с конкретного IP в клиентскую ERP "UserSide". После решения вопроса клиент обязан заблокировать предоставленную учётную запись.

* Не нужно предоставлять сотрудникам технической поддержки доступ к ssh, ftp, базам данных и т.п. Иногда сотрудник тех.поддержки может запросить пробросить доступ к какому-то конкретному оборудованию ''(коммутатор, радиооборудование, olt и т.п.)'' для проведения исследований или отладки. После решения вопроса клиент обязан закрыть доступ к этому оборудованию.

* Замечания и предложения по работе службы технической поддержки клиент может прислать по адресу office@userside.eu

* Просим отнестись с пониманием, что мы не обучаем основам системного администрирования и не оказываем техническую поддержку по всем существующим в IT темам. Для этого у вас должен быть квалифицированный персонал.

* '''В качестве лирического отступления:''' мы прикладываем достаточно много усилий для тестирования и отладки программы при каждом выпуске обновления. Мы не выпускаем обновления в которых есть ошибки о которых мы знаем. Однако очень часто клиент может столкнуться с очевидными ''(для него)'' ошибками, которые проявляются только у него ''(либо у незначительного количества иных клиентов)''. Это может быть связано как с производительностью сервера, его настройками, версиями программного обеспечения так и с особенностями использования функционала программы - как-то наличия/отсутствия каких-то объектов, их количества, порядка взаимодействия и бизнес-процессов внутри компании, особенностям географии и размещения объектов, моделей оборудования и т.п. Подобные вещи мы объективно не можем оттестировать. Поэтому предлагаем относиться к таким ошибкам и недоработкам с пониманием. Программа поставляется по общепринятому принципу "AS IS", но мы обязательно изучим каждое клиентское обращение и исправим ошибку, если она подтвердится.

см. также: [[Приоритетное обслуживание]]

см. также: [[Услуга по установке или обновлению ERP]]

см. также: [[FAQ. Почему мои тикеты на доработку не выполняются|Почему мои тикеты на доработку не выполняются]]

Оновлення

2026-06-23T11:09:14Z

IronBot: [IronBot] Create UK localization from RU

[[Upgrade|en]] | '''uk''' | [[Обновление|ru]]

'''УВАГА: ця інструкція актуальна для версій ERP "UserSide" 3.10 і вище. Для версій нижче 3.10 використовуйте окрему інструкцію з [[Оновлення_для_версії_3.10_і_раніших|оновлення]].

Особливості оновлення версії 3.11: [[Оновлення 3.11|переглянути]]
Особливості оновлення версії 3.12: [[Оновлення 3.12|переглянути]]
Особливості оновлення версії 3.13: [[Оновлення 3.13|переглянути]]
Особливості оновлення версії 3.14: [[Оновлення 3.14|переглянути]]
Особливості оновлення версії 3.15: [[Оновлення 3.15|переглянути]]
Особливості оновлення версії 3.16: [[Оновлення 3.16|переглянути]]
Особливості оновлення версії 3.17: [[Оновлення 3.17|переглянути]]
Особливості оновлення версії 3.18: [[Оновлення 3.18|переглянути]]
Особливості оновлення версії 3.19: [[Оновлення 3.19|переглянути]]
Особливості оновлення версії 3.20: [[Оновлення 3.20|переглянути]]
Особливості оновлення версії 3.21: [[Оновлення 3.21|переглянути]]

'''Ми рекомендуємо''' мати два інстанси системи: окремо робочий і окремо тестовий. На тестовому інстансі ви можете періодично оновлювати базу даних із робочої системи та виконувати оновлення, переконуватися, що все працює, ознайомлюватися з нововведеннями або виявляти моменти, які перестали працювати.

З інструкцією зі створення копії робочої системи для тестування нової версії або інших досліджень можна ознайомитися в розділі [[HOWTO: Клонування USERSIDE]].

== Підготовчі роботи ==

1) Перед оновленням робочої копії обов'язково зробіть резервну копію бази даних, каталогу програми та всіх модулів. Ви відповідаєте за збереження своїх даних.

2) Вимкніть усі модулі ERP "UserSide" у системному cron і зупиніть усі постійно запущені модулі, які працюють із базою даних Userside, на час оновлення.

== Оновлення ==

Також див.: [[Інсталятор|довідка з інсталятора]]

1) Перейдіть до каталогу системи ''(/var/www/userside)''

2) Запустіть інсталятор із командою ''install''

sudo -u www-data php userside_install.phar install

Під час роботи інсталятор перевіряє відповідність технічним вимогам і ставить питання, пов'язані з оновленням.

Під час виконання інсталятор запропонує вибрати версію, до якої потрібно оновитися. Це може бути версія з запропонованого списку (можна ввести порядковий номер зі списку) або будь-яка інша версія (можна ввести номер версії, наприклад 3.15.4).

Після завершення оновлення буде показано відповідне повідомлення.

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

sudo -u www-data php userside_install.phar repair

Якщо проблему не вдається розв'язати самостійно, створіть звернення до [[Регламент технічної підтримки|технічної підтримки]].

4) За потреби оновіть модулі сімейства UserSide новими файлами на всіх машинах, де вони працюють.

5) Відновіть раніше вимкнені модулі ERP "UserSide" у системному cron і запустіть постійно працюючі служби Userside, якщо вони використовуються.

Upgrade

2026-06-23T11:09:11Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[Оновлення|uk]] | [[Обновление|ru]]

'''ATTENTION: These instructions are valid for ERP "UserSide" version 3.10 and higher. For versions below 3.10 - use separate instructions for [[Upgrade|upgrade]].

Specifics of the version 3.11 upgrade: [[Upgrade 3.11|view]]
Specifics of the version 3.12 upgrade: [[Upgrade 3.12|view]]
Specifics of the version 3.13 upgrade: [[Upgrade 3.13|view]]
Specifics of the version 3.14 upgrade: [[Upgrade 3.14|view]]
Specifics of the version 3.15 upgrade: [[Upgrade 3.15|view]]
Specifics of the version 3.16 upgrade: [[Upgrade 3.16|view]]
Specifics of the version 3.17 upgrade: [[Upgrade 3.17|view]]
Specifics of the version 3.18 upgrade: [[Upgrade 3.18|view]]
Specifics of the version 3.19 upgrade: [[Upgrade 3.19|view]]
Specifics of the version 3.20 upgrade: [[Upgrade 3.20|view]]
Specifics of the version 3.21 upgrade: [[Upgrade 3.21|view]]

'''We recommend''' having two instances of the system. A separate production instance and a test instance. On the test instance, you can periodically update the database from the production system and perform upgrades to make sure everything is working, check new features, or identify things that are not working for you.

Instructions on how to create a copy of a working system for testing a new version or other research can be found in [[HOWTO: USERSIDE cloning]].

== Preparation work ==

1) Be sure to back up the database, the programme directory and all modules before upgrading the working copy! You are responsible for the safety of your data!

2) Disable all ERP "UserSide" modules in the system cron and stop all ongoing modules working with the Userside database during the upgrade

== Upgrade ==

See also: [[Installer|Installer help]]

1) Navigate to the system directory ''(/var/www/userside)''

2) Run the installer with the ''install'' command

sudo -u www-data php userside_install.phar install

In the work process, the installer checks for compliance with technical requirements and asks questions related to the upgrade.

During runtime, the installer will suggest you select the version to which you want to upgrade. It can be a version from a provided list (you can enter a serial number from the list) or any other version (you can enter a version number, e.g. 3.15.4).

A message will be displayed when the upgrade is completed.

If the installer is interrupted for any reason (data migration error or other), run the installer with the repair command

sudo -u www-data php userside_install.phar repair

If the problem cannot be solved by yourself, submit a ticket to [[Technical_support_regulations|Technical support]].

4) if necessary, upgrade the UserSide family modules with new files on all machines where they are running

5) restore the previously disabled ERP "UserSide" modules in the system cron, and start the permanently running Userside services, if any

Обновление

2026-06-23T11:08:58Z

IronBot: [IronBot] Repair localization links

[[Upgrade|en]] | [[Оновлення|uk]] | '''ru'''

'''ВНИМАНИЕ: Данная инструкция актуальна для версий ERP "UserSide" 3.10 и выше. Для версии ниже 3.10 - используйте отдельную инструкцию по [[Обновление_для_версии_3.10_и_более_ранних|обновлению]].

Особенности обновления версии 3.11: [[Обновление 3.11|просмотреть]]
Особенности обновления версии 3.12: [[Обновление 3.12|просмотреть]]
Особенности обновления версии 3.13: [[Обновление 3.13|просмотреть]]
Особенности обновления версии 3.14: [[Обновление 3.14|просмотреть]]
Особенности обновления версии 3.15: [[Обновление 3.15|просмотреть]]
Особенности обновления версии 3.16: [[Обновление 3.16|просмотреть]]
Особенности обновления версии 3.17: [[Обновление 3.17|просмотреть]]
Особенности обновления версии 3.18: [[Обновление 3.18|просмотреть]]
Особенности обновления версии 3.19: [[Обновление 3.19|просмотреть]]
Особенности обновления версии 3.20: [[Обновление 3.20|просмотреть]]
Особенности обновления версии 3.21: [[Обновление 3.21|просмотреть]]

'''Мы рекомендуем''' иметь два инстанса системы. Отдельно действующую и отдельно тестовую. На тестовой вы можете периодически обновлять базу данных с действующей системы и проводить обновление, убеждаясь, что всё работает, ознакамливаться с нововведениями или выявлять моменты, которые у вас перестали работать.

С инструкцией по созданию копии рабочей системы для проведения тестирования новой версии или других исследований можно ознакомиться в разделе [[HOWTO: Клонирование USERSIDE]].

== Подготовительные работы ==

1) Перед началом обновления рабочей копии обязательно сделайте резервную копию базы данных, каталога с программой и всех модулей! За сохранность ваших данных отвечаете только вы сами!

2) На время обновления отключите работу всех модулей ERP "UserSide" в системном cron и остановите все постоянно функционирующие модули, работающие с БД Userside

== Обновление ==

См. также: [[Инсталлятор|Справку по инсталлятору]]

1) перейти в каталог системы ''(/var/www/userside)''

2) запустить инсталлятор с командой '''install'''

sudo -u www-data php userside_install.phar install

В процессе работы инсталлятор проверяет соответствие техническим требованиям и задаёт сопутствующие обновлению вопросы.

Во время работы инсталлятор предложит выбрать версию, на которую необходимо произвести обновление. Это может быть версия из предложенного списка (можно ввести порядковый номер из списка) либо же любая другая версия (можно ввести номер версии, например, 3.15.4).

По окончанию обновления будет выдано соответствующее сообщение.

Если работа инсталлятора будет прервана по какой-то причине (возникла ошибка миграции данных или другая), то следует запустить инсталлятор с командой repair

sudo -u www-data php userside_install.phar repair

Если проблему не удается решить самостоятельно - подайте тикет в [[Регламент технической поддержки|техническую поддержку]]

4) при необходимости обновить модули семейства UserSide новыми файлами на всех машинах, где они работают

5) восстановить работу ранее отключенных модулей ERP "UserSide" в системном cron, а также запустить постоянно работающие службы Userside, если таковы имеются

Python-update UK

2026-06-23T11:08:45Z

IronBot: [IronBot] Create UK localization from RU

[[Python-update_EN|en]] | '''uk''' | [[Python-update|ru]]

Якщо версія Python, встановлена у вашій ОС, не підтримується модулями або poller, потрібно додатково встановити нову версію Python, яка відповідає всім вимогам.

Важливо: змінювати системну версію Python на нову не рекомендується. Єдиний правильний спосіб - встановити нову версію паралельно із системною. Інакше можуть перестати працювати різні системні служби та утиліти, які використовують Python.

Спочатку переконайтеся, що встановлені всі необхідні глобальні пакети Python, потрібні для запуску віртуального середовища та збирання інших залежностей.

sudo apt install -y python3-dev python3-pip python3-venv pkg-config libffi-dev libssl-dev zlib1g-dev zlibc

Після встановлення перейдіть на сайт https://www.python.org/downloads/source/ і скопіюйте номер останньої версії поточної гілки або попередньої, якщо поточна гілка занадто свіжа. Наприклад, якщо остання версія 3.14.1, надійніше встановити версію 3.13.13, оскільки одразу після виходу нової версії (3.14) є ймовірність, що не всі залежні пакети її підтримують.

Далі створіть тимчасову змінну середовища, значення якої міститиме номер версії Python, яку ви збираєтеся встановити.

PY_VER=3.13.13

Нижче наведені команди, які потрібно виконувати по одній, послідовно, щоб контролювати процес і в разі помилки не виконувати решту команд. Копіюйте та виконуйте по одному рядку:
curl -o python.tgz "https://www.python.org/ftp/python/${PY_VER}/Python-${PY_VER}.tgz"
tar xzf python.tgz
cd Python-${PY_VER}
./configure --enable-optimizations
make -j $(nproc)
sudo -H make altinstall
curl -sS https://bootstrap.pypa.io/get-pip.py | sudo -H python3.13
cd ..
sudo rm -rf Python-${PY_VER} python.tgz

Після виконання цих дій у системі буде встановлена ще одна версія Python. У цьому прикладі це Python 3.13, а інструмент pip також матиме версію 3.13. Системна версія Python не зміниться, і ми не рекомендуємо її змінювати, оскільки від неї можуть залежати деякі системні компоненти.

Щоб використовувати саме цю версію Python і pip, потрібно вказувати повні назви файлів, які запускаються. Наприклад:
python3.13 --version
pip3.13 --version

Тепер для створення віртуального середовища для будь-якого модуля або poller потрібно використовувати такий синтаксис:
sudo python3.13 -m venv venv
sudo venv/bin/pip install -U pip wheel
і так далі.

Python-update EN

2026-06-23T11:08:33Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[Python-update_UK|uk]] | [[Python-update|ru]]

If the version of Python installed on your OS is not supported by modules or poller, you must install an additional new version of Python that meets all requirements.

Important: Changing the system version of Python to the new version is not recommended! The only correct way is to install the new version in parallel with the system version. Otherwise, various system services and utilities that use Python may stop working.

First make sure you have all the necessary global packages installed in Python, which are needed globally to run the virtual environment, to build other dependencies.

sudo apt install -y python3-dev python3-pip python3-venv pkg-config libffi-dev libssl-dev zlib1g-dev zlibc

Once everything is installed, go to https://www.python.org/downloads/source/ and copy the latest version number of the current branch, or the previous version if the current branch is too recent. For example, if the latest version is 3.14.1, it is more reliable to install version 3.13.13, because as soon as a new version (3.14) is released, there is a chance that not all dependent packages support it.

Next, you need to create a temporary environment variable whose value will contain the version number of the Python version you are going to install.

PY_VER=3.13.13

The following are commands that you simply execute one at a time, one after the other, to control the process and in case of error not to execute the rest of the commands. Copy one line at a time and execute:
curl -o python.tgz "https://www.python.org/ftp/python/${PY_VER}/Python-${PY_VER}.tgz"
tar xzf python.tgz
cd Python-${PY_VER}
./configure --enable-optimizations
make -j $(nproc)
sudo -H make altinstall
curl -sS https://bootstrap.pypa.io/get-pip.py | sudo -H python3.13
cd ..
sudo rm -rf Python-${PY_VER} python.tgz

After performing all these steps, you will have another version of Python installed on your system. In this case it is Python 3.13 and the pip tool is also version 3.13. The system version of Python will not be changed and we do not recommend changing it, as some system components may be dependent on it.

To use this particular version of python and pip, you need to specify the entire names of the files you run. For example:
python3.13 --version
pip3.13 --version

Now, to create a virtual environment for any module or poller, you need to use the following syntax:
sudo python3.13 -m venv venv
sudo venv/bin/pip install -U pip wheel
and so on.

Python-update

2026-06-23T11:08:30Z

IronBot: [IronBot] Repair localization links

[[Python-update_EN|en]] | [[Python-update_UK|uk]] | '''ru'''

Если версия Python, установленная на вашей ОС, не поддерживается модулями или поллером, то необходимо установить дополнительно новую версию Python, удовлетворяющую всем требованиям.

Важно: Изменять системную версию Python на новую - не рекомендуется! Единственный правильный способ - это установить новую версию параллельно системной. Иначе могут перестать работать различные системные службы и утилиты, использующие Python.

Сначала убедитесь, что у вас установлены все необходимые глобальные пакеты в Python, которые необходимы глобально для запуска виртуального окружения, для сборки других зависимостей.

sudo apt install -y python3-dev python3-pip python3-venv pkg-config libffi-dev libssl-dev zlib1g-dev zlibc

После того, как все установлено, зайдите на сайт https://www.python.org/downloads/source/ и скопируйте номер последней версии текущей ветки или предыдущей, если текущая ветка слишком свежая. Например, если последняя версия 3.14.1, то надежней все таки установить версию 3.13.13, т.к. сразу после выхода новой версии (3.14) есть вероятность того, что не все зависимые пакеты ее поддерживают.

Далее вам нужно создать временную переменную окружения, значение которой будет содержать номер версии Python, которую вы собираетесь установить.

PY_VER=3.13.13

Далее приведены команды, которые вы просто выполняете по одной, одну за другой, чтобы контролировать процесс и в случае ошибки не выполнять остальные команды. Копируйте по одной строке и выполняйте:
curl -o python.tgz "https://www.python.org/ftp/python/${PY_VER}/Python-${PY_VER}.tgz"
tar xzf python.tgz
cd Python-${PY_VER}
./configure --enable-optimizations
make -j $(nproc)
sudo -H make altinstall
curl -sS https://bootstrap.pypa.io/get-pip.py | sudo -H python3.13
cd ..
sudo rm -rf Python-${PY_VER} python.tgz

После выполнения всех этих действий у вас в системе будет установлена дополнительно еще одна версия Python. В данном случае это Python 3.13 а также инструмент pip тоже с версией 3.13. Системная версия Python изменена не будет и мы не рекомендуем ее изменять, так как некоторые системные компоненты могут быть зависимы от нее.

Чтобы использовать именно эту версию python и pip, вам нужно указывать целиком имена файлов, которые вы запускаете. Например:
python3.13 --version
pip3.13 --version

Теперь, чтобы создать виртуальное окружение для какого-либо модуля либо поллера, вам нужно использовать следующий синтаксис:
sudo python3.13 -m venv venv
sudo venv/bin/pip install -U pip wheel
и т.д.

Версії 3.21

2026-06-23T11:08:17Z

IronBot: [IronBot] Sync UK localization from RU

[[Versions_3.21_EN|en]] | '''uk''' | [[Версии_3.21|ru]]

Версії гілки [[3.21_UK|3.21]]

Див. також: [[Версії_ERP_"USERSIDE"|Версії ERP "USERSIDE"]]

== 3.21.0 - 23.06.2026 ==
* Реліз версії

== 3.21.0-beta.7 - 21.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.6 - 20.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.5 - 17.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.4 - 13.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.3 - 07.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.2 - 30.05.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.1 - 24.05.2026 ==
* Перелік змін див. у [[3.21_UK|3.21]]

Versions 3.21 EN

2026-06-23T11:08:03Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[Версії_3.21|uk]] | [[Версии_3.21|ru]]

Versions of the [[3.21_EN|3.21]] branch

Also see: [[Versions_of_ERP_"USERSIDE"|ERP "USERSIDE" versions]]

== 3.21.0 - 23.06.2026 ==
* Version release

== 3.21.0-beta.7 - 21.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.6 - 20.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.5 - 17.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.4 - 13.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.3 - 07.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.2 - 30.05.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.1 - 24.05.2026 ==
* See the list of changes in [[3.21_EN|3.21]]

Модулі

2026-06-23T11:08:01Z

IronBot: [IronBot] Sync UK localization from RU

[[Modules_EN|en]] | '''uk''' | [[Модули|ru]]

Модулі ERP "UserSide" поділяються на внутрішні та зовнішні. Зовнішні модулі - це окремі скрипти або програми, які можуть працювати віддалено від основної системи за наявності підключення до бази даних системи. Внутрішні модулі вже вбудовані в систему та можуть вмикатися або вимикатися в розділі "[[Налаштування - Модулі]]".

Часті запитання щодо модулів зібрані у відповідному розділі "[[Часті питання]]".

== Встановлення модулів. Загальна інформація для всіх модулів ==

1. Для кожного модуля виділіть окремий каталог.

2. Під час роботи всі модулі ведуть журнали роботи. Шлях до каталогу з журналами вказується у файлі конфігурації. Настійно рекомендується створювати окремий каталог журналів для кожного модуля. Не забудьте надати цьому каталогу права на запис.

3. Модулі, як правило, призначені для постійної роботи. Їх потрібно додати до системного cron з періодичністю запуску 5-15 хвилин ''(залежно від навантаження)''. Під час першого запуску рекомендується запустити модуль вручну із системної консолі та переконатися, що помилок немає, а дані імпортуються або обробляються коректно.

== Загальна інформація для модулів взаємодії з білінгами ==

1. Адреса абонента обробляється та фіксується у вбудованій в ERP "UserSide" системі обліку [[Адресна система|адрес]]. Якщо потрібного будинку немає в ERP "UserSide", його буде створено. Якщо будинок уже існує та був доданий у систему не засобами модуля, він однаково буде коректно оброблений і прив'язаний до абонентів.

2. Якщо абонент є в ERP "UserSide", але не знайдений у білінгу, він не видаляється з ERP "UserSide", а позначається статусом "[[Статус абонентів|немає в білінгу]]". Це зроблено з міркувань безпеки: інакше в разі збою оновлення всі абоненти можуть бути видалені, оскільки не будуть знайдені в білінгу.

3. Якщо в абонента [[Активність|дата активності в інтернеті]] пізніша за дату активності в мережі, дата активності в мережі прирівнюється до дати активності в інтернеті.

4. Під час оновлення даних із білінгу оновлюються не всі дані абонента. Наприклад, ПІБ, адреса та телефон можуть залишатися без змін. Завантаження таких даних можна ввімкнути в розділі "[[Налаштування - Білінги]]" для потрібного білінгу.

== Короткий опис модулів ==

Детальний опис наведений на сторінці кожного модуля.

[[usm_billing_UK|usm_billing]] імпортує до USERSIDE інформацію про абонентів, адреси, тарифні плани тощо з білінгу. Також можлива підтримка власного самописного білінгу. На базі цього модуля створені окремі модулі для стандартних білінгів: [[usm_abills_UK|usm_abills]], [[usm_bgbilling_UK|usm_bgbilling]], [[usm_hydra_UK|usm_hydra]], [[usm_lanbilling_UK|usm_lanbilling]], [[usm_nodeny_UK|usm_nodeny]], [[usm_nodeny_plus_UK|usm_nodeny_plus]], [[usm_utm5_UK|usm_utm5]].

[[usm_asterisk_UK|usm_asterisk]] взаємодіє з телефонією Asterisk. Коли надходить дзвінок, модуль миттєво ''(ще до підняття слухавки)'' показує на екрані оператора номер телефону абонента, що телефонує. Якщо цей номер належить абоненту, відображається інформація про нього ''(ПІБ, баланс, адреса, тарифний план, дата останньої активності тощо)''. Якщо номер належить співробітнику, це буде вказано. Якщо номер невідомий, буде запропоновано створити картку потенційного абонента.

[[usm_cabletest_UK|usm_cabletest]] '''періодично''' опитує комутатори та отримує з них інформацію кабельного тестера про довжину підключених мідних кабелів. Перелік підтримуваних моделей комутаторів наведений на сторінці модуля.

[[usm_checker_UK|usm_checker]] '''періодично''' опитує ''(багатопотоково пінгує)'' активне мережеве обладнання або абонентські пристрої, щоб визначити, яке обладнання активне, а яке недоступне ''(або які абоненти перестали бути активними)''.

[[usm_gps 2_UK|usm_gps]] приймає інформацію від апаратних і програмних GPS-трекерів для відображення місцезнаходження автотранспорту та співробітників на карті покриття. Дає змогу зрозуміти, хто найближче до аварії, бачити, хто коли й де рухався, а також фіксувати порушення швидкісного режиму автотранспорту тощо. Список підтримуваних протоколів трекерів наведений на сторінці модуля.

[[usm_iferr_UK|usm_iferr]] '''періодично''' опитує ''(через SNMP)'' лічильники помилок на інтерфейсах обладнання. Це дає змогу бачити пристрої з помилками на інтерфейсах як у розрізі інтерфейсів, так і за кількістю проблемних інтерфейсів на кожному пристрої. Також будується дельта приросту помилок за добу та за тиждень, що дає змогу бачити пристрої, на яких проблеми тривають просто зараз.

[[usm_observer_UK|usm_observer]] '''періодично''' опитує ''(через SNMP)'' будь-яке обладнання за будь-якими параметрами та сповіщає ''(поштою, SMS тощо)'' про зміну параметрів або вихід параметрів за межі. Дає змогу гнучко налаштувати моніторинг будь-яких пристроїв: згас порт з певним номером, спрацював датчик сигналізації, почалася робота від акумуляторів, у принтері закінчився папір тощо.

[[usm_peleng_UK|usm_peleng]] '''періодично''' опитує комутатори, отримує з них FDB-таблицю та накопичує інформацію про MAC-адреси в розрізі обладнання і його портів. Дає змогу виявляти факти кілець, флуду на портах і вірусів, а також допомагає знаходити підміну MAC-адрес. Можна виключати з відображення UPLINK/DOWNLINK-порти тощо. За MAC-адресою з USERSIDE підтягується інформація про абонента або пристрій.

[[usm_pon_UK|usm_pon]] '''періодично''' [[PON_UK|опитує OLT]], отримує та накопичує інформацію про підключені ONU: рівень сигналу, відстань до OLT, модель, вендор, опис, MAC, ID тощо. Також зберігається історія зміни рівня сигналу в розрізі ONU. За MAC-адресою або ID ONU з USERSIDE підтягується інформація про абонента.

[[usm_radio_UK|usm_radio]] '''періодично''' [[Радіо|опитує радіообладнання]] та отримує список підключених радіоабонентів: рівень сигналу, MAC-адресу, швидкість з'єднання тощо. Перелік підтримуваних вендорів наведений на сторінці модуля. За MAC-адресою з USERSIDE підтягується інформація про абонента або пристрій.

[[usm_stat_UK|usm_stat]] '''періодично''' запускається та фіксує в базі факт [[Активність|активності]] абонентів на момент запуску. Це дає змогу надалі бачити по кожному абоненту, у які дні та години він був активним у мережі. Також фіксується загальна кількість активних абонентів на момент запуску модуля.

Modules EN

2026-06-23T11:07:47Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[Модулі|uk]] | [[Модули|ru]]

ERP "UserSide" modules are divided into internal and external modules. External modules are separate scripts or programs that can run remotely from the main system, provided they have a connection to the system database. Internal modules are built into the system and can be enabled or disabled in the "[[Settings - Modules]]" section.

Frequently asked questions about modules are collected in the "[[Frequently_Asked_Questions|Frequently Asked Questions]]" section.

== Installing modules. General information for all modules ==

1. Allocate a separate directory for each module.

2. During operation, all modules write logs. The log directory path is specified in the configuration file. It is strongly recommended to create a separate log directory for each module. Do not forget to grant write permissions for this directory.

3. Modules are usually intended for continuous operation. Add them to the system cron with a 5-15 minute run interval ''(depending on the load)''. On the first start, run the module manually from the system console and make sure there are no errors and the data is imported or processed correctly.

== General information for billing integration modules ==

1. The customer address is processed and recorded in the [[Address System|address accounting system]] built into ERP "UserSide". If the required building is not present in ERP "UserSide", it will be created. If the building already exists and was not added by the module, it will still be processed correctly and assigned to customers.

2. If a customer exists in ERP "UserSide" but is not found in the billing system, the customer is not deleted from ERP "UserSide". Instead, the customer is marked with the "[[Customer status|not in billing]]" status. This is done for safety: otherwise, if an update fails, all customers could be deleted because they were not found in billing.

3. If a customer's [[Activity|Internet activity date]] is later than the network activity date, the network activity date is set equal to the Internet activity date.

4. When data is updated from billing, not all customer data is updated. For example, full name, address, and phone number may remain unchanged. Loading such data can be enabled in the "[[Settings - Billings]]" section for the required billing system.

== Brief module descriptions ==

A detailed description is provided on each module page.

[[usm_billing_EN|usm_billing]] imports information about customers, addresses, tariff plans, and other data from billing into USERSIDE. It can also support a custom in-house billing system. Separate modules for standard billing systems are based on this module: [[usm_abills_EN|usm_abills]], [[usm_bgbilling_EN|usm_bgbilling]], [[usm_hydra_EN|usm_hydra]], [[usm_lanbilling_EN|usm_lanbilling]], [[usm_nodeny_EN|usm_nodeny]], [[usm_nodeny_plus_EN|usm_nodeny_plus]], [[usm_utm5_EN|usm_utm5]].

[[usm_asterisk_EN|usm_asterisk]] interacts with Asterisk telephony. When a call is received, it instantly ''(before the handset is picked up)'' displays the caller's phone number on the operator's screen. If this phone number belongs to a customer, the module shows customer information ''(full name, balance, address, tariff plan, last activity date, and so on)''. If the phone number belongs to an employee, this is indicated. If the number is unknown, the operator is offered to create a potential customer card.

[[usm_cabletest_EN|usm_cabletest]] '''periodically''' polls switches and receives cable tester information about the length of connected copper cables. The list of supported switch models is provided on the module page.

[[usm_checker_EN|usm_checker]] '''periodically''' polls ''(multithreaded ping)'' active network equipment or customer devices to detect which equipment is active and which has gone down ''(or which customers are no longer active)''.

[[usm_gps 2_EN|usm_gps]] receives information from hardware and software GPS trackers to display vehicle and employee locations on the coverage map. It helps identify who is closest to an incident, shows who moved where and when, and displays vehicle speed limit violations and similar data. The list of supported tracker protocols is provided on the module page.

[[usm_iferr_EN|usm_iferr]] '''periodically''' polls ''(via SNMP)'' error counters on equipment interfaces. This shows devices with interface errors, both by interface and by the number of problematic interfaces on each device. It also builds daily and weekly error growth deltas, making it possible to see devices where problems are still ongoing.

[[usm_observer_EN|usm_observer]] '''periodically''' polls ''(via SNMP)'' any equipment for any parameters and sends notifications ''(email, SMS, and so on)'' when parameters change or go beyond limits. It makes it possible to flexibly configure monitoring for any devices: a specific port went down, an alarm sensor was triggered, battery operation started, a printer ran out of paper, and so on.

[[usm_peleng_EN|usm_peleng]] '''periodically''' polls switches, receives their FDB tables, and accumulates MAC address information by equipment and port. It helps detect loops, port flooding, and viruses, and helps find MAC address spoofing. UPLINK/DOWNLINK ports can be excluded from display. Customer or device information is pulled from USERSIDE by MAC address.

[[usm_pon_EN|usm_pon]] '''periodically''' [[PON_EN|polls OLTs]], receives and accumulates information about connected ONUs: signal level, distance to OLT, model, vendor, description, MAC, ID, and other data. It also stores the history of signal level changes by ONU. Customer information is pulled from USERSIDE by ONU MAC address or ID.

[[usm_radio_EN|usm_radio]] '''periodically''' [[Radio|polls radio equipment]] and receives a list of connected radio customers: signal level, MAC address, connection speed, and similar data. The list of supported vendors is provided on the module page. Customer or device information is pulled from USERSIDE by MAC address.

[[usm_stat_EN|usm_stat]] is launched '''periodically''' and records customer [[Activity|activity]] in the database at the time of launch. This makes it possible to see, for each customer, on which days and at what hours they were active in the network. It also records the total number of active customers at the time the module is launched.

Версії 3.20

2026-06-23T11:07:34Z

IronBot: [IronBot] Sync UK localization from RU

[[Versions 3.20 EN|en]] | '''uk''' | [[Версии_3.20|ru]]

Версії гілки [[3.20_UK|3.20]]

Також див.: [[Версії ERP "USERSIDE"]]

== 3.20.25 (у розробці) ==
* Доопрацьовано відображення запланованих кабельних ліній на мапі покриття відповідно до налаштувань кольору за щільністю кабелю
* Виправлено помилку з відображенням списку кабельних ліній ''(у деяких випадках)''

== 3.20.24 - 27.05.2026 ==
* Виправлення невеликих помилок та змін

== 3.20.23 - 27.04.2026 ==
* Додано метод API->call->[[API_call_UK#agent_call|agent_call]]
* Додано метод API->chapter->[[API_chapter_UK#link_add|link_add]]
* Додано метод API->chapter->[[API_chapter_UK#link_get|link_get]]
* Додано метод API->chapter->[[API_chapter_UK#link_remove|link_remove]]
* Доопрацьовано метод API->call->[[API_call_UK#add|add]]
* Доопрацьовано метод API->task->[[API_task_UK#edit|edit]]
* У виконаних завданнях також відображається ознака "Прострочено" під час порушенні термінів робіт
* Виправлена помилка з входом у календар робіт ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.20.22 - 04.04.2026 ==
* Виправлено вибір порожнього значення в типі завдань для реєстрації телефоном
* Оптимізаційні роботи
* Виправлення невеликих помилок

== 3.20.21 - 11.03.2026 ==
* Виправлено відображення лічильника помилок на інтерфейсах пристроїв ''(у деяких випадках)''
* Виправлено налаштування шаблонів SMS-повідомлень для абонентів у завданнях
* Оптимізаційні роботи
* Виправлення невеликих помилок

== 3.20.20 - 22.02.2026 ==
* Оптимізована робота розділу "Мої завдання"
* Виправлено порушення розмітки головного меню в деяких випадках

== 3.20.19 - 08.02.2026 ==
* Виправлення невеликих помилок

== 3.20.18 - 23.01.2026 ==
* Оптимізація звіту за складу "Оборотно-сальдова відомість"
* Виправлення невеликих помилок

== 3.20.17 - 31.12.2025 ==
* Додано метод API->task->[[API_task_UK#add_node_to_task|add_node_to_task]]
* Додано метод API->task->[[API_task_UK#remove_node_from_task|remove_node_from_task]]
* Виправлено виконання ланцюжка завдань ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.20.16 - 14.12.2025 ==
* Виправлена помилка з фільтрацією за секції ТМЦ у списку операцій за складу
* Виправлення невеликих помилок

== 3.20.15 - 06.12.2025 ==
* Для ланцюжків завдань/автоматизації в типах завдань додано можливість вказівки дробового інтервалу годинника
* Виправлення невеликих помилок

== 3.20.14 - 29.11.2025 ==
* Доопрацювання API взаємозв'язку з Binotel
* Виправлення невеликих помилок

== 3.20.13 - 22.11.2025 ==
* Виправлення невеликих помилок

== 3.20.12 - 15.11.2025 ==
* Додано параметр налаштування "Масштабувати ширину кабельної лінії на схемі комутації в залежності від довжини назви"
* Допрацьовано відображення невідомих ONU за OLT у віджеті головної сторінки
* Виправлення інших невеликих помилок

== 3.20.11 - 08.11.2025 ==
* Виправлення помилки під час вході в розділ Custom-повідомлень ''(у деяких випадках)''
* Виправлення помилки під час вході в налаштування інтерфейсів/стекування за пристрої ''(у деяких випадках)''
* Виправлена неможливість комутації між ODF/кросами у майстрі комутацій
* Виправлення деяких помилок міграції

== 3.20.10 - 07.11.2025 ==
* Додано метод API->vehicle->[[API_vehicle_UK#add|add]]
* Додано метод API->vehicle->[[API_vehicle_UK#edit|edit]]
* Додано метод API->vehicle->[[API_vehicle_UK#delete|delete]]
* У картці спорудження зв'язку в блоці з прикріпленими файлами-зображеннями можна швидко зробити зображення основним фото для цього об'єкта ''(без необхідності переходити до редагування)''
* У картці кабельної лінії додано можливість створити завдання з цією лінією або додати лінію до існуючого завдання
* Доопрацьовано сортування за додатковими полями у власних розділах
* Виправлена фільтрація за найменуванням ТМЦ у списку ТМЦ
* Виправлено відображення шарів обладнання на карті покриття
* Виправлення інших невеликих помилок

== 3.20.9 - 14.09.2025 ==
* Доопрацювання перевірки прав доступу до ONU
* Виправлена помилка під час пошуку абонента під час передачі ТМЦ ''(у деяких випадках)''
* Виправлено оновлення на базі серійних номерів для ONU під час опитуванні OLT ''(у деяких випадках)''

== 3.20.8 - 06.09.2025 ==
* Додано метод API->billing->[[API_billing_UK#refresh_date_update|refresh_date_update]]
* Оптимізовано інтерфейс редагування/додавання адресної одиниці ''(актуально для розгалужених адресних структур)''
* У картці завдання додані посилання на перегляд зв'язаних абонентів із спорудами зв'язку та з кабельними лініями
* Виправлена перевірка на статус батьківського завдання в автоматизації дій із завдань ''(у деяких випадках)''
* Виправлено відображення спливаючої підказки в календарі завдань під час горизонтальному скролі
* Виправлено призначення співробітників у підрозділ ''(у деяких випадках)''

== 3.20.7 - 25.08.2025 ==
* '''Глибока переробка операцій із транспорту. Різні типи, контроль пробігу, терміни. Повідомлення на головну сторінку та список транспорту. Ведення історії змін в операціях '''
* Історія дій щодо потенційного абонента переноситься в історію дій звичайного абонента під час їх об'єднанні
* При гарячій заміні пристрою можна вказати збереження історії MAC-адрес на портах обладнання
* У групових діях за списком абонентів додано можливість очищення комутації
* Технічні міграції даних ядра
* Виправлена фільтрація FDB-таблиці з пристрою ''(у деяких випадках)''
* Виправлена помилка під час обмеженні співробітнику доступу за конкретною IP-адресою
* Виправлено перевірку прав на доступ до ONU

== 3.20.6 - 15.08.2025 ==
* ''' Окремі SMS-профілі для роботи. Наприклад, для кожної SMS-розсилки можна вказати окремий SMS-профіль ''(власне альфа-ім'я, інший оператор...)'''''
* Виділено окремі права доступу до ONU на перегляд та зміну
* Виправлено відображення великої кількості розділів блокнота у списку розділів
* Виправлено оновлення інформації під час додавання/виключенні споруди зв'язку в завданні

== 3.20.5 - 08.08.2025 ==
* Додано метод API->address->[[API_address_UK#get_building_type|get_building_type]]
* Додано параметр налаштування "Будівлі. Шаблон спливаючого повідомлення на карті"
* Доопрацьовано інтерфейс зміни нотатки, типу адаптера та з'єднання для волокна кабельної лінії
* Перероблено інтерфейс додавання споруд зв'язку та кабельних ліній у завдання під час створення завдання
* Підкориговано перевірку прав доступу до табеля робіт
* Доопрацьовано тарифікацію співробітникам за завдання у відомості робіт за участю в завданні понад 5 співробітників
* Виправлена помилка фільтрації за будівлі у списку операцій за складом ''(у деяких випадках)''

== 3.20.4 - 04.08.2025 ==
* Додано метод API->cross->[[API_cross_UK#edit_adapter|edit_adapter]]
* Доопрацьовано метод API->task->[[API_address_UK#edit_address|edit_address]]
* Додано параметр налаштування "Заблокувати виконання автоматизації/ланцюжка завдань під час поверненні завдання зі статусу із системною роллю "Відкладено"
* У списку завдань додано угруповання завдань за вулиці або населеному пункту
* Доопрацювання збереження прикріплених файлів до коментарів за завданням
* Невеликі виправлення та доопрацювання

== 3.20.3 - 27.07.2025 ==
* Доопрацьовано метод API->task->[[API_task_UK#change_state|change_state]]
* Додано параметр налаштування "З'єднання на дільниках вважати механічними"
* У налаштуваннях типів завдань для ТМЦ можна вказати, що переміщати всі ТМЦ після закриття на зв'язану будівлю
* У ланцюжках/автоматизації за типами завдань додано можливість додаткової умови "Статус дочірнього/батьківського завдання" для варіантів дій "Батьківське/Дочірнє завдання. Змінити статус на"
* У картці будівлі у списку ТМЦ додано інформацію про дату встановлення ТМЦ на будівлі та можливість експорту в XLS та у версію для друку
* У картці можна скопіювати всі прикріплені файли з іншого завдання
* У картці абонента додано пряме посилання на перегляд його маршруту комутації
* Для профілів співробітників можна обмежити максимальну кількість записів на сторінці ''(у таблицях/списках)''
* У фільтр зі споруд зв'язку додано можливість вибірки за відсутнім власним значком на карті
* У списку операцій за складу в селекторах вибору контрагента додано можливість вказівки конкретної будівлі
* У групових діях за будівлях додано можливість зміни індивідуального кольору на карті
* У групових діях за будинках можна змінити менеджера на порожнє значення ''(видалити менеджера)''
* Виправлено сортування за адресою у списку завдань ''(у деяких випадках)''
* Виправлена можливість одночасно відкласти завдання та вказати довільний коментар

== 3.20.2 - 18.07.2025 ==
* Додано метод API->task->[[API_task_UK#add_cable_line_to_task|add_cable_line_to_task]]
* Додано метод API->task->[[API_task_UK#remove_cable_line_from_task|remove_cable_line_from_task]]
* Список підключених ONU на OLT можна виводити на друк або експортувати до XLS
* Для споруд зв'язку та кабельних ліній додано можливість у групових діях змінювати нотатки
* У шаблоні спливаючої підказки на завдання на карті покриття можна відображати дату створення завдання, дату оновлення, текст останнього коментаря
* У ланцюжках/автоматизації за типами завдань додано дію "Абоненти. Виключити"
* Для ланцюжків/автоматизації в типах завдань додана можливість відключати автопризначуваних виконавців під час створення нового завдання за ланцюжку
* Доопрацьовано відображення посилань в описі типу завдань у картці завдання
* Виправлена фільтрація абонентів, що залежать від кросу/odf ''(у деяких випадках)''

== 3.20.1 - 12.07.2025 ==
* У списку будівель доданий фільтр за будівлях, у яких знято позначку "Відображати на карті"
* Виправлена неможливість відкрити картку автотранспорту зі списку
* Виправлено пошук за найменуванням кабельної лінії під час створення завдання ''(у деяких випадках)''
* Виправлення відображення інформації про абонента у списку завдань ''(у деяких випадках)''

== 3.20 - 09.07.2025 ==
* Реліз версії 3.20
* Список змін див. [[3.20_UK|3.20]]

Versions 3.20 EN

2026-06-23T11:07:32Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[Версії_3.20|uk]] | [[Версии_3.20|ru]]

Branch versions [[3.20_EN|3.20]]

Also see: [[Versions of ERP "USERSIDE"]]

== 3.20.25 (in development) ==
* Improved the display of planned cable lines on the coverage map according to cable-density color settings
* Fixed a bug with displaying the cable line list ''(in some cases)''

== 3.20.24 - 27.05.2026 ==
* Fixed minor bugs and changes

== 3.20.23 - 27.04.2026 ==
* Added API method->call->[[API_call_EN#agent_call|agent_call]]
* Added API method->chapter->[[API_chapter_EN#link_add|link_add]]
* Added API method->chapter->[[API_chapter_EN#link_get|link_get]]
* Added API method->chapter->[[API_chapter_EN#link_remove|link_remove]]
* Improved API method->call->[[API_call_EN#add|add]]
* Improved API method->task->[[API_task_EN#edit|edit]]
* Completed tasks now also show the "Overdue" flag when work deadlines are missed
* Fixed a bug when opening the work calendar ''(in some cases)''
* Fixed minor bugs

== 3.20.22 - 04.04.2026 ==
* Fixed selecting an empty value in the task type for registration by phone
* Optimization work
* Fixed minor bugs

== 3.20.21 - 11.03.2026 ==
* Fixed display of the error counter on equipment interfaces ''(in some cases)''
* Fixed SMS message template settings for customers in tasks
* Optimization work
* Fixed minor bugs

== 3.20.20 - 22.02.2026 ==
* Optimized the "My tasks" section
* Fixed broken main menu layout in some cases

== 3.20.19 - 08.02.2026 ==
* Fixed minor bugs

== 3.20.18 - 23.01.2026 ==
* Optimized the warehouse report "Turnover balance sheet"
* Fixed minor bugs

== 3.20.17 - 31.12.2025 ==
* Added API method->task->[[API task#add_node_to_task|add_node_to_task]]
* Added API method->task->[[API task#remove_node_from_task|remove_node_from_task]]
* Fixed execution of task chain ''(in some cases)''
* Fixed minor bugs

== 3.20.16 - 14.12.2025 ==
* Fixed a bug with filtering by inventory section in the warehouse operations list
* Fixed minor bugs

== 3.20.15 - 06.12.2025 ==
* For task chains/automation in task types, added the ability to specify fractional hour intervals
* Fixed minor bugs

== 3.20.14 - 29.11.2025 ==
* Improvements to the API interface with Binotel
* Fixed minor bugs

== 3.20.13 - 22.11.2025 ==
* Fixed minor bugs

== 3.20.12 - 15.11.2025 ==
* Added the setting "Scale the width of the cable line on the switching diagram depending on the length of the name"
* Improved the display of unknown ONUs by OLT in the main page widget
* Fixed other minor bugs

== 3.20.11 - 08.11.2025 ==
* Fixed an error when entering the Custom notifications section ''(in some cases)''
* Fixed an error when entering the device interface/stacking settings ''(in some cases)''
* Fixed the inability to switch between ODF/crosses in the switching master
* Fixed some migration errors

== 3.20.10 - 07.11.2025 ==
* Added API method->vehicle->[[API vehicle#add|add]]
* Added API method->vehicle->[[API vehicle#edit|edit]]
* Added API method->vehicle->[[API vehicle#delete|delete]]
* In the communication installations card, in the block with attached image files, it is possible to quickly make an image the main photo for this object ''(without having to go to editing)''
* In the cable line card, the ability to create a task with this line or add a line to an existing task has been added
* Sorting by additional fields in custom sections has been improved
* Filtering by inventory item name in the inventory list has been fixed
* The display of equipment layers on the coverage map has been fixed
* Other minor bugs have been fixed

== 3.20.9 - 14.09.2025 ==
* Improved verification of access rights to ONU
* Fixed a bug when searching for a user during the transfer of inventory items ''(in some cases)''
* Fixed an update in the serial number database for ONU when polling OLT ''(in some cases)''

== 3.20.8 - 06.09.2025 ==
* Added API method->billing->[[API billing#refresh_date_update|refresh_date_update]]
* Optimised interface for editing/adding address units ''(relevant for branched address structures)''
* Links to view users associated with communication installations and cable lines have been added to the task card
* Fixed checking for parent task status in task automation ''(in some cases)''
* Fixed display of pop-up hints in the task calendar when scrolling horizontally
* Fixed assignment of employees to a department ''(in some cases)''

== 3.20.7 - 25.08.2025 ==
* '''In-depth processing of transport operations. Various types, mileage control, deadlines. Notification on the main page and transport list. Keeping a history of changes in operations'''
* The history of actions for a potential user is transferred to the history of actions for a regular user when they are merged
* During hot replacement of a device, you can specify to save the history of MAC addresses on equipment ports
* The ability to clear switching has been added to group actions on the user list
* Technical migration of core data
* Fixed filtering of the FDB table by device ''(in some cases)''
* Fixed a bug when restricting an employee's access to a specific IP address
* Fixed ONU access rights verification

== 3.20.6 - 15.08.2025 ==
* ''' Separate SMS profiles for work. For example, you can specify a separate SMS profile for each SMS mailing ''(your own alpha name, different operator, etc.)'''''
* Separated ONU access rights for viewing and editing
* Fixed display of a large number of notebook sections in the section list
* Fixed information update when adding/removing a communication facility in a task

== 3.20.5 - 08.08.2025 ==
* Added API method->address->[[API address#get_building_type|get_building_type]]
* Added the "Buildings. Pop-up message template on the map" setting
* Improved the interface for changing notes, adapter types, and connections for fibre cable lines
* Redesigned the interface for adding communication structures and cable lines to a task when creating a task
* Corrected the verification of access rights to the work schedule
* Improved the billing of employees for tasks in the work schedule when more than 5 employees are involved in the task
* Fixed a bug in filtering by building in the list of warehouse operations ''(in some cases)''

== 3.20.4 - 04.08.2025 ==
* Added API method->cross->[[API cross#edit_adapter|edit_adapter]]
* Added API method->task->[[API address#edit_address|edit_address]]
* Added a setting parameter "Block automation/task chain execution when returning a task from the status with the system role 'Pending' "
* Added grouping of tasks by street or location to the task list
* Improved saving of files attached to task comments
* Minor fixes and improvements

== 3.20.3 - 27.07.2025 ==
* Added API method->task->[[API task#change_state|change_state]]
* The "Consider connections on dividers as mechanical" configuration parameter has been added
* In the task type settings for inventory items, you can specify that all inventory items should be moved to the associated building after closing
* In chains/automation by task type, the additional condition "Child/parent task status" has been added for the action options "Parent/Child task. Change status to"
* Information about the date of installation of inventory items on the building and the ability to export to XLS and printable versions has been added to the building card in the inventory list
* All attached files from another task can be copied to the card
* A direct link to view the customer's switching route has been added to the customer card
* For employee profiles, you can limit the maximum number of entries on the page (in tables/lists)
* The filter for communication facilities now includes the option to select by missing custom icon on the map
* In the list of warehouse operations in the counterparty selection selectors, the ability to specify a specific building has been added
* In group actions for buildings, the ability to change the individual colour on the map has been added
* In group actions for buildings, you can change the manager to the empty value ''(delete manager)''
* Fixed sorting by address in the task list ''(in some cases)''
* Fixed the ability to simultaneously postpone a task and specify an arbitrary comment

== 3.20.2 - 18.07.2025 ==
* Added API method->task->[[API task#add_cable_line_to_task|add_cable_line_to_task]]
* Added API method->task->[[API task#remove_cable_line_from_task|remove_cable_line_from_task]]
* The list of connected ONUs on the OLT can be printed or exported to XLS
* For communication installations and cable lines the possibility to change notes in group actions has been added
* In the template of the tooltip on the task on the coverage map it is possible to display the date of task creation, update date, text of the last comment
* In chains/automation by task type, added action "Customers. Exclude."
* In chains/automation by task types, added possibility to disable auto-assigned executors when creating a new task in a chain
* Improved displaying of links in the description of a task type in the task card
* Fixed filtering of customers that depend on cross/odf ''(in some cases)''

== 3.20.1 - 12.07.2025 ==
* In the list of buildings, added filter for buildings with "Display on map" unchecked
* Fixed inability to open a vehicle card from the list
* Fixed search by cable line name when task is created ''(in some cases)''
* Fixed display of customer information in the task list ''(in some cases)''

== 3.20 - 09.07.2025 ==
* Release version 3.20
* For a list of changes see [[3.20_EN|3.20]]

3.21 UK

2026-06-23T11:07:19Z

IronBot: [IronBot] Sync UK localization from RU

[[3.21_EN|en]] | '''uk''' | [[3.21|ru]]

Дата випуску: '''червень 2026'''

''Основні зміни: https://promo.userside.eu/321/''

Див. також:
* [[Оновлення 3.21|Оновлення до версії 3.21]]
* [[Версії ERP "USERSIDE"]] | [[Версії 3.21|Версії 3.21]]

== Перелік змін ==

'''Особливої важливості:'''
* [[PWA (застосунок)|PWA ''(застосунок)'']]
* Автоматична побудова [[Бізнес-процес|схеми бізнес-логіки/робочого процесу]] для типів завдань на основі ланцюжків/автоматизації
* [[Календар|Оновлений календар]] завдань та [[Інтеграція з Google-календарем|інтеграція з Google-календарем]]
* Окремий [[Масова передача ТМЦ|інтерфейс для швидкої передачі ТМЦ]] через сканування або введення штрихкодів, серійних номерів тощо ''(зокрема з підтримкою сканування штрихкодів камерою мобільного пристрою)''
* [[Схема комутації#anchor_321|Снапшоти схем комутації]] виводяться на основній схемі та формуються безпосередньо під час операцій комутації/розриву комутації на споруді зв'язку
* У схемі комутації створення з'єднань, видалення та зміна ламаної з'єднання виконуються без перезавантаження й очікування сторінки ''(на практиці це пришвидшило роботу у 2-10 разів)''
* Панель на головній сторінці з [[Список завдань#anchor_321|лічильниками фільтрів за завданнями/показниками KPI]]
* "Фізичне" [[Підписання документів з абонентами|підписання документів з абонентами/клієнтами]] на планшетах ''(мобільних пристроях)''
* Реалізовано автооновлення GPS-позиції транспорту на мапі в реальному часі ''(кожні N секунд)''
* Віджет на головну сторінку: [[Статистика_UK#anchor_321|найпроблемніші абоненти та будинки]]
* Нова [[Структурна схема|структурна схема]]. Масштабування, збереження у SVG
* [[Internal API UK|Internal API]] v2. Подієва система в ERP
* Підтримка обліку IPv6 для обладнання та абонентів
* Оновлений UI/UX

'''Абоненти/клієнти:'''
* Реалізовано масовий імпорт потенційних абонентів
* У групових діях за абонентами додано можливість надіслати SMS
* '''В умовах SMS-розсилки можна додавати конкретних абонентів'''
* В SMS-розсилці додано фільтр "Ігнорувати відмову від отримання SMS"
* У груповому надсиланні email абонентам додано різні шаблони з даними про абонента
* У листуванні з абонентом можна вимкнути відображення коментарів за завданнями
* Додано зберігання історії статусів абонентів
* Список абонентів:
** '''У фільтрі підтримується режим "і/або"'''
** '''У фільтрі додано можливість включати/виключати умови ''(раніше можна було лише включати)'''''
** Додано фільтр "Абоненти, включені в обладнання"
** Додано фільтр за номером завдання. Також у картці завдання, де прикріплено від 3 абонентів, додано посилання на цей фільтр
** У списку абонентів додано можливість відображати поле "Менеджер"
** У списку залежних абонентів від пристрою/споруди зв'язку також враховуються абоненти, які не скомутовані, але мають пристрої ''(наприклад ONU)'', залежні від батьківського об'єкта

'''Обладнання:'''
* '''Додано вкладки в картці комутатора/обладнання'''
* Якщо для пристрою не вказано IP-адресу, він має один порт і при цьому підключений до вищого керованого комутатора, то в таблиці портів цього пристрою виводитиметься SNMP-інформація з порту вищого пристрою
* PON:
** '''Історія зміни рівня сигналу ONU тепер виводиться у вигляді графіка'''
** Для списку підключених ONU можна налаштувати порядок і відображення полів
** У картці OLT на портах виводиться лічильник кількості ONU на них
* Можна вказувати відсотки поділу для запланованих дільників
* У таблиці дільників додано поле "Кількість зайнятих адаптерів"
* У картці VLAN додано можливість вручну додавати пристрої

'''Схема комутації:'''
* Написи на схемі комутації можна повертати під кутом
* Під час додавання дільника зі схеми комутації більше не відбувається перехід у картку дільника: користувач залишається у схемі
* У майстрі комутації додано можливість комутації пристроїв
* Для кросу/ODF у схемі комутації додано можливість швидко змінювати підписи для всіх портів одразу
* Для запланованих комутацій у схемі перепланування додано можливість змінювати маршрут вручну
* Для мобільних пристроїв перетягування ліній комутації типово заблоковане під час відкриття сторінки

'''Завдання:'''
* Оновлений [[Календар|календар завдань]]:
** '''перетягування завдань ''(зміна часу робіт)'''''
** можна змінювати строк виконання завдання ''(перетягувати нижню межу)''
** тижневий/місячний режим для підрозділів і співробітників
** режим "підрозділ"/"+співробітники"/"+співробітники і підрозділи"
** 15/30/60 хвилин ''(раніше тільки слоти по 1 годині)''
** позначається факт високого пріоритету, а також можна налаштовувати шаблон інформації для заголовка завдання і тіла завдання
* '''Перевірка існування раніше прикріпленого файла в завданнях і коментарях до завдання ''(щоб запобігти спробам співробітників прикріплювати старі файли, видаючи їх за нові)'''''
* У картці завдання додано можливість однією кнопкою передати ТМЦ із доступних цьому співробітнику
* Новий спецтип для типів завдань: "Роботи з боржниками"
* У картці завдання виводиться рядок з координатами і швидким переходом на Google-мапу
* Під час створення дочірнього завдання з картки завдання додано можливість копіювати ''(використовувати)'' також файли з батьківського завдання
* Дороблено відображення інформації про ТМЦ у списку ТМЦ під час зміни статусу завдання
* "Робочі нотатки" розширено з будинків на будь-який адресний об'єкт

* Нові параметри налаштування:
** "У картці завдання сортувати абонентів за порядком їх додавання в завдання"
** "Інтервал для відображення завдань у розділі "Мої завдання" (днів)"
** "Заблокувати виконання автоматизації/ланцюжка завдань під час повернення завдання зі статусу із системною роллю "Відкладено"

* Ланцюжки завдань/автоматизація:
** Додано додаткову умову "Завдання. Мітка"
** Додано варіанти дій:
*** "Батьківське завдання (найперше в ланцюжку). Змінити статус на"
*** "Батьківське завдання (усі в ланцюжку). Змінити статус на"
*** "ТМЦ. Передати в батьківське завдання"
*** "ТМЦ. Передати в дочірнє завдання"
*** "Перенесення значень додаткових полів у картку будинку"

* Список завдань:
** У списку завдань виводяться мініатюри прикріплених файлів ''(параметр налаштування)''
** Фільтр завдань:
*** додано режими "і/або"
*** розширено фільтр за номером батьківського завдання
*** розширено фільтр за "Виконано зі строком виконання понад..."
*** розширено фільтр за номером батьківського завдання
*** додано фільтр за значенням чек-листа
** У списку завдань додано групові дії:
*** "Абоненти - Відкрити список"
*** "Призначити власника"
*** "Виключити власника"

'''Склад:'''
* '''В операціях за складом додано фільтрацію за "Адреса (з об'єктами)", що дозволяє вибрати операції передачі ТМЦ на всі об'єкти цієї території'''
* '''У списку ТМЦ додано можливість фільтрації за будь-яким адресним об'єктом ''(включно з усім підпорядкуванням)'' ''(область, місто, вулиця...)'''''
* У списку ТМЦ виводиться підсумковий рядок із загальною вартістю/закупівельною вартістю
* У звіті щодо залишків ТМЦ назви позицій ТМЦ зроблено посиланнями для швидкого перегляду списку цих ТМЦ
* Групи для постачальників
* Додано можливість надсилати повідомлення співробітнику в Messenger/Telegram під час передачі ТМЦ йому під звіт/з-під звіту
* Під час розділення ТМЦ додано можливість одразу вказувати MAC-адреси/серійні номери для цих ТМЦ

'''Покриття:'''
* Реалізовано автооновлення GPS-позиції транспорту на мапі в реальному часі ''(кожні N секунд)''. Додано параметр налаштування "Інтервал оновлення позиції транспорту на мапі"
* '''Коли на мапі кілька об'єктів накладено один на одного ''(споруди зв'язку в одній точці/багато муфт на опорі... або кабельні лінії проходять поруч)'', то під час наведення на це скупчення об'єктів воно розкривається з можливістю вибрати потрібний'''
* Доробка відображення на мапі кабельних ліній, які проходять через екран, але мають кінцеві точки поза поточною областю відображення
* Нова лінійка на мапі
* Новий тип об'єктів на мапу: "Посилання"
* У спливних підказках на полігонах на мапі виводяться значення додаткових полів
* У списку будинків додано можливість виведення поля з відсотком проникнення, поле "Нотатки" і фільтр за цим полем

'''Споруди зв'язку:'''
* Для споруди зв'язку можна вказати приховування її з мапи покриття
* Для типів споруд зв'язку додано параметр "Під час додавання об'єкта пропонувати новий номер"
* У макеті шафи/стійки у спливних підказках на пристроях додано відображення серійного/інвентарних номерів

'''Кабельні лінії:'''
* У списку кабельних ліній додано фільтр за додатковими полями
* У групових діях із заміни марки кабелю в списку кабельних ліній додано можливість під час цієї дії замінювати кольори модулів/волокон/провідників у кабелі відповідно до нової марки кабелю

'''Співробітники:'''
* Налаштування в персональному налаштуванні: додаткові кнопки для лівого меню в мобільній версії, зокрема власні посилання
* Нові права в профілях співробітників:
** Перегляд/зміна інформації про постачальників
** Перегляд/зміна штрафів і премій персоналу

'''API:'''
* '''Можна створювати окремі [[UserSide API Key UK|API-ключі]] тільки для операцій читання даних'''
* '''Усі запити на запис/зміну даних тепер мають надсилатися лише через POST'''
* У запиті не повинно бути сторонніх параметрів. Якщо сторонній параметр присутній, запит повертатиме помилку
* Доопрацьовано метод API->address->[[API_address_UK#edit_address|edit_address]]
* Доопрацьовано метод API->attach->[[API_attach_UK#add|add]]
* Додано метод API->attach->[[API_attach_UK#upload|upload]]

'''Транспорт:'''
* '''Глибоко перероблено операції за транспортом. Різні типи, контроль пробігу, строків. Повідомлення на головну сторінку і список транспорту. Ведення історії змін в операціях'''

'''Інше:'''
* PHP 8.4
* Додано локалізації: албанська, узбецька, таджицька. Численні виправлення в поточних локалізаціях.
* '''Модуль [[usm_asterisk]] тепер підтримує передачу записів дзвінків і можливість прослуховувати їх в інтерфейсі ERP'''
* Перехід із числових ID на рядкові UUID в об'єктах ''(числові ID для частини об'єктів залишено як додаткові довідкові)''
* Новий редактор WYSIWYG
* '''Темна схема інтерфейсу ''(з підтримкою автоматичного перемикання)'''''
* '''Редагування значень додаткових полів у картках об'єктів прямо в режимі перегляду ''(без потреби переходити в редагування)'''''
* '''Перероблено блок роботи з прикріпленими файлами'''
** Повністю інші можливості, галерея, дії тощо
** Для мобільних пристроїв швидка кнопка "Фотографувати"
** Для мобільних пристроїв велика кнопка додавання файлів
** Блок Ctrl+V для роботи з буфером обміну тепер підтримує вставлення кількох зображень і файлів будь-яких форматів ''(а не лише зображень)''
* Нове ліве адаптивне меню з можливістю приховування/відкриття
* '''Додано кнопки в лівому меню для мобільних пристроїв:'''
** "Моя позиція на мапі"
** QR-код
** Штрихкод ''(+ може подавати звуковий сигнал під час сканування)''. Якщо є такий ТМЦ, відкривається картка ТМЦ; якщо немає прав до ТМЦ, але є таке обладнання, відкривається картка обладнання. Інакше відкривається список пошуку
** Три кнопки для власних посилань
** Кнопки поділитися посиланням/відкрити посилання
* '''Опція "Конвертувати HEIC-файли в JPEG" і власне підтримка роботи з .heic файлами на льоту'''
* Розділ "Блокнот" трансформувався в налаштовуваний власний розділ. Це значно розширює його функціональність
* Нова бібліотека генерації штрихкодів ''(у SVG-форматі)''
* Дороблено звіт за надходженнями коштів: групування за населеними пунктами, а також за населеними пунктами + місяцями, і можливість детального перегляду списку платежів
* У групових діях за об'єктами кнопка "Застосувати" тепер містить кількість позначених об'єктів і блокується, якщо не вибрано дію/об'єкти
* Селектор вибору дати/дати-часу: виправлено локалізацію під поточну мову
* Превентивно впроваджено рішення для забезпечення сумісності з датами після 2038 року ''("Unix 2038 bug")''
* Окремі SMS-профілі для роботи. Наприклад, для кожної SMS-розсилки можна вказати окремий SMS-профіль ''(власне альфа-ім'я, інший оператор...)''
* У списках об'єктів у фільтрацію за значеннями додаткових полів додано варіанти фільтрації "більше" і "менше"
* Нові версії зовнішніх [[Модулі|модулів]]

* Інші зміни: див. https://wiki.userside.eu/3.20

3.21 EN

2026-06-23T11:07:16Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[3.21_UK|uk]] | [[3.21|ru]]

Release date: '''June 2026'''

''Main changes: https://promo.userside.eu/321/''

See also:
* [[Upgrade_3.21|Upgrade to version 3.21]]
* [[Versions of ERP "USERSIDE"]] | [[Versions 3.21 EN|Versions 3.21]]

== List of changes ==

'''High-priority changes:'''
* [[PWA (application)|PWA ''(application)'']]
* Automatic building of a [[Business process|business logic/workflow diagram]] for task types based on task chains and automation
* Updated task [[Calendar|calendar]] and [[Google Calendar integration|Google Calendar integration]]
* A separate [[Bulk inventory transfer|interface for fast inventory transfer]] by scanning or entering barcodes, serial numbers, and other identifiers ''(including barcode scanning with a mobile device camera)''
* [[Switching scheme#anchor_321|Switching scheme snapshots]] are shown on the main scheme and are generated directly during switching/disconnection operations on a communications installation
* In the switching scheme, creating connections and deleting or changing a connection polyline is performed without reloading or waiting for the page ''(in practice, this made work 2-10 times faster)''
* A home-page panel with [[Work schedule#anchor_321|task filter counters/KPI indicators]]
* "Physical" [[Document signing with customers|document signing by customers/clients]] on tablets ''(mobile devices)''
* Automatic real-time GPS position updates for transport on the map ''(every N seconds)''
* Home-page widget with [[Statistics#anchor_321|the most problematic customers and buildings]]
* New [[Structural scheme|structural scheme]]. Scaling and SVG export
* [[Internal API EN|Internal API]] v2. Event system in ERP
* IPv6 accounting support for equipment and customers
* Updated UI/UX

'''Customers/clients:'''
* Added mass import of potential customers
* Added the ability to send SMS in group actions for customers
* '''Specific customers can be added to SMS mailing conditions'''
* Added the "Ignore SMS opt-out" filter to SMS mailings
* Added different customer-data templates for group email sending to customers
* Customer correspondence can hide comments from tasks
* Added customer status history storage
* Customer list:
** '''The filter now supports "and/or" mode'''
** '''The filter can now include/exclude conditions ''(previously it could only include them)'''''
** Added the "Customers included in equipment" filter
** Added filtering by task number. The task card also shows a link to this filter when at least three customers are attached to the task
** The customer list can display the "Manager" field
** The list of customers dependent on a device/communications installation also includes customers that are not commutated but have devices ''(for example ONU)'' that depend on the parent object

'''Equipment:'''
* '''Added tabs to the switch/equipment card'''
* If a device has no IP address, has one port, and is connected to an upstream managed switch, the port table for that device shows SNMP information from the upstream device port
* PON:
** '''ONU signal level history is now displayed as a chart'''
** The order and displayed fields can be configured for the list of connected ONUs
** The OLT card now shows an ONU counter on ports
* Split percentages can be specified for planned splitters
* Added the "Number of occupied adapters" field to the splitters table
* Devices can be added manually in the VLAN card

'''Switching scheme:'''
* Labels on the switching scheme can be rotated
* When adding a splitter from the switching scheme, the user no longer leaves the scheme for the splitter card
* The switching wizard can now switch devices
* Added the ability to quickly change labels for all ports at once for a distribution frame/ODF in the switching scheme
* Planned commutations in the replanning scheme can now have their route changed manually
* On mobile devices, dragging switching lines is blocked by default when the page is opened

'''Tasks:'''
* Updated task [[Calendar|calendar]]:
** '''dragging tasks ''(changing work time)'''''
** task due time can be changed ''(by dragging the lower boundary)''
** weekly/monthly mode for departments and employees
** modes: "department" / "+ employees" / "+ employees and departments"
** 15/30/60 minutes ''(previously only one-hour slots)''
** high priority is marked, and the information template for the task title and task body can be configured
* '''Checks whether a previously attached file still exists in tasks and task comments ''(to prevent employees from attaching old files as if they were new)'''''
* The task card can transfer inventory available to the employee with one button
* Added a new special type for task types: "Work with debtors"
* The task card shows a row with coordinates and a quick link to Google Maps
* When creating a child task from the task card, files from the parent task can also be copied ''(used)''
* Improved display of inventory information in the inventory list when the task status changes
* "Work notes" were extended from buildings to any address object

* New settings:
** "Sort customers in the task card by the order in which they were added to the task"
** "Interval for displaying tasks in the My tasks section (days)"
** "Block execution of task automation/chain when a task is returned from a status with the system role Deferred"

* Task chains/automation:
** Added the additional condition "Task. Tag"
** Added action variants:
*** "Parent task (the very first in the chain). Change status to"
*** "Parent task (all in the chain). Change status to"
*** "Inventory. Transfer to parent task"
*** "Inventory. Transfer to child task"
*** "Transfer custom field values to the building card"

* Task list:
** The task list can show thumbnails of attached files ''(setting)''
** Task filter:
*** added "and/or" modes
*** expanded filter by parent task number
*** expanded filter by "Completed with due time over..."
*** expanded filter by parent task number
*** added filtering by checklist value
** Added group actions in the task list:
*** "Customers - Open list"
*** "Assign owner"
*** "Remove owner"

'''Warehouse:'''
* '''Warehouse operations now have filtering by "Address (with objects)", which allows selecting inventory transfer operations for all objects in that area'''
* '''The inventory list can now be filtered by any address object ''(including the full hierarchy)'' ''(region, city, street, etc.)'''''
* The inventory list shows a totals row with total cost/purchase cost
* In the inventory balance report, report item names are links for quickly viewing the corresponding inventory list
* Added groups for suppliers
* Added the ability to send an employee a Messenger/Telegram message when inventory is transferred to or from that employee's accountability
* When splitting inventory, MAC addresses/serial numbers can be specified for the resulting items immediately

'''Coverage:'''
* Added automatic real-time GPS position updates for transport on the map ''(every N seconds)''. Added the "Transport position update interval on the map" setting
* '''When several objects overlap on the map ''(communications installations at one point, many closures on one pole, cable lines running next to each other, etc.)'', hovering over this cluster expands it so the required object can be selected'''
* Improved display of cable lines that pass through the visible map area while their endpoints are outside the current view
* Added a new ruler on the map
* Added a new map object type: "Link"
* Popup hints on map polygons now show custom field values
* The building list can show the penetration percentage field and the "Notes" field, and a filter for this field was added

'''Communications installations:'''
* A communications installation can be hidden from the coverage map
* Added the "Suggest a new number when adding an object" parameter for communications installation types
* In the cabinet/rack layout, popup hints on devices now show serial/inventory numbers

'''Cable lines:'''
* Added filtering by custom fields in the cable line list
* In group actions for replacing the cable brand in the cable line list, this action can also replace module/fiber/conductor colors in the cable according to the new cable brand

'''Employees:'''
* Added a personal setting for extra buttons in the left menu of the mobile version, including custom links
* New rights in employee profiles:
** View/change supplier information
** View/change employee fines and bonuses

'''API:'''
* '''Separate [[UserSide API Key EN|API keys]] can now be created for read-only operations'''
* '''All requests that write or modify data must now be sent only through POST'''
* Requests must not include extra parameters. If an extra parameter is present, the request returns an error
* Improved API method API->address->[[API_address_EN#edit_address|edit_address]]
* Improved API method API->attach->[[API_attach_EN#add|add]]
* Added API method API->attach->[[API_attach_EN#upload|upload]]

'''Transport:'''
* '''Transport operations were deeply reworked. Different types, mileage and deadline control, home-page and transport-list notifications, and operation change history are now supported'''

'''Other:'''
* PHP 8.4
* Added Albanian, Uzbek, and Tajik localizations. Multiple fixes in existing localizations.
* '''The [[usm_asterisk]] module now supports transferring call recordings and listening to them in the ERP interface'''
* Switched objects from numeric IDs to string UUIDs ''(numeric IDs remain for some objects as additional reference values)''
* New WYSIWYG editor
* '''Dark interface theme ''(with automatic switching support)'''''
* '''Custom field values can be edited directly in object cards while viewing them ''(without switching to edit mode)'''''
* '''Reworked attached-file block'''
** Completely different capabilities, gallery, actions, and more
** Quick "Take photo" button for mobile devices
** Large file-add button for mobile devices
** The Ctrl+V clipboard block now supports pasting multiple images and files of any format ''(not only images)''
* New adaptive left menu with hide/show support
* '''Added buttons to the left menu for mobile devices:'''
** "My position on the map"
** QR code
** Barcode ''(and it can beep while scanning)''. If such an inventory item exists, its card opens; if there are no rights to the inventory item but such equipment exists, the equipment card opens. Otherwise, the search list opens
** Three buttons for custom links
** Buttons to share/open a link
* '''Added the "Convert HEIC files to JPEG" option and on-the-fly .heic file support'''
* The "Notebook" section was transformed into a configurable custom section. This significantly expands its functionality
* New barcode generation library ''(SVG format)''
* Improved the cash receipts report: grouping by settlements and by settlements + months, plus detailed payment list viewing
* In group actions for objects, the "Apply" button now shows the number of selected objects and is blocked if no action/objects are selected
* The date/date-time selector localization was fixed for the current language
* A compatibility solution for dates after 2038 was implemented preventively ''("Unix 2038 bug")''
* Separate SMS profiles for work. For example, each SMS mailing can use a separate SMS profile ''(custom alpha name, different operator, etc.)''
* Object-list filters by custom field values now include "greater than" and "less than" variants
* New versions of external [[Modules_EN|modules]]

* Other changes: see https://wiki.userside.eu/3.20

Версії 3.20

2026-06-15T06:31:28Z

IronBot: [IronBot] Sync UK localization from RU

[[Versions 3.20 EN|en]] | '''uk''' | [[Версии_3.20|ru]]

Версії гілки [[3.20_UK|3.20]]

Також див.: [[Версії ERP "USERSIDE"]]

== 3.20.25 (у розробці) ==
* Виправлено помилку з відображенням списку кабельних ліній ''(у деяких випадках)''

== 3.20.24 - 27.05.2026 ==
* Виправлення невеликих помилок та змін

== 3.20.23 - 27.04.2026 ==
* Додано метод API->call->[[API_call_UK#agent_call|agent_call]]
* Додано метод API->chapter->[[API_chapter_UK#link_add|link_add]]
* Додано метод API->chapter->[[API_chapter_UK#link_get|link_get]]
* Додано метод API->chapter->[[API_chapter_UK#link_remove|link_remove]]
* Доопрацьовано метод API->call->[[API_call_UK#add|add]]
* Доопрацьовано метод API->task->[[API_task_UK#edit|edit]]
* У виконаних завданнях також відображається ознака "Прострочено" під час порушенні термінів робіт
* Виправлена помилка з входом у календар робіт ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.20.22 - 04.04.2026 ==
* Виправлено вибір порожнього значення в типі завдань для реєстрації телефоном
* Оптимізаційні роботи
* Виправлення невеликих помилок

== 3.20.21 - 11.03.2026 ==
* Виправлено відображення лічильника помилок на інтерфейсах пристроїв ''(у деяких випадках)''
* Виправлено налаштування шаблонів SMS-повідомлень для абонентів у завданнях
* Оптимізаційні роботи
* Виправлення невеликих помилок

== 3.20.20 - 22.02.2026 ==
* Оптимізована робота розділу "Мої завдання"
* Виправлено порушення розмітки головного меню в деяких випадках

== 3.20.19 - 08.02.2026 ==
* Виправлення невеликих помилок

== 3.20.18 - 23.01.2026 ==
* Оптимізація звіту за складу "Оборотно-сальдова відомість"
* Виправлення невеликих помилок

== 3.20.17 - 31.12.2025 ==
* Додано метод API->task->[[API_task_UK#add_node_to_task|add_node_to_task]]
* Додано метод API->task->[[API_task_UK#remove_node_from_task|remove_node_from_task]]
* Виправлено виконання ланцюжка завдань ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.20.16 - 14.12.2025 ==
* Виправлена помилка з фільтрацією за секції ТМЦ у списку операцій за складу
* Виправлення невеликих помилок

== 3.20.15 - 06.12.2025 ==
* Для ланцюжків завдань/автоматизації в типах завдань додано можливість вказівки дробового інтервалу годинника
* Виправлення невеликих помилок

== 3.20.14 - 29.11.2025 ==
* Доопрацювання API взаємозв'язку з Binotel
* Виправлення невеликих помилок

== 3.20.13 - 22.11.2025 ==
* Виправлення невеликих помилок

== 3.20.12 - 15.11.2025 ==
* Додано параметр налаштування "Масштабувати ширину кабельної лінії на схемі комутації в залежності від довжини назви"
* Допрацьовано відображення невідомих ONU за OLT у віджеті головної сторінки
* Виправлення інших невеликих помилок

== 3.20.11 - 08.11.2025 ==
* Виправлення помилки під час вході в розділ Custom-повідомлень ''(у деяких випадках)''
* Виправлення помилки під час вході в налаштування інтерфейсів/стекування за пристрої ''(у деяких випадках)''
* Виправлена неможливість комутації між ODF/кросами у майстрі комутацій
* Виправлення деяких помилок міграції

== 3.20.10 - 07.11.2025 ==
* Додано метод API->vehicle->[[API_vehicle_UK#add|add]]
* Додано метод API->vehicle->[[API_vehicle_UK#edit|edit]]
* Додано метод API->vehicle->[[API_vehicle_UK#delete|delete]]
* У картці спорудження зв'язку в блоці з прикріпленими файлами-зображеннями можна швидко зробити зображення основним фото для цього об'єкта ''(без необхідності переходити до редагування)''
* У картці кабельної лінії додано можливість створити завдання з цією лінією або додати лінію до існуючого завдання
* Доопрацьовано сортування за додатковими полями у власних розділах
* Виправлена фільтрація за найменуванням ТМЦ у списку ТМЦ
* Виправлено відображення шарів обладнання на карті покриття
* Виправлення інших невеликих помилок

== 3.20.9 - 14.09.2025 ==
* Доопрацювання перевірки прав доступу до ONU
* Виправлена помилка під час пошуку абонента під час передачі ТМЦ ''(у деяких випадках)''
* Виправлено оновлення на базі серійних номерів для ONU під час опитуванні OLT ''(у деяких випадках)''

== 3.20.8 - 06.09.2025 ==
* Додано метод API->billing->[[API_billing_UK#refresh_date_update|refresh_date_update]]
* Оптимізовано інтерфейс редагування/додавання адресної одиниці ''(актуально для розгалужених адресних структур)''
* У картці завдання додані посилання на перегляд зв'язаних абонентів із спорудами зв'язку та з кабельними лініями
* Виправлена перевірка на статус батьківського завдання в автоматизації дій із завдань ''(у деяких випадках)''
* Виправлено відображення спливаючої підказки в календарі завдань під час горизонтальному скролі
* Виправлено призначення співробітників у підрозділ ''(у деяких випадках)''

== 3.20.7 - 25.08.2025 ==
* '''Глибока переробка операцій із транспорту. Різні типи, контроль пробігу, терміни. Повідомлення на головну сторінку та список транспорту. Ведення історії змін в операціях '''
* Історія дій щодо потенційного абонента переноситься в історію дій звичайного абонента під час їх об'єднанні
* При гарячій заміні пристрою можна вказати збереження історії MAC-адрес на портах обладнання
* У групових діях за списком абонентів додано можливість очищення комутації
* Технічні міграції даних ядра
* Виправлена фільтрація FDB-таблиці з пристрою ''(у деяких випадках)''
* Виправлена помилка під час обмеженні співробітнику доступу за конкретною IP-адресою
* Виправлено перевірку прав на доступ до ONU

== 3.20.6 - 15.08.2025 ==
* ''' Окремі SMS-профілі для роботи. Наприклад, для кожної SMS-розсилки можна вказати окремий SMS-профіль ''(власне альфа-ім'я, інший оператор...)'''''
* Виділено окремі права доступу до ONU на перегляд та зміну
* Виправлено відображення великої кількості розділів блокнота у списку розділів
* Виправлено оновлення інформації під час додавання/виключенні споруди зв'язку в завданні

== 3.20.5 - 08.08.2025 ==
* Додано метод API->address->[[API_address_UK#get_building_type|get_building_type]]
* Додано параметр налаштування "Будівлі. Шаблон спливаючого повідомлення на карті"
* Доопрацьовано інтерфейс зміни нотатки, типу адаптера та з'єднання для волокна кабельної лінії
* Перероблено інтерфейс додавання споруд зв'язку та кабельних ліній у завдання під час створення завдання
* Підкориговано перевірку прав доступу до табеля робіт
* Доопрацьовано тарифікацію співробітникам за завдання у відомості робіт за участю в завданні понад 5 співробітників
* Виправлена помилка фільтрації за будівлі у списку операцій за складом ''(у деяких випадках)''

== 3.20.4 - 04.08.2025 ==
* Додано метод API->cross->[[API_cross_UK#edit_adapter|edit_adapter]]
* Доопрацьовано метод API->task->[[API_address_UK#edit_address|edit_address]]
* Додано параметр налаштування "Заблокувати виконання автоматизації/ланцюжка завдань під час поверненні завдання зі статусу із системною роллю "Відкладено"
* У списку завдань додано угруповання завдань за вулиці або населеному пункту
* Доопрацювання збереження прикріплених файлів до коментарів за завданням
* Невеликі виправлення та доопрацювання

== 3.20.3 - 27.07.2025 ==
* Доопрацьовано метод API->task->[[API_task_UK#change_state|change_state]]
* Додано параметр налаштування "З'єднання на дільниках вважати механічними"
* У налаштуваннях типів завдань для ТМЦ можна вказати, що переміщати всі ТМЦ після закриття на зв'язану будівлю
* У ланцюжках/автоматизації за типами завдань додано можливість додаткової умови "Статус дочірнього/батьківського завдання" для варіантів дій "Батьківське/Дочірнє завдання. Змінити статус на"
* У картці будівлі у списку ТМЦ додано інформацію про дату встановлення ТМЦ на будівлі та можливість експорту в XLS та у версію для друку
* У картці можна скопіювати всі прикріплені файли з іншого завдання
* У картці абонента додано пряме посилання на перегляд його маршруту комутації
* Для профілів співробітників можна обмежити максимальну кількість записів на сторінці ''(у таблицях/списках)''
* У фільтр зі споруд зв'язку додано можливість вибірки за відсутнім власним значком на карті
* У списку операцій за складу в селекторах вибору контрагента додано можливість вказівки конкретної будівлі
* У групових діях за будівлях додано можливість зміни індивідуального кольору на карті
* У групових діях за будинках можна змінити менеджера на порожнє значення ''(видалити менеджера)''
* Виправлено сортування за адресою у списку завдань ''(у деяких випадках)''
* Виправлена можливість одночасно відкласти завдання та вказати довільний коментар

== 3.20.2 - 18.07.2025 ==
* Додано метод API->task->[[API_task_UK#add_cable_line_to_task|add_cable_line_to_task]]
* Додано метод API->task->[[API_task_UK#remove_cable_line_from_task|remove_cable_line_from_task]]
* Список підключених ONU на OLT можна виводити на друк або експортувати до XLS
* Для споруд зв'язку та кабельних ліній додано можливість у групових діях змінювати нотатки
* У шаблоні спливаючої підказки на завдання на карті покриття можна відображати дату створення завдання, дату оновлення, текст останнього коментаря
* У ланцюжках/автоматизації за типами завдань додано дію "Абоненти. Виключити"
* Для ланцюжків/автоматизації в типах завдань додана можливість відключати автопризначуваних виконавців під час створення нового завдання за ланцюжку
* Доопрацьовано відображення посилань в описі типу завдань у картці завдання
* Виправлена фільтрація абонентів, що залежать від кросу/odf ''(у деяких випадках)''

== 3.20.1 - 12.07.2025 ==
* У списку будівель доданий фільтр за будівлях, у яких знято позначку "Відображати на карті"
* Виправлена неможливість відкрити картку автотранспорту зі списку
* Виправлено пошук за найменуванням кабельної лінії під час створення завдання ''(у деяких випадках)''
* Виправлення відображення інформації про абонента у списку завдань ''(у деяких випадках)''

== 3.20 - 09.07.2025 ==
* Реліз версії 3.20
* Список змін див. [[3.20_UK|3.20]]

3.21 UK

2026-06-15T06:31:28Z

IronBot: [IronBot] Sync UK localization from RU

[[3.21_EN|en]] | '''uk''' | [[3.21|ru]]

Дата випуску: '''червень 2026'''

''Основні зміни: https://promo.userside.eu/321/''

Див. також:
* [[Оновлення 3.21|Оновлення до версії 3.21]]
* [[Версії ERP "USERSIDE"]] | [[Версії 3.21|Версії 3.21]]

== Перелік змін ==

'''Особливої важливості:'''
* [[PWA (застосунок)|PWA ''(застосунок)'']]
* Автоматична побудова [[Бізнес-процес|схеми бізнес-логіки/робочого процесу]] для типів завдань на основі ланцюжків/автоматизації
* [[Календар|Оновлений календар]] завдань та [[Інтеграція з Google-календарем|інтеграція з Google-календарем]]
* Окремий [[Масова передача ТМЦ|інтерфейс для швидкої передачі ТМЦ]] через сканування або введення штрихкодів, серійних номерів тощо ''(зокрема з підтримкою сканування штрихкодів камерою мобільного пристрою)''
* [[Схема комутації#anchor_321|Снапшоти схем комутації]] виводяться на основній схемі та формуються безпосередньо під час операцій комутації/розриву комутації на споруді зв'язку
* У схемі комутації створення з'єднань, видалення та зміна ламаної з'єднання виконуються без перезавантаження й очікування сторінки ''(на практиці це пришвидшило роботу у 2-10 разів)''
* Панель на головній сторінці з [[Список завдань#anchor_321|лічильниками фільтрів за завданнями/показниками KPI]]
* "Фізичне" [[Підписання документів з абонентами|підписання документів з абонентами/клієнтами]] на планшетах ''(мобільних пристроях)''
* Реалізовано автооновлення GPS-позиції транспорту на мапі в реальному часі ''(кожні N секунд)''
* Віджет на головну сторінку: [[Статистика_UK#anchor_321|найпроблемніші абоненти та будинки]]
* Нова [[Структурна схема|структурна схема]]. Масштабування, збереження у SVG
* [[Internal API UK|Internal API]] v2. Подієва система в ERP
* Підтримка обліку IPv6 для обладнання та абонентів
* Оновлений UI/UX

'''Абоненти/клієнти:'''
* Реалізовано масовий імпорт потенційних абонентів
* У групових діях за абонентами додано можливість надіслати SMS
* '''В умовах SMS-розсилки можна додавати конкретних абонентів'''
* В SMS-розсилці додано фільтр "Ігнорувати відмову від отримання SMS"
* У груповому надсиланні email абонентам додано різні шаблони з даними про абонента
* У листуванні з абонентом можна вимкнути відображення коментарів за завданнями
* Додано зберігання історії статусів абонентів
* Список абонентів:
** '''У фільтрі підтримується режим "і/або"'''
** '''У фільтрі додано можливість включати/виключати умови ''(раніше можна було лише включати)'''''
** Додано фільтр "Абоненти, включені в обладнання"
** Додано фільтр за номером завдання. Також у картці завдання, де прикріплено від 3 абонентів, додано посилання на цей фільтр
** У списку абонентів додано можливість відображати поле "Менеджер"
** У списку залежних абонентів від пристрою/споруди зв'язку також враховуються абоненти, які не скомутовані, але мають пристрої ''(наприклад ONU)'', залежні від батьківського об'єкта

'''Обладнання:'''
* '''Додано вкладки в картці комутатора/обладнання'''
* Якщо для пристрою не вказано IP-адресу, він має один порт і при цьому підключений до вищого керованого комутатора, то в таблиці портів цього пристрою виводитиметься SNMP-інформація з порту вищого пристрою
* PON:
** '''Історія зміни рівня сигналу ONU тепер виводиться у вигляді графіка'''
** Для списку підключених ONU можна налаштувати порядок і відображення полів
** У картці OLT на портах виводиться лічильник кількості ONU на них
* Можна вказувати відсотки поділу для запланованих дільників
* У таблиці дільників додано поле "Кількість зайнятих адаптерів"
* У картці VLAN додано можливість вручну додавати пристрої

'''Схема комутації:'''
* Написи на схемі комутації можна повертати під кутом
* Під час додавання дільника зі схеми комутації більше не відбувається перехід у картку дільника: користувач залишається у схемі
* У майстрі комутації додано можливість комутації пристроїв
* Для кросу/ODF у схемі комутації додано можливість швидко змінювати підписи для всіх портів одразу
* Для запланованих комутацій у схемі перепланування додано можливість змінювати маршрут вручну

'''Завдання:'''
* Оновлений [[Календар|календар завдань]]:
** '''перетягування завдань ''(зміна часу робіт)'''''
** можна змінювати строк виконання завдання ''(перетягувати нижню межу)''
** тижневий/місячний режим для підрозділів і співробітників
** режим "підрозділ"/"+співробітники"/"+співробітники і підрозділи"
** 15/30/60 хвилин ''(раніше тільки слоти по 1 годині)''
** позначається факт високого пріоритету, а також можна налаштовувати шаблон інформації для заголовка завдання і тіла завдання
* '''Перевірка існування раніше прикріпленого файла в завданнях і коментарях до завдання ''(щоб запобігти спробам співробітників прикріплювати старі файли, видаючи їх за нові)'''''
* У картці завдання додано можливість однією кнопкою передати ТМЦ із доступних цьому співробітнику
* Новий спецтип для типів завдань: "Роботи з боржниками"
* У картці завдання виводиться рядок з координатами і швидким переходом на Google-мапу
* Під час створення дочірнього завдання з картки завдання додано можливість копіювати ''(використовувати)'' також файли з батьківського завдання
* Дороблено відображення інформації про ТМЦ у списку ТМЦ під час зміни статусу завдання
* "Робочі нотатки" розширено з будинків на будь-який адресний об'єкт

* Нові параметри налаштування:
** "У картці завдання сортувати абонентів за порядком їх додавання в завдання"
** "Інтервал для відображення завдань у розділі "Мої завдання" (днів)"
** "Заблокувати виконання автоматизації/ланцюжка завдань під час повернення завдання зі статусу із системною роллю "Відкладено"

* Ланцюжки завдань/автоматизація:
** Додано додаткову умову "Завдання. Мітка"
** Додано варіанти дій:
*** "Батьківське завдання (найперше в ланцюжку). Змінити статус на"
*** "Батьківське завдання (усі в ланцюжку). Змінити статус на"
*** "ТМЦ. Передати в батьківське завдання"
*** "ТМЦ. Передати в дочірнє завдання"
*** "Перенесення значень додаткових полів у картку будинку"

* Список завдань:
** У списку завдань виводяться мініатюри прикріплених файлів ''(параметр налаштування)''
** Фільтр завдань:
*** додано режими "і/або"
*** розширено фільтр за номером батьківського завдання
*** розширено фільтр за "Виконано зі строком виконання понад..."
*** розширено фільтр за номером батьківського завдання
*** додано фільтр за значенням чек-листа
** У списку завдань додано групові дії:
*** "Абоненти - Відкрити список"
*** "Призначити власника"
*** "Виключити власника"

'''Склад:'''
* '''В операціях за складом додано фільтрацію за "Адреса (з об'єктами)", що дозволяє вибрати операції передачі ТМЦ на всі об'єкти цієї території'''
* '''У списку ТМЦ додано можливість фільтрації за будь-яким адресним об'єктом ''(включно з усім підпорядкуванням)'' ''(область, місто, вулиця...)'''''
* У списку ТМЦ виводиться підсумковий рядок із загальною вартістю/закупівельною вартістю
* У звіті щодо залишків ТМЦ назви позицій ТМЦ зроблено посиланнями для швидкого перегляду списку цих ТМЦ
* Групи для постачальників
* Додано можливість надсилати повідомлення співробітнику в Messenger/Telegram під час передачі ТМЦ йому під звіт/з-під звіту
* Під час розділення ТМЦ додано можливість одразу вказувати MAC-адреси/серійні номери для цих ТМЦ

'''Покриття:'''
* Реалізовано автооновлення GPS-позиції транспорту на мапі в реальному часі ''(кожні N секунд)''. Додано параметр налаштування "Інтервал оновлення позиції транспорту на мапі"
* '''Коли на мапі кілька об'єктів накладено один на одного ''(споруди зв'язку в одній точці/багато муфт на опорі... або кабельні лінії проходять поруч)'', то під час наведення на це скупчення об'єктів воно розкривається з можливістю вибрати потрібний'''
* Доробка відображення на мапі кабельних ліній, які проходять через екран, але мають кінцеві точки поза поточною областю відображення
* Нова лінійка на мапі
* Новий тип об'єктів на мапу: "Посилання"
* У спливних підказках на полігонах на мапі виводяться значення додаткових полів
* У списку будинків додано можливість виведення поля з відсотком проникнення, поле "Нотатки" і фільтр за цим полем

'''Споруди зв'язку:'''
* Для споруди зв'язку можна вказати приховування її з мапи покриття
* Для типів споруд зв'язку додано параметр "Під час додавання об'єкта пропонувати новий номер"
* У макеті шафи/стійки у спливних підказках на пристроях додано відображення серійного/інвентарних номерів

'''Кабельні лінії:'''
* У списку кабельних ліній додано фільтр за додатковими полями
* У групових діях із заміни марки кабелю в списку кабельних ліній додано можливість під час цієї дії замінювати кольори модулів/волокон/провідників у кабелі відповідно до нової марки кабелю

'''Співробітники:'''
* Налаштування в персональному налаштуванні: додаткові кнопки для лівого меню в мобільній версії, зокрема власні посилання
* Нові права в профілях співробітників:
** Перегляд/зміна інформації про постачальників
** Перегляд/зміна штрафів і премій персоналу

'''API:'''
* '''Можна створювати окремі [[UserSide API Key UK|API-ключі]] тільки для операцій читання даних'''
* '''Усі запити на запис/зміну даних тепер мають надсилатися лише через POST'''
* У запиті не повинно бути сторонніх параметрів. Якщо сторонній параметр присутній, запит повертатиме помилку
* Доопрацьовано метод API->address->[[API_address_UK#edit_address|edit_address]]
* Доопрацьовано метод API->attach->[[API_attach_UK#add|add]]
* Додано метод API->attach->[[API_attach_UK#upload|upload]]

'''Транспорт:'''
* '''Глибоко перероблено операції за транспортом. Різні типи, контроль пробігу, строків. Повідомлення на головну сторінку і список транспорту. Ведення історії змін в операціях'''

'''Інше:'''
* PHP 8.4
* Додано локалізації: албанська, узбецька, таджицька. Численні виправлення в поточних локалізаціях.
* '''Модуль [[usm_asterisk]] тепер підтримує передачу записів дзвінків і можливість прослуховувати їх в інтерфейсі ERP'''
* Перехід із числових ID на рядкові UUID в об'єктах ''(числові ID для частини об'єктів залишено як додаткові довідкові)''
* Новий редактор WYSIWYG
* '''Темна схема інтерфейсу ''(з підтримкою автоматичного перемикання)'''''
* '''Редагування значень додаткових полів у картках об'єктів прямо в режимі перегляду ''(без потреби переходити в редагування)'''''
* '''Перероблено блок роботи з прикріпленими файлами'''
** Повністю інші можливості, галерея, дії тощо
** Для мобільних пристроїв швидка кнопка "Фотографувати"
** Для мобільних пристроїв велика кнопка додавання файлів
** Блок Ctrl+V для роботи з буфером обміну тепер підтримує вставлення кількох зображень і файлів будь-яких форматів ''(а не лише зображень)''
* Нове ліве адаптивне меню з можливістю приховування/відкриття
* '''Додано кнопки в лівому меню для мобільних пристроїв:'''
** "Моя позиція на мапі"
** QR-код
** Штрихкод ''(+ може подавати звуковий сигнал під час сканування)''. Якщо є такий ТМЦ, відкривається картка ТМЦ; якщо немає прав до ТМЦ, але є таке обладнання, відкривається картка обладнання. Інакше відкривається список пошуку
** Три кнопки для власних посилань
** Кнопки поділитися посиланням/відкрити посилання
* '''Опція "Конвертувати HEIC-файли в JPEG" і власне підтримка роботи з .heic файлами на льоту'''
* Розділ "Блокнот" трансформувався в налаштовуваний власний розділ. Це значно розширює його функціональність
* Нова бібліотека генерації штрихкодів ''(у SVG-форматі)''
* Дороблено звіт за надходженнями коштів: групування за населеними пунктами, а також за населеними пунктами + місяцями, і можливість детального перегляду списку платежів
* У групових діях за об'єктами кнопка "Застосувати" тепер містить кількість позначених об'єктів і блокується, якщо не вибрано дію/об'єкти
* Селектор вибору дати/дати-часу: виправлено локалізацію під поточну мову
* Превентивно впроваджено рішення для забезпечення сумісності з датами після 2038 року ''("Unix 2038 bug")''
* Окремі SMS-профілі для роботи. Наприклад, для кожної SMS-розсилки можна вказати окремий SMS-профіль ''(власне альфа-ім'я, інший оператор...)''
* У списках об'єктів у фільтрацію за значеннями додаткових полів додано варіанти фільтрації "більше" і "менше"
* Нові версії зовнішніх [[Модулі#Поточні_версії_модулів|модулів]]

* Інші зміни: див. https://wiki.userside.eu/3.20

Версії 3.21

2026-06-15T06:31:27Z

IronBot: [IronBot] Sync UK localization from RU

[[Versions_3.21_EN|en]] | '''uk''' | [[Версии_3.21|ru]]

Версії гілки [[3.21_UK|3.21]]

Див. також: [[Версії_ERP_"USERSIDE"|Версії ERP "USERSIDE"]]

== 3.21.0-beta.4 - 13.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.3 - 07.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.2 - 30.05.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.1 - 24.05.2026 ==
* Перелік змін див. у [[3.21_UK|3.21]]

3.21 EN

2026-06-15T06:31:17Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[3.21_UK|uk]] | [[3.21|ru]]

Release date: '''June 2026'''

''Main changes: https://promo.userside.eu/321/''

See also:
* [[Upgrade_3.21|Upgrade to version 3.21]]
* [[Versions of ERP "USERSIDE"]] | [[Versions 3.21 EN|Versions 3.21]]

== List of changes ==

'''High-priority changes:'''
* [[PWA (application)|PWA ''(application)'']]
* Automatic building of a [[Business process|business logic/workflow diagram]] for task types based on task chains and automation
* Updated task [[Calendar|calendar]] and [[Google Calendar integration|Google Calendar integration]]
* A separate [[Bulk inventory transfer|interface for fast inventory transfer]] by scanning or entering barcodes, serial numbers, and other identifiers ''(including barcode scanning with a mobile device camera)''
* [[Switching scheme#anchor_321|Switching scheme snapshots]] are shown on the main scheme and are generated directly during switching/disconnection operations on a communications installation
* In the switching scheme, creating connections and deleting or changing a connection polyline is performed without reloading or waiting for the page ''(in practice, this made work 2-10 times faster)''
* A home-page panel with [[Work schedule#anchor_321|task filter counters/KPI indicators]]
* "Physical" [[Document signing with customers|document signing by customers/clients]] on tablets ''(mobile devices)''
* Automatic real-time GPS position updates for transport on the map ''(every N seconds)''
* Home-page widget with [[Statistics#anchor_321|the most problematic customers and buildings]]
* New [[Structural scheme|structural scheme]]. Scaling and SVG export
* [[Internal API EN|Internal API]] v2. Event system in ERP
* IPv6 accounting support for equipment and customers
* Updated UI/UX

'''Customers/clients:'''
* Added mass import of potential customers
* Added the ability to send SMS in group actions for customers
* '''Specific customers can be added to SMS mailing conditions'''
* Added the "Ignore SMS opt-out" filter to SMS mailings
* Added different customer-data templates for group email sending to customers
* Customer correspondence can hide comments from tasks
* Added customer status history storage
* Customer list:
** '''The filter now supports "and/or" mode'''
** '''The filter can now include/exclude conditions ''(previously it could only include them)'''''
** Added the "Customers included in equipment" filter
** Added filtering by task number. The task card also shows a link to this filter when at least three customers are attached to the task
** The customer list can display the "Manager" field
** The list of customers dependent on a device/communications installation also includes customers that are not commutated but have devices ''(for example ONU)'' that depend on the parent object

'''Equipment:'''
* '''Added tabs to the switch/equipment card'''
* If a device has no IP address, has one port, and is connected to an upstream managed switch, the port table for that device shows SNMP information from the upstream device port
* PON:
** '''ONU signal level history is now displayed as a chart'''
** The order and displayed fields can be configured for the list of connected ONUs
** The OLT card now shows an ONU counter on ports
* Split percentages can be specified for planned splitters
* Added the "Number of occupied adapters" field to the splitters table
* Devices can be added manually in the VLAN card

'''Switching scheme:'''
* Labels on the switching scheme can be rotated
* When adding a splitter from the switching scheme, the user no longer leaves the scheme for the splitter card
* The switching wizard can now switch devices
* Added the ability to quickly change labels for all ports at once for a distribution frame/ODF in the switching scheme
* Planned commutations in the replanning scheme can now have their route changed manually

'''Tasks:'''
* Updated task [[Calendar|calendar]]:
** '''dragging tasks ''(changing work time)'''''
** task due time can be changed ''(by dragging the lower boundary)''
** weekly/monthly mode for departments and employees
** modes: "department" / "+ employees" / "+ employees and departments"
** 15/30/60 minutes ''(previously only one-hour slots)''
** high priority is marked, and the information template for the task title and task body can be configured
* '''Checks whether a previously attached file still exists in tasks and task comments ''(to prevent employees from attaching old files as if they were new)'''''
* The task card can transfer inventory available to the employee with one button
* Added a new special type for task types: "Work with debtors"
* The task card shows a row with coordinates and a quick link to Google Maps
* When creating a child task from the task card, files from the parent task can also be copied ''(used)''
* Improved display of inventory information in the inventory list when the task status changes
* "Work notes" were extended from buildings to any address object

* New settings:
** "Sort customers in the task card by the order in which they were added to the task"
** "Interval for displaying tasks in the My tasks section (days)"
** "Block execution of task automation/chain when a task is returned from a status with the system role Deferred"

* Task chains/automation:
** Added the additional condition "Task. Tag"
** Added action variants:
*** "Parent task (the very first in the chain). Change status to"
*** "Parent task (all in the chain). Change status to"
*** "Inventory. Transfer to parent task"
*** "Inventory. Transfer to child task"
*** "Transfer custom field values to the building card"

* Task list:
** The task list can show thumbnails of attached files ''(setting)''
** Task filter:
*** added "and/or" modes
*** expanded filter by parent task number
*** expanded filter by "Completed with due time over..."
*** expanded filter by parent task number
*** added filtering by checklist value
** Added group actions in the task list:
*** "Customers - Open list"
*** "Assign owner"
*** "Remove owner"

'''Warehouse:'''
* '''Warehouse operations now have filtering by "Address (with objects)", which allows selecting inventory transfer operations for all objects in that area'''
* '''The inventory list can now be filtered by any address object ''(including the full hierarchy)'' ''(region, city, street, etc.)'''''
* The inventory list shows a totals row with total cost/purchase cost
* In the inventory balance report, report item names are links for quickly viewing the corresponding inventory list
* Added groups for suppliers
* Added the ability to send an employee a Messenger/Telegram message when inventory is transferred to or from that employee's accountability
* When splitting inventory, MAC addresses/serial numbers can be specified for the resulting items immediately

'''Coverage:'''
* Added automatic real-time GPS position updates for transport on the map ''(every N seconds)''. Added the "Transport position update interval on the map" setting
* '''When several objects overlap on the map ''(communications installations at one point, many closures on one pole, cable lines running next to each other, etc.)'', hovering over this cluster expands it so the required object can be selected'''
* Improved display of cable lines that pass through the visible map area while their endpoints are outside the current view
* Added a new ruler on the map
* Added a new map object type: "Link"
* Popup hints on map polygons now show custom field values
* The building list can show the penetration percentage field and the "Notes" field, and a filter for this field was added

'''Communications installations:'''
* A communications installation can be hidden from the coverage map
* Added the "Suggest a new number when adding an object" parameter for communications installation types
* In the cabinet/rack layout, popup hints on devices now show serial/inventory numbers

'''Cable lines:'''
* Added filtering by custom fields in the cable line list
* In group actions for replacing the cable brand in the cable line list, this action can also replace module/fiber/conductor colors in the cable according to the new cable brand

'''Employees:'''
* Added a personal setting for extra buttons in the left menu of the mobile version, including custom links
* New rights in employee profiles:
** View/change supplier information
** View/change employee fines and bonuses

'''API:'''
* '''Separate [[UserSide API Key EN|API keys]] can now be created for read-only operations'''
* '''All requests that write or modify data must now be sent only through POST'''
* Requests must not include extra parameters. If an extra parameter is present, the request returns an error
* Improved API method API->address->[[API_address_EN#edit_address|edit_address]]
* Improved API method API->attach->[[API_attach_EN#add|add]]
* Added API method API->attach->[[API_attach_EN#upload|upload]]

'''Transport:'''
* '''Transport operations were deeply reworked. Different types, mileage and deadline control, home-page and transport-list notifications, and operation change history are now supported'''

'''Other:'''
* PHP 8.4
* Added Albanian, Uzbek, and Tajik localizations. Multiple fixes in existing localizations.
* '''The [[usm_asterisk]] module now supports transferring call recordings and listening to them in the ERP interface'''
* Switched objects from numeric IDs to string UUIDs ''(numeric IDs remain for some objects as additional reference values)''
* New WYSIWYG editor
* '''Dark interface theme ''(with automatic switching support)'''''
* '''Custom field values can be edited directly in object cards while viewing them ''(without switching to edit mode)'''''
* '''Reworked attached-file block'''
** Completely different capabilities, gallery, actions, and more
** Quick "Take photo" button for mobile devices
** Large file-add button for mobile devices
** The Ctrl+V clipboard block now supports pasting multiple images and files of any format ''(not only images)''
* New adaptive left menu with hide/show support
* '''Added buttons to the left menu for mobile devices:'''
** "My position on the map"
** QR code
** Barcode ''(and it can beep while scanning)''. If such an inventory item exists, its card opens; if there are no rights to the inventory item but such equipment exists, the equipment card opens. Otherwise, the search list opens
** Three buttons for custom links
** Buttons to share/open a link
* '''Added the "Convert HEIC files to JPEG" option and on-the-fly .heic file support'''
* The "Notebook" section was transformed into a configurable custom section. This significantly expands its functionality
* New barcode generation library ''(SVG format)''
* Improved the cash receipts report: grouping by settlements and by settlements + months, plus detailed payment list viewing
* In group actions for objects, the "Apply" button now shows the number of selected objects and is blocked if no action/objects are selected
* The date/date-time selector localization was fixed for the current language
* A compatibility solution for dates after 2038 was implemented preventively ''("Unix 2038 bug")''
* Separate SMS profiles for work. For example, each SMS mailing can use a separate SMS profile ''(custom alpha name, different operator, etc.)''
* Object-list filters by custom field values now include "greater than" and "less than" variants
* New versions of external [[Modules EN#Current_versions_of_modules|modules]]

* Other changes: see https://wiki.userside.eu/3.20

Versions 3.21 EN

2026-06-15T06:31:17Z

IronBot: [IronBot] Sync EN localization from RU

Versions 3.20 EN

2026-06-15T06:31:17Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[Версії_3.20|uk]] | [[Версии_3.20|ru]]

Branch versions [[3.20_EN|3.20]]

Also see: [[Versions of ERP "USERSIDE"]]

== 3.20.25 (in development) ==
* Fixed a bug with displaying the cable line list ''(in some cases)''

== 3.20.24 - 27.05.2026 ==
* Fixed minor bugs and changes

== 3.20.23 - 27.04.2026 ==
* Added API method->call->[[API_call_EN#agent_call|agent_call]]
* Added API method->chapter->[[API_chapter_EN#link_add|link_add]]
* Added API method->chapter->[[API_chapter_EN#link_get|link_get]]
* Added API method->chapter->[[API_chapter_EN#link_remove|link_remove]]
* Improved API method->call->[[API_call_EN#add|add]]
* Improved API method->task->[[API_task_EN#edit|edit]]
* Completed tasks now also show the "Overdue" flag when work deadlines are missed
* Fixed a bug when opening the work calendar ''(in some cases)''
* Fixed minor bugs

== 3.20.22 - 04.04.2026 ==
* Fixed selecting an empty value in the task type for registration by phone
* Optimization work
* Fixed minor bugs

== 3.20.21 - 11.03.2026 ==
* Fixed display of the error counter on equipment interfaces ''(in some cases)''
* Fixed SMS message template settings for customers in tasks
* Optimization work
* Fixed minor bugs

== 3.20.20 - 22.02.2026 ==
* Optimized the "My tasks" section
* Fixed broken main menu layout in some cases

== 3.20.19 - 08.02.2026 ==
* Fixed minor bugs

== 3.20.18 - 23.01.2026 ==
* Optimized the warehouse report "Turnover balance sheet"
* Fixed minor bugs

== 3.20.17 - 31.12.2025 ==
* Added API method->task->[[API task#add_node_to_task|add_node_to_task]]
* Added API method->task->[[API task#remove_node_from_task|remove_node_from_task]]
* Fixed execution of task chain ''(in some cases)''
* Fixed minor bugs

== 3.20.16 - 14.12.2025 ==
* Fixed a bug with filtering by inventory section in the warehouse operations list
* Fixed minor bugs

== 3.20.15 - 06.12.2025 ==
* For task chains/automation in task types, added the ability to specify fractional hour intervals
* Fixed minor bugs

== 3.20.14 - 29.11.2025 ==
* Improvements to the API interface with Binotel
* Fixed minor bugs

== 3.20.13 - 22.11.2025 ==
* Fixed minor bugs

== 3.20.12 - 15.11.2025 ==
* Added the setting "Scale the width of the cable line on the switching diagram depending on the length of the name"
* Improved the display of unknown ONUs by OLT in the main page widget
* Fixed other minor bugs

== 3.20.11 - 08.11.2025 ==
* Fixed an error when entering the Custom notifications section ''(in some cases)''
* Fixed an error when entering the device interface/stacking settings ''(in some cases)''
* Fixed the inability to switch between ODF/crosses in the switching master
* Fixed some migration errors

== 3.20.10 - 07.11.2025 ==
* Added API method->vehicle->[[API vehicle#add|add]]
* Added API method->vehicle->[[API vehicle#edit|edit]]
* Added API method->vehicle->[[API vehicle#delete|delete]]
* In the communication installations card, in the block with attached image files, it is possible to quickly make an image the main photo for this object ''(without having to go to editing)''
* In the cable line card, the ability to create a task with this line or add a line to an existing task has been added
* Sorting by additional fields in custom sections has been improved
* Filtering by inventory item name in the inventory list has been fixed
* The display of equipment layers on the coverage map has been fixed
* Other minor bugs have been fixed

== 3.20.9 - 14.09.2025 ==
* Improved verification of access rights to ONU
* Fixed a bug when searching for a user during the transfer of inventory items ''(in some cases)''
* Fixed an update in the serial number database for ONU when polling OLT ''(in some cases)''

== 3.20.8 - 06.09.2025 ==
* Added API method->billing->[[API billing#refresh_date_update|refresh_date_update]]
* Optimised interface for editing/adding address units ''(relevant for branched address structures)''
* Links to view users associated with communication installations and cable lines have been added to the task card
* Fixed checking for parent task status in task automation ''(in some cases)''
* Fixed display of pop-up hints in the task calendar when scrolling horizontally
* Fixed assignment of employees to a department ''(in some cases)''

== 3.20.7 - 25.08.2025 ==
* '''In-depth processing of transport operations. Various types, mileage control, deadlines. Notification on the main page and transport list. Keeping a history of changes in operations'''
* The history of actions for a potential user is transferred to the history of actions for a regular user when they are merged
* During hot replacement of a device, you can specify to save the history of MAC addresses on equipment ports
* The ability to clear switching has been added to group actions on the user list
* Technical migration of core data
* Fixed filtering of the FDB table by device ''(in some cases)''
* Fixed a bug when restricting an employee's access to a specific IP address
* Fixed ONU access rights verification

== 3.20.6 - 15.08.2025 ==
* ''' Separate SMS profiles for work. For example, you can specify a separate SMS profile for each SMS mailing ''(your own alpha name, different operator, etc.)'''''
* Separated ONU access rights for viewing and editing
* Fixed display of a large number of notebook sections in the section list
* Fixed information update when adding/removing a communication facility in a task

== 3.20.5 - 08.08.2025 ==
* Added API method->address->[[API address#get_building_type|get_building_type]]
* Added the "Buildings. Pop-up message template on the map" setting
* Improved the interface for changing notes, adapter types, and connections for fibre cable lines
* Redesigned the interface for adding communication structures and cable lines to a task when creating a task
* Corrected the verification of access rights to the work schedule
* Improved the billing of employees for tasks in the work schedule when more than 5 employees are involved in the task
* Fixed a bug in filtering by building in the list of warehouse operations ''(in some cases)''

== 3.20.4 - 04.08.2025 ==
* Added API method->cross->[[API cross#edit_adapter|edit_adapter]]
* Added API method->task->[[API address#edit_address|edit_address]]
* Added a setting parameter "Block automation/task chain execution when returning a task from the status with the system role 'Pending' "
* Added grouping of tasks by street or location to the task list
* Improved saving of files attached to task comments
* Minor fixes and improvements

== 3.20.3 - 27.07.2025 ==
* Added API method->task->[[API task#change_state|change_state]]
* The "Consider connections on dividers as mechanical" configuration parameter has been added
* In the task type settings for inventory items, you can specify that all inventory items should be moved to the associated building after closing
* In chains/automation by task type, the additional condition "Child/parent task status" has been added for the action options "Parent/Child task. Change status to"
* Information about the date of installation of inventory items on the building and the ability to export to XLS and printable versions has been added to the building card in the inventory list
* All attached files from another task can be copied to the card
* A direct link to view the customer's switching route has been added to the customer card
* For employee profiles, you can limit the maximum number of entries on the page (in tables/lists)
* The filter for communication facilities now includes the option to select by missing custom icon on the map
* In the list of warehouse operations in the counterparty selection selectors, the ability to specify a specific building has been added
* In group actions for buildings, the ability to change the individual colour on the map has been added
* In group actions for buildings, you can change the manager to the empty value ''(delete manager)''
* Fixed sorting by address in the task list ''(in some cases)''
* Fixed the ability to simultaneously postpone a task and specify an arbitrary comment

== 3.20.2 - 18.07.2025 ==
* Added API method->task->[[API task#add_cable_line_to_task|add_cable_line_to_task]]
* Added API method->task->[[API task#remove_cable_line_from_task|remove_cable_line_from_task]]
* The list of connected ONUs on the OLT can be printed or exported to XLS
* For communication installations and cable lines the possibility to change notes in group actions has been added
* In the template of the tooltip on the task on the coverage map it is possible to display the date of task creation, update date, text of the last comment
* In chains/automation by task type, added action "Customers. Exclude."
* In chains/automation by task types, added possibility to disable auto-assigned executors when creating a new task in a chain
* Improved displaying of links in the description of a task type in the task card
* Fixed filtering of customers that depend on cross/odf ''(in some cases)''

== 3.20.1 - 12.07.2025 ==
* In the list of buildings, added filter for buildings with "Display on map" unchecked
* Fixed inability to open a vehicle card from the list
* Fixed search by cable line name when task is created ''(in some cases)''
* Fixed display of customer information in the task list ''(in some cases)''

== 3.20 - 09.07.2025 ==
* Release version 3.20
* For a list of changes see [[3.20_EN|3.20]]

Версії 3.21

2026-06-07T05:56:59Z

IronBot: [IronBot] Sync UK localization from RU

[[Versions_3.21_EN|en]] | '''uk''' | [[Версии_3.21|ru]]

Версії гілки [[3.21_UK|3.21]]

Див. також: [[Версії_ERP_"USERSIDE"|Версії ERP "USERSIDE"]]

== 3.21.0-beta.3 - 07.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.2 - 30.05.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.1 - 24.05.2026 ==
* Перелік змін див. у [[3.21_UK|3.21]]

Versions 3.21 EN

2026-06-07T05:56:59Z

IronBot: [IronBot] Sync EN localization from RU