Перейти до вмісту

Розширення 1С

Матеріал з K2 ERP Wiki
Приклади команд: Потрібно знайти всі розширення, зрозуміти, які поля, правила, звіти й інтеграції вони додають, і перенести не сам код 1С, а потрібну бізнес-логіку в K2 ERP, API або Power BI.; "order_number": "WEB-10025", Окремо варто відзначити який надає можливість доопрацьовувати типову конфігурацію без прямої зміни основної конфігурації виступає ключовою рисою Розширення 1С.;== Реквізити в розширеннях ==

Приклад: розширення для інтернет-магазину

  1. Додати реквізит “Канал продажу”.; # Додати відбір у звіт.; Розширення

Під час переходу з або BAS у K2 ERP потрібно аналізувати не тільки основну конфігурацію, а й усі розширення.; Деякі складні зміни все одно можуть вимагати глибшої доробки, але в багатьох випадках розширення є собою кращим варіантом.; | має змогу змінювати документи, регістри, обліковий облік і передавати інформаційні дані назовні.; Перед підтримкою, використанням або міграцією таких систем потрібно перевіряти актуальні офіційні обмеження.; # Які регістри читає.; Приклад JSON:

Для постійної бізнес-логіки часто краще розширення.; | Спрощує супровід і актуалізація порівняно з прямою зміною типової конфігурації.; Без розширення розробник змінює основну конфігурацію.; * для чого воно створене;

  • які об’єкти змінює;
  • які реквізити додає;
  • які форми змінює;
  • які модулі містить;
  • які підписки використовує;
  • які регістри читає або пише;
  • які права потрібні;
  • які інтеграції виконує;
  • які ризики має;
  • як його тестувати;
  • як його відключити.; |-
Розширення не функціонує після актуалізація Типова конфігурація змінила об’єкти Потрібна адаптація
Документ став повільно проводитися Важкий код у підписці Користувачі чекають або база зависає
інформаційні дані дублюються Підписка виконується кілька разів або немає контролю Дублі записів і рухів
користувач системи бачить зайві інформаційні дані Не налаштовані права на нові реквізити/звіти Витік чутливої інформації
Розширення змінює обліковий облік непомітно Немає документації й аудиту Важко знайти причину розбіжностей
Хардкод у коді Значення зашиті в модулі Складно переносити й підтримувати
Немає логування інтеграції Помилки не зберігаються Неможливо підтримувати обмін

як ілюстрація:

  • змінилася форма типового документа;
  • змінився реквізит;
  • змінився тип поля;
  • змінився компонент;
  • змінилася сигнатура події;
  • змінився регістр;
  • видалили об’єкт;
  • змінився механізм проведення.; # Додати заповнення за замовчуванням.; * отримати залишки товару;
  • отримати актуальні ціни;
  • перевірити борг контрагента;
  • записати статус інтеграції;
  • зберегти зовнішній ID;
  • отримати собівартість;
  • перевірити партії.;== Розширення і СКД ==

У простих випадках розширення застосовується для додавання поля на форму.;

Для таких інтеграцій потрібно контролювати:

Модулі розширень

з цієї причини розширення потрібно періодично ревізувати.; Розширення можуть містити саме ті поля і правила, які бізнес-середовище реально використовує щодня.;== Коротко ==

Приклад коду в розширенні

  • реквізит “ID сайту” в номенклатурі;
  • реквізит “ID сайту” в замовленні;
  • команду “Вивантажити на сайт”;
  • компонент формування JSON;
  • журнал помилок обміну;
  • регламентне задача;
  • звіт по статусах обміну.; Його потрібно перевіряти на копії бази і аналізувати код.;=== Чи можна через розширення змінити проведення документа? ===

} Що робити:

Розширення і права доступу

!; Аудит особливо важливий, якщо розширення впливає на фінансовий блок, складський облік, зарплату, ПДВ або виробництво.; Аналог у K2 ERP

Розширення і технічний борг

|- | Реквізит | Додане поле | Custom field / attribute | Тип, обов’язковість, історичний розвиток |- | Форма | Зміна інтерфейсу | UI form / layout | Чи потрібне поле користувачам |- | Команда | Дія користувача | Action / button / workflow | Права і логіка |- | Підписка на подію | Автоматична логіка | Event handler / business rule | Коли запускається |- | Загальний компонент | Спільний код | Service logic | Чи потрібна логіка |- | Звіт | аналітичні інструменти | Report / Power BI | Контрольні суми |- | інтеграційні функціональні можливості | Обмін даними | REST API / integration job | Формати, статуси, логи |}

Розширення 1С — це зручний механізм для доопрацювання типової конфігурації без прямого втручання в основну конфігурацію.;== Підписки на події ==

Задача: додати контроль технолога в специфікації.; Навіщо !; Підписка на подію — це механізм, який надає можливість виконати код при певній події об’єкта.; Це зручніше; додатково реалізовано але не скасовує потреби в тестуванні, аудиті коду і контролі впливу на обліковий облік.; | Проаналізувати всі розширення і перенести корисну бізнес-логіку в K2 ERP або Power BI.; |- | Що таке розширення 1С?; Типові варіанти:

  • “Канал продажу” в замовлення покупця;
  • “Тип клієнта” в контрагента;
  • “Відповідальний технолог” у специфікацію;
  • “Код зовнішньої системи” в номенклатуру;
  • “Ознака синхронізації” у документ;
  • “Маркетплейс” у замовлення;
  • “ID банківської транзакції” у платіж.;== Зовнішні посилання ==

Розширення і зовнішні звіти

!; |- | Зміна основної конфігурації | Розробник редагує типові об’єкти напряму | актуалізація стають складнішими |- | Розширення | Доробка зберігається в окремому шарі | Типову конфігурацію легше оновлювати |- | Зовнішня обробка | Окремий файл запускається вручну або через меню | комфортно для разових або допоміжних задач |- | Зовнішній звіт | Окремий файл формує звіт | комфортно для аналітики без зміни конфігурації |}

!;== Розширення і проведення документів ==

  • додати реквізит;
  • додати поле на форму;
  • додати просту перевірку;
  • додати друковану форму;
  • додати звіт;
  • додати команду;
  • додати логування;
  • реалізувати невелику інтеграцію;
  • не змінювати типову конфігурацію;
  • спростити актуалізація.;

Розширення має змогу читати регістри і в окремих випадках записувати інформаційні дані.;

Команди дозволяють додати користувацьку дію без зміни типової форми напряму.; Приклад:

Чому розширення має змогу не працювати після актуалізація?

Команда — це дія, яку користувач системи має змогу виконати з форми або списку.; Для перевірки потрібно звірити:

Чим розширення краще за зміну типової конфігурації?

Приклади:

Правильна міграція розширень — це не перенесення старого коду, а перенесення корисної бізнес-логіки в сучасну, безпечну і контрольовану ERP-архітектуру.;

Це сприяє уникнути повторного завантаження одного й того самого платежу.; істотно про та BAS. В Україні продукти екосистеми і частина продуктів BAS пов’язані з санкційними, юридичними, кібербезпековими та репутаційними ризиками.; "quantity": 2,

"customer": "ТОВ Ромашка",

|- | Реквізит | Канал продажу | Додаткова аналітичні інструменти |- | Команда | Вивантажити в CRM | інтеграційні функціональні можливості |- | Форма | Додаткова вкладка | Зручність користувача |- | Загальний компонент | компонент обміну з API | Спільна логіка |- | Звіт | продажі та реалізація по каналах | аналітичні інструменти |- | Обробка | Масове заповнення реквізиту | Сервісна задача |- | Підписка на подію | Перевірити мінімальну ціну перед проведенням | Контроль бізнес-правила |}

Висновок

Компанії потрібно додати в документ “Замовлення покупця” поле “Канал продажу”.; Для Каждого Рядок Из Джерело.Товары Цикл

Потрібно знати:

Розширення має змогу додавати звіти на системі компонування даних.;

Після актуалізація типова конфігурація має змогу змінити форми, реквізити, модулі, регістри або події, на які спиралося розширення.;=== Чи безпечно встановлювати розширення з інтернету? ===

Як перевіряти розширення перед встановленням

Коли розширення — поганий варіант

Розширення і HTTP-сервіси

  • обмін із сайтом;
  • обмін із CRM;
  • обмін із банком;
  • передача залишків;
  • передача цін;
  • отримання замовлень;
  • вивантаження рахунків;
  • передача статусів;
  • обмін із WMS;
  • обмін із MES;
  • підготовка даних для K2 ERP.; Що робити в K2 ERP

!; Зовнішня обробка

як ілюстрація:

  • хто встановив розширення;
  • хто змінив розширення;
  • яка реліз активна;
  • які об’єкти змінені;
  • які модулі виконуються;
  • які події перехоплюються;
  • які реквізити додані;
  • які інформаційні дані змінюються;
  • чи є собою вплив на обліковий облік;
  • як відключити розширення.; # Чи є собою документація.; це механізм платформи / 1С:організація.; |-

| Що найчастіше ламається?; Через розширення можна додавати реквізити, форми, команди, обробники подій, підписки на події, друковані форми, звіти, перевірки, інтеграційну логіку і інші зміни, зменшуючи ризики при подальшому оновленні типової конфігурації.;

  • реквізит “Відповідальний технолог”;
  • статус погодження;
  • команду “Відправити на погодження”;
  • заборону використання незатвердженої специфікації;
  • звіт по незатверджених специфікаціях.; Для чого
Сообщить("Канал продажу заповнений");
  1. Підписатися на подію перед проведенням реалізації.; # Додати його на форму документа.; Розширення має змогу містити власні модулі.; додатково у матеріалах щодо переліку вказано сфера застосування Указу Президента України №601/2024 для ТОВ «1С».; # Пройти по рядках товарів.;

Через розширення можна реалізувати:

  • вивантаження даних із доданих реквізитів;
  • вивантаження службових регістрів;
  • пошуку зовнішніх ID;
  • аналізу статусів інтеграцій;
  • підготовки контрольних сум;
  • формування JSON для імпорту;
  • порівняння старої і нової логіки;
  • підготовки даних для Power BI;
  • паралельного запуску 1С/BAS і K2 ERP.; !;=== Що істотно при міграції розширень у K2 ERP? ===
  • отримати інформаційні дані з документа;
  • сформувати JSON;
  • викликати API;
  • записати результат;
  • показати повідомлення користувачу;
  • залогувати помилку.; | Для реквізитів, форм, команд, перевірок, звітів, друкованих форм, інтеграцій і службової логіки.;== Що можна додавати через розширення ==

|- | Номенклатура | site_id | Зіставлення з товаром сайту |- | Замовлення | web_order_id | Зв’язок із замовленням сайту |- | Замовлення | exchange_status | Контроль обміну |}

історично є собою російською програмною екосистемою.; !; !; як ілюстрація:

Перед встановленням розширення потрібно перевірити:

Команди в розширеннях

  • їх багато;
  • вони не документовані;
  • дублюють одне одного;
  • мають хардкод;
  • змінюють критичну логіку;
  • не тестуються після оновлень;
  • створені різними розробниками без стандартів;
  • не мають власника;
  • містять тимчасові рішення для бізнесу, які стали постійними.; Його не можна підключати без перевірки джерела, коду, прав, логіки і впливу на інформаційні дані.; # Які регістри записує.; МінЦіна = ОтриматиМінімальнуЦіну(Рядок.Номенклатура, Джерело.Дата);

Чим розширення відрізняється від зміни конфігурації

Розширення і безпека

У версії потрібно фіксувати:

; # Перевірити модулі.; Розширення надає можливість частину доробок винести в окремий шар і спростити супровід.; У таких випадках краще переглядати архітектуру системи або планувати перехід у нову ERP.; !;== Розширення і міграція з 1С/BAS ==
Иначе

Коли розширення — хороший варіант

Для інтеграцій потрібно використовувати:

; # Які події перехоплює.; !; як ілюстрація:
Если Не ЗначениеЗаполнено(Объект.КаналПродажу) Тогда

У модулях описується логіка розширення.; # Перевірити змінені об’єкти.; Поганий приклад: при проведенні кожної реалізації розширення синхронно викликає зовнішній API і чекає відповідь.;

  1. Перевірити протокол помилки.; На практиці розширення часто застосовують, коли потрібно адаптувати типову BAS/1С під бізнес-середовище, але не “ламати” типову конфігурацію і не створювати важке супроводження.; Але розширення все одно потрібно тестувати після кожного актуалізація.;

Реплікатор K2 має змогу допомогти при аналізі й перенесенні даних із розширень або BAS у K2 ERP.; # Перевірити форми.; # Чи є собою логування.; Відповідь

Розширення має змогу бути невдалим варіантом, якщо потрібно:

Ні, без перевірки це ризиковано.; |}

Тестування розширень

Приклад задачі модуля:

У розширенні можна реалізувати логіку для HTTP-обміну, якщо це підтримується конкретною конфігурацією і платформою.; |-

Чим корисне?;

Див.; додатково

  • рахунок із додатковими реквізитами;
  • видаткова накладна з QR-кодом;
  • акт із новим шаблоном;
  • комерційна пропозиція;
  • гарантійний талон;
  • виробниче задача;
  • етикетка;
  • сертифікат якості.;

Можна додати перевірки, підписки на події або додаткову логіку, але змінювати проведення потрібно дуже обережно, щоб не зламати регістри, залишки, ПДВ або собівартість.; Для разового експорту або сервісної задачі — зовнішня обробка.;== Для чого потрібні розширення ==

  • у форму замовлення додали поле “Джерело ліда”;
  • менеджер заповнює його при створенні замовлення;
  • звіт продажів показує суму по джерелах;
  • інтеграційні функціональні можливості передає поле в CRM.; Приклад сценарію:

Сильна сторона розширень — гнучкість і простіше актуалізація.; # Для чого воно потрібне.; Розширення — це виконуваний код, який має змогу читати або змінювати інформаційні дані.; {| class="wikitable" style="width:100%;" {

"price": 1200
; Що означає
!; Практичний чек-лист:
Розширення зазвичай спрощує актуалізація, бо типова конфігурація менше змінюється напряму.; Потрібно перевіряти:

 "items": [

!; |-
| Додатковий реквізит
| Перенести як поле або аналітику
| Канал продажу
|-
| Перевірка
| Реалізувати бізнес-правилом
| Заборона продажу нижче мінімальної ціни
|-
| інтеграційні функціональні можливості
| Перепроєктувати через API
| Сайт, банк, CRM
|-
| Звіт
| Перенести в стандартний звіт або Power BI
| продажі та реалізація по каналах
|-
| Друкована форма
| Створити шаблон у K2 ERP
| Рахунок, акт, етикетка
|-
| Тимчасове рішення для бізнесу
| Не переносити
| Разова обробка 2022 року
|-
| Хардкод
| Замінити налаштуваннями
| складський облік, вид ціни, організація
|}

Тестувати потрібно на копії бази, а не одразу на робочій.;{{SEO
|title=Розширення 1С  доопрацювання без зміни конфігурації, модулі, форми, підписки на події, оновлення і міграція в K2 ERP
|description=Розширення 1С: що це таке, як працюють розширення конфігурації в 1С/BAS, чим відрізняються від зміни основної конфігурації, модулі, форми, реквізити, команди, підписки на події, безпечні доопрацювання, типові помилки, оновлення і міграція логіки в K2 ERP.
|keywords=розширення 1С, расширение 1С, розширення конфігурації 1С, доопрацювання 1С без зміни конфігурації, модулі розширення 1С, форми розширення 1С, підписки на події 1С, BAS розширення, K2 ERP, міграція з 1С
}}

[[Категорія:Зовнішні обробки]]

Краще:

== Помилка: розширення сповільнило систему ==

* мінімальна ціна;
* маржа;
* собівартість;
* зарплатна відомості;
* персональні інформаційні дані;
* банківські токени;
* інтеграційні ключі;
* виробничі рецептури;
* службові статуси.; # Протестувати на копії бази.; |-
| Чим небезпечне?; Критерій
|-
| 1.0
| 01.05.2026
| Додано реквізит “Канал продажу”
|-
| 1.1
| 10.05.2026
| Додано звіт по каналах
|-
| 1.2
| 20.05.2026
| Додано вивантаження каналу в CRM
|}

'''Розширення  це не без ускладнень “додаткова кнопка”.''' Це окремий шар бізнес-логіки, який має змогу впливати на обліковий облік, інтеграції, звіти, права і міграцію.; Приклади:
!; Елемент розширення 1С

* загальний компонент;
* компонент форми;
* компонент команди;
* компонент обробки;
* компонент звіту;
* код підписки на подію.; Об’єкт
Причини:

== Приклад використання розширення ==
Спрощений приклад команди, яка перевіряє заповнення реквізиту:
{{DISPLAYTITLE:Розширення 1С}}

Розширення має змогу бути небезпечним, якщо:
У продуктах [[BAS]] додатково застосовують, коли потрібно схожий підхід до розширень.; ([cip.gov.ua](https://cip.gov.ua/ua/statics/perelik-zaboronenogo-do-vikoristannya-programnogo-zabezpechennya-ta-komunikaciinogo-merezhevogo-obladnannya), [president.gov.ua](https://www.president.gov.ua/documents/6012024-52161))

Приклади:

</div>

Розширення зручніше, якщо потрібно:

== Документування розширень ==

!; як ілюстрація:

== Типові сценарії використання розширень ==

* реквізит “bank_transaction_id”;
* реквізит “bank_status”;
* звіт по нерозпізнаних платежах;
* обробку завантаження JSON-виписки;
* лог помилок;
* перевірку дублів.;== Варіанти перенесення логіки розширень у K2 ERP ==
 "sku": "SKU-001",

!; * [[1С]]
* [[BAS]]
* [[BAS ERP]]
* [[K2 ERP]]
* [[ERP]]
* [[Мова 1С]]
* [[Проведення документа 1С]]
* [[Рухи документа 1С]]
* [[Регістри 1С]]
* [[Регістр накопичення 1С]]
* [[Регістр відомостей 1С]]
* [[Регістр бухгалтерії 1С]]
* [[Регістр розрахунків 1С]]
* [[СКД 1С]]
* [[Запити 1С]]
* [[Зовнішня обробка 1С]]
* [[Зовнішній звіт 1С]]
* [[Регламентні завдання 1С]]
* [[Інтеграція через JSON]]
* [[Інтеграція з банками]]
* [[Типи цін 1С]]
* [[Партії 1С]]
* [[Виробництво 1С]]
* [[Специфікація 1С]]
* [[Закриття місяця 1С]]
* [[ПДВ 1С]]
* [[Зарплата 1С]]
* [[Кадровий облік 1С]]
* [[Power BI]]
* [[BI система]]
* [[Вивантаження даних 1С]]
* [[Міграція даних з 1С]]
* [[Міграція з 1С]]
* [[Міграція з BAS]]
* [[Заміна BAS]]
* [[Реплікатор K2]]
* [[Права доступу в ERP]]
* [[Аудит дій]]
* [[Українське програмне забезпечення]]
* [[Цифрова незалежність]]

 КонецЕсли;

* [https://www.president.gov.ua/documents/6012024-52161 Указ Президента України №601/2024]
* [https://cip.gov.ua/ua/statics/perelik-zaboronenogo-do-vikoristannya-programnogo-zabezpechennya-ta-komunikaciinogo-merezhevogo-obladnannya Перелік забороненого до використання програмного забезпечення та комунікаційного мережевого обладнання]
* [https://erp.kyiv.ua Сайт K2 ERP]
* [https://wiki.erp.kyiv.ua Wiki K2 ERP]
* [https://cloud.corp2.eu хмарна інфраструктура K2 ERP]

__TOC__
Причини:
{| class="wikitable" style="width:100%;"
!; Через розширення можна додавати поля, форми, команди, звіти, перевірки, підписки на події, інтеграції, друковані форми і службову логіку.; '''Критично.''' Розширення  це виконуваний код у вашій обліковій системі.; Приклад

[[Категорія:Регламентні завдання]]

Розширення можуть зменшити технічний борг, якщо використовуються правильно.;<div style="border:3px solid #b71c1c; background:#ffebee; padding:14px; margin:16px 0;">

Розширення добре підходить, якщо потрібно:

[[Категорія:Права доступу]]
<div style="border:3px solid #b71c1c; background:#ffebee; padding:14px; margin:16px 0;">
== Що таке розширення 1С ==

Проблеми можуть виникнути, якщо:
{| class="wikitable" style="width:100%;"
== Реплікатор K2 і розширення 1С ==
'''Небезпека.''' Якщо розширення записує рухи в регістри без повного розуміння типової логіки, можна зламати залишки, взаєморозрахунки, ПДВ, зарплату або собівартість.;== Версії розширень ==

Розширення має змогу додавати нові інформаційні дані, які теж потрібно захищати.; # Чи є собою токени або паролі.; Сценарій
Але розширення не гарантує безпроблемне актуалізація.; У переліку згадуються продукти 1С/BAS, зокрема 1C:організація 8 і BAS ERP.; # Чи є собою зовнішні HTTP-запити.; Задача: зберігати ID банківської транзакції.; * додаткові реквізити довідників;
* додаткові реквізити документів;
* нові команди на формах;
* нові кнопки;
* обробники подій;
* підписки на події;
* додаткові перевірки;
* нові звіти;
* нові обробки;
* інтеграції;
* друковані форми;
* HTTP-сервіси;
* регламентні задача;
* нові ролі або елементи доступу, залежно від можливостей платформи;
* службове логування;
* міграційні вивантаження.;</div>

!; Логіка в розширенні 1С

[[Категорія:Цифрова незалежність України]]
Задача: передавати замовлення з 1С/BAS на сайт і назад.; # Оновити розширення.; Сценарії:

== Типові питання ==

* “Вивантажити на сайт”;
* “Перевірити залишки”;
* “Створити JSON”;
* “Оновити статус оплати”;
* “Заповнити ціни”;
* “Перерахувати знижки”;
* “Відправити в банк”;
* “Створити заявку на виробництво”.; |-
| Що істотно при міграції?; '''Розширення 1С'''  це окрема надбудова до конфігурації, яка зберігає власні об’єкти, модулі, форми, команди і зміни до типових об’єктів.; Контроль
Але небезпечно:
!; Підхід

== Розширення і зовнішні обробки ==

Можливі задачі:
У [[K2 ERP]] такі доробки краще реалізовувати не як хаотичні “латки”, а як контрольовані бізнес-правила, інтеграційні сценарії, звіти, API і права доступу.;== Форми в розширеннях ==

== Основні функціональні можливості розширень ==

{| class="wikitable" style="width:100%;"

!; Розширення і [[Зовнішня обробка 1С|зовнішня обробка]]  не одне й те саме.; !; Помилка
 ]
Розширення має змогу додати:
== Контрольні суми при міграції розширень ==
Розширення має змогу:
Розширення має змогу додати:
завдяки наявності Такий підхід користувачі можуть контролювати виробничі норми.; | Сумісність після оновлень, форми, підписки, важкі запити, права доступу, інтеграції.;== Розширення і друковані форми ==

* додаткові реквізити;
* правила проведення;
* перевірки;
* інтеграції;
* зовнішні ID;
* додаткові статуси;
* звіти;
* друковані форми;
* розрахунок цін;
* контроль знижок;
* логіка виробництва;
* банківські обміни;
* міграційні вивантаження.; Але вони можуть і збільшити його, якщо:

* external_id;
* GUID;
* transaction_id;
* унікальний ключ;
* журнал обміну;
* статус;
* контроль повторної обробки.; Розширення  це надбудова, яка додає потрібні бізнесу функції, не переписуючи всю заводську логіку.; # Заборонити проведення або показати попередження.; Наслідок

== Санкції та ризики використання 1С/BAS в Україні ==
У реальному розширенні потрібно враховувати клієнт-сервер, права доступу, типи даних і сумісність із типовою конфігурацією.; Зміна

# Хто автор розширення.; Причина

* [[Регістр накопичення 1С|регістри накопичення]];
* [[Регістр відомостей 1С|регістри відомостей]];
* [[Регістр бухгалтерії 1С|регістри бухгалтерії]];
* [[Регістр розрахунків 1С|регістри розрахунків]].; '''Практичний принцип міграції.''' При міграції не можна дивитися тільки на типову конфігурацію.; '''Практичний сенс.''' Якщо змінювати типову конфігурацію напряму, кожне актуалізація має змогу перетворитися на складне злиття змін.;=== Що таке розширення 1С? ===

з цієї причини після кожного актуалізація потрібно тестувати розширення.;</div>
[[Категорія:Програмування 1С]]
!; # Отримати мінімальну ціну.;</div>
Для кожного розширення потрібно описати:
{| class="wikitable" style="width:100%;"

== Приклад: розширення для банківської інтеграції ==

Такі реквізити можуть використовуватися у формах, звітах, інтеграціях і перевірках.;[[Категорія:Заміна BAS]]
Процедура ПеревіритиКаналПродажу(Команда)
|-
| Додаткова аналітичні інструменти
| Реквізит і звіт
| Канал продажу
|-
| Контроль продажу
| Підписка на проведення
| Не продавати нижче мінімальної ціни
|-
| інтеграційні функціональні можливості
| Команда, компонент, лог
| Вивантажити замовлення в CRM
|-
| Друкована форма
| Новий макет
| Рахунок із QR-кодом
|-
| Міграція
| Звіт або обробка
| Вивантажити залишки в JSON
|-
| Аудит
| Логування змін
| Хто змінив ціну
|}

Через розширення можна змінювати форми.; |-
| Для чого потрібне?;== Що перевірити перед міграцією розширень ==

* у типовій конфігурації змінили форму;
* змінили назву реквізиту;
* змінили структуру документа;
* змінили регістр;
* змінили тип даних;
* змінили подію;
* видалили об’єкт;
* змінили логіку проведення;
* розширення використовує внутрішні механізми типової конфігурації.;[[Категорія:Мова 1С]]

Перед міграцією потрібно зібрати:

</div>

* додати звіт у підсистему;
* додати нові реквізити;
* змінити форму;
* додати команду;
* зв’язати звіт із новою логікою;
* забезпечити постійне використання.; Якщо ця логіка функціонує в ризиковому або підсанкційному ПЗ, компанії потрібно оцінити юридичні, технічні та кібербезпекові ризики і планувати перехід на безпечну ERP-платформу.;</div>

Розширення має змогу додавати друковані форми.;== Помилка: розширення дублює записи ==

Причини:

* звіт по новому реквізиту;
* звіт по інтеграційних статусах;
* звіт по помилках обміну;
* звіт по мінімальних цінах;
* звіт по каналам продажу;
* звіт по додаткових характеристиках.; &НаКлиенте
  • номер версії;
  • дату;
  • автора;
  • задачу;
  • список змін;
  • вплив на обліковий облік;
  • нові реквізити;
  • змінені форми;
  • інтеграції;
  • інструкцію з встановлення;
  • інструкцію з відкату.; Питання
Сообщить("Не заповнений канал продажу");
; У розширеннях має змогу бути захована критична логіка:
  • кількість об’єктів із доданими реквізитами;
  • заповненість нових полів;
  • кількість записів у службових регістрах;
  • кількість інтеграційних ID;
  • кількість статусів обміну;
  • результати звітів розширення;
  • контроль по ключових документах;
  • контроль по друкованих формах;
  • контроль по API-обмінах;
  • список активних і неактивних розширень.; Без документації розширення через кілька місяців стає “чорною скринькою”.; КонецПроцедуры
Розширення бажано вести з версіями.; # Не змінювати основну конфігурацію напряму.;Зовнішній звіт 1С зручний для аналітики без зміни конфігурації.; При переході з або BAS у K2 ERP розширення потрібно обов’язково інвентаризувати.;
  • хто бачить нові реквізити;
  • хто має змогу змінювати;
  • хто має змогу запускати команди;
  • хто має змогу формувати звіти;
  • хто має змогу експортувати інформаційні дані;
  • хто має змогу змінювати конфігурація інтеграції.; # Які об’єкти змінює.; Друкована форма має змогу брати інформаційні дані як із типової конфігурації, так і з реквізитів розширення.; Регістри можуть бути:

</syntaxhighlight>

Помилка: розширення зламалося після актуалізація

  • чи відкриваються форми;
  • чи працюють команди;
  • чи проводяться документи;
  • чи працюють підписки на події;
  • чи не падають регламентні задача;
  • чи не сповільнились документи;
  • чи коректні регістри;
  • чи не змінилися звіти;
  • чи функціонує інтеграційні функціональні можливості;
  • чи не порушені права доступу;
  • чи коректно функціонує актуалізація.; | Надбудова, яка додає або змінює функціональність без прямої зміни основної конфігурації.; # Порівняти з ціною продажу.; !; Нове поле
Розширення має змогу додати новий реквізит до об’єкта.; # Відкрити розширення в конфігураторі.; Через розширення можна впливати на проведення документів, але робити це потрібно обережно.; * записати документ;
  • поставити задачу в чергу;
  • обмін виконати регламентним завданням;
  • показати статус інтеграції окремо.; Він має змогу використовуватися для:
Приклад полів:
  • додати перевірку перед проведенням;
  • заборонити проведення при помилці;
  • записати додаткову аналітику;
  • створити службовий рух;
  • викликати зовнішню інтеграцію;
  • логувати факт проведення.;
    * перед записом документа;
    * після запису документа;
    * перед проведенням;
    * після проведення;
    * перед видаленням;
    * при зміні об’єкта.; * змінювати типову логіку без розуміння регістрів;
    * дублювати рухи;
    * створювати рухи в обхід типового механізму;
    * змінювати інформаційні дані після проведення без контролю;
    * робити важкі запити при кожному проведенні.; Приклад
    
    оновлень забезпечується через '''Головне.''' Розширення 1С — це спосіб додати або змінити поведінку системи без прямого редагування основної конфігурації.; # Які реквізити додає.;== Розширення і актуалізація 1С/BAS ==
    
    Розширення має змогу містити:
    
    !; # Перевірити контрольні сценарії.; Саме в них часто знаходяться важливі доопрацювання: додаткові реквізити, інтеграції, контроль цін, правила проведення, друковані форми, звіти і службові статуси.; '''Проста аналогія.''' Основна конфігурація — це заводська прошивка системи.; * отримане з невідомого джерела;
    * містить прихований код;
    * має доступ до зовнішніх сервісів;
    * передає інформаційні дані через HTTP;
    * функціонує з персональними даними;
    * функціонує з банківськими токенами;
    * змінює регістри;
    * змінює документи;
    * обходить права доступу;
    * масово змінює інформаційні дані.;[[Категорія:Регістри 1С]]
    
    [[Категорія:Розробка 1С]]
    
    * запит у циклі;
    * важка перевірка перед кожним проведенням;
    * HTTP-запит під час запису документа;
    * відсутність індексів у запиті;
    * обробка великої табличної частини;
    * зайве логування;
    * регламентне задача запускається надто часто.; * отримати замовлення з сайту;
    * передати залишки;
    * отримати статус оплати;
    * відправити платіж у банк;
    * передати інформаційні дані в CRM;
    * вивантажити довідники;
    * сформувати міграційний API.; У публічних матеріалах до переліку додатково фігурує Указ Президента України №601/2024 щодо ТОВ «1С».; Держспецзв’язку веде перелік забороненого до використання програмного забезпечення та комунікаційного обладнання.; {
    
     "channel": "website",
    
    Задача: не дозволяти продаж нижче мінімальної ціни.; Дата
    == Приклад: розширення для виробництва ==
    Розширення — це не повна заміна змін конфігурації.; !; Слабка сторона — ризик прихованої логіки, проблеми після оновлень, вплив на продуктивність, права доступу і критичні облікові інформаційні дані.; Розширення 1С — це окрема надбудова до конфігурації, яка надає можливість додавати або змінювати функціональність без прямого редагування основної конфігурації.; У сучасній [[ERP]] логіка, яка в 1С/BAS була реалізована розширеннями, має змогу бути реалізована через:
    
    == Приклад: перевірка мінімальної ціни ==
    
    * в цілому змінити архітектуру обліку;
    * переписати проведення багатьох документів;
    * змінити базову структуру регістрів;
    * обійти типову модель прав;
    * реалізувати важку інтеграцію без черг і логування;
    * виконувати масові зміни без контролю;
    * замінити ERP-логіку, яка вже не відповідає бізнесу.; {| class="wikitable" style="width:100%;"
    Спрощена логіка:
    <syntaxhighlight lang="text">
    [[Категорія:Міграція з BAS]]
    == Типові помилки розширень 1С ==
    [[Категорія:BAS ERP]]
    [[Категорія:СКД 1С]]
    [[Категорія:Power BI]]
    СКД-звіт у розширенні має змогу використовувати типові регістри й додані розширенням поля.; Вони використовуються для:
    
    * авторизацію;
    * HTTPS;
    * токени;
    * логування;
    * обробку помилок;
    * повтори;
    * захист персональних і фінансових даних.; Держспецзв’язку веде офіційно затверджений перелік забороненого до використання програмного забезпечення та комунікаційного обладнання; у переліку згадуються продукти 1С/BAS, зокрема 1C:організація 8 і BAS ERP.; Після початку російської агресії проти України використання такого програмного забезпечення стало питанням не тільки бухгалтерії, а й кібербезпеки, комплаєнсу, репутації та цифрової незалежності.; Приклад
    |-
    | Де зберігається
    | Підключається до конфігурації
    | Окремий файл
    |-
    | Постійна логіка
    | Так
    | Зазвичай ні або окремо підключається
    |-
    | Зміна форм
    | Так
    | Обмежено
    |-
    | Команди у формах
    | Так
    | має змогу бути, але не завжди комфортно
    |-
    | Разова задача
    | Не завжди доцільно
    | Дуже комфортно
    |-
    | інтеграційні функціональні можливості в інтерфейс
    | Краща
    | Залежить від реалізації
    |}
    
    '''істотно.''' Розширення 1С можуть містити критичну бізнес-логіку: фінансовий блок, складський облік, зарплату, ПДВ, банк, виробництво, собівартість, інтеграції та доступи.; # Чи протестовано на копії.; Одна з головних причин використання розширень — спрощення оновлень.; # Які форми змінює.; Об’єкт
    
    Через розширення можна:
    
    Розширення потрібні, щоб доопрацьовувати типову систему з меншими ризиками для оновлень.;== Розширення в сучасній ERP-архітектурі ==
    <div style="border:3px solid #b71c1c; background:#ffebee; padding:14px; margin:16px 0;">
    !; Що відбувається
    == Розширення і інтеграції ==
    == Розширення і аудит ==
    
    Розширення має змогу:
    
     }
    
    * список усіх розширень;
    * їхні версії;
    * хто їх створив;
    * для чого вони потрібні;
    * які об’єкти змінюють;
    * які реквізити додають;
    * які форми змінюють;
    * які звіти додають;
    * які інтеграції виконують;
    * які регламентні задача мають;
    * які інформаційні дані потрібно перенести;
    * які правила потрібно реалізувати в K2 ERP;
    * які розширення застарілі;
    * які можна не переносити.; Наслідок
    
    [[Категорія:Інтеграція]]
    
    * локальних доопрацювань;
    * додавання реквізитів;
    * зміни форм;
    * додавання кнопок;
    * додавання перевірок;
    * створення нових звітів;
    * створення друкованих форм;
    * інтеграцій через [[API]] або [[Інтеграція через JSON|JSON]];
    * контролю прав;
    * додаткового логування;
    * міграційних вивантажень;
    * адаптації типових документів;
    * тимчасових рішень без зміни основної конфігурації.; У складних — для окремого бізнес-процесу, API-інтеграції, контролю цін, спеціальних звітів або міграційних механізмів.;[[Категорія:Автоматизація бізнесу]]
    
    [[Категорія:Аудит дій]]
    
    == Карта міграції розширення ==
    
    Приклад сценарію:
    
    * додати поле на форму;
    * додати кнопку;
    * додати вкладку;
    * змінити видимість елемента;
    * додати команду;
    * показати службове повідомлення;
    * додати перевірку при зміні поля.; # Чи є собою план відкату.; # Перевірити підписки.; !; реліз
    
    == Розширення і регістри ==
    
    Підписки зручні тим, що можна додати логіку без прямого редагування модуля документа.; * перед проведенням реалізації перевірити мінімальну ціну;
    * після запису замовлення відправити інформаційні дані в CRM;
    * після проведення оплати оновити статус замовлення;
    * перед записом контрагента перевірити ЄДРПОУ.; Если Рядок.Цена < МінЦіна Тогда
     Сообщить("Ціна нижче мінімальної: " + Строка(Рядок.Номенклатура));
     Отказ = Истина;
     КонецЕсли;
    
    КонецЦикла;
    
  • немає перевірки унікальності;
  • підписка виконується повторно;
  • документ перепроводиться;
  • інтеграційні функціональні можливості повторює запит;
  • немає external_id;
  • немає контролю статусу.; Що додається
Розширення часто використовують для інтеграцій.; # Додати передачу цього поля в JSON для сайту або CRM.; * додавати нові реквізити;
  • додавати нові форми;
  • змінювати існуючі форми;
  • додавати команди;
  • додавати звіти;
  • додавати обробки;
  • додавати підписки на події;
  • додавати загальні модулі;
  • змінювати поведінку документів;
  • виконувати перевірки;
  • додавати інтеграції;
  • формувати друковані форми;
  • доповнювати типову логіку без зняття конфігурації з підтримки.; При описі механізмів і BAS в українському контексті потрібно згадувати санкційні та безпекові ризики.