Платформа A2v10 довідкова система
EN


Прив'язка BindCmd

Всі прив`язки

Являє собою спеціальний об'єкт, що описує команду, яка буде виконана у відповідь на певну дію користувача (наприклад, натискання екранної кнопки). Практично завжди задається як розширення розмітки.

Зверніть увагу, що об`єкт має досить багато властивостей, але більшість з них використовуються тільки для якоїсь конкретної команди.

Властивості

Ім'я Тип Опис
Command Command За замовчуванням. Команда, що виконується. Можливі команди описані нижче.
Argument Object Аргумент команди. Практично завжди прив'язка (Bind).
Data Object Додаткові дані для команди. Практично завжди прив'язка (Bind).
Url String Url для зовнішньї команди.
CommandName String Тільки для команди Execute. Ім'я команди в шаблоні (template.commands).
SaveRequired Boolean Зберігати модель перед виконанням команди.
ValidRequired Boolean Для виконання команди потрібно, щоб модель була у валідному стані.
Confirm Confirm Запитувати у користувача підтвердження перед виконанням команди.
NewWindow Boolean Відкривати у новому вікні.
UpdateAfter Object Завжди прив'язка. Об'єкт або масив, який потрібно оновити після виконання якоїсь дії.
ReloadAfter Boolean Оновити модель після виконання команди.
Export Boolean Чи виконувати експорт замість відображення. Не сумісна з Print.
Print Boolean Чи виконувати друк замість відображення.
FileAction Enum Дія для команди File.
Action Enum Дія для команди Dialog.

Команди

Open, OpenSelected - відкрити форму

Виконує перехід на заданий Url із заданим аргументом.

Аргументи:

  • Url - Шлях до форми. Обов'язково
  • Argument - Аргумент команди. Обов'язково. Для команди Open задає елемент для форми. Для команди OpenSelected це колекція, обраний єлемент якої буде передано до форми.
  • NewWindow - Відкривати в новому вікні.
  • UpdateAfter - Прив'язка до елементу, який можливо буде оновлюватися при виконанні якихось дій. Має сенс тільки якщо форма відкривається у новому вікні.
Clear - очистить

Очищує об`єкт агрумента.

Аргументи:

  • Argument - Прив'язка до масиву або об'єкту, який потрібно очистити. Фактично команда просто викликає метод $empty зв'язаного об'єкта або масива.

Зверніть увагу, що елемент керування, пов'язаний з цією командою, не буде виводитися, якщо об`єкт або масив вже пусті. Додаткова прив'язка властивості If не потрібна.

Save - зберегти

Зберегає поточну модель. Команда не має аргументів.

SaveAndClose - зберегти та закрити

Зберегає поточну модель та закриває поточну форму або діалог. Команда не має аргументів.

Close - закрити

Закриває поточну форму або діалог. Команда не має аргументів.

CloseOk - закрити

Тільки для діалогів. Закриває поточний діалог з відповіддю true. Команда не має аргументів.

Reload, Refresh - оновити

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

Аргументи:

  • Argument - Прив'язка до масиву, який потрібно оновити. Не обов'язково.
Requery - оновити

Перезавантажує форму повністю з сервера (включаючи перегенерацію розмітки). Команда не має аргументів.

Print - надрукувати

Друк поточної сторінки. Команда не має аргументів. Зверніть увагу, що фактично друкується поточне зображення сторінки. Деякі елементи (наприклад Taskpad) на друк не виводяться. Більш тонко керувати видимістю елементів при друку можна за допомогою властивості Print об'єкта UIElement.

Dialog - діалог

Відображає діалог і виконує вказану дію.

Аргументи:

  • Action - дія. Можливі значення:
    • Edit - редагувати елемент, вказаний аргументом. Після закриття діалога елемент буде оновлений.
    • EditSelected - редагувати обраний елемент колекції. Колекція задається аргументом команди. Після закриття діалога виділений елемент буде оновлений.
    • Show - показати елемент, заданий аргументом.
    • ShowSelected - показати обраний елемент колекції. Колекція задається аргументом команди.
    • Browse - обрати елемент, заданий аргументом. Елемент замінюється обраним в діалозі.
    • Append - створити новий елемент і додати його в колекцію. Колекція задається аргументом.
    • New - створити новий елемент.
    • Copy - створити копію заданного елементу. Елемент задається аргументом.
  • Argument - Прив'язка до елементу або колекції.
  • Data - Додаткові дані для виклику діалога. Будуть параметрами процедури завантаження моделі діалога.
  • URL - URL на діалог з розділу dialogs файлу опису моделі model.json.
  • SaveRequired, ValidRequired, ReloadAfter - додаткові умови команди.
File - робота з файлами (бінарними об'єктами)

Виконує відображення, завантаження або друк вкладення (бінарного об'єкта). Це може ути зображення, файл тощо Детальніше про роботу з бінарними об'єктами.

Аргументи:

  • FileAction - дію з файлом. Можливі значення:
    • Show - Показать дані на сторінці.
    • Download - завантажити дані як файл.
    • Print - Печать даних файла.
  • Argument - Прив'язка до властивості, яка буде задавати ідентифікатор бінарного об'єкта.
  • URL - URL на дію з розділу files файлу опису моделі model.json.
Download - завантажити

Дозволяє користувачу завантажити статичний файл. Статичні файли, пов'язані з програмою мають бути розміщені в спеціальній папці _files.

Аргументи:

  • Url - шлях до статичного файлу. Шлях зазначається відносно папки _files.
Report - звіт

Дозволяє користувачу виконати дії зі звітом. Звіти мають бути розміщені в розділі reports.

Аргументи:

  • Report - назва звіту.
  • Url - шлях до кінцевої точки звіту.
  • Export - завантажити звіт.
  • Print - надрукувати звіт.
  • Format - формат завантаження для звіту. Доступні значення залежать від виду звіту.
  • Argument - Аргумент для звіту. З аргументу буде отримано ідентіфікатор звіту.
  • Data - Додаткові дані для звіту. Будуть параметрами процедури завантаження моделі звіту.