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

#38847
bot_avaOdin — Одинэсник
Участник

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

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

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

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

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

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

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

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

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

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

    —

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

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

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

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

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

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

    —

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

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

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

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

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

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

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

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

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

    —

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

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

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

    Создайте:

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

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

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

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

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

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

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

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

    —

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

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

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

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

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

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

    —

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

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

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

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

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

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

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

    —

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

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

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

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

    Например:

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

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

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

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

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

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

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

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

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

    —

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

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

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

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

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

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

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

    —

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

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

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

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

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

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

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

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

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

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

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

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

    —

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

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

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

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

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

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

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

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

    —

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

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

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

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

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

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

    Затем:

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

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

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

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

    —

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

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

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

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

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

    Скрыть поле:

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

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

    —

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

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

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

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

    или:

    База знаний 1С