Свойства компонента интерфейса, унаследованного от компонента «ФормаОбъекта»

Форма объекта предназначена для создания, редактирования и удаления сущности.

Иерархия наследования

Свойства

ДанныеФормы
Данные, с которыми работает форма
Обновить
Команда. Команда принудительного обновления данных в форме
Сохранить
Команда. Команда сохранения измененных данных
СохранитьИЗакрыть
Команда. Команда сохранения измененных данных и закрытия формы
Удалить
Команда. Команда удаления данных формы
ВключатьВАвтоИнтерфейс
Признак того, что включит команду открытия этой формы в автоматический интерфейс. Стандартное значение Ложь.
ГлавнаяКоманда
ОбычнаяКоманда. Задает команду, которая определяет главное действие формы. Здесь мы рекомендуем использовать команду, после вызова которой форма будет закрыта. Типичные примеры:
  • Сохранить (и закрыть)
  • Отправить (письмо)
  • Закрыть
Отображается в нижней панели команд формы. Выглядит как первичная кнопка.
ДополнительныеКоманды
Экземпляр ФрагментКомандногоИнтерфейса<ТипКоманды>, состоящий из команд. Список дополнительных команд формы. Отображаются в правой части заголовка формы (веб-интерфейс) или под заголовком формы (мобильный интерфейс).
Заголовок
Заголовок формы
ЗаголовокКомандыСоздания
Заголовок кнопки создания на форме списка. Если заголовок задан, то в веб-интерфейсе кнопка отображается в заголовке формы, а в мобильном интерфейсе отображается плавающая кнопка
Закрыть
Команда. Команда закрытия формы
Изображение
Задает картинку для автогенерируемой навигационной команды <ИмяФормы>.ОткрытьФорму.
КомандыСоздания
Экземпляр ОбычнаяКоманда либо экземпляр ГруппаКомандногоИнтерфейса<ТипКоманды>, состоящая из обычных команд. Задает команду или группу команд кнопке создания. Место и вид отображения кнопки создания может быть различным в зависимости от вида интерфейса:
  • В мобильном интерфейсе это плавающая кнопка, которая отображается в правом нижнем углу экрана;
  • В веб-интерфейсе кнопка отображается справа от заголовка формы
Пример команды создания Добавить сотрудника в веб-интерфейсе:
ОсновныеКоманды
Экземпляр ФрагментКомандногоИнтерфейса<ТипКоманды>, состоящий из команд. Список основных команд формы. Отображаются в нижней панели команд формы в виде вторичных кнопок. Основные команды отображаются после главной команды.
ПовторноеИспользованиеФормы
Признак повторного использования формы. Данное свойство так же влияет на состояние формы, при открытии ее методом встроенного языка Открыть, если при самом открытии этот флаг не сброшен Возможные значения свойства:
Использовать
Форма будет использоваться повторно. Форма, открытая в основной области, при закрытии не удаляется. При повторном открытии формы открывается тот же самый экземпляр
НеИспользовать
Форма не будет использоваться повторно
Авто
Система сама определяет, может ли форма использоваться повторно. Формы списков будут по-возможности переиспользоваться, остальные формы — нет. Установлено по умолчанию.
ПодсказкиПриПервомОткрытии

ПоследовательностьОбучающихПодсказок. Последовательность подсказок, которая запускается автоматически при первом открытии формы. Если данная последовательность уже была просмотрена пользователем до конца, то больше она запускаться не будет.

Состоит из элементов типа ОбучающаяПодсказка. Обучающая подсказка обладает следующими свойствами:
  • Заголовок — заголовок подсказки
  • Описание — текст внутри подсказки
  • ОпорныйЭлемент — компонент, около которого появляется подсказка.
  • Изображение — изображение внутри подсказки

Пример:
ВидЭлемента: КомпонентИнтерфейса
Ид: 63ddc157-05cd-4187-8d86-546634e011d6
Имя: СделкиФормаОбъекта
ОбластьВидимости: ВПроекте
Наследует:
   Тип: ФормаОбъекта
   Заголовок: =ПолучитьЗаголовокФормы()
   Содержимое:
        Тип: РазделяющаяГруппа
        Содержимое:
            -
                Заголовок: $ЛокализованныеСтроки.Основное
                ОтступПоГоризонтали: Одинарный
                Содержимое:
                    -
                        Тип: КомпонентСЗаголовком
                        Имя: ПолеВводаКлиент
                        Заголовок: $ЛокализованныеСтроки.Клиент
                    -
                        Тип: ПолеВвода<Направления.Ссылка?>
                        Имя: ПолеВводаНаправление
                        Заголовок: $ЛокализованныеСтроки.Направление
                        Значение: =ДанныеФормы.Данные["Направление"]
                        ПризнакОбязательности: Истина 
   ПодсказкиПриПервомОткрытии:
      Тип: ПоследовательностьОбучающихПодсказок
      Элементы:
          -
               Заголовок: Приветствую! 🤝
               Изображение: ОбучающиеПодсказки/Приветствие.png
               Описание: "Позвольте помочь вам создать новую сделку! Сделка отражает процесс 
                          оказания услуги клиенту нашей компании на каждой стадии этого процесса. 
                          Для начала нужно выбрать клиента."
               ОпорныйЭлемент: =Компоненты.ПолеВводаКлиент
          -
              Заголовок: Выбор направления
              Описание: "Сделка может относиться к одному из нескольких направлений, по которым 
                         наша компания предоставляет услуги."
              ОпорныйЭлемент: =Компоненты.ПолеВводаНаправление
По умолчанию последовательность обучающих подсказок запускается при открытии формы и переключается по кнопке Далее. Однако вы также можете управлять их поведением через специальные методы формы: ЗапуститьОбучающиеПодсказки, ОстановитьОбучающиеПодсказки, ПоказатьСледующуюОбучающуюПодсказку. Для этого необходимо описать последовательность обучающих подсказок и вызвать соответствующий метод в модуле формы.
Пример открытия последовательности обучающих подсказок при нажатии на кнопку:
ВидЭлемента: КомпонентИнтерфейса
Ид: 6e1a945d-f5c0-4a54-b4e0-0bd7ef2f3eb0
Имя: ТестПереключенияПодсказок
ОбластьВидимости: ВПодсистеме
Наследует:
    Тип: Форма
    ПослеСоздания: СоздатьИнтерфейсПереключения
    Заголовок: Тест возможных кейсов при переключении подсказок
    Содержимое:
        Тип: ОбычнаяГруппа
        ВыравниваниеСодержимогоПоВертикали: Центр
        Рамка: Истина
        Содержимое:
            -
                # Описание кнопки, при нажатии на которую будет запускаться 
                # последовательность обучающих подсказок.
                Тип: Кнопка
                Имя: КнопкаЗапускающаяТуториал
                Заголовок: Запустить туториал на дальнюю страницу
                Вид: Основная
                РастягиватьПоГоризонтали: Растягивать
                ПриНажатии: СгенерироватьТуториал
// Обработчик кнопки «ПриНажатии». Внутри обработчика осуществляется
// создание и запуск последовательности обучающих подсказок.
метод СгенерироватьТуториал(Источник: Кнопка, Событие: СобытиеПриНажатии)
    пер Последовательность = новый ПоследовательностьОбучающихПодсказок([
        новый ОбучающаяПодсказка(
            ОпорныйЭлемент = Компоненты.ПропадающаяГруппа,
            Заголовок = "Приветствую! 🤝", 
            Описание = 
                       "Позвольте помочь вам создать новую сделку! Сделка отражает процесс 
                        оказания услуги клиенту нашей компании на каждой стадии этого процесса. 
                        Для начала нужно выбрать клиента."
        )
        ])
        
    этот.ЗапуститьОбучающиеПодсказки(Последовательность)
;
ОтступПоВертикали
Вертикальный отступ от границы компонента до его содержимого: .
ОтступПоГоризонтали
Горизонтальный отступ от границы компонента до его содержимого: .
Содержимое
Экземпляр компонента, расположенный в данном компоненте. Содержит следующие свойства:
Тип
Обязательное. Имя компонента, экземпляр которого вы описываете. Это может быть системный компонент или компонент интерфейса. Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса
Ид: 9f51db7f-c98d-499c-9607-545d5e0a58c2
Имя: МояФормаОбъекта
Наследует:
    Тип: ФормаОбъекта
    ВключатьВАвтоИнтерфейс: Ложь
    Содержимое:
        Тип: ОбычнаяГруппа
        Содержимое:
            -
                Тип: Флажок
                Имя: ЗагружатьВсе
                Заголовок: Загружать все данные
                Значение:
                    Тип: Булево
                    Значение: Истина
            -
                Тип: Флажок
                Имя: ПерезаписыватьСтарые
                Заголовок: Перезаписывать старые элементы
Имя
Имя экземпляра компонента. По этому имени можно будет обратиться к экземпляру. Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса
Ид: 9f51db7f-c98d-499c-9607-545d5e0a58c2
Имя: МояФормаОбъекта
Наследует:
    Тип: ФормаОбъекта
    ВключатьВАвтоИнтерфейс: Ложь
    Содержимое:
        Тип: ОбычнаяГруппа
        Имя: Флажки
        Содержимое:
            -
                Тип: Флажок
                Имя: ЗагружатьВсе
                Заголовок: Загружать все данные
                Значение:
                    Тип: Булево
                    Значение: Истина
            -
                Тип: Флажок
                Имя: ПерезаписыватьСтарые
                Заголовок: Перезаписывать старые элементы
Например, к его свойству Видимость: 
ВидЭлемента: КомпонентИнтерфейса
Ид: 9f51db7f-c98d-499c-9607-545d5e0a58c2
Имя: МояФормаОбъекта
Наследует:
    Тип: ФормаОбъекта
    ВключатьВАвтоИнтерфейс: Ложь
    Видимость: =Компоненты.Флажки.Видимость
    Содержимое:
        Тип: ОбычнаяГруппа
        Имя: Флажки
        Содержимое:
            -
                Тип: Флажок
                Имя: ЗагружатьВсе
                Заголовок: Загружать все данные
                Значение:
                    Тип: Булево
                    Значение: Истина
            -
                Тип: Флажок
                Имя: ПерезаписыватьСтарые
                Заголовок: Перезаписывать старые элементы
ОтслеживатьИзменениеДанных
Не обязательное. По умолчанию Ложь.
Если Истина, то будет учитывать изменение данных в этом экземпляре при вычислении свойства РассчитаннаяМодифицированность у экземпляра этого компонента интерфейса. Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса
Ид: 9f51db7f-c98d-499c-9607-545d5e0a58c2
Имя: МояФормаОбъекта
Наследует:
    Тип: ФормаОбъекта
    ВключатьВАвтоИнтерфейс: Ложь
    Содержимое:
        Тип: ОбычнаяГруппа
        ОтслеживатьИзменениеДанных: Истина
        Содержимое:
            -
                Тип: Флажок
                Имя: ЗагружатьВсе
                Заголовок: Загружать все данные
                Значение:
                    Тип: Булево
                    Значение: Истина
            -
                Тип: Флажок
                Имя: ПерезаписыватьСтарые
                Заголовок: Перезаписывать старые элементы
<Свойство компонента>
Значение свойства компонента в этом экземпляре. Если тип свойства составной (включает несколько типов), необходимо указать тип значения. Иначе просто само значение. Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса
Ид: 9f51db7f-c98d-499c-9607-545d5e0a58c2
Имя: МояФормаОбъекта
Наследует:
    Тип: ФормаОбъекта
    ВключатьВАвтоИнтерфейс: Ложь
    Содержимое:
        Тип: ОбычнаяГруппа
        Ориентация: Горизонтальная        
        Содержимое:
            -
                Тип: Флажок
                Имя: ЗагружатьВсе
                Заголовок: Загружать все данные
                Значение:
                    Тип: Булево
                    Значение: Истина
            -
                Тип: Флажок
                Имя: ПерезаписыватьСтарые
                Заголовок: Перезаписывать старые элементы
<Событие компонента>
Имя метода, обрабатывающего событие компонента в этом экземпляре. Метод должен находиться в модуле компонента. Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса
Ид: 9f51db7f-c98d-499c-9607-545d5e0a58c2
Имя: МояФормаОбъекта
Наследует:
    Тип: ФормаОбъекта
    ВключатьВАвтоИнтерфейс: Ложь
    Содержимое:
        Тип: ОбычнаяГруппа    
        ПослеСоздания: ОбработчикПослеСозданияГруппы
        Содержимое:
            -
                Тип: Флажок
                Имя: ЗагружатьВсе
                Заголовок: Загружать все данные
                Значение:
                    Тип: Булево
                    Значение: Истина
            -
                Тип: Флажок
                Имя: ПерезаписыватьСтарые
                Заголовок: Перезаписывать старые элементы

События

ПослеЧтения
Возникает после чтения данных формы. В том числе для формы нового объекта и после записи данных формы, так как в процессе записи данные могли измениться на сервере
Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 45f04be2-407c-4bd7-a780-3d322cfc720a
Имя: МояФормаОбъекта
Наследует:
    Тип: ФормаОбъекта
    ПослеЧтения: ОбработчикПослеЧтения
Сигнатура обработчика события на встроенном языке:
метод ОбработчикПослеЧтения()
;
ПередЗаписьюОбъекта

Вызывается на клиенте во время процесса записи объекта, перед отправкой на сервер запроса на запись. В качестве аргумента передается объект типа <ИмяОбъекта>.ПараметрыЗаписи. Состав параметров записи описывается в секции ПараметрыЗаписи описания элемента. Значения свойств этого объекта, заданные в данном обработчике, доступны в последующих обработчиках записи.

Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 45f04be2-407c-4bd7-a780-3d322cfc720a
Имя: МояФормаОбъекта
Наследует:
    Тип: ФормаОбъекта
    ПередЗаписьюОбъекта: ОбработчикПередЗаписьюОбъекта
Сигнатура обработчика события на встроенном языке:
метод ОбработчикПередЗаписьюОбъекта(ПараметрыЗаписиОбъекта: <ИмяОбъекта>.ПараметрыЗаписи)
;
ПослеЗаписиОбъекта

Вызывается на клиенте во время процесса записи объекта, после получения ответа сервера на запрос на запись. В качестве аргумента передается объект типа <ИмяОбъекта>.ПараметрыЗаписи. Состав параметров записи описывается в секции ПараметрыЗаписи описания объекта.

Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 45f04be2-407c-4bd7-a780-3d322cfc720a
Имя: МояФормаОбъекта
Наследует:
    Тип: ФормаОбъекта
    ПослеЗаписиОбъекта: ОбработчикПослеЗаписиОбъекта
Сигнатура обработчика события на встроенном языке:
метод ОбработчикПослеЗаписиОбъекта(ПараметрыЗаписиОбъекта: <ИмяОбъекта>.ПараметрыЗаписи)
;
ПередУдалениемОбъекта
Примечание: Не вызывается для формы записи регистра сведений.

Вызывается на клиенте во время процесса удаления объекта, перед отправкой на сервер запроса на удаление. В качестве аргумента передается объект типа <ИмяОбъекта>.ПараметрыУдаления. Состав параметров удаления описывается в секции ПараметрыУдаления описания объекта. Значения свойств этого объекта, заданные в данном обработчике, доступны в последующих обработчиках удаления.

Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 45f04be2-407c-4bd7-a780-3d322cfc720a
Имя: МояФормаОбъекта
Наследует:
    Тип: ФормаОбъекта
    ПередУдалениемОбъекта: ОбработчикПередУдалениемОбъекта
Сигнатура обработчика события на встроенном языке:
метод ОбработчикПередУдалениемОбъекта(ПараметрыУдаленияОбъекта: <ИмяОбъекта>.ПараметрыУдаления)
;
ПослеУдаленияОбъекта
Примечание: Не вызывается для формы записи регистра сведений.

Вызывается на клиенте во время процесса удаления объекта, после получения ответа сервера на запрос на удаление. В качестве аргумента передается объект типа <ИмяОбъекта>.ПараметрыУдаления. Состав параметров удаления описывается в секции ПараметрыУдаления описания объекта.

Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 45f04be2-407c-4bd7-a780-3d322cfc720a
Имя: МояФормаОбъекта
Наследует:
    Тип: ФормаОбъекта
    ПослеУдаленияОбъекта: ОбработчикПослеУдаленияОбъекта
Сигнатура обработчика события на встроенном языке:
метод ОбработчикПослеУдаленияОбъекта(ПараметрыУдаленияОбъекта: <ИмяОбъекта>.ПараметрыУдаления)
;
ПриОбновлении

Возникает при запуске пользователем обновления данных формы через команду Обновить или с помощью жеста pull-to-refresh в мобильном приложении