Открыть форму нового элемента справочника до записи объекта с нужным УИД
Здравствуйте!
Есть обработка, которая создает номенклатуру по УИД.
УИД из другой базы приходит (настроен обмен) чтобы всякий мусор не гнать, надо только выбранные значения.
//
Короче, есть УИД, надо создать новый элемент номенклатуры с этим УИДом и открыть пользователю его форму до записи.
////////////////////
Делаю так:
&НаКлиенте
Процедура СоздатьНоменклатуру(Команда)
ТекДанные = Элементы.ТабНоменклатура.ТекущиеДанные;
Если ТекДанные = Неопределено Тогда
Возврат;
КонецЕсли;
Если ЗначениеЗаполнено(ТекДанные.Номенклатура) И ТипЗнч(ТекДанные.Номенклатура) = Тип(«СправочникСсылка.Номенклатура») Тогда
ПоказатьПредупреждение(Неопределено,»Создание номенклатуры не требуется!»);
Возврат;
КонецЕсли;
Если Не ЗначениеЗаполнено(ТекДанные.Номенклатура) Тогда
ПоказатьПредупреждение(Неопределено,»Поле номенклатура пустое!»);
Возврат;
КонецЕсли;
//
Ошибка = «»;
ПодключитьсяКБазеУПП(Ошибка);
Если ЗначениеЗаполнено(Ошибка) Тогда
Состояние(«Подключение не выполнено!»);
СтатусПодключения = «Ощибка подключения!»;
Элементы.ПоказатьОшибку.Видимость = Истина;
Сообщение = Новый СообщениеПользователю;
Сообщение.Текст = Ошибка;
Сообщение.Сообщить();
Возврат;
Иначе
Состояние(«Подключение выполнено!»);
СтатусПодключения = «Подключение выполнено!»;
Элементы.ПоказатьОшибку.Видимость = Ложь;
КонецЕсли;
ФормаЭлементаНоменклатуры = ПолучитьФорму(«Справочник.Номенклатура.Форма.ФормаЭлемента»);
СоздатьНоменклатуруУППСервер(ТекДанные.Номенклатура,ТекДанные.УИД,Ошибка);
Если ЗначениеЗаполнено(Ошибка) Тогда
ПоказатьПредупреждение(Неопределено,Ошибка);
Возврат;
КонецЕсли;
//Объект.Номенклатура.ВидНоменклатуры = ТекДанные.ВидНоменклатуры;
//Объект.Номенклатура.ЕдиницаИзмерения = ТекДанные.ЕдиницаИзмерения;
//
КопироватьДанныеФормы(Объект.Номенклатура, ФормаЭлементаНоменклатуры.Объект);
ФормаЭлементаНоменклатуры.Открыть();
//
КонецПроцедуры
Процедура СоздатьНоменклатуруУППСервер(Номенклатура,УИД,Ошибка)
СтруктураПодключения = ПолучитьИзВременногоХранилища(Адрес);
БазаУПП = СтруктураПодключения.Подключение;
///
СписокСкладов.Очистить();
СоответствиеСкладов = Новый Соответствие;
//
Если ЗначениеЗаполнено(УИД) Тогда
УИДНоменклатуры = УИД;
Иначе
НоменклатураУПП = БазаУПП.Справочники.Номенклатура.НайтиПоНаименованию(Номенклатура);
Если НоменклатураУПП = Неопределено Тогда
Ошибка = «Не найдена номенклатура в УУП!»;
Возврат;
КонецЕсли;
//
УИДНоменклатуры = БазаУПП.XMLСтрока(НоменклатураУПП);
КонецЕсли;
ОбНоменклатура = Справочники.Номенклатура.СоздатьЭлемент();
ОбНоменклатура.Наименование = Номенклатура;
ОбНоменклатура.УстановитьСсылкуНового(Справочники.Номенклатура.ПолучитьСсылку(Новый УникальныйИдентификатор(УИДНоменклатуры)));
///////////////
//Поясню
Все мои попытки передать объект с сервера на клиент, не взлетели.
ТОгда я добавил реквизит обработки «Объект.Номенклатура» с типом НоменклатураОбъект и делаю через него.
////
Косяк в том, что после записи объекта в форме, уид не тот, что надо.
Подскажите, помогите, как это сделать правильно? Спасибо!
Как в 1с открыть форму программно
В статье будет рассказано о том, как в 1с открыть форму программно. Все описанное ниже, касается только управляемого приложения. Подробно рассмотрим метод глобального контекста ОткрытьФорму.
Также можете ознакомиться с более простыми, но менее гибкими способами открыть форму по ссылке: Как в 1с открыть ссылку.
Метод ОткрытьФорму по имени
Самый гибкий и настраиваемый способ программного открытия формы в 1с 8. Рассмотрим подробно его параметры, а также разберем несколько примеров его использования.
Следует заметить, что метод ОткрытьФорму является клиентским. Т.е его можно использовать либо в общих модулях с установленным флагом Клиент, либо в процедурах (функциях) форм с директивой &НаКлиенте.
Рассмотрим параметры метода и приведем необходимые примеры.
ИмяФормы
Содержит полный путь к форме. Можно указать, как путь к форме по умолчанию, так и путь к произвольной форме объекта метаданных. Имя формы указывается в следующих двух форматах:
Пример 1. Путь к форме выбора по умолчанию, справочника Номенклатура.
Пример 2. Путь к форме СменаПочты справочника Пользователи, по ее имени.
Параметры
Содержит Структуру параметров, которые передаются в открываемую форму. Для каждого типа формы, существует набор стандартных параметров, которые не нужно дополнительно обрабатывать в самой форме. Также набор параметров может различаться и для объектов метаданных. Например, параметр Ключ, для форм объектов. В него можно передать ссылку на открываемый объект (если его не передать, будет открыта форма нового объекта).
Также в структуру можно передавать произвольные параметры, которые можно обрабатывать программно, в открываемой форме. Например в обработчике события ПриСозданииНаСервере.
Рассмотрим примеры открытия различных форм с использованием параметров.
Пример 3. Открыть форму объекта справочника Пользователи, используя ссылку на объект.
Пример 4. Открыть форму списка справочника Номенклатура с отбором по реквизиту ВидНоменклатуры и по списку родителей.
Здесь Отбор — это стандартный параметр для форм, использующих в качестве основного реквизита Динамический список. Например, это формы списка и выбора. Он представляет из себя Структуру, в которую можно добавить значения элементов отбора. В Ключ — имя реквизита, в Значение — значение отбора.
Данным способом можно отобрать значения, используя вид сравнения Равно или ВСписке. Для отбора ВСписке следует добавить в структуру Массив, ФиксированныйМассив, либо СписокЗначений. Следует заметить, что отбор ВИерархии установить данным способом не выйдет.
Владелец
В данный параметр передается элемент формы или форма клиентского приложения (управляемая форма) полностью. Используется для указания подчинения открываемой формы.
Это может потребоваться для многих целей, например для:
Пример 5. Реализовать программный выбор элемента Номенклатура, в поле ввода.
В данном случае необходимо:
Параметр ТекущаяСтрока, позволяет выделять ранее выбранный элемент в форме выбора. Стоит заменить, что в обычной ситуации такой метод выбора значений не применяется. Его применяют только тогда, когда нет возможности настроить форму выбора под условия задачи.
Уникальность
В параметре можно задать ключ уникальности формы произвольного типа. При открытии формы, платформа будет анализировать, есть в текущем сеансе уже открытая форма, с таким же ключом уникальности. Если такая форма будет найдена, то она будет активизирована, а новая не откроется. Этот механизм работает только для одинаковых форм. Если вы будете открывать формы объекта разных документов с одинаковым ключом, то откроются обе.
По умолчанию, платформа сама генерирует ключ уникальности. Поэтому помимо использования собственного ключа, в параметре Уникальность, можно регулировать использование стандартного. Если передать в него значение Ложь, то будет использован стандартный ключ, если значение Истина, то ключ не будет использоваться совсем. Т.е. будет создаваться новая форма, при каждом использовании метода ОткрытьФорму. Значением по умолчанию является Ложь, поэтому специально задавать его не требуется.
Пример 6. Одновременно открыть две формы объекта справочника Пользователи, по одной и той же ссылке.
В параметре можно указать окно, в котором будет открыта новая форма. Тип параметра ОкноКлиентскогоПриложения.
Пример 7. Реализовать программный выбор элемента Номенклатура, в поле ввода. Реализовать выбор в окне формы, на которой расположено поле.
В этом примере мы получаем окно текущей формы и используем его для открытия формы выбора справочника.
НавигационнаяСсылка
Позволяет установить собственную навигационную ссылку для открываемой формы. Устанавливаемая навигационная ссылка должна иметь тип Строка. Значение по умолчанию: Неопределено, при использовании этого значения, навигационная ссылка задается автоматически.
ОписаниеОповещенияОЗакрытии
В параметр передается описание процедуры, которая будет вызвана после закрытия открываемой формы. Тип параметра: ОписаниеОповещения.
Пример 8. В 1с открыть форму программно. Использовать форму объекта справочника Пользователи. После ее закрытия сообщить, что карточка пользователя закрыта.
Используемые в примере параметры описания оповещения:
Описанная процедура обязательно должна иметь два параметра:
Также описанная процедура должна быть экспортной.
РежимОткрытияОкна
Позволяет указать режим открытия управляемой формы. По умолчанию Неопределено, вручную можно задать одно из значений системного перечисления РежимОткрытияОкнаФормы:
Метод ОткрытьФорму по форме
Существует еще один вариант синтаксиса метода ОткрытьФорму.
Используется, если вы уже получили форму, произвели с ней какие-то действия и теперь ее необходимо открыть.
Пример 9. Получить форму списка справочника Номенклатура, а затем в 1с открыть форму программно.
Программное открытие форм в управляемом приложении 1С
Программное открытие форм в управляемом приложении 1С значительно отличается от их открытия в обычном приложении. Рассмотрим для начала старый метод. Он заключается в получении формы и ее последующем открытии в обычном или модальном режиме (при открытии в модальном режиме форма блокирует работу программы).
Это самый медленный метод открытия форм. Тем не менее, он позволяет программно обработать форму перед открытием. Для обработки код нужно немного изменить:
Надо учитывать, что при получении формы будет выполняться еще процедура события ПриСозданииНаСервере.
Рассмотрим другие методы, которые позволяют открывать формы в управляемом приложении 1С быстрее и удобнее. В зависимости от конкретной ситуации могут использоваться разные методы.
1. Как открыть форму объекта в управляемом приложении, если есть ссылка на него.
В этом случае все предельно просто.
2. Как открыть форму выбора и получить потом выбранное значение.
Для этого существует функция ВвестиЗначение(). У функции 3 параметра:
В результате выполнения функции откроется форма выбора по умолчанию для объекта указанного типа.
ОписаниеТипов = новый ОписаниеТипов ( Массив ) ;
Предыдущие способы позволяли открывать только формы, установленные для объектов по умолчанию (форму объекта или форму выбора). Если нужно открыть произвольную форму, то можно воспользоваться функцией ОткрытьФорму().
Эта функция имеет довольно много параметров. Рассмотрим некоторые из них:
Рассмотрим, как применяется функция ОткрытьФорму() в различных ситуациях.
3. Как открыть форму существующего объекта
У каждой формы есть один ключевой реквизит. Он выделен жирным в списке реквизитов формы и обычно называется Объект у форм элементов справочников, документов. У других объектов название может быть другим. Для открытия формы существующего объекта нужно передать в открываемую форму параметр Ключ со значением в виде ссылки на объект.
4. Как открыть форму нового объекта
Тут подойдет просто функция ОткрытьФорму() без всяких параметров.
5. Как открыть форму нового объекта и заполнить ее на основании чего-либо
Нужно передать параметр Основание, значением которого будет являться ссылка на объект-основание заполнения. При этом будет запущена процедура ОбработкаЗаполнения().
В этом примере будет создан документ Реализация товаров и услуг и заполнен на основании счета на оплату покупателю, ссылка на который была передана.
6. Как открыть форму и задать на ней отбор
Отбор на формах 1С может быть простым и сложным. Простой отбор предусматривает выражения типа Организация = ООО «Рога и копыта». Сложный отбор предполагает и другие типы сравнения, например, В списке. В данной статье рассмотрим организацию простого отбора, а сложному будет посвящена отдельная статья.
Чтобы организовать простой отбор, нужно передать в открываемую форму параметр с ключом Отбор, значением будет являться структура, в которой ключ — имя поля динамического списка, а значение — искомые данные.
Например, откроем форму списка справочника НомераГТД и сделаем там отбор по владельцу — элементу справочника Номенклатура.
7. Как открыть форму записи регистра сведений
Для этого понадобится ключ записи регистра сведений.
Ключ записи — это значения всех измерений и период (если регистр периодический). То есть ключ записи — это параметры, по которым можно однозначно идентифицировать запись.
Алгоритм открытия следующий:
Работа с формами в «1С:Предприятии 8»
Например, формы списков вы можете увидеть при открытии разнообразных справочников, журналов документов, списков записей в регистрах конфигурации и т. п.
Например, вызывая справочник «Контрагенты», мы получаем на экране как раз такую форму-список (рис. 1).
Как правило, кроме собственно списка, у форм такого типа присутствует командная панель с кнопками-действиями, которые выполняются над элементами данного списка.
При наведении (не нажатии!) мышью на одно из действий, вы получите краткое пояснения этого действия и «горячую» клавишу (или комбинацию клавиш) для его выполнения, если имеется такая возможность.
Кроме этого, в командной панели, как правило, присутствует элемент «Действия», где собраны все действия, которые можно выполнять над элементами данного списка.
При отметке какого-либо элемента в списке, можно нажать на нем правой кнопкой мыши. В результате вы получите список разрешенных действий для данного элемента.
Некоторые действия одинаковы для всех списков, некоторые созданы разработчиками конфигурации и могут отсутствовать в других формах списков.
Для часто используемых в форме списков действий назначены комбинации клавиш (подробнее об использовании «горячих» клавиш читайте в номере 10 (октябрь) «БУХ.1С» за 2007 год, стр. 8), использование которых повысит эффективность работы в программе:
Действие
Сочетание клавиш
Активация действия в командной панели
Добавить новый элемент
Пометка на удаление
Добавить группу (для справочников с иерархией)
Переместить элемент в другую группу (для справочников с иерархией)
Быстрый вход внутрь группы (для справочников с иерархией)
Выход на уровень выше
Добавить новый элемент копированием текущего
Изменить текущий элемент
В некоторых списках имеется возможность множественного выделения выбранных элементов с целью их групповой обработки. Для того, чтобы выделить несколько элементов (если это разрешено в списке), достаточно нажать клавишу Shift и прощелкать мышью необходимые элементы.
Для этого можно использовать клавиши со стрелками (вверх, вниз, вправо, влево), включая привычное всем нам страничное листание (PageUp/PageDown) в сочетании с этими клавишами. Работают также общепринятые «горячие» клавиши:
Действие
Сочетание клавиш
Выделить все от текущей позиции до начала списка
Выделить все от текущей позиции до конца списка
Выделить все элементы
Копирование текстового представления текущей ячейки в списке элементов
Форма списка
Например, формы списков вы можете увидеть при открытии разнообразных справочников, журналов документов, списков записей в регистрах конфигурации и т. п.
Например, вызывая справочник «Контрагенты», мы получаем на экране как раз такую форму-список (рис. 1).
Как правило, кроме собственно списка, у форм такого типа присутствует командная панель с кнопками-действиями, которые выполняются над элементами данного списка.
При наведении (не нажатии!) мышью на одно из действий, вы получите краткое пояснения этого действия и «горячую» клавишу (или комбинацию клавиш) для его выполнения, если имеется такая возможность.
Кроме этого, в командной панели, как правило, присутствует элемент «Действия», где собраны все действия, которые можно выполнять над элементами данного списка.
При отметке какого-либо элемента в списке, можно нажать на нем правой кнопкой мыши. В результате вы получите список разрешенных действий для данного элемента.
Некоторые действия одинаковы для всех списков, некоторые созданы разработчиками конфигурации и могут отсутствовать в других формах списков.
Для часто используемых в форме списков действий назначены комбинации клавиш (подробнее об использовании «горячих» клавиш читайте в номере 10 (октябрь) «БУХ.1С» за 2007 год, стр. 8), использование которых повысит эффективность работы в программе:
Действие
Сочетание клавиш
Активация действия в командной панели
Добавить новый элемент
Пометка на удаление
Добавить группу (для справочников с иерархией)
Переместить элемент в другую группу (для справочников с иерархией)
Быстрый вход внутрь группы (для справочников с иерархией)
Выход на уровень выше
Добавить новый элемент копированием текущего
Изменить текущий элемент
В некоторых списках имеется возможность множественного выделения выбранных элементов с целью их групповой обработки. Для того, чтобы выделить несколько элементов (если это разрешено в списке), достаточно нажать клавишу Shift и прощелкать мышью необходимые элементы.
Для этого можно использовать клавиши со стрелками (вверх, вниз, вправо, влево), включая привычное всем нам страничное листание (PageUp/PageDown) в сочетании с этими клавишами. Работают также общепринятые «горячие» клавиши:
Действие
Сочетание клавиш
Выделить все от текущей позиции до начала списка
Выделить все от текущей позиции до конца списка
Выделить все элементы
Копирование текстового представления текущей ячейки в списке элементов
Форма элемента
Чтобы не перегружать наше восприятие, информационное наполнение формы распределяется в ней по нескольким закладкам.
Для форм элементов характерно наличие командных панелей сверху и/или снизу открываемого окна. Это командные панели формы с действиями, которые относятся к открытому объекту конфигурации целиком.
Обычно одна из команд назначена «кнопкой по умолчанию». Она активируется комбинацией клавиш Ctrl+Enter. Такая кнопка выделяется жирным (в нашем примере, это кнопка «ОК»).
Как правило, на форме элемента четко можно определить разницу между командными панелями формы и вспомогательными командными панелями.
Комбинация Alt+F10 работает и здесь, она активирует ту командную панель, с элементами которой пользователь работает в данный момент времени.
Полезно знать, что практически все действия на форме элемента можно выполнять без использования мыши.
Клавиатурное управление, как правило, значительно ускоряет процесс работы с данными. Например, нажатие на клавишу Enter или Tab, позволяет «перескакивать» с одного элемента формы на другой (следующий за ним). Нажатие Shift+Tab позволяет «скакать» по элементам в обратном направлении. Если вы находитесь в каком-либо поле ввода (например, на рис. 2 в группе контрагентов), достаточно написать первые буквы нужного вам элемента и нажать Tab и программа автоматически подставит нужный элемент в поле ввода (если он уникален в системе), либо предоставит автоматический список для уточнения вашего варианта.
Действие
Сочетание клавиш
Открыть форму выбора нужного элемента
Открыть форму элемента уже выбранного объекта в поле ввода
Очистить поле ввода
Быстрое переключение между закладками на форме, если они есть
Ctrl+PageUp и Ctrl+PageDown
Переключение активного элемента типа «Флажок»
Отказаться от внесенных изменений в текстовых элементах формы
Вернуть отмененное действие
Закрытие практически любой формы
Закрытие/открытие окна служебных сообщений (того, которое может появляться внизу)
При вводе новых объектов конфигурации при помощи форм элементов, обязательные для заполнения поля подчеркнуты красным. Например, для документа «Реализация товаров и услуг: Продажа, комиссия» такими полями являются поле «Контрагент» и поле «Договор» (рис. 4).
Выделять текстовые блоки можно мышью, а можно курсорами с нажатой клавишей Shift. Это бывает полезно для операций с буфером обмена.
Форма выбора
Как правило, в форме выбора можно выполнять массу подобных форме списка действий. Например, завести новый элемент. О том, какие действия возможны в данном случае, вы всегда сможете узнать из наполнения командной панели формы выбора и по тому, какие горячие клавиши работают, а какие нет.
Форма группы
Для каждого объекта конфигурации, может быть задано при разработке несколько форм: разнообразные формы элемента, выбора, вспомогательные формы. Необходимо это, в первую очередь, для облегчения ввода и обработки информации, хранящейся в этом объекте. То есть набор форм, как правило, определяется на этапе создания конфигурации и в разных конфигурациях может отличаться друг от друга даже для однотипных объектов (например, в типовых конфигурациях «Бухгалтерия предприятия» и «Управление торговлей»).
В любом случае, поведение элементов, расположенных на форме, как правило, идентично с точки зрения возможностей управления ими мышью или «горячими» клавишами.
Если специальных пояснений нет, то вам отобразится общая информация по работе с текущим типом формы.
Вызвать справку можно, нажав клавишу F1.
Кроме этого, в таком случае всегда доступны «горячие» клавиши Ctrl+Shift+Стрелка вверх и Ctrl+Shift+Стрелка вниз.
Открытие форм
Область применения: управляемое приложение, мобильное приложение.
Рекомендация обусловлена соображениями
2. В случаях когда форма требует параметризации при открытии, все ее параметры следует указывать в наборе параметров формы. Таким образом, набор параметров формы декларативно описывает возможности формы по ее параметризации.
Параметры формы из этого набора могут быть указаны в вызывающем коде при открытии формы ( ОткрытьФорму ).
3. Не следует применять другие способы параметризации формы при открытии. Например, нужно избегать обращения к методам и свойствам формы после ее открытия.
Например, вместо
ФормаПутеводитель = Форма.ОткрытьФорму(«ОбщаяФорма.ПутеводительПоСистеме»);
ФормаПутеводитель.Элементы.ГруппаШаг.ТекущаяСтраница = ФормаПутеводитель.Элементы.ГруппаШаг.Страницы.Приветствие;
следует по той же причине использовать параметры формы:
ОткрытьФорму(«ОбщаяФорма.ПутеводительПоСистеме», Новый Структура(«РежимОткрытия», «Приветствие»));
4. Для получения результата работы формы, вместо непосредственного обращения к элементам и реквизитам формы
ФормаВопроса = ПолучитьФорму(«ОбщаяФорма.ФормаВопроса»);
ФормаВопроса.ОткрытьМодально();
Если ФормаВопроса.БольшеНеПоказыватьНапоминание Тогда
// …
следует использовать процедуры-обработчики оповещений, которые будут вызваны при завершении работы пользователя с формой:
Оповещение = Новый ОписаниеОповещения(«БольшеНеПоказыватьНапоминаниеЗавершение», ЭтотОбъект);
ОткрытьФорму(«ОбщаяФорма.ФормаВопроса». Оповещение, РежимОткрытияОкнаФормы.БлокироватьВеcьИнтерфейс);
.
&НаКлиенте
Процедура БольшеНеПоказыватьНапоминаниеЗавершение(БольшеНеПоказыватьНапоминание, Параметры) Экспорт
Если БольшеНеПоказыватьНапоминание = Неопределено Тогда
Возврат;
КонецЕсли;
Если БольшеНеПоказыватьНапоминание Тогда
// …
5. Другие ограничения:
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Если Не ПользователиКлиентСервер.ЭтоСеансВнешнегоПользователя() Тогда
Отказ = Истина;
Возврат;
КонецЕсли;
…
КонецПроцедуры
6. Следующие виды форм должны быть всегда доступны пользователю в режиме 1С:Предприятия из меню «Все функции» вне зависимости от того, размещены ли соответствующие объекты в командном интерфейсе приложения или нет: