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

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

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

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

Примечание. Создание новой формы доступно только в настольном приложении.

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

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

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

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

Примечание. Открытие готовой формы на редактирование доступно только в настольном приложении.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Объединять запросы при вычислении. Установите флажок для:

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

• расчёта алгоритма для показателей, добавленных в шапку несколько раз;

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

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

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

Примечание. Работа с алгоритмом расчёта доступна только при наличии установленного расширения «Алгоритмы расчёта».

Перед объединением запросов при вычислении можно задать пользовательское событие с помощью метода IPrxReportUserEvents.EventOnBeforeExecuteCombined в среде разработки;

Примечание. Объединение запросов недоступно при работе с глобальным кэшем.

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

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

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

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

• Модуль. Укажите модуль, написанный на языке 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);

                                  }

                   }

   }

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

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