База знаний Одина — Одинэсника › Форумы › ODIN — Форум по 1С Предприятию › Как создать управляемую форму в 1С? › Ответ в теме: Как создать управляемую форму в 1С?
## Как создать первую управляемую форму в 1С
Ниже самый простой вариант: создадим справочник Товары и его управляемую форму элемента.
### 1. Включите управляемое приложение
В конфигураторе откройте:
Конфигурация → Открыть конфигурацию
Затем выберите корень конфигурации и проверьте свойство:
Основной режим запуска → Управляемое приложение
Если планируется запускать конфигурацию только в управляемом режиме, можно включить:
— Использовать управляемые формы
— при необходимости отключить использование обычных форм
Точный набор свойств зависит от версии платформы 1С.
—
## 2. Создайте справочник
В дереве конфигурации:
1. Нажмите правой кнопкой на ветке Справочники.
2. Выберите Добавить.
3. Назовите справочник:
|
1 |
Товары |
4. Откройте свойства справочника.
5. Перейдите на вкладку Данные.
6. Добавьте реквизиты:
| Имя | Тип |
|—|—|
| Артикул | Строка, например 20 символов |
| Цена | Число, например 15.2 |
| Описание | Строка неограниченной длины |
В справочнике автоматически есть стандартный реквизит Наименование.
—
## 3. Создайте управляемую форму элемента
В свойствах справочника Товары перейдите на вкладку Формы.
Нажмите кнопку добавления формы или кнопку с изображением лупы.
В конструкторе выберите:
|
1 |
Основная форма элемента |
Обычно 1С предложит создать форму автоматически. Согласитесь с настройками и нажмите Готово.
В редакторе формы будут созданы:
— реквизит формы Объект;
— элементы формы;
— поля для Наименование, Артикул, Цена, Описание;
— стандартные команды записи и закрытия.
Нажмите Записать и закрыть.
Управляемая форма элемента справочника создана.
—
## 4. Создайте форму списка
Теперь создадим форму, в которой будут отображаться все товары.
В свойствах справочника Товары снова откройте вкладку Формы.
Создайте:
|
1 |
Основная форма списка |
В большинстве случаев конструктор автоматически создаст:
— реквизит Список типа Динамический список;
— табличное поле Список;
— стандартные команды добавления, изменения и удаления элементов.
После создания откройте форму списка в редакторе.
Слева находится дерево элементов формы, справа доступны:
— реквизиты формы;
— команды;
— параметры;
— свойства выбранного элемента.
Выделите табличное поле Список и проверьте свойство:
|
1 |
ПутьКДанным |
Оно должно ссылаться на реквизит формы:
|
1 |
Список |
Если список создан конструктором, это уже будет настроено автоматически.
—
## 5. Добавьте справочник в подсистему
Чтобы форма появилась в пользовательском интерфейсе:
1. Создайте подсистему, например:
|
1 |
Продажи |
2. Откройте состав подсистемы.
3. Добавьте в нее справочник Товары.
4. В свойствах подсистемы включите:
|
1 |
Включать в командный интерфейс |
5. Откройте командный интерфейс подсистемы.
6. Найдите команду открытия справочника Товары.
7. Убедитесь, что для нее включена видимость в панели навигации.
После этого справочник будет доступен пользователю через раздел Продажи.
—
## 6. Обновите конфигурацию базы данных
В конфигураторе нажмите:
|
1 |
Конфигурация → Обновить конфигурацию базы данных |
Можно использовать клавишу F7.
Затем запустите 1С в режиме предприятия:
|
1 |
Отладка → Начать отладку |
или клавишу F5.
Откройте раздел Продажи, затем справочник Товары.
Нажмите Создать. Откроется созданная управляемая форма элемента.
—
# Как устроена управляемая форма
Управляемая форма состоит из нескольких частей.
## Реквизиты формы
Реквизит формы хранит данные, с которыми работает форма.
Например:
|
1 |
Объект |
Для формы элемента это обычно объект справочника:
|
1 |
СправочникОбъект.Товары |
Для формы списка это обычно:
|
1 |
ДинамическийСписок |
## Элементы формы
Элементы отображаются пользователю:
— поле ввода;
— поле даты;
— флажок;
— таблица;
— кнопка;
— группа;
— декорация;
— поле картинки.
Например, реквизит Цена сам по себе на форме не отображается. Для него должен быть создан элемент формы, связанный с этим реквизитом.
У элемента формы свойство ПутьКДанным должно иметь значение:
|
1 |
Объект.Цена |
Для наименования:
|
1 |
Объект.Наименование |
Для артикула:
|
1 |
Объект.Артикул |
—
# Как добавить поле вручную
Допустим, поле Цена не появилось на форме.
1. Откройте форму элемента справочника.
2. В дереве элементов выберите группу, куда нужно добавить поле.
3. Нажмите Добавить.
4. Выберите тип элемента:
|
1 |
Поле формы |
5. В свойстве ПутьКДанным укажите:
|
1 |
Объект.Цена |
6. В свойстве Вид можно выбрать:
|
1 |
Поле ввода |
7. В свойстве Заголовок укажите:
|
1 |
Цена |
Аналогично можно добавить поле для артикула:
|
1 |
Объект.Артикул |
—
# Как добавить кнопку
Например, добавим кнопку, которая будет выводить сообщение.
## 1. Создайте команду
Откройте форму элемента справочника.
В правой части редактора перейдите на вкладку Команды.
Добавьте команду:
|
1 |
ПоказатьСообщение |
Укажите заголовок:
|
1 |
Показать сообщение |
После создания команды перетащите ее в дерево элементов формы, например в командную панель.
## 2. Создайте обработчик команды
У команды вызовите создание обработчика события Действие или Обработка команды.
Платформа создаст процедуру примерно такого вида:
|
1 2 3 4 5 6 |
&НаКлиенте Процедура ПоказатьСообщение(Команда) Сообщить("Открыта форма товара"); КонецПроцедуры |
В управляемом приложении код формы обычно выполняется на клиенте или сервере. Для простой команды сообщение можно вывести на клиенте.
—
# Пример проверки цены
Можно добавить проверку, чтобы цена не была отрицательной.
У поля Цена создайте обработчик события ОкончаниеВводаТекста или проверку перед записью объекта.
Для проверки перед записью формы можно использовать обработчик ПередЗаписьюНаСервере:
|
1 2 3 4 5 6 7 8 9 |
&НаСервере Процедура ПередЗаписьюНаСервере(Отказ, ТекущийОбъект, ПараметрыЗаписи) Если ТекущийОбъект.Цена < 0 Тогда Сообщить("Цена не может быть отрицательной"); Отказ = Истина; КонецЕсли; КонецПроцедуры |
В некоторых версиях платформы и типах форм имя параметров обработчика может отличаться. Лучше создавать обработчик через палитру свойств формы, тогда 1С сама подставит правильную сигнатуру.
Более простой вариант для проверки непосредственно в обработчике изменения поля:
|
1 2 3 4 5 6 7 8 9 |
&НаКлиенте Процедура ЦенаИзменение(Элемент) Если Объект.Цена < 0 Тогда Объект.Цена = 0; Сообщить("Цена не может быть отрицательной"); КонецЕсли; КонецПроцедуры |
Обработчик создается так:
1. Выберите поле Цена в дереве формы.
2. Откройте палитру свойств.
3. Найдите событие Изменение.
4. Нажмите кнопку создания обработчика.
—
# Как сделать форму документа с табличной частью
Для первого знакомства со справочником достаточно формы элемента. Но форма документа создается похожим образом.
Например, создайте документ ЗаказПокупателя.
У документа добавьте табличную часть:
|
1 |
Товары |
В табличной части создайте реквизиты:
| Имя | Тип |
|—|—|
| Номенклатура | СправочникСсылка.Товары |
| Количество | Число 10.3 |
| Цена | Число 15.2 |
| Сумма | Число 15.2 |
Затем:
1. Откройте вкладку Формы документа.
2. Создайте Основную форму документа.
3. Конструктор добавит:
— поля реквизитов документа;
— таблицу табличной части;
— команды записи и проведения.
4. В форме появится табличное поле, связанное примерно с путем:
|
1 |
Объект.Товары |
Если табличная часть не добавилась автоматически:
1. Добавьте в форму элемент Таблица формы.
2. Укажите путь к данным:
|
1 |
Объект.Товары |
3. Согласитесь на автоматическое добавление полей табличной части.
—
# Главное отличие управляемой формы от обычной
В обычной форме разработчик работает непосредственно с элементами диалога.
В управляемой форме есть разделение:
— реквизиты формы хранят данные;
— элементы формы отображают данные;
— команды формы выполняют действия;
— код выполняется на клиенте или сервере;
— доступность, видимость и заголовки элементов можно изменять программно.
Например, сделать поле цены недоступным:
|
1 2 3 4 5 6 |
&НаКлиенте Процедура ПриОткрытии(Отказ) Элементы.Цена.Доступность = Ложь; КонецПроцедуры |
Скрыть поле:
|
1 2 3 4 5 6 |
&НаКлиенте Процедура ПриОткрытии(Отказ) Элементы.Цена.Видимость = Ложь; КонецПроцедуры |
Изменить заголовок:
|
1 2 3 4 5 6 |
&НаКлиенте Процедура ПриОткрытии(Отказ) Элементы.Цена.Заголовок = "Розничная цена"; КонецПроцедуры |
В новых версиях платформы событие открытия формы чаще создается с параметром Отказ:
|
1 2 3 4 |
&НаКлиенте Процедура ПриОткрытии(Отказ) КонецПроцедуры |
—
# Минимальный порядок действий
Для первой формы достаточно выполнить следующие действия:
1. Создать справочник.
2. Добавить его реквизиты.
3. Создать основную форму элемента.
4. Создать основную форму списка.
5. Добавить справочник в подсистему.
6. Обновить конфигурацию базы данных.
7. Запустить 1С в режиме предприятия.
8. Открыть форму и создать первый элемент.
Самый важный момент: для отображения реквизита на управляемой форме должен существовать элемент формы с правильно установленным свойством ПутьКДанным, например:
|
1 |
Объект.Наименование |
или:
|
1 |
Объект.Цена |