ТочкаМаршрутаБизнесПроцессаСсылка.<Имя бизнес-процесса>.ОбработкаВыбораВарианта

События · SwitchProcessing

Вызывается после осуществления выбора перехода. В параметре <Результат> возвращается вариант перехода. Обработчик этого события обязательно должен быть назначен, т.к. в противном случае бизнес-процесс не сможет самостоятельно выбрать вариант перехода, что приведет к ошибке.

Синтаксис

ОбработкаВыбораВарианта(<ТочкаВыбораВарианта>, <Результат>)
Полное описание, параметры и ограничения

ТочкаМаршрутаБизнесПроцессаСсылка.<Имя бизнес-процесса>.ОбработкаВыбораВарианта (BusinessProcessRoutePointRef.<Business process name>.SwitchProcessing)

ТочкаМаршрутаБизнесПроцессаСсылка.<Имя бизнес-процесса> (BusinessProcessRoutePointRef.<Business process name>)

ОбработкаВыбораВарианта (SwitchProcessing)

Доступен, начиная с версии 8.0.

Синтаксис:
ОбработкаВыбораВарианта(<ТочкаВыбораВарианта>, <Результат>)
Параметры:

<ТочкаВыбораВарианта>
Тип: ТочкаМаршрутаБизнесПроцессаСсылка.<Имя бизнес-процесса>.
Точка выбора варианта, для которой вызывается обработчик для определения дальнейшей точки маршрута бизнес-процесса.

<Результат>
Тип: ВариантТочкиМаршрутаБизнесПроцесса.
Выбранный вариант точки маршрута бизнес-процесса. Должен быть обязательно установлен одним из вариантов.
Описание:

Вызывается после осуществления выбора перехода. В параметре <Результат> возвращается вариант перехода. Обработчик этого события обязательно должен быть назначен, т.к. в противном случае бизнес-процесс не сможет самостоятельно выбрать вариант перехода, что приведет к ошибке.

Доступность:

Сервер, толстый клиент, внешнее соединение.

Примечание:
Только для точек вида ВыборВарианта.
Это событие неинтерактивное и в нем не рекомендуется открывать какие-либо окна для организации диалога с пользователем.
Использование в версии:

Доступен, начиная с версии 8.0.

Методическая информация

Практические примеры

СпособРазбора: ОбработкаВыбораВарианта

Свой учебный процесс даёт настоящий источник события; в примере конкретное правило суммы, подтверждения или маршрутизации.

Где и как запускать

Модуль объекта своего бизнес-процесса УчебноеСогласование; процедуры назначаются в редакторе карты.

Подготовка

  1. Работайте в отдельной пустой учебной конфигурации. Создайте справочник УчебныеИсполнители и предопределённый элемент Демонстрационный с наименованием Учебный исполнитель.

  2. Создайте задачу УчебныеСогласования: строковый номер длиной 12, автонумерация, наименование длиной 100. Добавьте реквизит адресации Исполнитель типа СправочникСсылка.УчебныеИсполнители и выберите его основным реквизитом адресации. Здесь используется прямая адресация; регистр ролевой адресации не нужен.

  3. Создайте параметр сеанса УчебныйИсполнитель того же ссылочного типа. В свойстве задачи Текущий исполнитель выберите этот параметр. Запросы урока передают исполнителя явно и не зависят от начального значения параметра сеанса.

  4. Создайте бизнес-процесс УчебноеСогласование со строковым номером длиной 12 и автонумерацией. В свойстве Задача выберите УчебныеСогласования. Карта маршрута: Старт (начало) → Согласовать (действие) → Завершение. В точке Согласовать задайте адресацию Исполнитель = Демонстрационный, Групповая = Ложь.

  5. И у задачи, и у бизнес-процесса создайте обычные реквизиты КомментарийУчебный (Строка 100), Сумма (Число 12.2), Подтверждено (Булево), ЗапретУдаления (Булево). Добавьте табличную часть Детали с колонками Наименование (Строка 100) и Количество (Число 10.0).

  6. Каждый урок делайте на своей отдельной учебной карте. Основной код размещается в Модуле объекта бизнес-процесса УчебноеСогласование. В редакторе карты выберите указанную точку и назначьте её событию полное имя процедуры. Директивы клиентской формы в модуле объекта не добавляются.

  7. Создайте собственный процесс через его форму, заполните Сумма=500, КомментарийУчебный=Учебная покупка; в Детали добавьте Книга / Количество=2. Адресация точки Согласовать — собственный Демонстрационный. Тестовые задачи и процессы действительно создаются только при вашем ручном запуске.

  8. Не вызывайте обработчик вручную вместо механизма маршрута: событие получает настоящую точку / задачу от платформы. Ничего из приведённого кода при сборке HTML не выполнялось.

  9. Карта: Старт → СпособРазбора вида ВыборВарианта. Создайте именно имена вариантов Подробно и Кратко; выходы ведут в два собственных действия с исполнителем Демонстрационный и затем в Завершение. Значение Результат обязательно задаётся на обеих ветках кода.

Процедура СпособРазбораОбработкаВыбораВарианта(ТочкаВыбораВарианта, Результат)
    Если Сумма > 500 Тогда
        Результат = ТочкаВыбораВарианта.Варианты.Подробно;
    Иначе
        Результат = ТочкаВыбораВарианта.Варианты.Кратко;
    КонецЕсли;
    Сообщить("Выбран собственный вариант: " + Строка(Результат));
КонецПроцедуры

Разбор по шагам

  1. Подготовьте собственную карту и её реквизиты.

  2. Назначьте обработчик событию точной точки маршрута.

  3. Запустите / выполните собственный процесс и сравните заполненные и незаполненные условия.

Как проверить результат

  1. Для точки СпособРазбора назначена процедура СпособРазбораОбработкаВыбораВарианта. Параметры соответствуют событию точки, а не похожему событию самой задачи.

  2. Серверный обработчик использует Сообщить; модальные окна и формы в неинтерактивной обработке маршрута не открываются.

  3. Сумма=500 выбирает Кратко, 750 — Подробно. Возвращается ВариантТочкиМаршрутаБизнесПроцесса, не строка названия.

Ожидаемый результат

Показано реальное место вызова и действие параметров конкретного события маршрута.

На что обратить внимание

  1. Отказ и Результат имеют разные смыслы: Истина в Отказ отменяет действие, а Истина в ПроверкаУсловия выбирает отмеченную ветку.

  2. Учебный UI-запуск действительно может записывать только собственные процессы / задачи. Рабочую базу не используйте.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.