Общего назначения клиент переопределяемый

ПередНачаломРаботыСистемы

Описание, пример вызова

// Возникает при запуске приложения до открытия главного окна.
// В процедуре-обработчике могут быть выполнены необходимые проверки и, при необходимости, установлен параметр отказа
// от запуска приложения. Соответствует обработчику ПередНачаломРаботыСистемы.
//
// При работе в модели сервиса обработчик вызывается также:
// - при запуске сеанса администратора без установленных значений разделителей;
// - при входе администратора в область данных из сеанса без установленных значений разделителей.
// Для проверки режима запуска см. функцию ОбщегоНазначенияКлиент.ДоступноИспользованиеРазделенныхДанных.
//
// Параметры:
//  Параметры - Структура:
//   * Отказ         - Булево - возвращаемое значение. Если установить Истина, то работа программы будет прекращена.
//   * Перезапустить - Булево - возвращаемое значение. Если установить Истина, и параметр Отказ тоже установлен
//                              в Истина, то выполняется перезапуск программы.
//
//   * ДополнительныеПараметрыКоманднойСтроки - Строка - возвращаемое значение. Имеет смысл, когда Отказ
//                              и Перезапустить установлены Истина.
//
//   * ИнтерактивнаяОбработка - ОписаниеОповещения - возвращаемое значение. Для открытия окна, блокирующего вход в
//                              программу, следует присвоить в этот параметр описание обработчика
//                              оповещения, который открывает окно.
//
//   * ОбработкаПродолжения   - ОписаниеОповещения - если открывается окно, блокирующее вход в программу, то в обработке
//                              закрытия этого окна необходимо выполнить оповещение ОбработкаПродолжения.
//
//   * Модули                 - Массив - ссылки на модули, в которых нужно вызвать эту же процедуру после возврата.
//                              Модули можно добавлять только в рамках вызова в процедуру переопределяемого модуля.
//                              Используется для упрощения реализации нескольких последовательных асинхронных вызовов
//                              в разные подсистемы. См. пример ИнтеграцияПодсистемБСПКлиент.ПередНачаломРаботыСистемы.
//
// Пример:
//  Следующий код открывает окно, блокирующее вход в программу.
//
//    Если ОткрытьОкноПриЗапуске Тогда
//      Параметры.ИнтерактивнаяОбработка = Новый ОписаниеОповещения("ОткрытьОкно", ЭтотОбъект);
//    КонецЕсли;
//
//  Процедура ОткрытьОкно(Параметры, ДополнительныеПараметры) Экспорт
//    // Показываем окно, по закрытию которого вызывается обработчик оповещения ОткрытьОкноЗавершение.
//    Оповещение = Новый ОписаниеОповещения("ОткрытьОкноЗавершение", ЭтотОбъект, Параметры);
//    Форма = ОткрытьФорму(... ,,, ... Оповещение);
//    Если Не Форма.Открыта() Тогда // Если ПриСозданииНаСервере Отказ установлен Истина.
//      ВыполнитьОбработкуОповещения(Параметры.ОбработкаПродолжения);
//    КонецЕсли;
//  КонецПроцедуры
//
//  Процедура ОткрытьОкноЗавершение(Результат, Параметры) Экспорт
//    ...
//    ВыполнитьОбработкуОповещения(Параметры.ОбработкаПродолжения);
//
//  КонецПроцедуры
//
Процедура ПередНачаломРаботыСистемы(Параметры) Экспорт

Пример вызова

ОбщегоНазначенияКлиентПереопределяемый.ПередНачаломРаботыСистемы(Параметры)

ПриНачалеРаботыСистемы

Описание, пример вызова

// Возникает при запуске приложения после открытия главного окна.
// В процедуре-обработчике могут быть выполнены различные действия, необходимые при запуске программы, например,
// открыты некоторые формы. Соответствует обработчику ПриНачалеРаботыСистемы.
//
// При работе в модели сервиса обработчик вызывается также:
// - при запуске сеанса администратора без установленных значений разделителей;
// - при входе администратора в область данных из сеанса без установленных значений разделителей.
// Для проверки режима запуска см. функцию ОбщегоНазначенияКлиент.ДоступноИспользованиеРазделенныхДанных.
//
// Параметры:
//  Параметры - Структура:
//   * Отказ         - Булево - возвращаемое значение. Если установить Истина, то работа программы будет прекращена.
//   * Перезапустить - Булево - возвращаемое значение. Если установить Истина и параметр Отказ тоже установлен
//                              в Истина, то выполняется перезапуск программы.
//
//   * ДополнительныеПараметрыКоманднойСтроки - Строка - возвращаемое значение. Имеет смысл
//                              когда Отказ и Перезапустить установлены Истина.
//
//   * ИнтерактивнаяОбработка - ОписаниеОповещения - возвращаемое значение. Для открытия окна, блокирующего вход
//                              в программу, следует присвоить в этот параметр описание обработчика оповещения,
//                              который открывает окно. См. пример в ПередНачаломРаботыСистемы.
//
//   * ОбработкаПродолжения   - ОписаниеОповещения - если открывается окно, блокирующее вход в программу, то в
//                              обработке закрытия этого окна необходимо выполнить оповещение ОбработкаПродолжения.
//
//   * Модули                 - Массив - ссылки на модули, в которых нужно вызвать эту же процедуру после возврата.
//                              Модули можно добавлять только в рамках вызова в процедуру переопределяемого модуля.
//                              Используется для упрощения реализации нескольких последовательных асинхронных вызовов
//                              в разные подсистемы. См. пример ИнтеграцияПодсистемБСПКлиент.ПередНачаломРаботыСистемы.
//
Процедура ПриНачалеРаботыСистемы(Параметры) Экспорт

Пример вызова

ОбщегоНазначенияКлиентПереопределяемый.ПриНачалеРаботыСистемы(Параметры)

ПриОбработкеПараметровЗапуска

Описание, пример вызова

// Вызывается для обработки собственных параметров запуска программы,
// передаваемых с помощью ключа командной строки /C, например:
// 1cv8.exe /C РежимОтладки;ОткрытьИЗакрыть
//
// Параметры:
//  ПараметрыЗапуска  - Массив из Строка - строки, разделенные символом ";" в параметре запуска,
//                      которые переданы в конфигурацию с помощью ключа командной строки /C.
//  Отказ             - Булево - если установить Истина, то запуск будет прерван.
//
Процедура ПриОбработкеПараметровЗапуска(ПараметрыЗапуска, Отказ) Экспорт

Пример вызова

ОбщегоНазначенияКлиентПереопределяемый.ПриОбработкеПараметровЗапуска(ПараметрыЗапуска, Отказ)

ПослеНачалаРаботыСистемы

Описание, пример вызова

// Выполняется при запуске приложения после завершения действий ПриНачалеРаботыСистемы.
// Используется для подключения обработчиков ожидания, которые не должны вызываться
// перед и при начале работы системы.
//
// Начальная страница (рабочий стол) в этот момент еще не открыта, поэтому запрещено открывать
// формы напрямую, а следует использовать для этих целей обработчик ожидания.
// Запрещено использовать это событие для интерактивного взаимодействия с пользователем
// (ПоказатьВопрос и аналогичные действия). Для этих целей следует размещать код в процедуре ПриНачалеРаботыСистемы.
//
Процедура ПослеНачалаРаботыСистемы() Экспорт

Пример вызова

ОбщегоНазначенияКлиентПереопределяемый.ПослеНачалаРаботыСистемы()

ПередЗавершениемРаботыСистемы

Описание, пример вызова

// Возникает перед завершением работы приложения до закрытия главного окна.
// В процедуре-обработчике могут быть выполнены необходимые проверки и, при необходимости, может быть установлен
// параметр отказа от выхода из программы.
// Позволяет определить список предупреждений, выводимых пользователю перед завершением работы.
// В процессе завершения работы приложения запрещены серверные вызовы и  открытие окон.
// Соответствует обработчику ПередЗавершениемРаботыСистемы.
//
// При работе в модели сервиса обработчик вызывается также:
// - при завершении сеанса администратора без установленных значений разделителей;
// - при выходе администратора из области данных в сеанса без установленных значений разделителей.
// Для проверки режима запуска см. функцию ОбщегоНазначенияКлиент.ДоступноИспользованиеРазделенныхДанных.
//
// Параметры:
//  Отказ          - Булево - если установить данному параметру значение Истина, то работа с программой не будет
//                            завершена.
//  Предупреждения - Массив из см. СтандартныеПодсистемыКлиент.ПредупреждениеПриЗавершенииРаботы -
//                            можно добавить сведения о внешнем виде предупреждения и дальнейших действиях.
//
Процедура ПередЗавершениемРаботыСистемы(Отказ, Предупреждения) Экспорт

Пример вызова

ОбщегоНазначенияКлиентПереопределяемый.ПередЗавершениемРаботыСистемы(Отказ, Предупреждения)

ПриУстановкеЗаголовкаКлиентскогоПриложения

Описание, пример вызова

// Позволяет переопределить заголовок приложения.
//
// Параметры:
//  ЗаголовокПриложения - Строка - текст заголовка приложения;
//  ПриЗапуске          - Булево - Истина, если вызывается при начале работы приложения.
//                                 В этом случае недопустимо вызывать те серверные функции конфигурации,
//                                 которые рассчитывают на то, что запуск уже полностью завершен.
//                                 Например, вместо СтандартныеПодсистемыКлиент.ПараметрыРаботыКлиента
//                                 следует вызывать СтандартныеПодсистемыКлиент.ПараметрыРаботыКлиентаПриЗапуске.
//
// Пример:
//  Для того чтобы в начале заголовка приложения вывести название текущего проекта, следует определить параметр
//  ТекущийПроект в процедуре ОбщегоНазначенияПереопределяемый.ПриДобавленииПараметровРаботыКлиента и вписать код:
//
//  Если Не ОбщегоНазначенияКлиент.ДоступноИспользованиеРазделенныхДанных() Тогда
//    Возврат;
//  КонецЕсли;
//  ПараметрыКлиента = ?(ПриЗапуске, СтандартныеПодсистемыКлиент.ПараметрыРаботыКлиентаПриЗапуске(),
//    СтандартныеПодсистемыКлиент.ПараметрыРаботыКлиента());
//  Если ПараметрыКлиента.Свойство("ТекущийПроект")
//     И ЗначениеЗаполнено(ПараметрыКлиента.ТекущийПроект) Тогда
//    ЗаголовокПриложения = Строка(ПараметрыКлиента.ТекущийПроект) + " / " + ЗаголовокПриложения;
//  КонецЕсли;
//
Процедура ПриУстановкеЗаголовкаКлиентскогоПриложения(ЗаголовокПриложения, ПриЗапуске) Экспорт

Пример вызова

ОбщегоНазначенияКлиентПереопределяемый.ПриУстановкеЗаголовкаКлиентскогоПриложения(ЗаголовокПриложения, ПриЗапуске)

ПередПериодическойОтправкойДанныхКлиентаНаСервер

Описание, пример вызова

// Вызывается из глобального обработчика ожидания каждые 60 сек
// для возможности централизованно передать данные с клиента на сервер.
// Например, для передачи статистики о количестве открытых окон.
// Не рекомендуется делать собственные глобальные обработчики ожидания,
// чтобы минимизировать общее количество серверных вызовов.
//
// Не рекомендуется передавать данные каждые 60 сек, а делать это реже
// в зависимости от реальной необходимости (ориентироваться на один раз в 20 минут).
// Не рекомендуется передавать избыточно большой объем данных,
// так как это уменьшает отзывчивость клиентского приложения.
//
// Для отправки данных с клиента на сервер заполните параметр Параметры,
// который затем будет передан в процедуру
// ОбщегоНазначенияПереопределяемый.ПриПериодическомПолученииДанныхКлиентаНаСервере.
//
// Параметры:
//  Параметры - Соответствие из КлючИЗначение:
//    * Ключ     - Строка       - имя параметра, передаваемого на сервер.
//    * Значение - Произвольный - значение параметра, передаваемого на сервер.
//
// Пример:
//  МоментНачала = ТекущаяУниверсальнаяДатаВМиллисекундах();
//  Попытка
//    Если ОбщегоНазначенияКлиент.ПодсистемаСуществует("СтандартныеПодсистемы.ЦентрМониторинга") Тогда
//      МодульЦентрМониторингаКлиентСлужебный = ОбщегоНазначенияКлиент.ОбщийМодуль("ЦентрМониторингаКлиентСлужебный");
//      МодульЦентрМониторингаКлиентСлужебный.ПередПериодическойОтправкойДанныхКлиентаНаСервер(Параметры);
//    КонецЕсли;
//  Исключение
//    СерверныеОповещенияКлиент.ОбработатьОшибку(ИнформацияОбОшибке());
//  КонецПопытки;
//  СерверныеОповещенияКлиент.ДобавитьПоказатель(МоментНачала,
//    "ЦентрМониторингаКлиентСлужебный.ПередПериодическойОтправкойДанныхКлиентаНаСервер");
//
Процедура ПередПериодическойОтправкойДанныхКлиентаНаСервер(Параметры) Экспорт

Пример вызова

ОбщегоНазначенияКлиентПереопределяемый.ПередПериодическойОтправкойДанныхКлиентаНаСервер(Параметры)

ПослеПериодическогоПолученияДанныхКлиентаНаСервере

Описание, пример вызова

// Вызывается из глобального обработчика ожидания каждые 60 сек после возврата с сервера.
// Требуется, когда сервер возвращает результат для обработки на клиенте.
// Например, признак дальнейшей передачи статистики с клиента на сервер.
//
// Для получения результатов сервера на клиенте они должны быть заполнены
// в параметре Результаты в процедуре
// ОбщегоНазначенияПереопределяемый.ПриПериодическомПолученииДанныхКлиентаНаСервере.
//
// Параметры:
//  Результаты - Соответствие из КлючИЗначение:
//    * Ключ     - Строка       - имя параметра, возвращенного с сервера.
//    * Значение - Произвольный - значение параметра, возвращенного с сервера.
//
// Пример:
//  МоментНачала = ТекущаяУниверсальнаяДатаВМиллисекундах();
//  Попытка
//    Если ОбщегоНазначенияКлиент.ПодсистемаСуществует("СтандартныеПодсистемы.ЦентрМониторинга") Тогда
//      МодульЦентрМониторингаКлиентСлужебный = ОбщегоНазначенияКлиент.ОбщийМодуль("ЦентрМониторингаКлиентСлужебный");
//      МодульЦентрМониторингаКлиентСлужебный.ПослеПериодическогоПолученияДанныхКлиентаНаСервере(Результаты);
//    КонецЕсли;
//  Исключение
//    СерверныеОповещенияКлиент.ОбработатьОшибку(ИнформацияОбОшибке());
//  КонецПопытки;
//  СерверныеОповещенияКлиент.ДобавитьПоказатель(МоментНачала,
//    "ЦентрМониторингаКлиентСлужебный.ПослеПериодическогоПолученияДанныхКлиентаНаСервере");
//
Процедура ПослеПериодическогоПолученияДанныхКлиентаНаСервере(Результаты) Экспорт

Пример вызова

ОбщегоНазначенияКлиентПереопределяемый.ПослеПериодическогоПолученияДанныхКлиентаНаСервере(Результаты)

ПриГлобальномПоиске

Описание, пример вызова

// Вызывается при вводе в строку глобального поиска (после стандартной задержки).
// При вызове события в параметре ПланПоиска передается копия плана, установленного в менеджере глобального поиска.
// Содержимое параметра ПланПоиска можно модифицировать в коде обработчика.
//
// Параметры:
//  СтрокаПоиска - Строка - строка поиска
//  ПланПоиска - ПланГлобальногоПоиска - текущий план выполнения глобального поиска
//
Процедура ПриГлобальномПоиске(СтрокаПоиска, ПланПоиска) Экспорт

Пример вызова

ОбщегоНазначенияКлиентПереопределяемый.ПриГлобальномПоиске(СтрокаПоиска, ПланПоиска)

ПриВыбореРезультатаГлобальногоПоиска

Описание, пример вызова

// Вызывается при выборе результата глобального поиска.
// Если после завершения работы процедуры обработки события СтандартнаяОбработка установлено в Истина,
// то в зависимости от типа значения, используемого в объекте ЭлементРезультатаГлобальногоПоиска,
// выполняется одно из следующих действий:
//  Строка - переход по навигационной ссылке. Если строка является ссылкой на страницу справочной
//    информации, выполняется открытие справки.
//  ИдентификаторОбсужденияСистемыВзаимодействия, ИдентификаторПользователяСистемыВзаимодействия - открытие обсуждения.
//  ИдентификаторСообщенияСистемыВзаимодействия - открытие обсуждения и позиционирование на сообщение.
//  Другой тип - вызов метода ПоказатьЗначение с указанным значением.
//
// Параметры:
//  ЭлементРезультата - ЭлементРезультатаГлобальногоПоиска - выбранный результат поиска.
//  СтандартнаяОбработка - Булево - в данный параметр передается признак выполнения стандартной (системной) обработки события.
//                         Если в теле процедуры-обработчика установить данному параметру значение Ложь,
//                         стандартная обработка события производиться не будет.
//
Процедура ПриВыбореРезультатаГлобальногоПоиска(ЭлементРезультата, СтандартнаяОбработка) Экспорт

Пример вызова

ОбщегоНазначенияКлиентПереопределяемый.ПриВыбореРезультатаГлобальногоПоиска(ЭлементРезультата, СтандартнаяОбработка)

ПриВыбореДействияРезультатаГлобальногоПоиска

Описание, пример вызова

// Вызывается при нажатии на гиперссылку в элементе результата глобального поиска, заданную в свойстве Действия
//
// Параметры:
//  ЭлементРезультата - ЭлементРезультатаГлобальногоПоиска - элемент результата глобального описка,
//                      в котором нажата гиперссылка действия.
//  Действие - Произвольный - значение, заданное для нажатой гиперссылки.
//
Процедура ПриВыбореДействияРезультатаГлобальногоПоиска(ЭлементРезультата, Действие) Экспорт

Пример вызова

ОбщегоНазначенияКлиентПереопределяемый.ПриВыбореДействияРезультатаГлобальногоПоиска(ЭлементРезультата, Действие)

ОбработкаПереходаПоНавигационнойСсылке

Описание, пример вызова

// Вызывается при переходе по навигационной ссылке внутри приложения или при переходе в приложение по
// внешней ссылке или ссылке в мобильное приложение.
//
// Параметры:
//  ДанныеПереходаПоНавигационнойСсылке - ДанныеПереходаПоНавигационнойСсылке - данные перехода по навигационной ссылке.
//  СтандартнаяОбработка - Булево - в данный параметр передается признак выполнения стандартной (системной)
//   обработки ссылки. Если в теле процедуры-обработчика установить данному параметру значение Ложь,
//   стандартная обработка перехода по ссылке производиться не будет.
//
Процедура ОбработкаПереходаПоНавигационнойСсылке(ДанныеПереходаПоНавигационнойСсылке, Экспорт

Пример вызова

ОбщегоНазначенияКлиентПереопределяемый.ОбработкаПереходаПоНавигационнойСсылке(ДанныеПереходаПоНавигационнойСсылке, );