Подія OnChange стовпця (посилання на API клієнта)

Подія OnChange відбувається в таких ситуаціях:

  • Дані у стовпці форми змінилися, а фокус буде втрачено. Ця поведінка стосується стовпців "Так/Ні", відформатованих для використання перемикачів або прапорців. У таких випадках подія відбувається негайно.
  • Зміни даних на сервері отримуються для оновлення стовпця під час оновлення форми, наприклад після збереження запису.
  • Використовується метод attribute.fireOnchange .

Усі стовпці підтримують OnChange подію. Дані в стовпці перевірено до та після OnChange події.

Подія OnChange не відбувається, якщо стовпець змінюється програмно за допомогою методу attribute.setValue . Якщо потрібно, щоб обробники подій для OnChange події запускав після встановлення значення, потрібно використовувати formContext.data.entity attribute. метод fireOnchange у коді. Подія OnChange також не відбувається, якщо стовпець змінюється програмно під час скасування змін, якщо користувач переходить від брудної форми.

Нотатка

Хоча стовпець Стан підтримуєOnChange подію, стовпець доступний лише для читання у формі, тому подія не може відбуватися під час взаємодії з користувачем. Інший сценарій може призвести до виникнення цієї події за допомогою методу fireOnchange у стовпці.

Нотатка

OnChange події синхронні. Не слід використовувати асинхронний код у обробнику OnChange подій, який потребує виконання або обробки дії з роздільною здатністю асинхронного коду. Це призводить до проблем, якщо обробник роздільної здатності очікує, що контекст програми залишиться таким самим, як і під час запуску асинхронного коду. Також не слід робити синхронні мережеві запити в обробнику подій OnChange. Це може призвести до того, що програма не відповідає.

Методи, які підтримуються для цієї події

Є три способи, які можна використовувати для роботи з подією OnChange для стовпця:

Стовпці (посилання на API клієнта)
Події (довідник із інтерфейсу API клієнта)
Події у формах і сітках у програмах на основі моделі