Для того, щоб додати на сторінку редагування призначену для користувача кнопку в модель уявлення, необхідно змінити дві властивості:
- масив конфігураційних об'єктів diff. У нього необхідно додати конфігураційний об'єкт для настройки візуального розташування елемента керування на сторінці редагування.
- колекцію methods. У неї необхідно додати реалізацію методу-обробника, який буде викликатися при натисканні на кнопку, а також інші допоміжні методи, необхідні для функціонування елемента управління. Це можуть бути методи, які будуть регулювати видимість або доступність елемента управління в залежності від умов.
Для відображення кнопки на сторінці в суміщеному режимі редагування записи (з відкритим вертикальним реєстром) необхідно внести зміни як в схему моделі представлення розділу, так і в схему моделі представлення сторінки редагування.
Щоб кнопка відображалася на сторінці в звичайному режимі редагування записи (режимі додавання даних), зміни вносяться тільки в схему моделі представлення сторінки.
У звичайний режим відображення сторінки редагування можна перейти не тільки при створенні запису, але і якщо оновити сторінку, що знаходиться в суміщеному режимі відображення (з вертикальним реєстром).
DOM-модель стандартних кнопок сторінки
Для розташування стандартних функціональних кнопок сторінок редагування bpm'online використовується ієрархічна структура html-контейнерів.
CombinedModeActionButtonsCardContainer - контейнер верхнього рівня в суміщеному режимі редагування записи. Усередині нього розташовуються ще два контейнера:
- CombinedModeActionButtonsCardLeftContainer. в якому розміщені стандартні кнопки [Закрити], [Зберегти], [Скасувати], [Дії] і [Теги];
- CombinedModeActionButtonsCardRightContainer. в якому розташовані кнопки [Друк] і [Вид].
Аналогічно, для сторінки редагування записи в звичайному режимі контейнер верхнього рівня - ActionButtonsContainer. Усередині нього розташовуються ще два контейнера:
- Leftcontainer. в якому розміщені стандартні кнопки [Закрити], [Зберегти], [Скасувати], [Дії] і [Теги];
- RightContainer. в якому розташовані кнопки [Друк] і [Вид].
Залежно від того, де саме потрібно розташувати кнопку, при налаштуванні візуалізації кнопки в масиві модифікацій diff вказується відповідний контейнер.
Тут використовуються мета-імена html-контейнерів. Ці імена вказуються при налаштуванні візуалізації елемента управління в конфігураційному об'єкті масиву diff. Фактичні ідентифікатори відповідних html-елементів сторінки формуються системою автоматично на підставі таких мета-імен.
Налаштування властивостей візуалізації кнопки
Для того, щоб налаштувати візуальне розташування користувальницької кнопки на сторінці редагування, в масив diff моделі представлення необхідно додати конфігураційний об'єкт з такими властивостями: