ПараметрыФормированияКомандПланировщика.Источник

Свойства · Source

Тип: ИсточникКомандПланировщика. Содержит информацию о том, на какой объект было произведено нажатие. В зависимости от того, какой элемент содержит форматированную строку с гиперссылкой, заполняются разные свойства объекта типа ПараметрыФормированияКомандПланировщика. Если источник равен НавигационнаяСсылка, тогда: Заполнено свойство либо Элементы, либо ЭлементИзмерения, либо Измерение, если навигационная ссылка находится в заголовке элемента измерения, то свойство ЗначенияИзмерений, либо ЭлементШкалыВремени заполнен, иначе содержит Неопределено, Дата содержит Неопределено, НавигационнаяСсылка заполнено, Действие содержит Неопределено, Команды содержат стандартные команды ПерейтиПоНавигационнойСсылке, КопироватьНавигационнуюСсылку, КомандаПоУмолчанию заполнено командой ПерейтиПоНавигационнойСсылке. Если источник равен Действие тогда: Элементы заполнено, свойства ЭлементИзмерения, Измерение, ЗначенияИзмерений, содержит Неопределено, Дата, ЭлементШкалыВремени, НавигационнаяСсылка содержат Неопределено, Список команд не содержит стандартных команд, <КомандаПоУмолчанию> заполнено командой ВыполнитьДействие.

Полное описание, параметры и ограничения

ПараметрыФормированияКомандПланировщика.Источник (PlannerCommandGenerateParameters.Source)

ПараметрыФормированияКомандПланировщика (PlannerCommandGenerateParameters)

Источник (Source)

Не рекомендуется использовать, начиная с версии 8.3.23.

Рекомендуется использовать:

Источник

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

Использование:
Только чтение.
Описание:
Тип: ИсточникКомандПланировщика.
Содержит информацию о том, на какой объект было произведено нажатие.
В зависимости от того, какой элемент содержит форматированную строку с гиперссылкой, заполняются разные свойства объекта типа ПараметрыФормированияКомандПланировщика.
Если источник равен НавигационнаяСсылка, тогда:
Заполнено свойство либо Элементы, либо ЭлементИзмерения, либо Измерение,

если навигационная ссылка находится в заголовке элемента измерения, то свойство ЗначенияИзмерений, либо ЭлементШкалыВремени заполнен, иначе содержит Неопределено,

Дата содержит Неопределено,

НавигационнаяСсылка заполнено,

Действие содержит Неопределено,

Команды содержат стандартные команды ПерейтиПоНавигационнойСсылке, КопироватьНавигационнуюСсылку,

КомандаПоУмолчанию заполнено командой ПерейтиПоНавигационнойСсылке.
Если источник равен Действие тогда:
Элементы заполнено,

свойства ЭлементИзмерения, Измерение, ЗначенияИзмерений, содержит Неопределено, Дата, ЭлементШкалыВремени, НавигационнаяСсылка содержат Неопределено,

Список команд не содержит стандартных команд,

<КомандаПоУмолчанию> заполнено командой ВыполнитьДействие.

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

Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).

Использование в версии:

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

Не рекомендуется использовать, начиная с версии 8.3.23.

Описание изменено в версии 8.3.23.

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

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

Синтаксис старого callback планировщика: что нажал пользователь

Для реально переданного старого ПараметрыФормированияКомандПланировщика показываем источник нажатия и заполненные данные. В новом поле формы тип параметров другой.

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

Событие управляемой формы: &НаКлиенте; старый объект параметров, реально предоставленный планировщиком.

Подготовка

  1. Ограниченный образец для существующей старой формы, где реально передается указанный старый тип. В модуле этой управляемой формы элемент называется УчебныйПланировщик; событие ОбработкаФормированияКоманд назначено этой процедуре.

  2. В новом поле формы событие передает ПараметрыФормированияКомандПоляПланировщика. Код не подменяет этот тип старым и не создает параметры вручную.

&НаКлиенте
Процедура УчебныйПланировщикОбработкаФормированияКоманд(ПараметрыКоманд, Команды, КомандаПоУмолчанию)
    Если ТипЗнч(ПараметрыКоманд) <> Тип("ПараметрыФормированияКомандПланировщика") Тогда
        Сообщить("Переданы параметры нового поля планировщика, не старого типа");
        Возврат;
    КонецЕсли;
    Сообщить("Форма: " + ЭтотОбъект.ИмяФормы + "; поле: " + Элементы.УчебныйПланировщик.Имя);
    Сообщить("Источник: " + Строка(ПараметрыКоманд.Источник));
    Сообщить("Дата: " + Строка(ПараметрыКоманд.Дата));
    Сообщить("Действие: " + Строка(ПараметрыКоманд.Действие));
    Сообщить("Измерение: " + Строка(ПараметрыКоманд.Измерение));
    Сообщить("Элемент измерения: " + Строка(ПараметрыКоманд.ЭлементИзмерения));
    Сообщить("Шкала: " + Строка(ПараметрыКоманд.ЭлементШкалыВремени));
    Сообщить("Ссылка: " + ПараметрыКоманд.НавигационнаяСсылка);
    Если ПараметрыКоманд.ЗначенияИзмерений <> Неопределено Тогда
        Для Каждого Пара Из ПараметрыКоманд.ЗначенияИзмерений Цикл
            Сообщить(Строка(Пара.Ключ) + ": " + Строка(Пара.Значение));
        КонецЦикла;
    КонецЕсли;
    Если ПараметрыКоманд.Элементы <> Неопределено Тогда
        Сообщить("Выбранных элементов: " + Строка(ПараметрыКоманд.Элементы.Количество()));
    КонецЕсли;
    Сообщить("Команд: " + Строка(Команды.Количество()) + "; по умолчанию: " + Строка(КомандаПоУмолчанию));
КонецПроцедуры

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

  1. Настоящий пользовательский щелчок вызывает событие.

  2. Проверьте переданный тип и выведите источник нажатия.

  3. Для необязательных данных обработайте Неопределено.

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

  1. Сравните сообщения при нажатии элемента, шкалы времени и ссылки.

  2. На современном типе ожидайте пояснение о другом типе, а не успешную демонстрацию старого API.

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

Сведения старого объекта события, если он действительно предоставлен платформой.

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

  1. Старый тип не рекомендуется с 8.3.23. Это не автономный способ получить его в новой форме; не вызывайте обработчик вручную. Не все свойства заполнены для каждого вида нажатия.

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

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

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

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

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