Содержание:
2. Пример использования метода ПоказатьВыборЭлемента в системе конфигурации 1С
1. Когда следует использовать метод ПоказатьВыборЭлемента
Рассмотрим метод ПоказатьВыборЭлемента на встроенном языке 1С 8.3. Метод ПоказатьВыборЭлемента дает возможность пользователю интерактивно выбрать элемент из списка. При вызове данного метода на экран выводится окно, в котором размещается список элементов 1С. В качестве элементов списка могут быть документы, карточки справочника и другое. Кроме метода ПоказатьВыборЭлемента на встроенном языке 1С 8.3 есть ещё метод ВыбратьЭлемент. Вызов метода 1С ВыбратьЭлемент также вызывает окно со списком, для интерактивного выбора пользователем элемента.
Думаю, метод ВыбратьЭлемент привычнее и проще в использовании в отличии от метода ПоказатьВыборЭлемента. Так как при использовании метода ПоказатьВыборЭлемента потребуется описать дополнительную экспортную процедуру. Есть причина, когда следует использовать метод ПоказатьВыборЭлемента. В противном случает возникнет ошибка (Рис. 1).
Рис. 1. Использования модальных окон в данном режиме запрещено
Чтобы определить какой метод следует использовать нужно открыть свойства Конфигурации и найти свойство РежимИспользованияМодальности. Если значение свойства РежимИспользованияМодальности установлено в НеИспользовать, то следует использовать метод ПоказатьВыборЭлемента.
2. Пример использования метода ПоказатьВыборЭлемента в системе конфигурации 1С
У метода ПоказатьВыборЭлемента есть три параметра. Один из которых необходимо заполнить.
Первый обязательный для заполнения параметр с типом ОписаниеОповещения. В данном параметре потребуется описать экспортную процедуру.
Второй параметр содержит заголовок окна со списком элементов 1С. Этот параметр определяет текст заголовка в окне со списком элементов 1С.
Третий параметр с типом ЭлементСпискаЗначений. Параметр дает возможность спозиционироваться при интерактивном выборе.
Предположим была поставлена задача. В информационной базе создаются документы Счет на оплату покупателю 1С. Должна быть форма обработки, где система будет выводить список документов Счет на оплату покупателю 1С. У пользователя должна быть возможность делать отбор по тем контрагентам по которым был создан документ Счет на оплату покупателю 1С. Отбор будет выполняться с помощью списка элементов 1С. В списке элементов 1С будут только те контрагенты, по которым был создан документ Счет на оплату покупателю 1С.
Для более лучшего представления работы метода ПоказатьВыборЭлемента в статье будет описана создание обработки 1С. В созданной обработке добавить поле, в котором будет выполняться отбор документов Счет на оплату покупателю 1С. Добавить таблицу, в которой будет отображаться список документов Счет на оплату покупателю 1С (Рис. 2).
Рис. 2. Форма обработки
При открытии формы обработки система вызовет процедуру ПриСозданииНаСервере (Рис. 3).
Рис. 3. Модуль формы. Процедура ПриСозданииНаСервере
В процедуре ПриСозданииНаСервере будет вызвана процедура ОбновитьТаблицуДокументовСчетНаОплатуПокупателю с параметром (Рис. 4).
Рис. 4. Модуль формы. Процедура ОбновитьТаблицуДокументовСчетНаОплатуПокупателю
Далее, вызывается процедура ПолучитьДокументыСчетНаОплатуПокупателю с параметром (Рис. 5)
Рис. 5. Модуль формы. Процедура ПолучитьДокументыСчетНаОплатуПокупателю
Процедура ПолучитьДокументыСчетНаОплатуПокупателю выполняет запрос документов Счет на оплату покупателю 1С и возвращает таблицу с документами Счет на оплату покупателю 1С. В статье установлено ограничение запроса до 5 записей, можно сделать без ограничения. Теперь пользователь видит все документы Счет на оплату покупателю 1С. И может сделать отбор по контрагенту (Рис. 6).
Рис. 6. Форма обработки в пользовательском режиме
При выборе контрагента будет выполняться метод ПоказатьВыборЭлемента (Рис. 7). Система запустит обработку события поля Контрагенты. С помощью функции ПолучитьСписокКонтрагентов объект встроенного языка 1С СписокЗначений загрузит массив Контрагентов.
Рис. 7. Модуль формы. Процедуры: КонтрагентыНачалоВыбора, ПолучитьСписокКонтрагентов
На экран выводится окно со списком контрагентов в 1С (Рис. 8).
Рис. 8. Окно списка элементов
Пользователь выбирает контрагента и нажимает «ОК». Система вызывает процедуру ВыборКонтрагента (Рис. 9), которая в дальнейшем выполняет процедуру ОбновитьТаблицуДокументовСчетНаОплатуПокупателю. В результате таблица документов выполнен отбор по контрагенту, выбранному из списка.
Рис. 9. Модуль формы. Процедура ВыборКонтрагента
Специалист 1С компании ООО «Кодерлайн»
Быков Владимир Станиславович
