Начало работы с расширением «Интерактивные формы ввода данных» в настольном приложении

Для создания новой формы:

• нажмите кнопку «Новый объект > Пользовательские объекты > Форма ввода/вывода» в группе «Создать» на вкладке «Главная» ленты инструментов в навигаторе объектов;

• выполните команду «Создать > Пользовательские объекты > Форма ввода/вывода» в контекстном меню навигатора объектов.

Для открытия на редактирование готовой формы:

• нажмите кнопку  «Редактировать» вкладки «Главная» ленты инструментов в навигаторе объектов, выделив форму;

• выполните команду «Редактировать» контекстного меню формы;

• нажмите кнопку F4, выделив форму.

Для открытия на просмотр готовой формы:

• нажмите кнопку  «Открыть» вкладки «Главная» ленты инструментов в навигаторе объектов, выделив форму;

• выполните команду «Открыть» контекстного меню формы.

Для открытия на просмотр готовой формы в веб-интерфейсе воспользуйтесь расширением «Конструктор бизнес-приложений».

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

• Главное меню. Содержит список команд, предназначенных для выполнения различных операций над формой. Также в режиме редактирования доступно сохранение формы ввода.

• Лента инструментов. Содержит кнопки для построения формы в режиме редактирования и для работы с данными в режиме просмотра. Дополнительно можно настроить отображаемые вкладки и группы в режиме редактирования.

• Панель быстрого доступа. Содержит набор часто используемых команд.

• Строка формул. Предназначена для ввода формул в ячейки таблицы, отображения адресов выделенных ячеек и формул алгоритмов, если значения ячеек по ним рассчитывается.

• Рабочая область. Предназначена для построения формы в режиме редактирования и для ввода данных в режиме просмотра.

• Вкладки листов. Предназначены для работы с листами формы в режиме редактирования и для переключения между ними в режиме просмотра.

• Панель процессов. Предназначена для настройки свойств процесса в режиме редактирования и для управления процессом в режиме просмотра.

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

• Строка статуса. Предназначена для отображения значений базовых агрегатов выделенного диапазона ячеек.

Выполните команду «Сервис > Параметры» в главном меню формы ввода.

Вкладка «Общие» содержит настройки:

• Обновлять при открытии на редактирование. Установите флажок для автоматического обновления формы ввода при её открытии на редактирование. По умолчанию флажок снят;

• Расположение кубов-показателей. Укажите расположение папок, в которых располагаются показатели для построения формы ввода. Для этого выберите папку с кубами-показателями из раскрывающегося списка или нажмите кнопку  «Поиск» и начните печатать название папки. Для удаления папки нажмите  «Очистить»;

• Расположение измерений. Укажите расположение папок, в которых располагаются измерения для построения формы ввода. Для этого выберите папку с измерениями из раскрывающегося списка или нажмите кнопку поиска  «Поиск» и начните печатать название папки. Для удаления папки нажмите  «Очистить»;

• Загрузка только активного листа. Установите флажок для загрузки данных только активного листа формы, данные неактивных листов будут загружены при обращении к ним. При создании формы по умолчанию флажок установлен;

• Автоподгонка ширины столбцов. Установите флажок для автоматического изменения ширины столбцов при изменении размеров окна при просмотре формы ввода в веб-приложении. По умолчанию флажок снят. Такая настройка может быть использована для карточек и таблиц, размеры которых не меняются в процессе использования.

Если указаны расположения папок кубов-показателей и измерений, то при построении табличной области на вкладке «Структура табличной области» по умолчанию иерархия в дереве измерений и в дереве показателей будет развёрнута до содержимого соответствующей папки.

Вкладка «Управление процессами» содержит настройки:

• Модуль. Укажите модуль, написанный на языке Fore, для задания обработчиков для кнопок выполнения процесса. Все методы/функции для настройки обработчиков должны содержаться в данном модуле;

• Процесс завершения/согласования/Процесс отклонения. Установите флажок для задания соответствующего обработчика. Задание обработчика требуется, например, для проверки достаточности введённых данных;

• Автоматически запрашивать данные об активных процессах. Установите флажок для согласования активных шагов без отображения дерева процессов и выбора шагов. При этом будут отображаться кнопки  «Завершить»/«Согласовать» и  «Отклонить» на вкладке «Главная» ленты инструментов. По умолчанию флажок снят.

Примечание. Вкладка «Управление процессами» доступна только при установленном расширении «Управление бизнес-процессами».

Настройка предобработчика

Для вывода текстового сообщения с произвольным текстом перед выполнением действия кнопки  «Завершить»/«Согласовать» или  «Отклонить» на вкладке «Главная» или на вкладке «Процессы» ленты инструментов настройте предобработчик.

Для настройки предобработчика:

1. Установите флажок «Предобработчик».

2. Выберите функцию в списке «Fore метод/функция». Список содержит все функции выбранного модуля, соответствующие сигнатуре:

   Function <Наименование функции> (<Report>: IPrxReport; [Var messageType: Integer]): String;

   Параметр:

   Report. В параметр передаётся форма ввода в формате IPrxReport. При работе с этим объектом будут доступны все свойства и методы интерфейса IPrxReport;

   messageType. Необязательная переменная, используйте для определения формата выводимого сообщения. Если переменная не задана, то будет применяться диалог подтверждения. Для выведения текста сообщения в консоль среды разработки в настольном приложении и отсутствия сообщения в веб-приложении уберите возвращаемое значение в return. Пример такой функции представлен ниже.

   Допустимые значения:

   • 0. Диалог подтверждения. При нажатии кнопки «Да» диалога выполняется заданное для кнопки действие. При нажатии кнопки «Нет» диалога заданное для кнопки действие выполняться не будет;

   • 1. Ошибка. При нажатии кнопки «ОК» диалога заданное для кнопки действие не выполняется;

   • 2. Предупреждение. При нажатии кнопки «ОК» диалога заданное для кнопки действие не выполняется;

   • 3. Информационное сообщение. При нажатии кнопки «ОК» диалога заданное для кнопки действие не выполняется.

   Пример функции:

   Function MessageInformationBox(Report: IPrxReport; Var messageType: integer): String;
       Begin
           messageType := 3;
       Return "Операция будет доступна, когда будут введены все данные";
   End Function MessageInformationBox;

   Пример функции, при выполнении которой в веб-приложении сообщения не будет, а в настольном приложении текст сообщения будет выведен в консоль среды разработки:

   Function BeforeOper2(Report: IPrxReport): String;
   Begin
       debug.WriteLine("BeforeOper2");
       Return "";
   End Function BeforeOper2;

3. Укажите наименование функции на языке JavaScript в поле «JS-функция», которую необходимо запустить в веб-приложении после выполнения действия кнопки. Наименование функции:

   javascript:<Наименование функции (пользовательские параметры, callback, args)>

   Параметры:

   Пользовательские параметры. Требуемые пользовательские параметры. Необязательный параметр;

   Callback. Функция обратного вызова. Обязательный параметр;

   Args. Аргументы функции. Необязательный параметр.

   Наличие угловых скобок при указании наименования функции с параметрами обязательно.

   Пример наименования функции:

   javascript:<AfterOperTest(callback)>

   Если указаны JS-функция и Fore-функция, то в веб-приложении сначала выполняется Fore-функция, затем JS-функция, в настольном приложении выполняется только Fore-функция.

   Добавление JS-функции осуществляется в разделе «Разметка и оформление» конструктора бизнес-приложений. Нажмите кнопку  «Добавить» в области «Загрузка файлов» и загрузите файл в кодировке UTF-8. Функция должна иметь требуемую сигнатуру:

   function <Наименование функции>(пользовательские параметры, callback, args)

   {

   …callback();

   }

   В качестве аргументов могут приходить параметры:

   Report. Параметр для управления отчётом;

   DataEntryForm. Параметр для управления формой ввода;

   DataArea. Параметр для управления табличной областью.

   Пример функции:

   function addAttachments(callback, args)

   {

                   var rep = args.Report;

                   var da = args.DataArea

                   var grid = da.getGridView();

                   var tabSheet = grid.getTabSheet();

                   var tableSource = grid.getTableSource();

                   var onMeasuresLoaded = (function(){

                                  var tabSheetRange = tabSheet.getSelection().getRange();

                                  attachFile(da, tabSheetRange);

                                  tableSource.MeasuresLoaded.remove(onMeasuresLoaded, this, );

                   });

                   tableSource.MeasuresLoaded.addOne(onMeasuresLoaded, this, args);

                   callback();

   }

   function attachFile(da, tabSheetRange) {

                   var rep = da.getSource();

                   var grid = da.getGridView();

                   var tabSheet = grid.getTabSheet();

                   if (tabSheetRange && tabSheetRange.isValid()) {

                                  var cells = tabSheetRange.getCells();

                                  if (cells.length == 1) {

                                                  var cell = cells[0];

                                                  var coord = cell.getCoord();

                                                  var range = { top: coord.rowIndex, left: coord.colIndex, width: 1, height: 1 };

                                                  var views = rep.getGridViews(range);

                                                  var gridKey = views.length ? views[0].key : undefined;

                                                  var attachDlg = da.getGridView().showAttachmentDialog(gridKey, coord.rowIndex, coord.colIndex);

                                  }

                   }

   }

Если для кнопки задан предобработчик и условие заданное в предобработчике не выполняется, то выполнение шага блокируется, шаг останется активным.

Настройка постобработчика

Для возможности выполнять требуемые действия после выполнения действия кнопки  «Завершить»/«Согласовать» или  «Отклонить» на вкладке «Главная» или на вкладке «Процессы» ленты инструментов настройте постобработчик.

Для настройки постобработчика:

1. Установите флажок «Постобработчик».

2. Выберите метод в списке «Fore метод/функция». Список содержит все методы выбранного модуля, соответствующие сигнатуре:

   Sub <Наименование метода>(<Report>: IPrxReport);

   Параметр:

   Report. В параметр передаётся форма ввода в формате IPrxReport. При работе с этим объектом будут доступны все свойства и методы интерфейса IPrxReport.

   Пример метода:

   Sub UpdateData(Report: IPrxReport);
   Var
       SheetT: IPrxTable;
       ItemIndex: Integer;
   Begin
       ItemIndex := Report.ActiveSheet.Index;
       SheetT := Report.Sheets.Item(ItemIndex) As IPrxTable;
       SheetT.TabSheet.CellValue(10,10) := 1000000;
   End Sub UpdateData;

3. Укажите наименование функции на языке JavaScript в поле «JS-функция», которую необходимо запустить в веб-приложении после выполнения действия кнопки. Наименование функции:

   javascript:<Наименование функции (пользовательские параметры, callback, args)>

   Параметры:

   Пользовательские параметры. Требуемые пользовательские параметры. Необязательный параметр;

   Callback. Функция обратного вызова. Обязательный параметр;

   Args. Аргументы функции. Необязательный параметр.

   Наличие угловых скобок при указании наименования функции с параметрами обязательно.

   Пример наименования функции:

   javascript:<AfterOperTest(callback)>

   Если указаны JS-функция и Fore-функция, то в веб-приложении сначала выполняется Fore-функция, затем JS-функция, в настольном приложении выполняется только Fore-функция.

   Добавление JS-функции осуществляется в разделе «Разметка и оформление» конструктора бизнес-приложений. Нажмите кнопку  «Добавить» в области «Загрузка файлов» и загрузите файл в кодировке UTF-8. Функция должна иметь требуемую сигнатуру:

   function <Наименование функции>(пользовательские параметры, callback, args)

   {

   …callback();

   }

   В качестве аргументов могут приходить параметры:

   Report. Параметр для управления отчётом;

   DataEntryForm. Параметр для управления формой ввода;

   DataArea. Параметр для управления табличной областью.

   Пример функции:

   function addAttachments(callback, args)

   {

                   var rep = args.Report;

                   var da = args.DataArea

                   var grid = da.getGridView();

                   var tabSheet = grid.getTabSheet();

                   var tableSource = grid.getTableSource();

                   var onMeasuresLoaded = (function(){

                                  var tabSheetRange = tabSheet.getSelection().getRange();

                                  attachFile(da, tabSheetRange);

                                  tableSource.MeasuresLoaded.remove(onMeasuresLoaded, this, );

                   });

                   tableSource.MeasuresLoaded.addOne(onMeasuresLoaded, this, args);

                   callback();

   }

   function attachFile(da, tabSheetRange) {

                   var rep = da.getSource();

                   var grid = da.getGridView();

                   var tabSheet = grid.getTabSheet();

                   if (tabSheetRange && tabSheetRange.isValid()) {

                                  var cells = tabSheetRange.getCells();

                                  if (cells.length == 1) {

                                                  var cell = cells[0];

                                                  var coord = cell.getCoord();

                                                  var range = { top: coord.rowIndex, left: coord.colIndex, width: 1, height: 1 };

                                                  var views = rep.getGridViews(range);

                                                  var gridKey = views.length ? views[0].key : undefined;

                                                  var attachDlg = da.getGridView().showAttachmentDialog(gridKey, coord.rowIndex, coord.colIndex);

                                  }

                   }

   }

Вкладка «Создание и удаление записей» содержит настройки:

• Модуль. Укажите модуль, написанный на языке Fore, для задания обработчиков для кнопок  «Создать запись» и  «Удалить запись». Все методы/функции для настройки обработчиков должны содержаться в данном модуле;

• Кнопка «Создать запись»/ Кнопка «Удалить запись». Установите флажок для задания соответствующего обработчика. Задание обработчика требуется, например, для запрета добавления или удаления записи в зависимости от значения атрибута справочника или выполнения определённого шага процесса;

• Не выводить список с измерением при добавлении записи. Установите флажок для скрытия списка измерений при добавлении записи в табличную область. По умолчанию флажок снят.

Настройка предобработчика

Для вывода текстового сообщения с произвольным текстом перед выполнением действия кнопки  «Создать запись» или  «Удалить запись» на вкладке «Таблица» ленты инструментов настройте предобработчик.

Для настройки предобработчика:

1. Установите флажок «Предобработчик».

2. Выберите функцию в списке «Fore метод/функция». Список содержит все функции выбранного модуля, соответствующие сигнатуре:

   Function <Наименование функции> (<Report>: IPrxReport; [Var messageType: Integer]): String;

   Параметр:

   Report. В параметр передаётся форма ввода в формате IPrxReport. При работе с этим объектом будут доступны все свойства и методы интерфейса IPrxReport;

   messageType. Необязательная переменная, используйте для определения формата выводимого сообщения. Если переменная не задана, то будет применяться диалог подтверждения. Для выведения текста сообщения в консоль среды разработки в настольном приложении и отсутствия сообщения в веб-приложении уберите возвращаемое значение в return. Пример такой функции представлен ниже.

   Допустимые значения:

   • 0. Диалог подтверждения. При нажатии кнопки «Да» диалога выполняется заданное для кнопки действие. При нажатии кнопки «Нет» диалога заданное для кнопки действие выполняться не будет;

   • 1. Ошибка. При нажатии кнопки «ОК» диалога заданное для кнопки действие не выполняется;

   • 2. Предупреждение. При нажатии кнопки «ОК» диалога заданное для кнопки действие не выполняется;

   • 3. Информационное сообщение. При нажатии кнопки «ОК» диалога заданное для кнопки действие не выполняется.

   Пример функции:

   Function MessageInformationBox(Report: IPrxReport; Var messageType: integer): String;
       Begin
           messageType := 3;
       Return "Операция будет доступна, когда будут введены все данные";
   End Function MessageInformationBox;

   Пример функции, при выполнении которой в веб-приложении сообщения не будет, а в настольном приложении текст сообщения будет выведен в консоль среды разработки:

   Function BeforeOper2(Report: IPrxReport): String;
   Begin
       debug.WriteLine("BeforeOper2");
       Return "";
   End Function BeforeOper2;

3. Укажите наименование функции на языке JavaScript в поле «JS-функция», которую необходимо запустить в веб-приложении после выполнения действия кнопки. Наименование функции:

   javascript:<Наименование функции (пользовательские параметры, callback, args)>

   Параметры:

   Пользовательские параметры. Требуемые пользовательские параметры. Необязательный параметр;

   Callback. Функция обратного вызова. Обязательный параметр;

   Args. Аргументы функции. Необязательный параметр.

   Наличие угловых скобок при указании наименования функции с параметрами обязательно.

   Пример наименования функции:

   javascript:<AfterOperTest(callback)>

   Если указаны JS-функция и Fore-функция, то в веб-приложении сначала выполняется Fore-функция, затем JS-функция, в настольном приложении выполняется только Fore-функция.

   Добавление JS-функции осуществляется в разделе «Разметка и оформление» конструктора бизнес-приложений. Нажмите кнопку  «Добавить» в области «Загрузка файлов» и загрузите файл в кодировке UTF-8. Функция должна иметь требуемую сигнатуру:

   function <Наименование функции>(пользовательские параметры, callback, args)

   {

   …callback();

   }

   В качестве аргументов могут приходить параметры:

   Report. Параметр для управления отчётом;

   DataEntryForm. Параметр для управления формой ввода;

   DataArea. Параметр для управления табличной областью.

   Пример функции:

   function addAttachments(callback, args)

   {

                   var rep = args.Report;

                   var da = args.DataArea

                   var grid = da.getGridView();

                   var tabSheet = grid.getTabSheet();

                   var tableSource = grid.getTableSource();

                   var onMeasuresLoaded = (function(){

                                  var tabSheetRange = tabSheet.getSelection().getRange();

                                  attachFile(da, tabSheetRange);

                                  tableSource.MeasuresLoaded.remove(onMeasuresLoaded, this, );

                   });

                   tableSource.MeasuresLoaded.addOne(onMeasuresLoaded, this, args);

                   callback();

   }

   function attachFile(da, tabSheetRange) {

                   var rep = da.getSource();

                   var grid = da.getGridView();

                   var tabSheet = grid.getTabSheet();

                   if (tabSheetRange && tabSheetRange.isValid()) {

                                  var cells = tabSheetRange.getCells();

                                  if (cells.length == 1) {

                                                  var cell = cells[0];

                                                  var coord = cell.getCoord();

                                                  var range = { top: coord.rowIndex, left: coord.colIndex, width: 1, height: 1 };

                                                  var views = rep.getGridViews(range);

                                                  var gridKey = views.length ? views[0].key : undefined;

                                                  var attachDlg = da.getGridView().showAttachmentDialog(gridKey, coord.rowIndex, coord.colIndex);

                                  }

                   }

   }

Настройка постобработчика

Для возможности выполнять требуемые действия после выполнения действия кнопки  «Создать запись» или  «Удалить запись» на вкладке «Таблица» ленты инструментов настройте постобработчик.

Для настройки постобработчика:

1. Установите флажок «Постобработчик».

2. Выберите метод в списке «Fore метод/функция». Список содержит все методы выбранного модуля, соответствующие сигнатуре:

   Sub <Наименование метода>(<Report>: IPrxReport);

   Параметр:

   Report. В параметр передаётся форма ввода в формате IPrxReport. При работе с этим объектом будут доступны все свойства и методы интерфейса IPrxReport.

   Пример метода:

   Sub UpdateData(Report: IPrxReport);
   Var
       SheetT: IPrxTable;
       ItemIndex: Integer;
   Begin
       ItemIndex := Report.ActiveSheet.Index;
       SheetT := Report.Sheets.Item(ItemIndex) As IPrxTable;
       SheetT.TabSheet.CellValue(10,10) := 1000000;
   End Sub UpdateData;

3. Укажите наименование функции на языке JavaScript в поле «JS-функция», которую необходимо запустить в веб-приложении после выполнения действия кнопки. Наименование функции:

   javascript:<Наименование функции (пользовательские параметры, callback, args)>

   Параметры:

   Пользовательские параметры. Требуемые пользовательские параметры. Необязательный параметр;

   Callback. Функция обратного вызова. Обязательный параметр;

   Args. Аргументы функции. Необязательный параметр.

   Наличие угловых скобок при указании наименования функции с параметрами обязательно.

   Пример наименования функции:

   javascript:<AfterOperTest(callback)>

   Если указаны JS-функция и Fore-функция, то в веб-приложении сначала выполняется Fore-функция, затем JS-функция, в настольном приложении выполняется только Fore-функция.

   Добавление JS-функции осуществляется в разделе «Разметка и оформление» конструктора бизнес-приложений. Нажмите кнопку  «Добавить» в области «Загрузка файлов» и загрузите файл в кодировке UTF-8. Функция должна иметь требуемую сигнатуру:

   function <Наименование функции>(пользовательские параметры, callback, args)

   {

   …callback();

   }

   В качестве аргументов могут приходить параметры:

   Report. Параметр для управления отчётом;

   DataEntryForm. Параметр для управления формой ввода;

   DataArea. Параметр для управления табличной областью.

   Пример функции:

   function addAttachments(callback, args)

   {

                   var rep = args.Report;

                   var da = args.DataArea

                   var grid = da.getGridView();

                   var tabSheet = grid.getTabSheet();

                   var tableSource = grid.getTableSource();

                   var onMeasuresLoaded = (function(){

                                  var tabSheetRange = tabSheet.getSelection().getRange();

                                  attachFile(da, tabSheetRange);

                                  tableSource.MeasuresLoaded.remove(onMeasuresLoaded, this, );

                   });

                   tableSource.MeasuresLoaded.addOne(onMeasuresLoaded, this, args);

                   callback();

   }

   function attachFile(da, tabSheetRange) {

                   var rep = da.getSource();

                   var grid = da.getGridView();

                   var tabSheet = grid.getTabSheet();

                   if (tabSheetRange && tabSheetRange.isValid()) {

                                  var cells = tabSheetRange.getCells();

                                  if (cells.length == 1) {

                                                  var cell = cells[0];

                                                  var coord = cell.getCoord();

                                                  var range = { top: coord.rowIndex, left: coord.colIndex, width: 1, height: 1 };

                                                  var views = rep.getGridViews(range);

                                                  var gridKey = views.length ? views[0].key : undefined;

                                                  var attachDlg = da.getGridView().showAttachmentDialog(gridKey, coord.rowIndex, coord.colIndex);

                                  }

                   }

   }

Вкладка «Главное меню» содержит настройки:

• Доступные форматы экспорта. Установите флажки напротив форматов экспорта для определения доступных форматов в главном меню при открытии формы ввода на просмотр. При снятии флажка напротив формата, он будет скрыт из главного меню и с панели быстрого доступа, если он был туда вынесен, при открытии формы ввода на просмотр.