Как создать управляемую форму в 1С?

[Odineski]

как создать свою первую управляемую форму

[Odin — Одинэсник]

## Как создать первую управляемую форму в 1С

Ниже самый простой вариант: создадим справочник Товары и его управляемую форму элемента.

### 1. Включите управляемое приложение

В конфигураторе откройте:

Конфигурация → Открыть конфигурацию

Затем выберите корень конфигурации и проверьте свойство:

Основной режим запуска → Управляемое приложение

Если планируется запускать конфигурацию только в управляемом режиме, можно включить:

— Использовать управляемые формы
— при необходимости отключить использование обычных форм

Точный набор свойств зависит от версии платформы 1С.

—

## 2. Создайте справочник

В дереве конфигурации:

1. Нажмите правой кнопкой на ветке Справочники.
2. Выберите Добавить.
3. Назовите справочник:

1С (Код)

Товары

1

Товары

4. Откройте свойства справочника.
5. Перейдите на вкладку Данные.
6. Добавьте реквизиты:

| Имя | Тип |
|—|—|
| Артикул | Строка, например 20 символов |
| Цена | Число, например 15.2 |
| Описание | Строка неограниченной длины |

В справочнике автоматически есть стандартный реквизит Наименование.

—

## 3. Создайте управляемую форму элемента

В свойствах справочника Товары перейдите на вкладку Формы.

Нажмите кнопку добавления формы или кнопку с изображением лупы.

В конструкторе выберите:

1С (Код)

Основная форма элемента

1	Основная форма элемента

Обычно 1С предложит создать форму автоматически. Согласитесь с настройками и нажмите Готово.

В редакторе формы будут созданы:

— реквизит формы Объект;
— элементы формы;
— поля для Наименование, Артикул, Цена, Описание;
— стандартные команды записи и закрытия.

Нажмите Записать и закрыть.

Управляемая форма элемента справочника создана.

—

## 4. Создайте форму списка

Теперь создадим форму, в которой будут отображаться все товары.

В свойствах справочника Товары снова откройте вкладку Формы.

Создайте:

1С (Код)

Основная форма списка

1	Основная форма списка

В большинстве случаев конструктор автоматически создаст:

— реквизит Список типа Динамический список;
— табличное поле Список;
— стандартные команды добавления, изменения и удаления элементов.

После создания откройте форму списка в редакторе.

Слева находится дерево элементов формы, справа доступны:

— реквизиты формы;
— команды;
— параметры;
— свойства выбранного элемента.

Выделите табличное поле Список и проверьте свойство:

1С (Код)

ПутьКДанным

1	ПутьКДанным

Оно должно ссылаться на реквизит формы:

1С (Код)

Список

1

Список

Если список создан конструктором, это уже будет настроено автоматически.

—

## 5. Добавьте справочник в подсистему

Чтобы форма появилась в пользовательском интерфейсе:

1. Создайте подсистему, например:

1С (Код)

Продажи

1

Продажи

2. Откройте состав подсистемы.
3. Добавьте в нее справочник Товары.
4. В свойствах подсистемы включите:

1С (Код)

Включать в командный интерфейс

1	Включать в командный интерфейс

5. Откройте командный интерфейс подсистемы.
6. Найдите команду открытия справочника Товары.
7. Убедитесь, что для нее включена видимость в панели навигации.

После этого справочник будет доступен пользователю через раздел Продажи.

—

## 6. Обновите конфигурацию базы данных

В конфигураторе нажмите:

1С (Код)

Конфигурация → Обновить конфигурацию базы данных

1	Конфигурация → Обновить конфигурацию базы данных

Можно использовать клавишу F7.

Затем запустите 1С в режиме предприятия:

1С (Код)

Отладка → Начать отладку

1	Отладка → Начать отладку

или клавишу F5.

Откройте раздел Продажи, затем справочник Товары.

Нажмите Создать. Откроется созданная управляемая форма элемента.

—

# Как устроена управляемая форма

Управляемая форма состоит из нескольких частей.

## Реквизиты формы

Реквизит формы хранит данные, с которыми работает форма.

Например:

1С (Код)

Объект

1

Объект

Для формы элемента это обычно объект справочника:

1С (Код)

СправочникОбъект.Товары

1	СправочникОбъект.Товары

Для формы списка это обычно:

1С (Код)

ДинамическийСписок

1	ДинамическийСписок

## Элементы формы

Элементы отображаются пользователю:

— поле ввода;
— поле даты;
— флажок;
— таблица;
— кнопка;
— группа;
— декорация;
— поле картинки.

Например, реквизит Цена сам по себе на форме не отображается. Для него должен быть создан элемент формы, связанный с этим реквизитом.

У элемента формы свойство ПутьКДанным должно иметь значение:

1С (Код)

Объект.Цена

1	Объект.Цена

Для наименования:

1С (Код)

Объект.Наименование

1	Объект.Наименование

Для артикула:

1С (Код)

Объект.Артикул

1	Объект.Артикул

—

# Как добавить поле вручную

Допустим, поле Цена не появилось на форме.

1. Откройте форму элемента справочника.
2. В дереве элементов выберите группу, куда нужно добавить поле.
3. Нажмите Добавить.
4. Выберите тип элемента:

1С (Код)

Поле формы

1	Поле формы

5. В свойстве ПутьКДанным укажите:

1С (Код)

Объект.Цена

1	Объект.Цена

6. В свойстве Вид можно выбрать:

1С (Код)

Поле ввода

1	Поле ввода

7. В свойстве Заголовок укажите:

1С (Код)

Цена

1

Цена

Аналогично можно добавить поле для артикула:

1С (Код)

Объект.Артикул

1	Объект.Артикул

—

# Как добавить кнопку

Например, добавим кнопку, которая будет выводить сообщение.

## 1. Создайте команду

Откройте форму элемента справочника.

В правой части редактора перейдите на вкладку Команды.

Добавьте команду:

1С (Код)

ПоказатьСообщение

1	ПоказатьСообщение

Укажите заголовок:

1С (Код)

Показать сообщение

1	Показать сообщение

После создания команды перетащите ее в дерево элементов формы, например в командную панель.

## 2. Создайте обработчик команды

У команды вызовите создание обработчика события Действие или Обработка команды.

Платформа создаст процедуру примерно такого вида:

1С (Код)

&НаКлиенте Процедура ПоказатьСообщение(Команда) Сообщить("Открыта форма товара"); КонецПроцедуры

1 2 3 4 5 6

&НаКлиенте Процедура ПоказатьСообщение(Команда) Сообщить("Открыта форма товара"); КонецПроцедуры

В управляемом приложении код формы обычно выполняется на клиенте или сервере. Для простой команды сообщение можно вывести на клиенте.

—

# Пример проверки цены

Можно добавить проверку, чтобы цена не была отрицательной.

У поля Цена создайте обработчик события ОкончаниеВводаТекста или проверку перед записью объекта.

Для проверки перед записью формы можно использовать обработчик ПередЗаписьюНаСервере:

1С (Код)

&НаСервере Процедура ПередЗаписьюНаСервере(Отказ, ТекущийОбъект, ПараметрыЗаписи) Если ТекущийОбъект.Цена < 0 Тогда Сообщить("Цена не может быть отрицательной"); Отказ = Истина; КонецЕсли; КонецПроцедуры

1 2 3 4 5 6 7 8 9

&НаСервере Процедура ПередЗаписьюНаСервере(Отказ, ТекущийОбъект, ПараметрыЗаписи) Если ТекущийОбъект.Цена < 0 Тогда Сообщить("Цена не может быть отрицательной"); Отказ = Истина; КонецЕсли; КонецПроцедуры

В некоторых версиях платформы и типах форм имя параметров обработчика может отличаться. Лучше создавать обработчик через палитру свойств формы, тогда 1С сама подставит правильную сигнатуру.

Более простой вариант для проверки непосредственно в обработчике изменения поля:

1С (Код)

&НаКлиенте Процедура ЦенаИзменение(Элемент) Если Объект.Цена < 0 Тогда Объект.Цена = 0; Сообщить("Цена не может быть отрицательной"); КонецЕсли; КонецПроцедуры

1 2 3 4 5 6 7 8 9

&НаКлиенте Процедура ЦенаИзменение(Элемент) Если Объект.Цена < 0 Тогда Объект.Цена = 0; Сообщить("Цена не может быть отрицательной"); КонецЕсли; КонецПроцедуры

Обработчик создается так:

1. Выберите поле Цена в дереве формы.
2. Откройте палитру свойств.
3. Найдите событие Изменение.
4. Нажмите кнопку создания обработчика.

—

# Как сделать форму документа с табличной частью

Для первого знакомства со справочником достаточно формы элемента. Но форма документа создается похожим образом.

Например, создайте документ ЗаказПокупателя.

У документа добавьте табличную часть:

1С (Код)

Товары

1

Товары

В табличной части создайте реквизиты:

| Имя | Тип |
|—|—|
| Номенклатура | СправочникСсылка.Товары |
| Количество | Число 10.3 |
| Цена | Число 15.2 |
| Сумма | Число 15.2 |

Затем:

1. Откройте вкладку Формы документа.
2. Создайте Основную форму документа.
3. Конструктор добавит:
— поля реквизитов документа;
— таблицу табличной части;
— команды записи и проведения.
4. В форме появится табличное поле, связанное примерно с путем:

1С (Код)

Объект.Товары

1	Объект.Товары

Если табличная часть не добавилась автоматически:

1. Добавьте в форму элемент Таблица формы.
2. Укажите путь к данным:

1С (Код)

Объект.Товары

1	Объект.Товары

3. Согласитесь на автоматическое добавление полей табличной части.

—

# Главное отличие управляемой формы от обычной

В обычной форме разработчик работает непосредственно с элементами диалога.

В управляемой форме есть разделение:

— реквизиты формы хранят данные;
— элементы формы отображают данные;
— команды формы выполняют действия;
— код выполняется на клиенте или сервере;
— доступность, видимость и заголовки элементов можно изменять программно.

Например, сделать поле цены недоступным:

1С (Код)

&НаКлиенте Процедура ПриОткрытии(Отказ) Элементы.Цена.Доступность = Ложь; КонецПроцедуры

1 2 3 4 5 6

&НаКлиенте Процедура ПриОткрытии(Отказ) Элементы.Цена.Доступность = Ложь; КонецПроцедуры

Скрыть поле:

1С (Код)

&НаКлиенте Процедура ПриОткрытии(Отказ) Элементы.Цена.Видимость = Ложь; КонецПроцедуры

1 2 3 4 5 6

&НаКлиенте Процедура ПриОткрытии(Отказ) Элементы.Цена.Видимость = Ложь; КонецПроцедуры

Изменить заголовок:

1С (Код)

&НаКлиенте Процедура ПриОткрытии(Отказ) Элементы.Цена.Заголовок = "Розничная цена"; КонецПроцедуры

1 2 3 4 5 6

&НаКлиенте Процедура ПриОткрытии(Отказ) Элементы.Цена.Заголовок = "Розничная цена"; КонецПроцедуры

В новых версиях платформы событие открытия формы чаще создается с параметром Отказ:

1С (Код)

&НаКлиенте Процедура ПриОткрытии(Отказ) КонецПроцедуры

1 2 3 4

&НаКлиенте Процедура ПриОткрытии(Отказ) КонецПроцедуры

—

# Минимальный порядок действий

Для первой формы достаточно выполнить следующие действия:

1. Создать справочник.
2. Добавить его реквизиты.
3. Создать основную форму элемента.
4. Создать основную форму списка.
5. Добавить справочник в подсистему.
6. Обновить конфигурацию базы данных.
7. Запустить 1С в режиме предприятия.
8. Открыть форму и создать первый элемент.

Самый важный момент: для отображения реквизита на управляемой форме должен существовать элемент формы с правильно установленным свойством ПутьКДанным, например:

1С (Код)

Объект.Наименование

1	Объект.Наименование

или:

1С (Код)

Объект.Цена

1	Объект.Цена

[Автор]

Записи