Чтение форм 1С

Поверхность системы

Книга о том, как читать управляемую форму 1С: видеть, о чём программа разговаривает с пользователем, откуда на форме берётся каждое поле и что делает каждая кнопка, — и собирать свои формы, не написав ни строки кода.

Для кого

Для новичка без опыта программирования. Знакомство с деревом метаданных желательно, но не обязательно: вводная глава даёт минимальный обзор для тех, кто пришёл сразу сюда.

Место в серии

Третья книга линии «Чтение 1С»:

Книги автономны и связаны сквозным примером — фирмой «Канцтовары».

Что понадобится

• Платформа 1С:Предприятие 8.3; книга сверяется на 8.3.27.
• База «Канцтовары»: та, что собрана по «Дереву метаданных», или готовая из поставки книги (поставка готовится).

Как устроена книга

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

Каждый параграф заканчивается «Главным в одном абзаце», вопросами и упражнениями; ответы собраны в конце главы. Упражнения идут в Конфигураторе, в режиме Предприятия и на бумаге. Со второй главы каждую главу замыкает «Чужая форма»: одна и та же серия заранее собранных форм, которую каждая следующая глава разбирает глубже.

Состояние

Черновик: написаны два первых параграфа. Полный план — docs/00_plan_knigi.md.

Сборка

Ночная сборка выкладывает книгу в разделе Releases: EPUB, FB2, PDF, HTML, DOCX.

Лицензия

CC BY 4.0.

§ 0.1. Платформа в двух режимах: Конфигуратор и Предприятие

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

И сразу обнаруживается подробность, о которую спотыкается почти каждый новичок. Платформа устанавливается на компьютер как одна программа, а запускается двумя разными способами — в двух режимах. С них и начнём: чем они отличаются и зачем их два.

1. Платформа и прикладная программа

Говоря «1С», обычно имеют в виду готовую программу, в которой работает бухгалтер или кладовщик. Это правда, но не вся. То, что видно на экране, — не сама платформа, а прикладная программа, написанная для неё. Прикладные программы бывают типовые, выпущенные фирмой «1С» для множества предприятий, и самописные, собранные под одну фирму и её способ работать.

Платформа — исполнитель: она умеет хранить данные, строить окна, считать итоги, но что именно хранить, показывать и считать, задаёт прикладная программа. Устройство прикладной программы — какие в ней списки, документы, отчёты, формы и код — в 1С называют конфигурацией. Слово здесь стоит мимоходом: пока достаточно понимать его так — устройство программы, а подробнее о нём — в конце этой главы.

Платформа — исполнитель, прикладная программа — то, что она исполняет. Устройство программы называется конфигурацией.

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

Запустить исполнителя можно двумя способами. В одном видно устройство программы, в другом — её работа. Первый режим называется Конфигуратор, второй — 1С:Предприятие, или просто Предприятие.

2. Конфигуратор: где программа устраивается

В Конфигураторе прикладную программу создают и меняют. Здесь работает разработчик: заводит объекты, собирает формы, пишет код, настраивает права.

Открыв Конфигуратор, разработчик видит дерево конфигурации — перечень всего, из чего программа состоит, разложенный по веткам. Вот его верхушка для «Канцтоваров»:

Конфигурация «Канцтовары»
├── Общие
│   ├── Подсистемы
│   ├── Общие формы
│   └── …
├── Константы
├── Справочники
│   ├── ЕдиницыИзмерения
│   ├── Товары
│   ├── Контрагенты
│   └── Склады
├── Документы
│   ├── ПоступлениеТоваров
│   ├── РеализацияТоваров
│   └── ПриказОбИзмененииЦен
├── Отчёты
├── Регистры сведений
└── Регистры накопления

Обратите внимание, каких веток здесь нет: отдельных «Форм» и «Регистров». Дерево разложено по видам объектов — справочники один вид, документы другой, — а форма не отдельный вид, а часть объекта. Поэтому свои формы живут внутри своего справочника или документа, а в ветке «Общие» лежат только формы, общие для всей программы. У регистров свои ветки, по одной на вид.

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

Конфигуратор — режим, в котором программа устраивается.

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

3. Предприятие: где в программе работают

В Предприятии с программой работают её пользователи: бухгалтер заводит документы, кладовщик принимает товар, менеджер смотрит, что осталось на складе. Дерева конфигурации никто из них не видит. Они видят разделы, списки, карточки документов и отчёты с готовыми числами.

Предприятие — режим, в котором в программе работают.

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

Два режима удобно поставить рядом:

4. Одна база — две двери

Конфигуратор и Предприятие — не два приложения, живущих каждое своей жизнью. Оба подключаются к одной и той же информационной базе. В ней хранится и устройство программы, и её данные: товары, документы, остатки на складе.

     ┌───────────────────────────┐
     │    Информационная база    │
     │   конфигурация + данные   │
     └───────────────────────────┘
          ▲                  ▲
  ┌───────┴──────┐   ┌───────┴──────┐
  │ Конфигуратор │   │ Предприятие  │
  │  устройство  │   │    работа    │
  └──────────────┘   └──────────────┘
    разработчик        пользователь

Стрелки показывают: оба режима смотрят в одну базу. Из Конфигуратора видно её устройство, из Предприятия — её работу. Отдельного мира, где разработчик трудится понарошку, нет: то, что он сделал, происходит с той самой базой, к которой он подключился. Потому на работе конфигурацию обычно правят в копии базы, а рабочую, где идёт учёт, обновляют отдельно и обдуманно.

Конфигуратор и Предприятие подключаются к одной информационной базе. Это два взгляда на одно и то же.

5. Как изменение доходит до пользователя

Раз база одна, изменение, сделанное в Конфигураторе, до пользователя дойдёт. Но не мгновенно и не само: пока разработчик правит конфигурацию, пользователи работают с прежней. Нужны два действия — обновить конфигурацию базы данных и перезапустить сеанс пользователя. По шагам это выглядит так.

Второй шаг — отдельная команда Конфигуратора, «Обновить конфигурацию базы данных»: до неё изменения лежат в Конфигураторе и в работу не пошли. Третий — источник частого недоумения: разработчик уверен, что всё сделал, а пользователь поля не видит, потому что его программа запущена раньше, чем изменение вступило в силу.

Подробной механики обновления книга не разбирает, но из таблицы стоит унести главное: изменение делают, применяют к базе — и только потом его видит пользователь.

6. Смотреть снаружи

В книге мы много времени проведём в Конфигураторе — там, где формы устраиваются. Но почти каждый параграф будет заканчиваться открытием Предприятия и проверкой: как сделанное выглядит для человека, ради которого оно делается.

Правило не случайное. В редакторе всё кажется понятным, потому что мы сами это собирали и помним, что куда положили. Пользователь этого не помнит, он видит только то, что ему показали, — и его «понятно» или «непонятно» решает, годится ли форма.

Форму оценивают так, как её увидит пользователь, а не так, как она выглядит в редакторе.

Проверим это сразу: запустим «Канцтовары» и посмотрим, что видит пользователь, когда открывает программу.

7. В режиме Предприятия

Запустим «Канцтовары» в режиме Предприятия. Если вы собирали конфигурацию по «Дереву метаданных», база у вас уже есть. Если нет — возьмите готовую из поставки книги и распакуйте в любую папку.

Окно запуска выглядит примерно так:

┌─ Запуск 1С:Предприятия ───────────────┐
│ Информационные базы:                  │
│ ┌──────────────────┐ [1С:Предприятие] │
│ │ Канцтовары       │ [Конфигуратор  ] │
│ │ …                │ [Добавить…     ] │
│ └──────────────────┘ [Изменить…     ] │
└───────────────────────────────────────┘

1. Запустите ярлык «1С:Предприятие». Откроется окно запуска со списком информационных баз.

2. Если «Канцтоваров» в списке нет, нажмите «Добавить…», выберите добавление в список существующей базы, задайте имя «Канцтовары» и укажите папку, куда распакована база.

3. Выделите «Канцтовары» в списке. Справа — кнопки режимов: «1С:Предприятие» и «Конфигуратор».

4. Нажмите «1С:Предприятие».

В базе из поставки пользователи не заведены, а при пустом списке пользователей платформа имени и пароля не спрашивает: программа откроется сразу.

Откроется программа «Канцтовары». Разбирать экран будем дальше, а сейчас окиньте его взглядом. Окно прикладной программы 1С обычно делится на несколько областей:

┌────────────────────────────────────────┐
│ заголовок, главное меню, поиск         │
├────────────┬───────────────────────────┤
│ разделы    │ рабочая область:          │
│ программы  │ начальная страница,       │
│            │ открытые формы            │
└────────────┴───────────────────────────┘

В «Канцтоварах» левая область почти пуста: разделов пока не задано — их задаёт разработчик, и мы займёмся этим ближе к концу книги. Поэтому платформа собирает всё, что в программе есть, — списки товаров, контрагентов, складов, документы, отчёт — в один общий перечень. Если его на экране не видно, откройте главное меню: в нём есть пункт «Все функции», где перечислено всё. В типовой программе разделов десяток — «Закупки», «Продажи», «Склад», — и каждый собирает свою часть этого перечня.

Окно Предприятия оставьте открытым: оно понадобится в следующем параграфе.

Главное в одном абзаце

Платформа 1С устанавливается как одна программа, а запускается в двух режимах. В Конфигураторе прикладную программу устраивают: разработчик видит дерево конфигурации — справочники, документы, отчёты, формы, код. В Предприятии в программе работают: пользователь видит разделы, списки, документы и отчёты, а устройство от него скрыто. Оба режима подключаются к одной информационной базе, где лежат и конфигурация, и данные, поэтому сделанное в Конфигураторе доходит до пользователя по-настоящему — после того как разработчик обновит конфигурацию базы данных, а пользователь перезапустит программу. Собирать формы мы будем в Конфигураторе, а проверять — в Предприятии, потому что там форма встречается с тем, ради кого сделана.

Окно Предприятия открыто: в нём списки, какие-то окна и кнопки. Всё это вместе называют интерфейсом пользователя. Но что именно в него входит — и что остаётся за ним, невидимым для пользователя?

Контрольные вопросы

1. Какие два режима запуска есть у платформы 1С?
2. В каком режиме работает разработчик, а в каком — бухгалтер или кладовщик?
3. Что общего у Конфигуратора и Предприятия?
4. Чем то, что видно в Конфигураторе, отличается от того, что видно в Предприятии?
5. Разработчик добавил поле на форму товара. Что должно произойти, прежде чем пользователь это поле увидит?
6. Почему результат настройки формы проверяют в Предприятии, а не в редакторе?

Упражнения

Первый взгляд. Запустите «Канцтовары» в режиме Предприятия и перечислите своими словами три-четыре вещи, которые видите на экране. Правильные термины не нужны — описывайте, как видите.

Вторая дверь. Закройте Предприятие и откройте ту же базу в Конфигураторе. Назовите три заметных отличия от того, что вы видели в Предприятии.

Схема по памяти. Нарисуйте схему «одна база — два режима», не заглядывая в параграф. Подпишите, кто пользуется каждым режимом и что он там видит.

Ловушка: поле, которого нет. Разработчик пишет: «Добавил на форму товара новое поле, проверяйте». Кладовщик отвечает: «Открыл товар — никакого нового поля». Разработчик уверен, что всё сделал, кладовщик — что его разыгрывают. Назовите две причины, по которым поля может быть не видно, хотя разработчик действительно его добавил.

По одной фразе. Определите режим по реплике. Бухгалтер: «Открыла программу, слева разделы: Закупки, Продажи, Зарплата». Стажёру велели: «Открой ветку „Документы" и найди там ПоступлениеТоваров». По какому признаку вы узнали режим в каждом случае?

Ответы — в конце части.

§ 0.2. Что такое интерфейс пользователя: всё, что видно и трогается

Слово «интерфейс» слышал каждый, кто хоть раз ругал неудобную программу. Употребляют его широко и не всегда точно: то про одну кнопку, то про всю программу разом. Раз это главный предмет книги, договоримся о нём твёрдо: что мы будем называть интерфейсом, где у него границы и почему смотреть мы будем именно сюда.

1. Интерфейс — место встречи

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

Общее у всех трёх одно: это место встречи человека и системы. Через него человек сообщает, чего хочет, а система отвечает — цифрами, светом, звуком, движением. Обходного пути у пользователя обычно нет: он не лезет под капот и не разбирает банкомат, он работает с тем, что ему выставили наружу.

Интерфейс — это всё, через что человек общается с системой.

Строже: интерфейс — граница системы, через которую она принимает действия человека и показывает ему результат. Формулировка широкая, но точная: она годится и для микроволновки, и для прикладной программы 1С.

2. Что входит в интерфейс программы

У программы интерфейс — всё, что показано на экране, и всё, через что программой управляют. Для «Канцтоваров» это выглядит так.

Перечень не полный, но масштаб по нему виден: интерфейс — не одна кнопка и не одно окно, а вся видимая и доступная для действия поверхность программы.

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

«Видно и трогается» — короткая память об этом. Строго говоря, часть интерфейса не видна: горячие клавиши, звуковой сигнал, подсказка, которую читает вслух программа для незрячих. Поэтому точнее говорить о поверхности, доступной для восприятия и действия.

Окна, элементы и команды — как раз те части, на которые мы потом будем разбирать каждое такое окно, так что строгая формулировка ещё поработает. А на первое время хватит короткой: интерфейс — всё, что видно и трогается.

3. Интерфейс — поверхность

У интерфейса есть глубина, в которой его самого нет. Под окнами «Канцтоваров» лежат данные — товары, документы, остатки, — правила, по которым программа считает и проверяет, код, написанный разработчиком, и устройство объектов, описанное в дереве конфигурации. Пользователь всего этого прямо не видит; видит он то, во что оно превращается на поверхности.

  пользователь
      │ видит и трогает
      ▼
  ┌──────────────────────────┐
  │ интерфейс: формы,        │ ← эта книга
  │ кнопки, разделы, отчёты  │
  └──────────────────────────┘
      │ опирается на
      ▼
  ┌──────────────────────────┐
  │ данные и логика: база,   │ ← другие книги
  │ код, дерево конфигурации │   серии
  └──────────────────────────┘

Проверить себя удобно на трёх вещах с экрана «Канцтоваров»:

Интерфейс — поверхность системы. Под ним всегда есть данные и логика.

Эта книга — о поверхности. Не потому, что глубина не важна: глубиной заняты другие книги серии, о коде и о дереве объектов. Задача этой — научиться читать поверхность так, чтобы за каждым полем и каждой кнопкой видеть, откуда они взялись.

4. В режиме Предприятия: разные лица одной программы

«Канцтовары» — не одно окно с одним набором кнопок, а много окон, и устроены они по-разному. Чтобы это увидеть, откроем четыре окна и сравним.

1. Найдите в общем перечне команд список товаров и откройте его. Это таблица: строки — товары, колонки — несколько коротких сведений о каждом.

2. Дважды щёлкните по строке «Ручка шариковая». Откроется карточка одного товара — уже не таблица, а несколько отдельных полей.

┌─ Ручка шариковая (Товары) ─────────────┐
│ [Записать и закрыть] [Записать]    Ещё │
│                                        │
│ Код:               [000000006   ]      │
│ Наименование:      [Ручка шариковая]   │
│ Родитель:          [Письменные…][…]    │
│ Артикул:           [РУЧ-01      ]      │
│ Единица измерения: [шт          ][…]   │
└────────────────────────────────────────┘

Поле «Родитель» показывает группу, в которой лежит товар: справочник «Товары» иерархический, и ручка лежит в группе «Письменные принадлежности».

3. Откройте список документов «Поступление товаров», а в нём — поступление № 12 от 15 марта. Сверху — отдельные поля: номер, дата, поставщик, склад; ниже — таблица товаров с количеством и ценой.

┌─ Поступление товаров 0000000012 ──────┐
│ [Провести и закрыть] [Записать]  Ещё  │
│                                       │
│ Номер: [0000000012]  от: [15.03.2026] │
│ Контрагент: [Канцелярия Плюс  ][…]    │
│ Склад:      [Основной         ][…]    │
│                                       │
│ ┌─────────────────┬──────┬──────┐     │
│ │ Товар           │ Кол. │ Цена │     │
│ ├─────────────────┼──────┼──────┤     │
│ │ Бумага А4       │  500 │  250 │     │
│ │ Ручка шариковая │  400 │   20 │     │
│ │ Папка-регистра… │  150 │   90 │     │
│ └─────────────────┴──────┴──────┘     │
└───────────────────────────────────────┘

4. Откройте отчёт об остатках товаров на складе и нажмите «Сформировать». Сверху — настройки, снизу появится результат.

Теперь сравним четыре окна.

Первые два окна принадлежат одному справочнику «Товары» — и всё же это разные окна: список показывает много товаров сразу, карточка — один целиком. Окна различаются не прихотью того, кто их делал, а тем, что отвечают на разные вопросы: в «Канцтоварах» их вообще никто не рисовал вручную, и всё же платформа построила список и карточку по-разному.

Разные окна программы устроены по-разному, потому что отвечают на разные вопросы. Даже у одного справочника окон несколько.

Каждое такое окно — список, карточка, отчёт — называется формой. Это главное слово книги, и следующий параграф займётся им всерьёз.

Главное в одном абзаце

Интерфейс пользователя — всё, через что человек общается с системой: у автомобиля это руль и приборы, у программы — разделы, списки, карточки, поля, кнопки, сообщения. В прикладной программе 1С интерфейс виден в режиме Предприятия и складывается из множества окон, устроенных по-разному: список товаров — таблица, карточка товара — отдельные поля, карточка поступления — поля и таблица, отчёт — настройки и результат. Устроены они по-разному потому, что отвечают на разные вопросы, и даже у одного справочника окон несколько. Под интерфейсом всегда лежат данные и логика — база, правила, код, дерево конфигурации, — а сам интерфейс есть поверхность, через которую к ним подходят. Эта книга — о поверхности, и каждое отдельное окно на ней называется формой.

Окон много, и все они разные. Но что делает окно формой — и о чём, собственно, каждая форма говорит с пользователем?

Контрольные вопросы

1. Что такое интерфейс в широком смысле? Приведите пример не из мира программ.
2. Назовите не меньше пяти частей, из которых складывается интерфейс программы 1С.
3. В каком режиме платформы виден интерфейс прикладной программы?
4. Список товаров и карточка товара принадлежат одному справочнику. Почему окна всё же разные?
5. Что лежит «под» интерфейсом?
6. Что шире — интерфейс или форма? Почему?

Упражнения

Четыре окна. Откройте в Предприятии список товаров, карточку товара, карточку поступления и отчёт об остатках. Для каждого окна двумя-тремя предложениями опишите, как оно устроено и на какой вопрос отвечает.

Своё устройство. Выберите бытовое устройство, которого не было в параграфе, — лифт, стиральную машину, кофейный автомат. Составьте для него такую же таблицу: чем человек сообщает, чем устройство отвечает, что скрыто под поверхностью.

Ловушка: «программа меня не понимает». Пользователь жалуется: «Нажимаю кнопку — ничего не происходит». Где может быть причина — на поверхности, под ней или в обоих местах? Приведите по примеру для каждого случая.

Где это живёт. Программист говорит: «Здесь мы переводим число в строку и приписываем знак рубля». О поверхности он говорит или о том, что под ней? А если бы он сказал: «Сумму на форме покажем с двумя знаками после запятой»?

Окно не из четырёх. Найдите в «Канцтоварах» окно, которое не похоже ни на список, ни на карточку, ни на отчёт. Опишите его и предположите, для чего оно нужно. Ищите там, где программа что-то у вас спрашивает: например, при выборе значения в поле кнопкой «…».

Ответы — в конце части.

§ 0.3. Форма как единица интерфейса: разговор о чём-то одном

Одно имя досталось сразу четырём непохожим окнам: таблице товаров, карточке ручки, карточке поступления с таблицей внизу, окну отчёта с настройками. Все они — формы. Общее имя для таких разных вещей выглядит натяжкой, пока не увидишь, что у них и правда общего. Что же делает окно формой?

Ответ, на котором держится вся книга, простой: почти каждое такое окно говорит с пользователем о чём-то одном. «Почти» — не оговорка для порядка: у этого правила есть граница, и в конце параграфа мы до неё дойдём.

1. Одно окно — один предмет

Вернёмся к четырём окнам и спросим о каждом не «как оно устроено», а «о чём оно».

Предметы разные: товар, документ, справочник, вопрос. Но у каждого окна он один. Карточка ручки не рассказывает заодно о бумаге, карточка поступления № 12 — о поступлении № 13, а список товаров не превращается по ходу дела в список контрагентов. Всё, что есть в окне, — поля, таблицы, кнопки — служит одному предмету.

Это удобно представить как разговор. Программа обращается к пользователю репликой: «вот товар — ручка шариковая, вот её артикул, вот единица; хотите — поправьте и запишите». Реплика может быть длинной, но она об одном.

Форма — это разговор системы с пользователем по поводу одного объекта.

Слово «объект» здесь стоит в широком смысле: это то, на чём сосредоточен разговор, — один товар, один документ, справочник как целое или вопрос, на который отвечает отчёт. Одно — не значит «одна запись»: список говорит о многих товарах, но об одном справочнике.

2. Строже: форма в дереве конфигурации

Образ разговора помогает удержать главное, но в Конфигураторе нет ветки «Разговоры». Что там есть на самом деле, удобно записать тремя строками:

образ    форма — реплика системы
         об одном предмете
строго   объект конфигурации, который
         описывает одно окно
где      ветка «Формы» внутри объекта
         или «Общие формы» в «Общих»

Строго говоря, форма — объект конфигурации, который описывает одно окно прикладной программы: из каких частей оно состоит, что показывает и что позволяет сделать. Такую форму задаёт разработчик, и живёт она рядом со своим предметом. Формы товара — внутри справочника «Товары», в его собственной ветке:

Справочники
└── Товары
    ├── Реквизиты
    │   ├── Артикул
    │   └── ЕдиницаИзмерения
    ├── Табличные части
    ├── Формы         ← формы товара
    ├── Команды
    └── Макеты

Если форму решили сделать общей для многих объектов, она лежит в ветке «Общие», среди общих форм. Правило выходит простым: где предмет разговора, там и заданные для него формы.

Здесь вас ждёт первая странность. Раскройте в «Канцтоварах» ветку «Формы» у товаров — она пуста. А карточка ручки в Предприятии открывалась, и список товаров тоже. Окно есть, а формы в дереве нет: окно может обойтись без заданной формы. Кто в таком случае его строит — вопрос следующей главы; пока просто отметьте, что так бывает и что правило выше говорит только о заданных формах.

3. Пять слов разговора

У разговора есть части, и у каждой в 1С своё настоящее имя. Сейчас мы их только назовём: каждое слово раскроется в своей главе, и запоминать всё разом не нужно.

Оговорка про предмет: у карточки он лежит в одном месте — в основном реквизите формы. У списка и отчёта роль предмета играют свои данные, и о них книга скажет в своё время.

Одно предупреждение сразу. «Реквизит формы» — не то же, что реквизит товара из дерева конфигурации, хотя слово одно. Реквизит товара — его свойство, которое хранится в базе; реквизит формы — данные, которые форма объявляет у себя и с которыми работает, пока открыта. Различать их учит глава о данных формы, а до неё слово «реквизит» без уточнения будет значить реквизит объекта.

Приложим пять слов к знакомой форме — карточке поступления № 12:

Заметьте, что предмет на экране не виден сам по себе: видно его отражение — номер, поставщик, строки товаров. Сам документ живёт в базе, а форма держит его у себя, пока открыта, и показывает по частям. Это различие ещё не раз пригодится.

4. С чего начинается чтение формы

Раз у каждой формы один предмет, первый вопрос к любой незнакомой форме — «о чём она?». Ответить на него часто помогает заголовок окна. Когда форму строит платформа, она пишет в заголовке имя предмета, а у карточек — ещё и в скобках, какого вида этот предмет. Автор формы может задать и свой заголовок, поэтому заголовок — подсказка, а не гарантия.

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

Чтение формы начинается с вопроса «о чём она?». Первая подсказка — заголовок окна.

5. Где разговор перестаёт быть об одном

Образ разговора об одном объекте точно описывает большинство форм: карточки, списки, отчёты. Но у него есть граница, и о ней лучше знать заранее.

Представьте рабочее место кассира. В одном окне — товары покупателя, сумма, способ оплаты, сдача, кнопка печати чека. О каком одном объекте это окно? Ни о каком: оно не о товаре и не о документе, а о задаче — обслужить покупателя.

Такие окна тоже формы, и собраны они из тех же деталей: полей, таблиц, кнопок. Отличается только то, что в центре разговора стоит не предмет, а дело. В дереве конфигурации они чаще всего живут в ветке «Обработки». Подробно мы встретимся с ними ближе к концу книги; пока достаточно знать, что форма «не про один объект» — не ошибка и не нарушение правила, а другой род формы.

Большинство форм — про один объект. Но есть формы, у которых в центре задача, а не предмет. Устроены они из тех же деталей.

6. В режиме Предприятия

Проверим на «Канцтоварах», что у каждой формы один предмет и что заголовок его называет.

1. Откройте карточку товара «Ручка шариковая» и прочитайте заголовок окна: имя предмета и, в скобках, его вид.

2. Откройте список товаров. В заголовке — «Товары», без скобок: предмет — справочник целиком.

3. Откройте список поступлений и нажмите «Создать». Откроется карточка документа, которого ещё нет, — и заголовок об этом скажет. Ничего не вводя, закройте её.

4. Откройте поступление № 12 и нажмите кнопку «…» у поля «Контрагент». Откроется окно со списком контрагентов: его предмет — справочник «Контрагенты», а задача — выбрать из него одного. Закройте его, ничего не выбирая, а затем закройте и карточку.

Обратите внимание на третий шаг: предмета разговора может ещё не быть. Новая карточка говорит о документе, который появится в базе, только когда его запишут. А четвёртый шаг показывает ещё одну форму о справочнике целиком — форму выбора: предмет тот же, что у списка, а разговор другой — «выберите одного».

Главное в одном абзаце

Окна прикладной программы, которые мы называем формами, почти всегда говорят с пользователем о чём-то одном — об одном товаре, одном документе, о справочнике как целом или об одном вопросе. Отсюда образ, на котором держится книга: форма — это разговор системы с пользователем по поводу одного объекта. Строго форма — объект конфигурации, описывающий одно окно; заданная разработчиком, она живёт в ветке «Формы» внутри своего объекта или среди общих форм, но окно может обойтись и без заданной формы. У разговора пять частей — реплика, предмет, видимая часть, глагол, оглавление, — и в 1С им соответствуют форма, реквизит формы, элемент формы, команда и командный интерфейс. Чтение любой формы начинается с вопроса «о чём она?», и первая подсказка — заголовок окна. Граница у образа тоже есть: бывают формы, в центре которых задача, а не предмет, — вроде рабочего места кассира; собраны они из тех же деталей.

Каждая форма — реплика об одном. Но реплик в программе десятки, и пользователь как-то находит нужную. Кто подсказывает ему, какие разговоры в программе вообще возможны и откуда их начинать?

Контрольные вопросы

1. Что общего у всех окон программы, которые мы называем формами?
2. О чём разговаривает карточка товара, а о чём — список товаров?
3. Что такое форма, если сказать строго, и где она живёт в Конфигураторе?
4. Назовите пять слов разговора и то, что каждому из них соответствует в 1С.
5. По чему в Предприятии быстрее всего понять, о чём форма?
6. Чем рабочее место кассира не похоже на карточку документа — и чем похоже?

Упражнения

Назовите предмет. Откройте в Предприятии карточку товара, список товаров, карточку поступления № 12, отчёт об остатках и окно выбора контрагента. Для каждого окна одной фразой ответьте: о чём оно?

Бланк из жизни. Возьмите бумажный бланк — квитанцию за квартиру, заявление в библиотеку, бланк заказа. О каком одном предмете он? Что в нём заполняет человек, а что уже напечатано заранее?

Ловушка: список — это много разговоров? Коллега рассуждает: «Список товаров — не одна реплика, а много: по одной на каждый товар, строк-то много». Прав ли он? Чем проверить?

Предмет по заголовку. Даны заголовки окон: «Контрагенты», «ООО «Ромашка» (Контрагенты)», «Поступление товаров (создание)», «Рабочее место кассира». Назовите предмет разговора в каждом. Какое окно не укладывается в «разговор об одном объекте» и почему?

Ответы — в конце части.

§ 0.4. Командный интерфейс: оглавление прикладной программы

Откуда пользователь вообще знает, что в программе есть список товаров? Ему этого никто не рассказывал, и всё же он находит нужное окно среди десятков, а в типовой программе — среди многих сотен. Значит, программа заранее выкладывает перед ним всё, что умеет, и делает это не как попало. У книги для этого есть оглавление. У прикладной программы 1С — тоже, и называется оно командным интерфейсом.

1. Оглавление программы

Толстую книгу не листают в поисках нужной главы: открывают оглавление, находят часть, в ней строку и по номеру страницы попадают куда нужно. Программа устроена так же — только вместо глав у неё формы.

Пользователь выбирает раздел, в разделе — команду, и команда открывает форму: список, карточку, отчёт. Главное дело оглавления — не рассказывать, а привести к тому месту, где рассказ начнётся.

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

Оговорка, без которой образ треснет: рядом со ссылками на формы в разделе живут и действия — «Создать», «Отчёты». Оглавление книги таких кнопок не знает, а оглавление программы знает.

Строгая пара, как обычно, с адресом в Конфигураторе:

образ    оглавление программы
строго   разделы программы и команды
         в них, через которые открывают
         списки, карточки, отчёты
где      подсистемы в ветке «Общие»;
         свойства конфигурации
         «Командный интерфейс»

2. Из чего складывается главное окно

Окно программы 1С в интерфейсе «Такси» — в нём работают современные типовые программы — делится на несколько областей. Вот как это выглядит в типовой программе, где разделов много:

┌──────────────────────────────────────────┐
│ заголовок, главное меню, поиск           │
├────────────┬─────────────────────────────┤
│ Главное    │ Товары                      │
│ Закупки    │ Контрагенты                 │
│ Продажи ◄  │ Реализации товаров          │
│ Склад      │ Создать ▾  Отчёты ▾         │
│            ├─────────────────────────────┤
│            │ рабочая область:            │
│            │ здесь открываются формы     │
└────────────┴─────────────────────────────┘
   разделы     функции раздела «Продажи»

Слева — панель разделов: список разделов верхнего уровня, между которыми переключаются одним щелчком; стрелкой на наброске отмечен открытый. Рядом — функции текущего раздела: сначала команды, которые открывают списки, затем группы действий — «Создать», «Отчёты», «Сервис». Остальное место — рабочая область: здесь и открываются формы. Бывают и другие панели — избранное, история, открытые окна, — но оглавление держат эти две.

Расположение панелей не жёсткое: пользователь может скрыть лишние или выбрать для них другое место из допустимых. Но состав — какие разделы есть и какие команды в каждом — задаёт не он, а разработчик.

3. Раздел — это подсистема

Откуда берутся разделы? Первый из них, «Главное», есть в любой программе, даже самой маленькой: платформа показывает его всегда. Все остальные — это подсистемы первого уровня, объекты конфигурации из ветки «Общие», у которых включено свойство «Включать в командный интерфейс». Одна подсистема первого уровня — один раздел; вложенные в неё подсистемы становятся группами команд внутри этого раздела.

Конфигурация
└── Общие
    └── Подсистемы
        ├── Закупки   → раздел «Закупки»
        ├── Продажи   → раздел «Продажи»
        └── Склад     → раздел «Склад»

Что попадает в раздел, решает состав подсистемы: разработчик включает в неё объекты — справочники, документы, отчёты, — и их стандартные команды появляются в разделе. Стандартные — это те, которые платформа даёт объекту сама, не спрашивая: открыть список, создать новую запись. Документ «ПоступлениеТоваров», включённый в подсистему «Закупки», даёт в разделе «Закупки» команду открыть список поступлений и команду создать новое. Увидит их пользователь, у которого есть права на этот документ; а если набор по умолчанию не устраивает, разработчик поправит его в командном интерфейсе подсистемы — уберёт лишнее или добавит свои команды.

Названия свойств запоминать сейчас не обязательно — важнее связь: подсистема даёт раздел, включённый в неё объект даёт команды в этом разделе. И здесь снова работает правило, которое встретится в книге ещё не раз: стандартные команды в разделе никто не рисовал по одной. Разработчик сказал «поступления относятся к закупкам», а кнопки платформа расставила сама.

4. Что видно в «Канцтоварах»

В «Канцтоварах» ветка «Подсистемы» пока пуста: конфигурация, собранная по «Дереву метаданных», разделов не заводила. Поэтому раздел на экране один — «Главное», тот самый, что есть всегда. Команды в нём платформа расставила сама: списки товаров, контрагентов, складов, поступлений и отчёт об остатках. Если какого-то из них там не окажется, откройте главное меню: в нём есть пункт «Все функции», где перечислено всё, что есть в программе.

Выглядит это бедно, но полезно: вы видите оглавление, которое платформа собрала без участия разработчика. Когда ближе к концу книги мы заведём подсистемы «Закупки» и «Продажи», оглавление «Канцтоваров» станет похоже на оглавление типовой программы — и вы увидите, что поменялось от нескольких строк в Конфигураторе.

Прежде чем идти дальше, разведём два похожих слова про команды: они живут в разных местах и делают разное.

5. Не путать с командной панелью формы

Слово «команда» живёт в двух местах, и их легко спутать. У программы есть командный интерфейс — оглавление. У каждой формы есть своя командная панель — полоса кнопок наверху формы: «Записать», «Провести и закрыть».

Проверка простая: команда оглавления доступна, когда не открыто ни одной формы, — её видно в разделе сразу после запуска программы. Глагол формы появляется вместе с формой и без неё не существует.

6. Одна форма — несколько входов

Теперь, когда оглавление отделено от глаголов формы, видно и ещё одно: оглавление — не единственная дорога к форме.

Раздел — не дом формы, а место, где стоит команда, которая её открывает. Одна и та же форма открывается разными путями, и оглавление — только один из них.

Объект может входить и в несколько подсистем сразу: справочник «Товары» нужен и в закупках, и в продажах, и его список окажется в обоих разделах. Форма от этого не раздваивается — просто у неё два входа.

Форма живёт в своём объекте, а не в разделе. Раздел лишь даёт к ней вход — и не единственный.

7. В режиме Предприятия

1. Посмотрите на панель разделов «Канцтоваров». Сколько в ней разделов и как называется единственный?

2. Откройте «Главное» и перепишите его команды. Какие из них открывают списки, какие что-то создают, какие открывают отчёты?

3. Откройте из «Главного» список поступлений, а в нём — поступление № 12. Затем нажмите в заголовке формы кнопку с домиком: она возвращает на начальную страницу — ту, что программа показывает при запуске. Карточка при этом не закрылась: к ней можно вернуться через список открытых окон или историю.

4. Откройте главное меню и найдите в нём настройку панели разделов. В списке разделов, который она покажет, будет один «Главное».

Главное в одном абзаце

Командный интерфейс — оглавление прикладной программы: разделы и команды в них, через которые пользователь находит и открывает формы, не перебирая их подряд. В главном окне его держат две области — панель разделов и функции текущего раздела, — а формы открываются в рабочей области. Раздел «Главное» есть всегда, остальные разделы — подсистемы первого уровня, а стандартные команды в разделе появляются сами, когда разработчик включает объект в подсистему. В «Канцтоварах» подсистем пока нет, поэтому раздел один — «Главное», и его команды платформа расставила без нас. Путать командный интерфейс с командной панелью формы нельзя: первое — оглавление всей программы, второе — глаголы одной открытой формы. И раздел — не дом формы, а один из входов в неё: форма живёт в своём объекте.

Мы нашли форму по оглавлению и открыли её. Но где в этот момент находится то, что мы видим, — на нашем компьютере или там, где хранится база? И почему от ответа зависит, сохранится ли то, что мы введём?

Контрольные вопросы

1. Что в программе 1С играет роль оглавления и из чего оно состоит?
2. Какие области главного окна держат оглавление, а в какой открываются формы?
3. Откуда берётся раздел «Главное» и откуда — все остальные разделы?
4. Как команда попадает в раздел, если её никто не рисовал?
5. Почему в «Канцтоварах» раздел только один?
6. Чем командный интерфейс отличается от командной панели формы?

Упражнения

Оглавление «Канцтоваров». Перепишите команды раздела «Главное» и разложите их на три группы: открывают список, создают новое, открывают отчёт.

Своё оглавление. Разложите «Канцтовары» на бумаге на три-четыре раздела: какие команды в какой раздел попадут. Какой объект хочется положить сразу в два раздела и почему?

Ловушка: две панели. Коллега пишет: «Кнопку „Провести" надо добавить в командный интерфейс, пользователи её не находят». Что не так в этой фразе? Где на самом деле живёт эта кнопка?

Чужое оглавление. В типовой программе разделы такие: «Главное», «Продажи», «Закупки», «Склад», «Финансы», «Администрирование». В каком разделе вы стали бы искать список поступлений товаров, а в каком — справочник товаров? Почему справочник может найтись сразу в нескольких?

Ответы — в конце части.

§ 0.5. Клиент и сервер: пользователь здесь, данные там

Откройте карточку поступления № 12, поменяйте в ней количество и закройте окно, не нажимая «Записать». Введённое исчезнет. Новички считают это придирчивостью программы, а на самом деле здесь видно её устройство — и вопрос, который за ним стоит: где находится то, что мы видим на экране, — у нас на компьютере или там, где хранится база?

1. Две стороны одной программы

Представьте архив с окошком выдачи. Дела лежат в хранилище, за стеной, и наружу их не выносят: вам приносят к окошку копию дела и чистый лист для пометок. Пока вы правите свою копию, хранилище об этом не знает — и другому человеку у соседнего окошка спокойно выдают копию того же дела. Оригинал меняется только тогда, когда вы сдаёте пометки обратно и архивариус их подшивает.

Программа 1С устроена так же. Всё, что вы видите и трогаете, — окна, поля, кнопки — находится у вас. Данные — товары, документы, остатки — лежат в базе, за стеной. Сторона пользователя называется клиентом, сторона данных — сервером.

Данные живут на сервере, пользователь — на клиенте. Между ними ходят описание формы, её данные и обращения к серверу; окно формы — на клиенте.

2. Строже: клиент и сервер — роли

Строже: клиент — часть платформы, которая показывает интерфейс и принимает действия пользователя; сервер — часть, которая работает с базой: читает из неё данные, проверяет их и записывает. Это роли, а не обязательно два разных компьютера.

В файловой базе платформа держит обе роли внутри одной запущенной программы, и сервер ничем не виден. На предприятии сервер — отдельная машина, к которой подключаются десятки пользователей. Но разделение ролей от этого не меняется: окно — у клиента, база — у сервера.

Клиент и сервер — роли, а не обязательно два компьютера.

Где увидеть, какой у вас вариант: в окне запуска выделите базу и нажмите «Изменить…». Файловая база записана там как папка на этом компьютере или в локальной сети, клиент-серверная — как адрес сервера 1С и имя базы на нём.

3. Что происходит, когда открывается форма

Откроем карточку поступления № 12 и проследим, кто что делает.

Окно рисует клиент — по описанию и с данными, которые прислал сервер. Описание формы — это её чертёж: какие на ней поля, в каком порядке, с какими надписями и кнопками; данные — то, что в этих полях стоит. Архивариус из нашего сравнения приносит только дело, а чертёж окна — отдельная бумага; кто её пишет — вопрос следующего параграфа. Отсюда первое практическое следствие: открытие формы — не мгновенное дело. Между щелчком и окном прошло обращение к серверу и ответ от него, и на медленной сети эта пауза заметна.

4. Что происходит, когда вы вводите и записываете

Теперь изменим в карточке количество и посмотрим, куда оно попадёт.

Пока не нажата «Записать», новое значение живёт в данных формы, у клиента. В базе его нет, другие пользователи его не видят, и если закрыть окно, отказавшись сохранять, оно пропадёт. Это и есть ответ на вопрос, с которого начался параграф: введённое в поле не сохраняется само, потому что поле — у клиента, а база — у сервера.

Пока не нажата «Записать», новое значение живёт в данных формы и в базу не попадает.

5. Почему так устроено

Потому что клиентов много, а база одна. Каждый пользователь сидит за своим компьютером и видит своё окно, а правда о товарах и остатках должна быть одна на всех. Хранит её сервер, и только он решает, что записать, — там же живут правила проверки, общие для всех клиентов.

клиент 1 ──┐
клиент 2 ──┼──► сервер ──► база
клиент 3 ──┘

Если бы каждое нажатие клавиши сразу уходило в базу, два кладовщика, правящие одно поступление, мешали бы друг другу на каждой букве. Вместо этого каждый работает со своими данными формы и отправляет их серверу целиком — когда решил, что готово.

6. «Форма ушла на сервер»: как говорят и как точнее

Разработчики говорят быстро: «форма ушла на сервер», «форма пришла с сервера». Образ удобный, но неточный, и разницу стоит видеть с самого начала.

Окно никуда не ходит: его строит и держит клиент. Путешествуют данные и обращения к серверу — разработчики называют их серверными вызовами. Эта поправка ещё пригодится в главе о списках.

7. В режиме Предприятия

Увидеть два клиента одной базы можно на одном компьютере: каждый запуск программы — отдельный клиент.

1. Запустите «Канцтовары» в режиме Предприятия, а затем, не закрывая первое окно, — ещё раз. Теперь у вас два клиента одной базы.

2. В первом окне откройте товар «Ручка шариковая» и замените артикул на «РУЧ-01-Т». Пока не записывайте.

3. Во втором окне откройте тот же товар. Артикул — прежний, «РУЧ-01»: изменение живёт только в первом клиенте.

4. В первом окне нажмите «Записать и закрыть». Во втором закройте карточку и откройте снова: теперь артикул новый.

5. Верните товару прежний артикул «РУЧ-01» и запишите: дальше книга опирается на него.

Главное в одном абзаце

У программы 1С две стороны: клиент, где окна, поля и кнопки и где работает пользователь, и сервер, где лежит база и выполняется всё, что связано с данными. Это роли, а не обязательно два компьютера: в файловой базе обе живут в одной запущенной программе, на предприятии сервер — отдельная машина. Когда форма открывается, сервер читает данные и присылает клиенту описание формы и её данные, а окно строит клиент. Когда вы вводите значение, оно остаётся на клиенте и попадает в базу только после записи, поэтому введённое в поле не сохраняется само. Так устроено потому, что клиентов много, а база одна, и правду о данных держит сервер. Образ «форма ушла на сервер» неточен: окно остаётся у клиента, путешествуют данные и обращения к серверу.

Окно строит клиент — по описанию, которое прислал сервер. Но кто написал это описание? И почему в нём нет ни одной фразы вида «когда нажмут кнопку, сделай то-то»?

Контрольные вопросы

1. Что находится на клиенте, а что — на сервере?
2. Почему клиент и сервер называют ролями, а не компьютерами?
3. Кто строит окно формы и из чего?
4. Где находится новое значение, которое вы ввели в поле, но ещё не записали?
5. Почему правду о данных держит сервер, а не каждый клиент?
6. Что неточного во фразе «форма ушла на сервер»?

Упражнения

Два клиента. Повторите опыт из параграфа и для каждого шага запишите, где в этот момент находится артикул «РУЧ-01-Т»: только на первом клиенте, на сервере или уже у обоих клиентов.

Своё окошко. Найдите клиент и сервер в бытовой системе, которой не было в параграфе: банкомат и банк, касса и магазин, кассир и кухня в кафе. Что в ней ходит между сторонами? Где лежит «правда»?

Ловушка: «у нас нет сервера». Бухгалтер небольшой фирмы говорит: «У нас база файловая, на одном компьютере, сервера нет — значит, всё, что я ввожу, сохраняется сразу». В чём он ошибается дважды?

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

Ответы — в конце части.

§ 0.6. Декларативность платформы: не написать действие, а задать правило

У справочника «Товары» ветка «Формы» пуста — мы замечали это дважды. А карточка товара открывается, и в ней есть всё нужное: поля, кнопки, заголовок. Кто-то ведь решил, что показать и в каком порядке. Ответ неожиданный: иногда не человек. Чертёж окна может написать сама платформа. Из чего?

1. Не действие, а правило

Держать в комнате тепло можно двумя способами. Можно сидеть у градусника и включать обогреватель, когда стало двадцать, а выключать, когда стало двадцать три. А можно поставить на термостате «22» и забыть: как этого добиться, решает сам термостат.

Платформа 1С устроена по второму способу. Разработчик не пишет «когда откроют товар, нарисуй поле с артикулом, а когда нажмут кнопку, сохрани». Он задаёт, каким всё должно быть: у товара есть артикул, у поступления есть поставщик из справочника контрагентов, поступления относятся к закупкам. А как из этого получить окна, кнопки и разделы, решает платформа.

Мы не пишем «когда нажмут кнопку — сделай то-то». Мы задаём правила, по которым платформа сама строит и оживляет интерфейс.

Строгая пара с адресом:

образ    не «сделай», а «пусть будет»
строго   описание свойствами: что есть
         и как связано, а как этого
         достичь, решает платформа
где      палитра свойств: тип — у
         реквизита, автонумерация —
         у документа, состав раздела —
         у подсистемы

Такой способ описания называют декларативным — от латинского «объявлять»: разработчик объявляет, каким должен быть результат. Противоположный — «включи свет», а не «пусть будет светло» — называют императивным: на нём пишут код, и книга дойдёт до него только в самом конце, как до своей границы.

2. Правила, которые уже сработали у нас на глазах

Вспомним, что за пять параграфов произошло «само», и назовём правило за каждым случаем.

Ни одна из этих вещей не написана как действие. Каждая — следствие того, что в дереве конфигурации что-то объявлено.

Если форма ведёт себя сама — значит, где-то в дереве задано правило.

3. Одно правило — много последствий

Самое сильное в правилах — их отдача. Возьмём одно-единственное свойство: реквизит «Контрагент» у поступления имеет тип «ссылка на справочник „Контрагенты“». Ссылка — это не текст с именем, а указание на конкретного контрагента в справочнике. Вот что следует из одного этого свойства, без единого слова сверх него.

В поле можно и просто начать набирать имя — «Канц», — и платформа предложит «Канцелярия Плюс». Но это уже не одно свойство: так работает ввод по строке, у которого свои настройки у справочника и у поля.

Верно и обратное: поменяйте правило — и форма поменяется сама. В «Дереве метаданных» склад у поступления сначала был простой строкой, а потом стал ссылкой на справочник «Склады». Форму поступления при этом никто не открывал, а поле «Склад» из строки для ввода превратилось в поле с кнопкой выбора и окном со списком складов.

4. Где искать правило

Отсюда рабочая привычка, которая пригодится в каждой главе: увидев, что форма ведёт себя сама, спросить «какое правило?» — и знать, где его искать. По ней быстрее всего находят, почему форма ведёт себя так, а не иначе, и где это поменять, не трогая кода.

Про проверку заполнения стоит сказать отдельно, это частый случай. Если у реквизита объекта «Контрагент» свойство «Проверка заполнения» стоит в значении «Выдавать ошибку», платформа не даст записать поступление без поставщика, сообщит об этом и подсветит пустое поле. Ни строки кода — одно значение в палитре свойств.

5. Где правил не хватает

Правила покрывают многое, но не всё. Когда в строке поступления меняют количество, хочется, чтобы сумма пересчиталась сама: количество на цену. Такого свойства у реквизита нет — это уже поведение, и его разработчик дописывает кодом, в обработчике события «при изменении количества». В типовых программах таких обработчиков тысячи.

В «Канцтоварах» такого обработчика нет, и если поменять количество в строке поступления, сумма останется прежней. Код в конфигурации всё же есть — проведение документа записано в модуле объекта, — но это другое место и другая работа. Это не поломка, а честная граница: книга учит читать то, что задано правилами, а код — следующий уровень, к которому она подведёт в самом конце.

Сначала ищите правило. Код — там, где правила кончились.

6. В Предприятии и в Конфигураторе

Проверим на «Канцтоварах», что за «самим собой» стоят свойства. В Конфигураторе мы только смотрим и ничего не меняем.

1. В Предприятии откройте поступление № 12 и нажмите «…» у поля «Контрагент». Откроется окно выбора. Закройте его, ничего не выбирая, и закройте карточку.

2. В Конфигураторе раскройте в дереве «Документы» → «ПоступлениеТоваров» → «Реквизиты» и откройте свойства реквизита «Контрагент». Найдите его тип: «СправочникСсылка.Контрагенты». Вот правило, из которого выросли кнопка и окно выбора.

3. Там же найдите у реквизита свойство «Проверка заполнения» и посмотрите, какое значение в нём стоит.

4. Откройте окно документа «ПоступлениеТоваров» и найдите на вкладке нумерации флажок «Автонумерация». Закройте окна, ничего не сохраняя.

Главное в одном абзаце

Платформа 1С декларативна: разработчик не пишет последовательность действий «когда нажмут кнопку, сделай то-то», а задаёт свойства — каким должен быть результат, что с чем связано, — и платформа сама строит и оживляет по ним интерфейс, как термостат сам держит заданную температуру. Всё, что до сих пор происходило «само», — карточка без формы в дереве, кнопка выбора у поля, номер документа, команды в разделе — было сработавшим правилом, заданным в дереве или в свойствах. Одно правило даёт много следствий, и, поменяв его, меняешь форму, не трогая её. Отсюда привычка: увидев, что форма ведёт себя сама, искать правило в палитре свойств. Правила кончаются там, где нужно поведение, — например, пересчёт суммы; его дописывают кодом, и эта книга такой код не пишет.

Правила, окно, которое платформа раскладывает сама, формы, построенные без рисовальщика, — всё это черты управляемых форм. Но в 1С были и другие формы, нарисованные по координатам. Куда они делись и почему книга о них почти молчит?

Контрольные вопросы

1. Чем задание правилом отличается от задания действием? Приведите бытовой пример.
2. Что значит «декларативное описание» и где в Конфигураторе живут правила?
3. Назовите три вещи в «Канцтоварах», которые произошли «сами», и правило за каждой.
4. Что изменится в карточке поступления, если поменять тип реквизита «Склад» со строки на ссылку на справочник, и почему форму при этом трогать не нужно?
5. Где искать правило, если поле формы ведёт себя по-особому?
6. Почему пересчёт суммы при изменении количества — не правило, а код?

Упражнения

Найдите правило. Для каждого случая назовите правило и где оно задано: у нового поступления сам появился номер; в карточке товара есть поле «Артикул», хотя формы товара в дереве нет; у поля «Склад» в поступлении есть кнопка выбора.

Своё: правила вокруг. Найдите в быту три устройства, которые работают по правилу, а не по командам, — вроде термостата. Для каждого запишите, что вы задаёте и что устройство решает само.

Ловушка: где спрятан код? Новичок говорит: «Кнопку „…“ у поля „Контрагент“ кто-то запрограммировал — найду обработчик и посмотрю, как она работает». Найдёт ли он обработчик? Что он найдёт вместо него?

Правило или код. Для каждого поведения скажите, чем оно, скорее всего, задано — правилом или кодом: поле «Контрагент» подсвечивается, если пустое; при выборе товара в строке сама подставляется его цена; поступление попадает в раздел «Закупки»; документ не записывается без склада.

Ответы — в конце части.

§ 0.7. Два режима форм: управляемые и обычные

Слово «управляемая» стояло в этой главе почти в каждом абзаце, и до сих пор мы обходились без объяснения. Пора сказать, с чем его противопоставляют: раз формы управляемые, значит, бывают и другие. Они называются обычными, и разговор о них будет коротким — увидеть, научиться отличать и больше к ним не возвращаться.

1. Две эпохи

Обычные формы — из первых выпусков восьмой версии. Их рисовали мышью на холсте: поле стоит там, куда его положили, и окно выглядит ровно так, как его нарисовал разработчик. Управляемые появились в версии 8.2, вместе с тонким и веб-клиентом, а основным способом работы стали позже. Устроены они иначе: в конфигурации описано, что на форме есть и с чем связано, а где что окажется на экране, решает платформа.

2. Почему платформа сменила подход

Причина прямо следует из того, о чём мы говорили. Окно строит клиент — а клиентов стало несколько: обычная программа на компьютере, браузер, телефон.

Их и называют клиентами: программу на компьютере — толстым или тонким клиентом, браузер — веб-клиентом, телефон — мобильным. Разница между толстым и тонким здесь неважна; важно, что рисуют они по-разному. Нарисованную по координатам картинку в браузер как есть не перетащишь: там другие шрифты, другие размеры, другое окно, и подогнать её под каждый экран нечем. А описание «здесь поле артикула, здесь таблица товаров, вот кнопки» переносится куда угодно — каждый клиент рисует его своими средствами.

Отсюда и название, которое сбивает с толку почти всех новичков. Слышится в нём, будто управляет формой пользователь: двигает поля, меняет их размер. На деле пользователь управляет данными и командами, а раскладкой — платформа.

Управляемая форма названа так не потому, что ею управляет пользователь, а потому, что её раскладкой управляет платформа.

Кое-что пользователю платформа всё же отдаёт: в разрешённых пределах он подстраивает вид под себя — прячет колонки, меняет их порядок и ширину. Но раскладку в целом считает она.

3. Как отличить одну от другой

Отличить нетрудно, и полезно уметь: по признакам сразу ясно, применима ли к форме эта книга.

редактор обычной        редактор управляемой
┌──────────────────┐    Форма
│ Наименование [ ] │    ├── Реквизиты
│ Артикул      [ ] │    ├── Элементы
│                  │    │   ├── Наименование
│    [Записать]    │    │   └── Артикул
└──────────────────┘    └── Команды
  элементы двигают      порядок и группы

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

4. Где обычные формы ещё попадаются

Совсем они не исчезли. Встретить их можно в трёх случаях.

Третий случай стоит прочитать внимательно: «управляемый режим» здесь — про режим работы приложения, а не про тип клиента. Обычные формы и в такой конфигурации открываются только толстым клиентом.

Во всех трёх случаях дело не в отдельной форме, а в решении, принятом для всей конфигурации. Перевод такой конфигурации на управляемые формы — отдельная большая работа, и книга её не разбирает.

5. Что это значит для книги

Дальше в книге слово форма значит «управляемая форма», и оговариваться об этом мы больше не будем. Всё, что сказано про правила, раскладку, клиент и сервер, относится к ним.

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

Главное в одном абзаце

Формы в 1С бывают двух родов. Обычные рисовали мышью на холсте, элементы в них стоят по координатам, и работают такие формы только в толстом клиенте, — это наследство первых выпусков восьмёрки. Управляемые появились в версии 8.2: в конфигурации описано, что на форме есть и с чем оно связано, а раскладку считает платформа при открытии, поэтому одно и то же описание живёт и в программе на компьютере, и в браузере, и на телефоне — выглядя на каждом по-своему. Отсюда название: формой управляет не пользователь, а платформа. Отличают их по редактору — холст против дерева элементов, — по клиенту и по свойствам конфигурации. Обычные формы ещё встречаются в старых конфигурациях и при режиме совместимости с 8.1, но эта книга дальше говорит только об управляемых.

Мы всё время ссылались на дерево конфигурации: там задан тип реквизита, там живут подсистемы, там лежат формы. А что это, собственно, за дерево — и где в нём место коду?

Контрольные вопросы

1. Чем обычная форма отличается от управляемой по способу задания?
2. Почему управляемая форма называется управляемой?
3. Какими клиентами открывается обычная форма, а какими — управляемая?
4. По каким признакам вы отличите одну от другой в Конфигураторе?
5. В каких случаях в конфигурации до сих пор работают обычные формы?

Упражнения

Найдите режим. В Конфигураторе откройте свойства корня конфигурации «Канцтовары» и найдите свойство «Основной режим запуска». Какое значение в нём стоит и что это значит для форм, которые мы будем делать?

Два описания. Опишите словами, как выглядело бы задание карточки товара в обычной форме и в управляемой: что в каждом случае задаёт разработчик, а что остаётся платформе.

Ловушка: кто управляет. Новичок говорит: «Управляемая форма — это форма, которой пользователь может управлять: двигать поля, менять колонки. А обычная — та, где ничего не подвинешь». Что здесь перепутано и почему вывод всё же получился отчасти верным?

Чужая форма из описания. Дано: «окно открывается только в толстом клиенте, поля стоят на своих местах и не переставляются, разработчик менял их расположение мышью». Какого рода эта форма и в какой конфигурации она могла сохраниться?

Ответы — в конце части.

§ 0.8. Связь с метаданными и с кодом: где здесь дерево, где здесь язык

Откройте Конфигуратор — и первое, что вы увидите, будет дерево: «Справочники», «Документы», «Отчёты», «Регистры». За главу мы сослались на него с десяток раз, ни разу не объяснив, как оно устроено: там задан тип реквизита, оттуда берутся разделы, там лежат формы. Пора собрать необходимый минимум в одном месте. Если «Дерево метаданных» вы читали, этот параграф освежит знакомое; если нет — даст то, чего хватит до конца книги.

1. Дерево конфигурации: чертёж программы

Конфигурация — устройство прикладной программы, и показывают его деревом. Ветки дерева — это виды объектов, а внутри веток то, что завёл разработчик.

Дерево конфигурации — чертёж программы: что в ней есть и как оно устроено. Чертёж устройства, а не поведения: поведение задают свойства и код.

Полное объяснение, почему объекты именно такие и чем документ отличается от справочника, — в «Дереве метаданных». Здесь нам хватит трёх слов.

2. Объект, реквизит, табличная часть

Объект конфигурации — то, что заведено в дереве: справочник «Товары», документ «ПоступлениеТоваров». Он описывает не одну запись, а целый вид: справочник «Товары» — это все товары, какие есть и будут.

Реквизит объекта — его свойство, которое хранится в базе: артикул у товара, контрагент у поступления.

Табличная часть — таблица внутри объекта: у поступления это строки товаров.

Документ «ПоступлениеТоваров»
├── Реквизиты
│   ├── Контрагент → Контрагенты
│   └── Склад      → Склады
└── Табличная часть «Товары»
    ├── Товар      → Товары
    ├── Количество
    ├── Цена
    └── Сумма

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

Оговорка в первой строке не случайна: показывают не всё, что хранится, и об этом речь в конце параграфа.

Ещё два слова понадобятся по дороге. Ссылка — значение, которое указывает на конкретную запись: на элемент справочника, на отдельный документ. В поступлении хранится не имя «Канцелярия Плюс», а ссылка на этого контрагента; на форме её видно как поле с кнопкой выбора. Проведение — операция документа, при которой платформа выполняет правила, заданные для него, и записывает движения в регистры: после проведения поступления остаток товара на складе увеличивается. Где живут эти правила, увидим в следующем разделе.

3. Где в этом дереве код

Правила живут в свойствах, а код — в модулях. Модули есть у формы, у объекта, у менеджера объекта, у набора записей регистра и в других местах; отдельно — общие модули, которыми пользуется вся конфигурация. Нам понадобятся первые два. В модулях лежат процедуры, и среди них — обработчики событий, свои у каждого модуля: у формы — «при открытии», «при изменении», у объекта — «перед записью», «при записи», обработка проведения.

Правила — в свойствах, код — в модулях. Эта книга читает свойства.

Граница книги проходит ровно здесь. Мы будем открывать свойства, сравнивать их с тем, что видно на экране, и собирать формы, не написав ни строки кода. В формах, которые мы сделаем, обработчики останутся пустыми и помеченными — чтобы было видно: это не забыли, это граница.

4. Как искать в дереве то, что видишь на экране

Дальше в книге этот путь будет повторяться постоянно, поэтому проговорим его один раз.

Строже: поле — элемент формы, и живёт оно на вкладке «Элементы» редактора формы; реквизит — в дереве, у объекта. «Чаще всего» в таблице стоит не зря: поле может показывать и не реквизит объекта — такие случаи разберём дальше. Обратный путь тоже рабочий: увидели в дереве реквизит — ищите на форме поле, которое его показывает. Если поля нет, это не ошибка: не всё, что хранится, показывают.

5. В Конфигураторе

Откроем «Канцтовары» в Конфигураторе и посмотрим на чертёж целиком. Ничего не меняем.

1. Раскройте дерево и найдите ветки «Справочники», «Документы», «Отчёты», «Регистры сведений», «Регистры накопления». Сравните с тем, что видели в Предприятии: списки, карточки, отчёт — всё это собрано отсюда.

2. Раскройте документ «ПоступлениеТоваров»: найдите реквизиты «Контрагент» и «Склад» и табличную часть «Товары» с её реквизитами.

3. Найдите у документа ветку «Формы». Она пуста — а карточка поступления в Предприятии открывается.

4. Откройте модуль объекта документа. Он не пуст: там лежит процедура проведения, которую написал за разработчика конструктор движений в «Дереве метаданных». Читать её мы не будем — важно увидеть, где живёт код. Закройте окна, ничего не сохраняя.

Главное в одном абзаце

Дерево конфигурации — чертёж прикладной программы: его ветки суть виды объектов, а внутри лежит то, что завёл разработчик, — справочники для того, что существует, документы для того, что произошло, регистры для записей о состоянии и о движениях, отчёты для вопросов. Объект конфигурации описывает целый вид, а не одну запись; реквизит объекта — его свойство, хранимое в базе; табличная часть — таблица внутри объекта. По этому чертежу платформа собирает форму: реквизит показывается полем — если его вывели, — табличная часть таблицей, стандартные команды кнопками. Правила живут в свойствах, а код — в модулях, и граница этой книги проходит между ними: мы читаем и задаём свойства, а обработчики оставляем пустыми. Путь от экрана к дереву и обратно — заголовок формы, объект, его ветка «Формы», реквизит и поле — дальше будет повторяться в каждой главе.

Мы дважды натыкались на одно и то же: формы в дереве нет, а окно открывается. Пора выяснить, что именно платформа строит сама, из чего она это берёт и где у неё предел.

Контрольные вопросы

1. Что такое дерево конфигурации и что лежит в его ветках?
2. Чем объект конфигурации отличается от одной записи — например, справочник «Товары» от товара «Ручка шариковая»?
3. Что такое реквизит объекта и что такое табличная часть?
4. Во что превращаются на форме реквизит, табличная часть и стандартные команды объекта?
5. Где в конфигурации живут правила, а где — код?
6. Каким путём от открытой формы дойти до объекта в дереве?

Упражнения

Прочитайте чертёж. По ветке документа «ПоступлениеТоваров» в Конфигураторе предскажите, что будет на его карточке в Предприятии: какие поля, какая таблица, какие кнопки. Потом откройте карточку и сверьте.

Обратный путь. Откройте в Предприятии список складов и по нему найдите в дереве объект, из которого он вырос. Что вы искали в заголовке окна?

Ловушка: реквизит и поле. Коллега говорит: «Реквизит — это поле на форме, просто называется по-другому». В чём он не прав? Приведите случай, когда реквизит есть, а поля нет.

Где искать код. Для каждого вопроса скажите, куда смотреть — в свойства или в модуль: почему у поля «Контрагент» есть кнопка выбора; почему при проведении поступления меняется остаток на складе; почему в списке товаров видно артикул; почему после ввода количества сумма не пересчиталась.

Ответы — в конце части.

Ответы к части 0

Ответы собраны здесь, а не под вопросами: подсказка, увиденная сразу после вопроса, отменяет попытку вспомнить. У каждого ответа до трёх ступеней: сам ответ, указание — если ответ не дался сразу — и полное решение там, где рассуждение важнее вывода.

§ 0.1. Платформа в двух режимах: Конфигуратор и Предприятие

К вопросу 1. Ответ. Конфигуратор и 1С:Предприятие — или просто Предприятие.

К вопросу 2. Ответ. Разработчик — в Конфигураторе, бухгалтер и кладовщик — в Предприятии.

К вопросу 3. Ответ. Оба подключаются к одной информационной базе, в которой лежат и конфигурация, и данные. Одна база — две двери.

К вопросу 4. Ответ. В Конфигураторе видно устройство программы: дерево конфигурации, формы в редакторе, код; товары и документы здесь не вводят. В Предприятии видна работа программы: разделы, списки, документы, отчёты, а устройство скрыто.

К вопросу 5. Указание. Должны случиться две вещи: одна — в Конфигураторе, другая — у пользователя.

Полное решение. Сначала разработчик обновляет конфигурацию базы данных: до этого изменение лежит в Конфигураторе и в работу не пошло. Затем пользователь перезапускает программу: сеанс, открытый раньше, работает с прежней конфигурацией и нового поля не покажет. Обе вещи нужны — не хватит любой, и пользователь поля не увидит.

К вопросу 6. Ответ. Чтобы видеть форму глазами того, для кого она сделана. В редакторе всё кажется понятным, потому что мы сами это собирали и помним, что куда положили; пользователь видит только то, что ему показали.

К упражнению «Первый взгляд». Ответ. Свободный. Типичные наблюдения: «сверху — заголовок и меню», «сбоку — раздел со списком всего, что есть», «в центре — пустая область или начальная страница». Хорошо, если описано своими словами: в этом и задача.

К упражнению «Вторая дверь». Ответ. Свободный. Типичные отличия: вместо раздела — дерево с ветками «Справочники», «Документы», «Отчёты»; товаров и документов не видно, видны только объекты, из которых программа устроена; названия объектов пишутся слитно — «ПоступлениеТоваров», а не «Поступление товаров».

К упражнению «Схема по памяти». Ответ. Одна база, подписанная «конфигурация + данные», и две стрелки к ней — от Конфигуратора и от Предприятия. У Конфигуратора подпись «разработчик; видит устройство», у Предприятия — «пользователь; видит работу».

К упражнению «Ловушка: поле, которого нет». Указание. Вспомните таблицу из четырёх шагов: какие из них разработчик мог счесть сделанными раньше, чем они случились?

Полное решение. Первая причина — разработчик изменил конфигурацию, но не обновил конфигурацию базы данных: изменение осталось в Конфигураторе. Вторая — у кладовщика открыта программа, запущенная до обновления: ей нужен перезапуск. Ловушка в слове «добавил»: для разработчика поле добавлено, как только оно появилось в редакторе, а для пользователя — только когда оно дошло до его экрана. Бывает и третья причина — поле добавили не на ту форму, которую открывает кладовщик: у одного товара окон несколько, и об этом — в следующей главе.

К упражнению «По одной фразе». Ответ. Бухгалтер — в Предприятии, стажёр — в Конфигураторе.

Полное решение. Разделы «Закупки», «Продажи», «Зарплата» названы деловыми словами, и так они выглядят только в Предприятии; в Конфигураторе их следы лежат в ветке «Подсистемы» внутри «Общих». У стажёра признаков два: «ветка» — это слово дерева конфигурации, а имя «ПоступлениеТоваров» написано слитно, как пишут имя объекта. В Предприятии пользователь увидел бы «Поступление товаров».

§ 0.2. Что такое интерфейс пользователя: всё, что видно и трогается

К вопросу 1. Ответ. Всё, через что человек общается с системой: сообщает ей, чего хочет, и получает ответ. Примеры: руль, педали и приборы автомобиля; ручка и табло микроволновки; экран и клавиши банкомата.

К вопросу 2. Ответ. Разделы, списки, карточки, поля, кнопки, сообщения и вопросы — любые пять.

К вопросу 3. Ответ. В режиме Предприятия. Конфигуратор показывает устройство программы, а не её интерфейс.

К вопросу 4. Ответ. Потому что они отвечают на разные вопросы. Список — «какие товары у нас бывают»: ему нужно показать много товаров сразу. Карточка — «каков этот товар»: ей нужно показать один товар целиком.

К вопросу 5. Ответ. Данные в информационной базе, правила, по которым программа считает и проверяет, код, написанный разработчиком, и устройство объектов в дереве конфигурации.

К вопросу 6. Указание. Можно ли назвать интерфейсом одно окно? А можно ли назвать формой всё, что видит пользователь?

Полное решение. Интерфейс шире. Это всё видимое и доступное для действия в программе: разделы, меню, списки, карточки, сообщения. Форма — одно отдельное окно: список товаров, карточка поступления, окно отчёта. Раздел программы или главное меню — часть интерфейса, но не форма; как они устроены, книга разберёт ближе к концу. Помогает сравнение с квартирой: интерфейс — вся обстановка, форма — одна комната, и каждая комната устроена по-своему, потому что служит своему делу.

К упражнению «Четыре окна». Ответ. Свободный. Опорные наблюдения: список товаров — таблица, по строке на товар; карточка товара — отдельные поля одного товара; карточка поступления — поля сверху и таблица товаров ниже, кнопки записи и проведения; отчёт — настройки и область результата, которая заполняется после «Сформировать».

К упражнению «Своё устройство». Ответ. Свободный. Пример для лифта: человек сообщает кнопками этажей и кнопкой вызова; лифт отвечает табло с номером этажа, звонком, открывающимися дверями; под поверхностью — мотор, тросы и управляющее устройство, которое решает, куда ехать сначала.

К упражнению «Ловушка: „программа меня не понимает"». Ответ. Возможны оба места.

Полное решение. На поверхности: нажата не та кнопка; кнопка недоступна; программа показала сообщение, которого пользователь не заметил. Под поверхностью: правило или код, который должен сработать, работает не так; у пользователя нет права на это действие. Ловушка в том, что «ничего не происходит» — наблюдение с поверхности, а причина может быть на любой глубине. Поэтому разбор начинают с поверхности — та ли кнопка, доступна ли, не было ли сообщения — и только потом ищут глубже.

К упражнению «Где это живёт». Ответ. Первое — о том, что под поверхностью: значение превращается кодом. Второе — о поверхности.

Полное решение. Когда число переводят в строку и приписывают знак рубля, меняется само значение — это работа кода. Когда сумму «показывают с двумя знаками», значение в базе остаётся тем же, меняется только то, как поле его выводит. Это свойство того, как показано, а не того, что лежит, — то есть интерфейса. Ловушка в том, что обе фразы звучат как «про деньги на экране», а живут на разных этажах.

К упражнению «Окно не из четырёх». Ответ. Свободный. Подойдут окно настроек, окно со списком всех функций программы, маленькое окно выбора, которое открывается, когда в документе выбирают контрагента из списка. Последнее особенно интересно: это тоже форма, но с другой задачей — не показать и не принять данные, а помочь выбрать одно значение.

§ 0.3. Форма как единица интерфейса: разговор о чём-то одном

К вопросу 1. Ответ. Почти каждое окно говорит с пользователем о чём-то одном: об одном товаре, одном документе, о справочнике целиком или об одном вопросе.

К вопросу 2. Ответ. Карточка — об одном товаре, например о ручке шариковой. Список — о справочнике «Товары» целиком: какие товары у нас бывают.

К вопросу 3. Ответ. Форма — объект конфигурации, который описывает одно окно: из каких частей оно состоит, что показывает и что позволяет сделать. Живёт она в ветке «Формы» внутри своего объекта — справочника, документа, отчёта, — а если её сделали общей, то среди общих форм в ветке «Общие». Такую форму задаёт разработчик; окно может обойтись и без неё, и кто его тогда строит — вопрос следующей главы.

К вопросу 4. Ответ. Реплика — форма; предмет реплики — реквизит формы; видимая часть реплики — элемент формы; глагол — команда; оглавление — командный интерфейс.

К вопросу 5. Указание. Посмотрите на окно сверху, раньше, чем на поля.

Полное решение. По заголовку окна. Платформа пишет в нём имя предмета, а у карточки — ещё и вид предмета в скобках: «Ручка шариковая (Товары)». Заголовок без скобок, «Товары», говорит, что предмет — справочник целиком. Но это подсказка, а не гарантия: автор формы может задать свой заголовок, и тогда предмет придётся искать по содержимому окна.

К вопросу 6. Ответ. Не похоже тем, что говорит не об одном объекте, а о задаче — обслужить покупателя: в нём сразу товары, оплата и чек. Похоже тем, что собрано из тех же деталей — полей, таблиц, кнопок — и тоже является формой.

К упражнению «Назовите предмет». Ответ. Карточка товара — об одном товаре; список товаров — о справочнике «Товары» целиком; карточка поступления — об одном документе, поступлении № 12; отчёт — об одном вопросе, сколько товара на складах; окно выбора — отдельная форма о справочнике «Контрагенты» целиком, с задачей выбрать одного.

К упражнению «Бланк из жизни». Ответ. Свободный. Пример: квитанция за квартиру — об одном платеже за одну квартиру за один месяц. Напечатаны заранее получатель, адрес, строки услуг; заполняет человек показания счётчиков, сумму, дату. Хорошо, если вы заметили, что бланк, как и форма, собран вокруг одного предмета.

К упражнению «Ловушка: список — это много разговоров?». Ответ. Не прав.

Полное решение. У списка один предмет — справочник «Товары» целиком, а строки — его содержимое, как строки в оглавлении книги не делают из неё много книг. Проверить можно глаголами списка. Кнопка «Создать» добавляет товар в справочник — это действие над целым, а не над строкой. А отдельный разговор о каждом товаре начинается там, где открывается его собственное окно, — в карточке, по двойному щелчку на строке.

К упражнению «Предмет по заголовку». Ответ. «Контрагенты» — справочник целиком. «ООО «Ромашка» (Контрагенты)» — один контрагент. «Поступление товаров (создание)» — один документ, которого ещё нет в базе: он появится, когда его запишут. «Рабочее место кассира» не укладывается в разговор об одном объекте: это задача — обслужить покупателя, — а не предмет. Это форма того рода, в центре которого дело, как у рабочего места кассира.

§ 0.4. Командный интерфейс: оглавление прикладной программы

К вопросу 1. Ответ. Командный интерфейс: разделы программы и команды в них, через которые открывают формы: списки, карточки, отчёты.

К вопросу 2. Ответ. Оглавление держат панель разделов и функции текущего раздела. Формы открываются в рабочей области.

К вопросу 3. Ответ. «Главное» платформа показывает всегда, в любой программе. Остальные разделы — это подсистемы первого уровня из ветки «Общие»: одна подсистема первого уровня — один раздел, а вложенные в неё подсистемы становятся группами команд внутри него.

К вопросу 4. Указание. Что разработчик делает с подсистемой, а что платформа делает сама?

Полное решение. Разработчик включает объект в состав подсистемы — например, документ «ПоступлениеТоваров» в «Закупки». Команды объекта — открыть список, создать новый — платформа сама ставит в раздел этой подсистемы. Разработчик задаёт правило «поступления относятся к закупкам», а кнопок по одной не рисует.

К вопросу 5. Ответ. Потому что подсистем в конфигурации нет: по «Дереву метаданных» их не заводили. Остаётся только раздел, который есть всегда, — «Главное».

К вопросу 6. Ответ. Командный интерфейс — оглавление всей программы: его команды открывают формы. Командная панель — полоса кнопок одной формы: её команды что-то делают с тем, что уже открыто. Проверка: открывает команда новую форму — это оглавление; действует над открытой — это глагол формы.

К упражнению «Оглавление „Канцтоваров"». Ответ. Ожидаемо: списки — товары, контрагенты, склады, поступления товаров; создание — новое поступление, новый товар; отчёт — остатки товаров на складе. Точный состав сверьте с экраном: что платформа кладёт в «Главное», зависит от настроек объектов.

К упражнению «Своё оглавление». Ответ. Свободный. Пример: «Закупки» — поступления, контрагенты; «Склад» — товары, склады, отчёт об остатках; «Справочники» — всё, что заводят один раз. Контрагентов хочется положить и в закупки, и в продажи: у них покупают и им продают. Так и делают — объект входит в две подсистемы, и у его списка появляются два входа.

К упражнению «Ловушка: две панели». Ответ. Кнопка «Провести» — глагол формы документа, она живёт в командной панели его формы, а не в оглавлении.

Полное решение. Командный интерфейс открывает формы; провести же можно только документ, который уже открыт, — значит, это действие над открытой репликой. Если пользователи кнопку не находят, искать нужно в командной панели формы: возможно, кнопка убрана в меню «Ещё». Добавлять её в разделы программы бессмысленно — там нечего проводить.

К упражнению «Чужое оглавление». Ответ. Поступления — в «Закупках». Справочник товаров — в «Складе», а скорее всего ещё и в «Продажах» и «Закупках».

Полное решение. Раздел — не дом формы, а вход в неё. Справочник товаров нужен и тому, кто закупает, и тому, кто продаёт, и тому, кто считает остатки, поэтому разработчик включает его в несколько подсистем. Форма списка при этом одна и та же — у неё просто несколько входов.

§ 0.5. Клиент и сервер: пользователь здесь, данные там

К вопросу 1. Ответ. На клиенте — окна, формы, поля, кнопки: всё, что видит и трогает пользователь. На сервере — база с данными и всё, что с ними делают: чтение, проверка, запись.

К вопросу 2. Ответ. Потому что это разделение обязанностей, а не устройств. В файловой базе обе роли выполняет одна запущенная программа на одном компьютере; на предприятии сервер — отдельная машина. Обязанности при этом те же.

К вопросу 3. Ответ. Клиент — по описанию формы и с данными, которые прислал сервер, прочитав объект из базы.

К вопросу 4. Ответ. На клиенте, в данных формы. В базе его ещё нет, и другие пользователи его не видят.

К вопросу 5. Указание. Сколько пользователей и сколько баз?

Полное решение. Клиентов много, база одна. Если бы каждый клиент считал правдой своё, два пользователя видели бы разные остатки одного товара. Сервер принимает записи от всех и держит одну версию данных для всех.

К вопросу 6. Ответ. Окно формы никуда не уходит — его строит и держит клиент. К серверу уходит обращение с данными формы, а обратно приходят описание формы и данные.

К упражнению «Два клиента». Ответ. Шаг 2: «РУЧ-01-Т» только в данных формы первого клиента. Шаг 3: второй клиент получил с сервера прежний артикул — на сервере нового значения нет. Шаг 4: после «Записать и закрыть» новое значение на сервере, в базе; второй клиент видит его, когда снова запрашивает карточку. Шаг 5: прежний артикул возвращён в базу.

К упражнению «Своё окошко». Ответ. Свободный. Пример: банкомат — клиент, банк — сервер. Между ними ходят обращения («снять пять тысяч») и ответы («разрешено, остаток такой-то»). Правда о деньгах — в банке: банкомат ничего не решает сам и не хранит.

К упражнению «Ловушка: „у нас нет сервера“». Ответ. Первая ошибка: сервер есть — это роль, и в файловой базе её выполняет та же программа на том же компьютере. Вторая: введённое не сохраняется сразу — оно остаётся в данных формы, пока не нажата «Записать».

Полное решение. Ловушка в том, что «сервер» представляется отдельным железным ящиком. Бухгалтер его не видит и делает вывод, что нет и разделения. Но окно, в котором он вводит число, и база, где число будет храниться, остаются разными сторонами и в файловой базе, — и между ними по-прежнему нужен шаг записи.

К упражнению «Где это происходит». Ответ. Окно стало шире — клиент. Строки прочитаны из базы — сервер. Буква появилась в поле — клиент. Документ записан в базу — сервер. Переключение на другое окно — клиент.

§ 0.6. Декларативность платформы: не написать действие, а задать правило

К вопросу 1. Ответ. Действием задают, что делать и когда: «в двадцать градусов включи обогреватель». Правилом — каким должен быть результат: «пусть будет двадцать два», а как этого добиться, решает устройство. Бытовой пример — термостат, свет с датчиком движения.

К вопросу 2. Ответ. Описание свойствами: что есть и как связано, без последовательности действий; способ получить результат выбирает платформа. Правила живут в палитре свойств Конфигуратора — у объектов, реквизитов, форм и их элементов.

К вопросу 3. Ответ. Любые три из: карточка товара построилась без формы в дереве — у объекта нет своих форм, платформа строит сама; кнопка выбора у поля «Контрагент» — тип реквизита, ссылка на справочник; номер поступления — свойство документа «Автонумерация»; команды в разделе — состав подсистемы; раздел «Главное» — первый раздел платформа показывает всегда.

К вопросу 4. Указание. Что тип реквизита сообщает платформе о поле?

Полное решение. Поле «Склад» из строки для ввода станет полем с кнопкой выбора и окном со списком складов, а в списке поступлений склад будет показан по имени. Форму трогать не нужно, потому что всё это — следствия одного свойства, типа реквизита: платформа строит поле по правилу, а правило поменялось.

К вопросу 5. Ответ. В свойствах реквизита, с которым поле связано: тип, проверка заполнения и другие.

К вопросу 6. Ответ. Потому что это поведение — «когда изменили одно, пересчитай другое», — а не свойство результата. Такого свойства у реквизита нет, и разработчик дописывает пересчёт в обработчике события.

К упражнению «Найдите правило». Ответ. Номер — свойство документа «Автонумерация». Поле «Артикул» — реквизит справочника: платформа строит карточку из реквизитов, когда своей формы нет. Кнопка выбора у «Склада» — тип реквизита, ссылка на справочник «Склады».

К упражнению «Своё: правила вокруг». Ответ. Свободный. Примеры: термостат — задаёте температуру, он решает, когда греть; свет с датчиком движения — задаёте «гореть, когда кто-то есть», он решает, когда включиться; стиральная машина — задаёте программу, она решает, сколько набрать воды и когда отжимать.

К упражнению «Ловушка: где спрятан код?». Ответ. Не найдёт: обработчика нет. Найдёт тип реквизита — «СправочникСсылка.Контрагенты».

Полное решение. Привычка «раз что-то происходит, значит, это кто-то запрограммировал» в 1С часто ведёт мимо. Кнопка «…» и окно выбора — следствия одного свойства, и искать их нужно в палитре свойств реквизита, а не в модуле формы. Правило «сначала ищите правило» экономит здесь часы.

К упражнению «Правило или код». Ответ. Подсветка пустого поля — правило: проверка заполнения реквизита. Подстановка цены при выборе товара — код: это поведение «при изменении товара найди цену». Поступление в разделе «Закупки» — правило: состав подсистемы. Отказ записать без склада — правило: проверка заполнения.

§ 0.7. Два режима форм: управляемые и обычные

К вопросу 1. Ответ. Обычная нарисована: элементы стоят по координатам, куда их положил разработчик. Управляемая описана свойствами — что на ней есть и с чем связано, — а раскладку считает платформа при открытии.

К вопросу 2. Ответ. Потому что её раскладкой управляет платформа, а не потому, что ею управляет пользователь.

К вопросу 3. Ответ. Обычная — только толстым клиентом. Управляемая — тонким, веб-клиентом, мобильным и толстым.

К вопросу 4. Ответ. По редактору: у обычной холст, элементы двигаются мышью; у управляемой дерево элементов и никаких координат. Ещё по свойству конфигурации «Основной режим запуска».

К вопросу 5. Ответ. В старых конфигурациях, начатых до 8.2 и не переведённых; при режиме совместимости с версией 8.1, когда управляемое приложение запрещено; при включённом свойстве «Использовать обычные формы в управляемом режиме» — тогда приложение управляемое, но в толстом клиенте работают обычные формы.

К упражнению «Найдите режим». Ответ. В «Канцтоварах» стоит «Управляемое приложение»: формы, которые мы будем делать, — управляемые, и всё, что книга говорит о правилах и раскладке, к ним относится.

К упражнению «Два описания». Ответ. Свободный. Ожидаемо: в обычной форме разработчик сам ставит поле «Артикул» в нужное место, задаёт его размер и следит, чтобы при другом размере окна ничего не наехало друг на друга. В управляемой он говорит, что на форме есть поля наименования, артикула и единицы и в каком они порядке, а размеры и расположение платформа рассчитает сама — под окно, клиент и настройки пользователя.

К упражнению «Ловушка: кто управляет». Указание. Кто в слове «управляемая» управляет — человек или программа?

Полное решение. Перепутано, кто управляет: раскладкой управляет платформа, и название про неё. Но вывод отчасти верен по другой причине: раз расположение считает платформа, она же умеет учесть настройки пользователя — скрытые колонки, их порядок и ширину. У обычной формы, нарисованной по координатам, такой свободы нет. То есть пользователь действительно получает больше власти над управляемой формой, но не потому, что она так названа.

К упражнению «Чужая форма из описания». Ответ. Это обычная форма. Сохраниться она могла в конфигурации, начатой до версии 8.2 и не переведённой на управляемые формы, или в конфигурации с режимом совместимости с 8.1.

§ 0.8. Связь с метаданными и с кодом: где здесь дерево, где здесь язык

К вопросу 1. Ответ. Дерево конфигурации — чертёж прикладной программы. Его ветки — виды объектов: справочники, документы, регистры, отчёты, обработки; внутри веток лежит то, что завёл разработчик.

К вопросу 2. Ответ. Объект конфигурации описывает целый вид: справочник «Товары» — это все товары, какие есть и будут. «Ручка шариковая» — одна запись в нём, один элемент справочника.

К вопросу 3. Ответ. Реквизит объекта — его свойство, которое хранится в базе: артикул товара, контрагент поступления. Табличная часть — таблица внутри объекта: строки товаров в поступлении.

К вопросу 4. Ответ. Реквизит — в поле, табличная часть — в таблицу со строками, стандартные команды — в кнопки вроде «Записать» и «Провести и закрыть».

К вопросу 5. Ответ. Правила — в свойствах объектов, реквизитов и форм. Код — в модулях: модуле формы, модуле объекта, общих модулях.

К вопросу 6. Указание. С чего начинается чтение любой формы?

Полное решение. Сначала заголовок формы: он называет предмет разговора — товар, поступление, справочник целиком. По предмету находят объект в дереве: справочник «Товары», документ «ПоступлениеТоваров». Внутри объекта лежит ветка «Формы», а поля формы возводятся к его реквизитам.

К упражнению «Прочитайте чертёж». Ответ. По ветке документа ожидаемо: поля «Контрагент» и «Склад» с кнопками выбора, таблица товаров с колонками «Товар», «Количество», «Цена», «Сумма», кнопки записи и проведения. Плюс то, чего в ветке реквизитов не видно: номер и дата — они есть у каждого документа.

К упражнению «Обратный путь». Ответ. В заголовке окна искали имя предмета — «Склады». Отсюда объект: справочник «Склады» в ветке «Справочники».

К упражнению «Ловушка: реквизит и поле». Ответ. Реквизит — то, что хранится; поле — то, чем это показывают. Это разные вещи, и одно бывает без другого.

Полное решение. Реквизит объекта живёт в базе и существует, даже когда его никто не смотрит. Поле — элемент формы, через который реквизит показывают пользователю. Реквизит без поля — обычное дело: разработчик может не выводить служебное значение на форму, и оно всё равно хранится и участвует в отчётах. Обратный случай — поле без реквизита — тоже бывает, но о нём книга скажет позже, когда дойдёт до элементов формы.

К упражнению «Где искать код». Ответ. Кнопка выбора у поля «Контрагент» — свойства: тип реквизита. Изменение остатка при проведении — код: процедура проведения в модуле объекта. Артикул в списке товаров — свойства: реквизит справочника и состав колонок списка. Сумма не пересчиталась — код, которого в «Канцтоварах» нет.

§ 1.1. Автогенерируемая форма: что это и когда срабатывает

Справочник «Товары» живёт в «Канцтоварах» с тех пор, как его завели по «Дереву метаданных». Форм у него нет: ветка «Формы» пуста, и никто никогда не открывал редактор форм. А список товаров открывается. Двойной щелчок по строке открывает карточку, в ней наименование, артикул, единица, кнопки записи — всё на месте. Окно есть, а в редакторе форм его никто не собирал.

За этим стоит первое правило платформы, которое мы разберём вплотную.

1. Форма, которой нет в дереве

Когда пользователь просит показать товар, платформа ищет, какую форму ему открыть. Если у объекта назначена управляемая форма нужного вида, откроется она. Если назначенной управляемой формы нет — платформа не разводит руками, а строит форму сама, по описанию объекта: берёт его реквизиты, табличные части, стандартные команды и собирает из них окно. Такую форму называют автогенерируемой, или коротко — автоформой.

Если форма не задана явно — платформа создаёт её из метаданных.

Строгая пара, как всегда, с адресом:

образ    окно, которое не собирали
         в редакторе
строго   форму строит платформа по
         описанию объекта, когда ни одна
         форма ему не назначена
где      окно редактирования объекта,
         закладка «Формы», страницы
         «Основные» и «Дополнительные»

На этих двух страницах разработчик и говорит платформе: «для элемента открывай вот эту форму, для списка — вот эту». Пока там пусто, решение остаётся за платформой.

2. Когда правило срабатывает

Правило простое, но у него есть одна неочевидная строка. Вот что откроется в тонком клиенте — а в нём работают все современные программы.

Третья строка — та самая неочевидная. Обычную форму тонкий клиент открыть не может, и вместо неё платформа строит управляемую: так описан порядок в документации платформы. Речь о конфигурациях, которые живут на управляемых формах, — только их эта книга и разбирает. Получается, что старая нарисованная форма в новом клиенте не работает, а пользователь всё равно видит окно — построенное на лету.

Отсюда важное следствие для чтения чужих конфигураций: пустая ветка «Формы» не означает, что объект нельзя открыть. Она означает ровно одно — форму для него строит платформа.

3. «Строит в момент, когда понадобилась»

Автоформа не лежит готовой. Её собирают тогда, когда она понадобилась: сервер читает описание объекта, строит из него описание формы, добавляет данные и отправляет клиенту — а тот рисует окно. Именно поэтому автоформы нет в дереве: до открытия её не существует.

Из этого следует всё остальное, что про неё нужно знать.

Автоформы нет в дереве, потому что до открытия её не существует.

4. Это не заглушка, а рабочее окно

Слово «автоматически» часто звучит как «наспех», и здесь этого оттенка нет. Автоформа — не набросок и не заглушка: через неё делают всё, ради чего объект заводили.

Вы уже пользовались автоформами всю прошлую главу, просто не знали об этом.

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

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

5. Порядок, по которому платформа выбирает форму

Формы, которые платформа откроет сама, называют основными: их указывают на странице «Основные». Дополнительные — те, что объекту тоже принадлежат, но открываются по особому требованию. Платформа перебирает их именно в этом порядке.

Правило удобно держать в голове лестницей. Пользователь просит открыть товар — платформа спускается по ступеням, пока не найдёт, что открыть.

нужна форма элемента
        │
  назначена основная? ──да──► она
        │ нет
  есть дополнительная? ─да──► она
        │ нет
  построить по описанию объекта

Важно, что лестница своя у каждого вида формы. У справочника есть форма элемента, форма списка, форма выбора — что это за виды и кто каждый из них просит, разберём сразу дальше; вопрос «назначена ли своя» задаётся про каждую отдельно. Поэтому обычное состояние живой конфигурации — смешанное: у одного объекта список нарисован, а карточка строится платформой, у другого наоборот.

6. Зачем платформе это умение

Можно спросить: почему бы не потребовать от разработчика нарисовать форму, как требуют почти везде? Ответ виден, если сравнить два порядка работы.

Три шага из пяти пропадают. Дело не только в экономии времени: пока формы нет, объект всё равно работает, и это меняет сам порядок работы. Разработчик заводит справочник, тут же запускает Предприятие, вводит десяток записей, смотрит, чего не хватает, — и правит дерево, а не форму. Форму он сделает потом и только там, где она нужна.

Есть и вторая причина, важнее первой. Автоформа строится из описания объекта, и значит, она не отстаёт от него. Добавили реквизит — он появился в окне сам. Нарисованная форма так не умеет: в ней новый реквизит нужно ставить руками, и всякий раз, когда об этом забывают, форма начинает врать — показывать не всё, что у объекта есть.

Пока формы нет, окно не отстаёт от объекта: платформа строит его заново по текущему описанию.

7. Как узнать автоформу в лицо

Различать их полезно: от этого зависит, где искать причину того, что вы видите на экране.

Самый быстрый признак — первый: посмотреть в дерево. Остальные помогают, когда дерева под рукой нет, например при разговоре с пользователем: если окно выглядит ровно как список полей подряд и в нём нет ничего, кроме стандартных кнопок, — скорее всего, его построила платформа.

8. В Конфигураторе и в Предприятии

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

1. В Конфигураторе откройте справочник «Товары» и перейдите на закладку «Формы». На странице «Основные» все поля пусты: ни формы элемента, ни формы списка, ни формы выбора.

2. Раскройте в дереве ветку «Формы» у этого справочника — она пуста. Открывать нечего: автоформу в редакторе не показать.

3. То же самое проделайте с документом «ПоступлениеТоваров».

4. Запустите Предприятие и откройте список товаров и карточку любого товара. Оба окна платформа собрала только что, в момент открытия.

Главное в одном абзаце

Форма может существовать для пользователя и не существовать в дереве конфигурации. Когда объекту не назначено ни одной формы нужного вида, платформа строит её сама — по описанию объекта, из его реквизитов, табличных частей и стандартных команд; такую форму называют автогенерируемой. В тонком клиенте она же появится и тогда, когда объекту назначена только обычная форма: открыть её тонкий клиент не умеет. Автоформа не хранится готовой — её собирают в момент открытия, и потому её нет в дереве, нельзя открыть в редакторе, нельзя добавить к ней свои реквизиты, команды и обработчики. При этом она не заглушка: почти все окна, с которыми мы работали в прошлой главе, — автоформы, и через них делается всё, ради чего объект заводили.

Платформа собрала окно из описания объекта. Но по каким правилам — что именно она берёт, в каком порядке ставит и чего не показывает никогда?

Контрольные вопросы

1. Что такое автогенерируемая форма и из чего платформа её строит?
2. Когда правило срабатывает — при каких условиях платформа строит форму сама?
3. Что откроется в тонком клиенте, если объекту назначена только обычная форма?
4. Почему автоформы нет в дереве конфигурации и почему её нельзя открыть в редакторе?
5. Чего у автоформы не может быть в принципе?
6. Почему пустая ветка «Формы» — не признак недоделанной конфигурации?

Упражнения

Найдите автоформы. Откройте в Предприятии четыре окна из прошлой главы — список товаров, карточку товара, карточку поступления, окно выбора контрагента — и для каждого скажите, есть ли у него форма в дереве. Проверьте себя в Конфигураторе.

Своё: предскажите. В конфигурацию добавили справочник «Сотрудники» с реквизитами «Должность» и «Телефон» и ни одной формы не сделали. Что увидит пользователь, открыв список сотрудников? Что он сможет с ним сделать?

Ловушка: «форму забыли». Новичок открыл чужую конфигурацию, увидел у половины справочников пустую ветку «Формы» и решил, что работа не доделана. В чём он ошибается и какой вопрос стоило задать вместо этого?

Правило по таблице. Объекту назначена управляемая форма списка, а формы элемента нет. Что откроется при щелчке по строке списка, а что — при открытии самого списка?

Ответы — в конце части.

§ 1.2. Что попадает в автогенерируемую форму: правила сборки

Откройте рядом две вещи: ветку справочника «Товары» в Конфигураторе и карточку ручки шариковой в Предприятии. Совпадение бросается в глаза — те же имена, тот же порядок. Платформа не выдумывает окно, она переписывает описание объекта в поля, таблицы и кнопки. Правила этого переписывания стоит знать: по ним читают любую автоформу и по ним же предсказывают, что увидит пользователь, ещё не открыв программу.

1. Из чего собирается окно

Источников ровно четыре, и все они лежат в дереве.

объект «Товары»           автоформа
───────────────           ─────────
стандартные реквизиты  →  поля
свои реквизиты         →  поля
табличные части        →  таблицы
стандартные команды    →  кнопки

Больше платформе брать неоткуда: своих выдумок у неё нет. Отсюда первое практическое следствие — всё на автоформе либо задано в дереве, либо следует из стандартных правил показа: кнопка календаря у даты и кнопки над таблицей — не узлы дерева, а следствие типа и вида элемента. И обратное верно: чего в дереве нет, того в окне не появится.

2. Стандартные реквизиты: то, что есть у всех

Часть реквизитов разработчик не пишет руками: их даёт объекту сама платформа. Их так и называют — стандартные реквизиты. Одни есть всегда: ссылка, пометка удаления, версия данных. Другие появляются по настройкам объекта: код и наименование — если заданы их длины, родитель — у иерархического справочника, владелец — у подчинённого. У документа стандартные свои: номер, дата, признак проведения.

Живут их настройки в окне редактирования объекта, на закладке «Данные», за кнопкой «Стандартные реквизиты».

Заведены они не от щедрости платформы. Без наименования объект нечем показать в списке и в чужом поле; без кода трудно отличить тёзок; без пометки удаления нечем сказать «этот больше не нужен», не ломая ссылки на него из старых документов. Это рабочий минимум — а что из него объекту нужно, решает разработчик.

Последние две строки объясняют вопрос, который возникает у всех: почему в карточке нет поля «Ссылка» и галочки «Пометка удаления». Они есть у объекта, но показывать их полем незачем: ссылка — это сам объект, а пометку ставят командой и видят по значку в списке.

3. Как объект показывает себя в чужом поле

Есть ещё одно правило, которое видно не в карточке товара, а в карточке поступления. Поле «Контрагент» показывает «Канцелярия Плюс» — наименование, а не код и не какой-нибудь внутренний номер. Кто это решил?

Решил справочник, у которого есть свойство основное представление: показывать его элементы по наименованию или по коду. Выбор действует везде, где этот справочник попадает в чужое поле или колонку.

Правило то же, что и с типом: автоформа ничего не выбирает сама, она читает решение из дерева. Поэтому вопрос «почему здесь показан код, а не имя» — вопрос не к форме, а к справочнику.

4. Свои реквизиты и их порядок

Дальше идут реквизиты, которые завёл разработчик, — в том порядке, в каком они стоят в дереве.

дерево                    карточка
──────                    ────────
Код                       Код
Наименование              Наименование
Родитель                  Родитель
├── Артикул            →  Артикул
└── ЕдиницаИзмерения      Единица измерения

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

5. Тип реквизита решает, как выглядит поле

Платформа не спрашивает, каким полем показать значение: вид поля следует из типа. Это то самое правило из прошлой главы, только теперь видно, как широко оно работает.

Автоформа не решает, как показать значение, — она читает это из типа.

6. Табличная часть становится таблицей

Табличная часть объекта превращается в таблицу, а её реквизиты — в колонки, всё в том же порядке дерева. Над таблицей платформа ставит свои кнопки: добавить строку, удалить, передвинуть.

ПоступлениеТоваров        карточка
──────────────────        ────────
Контрагент             →  поле
Склад                  →  поле
ТЧ «Товары»            →  таблица
├── Товар              →  колонка
├── Количество         →  колонка
├── Цена               →  колонка
└── Сумма              →  колонка

7. Чего в автоформе не бывает

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

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

Заметно это становится на объёме. У справочника с тремя реквизитами автоформа выглядит опрятно. У документа с двумя десятками полей она превращается в длинный столбец, где связанное не собрано вместе: платформа не знает, что «Склад» и «Ответственный» — про разное, а «Цена» и «Сумма» — про одно. Знает это только человек, и ровно с этого места начинается своя форма.

8. В Конфигураторе и в Предприятии

Сверим дерево и экран напрямую. Это не упражнение, а короткая проверка правил, которые мы только что назвали: проделав её один раз, дальше вы будете видеть соответствие без сверки.

1. В Конфигураторе откройте справочник «Товары» и выпишите на бумагу порядок его реквизитов.
2. В Предприятии откройте карточку любого товара и сверьте порядок полей с вашим списком. Совпало ли? Что появилось в карточке сверх выписанного?
3. Найдите в карточке поля стандартных реквизитов. Каких стандартных реквизитов на экране нет?
4. Откройте карточку поступления и сверьте с деревом документа: поля шапки, таблица, колонки. Какие кнопки стоят над таблицей?

Главное в одном абзаце

Автоформа собирается из четырёх источников, и все они лежат в дереве: стандартные реквизиты, реквизиты разработчика, табличные части и стандартные команды. Стандартные реквизиты — те, что есть у объекта сами по себе: код, наименование, родитель у иерархического справочника, номер и дата у документа; часть из них полем не показывается, потому что показывать нечего — ссылка есть сам объект, а пометку удаления видно по значку. Свои реквизиты идут в том порядке, в каком стоят в дереве, поэтому порядок в дереве — это порядок полей на экране. Как выглядит поле, решает тип реквизита: строка даёт поле ввода, булево — флажок, ссылка — поле с кнопкой выбора. Табличная часть становится таблицей, её реквизиты — колонками. И наоборот: в автоформе не бывает групп, страниц, декораций, своих команд и особого поведения — всё, что требует замысла, появляется только в форме, которую собрал человек.

Правила сборки одни, а окна у справочника разные: список не похож на карточку, а окно выбора — на список. Значит, платформа строит не одну форму, а несколько. Сколько и зачем?

Контрольные вопросы

1. Из каких четырёх источников платформа собирает автоформу?
2. Что такое стандартные реквизиты и где их настройки?
3. Почему в карточке нет поля «Ссылка» и флажка «Пометка удаления»?
4. В каком порядке идут поля в автоформе и что из этого следует для дерева?
5. Что решает, каким полем показать реквизит?
6. Чего в автоформе не бывает никогда и почему это не поломка?

Упражнения

Предскажите карточку. По ветке справочника «Склады» (у него только наименование) скажите, что будет в его автоформе элемента. Проверьте в Предприятии.

Своё: нарисуйте по дереву. Дан справочник «Сотрудники»: реквизиты «Должность» (строка), «ДатаПриёма» (дата), «Уволен» (булево), «Руководитель» (ссылка на «Сотрудники»). Нарисуйте на бумаге, как будет выглядеть его автоформа элемента: порядок полей и вид каждого.

Ловушка: поля не видно. Разработчик добавил справочнику реквизит, открыл Предприятие — поля нет. Он решил, что автоформа берёт не все реквизиты. Какие две причины вероятнее и что он должен проверить в первую очередь?

Обратный ход. Пользователь описывает окно: «сверху три поля, потом таблица с четырьмя колонками, сверху кнопки „Провести и закрыть“ и „Записать“». Что вы скажете об объекте, который за этим окном стоит?

Ответы — в конце части.

§ 1.3. Виды автогенерируемых форм: список, элемент, выбор, группа

Двойной щелчок по строке в списке товаров открывает карточку. Двойной щелчок в окне, которое открылось по кнопке «…» у поля «Контрагент», не открывает ничего — он выбирает контрагента и закрывает окно. Оба окна показывают список записей одного справочника, а ведут себя по-разному, потому что это разные формы. У одного объекта их несколько, и, пока своих форм у него нет, каждую строит платформа.

1. У одного объекта несколько лиц

Справочник — не одно окно, а набор окон под разные случаи. Разговор с пользователем каждый раз другой, и форма нужна другая.

У документа набор свой, но устроен так же: форма документа вместо формы элемента, форма списка, форма выбора.

Один объект — несколько форм: по одной на каждый способ разговора.

2. Кто просит форму

Платформа не решает, какое окно показать, — она отвечает на просьбу. Повод даёт пользователь, а просит форму то место, откуда он нажал: команда раздела, строка списка, поле другой формы.

Дальше работает лестница из первого параграфа главы, и работает она для каждого вида отдельно: назначена ли для этого вида своя форма? Если нет — платформа строит её сама. Поэтому у одного и того же справочника список может быть нарисован человеком, а карточка построена платформой.

3. Список и выбор: близнецы, но не одно

Эти два вида путают чаще всего: на экране оба показывают таблицу записей. Разница не в том, как они выглядят, а в том, чем кончаются.

Последняя строка — главная. Форма выбора всегда открыта для кого-то: её попросило поле, и она вернётся к нему с ответом. Поэтому в ней и появляется кнопка «Выбрать», которой в списке нет.

4. Иногда окно выбора не открывается вовсе

Поле ссылочного типа не всегда зовёт форму выбора. Если у справочника включён быстрый выбор и записей немного, платформа показывает их выпадающим списком прямо под полем: выбрали строку — и всё, окна не было. Быстрый выбор — свойство справочника, а не формы.

Правило то же, что и всюду в этой главе: решение принято в дереве, а форма только исполняет. И следствие то же: увидев выпадающий список там, где ждали окно, ищите причину в свойствах справочника, а не в форме документа.

5. Почему у папки своя карточка

В иерархическом справочнике папка — тоже запись, но разговор о ней другой: у группы «Бумага» нет ни артикула, ни единицы, у неё есть имя и место в иерархии. Поэтому форма группы — не укороченная карточка элемента, а самостоятельный вид формы: у неё свой состав полей, и назначают её отдельно от формы элемента.

Товары
├── Бумага          ← группа: имя, родитель
│   ├── Бумага А4   ← элемент: имя, артикул,
│   └── Бумага А3       единица
└── Письменные

Какие реквизиты достаются группе, а какие элементу, задаёт свойство самого реквизита — и это снова правило из дерева, а не решение формы.

6. Сборка у всех одна

Важно не потерять за разнообразием главное: все эти формы платформа собирает по тем же правилам, что мы разобрали. Берёт стандартные реквизиты, свои реквизиты, табличные части, стандартные команды — и раскладывает подряд.

Иначе говоря, видов форм несколько, а правило сборки одно. Отсюда и сходство автоформ во всех конфигурациях: их собирает один механизм по одному описанию.

Для читателя чужой конфигурации это подарок. Открыв незнакомую программу, вы узнаёте автоформу с первого взгляда и сразу понимаете: всё, что в ней есть, лежит в дереве, и ничего сверх этого искать не нужно. А вот встретив окно с группами, страницами и непонятной кнопкой, вы знаете, что за ним стоит человеческий замысел, — и вот его уже надо разбирать.

7. В режиме Предприятия

Откроем четыре окна подряд и назовём вид каждого — это и есть навык, ради которого параграф написан.

1. Откройте список товаров. Это форма списка: в ней много записей и есть кнопка «Создать».

2. Щёлкните дважды по «Ручка шариковая» — открылась форма элемента. Закройте её.

3. Откройте папку «Бумага» двойным щелчком. Открывшееся окно — форма группы: полей меньше, артикула нет.

4. Откройте поступление № 12 и нажмите «…» у поля «Контрагент». Это форма выбора: двойной щелчок по строке закроет окно и подставит контрагента. Нажмите «Отмена» или закройте окно, ничего не выбирая.

Главное в одном абзаце

У одного объекта не одна форма, а несколько: форма списка отвечает на вопрос «какие записи есть», форма элемента — «какова эта запись», форма выбора — «выберите одну», форма группы — «какова эта папка». Платформа не выбирает между ними: форму просит то место, откуда нажали, — команда раздела просит список, строка списка просит карточку, поле ссылочного типа просит форму выбора. Для каждого вида отдельно работает знакомая лестница: если своя форма этого вида не назначена, платформа строит её сама, поэтому у одного справочника список бывает нарисован, а карточка построена. Список и форма выбора похожи только на вид: у выбора другая задача — вернуть значение тому, кто его попросил, и потому двойной щелчок в ней выбирает, а не открывает. При всём разнообразии правило сборки одно, и собранные формы похожи во всех конфигурациях.

Пока всё складывается удачно: платформа делает лица объекта сама, и они работают. И всё же разработчики зачем-то рисуют формы руками — значит, у этого удобства где-то кончается запас. Где?

Контрольные вопросы

1. Какие виды форм бывают у справочника и на какой вопрос отвечает каждый?
2. Кто решает, какую форму открыть?
3. Чем форма выбора отличается от формы списка — не по виду, а по задаче?
4. Чем форма группы отличается от формы элемента и почему это отдельный вид, а не укороченная карточка?
5. Может ли у одного объекта список быть нарисован человеком, а карточка построена платформой? Почему?
6. Что общего у всех автоформ одного объекта?

Упражнения

Назовите вид. Откройте в Предприятии четыре окна из параграфа и для каждого скажите вслух: какой это вид формы, кто её попросил и чем она закончится.

Своё: кто просит. Для каждого действия скажите, какая форма откроется: пользователь нажал «Создать» в списке товаров; выбрал товар в строке поступления; открыл список поступлений из раздела; открыл папку в списке товаров.

Ловушка: «это тот же список». Коллега говорит: «Окно выбора — это тот же список, просто открытый в другом режиме». В чём он прав и в чём ошибается?

Обратный ход. Пользователь рассказывает: «Нажал на кнопку с тремя точками, выбрал строку двойным щелчком, окно само закрылось, и значение подставилось». Какие формы участвовали в этой истории и в каком порядке?

Ответы — в конце части.

§ 1.4. Где у платформы предел: когда автоформ перестаёт хватать

Автоформа поступления показывает всё, что у документа есть: номер, дату, контрагента, склад, таблицу товаров. Ни одного поля не забыто. И всё-таки кладовщик, оформляющий на ней по двадцать поступлений в день, через неделю придёт с просьбой «сделать под работу». Разберём, чего именно ему не хватает, — а заодно поймём, где у платформенной сборки предел.

1. Предел первый: длинный столбец

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

как строит платформа как нужно человеку
──────────────────── ──────────────────
Номер                ┌ Шапка ─────────┐
Дата                 │ Номер   Дата   │
Контрагент           │ Контрагент     │
Склад                │ Склад          │
Ответственный        └────────────────┘
Комментарий          ┌ Товары ────────┐
таблица товаров      │ таблица        │
                     └────────────────┘

Слева — как собирает платформа: всё равнозначно, всё в одну колонку. Справа — как это устроено в голове у человека: шапка отдельно, товары отдельно, и служебное внизу. Платформа так не умеет не потому, что слаба, а потому, что не знает, что «Склад» и «Ответственный» — про разное. Это знание есть только у того, кто понимает задачу.

Платформа знает, из чего состоит объект. Она не знает, что из этого важно.

2. Предел второй: ничего не объяснить

В автоформе есть поля и нет слов о них. Нельзя ни пояснить, что значит «Ответственный», ни предупредить, что цену вводят без налога, ни отделить чертой то, что заполняют всегда, от того, что заполняют изредка.

Пояснения на форме — не украшение. Каждая такая надпись снимает вопрос, который иначе задают вслух по телефону.

3. Предел третий: показывается всё

Автоформа показывает все реквизиты объекта — включая те, которые пользователю видеть незачем: служебные признаки, технические поля, реквизиты, заполняемые программой. Спрятать их нельзя: в автоформе нет способа сказать «этого не показывай».

Обратная сторона того же предела — нельзя и добавить. Если на форме нужно показать что-то, чего у объекта нет — например, остаток товара на складе рядом со строкой, — автоформа этого не сделает: она знает только объект.

4. Предел четвёртый: только стандартные действия

Кнопки автоформы — те, что платформа даёт всем: записать, провести, закрыть. Ни одного своего действия в неё не добавить.

Последняя строка особенно показательна: печатная форма — обычная потребность любой конторы, и появляется она только вместе со своей формой и своей командой.

5. Предел пятый: ничего не происходит само

Автоформа не считает и не подставляет. Ввели количество и цену — сумма осталась пустой. Выбрали товар — цена не подтянулась. Ошиблись складом — никто не переспросил.

Причину стоит назвать точно, потому что поведение бывает двух родов. То, что следует из свойств, платформа обеспечивает сама: проверка заполнения сработает и в автоформе, потому что задана у реквизита. А то, что нужно описать шагами — «когда изменили количество, умножь его на цену», — пишут кодом, в модуле формы. У автоформы нет описания в дереве, а значит, нет и модуля, который можно было бы открыть: писать некуда. Чтобы у формы появилось место для кода, её придётся сначала сделать своей.

6. Чего этот список не означает

Пределы легко прочитать как приговор: раз всего этого нет, значит, автоформа — временная мера. Это не так.

Автоформа перестаёт годиться не вообще, а для конкретной работы конкретного человека. Справочник складов, куда заглядывают раз в квартал, проживёт на автоформе всю жизнь конфигурации. Документ, который оформляют по двадцать раз в день, своей формы попросит быстро.

7. Как понять, что предел достигнут

Признаки одинаковы в любой конторе, и ни один из них не про красоту.

Своя форма нужна не тогда, когда автоформа некрасива, а тогда, когда она заставляет человека помнить лишнее.

Проверяются эти признаки не в редакторе, а разговором. Три вопроса тому, кто работает с формой каждый день: что вы делаете в ней чаще всего? где чаще всего ошибаетесь? что приходится держать в голове или подсматривать в бумажке? Ответы и есть список того, чего форме не хватает, — и он всегда короче, чем кажется со стороны.

8. В режиме Предприятия

Посмотрим на предел своими глазами — это займёт пять минут.

1. Откройте любое поступление — например, № 12 — и попробуйте заполнить его так, будто принимаете товар: выберите контрагента, склад, добавьте строку, введите количество и цену.

2. Обратите внимание на сумму в строке. Она не пересчиталась — считать некому.

3. Выпишите на бумагу, чего вам не хватило: пояснений, порядка полей, кнопок, автоматических подстановок.

4. Сохранять не нужно: закройте карточку, отказавшись от записи.

Список, который у вас получился, — это и есть заказ на свою форму. Держите его под рукой: к концу книги вы соберёте форму, которая его закрывает.

Главное в одном абзаце

Автоформа даёт полный доступ к объекту и ничего не забывает, но у неё есть пять пределов, и все они об одном: платформа знает, из чего состоит объект, и не знает, что из этого важно. Поля идут подряд, в порядке дерева, и на длинном документе превращаются в ленту; пояснить, предупредить, разделить смысловые части нечем; показывается всё подряд, а спрятать лишнее или добавить чужое нельзя; кнопки только стандартные, поэтому ни подбора, ни печатной формы; и наконец, ничего не считается и не подставляется само: поведение, которое нужно описать шагами, живёт в коде, а у автоформы модуля нет — писать некуда. Предел достигнут не тогда, когда форма некрасива, а тогда, когда она заставляет человека помнить лишнее: объяснять новичкам устно, чистить мусор в полях, писать инструкцию по заполнению.

Пределы названы. Но из этого не следует, что своя форма нужна везде, где автоформа чего-то не умеет: у своей формы есть цена. Как решать?

Контрольные вопросы

1. Почему платформа ставит поля подряд, а не группирует их по смыслу?
2. Чего нельзя сказать пользователю в автоформе?
3. Что автоформа показывает и чего не может показать?
4. Какие действия доступны в автоформе и каких в ней не бывает?
5. Почему в автоформе не пересчитывается сумма, хотя проверка заполнения работает?
6. По каким признакам видно, что автоформы перестало хватать?

Упражнения

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

Своё: разложите по пределам. Возьмите свой список и отнесите каждый пункт к одному из пяти пределов: порядок, пояснения, состав, действия, поведение.

Ловушка: «сделаем красиво». Разработчик говорит: «Автоформы уродливы, надо нарисовать свои для всех справочников». Что он упускает и какой вопрос стоит задать вместо этого?

Чужая жалоба. Кладовщик пишет: «Каждый раз спрашиваю, в какое поле писать номер накладной поставщика, и всегда забываю поставить склад». Какие пределы автоформы стоят за этой жалобой?

Ответы — в конце части.

§ 1.5. Когда оставляем автоформу, когда делаем свою

Список набрался — свой или принесённый кладовщиком: тут непонятно, здесь долго, это приходится помнить. Казалось бы, ответ очевиден — рисуем форму. Но прежде чем открывать редактор, стоит посмотреть на другую сторону сделки: у своей формы есть цена, и платят её не один раз.

1. Чем платят за свою форму

Своя форма — не рисунок, а обязательство. Её делают один раз, а живут с ней годами.

Третья строка — главная и самая обидная. Автоформа строится заново при каждом открытии и потому всегда показывает объект целиком. Своя форма собрана однажды: новый реквизит в дереве появился, а на форме его нет — и об этом узнают через полгода, когда бухгалтер спросит, куда делось поле.

Автоформа составом не отстаёт от объекта: она каждый раз собирается по дереву. Своя форма отстаёт всякий раз, когда о ней забыли.

2. Правило решения

Рабочее правило простое и опирается не на вид формы, а на работу, которую ею делают.

Границу удобно держать деревом решений.

часто ли с ней работают?
├─ редко ───────────────► автоформа
└─ часто
   что мешает?
   ├─ ничего ───────────► автоформа
   ├─ порядок, пояснения► сначала дерево
   └─ действия, расчёты► своя форма

3. Дешёвое лечение: поправить дерево

Прежде чем рисовать форму, стоит вспомнить, что автоформа — прямой снимок дерева. Многое из того, что «мешает», лечится в самом объекте, и лечение достаётся бесплатно: оно действует во всех окнах сразу.

Последняя строка — про то, что читатель уже умеет, сам того не зная: колонки, их порядок и отборы в списке пользователь настраивает себе сам, и это сохраняется.

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

4. Чего деревом чинить нельзя

Обратное тоже верно, и об этом стоит сказать прямо. Дерево описывает данные, а не экран. Заводить реквизит ради вида, менять тип ради удобства ввода, разбивать объект на два, чтобы «форма стала короче», — значит чинить не то.

Если задача про показ — её решает форма. Если про хранение — дерево. Смешивать их дорого: данные переживут не одну форму.

5. Смешанное решение — норма

Выбор не двоичный. В живой конфигурации обычное состояние такое: у документа своя форма, у его списка — автоформа; у главного справочника своя форма элемента, у служебного — ничего своего.

ПоступлениеТоваров
├── форма документа ── своя
└── форма списка ──── авто

Склады
├── форма элемента ── авто
└── форма списка ──── авто

Это не признак недоделанности, а разумная экономия: своё делают там, где на это есть причина, названная словами.

6. Как выглядит решение на словах

Полезно уметь сформулировать его в одну фразу — ту, которую не стыдно сказать заказчику и вспомнить через год.

Причина для своей формы — это предложение о работе человека, а не о внешнем виде окна.

7. Изменили объект — проверьте его формы

Из платы за свою форму следует привычка, которую стоит завести сразу, пока форм у вас ещё нет.

Искать эти формы недолго: они лежат внутри самого объекта, в его ветке «Формы». Открыли объект, поменяли — тут же посмотрели, что у него в этой ветке, и если там пусто, работа закончена: автоформа уже всё показала.

История, которая случается в каждой конторе, выглядит так. Товару добавили реквизит «Страна происхождения». В служебных справочниках, живущих на автоформах, поле появилось само. В карточке товара, для которой полгода назад сделали свою форму, не появилось. Через месяц выясняется, что страну никто не заполняет, — не потому, что не хотят, а потому, что её негде ввести.

8. В режиме Предприятия

Попробуем самое дешёвое лечение своими руками — то, для которого не нужен ни редактор форм, ни Конфигуратор.

1. Откройте список товаров и уберите из него колонку — например, код: меню «Ещё» → изменение формы или настройка списка.

2. Закройте список и откройте снова. Колонка не вернулась: настройка сохранилась за вами.

3. Верните колонку на место тем же путём.

4. Подумайте, что это значит для решения о своей форме: часть претензий пользователь способен закрыть сам, ничего не прося у разработчика.

Главное в одном абзаце

Своя форма — не рисунок, а обязательство: её собирают однажды, а сопровождают годами, и главная её особенность в том, что сама за объектом она не поспевает — добавленный реквизит нужно поставить в неё руками. Поэтому решение принимают не по виду окна, а по работе: служебный справочник живёт на автоформе всю жизнь, документ, который оформляют каждый день, своей формы просит быстро. Прежде чем открывать редактор, стоит вылечить дешёвым: порядок реквизитов, синонимы, проверку заполнения, основное представление, быстрый выбор и пользовательские настройки списка действуют во всех окнах сразу. Но чинить деревом то, что относится к показу, нельзя: данные переживут не одну форму. Обычное состояние живой конфигурации — смешанное: где-то своя форма, где-то автоформа, и у каждой своей формы есть причина, названная словами про работу человека.

Причина названа, решение принято: документу нужна своя форма. Значит, пора открыть редактор и собрать первую — и сначала разобраться, из чего вообще состоит форма изнутри.

Контрольные вопросы

1. Чем платят за свою форму, кроме времени на её сборку?
2. Почему своя форма отстаёт от объекта, а автоформа — нет?
3. По какому признаку выбирают между автоформой и своей формой?
4. Что из «мешающего» лечится деревом, а не формой? Приведите три примера.
5. Почему нельзя менять дерево ради вида формы?
6. Как звучит хорошая причина для своей формы?

Упражнения

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

Своё: три объекта. Для справочника «Склады», справочника «Товары» и документа «ПоступлениеТоваров» решите, что оставить на автоформе, и объясните каждое решение одной фразой про работу.

Ловушка: «своя форма догонит». Разработчик рассуждает: «Сделаю форму по образцу автоформы, а если в объекте что-то поменяется, форма подхватит». В чём он ошибается и чем это грозит через полгода?

Чужая причина. Заказчик пишет: «Форма поступления неудобная, переделайте». Какие три вопроса вы зададите, прежде чем открывать редактор?

Ответы — в конце части.

Ответы к части 1

Ответы собраны здесь, а не под вопросами: подсказка, увиденная сразу после вопроса, отменяет попытку вспомнить. У каждого ответа до трёх ступеней: сам ответ, указание — если ответ не дался сразу — и полное решение там, где рассуждение важнее вывода.

§ 1.1. Автогенерируемая форма: что это и когда срабатывает

К вопросу 1. Ответ. Форма, которую платформа строит сама по описанию объекта: из его реквизитов, табличных частей и стандартных команд.

К вопросу 2. Ответ. Когда объекту не назначено ни одной формы нужного вида — ни основной, ни дополнительной.

К вопросу 3. Ответ. Форма, построенная платформой. Обычную форму тонкий клиент открыть не может и строит управляемую на лету.

К вопросу 4. Указание. В какой момент автоформа появляется?

Полное решение. Автоформа не хранится: её собирают тогда, когда она понадобилась пользователю. До этого момента её не существует — значит, в дереве нечему лежать и в редакторе нечего открывать. Редактор форм правит описание, которое хранится; у автоформы такого описания нет.

К вопросу 5. Ответ. Своих реквизитов формы, своих команд и модуля с обработчиками. Всё, что в ней есть, приходит от объекта.

К вопросу 6. Ответ. Потому что объект и без своих форм полностью доступен пользователю: платформа построит окно сама. Пустая ветка означает решение, а не недоделку.

К упражнению «Найдите автоформы». Ответ. Списка товаров, карточки товара, карточки поступления и окна выбора контрагента в дереве нет — все четыре окна платформа строит сама. Окно отчёта устроено иначе: у отчёта есть своя схема, и о нём книга скажет отдельно.

К упражнению «Своё: предскажите». Ответ. Пользователь увидит список сотрудников, построенный платформой, и сможет делать в нём всё обычное: просматривать, искать, создавать сотрудника, открывать карточку с полями «Должность» и «Телефон», записывать изменения, помечать на удаление.

К упражнению «Ловушка: „форму забыли“». Ответ. Пустая ветка «Формы» означает, что формы не понадобились, а не что их забыли.

Полное решение. Ошибка в том, что отсутствие формы принято за отсутствие окна. Пока хватает того, что строит платформа, своя форма не нужна — и опытный разработчик не делает её «для порядка». Правильный вопрос звучит иначе: чего в автоформе не хватает для работы? Если ответа нет, то и форма не нужна.

К упражнению «Правило по таблице». Ответ. При открытии списка откроется назначенная управляемая форма списка. При щелчке по строке откроется форма элемента, построенная платформой: своей у объекта нет.

§ 1.2. Что попадает в автогенерируемую форму: правила сборки

К вопросу 1. Ответ. Стандартные реквизиты, реквизиты разработчика, табличные части и стандартные команды. Все четыре источника лежат в дереве.

К вопросу 2. Ответ. Реквизиты, которые есть у объекта сами по себе: код, наименование, пометка удаления, ссылка у справочника; номер, дата, признак проведения у документа. Настройки — в окне редактирования объекта, на закладке «Данные», за кнопкой «Стандартные реквизиты».

К вопросу 3. Ответ. Показывать нечего: ссылка — это сам объект, а пометку удаления ставят командой и видят по значку в списке.

К вопросу 4. Ответ. В том же порядке, в каком реквизиты стоят в дереве. Значит, порядок в дереве — это порядок полей на экране, и перестановка реквизитов меняет вид карточки у всех, кто работает с автоформой.

К вопросу 5. Ответ. Тип реквизита: строка даёт поле ввода, число — поле с выравниванием вправо, дата — поле с календарём, булево — флажок, ссылка — поле с кнопкой выбора.

К вопросу 6. Ответ. Групп, страниц, декораций, своих команд, скрытых или переставленных полей, особого поведения. Это не поломка: пока форма показывает нужное в понятном порядке, замысел человека ей не требуется.

К упражнению «Предскажите карточку». Ответ. Поля кода и наименования и стандартные кнопки записи — больше в справочнике «Склады» ничего нет.

К упражнению «Своё: нарисуйте по дереву». Ответ. Сверху код и наименование, дальше в порядке дерева: «Должность» — поле ввода, «ДатаПриёма» — поле с календарём, «Уволен» — флажок, «Руководитель» — поле с кнопкой выбора, открывающее список сотрудников. Внизу кнопки «Записать и закрыть» и «Записать».

К упражнению «Ловушка: поля не видно». Указание. Что должно случиться между правкой дерева и появлением поля у пользователя?

Полное решение. Первая причина — изменение не дошло до базы: разработчик не обновил конфигурацию базы данных либо пользователь работает в сеансе, запущенном раньше. Вторая — смотрят не туда: у объекта есть назначенная форма, и открывается она, а не автоформа; в назначенной форме новый реквизит сам не появляется. Проверять нужно в этом порядке: сначала дошло ли изменение, потом пуста ли ветка «Формы». Предположение «автоформа берёт не все реквизиты» — последнее, что стоит подозревать.

К упражнению «Обратный ход». Ответ. За окном документ: кнопка «Провести и закрыть» бывает только у документов. Три поля сверху — его реквизиты шапки, таблица с четырьмя колонками — табличная часть с четырьмя реквизитами. Скорее всего, это автоформа: групп и страниц не видно.

§ 1.3. Виды автогенерируемых форм: список, элемент, выбор, группа

К вопросу 1. Ответ. Форма списка — какие записи есть; форма элемента — какова эта запись; форма выбора — выберите одну; форма группы — какова эта папка.

К вопросу 2. Ответ. Никто не выбирает заранее: форму просит то место, откуда пользователь нажал. Команда раздела просит список, строка списка — карточку, поле ссылочного типа — форму выбора.

К вопросу 3. Ответ. Задачей. Список открывают, чтобы смотреть и искать; форма выбора открыта для того, кто её попросил, и её дело — вернуть ему одно значение и закрыться.

К вопросу 4. Ответ. У группы другой состав реквизитов: артикул и единица относятся к элементу. Поэтому форма группы — самостоятельный вид со своим составом полей, и назначают её отдельно от формы элемента, а не получают обрезкой карточки.

К вопросу 5. Ответ. Может. Лестница выбора работает для каждого вида формы отдельно: у списка своя форма назначена, у элемента нет — значит, карточку строит платформа.

К вопросу 6. Ответ. Правило сборки: все они собираются из одного описания объекта — стандартные реквизиты, свои реквизиты, табличные части, стандартные команды, порядок как в дереве, вид поля по типу.

К упражнению «Назовите вид». Ответ. Список товаров — форма списка, попросила команда раздела, закроют её вручную. Карточка ручки — форма элемента, попросила строка списка. Папка «Бумага» — форма группы. Окно контрагентов — форма выбора, попросило поле «Контрагент», закроется само, отдав значение.

К упражнению «Своё: кто просит». Ответ. «Создать» — форма элемента для новой записи. Выбор товара в строке поступления — форма выбора товаров (или выпадающий список, если включён быстрый выбор). Список поступлений из раздела — форма списка. Папка в списке товаров — форма группы.

К упражнению «Ловушка: „это тот же список“». Ответ. Прав в том, что оба окна показывают записи одного справочника и похожи на вид. Ошибается в том, что это одна форма: форма выбора — отдельный вид со своей задачей.

Полное решение. Проверяется поведением. В списке двойной щелчок открывает карточку, в форме выбора — возвращает значение и закрывает окно. В списке есть «Создать», в форме выбора — «Выбрать». И назначают их по отдельности: у объекта может быть своя форма списка и построенная платформой форма выбора.

К упражнению «Обратный ход». Ответ. Сначала была открыта форма документа — в ней поле ссылочного типа. Кнопка с тремя точками попросила форму выбора справочника. Двойной щелчок в форме выбора вернул значение полю и закрыл окно. Итого две формы: та, что просила, и та, что ответила.

§ 1.4. Где у платформы предел: когда автоформ перестаёт хватать

К вопросу 1. Ответ. Потому что она знает состав объекта и не знает, что в нём важно: «Склад» и «Ответственный» для неё одинаковые реквизиты. Смысловые группы видит только человек, понимающий задачу.

К вопросу 2. Ответ. Ничего: в автоформе нет ни надписей, ни пояснений, ни разделителей. Предупредить, что цену вводят без налога, нечем.

К вопросу 3. Ответ. Показывает все реквизиты объекта, включая служебные. Не может ни спрятать лишнее, ни показать то, чего у объекта нет, — например остаток товара рядом со строкой.

К вопросу 4. Ответ. Только стандартные: записать, провести, закрыть. Своих действий — подбора, заполнения по прошлому документу, печати — в ней не бывает.

К вопросу 5. Указание. Поведение поведению рознь: одно следует из свойства, другое нужно описать шагами.

Полное решение. Проверка заполнения задана свойством реквизита, и платформа исполняет её сама — для этого ничего писать не надо. Пересчёт суммы шагами не описан нигде: «когда изменили количество, умножь на цену» — это код, а писать его в автоформе негде: у автоформы нет описания в дереве, а значит, нет и модуля. Чтобы появилось место для кода, форму сначала делают своей.

К вопросу 6. Ответ. Одно и то же объясняют новичкам устно; в полях появляется мусор; ввод одного документа занимает минуты; заводят инструкцию «как заполнять». Все признаки — про работу, а не про красоту.

К упражнению «Соберите заказ». Ответ. Свободный. Типичный список: нет порядка полей и группировки шапки; не сказано, что вводить в «Комментарий»; видны служебные реквизиты; нет кнопки подбора товаров; сумма не считается; цена не подставляется из регистра цен.

К упражнению «Своё: разложите по пределам». Ответ. Свободный. Порядок: группировка шапки. Пояснения: подписи и предупреждения. Состав: лишние поля, отсутствие остатка. Действия: подбор, печать. Поведение: пересчёт и подстановка.

К упражнению «Ловушка: „сделаем красиво“». Ответ. Он упускает, что своя форма стоит работы и сопровождения, а красота сама по себе никому не помогает.

Полное решение. Автоформа не уродлива — она равнодушна: показывает всё в порядке дерева. Для справочника, куда заглядывают раз в квартал, этого хватает навсегда. Вопрос, который стоит задать вместо «нарисуем всем»: кому эта форма мешает работать и чем именно? Если ответа нет, своя форма добавит работы и не добавит пользы.

К упражнению «Чужая жалоба». Ответ. Два предела. «Спрашиваю, в какое поле писать номер накладной» — нечем объяснить: нет ни подписи, ни пояснения. «Забываю поставить склад» — форма не мешает ошибиться: поле не выделено, порядок полей не ведёт, а проверка заполнения у реквизита, видимо, не включена.

§ 1.5. Когда оставляем автоформу, когда делаем свою

К вопросу 1. Ответ. Сопровождением: каждое изменение объекта придётся повторить в форме. Плюс риском отстать и новым местом для логики — модулем формы, за которым тоже нужно следить.

К вопросу 2. Ответ. Автоформа строится заново при каждом открытии, по текущему описанию объекта. Своя форма собрана однажды: новый реквизит в неё нужно поставить руками.

К вопросу 3. Ответ. По работе, а не по виду окна: как часто с формой работают и что именно мешает. Служебный справочник живёт на автоформе, ежедневный документ просит своей формы.

К вопросу 4. Ответ. Порядок полей — порядком реквизитов; непонятное имя — синонимом; забытые значения — проверкой заполнения; код вместо имени — основным представлением; лишние колонки — настройкой списка у самого пользователя.

К вопросу 5. Указание. Что дерево описывает и что живёт дольше — данные или окно?

Полное решение. Дерево описывает данные, а не экран. Реквизит, заведённый ради вида формы, останется в базе у всех и навсегда; документ, разрезанный на два ради длины окна, разрежет и событие, которое на деле одно. Формы меняются чаще, чем данные, и подгонять данные под текущий вид окна — значит платить дважды.

К вопросу 6. Ответ. Она говорит о работе человека: «кладовщик оформляет двадцать документов в день и путает склад», «на документ уходит четыре минуты из-за ручного подбора». Не о красоте и не о «сделаем как у людей».

К упражнению «Разберите свой список». Ответ. Свободный. Ожидаемо: в стопку «дерево» уходят порядок полей, подписи, проверка заполнения, лишние колонки; в стопку «форма» — группы и страницы, пояснения, подбор товаров, пересчёт суммы, печать.

К упражнению «Своё: три объекта». Ответ. «Склады» — автоформа: справочник меняют раз в квартал. «Товары» — автоформа или лёгкая правка дерева: заполняют изредка, полей немного. «ПоступлениеТоваров» — своя форма: документ оформляют каждый день, нужны подбор, пересчёт и порядок полей под руку кладовщика.

К упражнению «Ловушка: „своя форма догонит“». Ответ. Не подхватит: своя форма собрана один раз и новые реквизиты сама не показывает.

Полное решение. Ошибка в слове «по образцу»: мастер заполнит форму тем, что есть у объекта сейчас, и на этом связь кончится. Через полгода в объекте появится реквизит, в форме его не будет, и никто этого не заметит — поле просто не заполняют. Поэтому у своей формы заводят привычку: изменили объект — откройте его формы и проверьте.

К упражнению «Чужая причина». Ответ. Спросить о работе, а не о внешнем виде. Что вы делаете в этой форме чаще всего? Где чаще всего ошибаетесь? Что приходится держать в голове или подсматривать в бумажке? Из ответов получится список, который можно разложить на «лечится деревом» и «требует формы».

§ 2.1. Форма как объект конфигурации: где она живёт в дереве

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

1. Чертёж и окно

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

одно описание          много окон
ФормаТовара  ──┬──►  Бумага А4
               ├──►  Ручка шариковая
               └──►  Папка-регистратор

Форма — чертёж окна, а не само окно: по одному чертежу строится сколько угодно окон.

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

Отсюда и правило чтения: когда говорят «поправь форму», речь о чертеже, и поправка отзовётся во всех окнах сразу. А когда говорят «у меня открыта форма товара», речь об окне — одном из многих, построенных по этому чертежу.

образ    форма — чертёж окна
строго   объект конфигурации с именем
         и описанием
адрес    ветка «Формы» внутри объекта

2. Что лежит внутри формы

Объект «форма» хранит не картинку, а несколько списков и модуль. Списки отвечают на разные вопросы, и разделены они не случайно.

Оговорюсь сразу: это части описания формы, а не части окна. Две строки в таблице стоят особняком даже среди них. Параметры — не часть окна, а его вход: то, что форма получает в момент открытия, ещё до того, как окно появилось. Модуль — не описание, а действие: остальные части рассказывают, каким быть окну, а он говорит, что делать в ответ на нажатие. В этой книге мы модуль не пишем — знаем, что он есть и где лежит.

Первая же строка требует оговорки, которую придётся повторить не раз. Реквизит формы — не то же самое, что реквизит объекта. Артикул товара — реквизит объекта: он задан справочнику и хранится в базе. А флажок «показывать подробности», который нужен, пока окно открыто, и никуда не записывается, — реквизит формы. Первые заданы в ветке объекта, вторые — внутри формы, и разбираться с ними будем в следующей главе книги.

3. У каждой формы один хозяин

Форма не висит в воздухе: она принадлежит объекту и лежит в его ветке. Поэтому полное имя формы всегда двойное — чей объект и какая форма.

Справочники
├── Товары
│   └── Формы
│       └── ФормаЭлемента   ← форма товара
└── Контрагенты
    └── Формы
        └── ФормаЭлемента   ← другая форма

Это две разные формы, просто с совпадающими именами, и друг другу они не мешают: имя формы уникально внутри своего объекта, а не во всей конфигурации. Имена от этого получаются короткими, но разговор требует точности. «Открой форму элемента» без указания объекта не адресует ничего.

Форма принадлежит одному объекту. Имя формы имеет смысл только вместе с именем хозяина.

4. Общая форма: окно без предметного хозяина

У правила есть исключение, и оно честное: пометим его сейчас, а развернём в главе об особых формах. Если окно не про один объект — настройки программы, служебный диалог, — привязывать его к справочнику незачем. Такие формы лежат отдельно.

Общие
└── Общие формы
    └── НастройкиПрограммы

Устроена общая форма из тех же частей: те же списки, тот же модуль. Разница в том, что предметного хозяина у неё нет, а значит, нет и объекта, который подставился бы в неё сам: данные попадают в такую форму только через параметры и собственные реквизиты формы. Особые формы — тема отдельной главы ближе к концу книги; пока достаточно знать, что ветка такая есть и что попадают в неё по причине, а не по привычке.

5. Имя и синоним: адрес и подпись

У формы, как у всякого объекта конфигурации, есть имя и есть синоним. Имя — служебное: по нему на форму ссылаются настройки и код. Синоним — человеческое название, его видит тот, кто выбирает форму из списка форм.

Заголовок окна к этой паре отношения не имеет: его платформа складывает из представления объекта-хозяина — то есть из того, как объект называет себя пользователю; обычно это его синоним. Так что имя формы в заголовке не появится, какое бы имя ей ни дали.

6. Вид формы — не имя формы

Здесь спотыкаются почти все. Виды форм — элемента, списка, выбора, группы — мы разобрали в прошлой главе. Кажется, что вид задаётся именем: назвал форму «ФормаЭлемента» — получил форму элемента. Это не так.

Форму можно назвать «Карточка», «ФормаТовара» или «Ф1» — видом элемента она станет тогда, когда справочник укажет её как свою основную форму элемента. Имя — это адрес, по которому форму находят; назначение — решение хозяина, кем эта форма ему приходится. Как объект указывает на форму, разберём дальше в этой главе.

Имя формы не делает её формой элемента. Вид назначает объект, а не название.

7. В Конфигураторе

Три коротких обхода. Ничего не создаём и не меняем — только читаем дерево.

1. Раскройте справочник «Товары» и найдите ветку «Формы». Она пуста — мы это уже видели. Сделайте то же для справочника «Контрагенты» и документа «ПоступлениеТоваров»: пусто везде.

2. Откройте свойства справочника «Товары» и найдите группу свойств, где указываются основные формы объекта. Поля пустые — это они связывают объект с формой.

3. Найдите в дереве ветку «Общие» и в ней «Общие формы». Она тоже пуста. Запомните адрес: когда встретите окно, которое не про один объект, искать его форму нужно здесь.

Вывод из обхода неожиданный только на первый взгляд: в нашей конфигурации не задано ни одной формы — и она полностью работает, потому что окна строит платформа. В типовых конфигурациях всё наоборот: формы заданы почти везде, и читать их мы научимся. Первую форму в этом дереве создадим мы.

Главное в одном абзаце

Форма в дереве конфигурации — не окно, а его чертёж: по одному описанию платформа строит столько окон, сколько понадобится, и правка чертежа отзывается во всех сразу. Внутри формы лежат списки — реквизиты формы, элементы, команды, параметры — и модуль; реквизиты формы не путать с реквизитами объекта: первые нужны, пока открыто окно, вторые хранятся в базе. Каждая форма принадлежит одному объекту и лежит в его ветке «Формы», поэтому имя формы имеет смысл только вместе с именем хозяина, а одинаковые имена у разных объектов друг другу не мешают; формы, которые не про один объект, лежат отдельно, в общих формах. Имя — это адрес, по которому форму находят; кем форма приходится объекту — формой элемента, списка, выбора, — решает не имя, а ссылка из свойств самого объекта.

Ветка «Формы» пуста, и мы знаем, что в ней должно появиться: объект с именем, списками и модулем. Составлять эти списки с нуля, поле за полем, — работа на полдня. А нельзя ли получить основу формы сразу готовой?

Контрольные вопросы

1. Чем форма в дереве отличается от окна на экране?
2. Из каких частей состоит объект-форма и на какой вопрос отвечает каждая?
3. Почему у справочника «Товары» и у справочника «Контрагенты» формы могут называться одинаково?
4. Что задаёт имя формы, а что — назначение формы? Где живёт каждое решение?
5. Чем реквизит формы отличается от реквизита объекта?
6. В каком случае форма попадает в общие формы, а не в ветку объекта?
7. Почему наша конфигурация работает, хотя ни одной заданной формы в ней нет?

Упражнения

Прочтите дерево. Пройдите по «Канцтоварам» и выпишите, у каких объектов есть ветка «Формы». Для каждого скажите, что означает пустая ветка.

Своё: назовите хозяина. Коллега говорит: «открой форму списка», «поправь форму элемента», «в форме выбора нет кнопки». Для каждой фразы скажите, какого уточнения не хватает, чтобы понять, о чём речь.

Ловушка: «назвал — значит сделал». Разработчик создал у справочника «Товары» форму с именем «ФормаСписка» и говорит: «теперь список товаров открывается моей формой». Прав ли он и что проверить в первую очередь?

Обратный ход. В чужой конфигурации у документа в ветке «Формы» лежат три формы, а в свойствах документа указана как основная только одна. Что это означает и где искать две остальные в работе программы?

На чтение. В дереве встретилась форма в ветке «Общие формы». Какие выводы о ней можно сделать сразу, ещё не открыв её в редакторе?

Ответы — в конце части.

§ 2.2. Конструктор формы: первое знакомство

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

1. Конструктор приходит сам

Инструмент, который собирает форму, называется конструктором формы. Его не нужно искать в меню: при создании формы он вызывается автоматически. Добраться до создания можно двумя дорогами — обе ведут в одно место.

Инструмент один, но ведёт себя по-разному: конструктор читает, какие виды форм свойственны этому объекту, и лишнего не показывает. Оттого документация платформы и говорит о конструкторе форм справочника, конструкторе формы документа, конструкторе формы регистра сведений — по объекту, для которого он вызван.

Конструктор предлагает не всё подряд, а только то, что свойственно этому объекту: набор видов форм читается из его описания.

2. Первый вопрос: какая это форма

Конструктор начинает с того, о чём мы говорили в прошлой главе, — с вида формы. Справочнику он предлагает шесть вариантов.

Выбор здесь не про внешность, а про разговор: мы говорим конструктору, о чём будет окно, и он раскладывает содержимое под этот разговор. Последняя строка — для случая, когда готовая раскладка мешает: произвольная форма приходит пустой, и всё, что в ней появится, положите туда вы.

У документа набор короче — формы документа, списка, выбора и произвольная: папок у документов не бывает, а значит, нет и форм группы. Набор, как видите, не выдуман конструктором, а прочитан по объекту.

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

3. Откуда конструктор берёт содержимое

А берёт он его оттуда же, откуда его берёт платформа, когда строит автоформу: из описания объекта. Реквизиты, табличные части, стандартные команды — всё раскладывается по тем же правилам, которые мы разобрали в прошлой главе.

дерево объекта ──► конструктор ──► форма
   реквизиты          один раз       лежит
   табличные                         в дереве
   части

Отсюда главное свойство первой своей формы: она начинается как снимок автоформы. Не «почти такая же» — та же самая, только записанная в дерево и отданная вам в руки. Строго это значит вот что: конструктор заполняет реквизиты формы и элементы по тем же правилам, по которым платформа строит автоформу, — и в редакторе обе эти вкладки открываются уже не пустыми.

Своя форма начинается там, где автоформа заканчивается: конструктор снимает с объекта тот же снимок и кладёт его в дерево.

И сразу следствие, о котором мы говорили, когда взвешивали цену своей формы. Снимок сделан один раз. Добавите завтра объекту реквизит — всё, что платформа строит сама, покажет его сразу, а эта форма не покажет: она уже не строится заново, она хранится. Пока форма не назначена объекту, автоформа того же вида тоже продолжает строиться — и новый реквизит в ней появится.

4. Остальные вопросы

Кроме вида формы конструктор спрашивает немного.

Две строки требуют пояснения. Отметка «Назначить форму основной» — это ровно та ссылка из свойств объекта, о которой шла речь в прошлом параграфе: поставили её — справочник начал указывать на нашу форму. Конструктор предлагает сделать это заодно; мы отметку снимем и назначим форму руками — чтобы увидеть своими глазами, что создание формы и её назначение объекту два разных действия, а не одно.

А «Далее» ведёт на второй шаг, где выбирают состав реквизитов, число колонок и вид каждого поля. Нам туда рано: сейчас важно увидеть раскладку по умолчанию, а не спорить с ней. Нажимаем «Готово» — конструктор размещает элементы сам и открывает форму.

5. Чего конструктор не делает

Соблазн считать конструктор умным велик, а список его отказов короткий и полезный.

Последняя строка стоит отдельного слова. Создав форму элемента, вы не отменили автоформы списка, выбора и группы: для них ничего не изменилось, платформа по-прежнему строит их сама. Своя форма занимает ровно одно место в разговоре — то, на которое её поставили.

6. В Конфигураторе

Создаём первую форму. Это первое изменение конфигурации в книге — до сих пор мы только читали дерево.

1. В дереве конфигурации раскройте справочник «Товары», встаньте на ветку «Формы» и добавьте форму. Конструктор откроется сам.

2. Выберите вид «Форма элемента справочника». Имя, синоним и комментарий оставьте предложенные.

3. Снимите отметку «Назначить форму основной» — назначать будем отдельно.

4. Нажмите «Готово». Откроется редактор формы — пока просто посмотрите на него и ничего не меняйте.

5. Вернитесь к дереву: ветка «Формы» у справочника «Товары» больше не пуста.

Теперь проверьте, что изменилось для пользователя. Запустите Предприятие и откройте карточку любого товара. Если Предприятие попросит обновиться — обновитесь; почему это вообще требуется, разберём дальше в этой главе. Она открылась ровно такой же, как раньше, — потому что справочник на нашу форму пока не ссылается. Форма есть, а разговор идёт по-прежнему через автоформу.

Главное в одном абзаце

Форму собирает конструктор, и вызывать его не нужно — он открывается сам, как только объекту добавляют форму, и предлагает только те виды форм, которые этому объекту свойственны, вплоть до произвольной — пустой. Первый вопрос конструктора — какая это форма: элемента, списка, выбора, группы, — и это вопрос не о внешности, а о том, про что будет разговор. Содержимое конструктор берёт из описания объекта по тем же правилам, по которым платформа строит автоформу, поэтому первая своя форма — это снимок автоформы, положенный в дерево; снимок сделан один раз, и дальше форма за объектом не следует. Остальные вопросы конструктора — имя, синоним и отметка «назначить основной»; последняя ставит ту самую ссылку из свойств объекта, и создание формы и её назначение — два разных действия. Пока форма не назначена, пользователь её не увидит: платформа продолжает строить автоформу.

Форма в дереве есть, и редактор открыт. На экране несколько панелей, дерево элементов и превью окна — всё это надо научиться читать. С чего начать?

Контрольные вопросы

1. Как вызывается конструктор формы и почему его не ищут в меню?
2. Почему у справочника и у документа конструкторы разные?
3. О чём на самом деле спрашивает конструктор, предлагая выбрать вид формы?
4. Откуда конструктор берёт содержимое будущей формы?
5. Почему первую свою форму называют снимком автоформы и чем это обернётся через полгода?
6. Что делает отметка «назначить форму основной» и почему мы её сняли?
7. Мы создали форму элемента. Что изменилось для формы списка того же справочника?

Упражнения

По образцу. Создайте в «Канцтоварах» форму элемента для справочника «Контрагенты» — тем же порядком, не назначая её основной. Проверьте в Предприятии, что карточка контрагента открывается по-прежнему.

Своё: предскажите набор. Прежде чем открывать конструктор для документа «ПоступлениеТоваров», выпишите, какие виды форм он предложит и что окажется в форме документа. Потом откройте и сверьте.

Ловушка: «форма создана — дело сделано». Разработчик создал форму элемента для справочника и отчитался: «карточку переделал». Пользователь говорит, что ничего не изменилось. Оба правы — объясните, что произошло.

Обратный ход. В чужой конфигурации форма справочника показывает поля не в том порядке, в каком они идут в дереве объекта. Что это говорит о её истории?

На чтение. Объекту год назад добавили реквизит. В форме списка он виден, в форме элемента — нет. Что из этого следует про обе формы?

Ответы — в конце части.

§ 2.3. Редактор формы: три области и предпросмотр

Начать стоит с того, что это не одно окно, а шесть редакторов, сложенных в одно. Каждый занимается своей частью формы — теми самыми списками, которые мы перечисляли, — и переключаются они закладками. Плюс снизу набросок будущего окна. Разберём, кто за что отвечает, и заведём привычку читать форму именно отсюда.

1. Шесть редакторов в одном окне

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

В нижней части окна — форма в режиме предварительного просмотра: набросок того, что увидит пользователь. Он показывает раскладку — где встанет элемент, — но не работу: значения реквизитов не заполнены, обработчики не выполняются. Зато сразу видно, куда попадёт поле, которое вы только что перетащили.

Редактор формы — не рисовалка окна, а шесть списков плюс набросок. Окно получается из списков, а не наоборот.

2. Три вопроса, на которые отвечает форма

Из шести редакторов три несут главную нагрузку, и держать в голове надо именно их. Проще всего запомнить как три вопроса об одном разговоре.

реквизиты   о чём говорим  ← данные
элементы    что видно      ← окно
команды     что можно      ← действия

Порядок здесь не случаен. Данные первичны: элемент, которому нечего показывать, бессмыслен, а команда, которой нечего делать, бесполезна. Поэтому и читают форму в этом порядке, и собирают её так же.

Остальные три редактора в этой главе только назовём. Командный интерфейс формы — тема главы о командах; параметры — разговор об открытии формы; модуль мы не пишем вовсе.

3. Реквизиты: чем форма располагает

Здесь перечислено то, что форма держит у себя, пока открыта. После конструктора список не пуст: в нём уже есть строка, которую мы не заводили, — через неё форма и связана с товаром. Как она устроена, разберём в следующей главе, здесь достаточно увидеть, что она есть.

Важно не потерять различение, о котором мы условились. В этом редакторе живут реквизиты формы. Реквизиты объекта — артикул, единица — заданы в дереве справочника, и форма получает их не отсюда.

4. Элементы: из чего сложено окно

Структура окна — иерархическая, и корень у неё один: элемент «Форма». Всё остальное вложено в него.

Форма
├── Наименование          ← поле
├── Артикул               ← поле
├── Группа «Учёт»         ← группа
│   └── ЕдиницаИзмерения  ← поле
└── Записать              ← кнопка

Виды элементов немногочисленны: группа, поле, таблица, кнопка, декорация. За каждым — своя роль: группа собирает, поле показывает данные, таблица показывает их строками, кнопка запускает действие, декорация не делает ничего, кроме подписи или картинки.

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

Поле не «показывает реквизит» по случайности: его либо перетащили из реквизитов, либо добавили и указали, откуда брать данные.

5. Команды: что форма умеет

Редактор команд перечисляет действия. А вот где эти действия увидит пользователь, решается в другом месте — и путей к экрану у команды два.

Отсюда понятная ловушка: команда объявлена, кнопки не видно — и ошибки в этом нет, её просто никуда не вынесли. И обратный случай: кнопка на форме есть, а в списке команд формы соответствующей строки нет — за такой кнопкой стоит стандартная команда, которую форма не объявляла, а получила от объекта.

6. Палитра свойств: где живут настройки

Списки отвечают на вопрос «что есть», а на вопрос «как себя ведёт» отвечает палитра свойств: выделили элемент — справа его свойства. Выделили корневой элемент «Форма» — увидели свойства самой формы.

Правило то же, что и во всей книге: если что-то ведёт себя не так, как ждали, ищите заданное правило. В редакторе форм оно почти всегда в палитре свойств — у элемента, у реквизита или у самой формы.

7. В Конфигураторе

Открываем форму, созданную в прошлом параграфе, и обходим её.

1. Пройдите по закладкам и назовите вслух, чем занят каждый редактор. Шесть названий — хватит одного круга, чтобы они улеглись.

2. В редакторе элементов раскройте структуру и найдите корневой элемент «Форма». Выделите его и посмотрите палитру свойств: это свойства всей формы.

3. Выделите поле наименования и сравните его свойства со свойствами формы — набор другой, потому что и предмет другой.

4. Посмотрите на предпросмотр внизу и сравните с карточкой товара в Предприятии. Отличия есть, и они ожидаемы: предпросмотр показывает раскладку, а не работу.

Ничего не меняйте: цель обхода — научиться смотреть, а не править.

Главное в одном абзаце

Редактор формы — это шесть редакторов в одном окне: элементов, командного интерфейса, реквизитов, команд, параметров и модуля, а внизу набросок будущего окна, который показывает раскладку, но не работу. Главную нагрузку несут три: реквизиты отвечают на вопрос «о чём говорим», элементы — «что видно», команды — «что можно сделать», и читать форму стоит в этом порядке, потому что элемент без данных пуст, а команда без дела бесполезна. Структура элементов иерархическая, её корень — элемент «Форма», а виды элементов немногочисленны: группа, поле, таблица, кнопка, декорация. Поле появляется из реквизита — перетаскиванием или указанием, откуда брать данные, — и это тот жест, которым окно связывается с данными. К пользователю команда попадает двумя путями: кнопкой в структуре окна или через редактор командного интерфейса формы. А на вопрос «как себя ведёт» отвечают не списки, а палитра свойств: у элемента, у реквизита или у самой формы.

Читать форму мы научились, и форма в дереве лежит. Пользователь между тем по-прежнему видит автоформу — справочник о нашей работе не знает. Чем именно ему об этом сообщают?

Контрольные вопросы

1. Почему редактор формы называют группой редакторов, а не одним окном?
2. На какие три вопроса отвечают реквизиты, элементы и команды?
3. Почему форму читают именно в этом порядке, а не наоборот?
4. Что показывает предпросмотр внизу и чего он не показывает?
5. Какой элемент стоит в корне структуры и что означают его свойства?
6. Чем отличается вопрос «есть ли такое действие» от вопроса «видно ли оно»?
7. Где искать ответ на вопрос «почему этот элемент ведёт себя так»?

Упражнения

По образцу. Пройдите по шести закладкам формы товара и для каждой скажите одной фразой, на какой вопрос она отвечает.

Своё: три вопроса к чужому окну. Возьмите любое окно в Предприятии и задайте ему три вопроса — о чём, что видно, что можно. Ответы, которые вы знаете, отметьте; остальные оставьте на потом.

Ловушка: «нарисую окно и заполню». Разработчик собирается сначала разложить поля, а потом придумать, откуда они берут значения. Почему из этого выйдет лишняя работа?

Обратный ход. В форме есть кнопка, но в редакторе команд нужного действия не видно. Какие объяснения этому возможны?

На чтение. В структуре элементов чужой формы вы видите группу, в ней три поля и таблицу, а рядом — декорацию. Что из этого показывает данные, а что нет?

Ответы — в конце части.

§ 2.4. Назначение формы объекту

Сообщают одной строкой в свойствах объекта. Справочник хранит список того, чем он отвечает на каждый повод: вот этой формой — на открытие карточки, вот этой — на открытие списка. Пока строка пуста, повод обрабатывает платформа. Как только в ней появилось имя формы, отвечать начинает она.

1. Где живёт назначение

Адрес точный, и запомнить его стоит: окно редактирования объекта, закладка «Формы», группа свойств «Основные формы». Там по строке на каждый вид действия.

Справочник «Товары»
└── Формы (закладка)
    └── Основные формы
        ├── элемента ─── ФормаЭлемента
        ├── группы   ─── (пусто)
        ├── списка   ─── (пусто)
        └── выбора   ─── (пусто)

Обратите внимание, где это лежит: в свойствах объекта, а не формы. Годится ли форма на эту роль, видно по её устройству — по тому, чем она в себе распоряжается; об этом вся следующая глава. Но выбор делает хозяин: форма не назначает себя сама.

Пригодность формы определяет её устройство, а выбор — объект. Два разных решения, и принимают их в разных местах.

2. Что значит «основная»

Слово выбрано точно. Основная — та, которую платформа откроет, если при вызове не сказано, какую именно открыть. А сказать можно: команда или код умеют потребовать конкретную форму по имени.

Соберём эти случаи в одну лестницу — но сначала следствие, которое удивляет: форм одного вида у объекта может быть несколько. Основной будет одна, остальные открываются явным вызовом — из команды, из другой формы. Пустая строка «Основная форма списка» при трёх формах списка в ветке — не ошибка, а решение: ни одна из трёх сама не откроется, а двойной щелчок по-прежнему приведёт к форме, построенной платформой.

3. Лестница, у которой теперь видно оба конца

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

1. основная форма этого вида назначена?
   да  → открываем её
   нет ↓
2. платформа строит форму сама

Ступеней ровно две, и для объектов, о которых идёт речь в этой книге — справочников, документов, — вторая срабатывает без исключений. Поэтому не бывает так, что окно не открылось, раз форму забыли назначить: не назначили — построит платформа. Назначение меняет не наличие окна, а его содержание.

4. Чего назначение не делает

Три отказа, за которые потом благодарят.

Назначение не меняет саму форму. Она как лежала в дереве, так и лежит: её содержимое не пересобирается и не сверяется с объектом. Тот снимок, который сделал конструктор при создании формы, остаётся ровно таким, каким был.

Назначение не запрещает остальные формы. Другие формы того же вида по-прежнему открываются — просто их надо позвать по имени.

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

Назначить — значит ответить на вопрос «что открывать по умолчанию». Ни на один другой вопрос это не отвечает.

5. Почему пользователь не видит изменений сразу

Строку в свойствах мы поменяли в Конфигураторе — то есть в описании программы. Пользователь работает не с описанием, а с базой данных, и между ними есть шаг: конфигурацию базы данных нужно обновить. Пока он не сделан, в Предприятии по-прежнему старое поведение.

Это тот же порядок, о котором мы говорили в самом начале книги, и он не особенность форм: так доходит до пользователя любое изменение конфигурации.

6. В Конфигураторе

Назначаем нашу форму элемента — ту, которую собрал конструктор.

1. Откройте окно редактирования справочника «Товары» и перейдите на закладку «Формы».

2. В группе «Основные формы» в строке формы элемента выберите нашу форму. Остальные строки не трогайте — там по-прежнему пусто.

3. Обновите конфигурацию базы данных и запустите Предприятие.

4. Откройте карточку любого товара. Теперь её строит не платформа, а наша форма.

5. Откройте список товаров. Он остался прежним: своей формы списка мы не назначали.

Проверьте себя одним вопросом: что изменится, если сейчас очистить строку основной формы элемента? Ответ должен даваться без запуска.

Главное в одном абзаце

Назначение формы живёт в свойствах объекта — в окне его редактирования, на закладке «Формы», в группе «Основные формы», по строке на каждый вид действия: годится ли форма на роль, видно по её устройству, а выбирает хозяин. Основная — это та, которую платформа откроет, когда при вызове не сказано, какую именно открывать; форм одного вида у объекта может быть несколько, но основная одна, а остальные открываются явным вызовом. Лестница выбора теперь видна целиком: назначена основная — откроется она, не назначена — платформа построит форму сама, и у справочников и документов второй ступени достаточно, чтобы окно открылось в любом случае. Назначение не меняет саму форму, не запрещает остальные и не отменяет автоформы других видов. А до пользователя изменение доходит не сразу: сначала обновляют конфигурацию базы данных, и только потом Предприятие показывает новое окно.

Карточка товара открывается теперь нашей формой — и выглядит точно так же, как раньше. Это не осечка: мы ведь ничего в ней не меняли. Но раз окно наше, стоит рассмотреть, что именно мы получили.

Контрольные вопросы

1. Где задаётся назначение формы и почему именно там, а не в самой форме?
2. Что означает слово «основная» в названии свойства?
3. Может ли у объекта быть несколько форм одного вида? Что тогда откроется двойным щелчком?
4. Из каких ступеней состоит выбор формы и почему окно открывается в любом случае?
5. Что назначение не меняет — назовите три вещи.
6. Почему после назначения пользователь не сразу видит новое окно?
7. Мы назначили форму элемента. Что теперь откроется по команде раздела «Товары»?

Упражнения

По образцу. Форму элемента для «Контрагентов» вы делали упражнением раньше; если её нет, соберите так же. Назначьте её основной и проверьте в Предприятии, что карточка контрагента открывается ею. Список не трогайте.

Своё: предскажите экран. В справочнике назначена основная форма списка, но не назначена форма элемента. Опишите, что увидит пользователь, открыв список и щёлкнув по строке.

Ловушка: «форма не работает». Разработчик назначил форму, сохранил конфигурацию и говорит: «в Предприятии всё по-старому, форма не работает». Что он пропустил и в каком порядке это проверять?

Обратный ход. В чужой конфигурации у справочника четыре формы, а в группе «Основные формы» заполнена одна строка. Что это говорит о трёх остальных?

На чтение. Строку основной формы элемента очистили, форму из дерева не удаляли. Что изменится для пользователя и что останется как было?

Ответы — в конце части.

§ 2.5. Запуск в Предприятии: видим то, что собрали

Открываем карточку — и не находим ни одного отличия. Те же поля, в том же порядке, те же кнопки. Первое чувство обманчиво: кажется, что работа пропала зря. На самом деле мы получили доказательство, ради которого стоило пройти весь путь.

1. Совпадение — это результат

Конструктор собрал форму из того же описания объекта, по которому платформа строит автоформу, и теми же правилами. Потому и результат тот же: будь карточка заметно другой, это значило бы, что где-то по дороге что-то потерялось или прибавилось.

Первая своя форма и должна выглядеть как автоформа. Отличия начнутся там, где мы их сделаем сами.

2. Что всё-таки изменилось

Изменилось не окно, а то, откуда оно берётся, — и из этого следуют два разных последствия. Одно приятное, другое нет.

было:  объект ──► платформа строит ──► окно
стало: объект ──► наша форма       ──► окно
                  (лежит в дереве)

Приятное: теперь окно можно менять. Убрать поле, собрать поля в группу, поменять заголовок — всё это стало возможным ровно в ту минуту, когда форма появилась в дереве.

Неприятное: окно больше не следует за объектом. Добавите справочнику реквизит — в карточке он сам не появится, потому что карточка теперь берётся из нашей формы. А список, своей формы не имеющий, платформа построит заново при следующем открытии, и новый реквизит там будет. Разница не между карточкой и списком: она между формой заданной и формой, которую строят каждый раз.

3. Как отличить назначенную форму от автоформы

Это вопрос читателя чужих конфигураций, и честный ответ неожиданный: глядя на одно окно — почти никак. Пока форму не трогали, она выглядит как автоформа, потому что ею и была.

Последняя строка и есть главная. Отсутствие странностей не означает, что формы нет: она может быть и нетронутой. Точный ответ даёт строка основных форм объекта — там видно, какая форма открывается для каждого вида. Одна лишь ветка «Формы» не ответ: форма может в ней лежать и не быть назначенной ни на что.

На экране видно, что форму правили. Открывается ли она — видно в строке основных форм, и больше нигде.

4. Круг, который придётся пройти много раз

Путь правки до пользователя мы уже знаем: описание меняют в Конфигураторе, а работает пользователь с базой. Теперь он становится рабочим кругом, и ходить по нему предстоит столько раз, сколько будет правок.

редактор формы ──► обновить конфигурацию
                   базы данных ──► Предприятие

Пропускают в нём всегда одно и то же — средний шаг, и выглядит это одинаково: «я же поменял, а ничего не изменилось». Привыкать стоит сейчас, пока правки маленькие и проверять их легко.

5. В режиме Предприятия и обратно

Сделаем маленькую правку и проведём её до экрана — весь цикл целиком.

1. Откройте карточку товара в Предприятии и запомните порядок полей.

2. Вернитесь в Конфигуратор, откройте нашу форму и поменяйте местами два поля в структуре элементов.

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

4. Откройте карточку снова: порядок изменился. Это первая правка формы, которая дошла до пользователя.

5. Откройте список товаров и убедитесь, что в нём ничего не менялось: он по-прежнему строится платформой.

Верните порядок полей обратно, когда посмотрите: дальше книга исходит из того, что форма осталась такой, какой её собрал конструктор.

Главное в одном абзаце

Назначенная форма открывается неотличимо от автоформы, и это не осечка, а доказательство: конструктор снял с объекта точный снимок. Изменилось не окно, а его источник — и отсюда два следствия: окно теперь можно менять, но оно больше не следует за объектом, так что новый реквизит в нём сам не появится. Отличить назначенную форму от автоформы по одному экрану почти невозможно: странности в раскладке говорят, что форму правили, но их отсутствие не говорит ни о чём — точный ответ даёт дерево. И у каждой правки формы один и тот же путь: редактор, обновление конфигурации базы данных, Предприятие; пропущенный средний шаг выглядит как «ничего не изменилось».

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

Контрольные вопросы

1. Почему совпадение нашей формы с автоформой — правильный результат?
2. Что изменилось после назначения, если окно осталось прежним?
3. Какое следствие у того, что форма хранится, а не строится заново?
4. Можно ли, глядя на окно, сказать, что у объекта есть своя форма?
5. О чём говорит необычный порядок полей в чужой форме?
6. Какой путь проходит правка формы до пользователя?
7. Мы поменяли порядок полей в форме элемента. Что произойдёт со списком?

Упражнения

По образцу. Проведите весь цикл на «Контрагентах»: правка в редакторе, обновление конфигурации базы данных, проверка в Предприятии.

Своё: предскажите последствие. Справочнику «Товары» добавили реквизит «Вес». Опишите, что увидит пользователь в карточке товара и что — в списке. Объясните разницу.

Ловушка: «форма сломалась». Коллега говорит: «после того как я добавил реквизит, форма сломалась — поля нет». Что на самом деле произошло и что нужно сделать?

Обратный ход. В чужой конфигурации карточка справочника выглядит ровно так, как выглядела бы автоформа. Что из этого следует и как проверить наверняка?

На чтение. В одной конфигурации у справочника поля собраны в две группы, а у соседнего справочника идут подряд. Что можно сказать о каждой из двух форм?

Ответы — в конце части.

§ 2.6. Чужая форма: разбор по трём областям

Начинать надо не с окна. Окно — это результат, а разбор начинается с вопроса, откуда результат взялся: чья это форма, назначена ли она и есть ли у объекта другие. Порядок разбора один и тот же, и в этом параграфе мы его закрепим — он пригодится в каждой следующей главе.

1. Сначала дерево, потом окно

Три вопроса, которые задают до того, как разглядывать поля.

Ответы на них меняют всё дальнейшее чтение. Форма, которая не назначена, может оказаться заброшенной или вызываться из кода. Форма, лежащая в общих формах, объекту не принадлежит: сам собой он в неё не подставится, и данные попадают туда явно — параметрами при открытии или через реквизиты формы.

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

2. Три области по порядку

Дальше — сама форма, и порядок тот же, что мы разобрали: данные, вид, действия.

1. реквизиты  что у формы есть
2. элементы   что из этого видно
3. команды    что можно сделать

Читать в обратную сторону — распространённая ошибка. Начав с элементов, вы увидите поле и не будете знать, откуда оно берёт значение; начав с реквизитов, вы прочтёте элемент сразу вместе с его источником.

Третья строка стоит внимания: полезно не только то, что в форме есть, но и то, чего в ней нет. Реквизит, который есть в списке, но не выведен элементом, — чей-то осознанный отказ показывать его пользователю.

3. Где кончается чтение без кода

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

Это не поражение, а граница. Большинство вопросов, с которыми человек приходит к чужой форме — «почему поле пустое», «откуда взялось это значение», «почему кнопки нет», — решаются без единой строки кода.

4. Что выдаёт замысел

Зато и без модуля видно многое — прежде всего по тому, как расположены элементы. Автоформа раскладывает всё подряд. Как только в форме появляется порядок, не совпадающий с деревом, за ним стоит человеческое решение — и его стоит прочесть.

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

5. Три ловушки чтения

Первая: считать, что всё на форме пришло от объекта. Реквизиты формы заводят и руками, и такое поле в дереве объекта искать бесполезно.

Вторая: считать кнопку командой формы. Часть кнопок приходит от объекта стандартными командами: в списке команд формы их не найти, а на экране они есть — в командной панели формы.

Третья: судить о форме по одному окну. У объекта форм бывает несколько, и та, что открылась двойным щелчком, — только одна из них.

Прочесть форму — значит объяснить каждое поле и каждую кнопку: откуда оно и почему здесь. Всё, чего объяснить не удалось, — список вопросов, а не провал.

6. Разбор по шагам

Порядок, которым дальше разбирается любая чужая форма.

1. Найдите форму в дереве: чей объект, как называется, есть ли соседи.

2. Посмотрите строки основных форм объекта: открывается ли эта форма сама и для какого вида.

3. Откройте редактор и выпишите реквизиты формы.

4. Пройдите структуру элементов сверху вниз: что выведено, в каком порядке, что собрано в группы.

5. Сверьте два списка: какие реквизиты не выведены и какие элементы не связаны с реквизитами.

6. Посмотрите команды: что объявлено формой, что вынесено на экран и какие кнопки пришли от объекта стандартными командами.

7. Назовите одно решение, которое видно в этой форме, и объясните его словами про работу пользователя.

Главное в одном абзаце

Чужую форму разбирают не с окна, а с дерева: чей это объект, назначена ли форма основной и есть ли у объекта другие — без этих ответов остальное читается вслепую. Дальше идут три области в неизменном порядке: реквизиты — что у формы есть, элементы — что из этого видно, команды — что можно сделать; и полезно не только то, что в форме есть, но и то, чего в ней нет. Модуль мы не читаем, и это граница, а не поражение: почти все вопросы, с которыми приходят к чужой форме, решаются без кода. Всякий порядок, не совпадающий с деревом, — след человеческого решения, и его стоит прочесть вопросом «какую работу это облегчает». А главных ловушек три: считать, что всё на форме пришло от объекта; принимать любую кнопку за команду формы; судить об объекте по одному открытому окну.

Разбирать формы мы научились по трём областям, но первая из них так и осталась списком без объяснения. Что это за реквизиты, откуда они берутся и почему среди них есть строка, которую никто не заводил?

Контрольные вопросы

1. Почему разбор чужой формы начинают с дерева, а не с окна?
2. Какие три вопроса задают к дереву до того, как открыть форму?
3. В каком порядке читают три области и почему именно в таком?
4. Почему полезно смотреть, чего в форме нет?
5. Какие вопросы о форме нельзя решить, не читая модуль?
6. Что означает порядок полей, не совпадающий с деревом объекта?
7. Назовите три ловушки чтения формы.

Упражнения

По образцу. Разберите по семи шагам форму, которую вы собрали сами. Ответы на все шаги известны заранее — это и есть проверка самого порядка.

Своё: разбор соседа. Возьмите форму элемента другого справочника и пройдите по ней те же шаги. Сравните с первым разбором и назовите одно отличие.

Ловушка: «это поле из справочника». В чужой форме есть флажок «показывать подробности». Коллега ищет его в дереве справочника и не находит. Где искать и почему.

Обратный ход. В форме выведены не все реквизиты объекта. Какие объяснения этому возможны и как отличить одно от другого?

На чтение. Форма открывается двойным щелчком по строке списка, а строка формы элемента в основных формах объекта пуста. Что это означает?

Ответы — в конце части.

Ответы к части 2

Ответы собраны здесь, а не под вопросами: подсказка, увиденная сразу после вопроса, отменяет попытку вспомнить. У каждого ответа до трёх ступеней: сам ответ, указание — если ответ не дался сразу — и полное решение там, где рассуждение важнее вывода.

§ 2.1. Форма как объект конфигурации: где она живёт в дереве

К вопросу 1. Ответ. Форма — описание окна, которое хранится в дереве; окно — то, что платформа по этому описанию строит. По одной форме окон бывает много, и правка формы отзывается во всех сразу.

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

К вопросу 3. Ответ. Имя формы уникально внутри своего объекта, а не во всей конфигурации: у каждого хозяина своё пространство имён.

К вопросу 4. Указание. Что изменится, если форму переименовать?

Полное решение. Имя — адрес, по которому форму находят: оно живёт в свойствах самой формы. Назначение — кем форма приходится объекту — живёт в свойствах объекта-хозяина, в ссылке на эту форму. Переименование меняет адрес, но не назначение: пока объект ссылается на форму, она остаётся его основной формой элемента, как бы её ни звали.

К вопросу 5. Ответ. Реквизит объекта задан в дереве объекта и хранится в базе; реквизит формы задан внутри формы и живёт, пока открыто окно.

К вопросу 6. Ответ. Когда окно не про один объект — настройки, служебный диалог. Привязывать такое окно к справочнику не к чему, и форма ложится в общие.

К вопросу 7. Ответ. Потому что окна для объектов платформа строит сама, пока своя форма не задана. Заданная форма нужна не для работы, а для того, чтобы разговор шёл иначе, чем по умолчанию. В типовых конфигурациях картина обратная: там формы заданы почти везде.

К упражнению «Прочтите дерево». Ответ. Ветка «Формы» есть у всех прикладных объектов «Канцтоваров» — справочников, документов, отчёта — и всюду пуста. Пустая ветка означает решение: своих форм объекту не понадобилось, окна строит платформа.

К упражнению «Своё: назовите хозяина». Ответ. Во всех трёх фразах не хватает объекта: чей список, чей элемент, выбор чего. Имя формы без имени хозяина не адресует ничего.

К упражнению «Ловушка: „назвал — значит сделал"». Ответ. Не прав. Проверить нужно свойства справочника: указана ли эта форма как основная форма списка.

Полное решение. Имя формы — только адрес. Пока объект не сослался на форму, платформа о ней не знает и продолжает строить список сама. Со стороны это выглядит обидно: форма нарисована, а в Предприятии всё по-старому. Причина не в форме и не в платформе, а в незаполненном свойстве объекта.

К упражнению «Обратный ход». Ответ. Основная форма открывается сама, а две остальные вызываются явно — из кода, из команды или другой формой. Искать их в работе программы нужно там, где окно открывается не двойным щелчком, а по кнопке или по действию.

К упражнению «На чтение». Ответ. У этой формы нет предметного хозяина: объект в неё сам не подставится, данные придут через параметры и собственные реквизиты формы, а открывается она не двойным щелчком по записи, а откуда-то из программы. Скорее всего, окно не про один предмет — настройки, служебный диалог, помощник.

§ 2.2. Конструктор формы: первое знакомство

К вопросу 1. Ответ. Конструктор вызывается автоматически при создании формы: его не выбирают в меню, он открывается сам, как только объекту добавляют форму.

К вопросу 2. Ответ. Потому что набор видов форм читается по объекту: у справочника есть папки, а значит, и формы группы, у документа их нет.

К вопросу 3. Ответ. О том, про что будет разговор: одна запись, список записей, выбор одной записи, папка. Внешность здесь ни при чём.

К вопросу 4. Ответ. Из описания объекта — тех же реквизитов, табличных частей и стандартных команд, из которых платформа строит автоформу.

К вопросу 5. Указание. Что происходит с автоформой при каждом открытии и чего не происходит с сохранённой формой?

Полное решение. Автоформа собирается заново каждый раз, поэтому она всегда соответствует объекту. Конструктор делает с объекта такой же снимок, но однократно и кладёт результат в дерево. С этой минуты форма живёт отдельно от объекта: добавленный через полгода реквизит в ней не появится, и, если он нужен пользователю, форму придётся править руками. Это и есть та цена своей формы, о которой шла речь в прошлой главе.

К вопросу 6. Ответ. Ставит ссылку из свойств объекта на созданную форму — то самое назначение. Мы её сняли, чтобы увидеть: создать форму и назначить её объекту — два разных действия.

К вопросу 7. Ответ. Ничего. Для списка, выбора и группы платформа по-прежнему строит окна сама; своя форма занимает одно место, и только то, на которое её поставят.

К упражнению «По образцу». Ответ. Форма у контрагентов появилась, а карточка контрагента открывается прежней: справочник на новую форму не ссылается. То же самое мы видели у товаров.

К упражнению «Своё: предскажите набор». Ответ. Конструктор предложит форму документа, форму списка, форму выбора и произвольную; форм группы у документа нет. В форме документа окажутся реквизиты шапки и табличная часть «Товары» — то же, что показывает автоформа.

К упражнению «Ловушка: „форма создана — дело сделано"». Ответ. Оба правы: форма действительно создана и лежит в дереве, но объект на неё не ссылается, поэтому пользователь по-прежнему видит автоформу.

Полное решение. Разработчик выполнил первое из двух действий: форма существует. Второе — назначение — осталось несделанным, а именно оно решает, какое окно откроется пользователю. Проверять нужно свойства объекта: указана ли форма как основная форма нужного вида. Пока не указана, разговор идёт через автоформу, и никакая правка формы на экран не попадёт.

К упражнению «Обратный ход». Ответ. Порядок полей в ней меняли руками: конструктор раскладывает поля в порядке дерева, значит, после него форму правили. Это признак формы, за которой стоит замысел, а не автоматическая раскладка.

К упражнению «На чтение». Ответ. Форма списка строится платформой — своей формы списка у объекта нет или она не назначена. А форма элемента задана и хранится: снимок сделан до того, как реквизит появился, и сам он туда не попадёт.

§ 2.3. Редактор формы: три области и предпросмотр

К вопросу 1. Ответ. Потому что под одним окном собраны шесть редакторов — элементов, командного интерфейса, реквизитов, команд, параметров и модуля, — и каждый занимается своей частью формы.

К вопросу 2. Ответ. Реквизиты — о чём говорим; элементы — что видно; команды — что можно сделать.

К вопросу 3. Ответ. Данные первичны: элемент, которому нечего показывать, бессмыслен, а команда, которой нечего делать, бесполезна.

К вопросу 4. Ответ. Показывает раскладку — где встанут элементы. Не показывает работы: значения реквизитов не заполнены, обработчики не выполняются.

К вопросу 5. Ответ. Элемент «Форма». Его свойства в палитре — свойства всей формы, а не отдельного поля.

К вопросу 6. Указание. Через сколько мест команда может попасть на экран?

Полное решение. «Есть ли действие» решает редактор команд: там оно объявляется. «Видно ли оно» решается в другом месте, и путей два — кнопкой в структуре элементов или через редактор командного интерфейса формы, в панели навигации или командной панели. Поэтому объявленная команда без кнопки — не ошибка, а незаконченное решение: действие есть, а на экран его не вывели.

К вопросу 7. Ответ. В палитре свойств — у самого элемента, у реквизита или у формы целиком.

К упражнению «По образцу». Ответ. Элементы — из чего сложено окно; командный интерфейс — что стоит в панелях; реквизиты — чем форма располагает; команды — что она умеет; параметры — с чем её открывают; модуль — что делать в ответ на действие.

К упражнению «Своё: три вопроса к чужому окну». Ответ. Проверка не на знание, а на привычку: если после трёх вопросов окно перестало быть картинкой и стало устройством, упражнение сделано.

К упражнению «Ловушка: „нарисую окно и заполню"». Ответ. Поле без данных показывать нечего: его придётся или связывать с реквизитом потом, или заводить реквизит задним числом. Работа выйдет двойная.

Полное решение. Порядок «сначала данные, потом вид» держится не на вкусе, а на устройстве формы: поле появляется из реквизита, и связь эта задаётся при создании поля. Разложив пустые поля, разработчик получает окно, которое выглядит готовым и ничего не показывает, — а потом связывает каждое поле вручную. Тот же результат достигается перетаскиванием реквизитов сразу.

К упражнению «Обратный ход». Ответ. За кнопкой стандартная команда, которую форма не объявляла, а получила от объекта. Либо действие пришло через редактор командного интерфейса формы, а не через структуру элементов.

К упражнению «На чтение». Ответ. Данные показывают поля и таблица; группа только собирает их вместе, а декорация не показывает ничего — это подпись или картинка.

§ 2.4. Назначение формы объекту

К вопросу 1. Ответ. В свойствах объекта: окно редактирования, закладка «Формы», группа «Основные формы». Там, потому что решает хозяин: форма не выбирает, кем ей быть.

К вопросу 2. Ответ. Основная — та, которую платформа откроет, если при вызове не сказано, какую именно открывать.

К вопросу 3. Ответ. Может. Двойным щелчком откроется основная; если основная не назначена — форма, построенная платформой, а не одна из существующих.

К вопросу 4. Ответ. Из двух: назначена ли основная форма этого вида; если нет — платформа строит форму сама. У справочников и документов вторая ступень срабатывает в любом случае, поэтому окно открывается.

К вопросу 5. Ответ. Не меняет саму форму, не запрещает остальные формы того же вида, не отменяет автоформы других видов.

К вопросу 6. Указание. Где мы меняли строку и с чем работает пользователь?

Полное решение. Строку правят в Конфигураторе, то есть в описании программы. Пользователь работает с базой данных, а описание попадает в неё отдельным действием — обновлением конфигурации базы данных. Пока оно не сделано, Предприятие живёт по старому описанию. Открытый сеанс к тому же держит своё состояние, поэтому его перезапускают.

К вопросу 7. Ответ. Список товаров, построенный платформой: мы назначили форму элемента, а команда раздела просит форму списка.

К упражнению «По образцу». Ответ. Карточка контрагента открывается назначенной формой, список — по-прежнему автоформой. Порядок тот же: назначить, обновить конфигурацию базы данных, проверить.

К упражнению «Своё: предскажите экран». Ответ. Список откроется назначенной формой списка, а щелчок по строке откроет карточку, построенную платформой: для формы элемента назначения нет.

К упражнению «Ловушка: „форма не работает"». Ответ. Пропущено обновление конфигурации базы данных. Проверять по порядку: обновлена ли конфигурация базы данных, перезапущен ли сеанс, заполнена ли нужная строка основных форм и та ли это строка.

Полное решение. «Не работает» здесь означает «не дошло». Сохранение конфигурации кладёт изменение в описание, а не в базу; пользователь видит базу. Отсюда и порядок проверки — от самого частого к редкому: обновление, сеанс, строка, вид формы. Только в последнюю очередь стоит подозревать саму форму.

К упражнению «Обратный ход». Ответ. Три остальные формы сами не открываются: их зовут явно — из команды, из кода, из другой формы. Либо они остались от прежних решений и не используются вовсе.

К упражнению «На чтение». Ответ. Пользователь снова увидит карточку, построенную платформой. Сама форма никуда не делась: она лежит в дереве, её по-прежнему можно открыть явным вызовом и снова назначить.

§ 2.5. Запуск в Предприятии: видим то, что собрали

К вопросу 1. Ответ. Потому что конструктор собирал форму из того же описания объекта и теми же правилами, что и платформа. Заметное отличие означало бы, что где-то что-то потерялось.

К вопросу 2. Ответ. Источник окна. Раньше его строила платформа, теперь оно берётся из формы, лежащей в дереве.

К вопросу 3. Ответ. Форма не следует за объектом: новый реквизит в ней сам не появится, его придётся вывести руками.

К вопросу 4. Ответ. Нет. Нетронутая форма выглядит как автоформа. Ответ даёт строка основных форм объекта.

К вопросу 5. Ответ. Что форму правил человек: автоформа раскладывает поля в порядке дерева.

К вопросу 6. Ответ. Редактор формы → обновление конфигурации базы данных → Предприятие. Пропущенный средний шаг выглядит как «ничего не изменилось».

К вопросу 7. Ответ. Ничего. Список строится платформой, и правка формы элемента его не касается.

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

К упражнению «Своё: предскажите последствие». Ответ. В карточке «Веса» не будет: она берётся из заданной формы, а форму никто не менял. В списке появится: его платформа строит заново при следующем открытии.

К упражнению «Ловушка: „форма сломалась"». Ответ. Ничего не сломалось. Форма хранится и не пересобирается; поле нужно вывести в ней руками.

Полное решение. Слово «сломалась» описывает ожидание, а не событие: коллега ждал, что форма догонит объект. Так ведёт себя автоформа, а заданная форма — нет, и это её постоянное свойство, а не сбой. Дальше два пути: вывести реквизит в форме или, если своя форма больше не нужна, снять назначение и вернуться к автоформе.

К упражнению «Обратный ход». Ответ. Из этого не следует ничего: так выглядит и автоформа, и нетронутая своя форма. Проверить можно только в Конфигураторе — по строке основных форм объекта.

К упражнению «На чтение». Ответ. Первую правил человек: поля собраны в группы, а сама собой такая раскладка не получается. О второй сказать нельзя ничего: так выглядит и автоформа, и нетронутая своя форма.

§ 2.6. Чужая форма: разбор по трём областям

К вопросу 1. Ответ. Окно — результат. Пока неизвестно, чья это форма и открывается ли она сама, всё увиденное читается вслепую.

К вопросу 2. Ответ. Чей объект; назначена ли форма и для какого вида; есть ли у объекта другие формы.

К вопросу 3. Ответ. Реквизиты, элементы, команды. В этом порядке элемент читается сразу вместе с источником значения.

К вопросу 4. Ответ. Невыведенный реквизит — чей-то отказ показывать его пользователю, то есть тоже решение.

К вопросу 5. Ответ. Что происходит при нажатии, что при открытии и откуда берутся вычисляемые значения.

К вопросу 6. Ответ. Что форму правил человек: автоформа раскладывает поля в порядке дерева.

К вопросу 7. Ответ. Считать, что всё на форме пришло от объекта; считать любую кнопку командой формы; судить об объекте по одному окну.

К упражнению «По образцу». Ответ. Все семь шагов на своей форме дают известные ответы — упражнение проверяет не знание конфигурации, а порядок разбора.

К упражнению «Своё: разбор соседа». Ответ. Отличия обычно в составе реквизитов объекта и в том, что из них выведено. Если формы не правили, различие будет только в наборе полей.

К упражнению «Ловушка: „это поле из справочника"». Ответ. Искать в реквизитах формы: такое поле живёт в форме, а не в объекте, и в дереве справочника его нет.

К упражнению «Обратный ход». Ответ. Либо реквизит не стали выводить, либо форма старше реквизита: её собрали, когда реквизита ещё не было. Отличить можно по остальным формам объекта — если в других он выведен, дело в возрасте формы.

К упражнению «На чтение». Ответ. Что открывается не она: двойной щелчок приведёт к форме, построенной платформой. Эту форму зовут явно — из команды, из кода или из другой формы.

§ 3.1. Реквизит объекта и реквизит формы: одно слово, два смысла

Слово «реквизит» читатель уже знает: артикул товара, ИНН контрагента — всё это реквизиты, заданные объекту и хранящиеся в базе. А в редакторе формы список с тем же названием — и лежит в нём другое. Совпадение имён здесь не случайность и не небрежность, но пока оно не разобрано, дальше двигаться нельзя: половина вопросов о формах упирается ровно в это различение.

1. Два списка, названных одинаково

Первый список — в дереве объекта. Второй — в редакторе формы. Названы они почти одинаково, а отвечают на разные вопросы.

Справочник «Товары»    Форма элемента
└── Реквизиты          └── реквизиты
    ├── Артикул            ├── Объект
    └── ЕдиницаИзм…        └── Показывать…

Строка «Объект» в правом списке — та самая, которой никто не заводил: о ней следующий параграф. Пока достаточно знать, что она там есть.

Одно слово, два предмета. Различает их принадлежность: реквизит объекта — у объекта, реквизит формы — у формы.

2. Реквизит объекта: свойство записи

Реквизит объекта задают один раз — в дереве, — а хранится он у каждой записи свой. Артикул есть у бумаги, у ручки и у папки, у каждой свой, и все эти значения лежат в базе, пока записи оттуда не удалят. Задан он для всего справочника сразу, а живёт поштучно.

Об этом подробно рассказывает книга о дереве метаданных; здесь нам нужно одно её следствие, зато важное. Реквизит объекта существует независимо от того, открыта какая-нибудь форма или нет: он часть записи, а не часть разговора о ней. Закройте все окна, погасите экран — артикул бумаги останется на месте, и запрос его найдёт.

3. Реквизит формы: то, чем форма располагает

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

Зачем оно тогда нужно, проще показать на примере. Флажок «показывать подробности», который разворачивает часть полей, — не свойство товара. Он вообще не про товар: он про то, как сейчас смотрит один пользователь в одном открытом окне. У соседа, который в эту же минуту открыл тот же товар, флажок может стоять иначе, и оба правы. Хранить такое в базе бессмысленно, а форме без него неудобно — вот для этого реквизиты формы и заводят.

4. Разница в одной таблице

Свести различия вместе стоит один раз и запомнить насовсем.

Строка про базу означает ровно то, что написано: сама собой форма таких значений не сохраняет. Каким действием данные вообще попадают в базу, разберём в этой же главе.

Последняя строка — быстрый способ проверить себя, и работает он потому, что запрос читает хранимые данные — таблицы базы. Реквизита формы среди них нет, оттого запрос его и не находит — дело не в секретности, а в адресе.

5. Почему их всё-таки назвали одинаково

Потому что устроены они похоже: именованное значение определённого типа, принадлежащее чему-то. Разница не в природе, а в хозяине — и, как следствие, в сроке жизни.

имя + тип + хозяин
   хозяин объект → хранится в базе
   хозяин форма  → живёт, пока открыта

Такая экономия имён в 1С встречается часто, и правило чтения всегда одно: сначала спросить, чей это реквизит. Без ответа на этот вопрос спор «есть такое поле или нет» может длиться долго — собеседники будут смотреть в разные списки.

Прежде чем искать реквизит, спросите, чей он. Половина недоразумений о формах живёт именно здесь.

6. Где это всплывает в работе

Три случая, в которых различение окупается сразу.

Третья строка — самая частая, и она обычно значит больше, чем кажется. Если значение понадобилось в отчёте, его место, скорее всего, в реквизитах объекта: кто-то завёл реквизитом формы то, что должно храниться. Иногда это осознанный выбор, но чаще недосмотр, и обнаруживается он именно так.

7. В Конфигураторе

Выпишем оба списка и сравним их глазами.

1. Откройте в дереве справочник «Товары» и выпишите его реквизиты.

2. Откройте форму элемента этого же справочника — ту, что мы собрали, — и выпишите реквизиты формы.

3. Сравните списки. Они не совпадают, и это нормально: списки отвечают на разные вопросы.

4. В списке реквизитов формы найдите строку, которой вы не заводили. Имя её запомните — следующий параграф будет о ней.

Главное в одном абзаце

Слово «реквизит» в 1С означает две разные вещи, и различает их хозяин. Реквизит объекта задан в дереве объекта, хранится в базе у каждой записи, живёт, пока существует запись, и виден запросам к базе. Реквизит формы задан в самой форме, значение его лежит в данных открытого окна, а не в базе, и запрос к базе его не найдёт — он нужен форме для разговора, а не базе для хранения. Названы они одинаково потому, что устроены похоже: имя, тип и хозяин; разница в хозяине и в сроке жизни. Отсюда правило чтения: прежде чем искать реквизит, спросить, чей он, — иначе двое будут смотреть в разные списки и спорить о том, есть ли такое поле.

В списке реквизитов формы нашлась строка, которую никто не заводил, и она там не случайно: через неё форма и говорит о товаре. Что это за реквизит и почему он главный?

Контрольные вопросы

1. Чем отличается реквизит объекта от реквизита формы — назовите хозяина каждого.
2. Сколько живёт реквизит формы и что от него остаётся после закрытия окна?
3. Почему запрос к базе не находит реквизит формы?
4. Как быстро проверить, какого рода реквизит перед вами?
5. Почему два разных предмета назвали одним словом?
6. Пользователь говорит: «поле на форме есть, а в отчёт не попадает». Что это значит?
7. Где искать флажок «показывать подробности» — в дереве справочника или в форме?

Упражнения

По образцу. Выпишите два списка для справочника «Товары» — реквизиты объекта и реквизиты формы — и отметьте, что есть только в одном из них.

Своё: придумайте реквизит. Назовите два значения, которые нужны форме товара, но не нужны базе. Объясните, почему их незачем хранить.

Ловушка: «добавь поле в справочник». Заказчик просит добавить в карточку товара галочку «показывать закупочные цены», чтобы каждый пользователь включал её себе. Какой это реквизит и почему не тот, о котором просят?

Обратный ход. В форме есть поле, значения которого нет ни в одном отчёте. Какие объяснения этому возможны?

На чтение. В списке реквизитов формы вы видите строку «Итого» типа Число. Что о ней можно сказать, не открывая ничего больше?

Ответы — в конце части.

§ 3.2. Основной реквизит: главный предмет разговора

Раз реквизиты формы и объекта разведены, вернёмся к списку формы: одна строка в нём выделена полужирным. Выделение не украшение — так редактор отмечает основной реквизит, тот, ради которого форма вообще существует. Его завёл конструктор, и от него зависит, как форма ведёт себя при открытии, при правке и при закрытии.

1. Строка, которую завёл конструктор

Конструктор, собирая форму по объекту, создаёт реквизит под предмет разговора и отмечает его как основной. У формы элемента товара он называется «Объект». У произвольной формы такого реквизита не будет — о ней в конце параграфа.

реквизиты формы
├── Объект            ← основной, полужирным
└── (остальные, если заведут)

Документация платформы говорит об этом прямо: основной реквизит определяет поведение формы при открытии, редактировании и закрытии, а его тип задаётся типом объекта и видом формы. Проще говоря, по основному реквизиту форма знает, про что она — и потому умеет сама то, чему её никто не учил. Открыли карточку товара — в полях уже данные этого товара. Поменяли артикул и закрываете окно, не записав, — форма спросит, сохранить ли изменения. Ни строчки кода за этим нет: так работает форма, у которой есть предмет. Подробно эту жизнь данных разберём в этой же главе.

Основной реквизит — это предмет разговора, записанный в форму. Всё остальное в форме говорит о нём или вокруг него.

2. Имя и тип зависят от вида формы

Конструктор подбирает основному реквизиту тип под разговор. Форма одной записи получает саму запись, форма списка — список.

Слово «Объект» в имени не случайно и не обязательно: это просто имя, которое конструктор даёт по умолчанию. Важен не текст, а отметка «основной» и тип. Но переименовывать без причины не стоит. Окно от этого не сломается, а вот всё, что обращается к реквизиту по имени, — код формы, если он есть, и привычки тех, кто этот код читает, — рассчитывает найти именно «Объект».

3. Почему форма «знает», кем ей быть

Тип основного реквизита — не просто подпись к данным: именно он делает форму пригодной для роли. Когда мы назначали формы объекту, осталась недосказанность: пригодность, говорили мы, видна по устройству формы. Вот это устройство.

Отсюда и порядок решений, который мы уже видели, только теперь с объяснением. Конструктор создаёт основной реквизит нужного типа — форма становится пригодной для роли. В свойствах объекта указывают, какую из пригодных открывать по умолчанию, — и роль назначена.

4. Основной реквизит — реквизит формы

Легко запутаться ровно в том месте, которое разбирали в прошлом параграфе. «Объект» — реквизит формы. Он лежит в списке формы, живёт, пока открыто окно, и принадлежит форме. Но тип у него — объект справочника, и потому внутри него оказываются реквизиты объекта: артикул, единица, наименование.

реквизит формы «Объект»
  тип: СправочникОбъект.Товары
  внутри: Артикул, ЕдиницаИзмерения, …
          ↑ реквизиты объекта

Это не противоречие, а вложенность: реквизит формы, внутри которого сидят реквизиты объекта. Как именно они туда попадают и что с ними происходит, пока окно открыто, разберём в этой главе по шагам.

5. Почему основной только один

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

образ    предмет разговора
строго   основной реквизит формы
адрес    список реквизитов формы,
         строка с отметкой основного

6. Форма без основного реквизита

Мы уже встречали такую: произвольная форма, которую предлагал конструктор. Основного реквизита у неё нет, и документация прямо говорит, что при выборе произвольной формы он не создаётся.

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

7. В Конфигураторе

1. Откройте форму элемента справочника «Товары» и найдите в списке реквизитов основной. Запишите его имя и тип.

2. Добавьте справочнику «Товары» ещё одну форму — произвольную — и откройте её реквизиты. Основного реквизита там нет.

3. Сравните два списка и назовите разницу одним предложением.

4. Удалите произвольную форму: она была нужна только для сравнения.

Главное в одном абзаце

Основной реквизит — строка в списке реквизитов формы, которую завёл конструктор и отметил как главную: по нему форма знает, про что она, и от него зависит, как она ведёт себя при открытии, правке и закрытии. Имя по умолчанию — «Объект» у формы элемента или документа и «Список» у формы списка, а тип подбирается под разговор: сама запись для формы одной записи, список для формы списка. Этим же типом объясняется, почему форма пригодна для той или иной роли: объект выбирает в основные формы только из годных. Основной реквизит — реквизит формы, но внутри него сидят реквизиты объекта, и это не путаница, а вложенность. Основной он один, потому что предмет у разговора один; у произвольной формы основного реквизита нет вовсе, и потому ей место там, где разговор не о записи.

Внутри «Объекта» лежат реквизиты товара — те самые, из дерева. Но как они туда попадают и что видно, если этот реквизит развернуть?

Контрольные вопросы

1. Как отличить основной реквизит в списке реквизитов формы?
2. Кто создаёт основной реквизит и в каком случае его не будет?
3. От чего зависят имя и тип основного реквизита?
4. Как основной реквизит связан с тем, в какие основные формы объекта годится форма?
5. «Объект» — реквизит формы или реквизит объекта? Объясните, что внутри него.
6. Почему основной реквизит у формы только один?
7. Для чего нужны формы без основного реквизита?

Упражнения

По образцу. Найдите основной реквизит в форме элемента «Контрагентов» и назовите его имя и тип.

Своё: предскажите тип. Для формы документа «ПоступлениеТоваров» и для формы списка контрагентов назовите, каким будет основной реквизит, прежде чем открывать редактор. Потом сверьте.

Ловушка: «переименую — станет понятнее». Разработчик переименовал «Объект» в «Товар» и доволен. Что от этого изменилось, а что нет, и почему коллеги попросят вернуть?

Обратный ход. В чужой форме в списке реквизитов нет ни одной строки, выделенной как основная. Что можно сказать о форме и где она, скорее всего, лежит?

На чтение. В списке реквизитов формы: «Объект» типа ДокументОбъект.Заказ и «ПоказыватьОплаты» типа Булево. Что из этого предмет разговора, а что — данные вокруг него?

Ответы — в конце части.

§ 3.3. Разворачиваем «Объект»: откуда в форме реквизиты товара

Основной реквизит нашей формы — «Объект», и рядом с ним в списке реквизитов стоит значок раскрытия. Нажмите — и под одной строкой окажется целый список: артикул, единица измерения, код, наименование. Ни одну из этих строк в форму никто не добавлял. Разберёмся, откуда они там и почему это важнее, чем кажется.

1. Что внутри

Развёрнутый основной реквизит показывает всё, из чего состоит запись справочника.

Объект   (СправочникОбъект.Товары)
├── Ссылка
├── Код
├── Наименование
├── Родитель
├── ПометкаУдаления
├── Артикул
└── ЕдиницаИзмерения

Верхняя часть — стандартные реквизиты: их платформа даёт справочнику сама, а точный набор зависит от его настроек — родитель, например, есть только у иерархического. Нижняя часть — то, что завёл разработчик в дереве. Внутри «Объекта» они стоят вместе, потому что для записи они одинаково свои: и код, и артикул — свойства одного товара.

2. Откуда: из типа, а не из копирования

Реквизиты товара форма к себе по одному не копировала. В её описании хранится одна строка — реквизит «Объект» с типом объекта справочника «Товары», — а состав этого типа платформа берёт из описания справочника. Развернуть «Объект» — значит заглянуть в этот тип.

образ    опись состава, а не склад
         значений
строго   реквизит формы типа
         СправочникОбъект.Товары
адрес    реквизиты формы, «Объект»,
         значок раскрытия

Отсюда следствие, которое проверяется за минуту. Добавьте справочнику реквизит, откройте форму заново — и внутри «Объекта» он уже есть, хотя в самой форме никто ничего не менял: список реквизитов товара форма не хранит, его приносит тип. На экране при этом нового поля не появится — почему, сейчас разберём.

Реквизиты объекта в форме не лежат, а видны: форма смотрит на них через тип основного реквизита.

3. Данные идут за объектом, раскладка — нет

Здесь закрывается вопрос, оставленный в параграфе о запуске формы. Там мы видели: добавили реквизит — в нашей форме поле не появилось. А здесь только что сказали: добавили — и он появился внутри «Объекта». Противоречия нет, это две разные части формы.

Новый реквизит у формы есть — данными. Пользователю его не видно, потому что поля для него никто не положил. Вывести его — дело одного перетаскивания из реквизитов в элементы, того самого жеста, о котором шла речь в разговоре о редакторе формы.

Своя форма отстаёт от объекта не данными, а раскладкой. Состав данных у неё всегда свежий, а поля — те, что положили.

4. Путь через точку

У каждой строки внутри «Объекта» есть полный адрес: имя основного реквизита, точка, имя реквизита объекта. Артикул товара в форме — это Объект.Артикул, единица — Объект.ЕдиницаИзмерения, наименование — Объект.Наименование.

Встретятся такие пути в свойствах полей: у каждого поля есть свойство, где записано, откуда оно берёт значение, — например, «Объект.Артикул». Подробно — когда дойдём до связи элемента с данными.

Читать же их можно уже сейчас. Путь всегда начинается с имени реквизита формы. Начинается с «Объект.» — значит, это данные той записи, о которой форма разговаривает. Начинается с другого имени — значит, форма держит это значение у себя; бывает, что и там лежит ссылка на запись, но уже не на свою.

5. У документа внутри есть и таблица

То же правило работает у документов, и там в «Объекте» видна ещё одна вещь. У справочника «Товары» табличных частей нет, у документа поступления есть, и развёрнутый «Объект» покажет её вместе с колонками.

Объект   (ДокументОбъект.ПоступлениеТоваров)
├── Номер, Дата
├── Контрагент, Склад, СуммаДокумента
└── Товары          ← табличная часть
    ├── Товар
    ├── Количество
    ├── Цена
    └── Сумма

Путь к колонке длиннее на одно звено: Объект.Товары.Количество. Табличная часть — тоже данные записи, и приходит она тем же путём: из типа.

6. Как этим пользоваться при чтении чужой формы

В списке реквизитов чужой формы реквизиты объекта перечислены не будут — там одна строка «Объект». Отсюда два правила чтения.

Второе правило избавляет от целого класса поисков вслепую. Если поле на форме связано не с «Объект.…», его значение не хранится в этой записи, как бы похоже на реквизит товара оно ни выглядело. Проверим оба правила в редакторе.

7. В Конфигураторе

1. Откройте форму элемента «Товаров», разверните «Объект» и сравните состав с деревом справочника.

2. Добавьте справочнику «Товары» реквизит «Вес» с типом Число.

3. Вернитесь в форму и снова разверните «Объект»: «Вес» уже там.

4. Посмотрите на предпросмотр внизу: поля «Вес» на нём нет — раскладку никто не менял.

5. Удалите реквизит «Вес» из справочника: он был нужен для опыта, а база серии должна остаться такой, какой её знают другие книги.

Главное в одном абзаце

Развёрнутый основной реквизит показывает всё, из чего состоит запись: стандартные реквизиты вроде кода и наименования, реквизиты, заведённые в дереве, а у документа — ещё и табличные части с колонками. По одному форма их не копировала: в ней хранится один реквизит «Объект» с типом объекта, а состав типа платформа берёт из описания, так что новый реквизит объекта появляется внутри «Объекта» сам. Этим закрывается загадка отстающей формы: данные у неё идут за объектом всегда, а раскладка — нет, потому что поля хранятся в форме и новое поле кто-то должен положить. У каждой строки есть путь через точку — Объект.Артикул, Объект.Товары.Количество, — и отсюда правило чтения чужой формы: начинается с «Объект.» — данные записи, о которой разговор, с другого имени — значение, которое форма держит у себя.

Всё, что внутри «Объекта», пришло из записи. Но форме нужны и такие данные, которых в записи нет и быть не должно. Где их держать?

Контрольные вопросы

1. Что видно, если развернуть основной реквизит формы элемента?
2. Откуда в «Объекте» берутся реквизиты товара, если форма их не копирует?
3. Добавили справочнику реквизит. Что изменилось внутри «Объекта» и что — на экране формы?
4. Почему своя форма отстаёт от объекта раскладкой, но не данными?
5. Что означает путь «Объект.Артикул» и чем он отличается от пути без «Объект.»?
6. Как выглядит путь к колонке табличной части документа?
7. Где искать реквизит объекта в списке реквизитов чужой формы?

Упражнения

По образцу. Разверните «Объект» у формы элемента «Контрагентов» и выпишите, какие строки пришли из дерева справочника, а какие стандартные.

Своё: предскажите путь. Не открывая редактор, запишите полные пути к ИНН контрагента и к цене в строке поступления. Потом сверьте.

Ловушка: «реквизит добавил, а форма не видит». Разработчик добавил товару реквизит «Вес», открыл форму и говорит: «форма его не видит, придётся пересоздавать». Что он перепутал и что сделать вместо пересоздания?

Обратный ход. В чужой форме поле связано с путём «Объект.Комментарий». Что можно сказать о «Комментарии», не открывая дерево объекта?

На чтение. В списке реквизитов формы поступления две строки: «Объект» типа ДокументОбъект.ПоступлениеТоваров и «ИтогоВес» типа Число. Что из этого хранится в базе, а что форма держит у себя?

Ответы — в конце части.

§ 3.4. Дополнительные реквизиты формы: данные помимо записи

С основным реквизитом разобрались: в нём данные записи. Данные, которых в записи нет и быть не должно, держат в самой форме — рядом с «Объектом», отдельными строками в списке её реквизитов. «Объект» форма получила от конструктора, а эти строки заводит разработчик, и принадлежат они только форме. Разберём, когда они нужны, как их добавить и почему заведённый реквизит ещё ничего не меняет на экране.

1. Рядом с «Объектом», а не внутри

Список реквизитов формы делится на две части: основной реквизит с данными записи и всё остальное.

реквизиты формы
├── Объект                  ← запись
│   ├── Артикул
│   └── …
└── ПоказыватьПодробности   ← форма

Граница здесь та же, что между реквизитом объекта и реквизитом формы: всё внутри «Объекта» — данные записи, они приходят из базы и уходят в неё при записи; всё рядом с ним — данные самой формы, места в записи у них нет. Путь к дополнительному реквизиту короткий — одно имя, без «Объект.».

2. Три повода завести реквизит формы

Поводов немного, и почти все сводятся к трём.

Проверить себя помогает один вопрос: понадобится ли это значение завтра другому человеку или отчёту? Если да — место ему в записи, то есть в реквизитах объекта. Если нет — оно принадлежит этому окну и этому разговору, и завести его нужно в форме.

Реквизит формы — для того, что нужно разговору, а не записи. Завтрашнему собеседнику оно не достанется.

3. Как заводят

Реквизит формы добавляют в редакторе реквизитов: новая строка, у неё имя, заголовок и тип.

Тип здесь выбирают так же, как у реквизита объекта: строка, число, дата, булево, ссылка на справочник. Какие ещё типы бывают у реквизитов формы и зачем, разберём в следующем параграфе.

4. Завели — а на экране ничего

Здесь снова работает правило, с которого начиналась эта глава: данные и раскладка — разные части формы. Реквизит формы — данные. Чтобы пользователь его увидел, нужен элемент.

реквизит       элемент      экран
Показывать… ──► флажок ──► [✓] Показывать
(данные)        (раскладка)    подробности

Жест тот же, что и для реквизитов объекта: перетащить строку из реквизитов в элементы. Редактор сам подберёт вид элемента по типу: для булева это поле, показанное флажком. В структуре элементов оно так и будет называться полем — искать в чужой форме элемент с названием «флажок» бесполезно.

5. Флажок сам ничего не прячет

Честная оговорка. Флажок «показывать подробности» появится на форме, его можно ставить и снимать — и ничего не будет происходить. Реквизит хранит значение, но не знает, что с ним делать: чтобы флажок прятал и показывал поля, нужен обработчик, который на изменение отзовётся.

Обработчики в этой книге мы не пишем. Для нас важно, что значению есть где жить: без реквизита формы обработчику нечего было бы проверять.

6. Два свойства со схожими названиями

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

У реквизита формы есть свойство «Сохраняемые данные», и название сбивает с толку. Оно не про память. Документация называет такой реквизит «сохраняемым при записи»: его изменение считается изменением данных формы — форма помечает себя изменённой и при закрытии спросит, сохранить ли. У формы же есть своё свойство — сохранение данных в настройках: с ним значение переживёт закрытие окна у этого пользователя.

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

7. В Конфигураторе и в Предприятии

1. Откройте форму элемента «Товаров» и добавьте реквизит формы «ПоказыватьПодробности» с типом Булево.

2. Убедитесь, что он появился рядом с «Объектом», а не внутри.

3. Перетащите его в элементы и посмотрите на предпросмотр: там появился флажок.

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

5. Откройте её снова: флажок снят. Значение жило, пока было открыто окно.

6. Вернитесь в Конфигуратор и включите у формы сохранение данных в настройках, отметив «ПоказыватьПодробности» как сохраняемый в них. Повторите шаги 4 и 5: теперь флажок остаётся таким, каким вы его оставили.

Главное в одном абзаце

Данные, которых в записи нет и быть не должно, держат в самой форме — отдельными реквизитами рядом с «Объектом», не внутри него; путь к ним короткий, одно имя. Поводов три: вспомогательное значение для расчёта, временное значение ввода и переключатель режима, а проверяется выбор одним вопросом — понадобится ли значение завтра другому человеку, открывшему ту же запись. Заводят реквизит в редакторе реквизитов — имя, заголовок, тип, — но на экране он появится только тогда, когда из него сделают элемент: данные и раскладка по-прежнему живут врозь. Сам реквизит лишь хранит значение: чтобы флажок что-то прятал, нужен обработчик. И не спутать два свойства: «Сохраняемые данные» у реквизита превращают изменение в правку, о которой спросят при закрытии, а сохранение данных в настройках у формы даёт значению пережить закрытие окна.

Флажок получил тип Булево, и выбор был очевиден. Но реквизиту формы можно дать и такой тип, какого у реквизита объекта не бывает. Что это за типы и зачем форме таблица, которой нет в базе?

Контрольные вопросы

1. Где в списке реквизитов формы находятся дополнительные реквизиты и чем их путь отличается от пути к реквизиту объекта?
2. Назовите три повода завести реквизит формы.
3. По какому вопросу решают, куда поместить значение — в запись или в форму?
4. Почему только что заведённый реквизит формы не виден на экране?
5. Что даёт флажку реквизит формы и чего не даёт?
6. Чем «Сохраняемые данные» у реквизита отличаются от сохранения данных в настройках у формы?
7. Почему флажок в Предприятии оказался снят после повторного открытия?

Упражнения

По образцу. Добавьте форме элемента «Контрагентов» реквизит «ПоказыватьКонтакты» типа Булево и выведите его флажком.

Своё: запись или форма. Для каждого значения решите, где его место: «дата последней сверки с контрагентом», «строка поиска в списке товаров», «количество строк в поступлении», «примечание к поступлению». Объясните каждое решение одним предложением.

Ловушка: «сделай, чтобы флажок работал». Заказчик увидел флажок «показывать подробности» и говорит: «вы его добавили, а он ничего не делает — это ошибка». Что на самом деле сделано, чего не сделано и почему это не ошибка?

Обратный ход. Пользователь жалуется: переключает в карточке режим просмотра — и при закрытии каждый раз вопрос о сохранении, хотя он ничего не менял. Какое свойство и у какого реквизита стоит проверить?

На чтение. В форме поступления рядом с «Объектом» лежат «Отбор» типа Строка и «ИтогоВес» типа Число. Что каждый из них, скорее всего, делает и понадобится ли их значение завтра другому пользователю?

Ответы — в конце части.

§ 3.5. Типы реквизитов формы: простые, ссылочные, особые

Окно выбора типа у реквизита формы длиннее, чем у реквизита объекта. Первые строки в нём знакомы — строка, число, дата, булево, ссылки на справочники и документы. А дальше идут типы, которых у реквизита объекта не бывает вовсе: таблица значений, список значений, дерево значений, динамический список. Они и есть ответ на вопрос, зачем форме таблица, которой нет в базе.

1. Три семьи

Типы реквизитов формы удобно делить на три семьи — по тому, что лежит в значении.

Первые две семьи у реквизита объекта тоже есть. Третья — только у формы. Реквизит объекта хранится в базе, и тип ему можно дать лишь такой, какой база умеет хранить в записи; таблицу значений в одну клетку записи не положишь — для строк у объекта есть табличная часть. А форме хранить ничего не надо: её данные живут, пока открыто окно, и тип им можно дать любой.

2. Простые: одно значение

С ними всё знакомо по реквизитам объекта. Флажок «показывать подробности» — булево, строка поиска — строка, итог по весу — число. Разница не в типе, а в хозяине: значение живёт в форме и по умолчанию пропадает с закрытием окна — если не включить сохранение данных в настройках, о котором шла речь в прошлом параграфе.

3. Ссылочные: указатель на запись

Реквизит формы может хранить ссылку на запись — например, на склад, по которому пользователь хочет посмотреть остаток товара.

реквизит формы  ВыбранныйСклад
тип             ссылка на «Склады»
значение        → «Основной»
                  (сама запись — в базе)

Здесь легко спутать два утверждения. Реквизит формы временный — любой, и ссылочный в том числе: закрыли окно, и выбор пропал. Но запись, на которую он указывает, — постоянная: склад «Основной» как лежал в базе, так и лежит. Форма хранит не склад, а палец, которым на него показывают. Кстати, временно в форме живут не только её собственные реквизиты: данные записи внутри «Объекта» тоже, пока их не записали, — к этому вернёмся в следующем параграфе.

Реквизит формы временный, а запись, на которую он указывает, — нет. Забыть можно выбор, но не сам склад.

4. Особые: таблица, которой нет в базе

Самый полезный из особых типов — таблица значений. У неё свои колонки, и задают их прямо в форме, как вложенные строки реквизита.

ОстаткиПоСкладам    таблица значений
├── Склад           ссылка на «Склады»
└── Количество      Число(15,3)

Похожа она на табличную часть, но устроена по-другому — и разница та же, что между реквизитом формы и реквизитом объекта.

Отсюда её работа: показать то, что посчитано, а не записано. Остаток товара по складам в записи товара не хранится — он в регистре, — но показать его в карточке таблицей удобно. Таблица значений даёт место, где такому результату жить, пока открыто окно. Сама она из базы ничего не читает: строки кладёт обработчик — или пользователь, если у таблицы на форме разрешено добавление строк.

5. Остальные особые типы — кратко

Остальные особые типы встретятся дальше в книге, здесь достаточно узнать их в лицо.

Последней строке стоит удивиться. «Список» — основной реквизит формы списка, о котором говорилось, когда разбирали основной реквизит, — и есть реквизит особого типа. Он особый даже среди особых: у него свои свойства, а записи для него платформа получает из базы запросом, который строит по этим свойствам. Форме списка он достаётся от конструктора так же, как «Объект» форме элемента. Подробный разговор о нём — в главе о списках.

6. Тип решает, каким будет элемент

Как и у реквизита объекта, вид элемента на экране следует из типа. Перетащили реквизит в элементы — редактор предложит подходящий.

Правило то же, что у автоформы: «вид поля — по типу реквизита». Только теперь это правило работает и для данных, которых в записи нет. Это короткий взгляд вперёд: как элемент связан с реквизитом — разговор следующей главы.

7. В Конфигураторе и в Предприятии

1. Откройте форму элемента «Товаров» и добавьте реквизит формы «ОстаткиПоСкладам» с типом «Таблица значений».

2. Добавьте ему две колонки: «Склад» — ссылка на «Склады», «Количество» — Число.

3. Перетащите реквизит в элементы: на форме появится таблица с двумя колонками.

4. Обновите конфигурацию базы данных и откройте карточку товара в Предприятии. Таблица есть — и пустая.

Пустота здесь честная. Таблице есть где жить, но заполнить её остатками из регистра может только обработчик, который при открытии формы спросит базу. Мы его не пишем: для этого параграфа важно, что у результата появилось место.

Главное в одном абзаце

Типы реквизитов формы делятся на три семьи: простые — одно значение, как у реквизитов объекта; ссылочные — указатель на запись; особые — целая структура, которой у реквизита объекта не бывает. Ссылочный реквизит формы временный, а запись, на которую он показывает, остаётся в базе: забыть можно выбор, но не сам склад. Главный из особых типов — таблица значений, рядом с ней список и дерево значений: колонки у неё задают прямо в форме, строки живут в данных открытого окна, и видит её только эта форма — этим она и отличается от табличной части, хотя похожа на неё. Такая таблица — место для того, что посчитано, а не записано, например для остатков по складам. Динамический список, основной реквизит формы списка, — тоже особый тип, со своими свойствами. Вид элемента по-прежнему следует из типа: поле ввода, поле-флажок, поле с кнопкой выбора, таблица.

У формы теперь есть свои данные — простые, ссылочные, целые таблицы, — и все они живут, пока открыто окно. Но и данные записи внутри «Объекта» тоже живут в форме. Что будет с изменённым артикулом, если окно закрыть, не записав?

Контрольные вопросы

1. На какие три семьи делятся типы реквизитов формы?
2. Какая семья есть только у реквизитов формы и почему?
3. Реквизит формы хранит ссылку на склад. Что пропадёт, если закрыть окно, а что останется?
4. Чем таблица значений в форме отличается от табличной части объекта?
5. Для чего форме таблица, которой нет в базе? Приведите пример.
6. К какой семье относится основной реквизит формы списка?
7. Как тип реквизита формы связан с элементом на экране?

Упражнения

По образцу. Добавьте форме элемента «Контрагентов» реквизит «ПоследниеПоступления» типа «Таблица значений» с колонками «Документ» и «Сумма». Выведите его таблицей.

Своё: подберите тип. Какой тип вы дадите реквизиту формы для каждого значения: «склад, выбранный для просмотра остатка», «варианты сортировки на выбор», «строки с итогами по месяцам», «признак, что форма открыта только для просмотра»?

Ловушка: «удалил выбор — удалился склад». Пользователь боится очищать поле «Выбранный склад» в карточке товара: «вдруг склад пропадёт из базы». Что вы ему объясните?

Обратный ход. В чужой форме видна таблица, но в дереве объекта нет табличной части с такими колонками. Где искать её данные и что это говорит о том, откуда берутся строки?

На чтение. В списке реквизитов формы: «Объект», «Список» и «ИтогиПоМесяцам» типа «Таблица значений». Что здесь не так?

Ответы — в конце части.

§ 3.6. Форма и запись: две жизни одних данных

С изменённым артикулом не будет ничего: закроете окно, не записав, — в базе останется прежний. И это не милосердие платформы, а устройство. Форма работает не с записью, а с её копией, и копия живёт ровно столько, сколько открыто окно.

1. Два срока жизни

Запись и форма живут по-разному, и это главное различие главы.

Последняя строка объясняет многое. Один и тот же товар могут открыть трое — и у каждого будет своя форма со своей копией данных.

Запись одна, а форм у неё столько, сколько людей её открыли. Форма — не запись, а разговор о ней.

2. Что происходит при открытии

Открытие формы — это не «показать запись», а цепочка из трёх шагов, и в ней снова видно разделение на клиента и сервер.

1. сервер читает запись из базы
2. копия попадает в данные формы
3. клиент строит окно по описанию
   формы и показывает копию

Дальше копия живёт на клиенте, у пользователя. Когда форме нужен сервер, платформа отправляет её данные туда и получает обратно — но сам сервер за каждым нажатием клавиши не следит: он не пересчитывает копию и не сохраняет её. Но форма ему не чужая — когда дело дойдёт до записи, именно сервер возьмёт данные формы и перенесёт их в запись.

3. Правка меняет копию

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

Форма при этом не молчит. С первой же правки платформа помечает её изменённой — и с этого момента при закрытии спросит, сохранять ли. Документация говорит и о втором действии: при интерактивном изменении данных система «устанавливает модифицированность и выполняет блокировку».

Блокировка означает не то, чего обычно пугаются. Сосед по-прежнему откроет тот же товар и всё в нём увидит. А вот изменить не сможет: платформа скажет, что данные заняты. Держится это до тех пор, пока первый не запишет или не закроет форму.

4. В базу — только явным действием

Копия уходит в базу не сама. Для этого есть действия, и все они видны пользователю кнопками.

Кнопки эти пришли к форме сами — стандартными командами от объекта, о чём говорилось в главе об автоформах. Но сути это не меняет: пока одна из них не нажата, база не знает о правках ничего.

Данные попадают в базу только явным действием. Ни закрытие окна, ни переход в другое поле записью не являются.

5. Закрыли без записи — копии нет

Здесь и кроется ответ на вопрос из прошлого параграфа. Закрытие окна завершает жизнь формы: вместе с ней исчезают и её собственные реквизиты, и копия записи.

открыли  → копия в форме
правили  → копия изменилась
закрыли  → копии нет
           в базе — прежнее

Пользователю платформа даёт последний шанс: при закрытии изменённой формы спрашивает, сохранять ли. Ответ «нет» означает ровно то, что написано, — копия исчезает вместе с правками.

Слово на будущее: окно может открываться так, что пользователь обязан сначала закончить с ним, — это называется модальным открытием, — или параллельно с другими, немодально. Разрешены ли модальные окна вообще, задаёт свойство конфигурации: режим использования модальности. В новых конфигурациях он выключен, и окна открываются немодально.

6. В режиме Предприятия

Опыт на две минуты, и он стоит того, чтобы проделать его руками.

1. Откройте карточку товара «Ручка шариковая» и запомните артикул.

2. Измените артикул, ничего не нажимая.

3. Откройте список товаров: в колонке артикула — прежнее значение. База правок не видела.

4. Вернитесь в карточку и закройте её. На вопрос о сохранении ответьте «нет».

5. Откройте карточку снова: артикул прежний. Копия ушла вместе с окном.

6. Повторите опыт, но нажмите «Записать и закрыть». Теперь и в списке новое значение. Верните прежний артикул: база серии должна остаться прежней.

Главное в одном абзаце

Запись и форма — два разных существа с разными сроками жизни: запись лежит в базе, пока её не удалили, а форма живёт от открытия окна до закрытия, и у одной записи их столько, сколько людей её открыли. При открытии сервер читает запись и отдаёт копию на клиента, в данные формы; дальше пользователь правит копию, а в базе остаётся прежнее. С первой правки платформа помечает форму изменённой и запирает запись для правки — смотреть её сосед сможет, менять нет, — а при закрытии спрашивает, сохранять ли. В базу данные попадают только явным действием — «Записать», «Записать и закрыть», «Провести»; закрытие окна записью не является, и вместе с окном исчезают и копия записи, и собственные реквизиты формы.

Свои формы мы разбирали, зная о них всё заранее. А если форма чужая — можно ли объяснить в ней каждый реквизит: и основной, и все остальные?

Контрольные вопросы

1. Сколько живёт форма и сколько — запись?
2. Сколько форм может быть открыто у одной записи и что у каждой внутри?
3. Что происходит, когда пользователь открывает карточку товара?
4. Пользователь изменил артикул и не нажал ничего. Что увидит его сосед, открывший тот же товар?
5. Какими действиями данные попадают в базу?
6. Что теряется при закрытии формы без записи?
7. Сосед открыл тот же товар, пока вы его правите. Что он увидит и что ему не удастся сделать?

Упражнения

По образцу. Проделайте опыт из параграфа на контрагенте: измените телефон, проверьте список, закройте без сохранения, откройте снова.

Своё: предскажите результат. Пользователь открыл товар, изменил наименование и, не записывая, нажал в карточке кнопку печати ценника (если бы она была). Какое наименование попало бы в ценник, если печать берёт данные из базы, и какое — если из формы?

Ловушка: «я же всё исправил». Кладовщик жалуется: «я поправил артикулы у десяти товаров, а в отчёте старые». Что он, скорее всего, делал и что ему объяснить?

Обратный ход. Пользователь говорит: «открываю товар на изменение, а система не даёт». Какие объяснения возможны и с чего начать проверку?

На чтение. В форме есть реквизит формы «ИтогоВес» и реквизит объекта «Вес» внутри «Объекта». Пользователь меняет вес в строке и закрывает форму без записи. Что стало с каждым из двух значений?

Ответы — в конце части.

§ 3.7. Чужая форма: основной реквизит и всё остальное

Объяснить можно, и порядок тот же, что в любом разборе: сначала предмет разговора, потом всё, что вокруг него. Список реквизитов читается за минуту и рассказывает о форме не меньше, чем её экран: по нему видно, о чём она и что считает сама, ещё до того, как вы посмотрите на поля.

1. Сначала основной

Первый вопрос к списку реквизитов — какой из них основной. Найти его просто: он выделен полужирным, а что он значит, говорит его тип.

В таблице три частых случая, а не весь список: основным реквизитом бывает и набор записей регистра — такие формы встретятся в разговоре об особых формах.

Предмет разговора — первое, что стоит записать при разборе. Дальше каждый следующий реквизит читается уже относительно него — «вокруг чего это».

2. Потом всё остальное — по трём вопросам

К каждому дополнительному реквизиту задают три вопроса. Ответы на первые два приходится искать, третий известен заранее.

Первые два ответа ищут в двух местах: в структуре элементов — есть ли поле, связанное с этим реквизитом, — и в командах формы. Третий искать не нужно: данные формы живут, пока открыто окно.

Отсюда рабочий приём. Если значение должно пережить закрытие окна, где-то рядом обязана быть запись — и стоит найти, куда это значение переносят.

Реквизит формы, значение которого должно пережить окно, — повод искать место, где его записывают. Нет такого места — перед вами ошибка проектирования.

3. Что говорит тип

Тип дополнительного реквизита почти всегда подсказывает назначение.

Строка про таблицу значений — самая говорящая: из базы такая таблица сама ничего не читает, строки в неё кладёт обработчик — или пользователь, если у таблицы на форме разрешено добавление строк.

Читать эту таблицу нужно как гипотезу, а не как ответ. Тип подсказывает назначение, а проверяют его по имени реквизита и по тому, где он используется: булево может оказаться не переключателем режима, а значением, которое потом запишут. И не всякий реквизит вообще выводится на экран — об этом прямо сейчас.

4. Реквизит есть, а элемента нет

Частая находка: реквизит в списке есть, а на форме его не видно. Ошибки тут обычно нет — это рабочий приём.

Последнюю строку отличают от первых трёх поиском: если реквизит не встречается нигде — ни у элемента, ни в командах, ни в модуле формы, — скорее всего, он остался от прошлой жизни формы. Такие находки стоит записывать: они объясняют, почему форма выглядит сложнее, чем работает.

5. Три ловушки списка реквизитов

Первая: искать реквизит формы в дереве объекта. Его там нет и не будет. Признак виден в свойствах поля, там, где записан путь к данным: путь без «Объект.» — значит, значение форма держит у себя.

Вторая: принять развёрнутый «Объект» за список реквизитов формы. Строки внутри основного реквизита — это реквизиты объекта, они хранятся в базе и видны запросу.

Третья: считать, что дополнительный реквизит где-то хранится. Само значение живёт, пока открыто окно, и никакой отчёт его не увидит. А вот запись, на которую он, может быть, указывает, никуда не денется: склад из базы не исчезнет оттого, что закрыли карточку товара.

6. Разбор по шагам

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

1. Найдите основной реквизит и запишите его тип. Назовите предмет разговора одной фразой.

2. Разверните основной реквизит и сверьте состав с деревом объекта: всё ли на месте, нет ли неожиданного.

3. Выпишите дополнительные реквизиты с типами.

4. Для каждого ответьте на два вопроса: откуда берётся значение и кто его меняет. Что будет при закрытии, вы уже знаете.

5. Отметьте те, у которых нет элемента на форме, и найдите, где они используются.

Разбор считается сделанным, когда каждый реквизит объяснён одной фразой про работу пользователя. Строка, которую объяснить не вышло, — не провал, а вопрос к автору формы; таких строк в чужих формах всегда находится одна-две.

Главное в одном абзаце

Читать список реквизитов начинают с основного — он выделен полужирным, — и его тип говорит, о чём форма: об одной записи, о множестве записей или вообще не о записи. Дальше каждый дополнительный реквизит разбирают тремя вопросами: откуда берётся значение, кто его меняет и что с ним станет при закрытии, — и третий ответ известен заранее, потому что данные формы исчезают вместе с окном. Тип даёт гипотезу о назначении: булево — переключатель, строка — поиск или отбор, число — итог, ссылка — выбор для отбора, таблица значений — результат, который кто-то собрал; проверяют гипотезу по имени реквизита и по тому, где он используется. Реквизит без элемента на форме — обычное дело: служебное значение, придержанный результат, связка между командами или след прежнего решения. А ловушек три: искать реквизит формы в дереве объекта, принимать развёрнутый «Объект» за реквизиты формы и думать, что дополнительный реквизит где-то хранится.

Реквизиты мы читать научились, но между ними и полями на экране осталась недосказанность. Поле показывает значение реквизита — а кто и где решил, какое поле какой реквизит показывает?

Контрольные вопросы

1. С какого реквизита начинают разбор формы и почему?
2. Что говорит о форме тип основного реквизита?
3. Какие три вопроса задают к дополнительному реквизиту?
4. Почему ответ на третий вопрос известен заранее?
5. О чём говорит реквизит формы с типом «таблица значений»?
6. Что может означать реквизит, для которого на форме нет элемента?
7. Назовите три ловушки при чтении списка реквизитов.

Упражнения

По образцу. Разберите по пяти шагам форму элемента «Товаров», которую вы собрали сами. Ответы известны заранее — проверяется порядок разбора.

Своё: объясните каждый. Возьмите форму, где есть и флажок, и таблица значений, и объясните каждый реквизит одной фразой про работу пользователя.

Ловушка: «этого поля нет в базе». Коллега разбирает чужую форму и говорит: «тут поле «Остаток», но в справочнике такого реквизита нет — форма сломана». Что вы ему ответите и куда предложите посмотреть?

Обратный ход. В форме есть реквизит «ВыбранныйСклад» типа ссылки на «Склады», но ни одного элемента для него нет. Какие объяснения возможны?

На чтение. Основной реквизит формы — динамический список, а рядом с ним реквизит «ТекущийТовар» типа ссылки на «Товары». О чём эта форма и зачем ей, скорее всего, второй реквизит?

Ответы — в конце части.

Ответы к части 3

Ответы собраны здесь, а не под вопросами: подсказка, увиденная сразу после вопроса, отменяет попытку вспомнить. У каждого ответа до трёх ступеней: сам ответ, указание — если ответ не дался сразу — и полное решение там, где рассуждение важнее вывода.

§ 3.1. Реквизит объекта и реквизит формы: одно слово, два смысла

К вопросу 1. Ответ. У реквизита объекта хозяин — объект, и значение лежит в базе у каждой записи. У реквизита формы хозяин — форма, и значение живёт в данных открытого окна.

К вопросу 2. Ответ. По умолчанию — пока открыто окно, и после закрытия не остаётся ничего. Исключение одно: если у формы включено сохранение данных в настройках, значение вернётся к этому пользователю при следующем открытии. В базу оно не попадает и тогда.

К вопросу 3. Указание. Куда смотрит запрос?

Полное решение. Запрос к базе видит то, что в базе хранится, и больше ничего. Реквизита формы там нет — он живёт в данных открытой формы. Дело не в запретах, а в адресе: запрос ищет не там, где лежит значение. Отсюда и практическое следствие: если значение понадобилось в отчёте, скорее всего, оно должно храниться, то есть быть реквизитом объекта.

К вопросу 4. Ответ. Спросить, можно ли получить значение запросом. Можно — реквизит объекта; нельзя — реквизит формы.

К вопросу 5. Ответ. Потому что устроены они похоже: имя, тип и хозяин. Различает их хозяин, а с ним и срок жизни.

К вопросу 6. Ответ. Значение на экране есть, а в базе его нет: это реквизит формы. Обычно это сигнал, что значение завели не там, где ему место.

К вопросу 7. Ответ. В форме, среди её реквизитов. В дереве справочника его нет и быть не должно: это не свойство товара.

К упражнению «По образцу». Ответ. В списке объекта — наименование, артикул, единица и стандартные реквизиты; в списке формы — строка «Объект», а всё остальное появляется там, только если его завели. Совпадений между списками может не быть вовсе.

К упражнению «Своё: придумайте реквизит». Ответ. Например, флажок «показывать подробности» и строка поиска внутри формы. Оба нужны, пока окно открыто, и не описывают товар: хранить их в базе значило бы записывать привычки одного пользователя в свойства вещи.

К упражнению «Ловушка: „добавь поле в справочник"». Ответ. Просят реквизит объекта, а нужен реквизит формы — или даже настройка пользователя.

Полное решение. Формулировка «добавить в карточку галочку» описывает результат на экране, а не место хранения. Ключ в словах «каждый пользователь включал её себе»: значение зависит не от товара, а от того, кто смотрит. Если завести такое реквизитом объекта, галочка станет общей для всех, потому что запишется в товар. Место такому значению в форме, а если оно должно пережить закрытие окна — в настройках пользователя, о которых книга скажет позже.

К упражнению «Обратный ход». Ответ. Либо это реквизит формы, которого в базе нет; либо реквизит объекта, который в отчёт просто не вывели. Различить можно по списку реквизитов объекта.

К упражнению «На чтение». Ответ. «Итого» — реквизит формы: он живёт, пока открыто окно, в базе его нет и запрос его не найдёт. Скорее всего, значение считают при открытии или при изменении строк, а храниться ему незачем.

§ 3.2. Основной реквизит: главный предмет разговора

К вопросу 1. Ответ. Он выделен в списке реквизитов формы — отмечен как основной.

К вопросу 2. Ответ. Создаёт конструктор, собирая форму по объекту. Не будет его у произвольной формы.

К вопросу 3. Ответ. От типа объекта и вида формы: у формы одной записи это сама запись, у формы списка — список.

К вопросу 4. Указание. Что отличает форму, пригодную для карточки товара, от формы, пригодной для списка?

Полное решение. Пригодность формы на роль определяется типом её основного реквизита. Форма с основным реквизитом типа «объект справочника» говорит об одной записи — она годится как форма элемента. Форма со списком — как форма списка или выбора. В свойствах объекта из пригодных выбирают основную. Так замыкается линия, начатая в параграфе о назначении: устройство формы решает, на что она годится, а объект — какую из годных открывать.

К вопросу 5. Ответ. Реквизит формы. Но тип у него — объект справочника, поэтому внутри него лежат реквизиты объекта: артикул, единица, наименование.

К вопросу 6. Ответ. Потому что разговор ведётся об одном предмете, и форма должна знать, о каком.

К вопросу 7. Ответ. Для разговоров не о записи: помощники, настройки, служебные диалоги. Обычно такие формы лежат в общих формах.

К упражнению «По образцу». Ответ. «Объект» типа СправочникОбъект.Контрагенты.

К упражнению «Своё: предскажите тип». Ответ. У формы документа — «Объект» типа ДокументОбъект.ПоступлениеТоваров; у формы списка контрагентов — «Список», динамический список.

К упражнению «Ловушка: „переименую — станет понятнее"». Ответ. Окно не изменилось: отметка «основной» и тип остались прежними. Изменилось имя, по которому к реквизиту обращаются.

Полное решение. Переименование касается только адреса. Всё, что держится на отметке и типе, — данные записи в полях, вопрос о сохранении при закрытии, пригодность формы на роль — работает как раньше. Но код формы, если он есть, обращается к реквизиту по имени и перестанет его находить, а коллеги, открыв форму, будут искать привычное «Объект». Ясности прибавилось только самому разработчику, и то до первого чужого взгляда.

К упражнению «Обратный ход». Ответ. У формы нет предмета разговора: это произвольная форма. Скорее всего, она лежит в общих формах или открывается явно, а в основные формы объекта её не ставят.

К упражнению «На чтение». Ответ. Предмет разговора — «Объект» типа ДокументОбъект.Заказ, основной реквизит. «ПоказыватьОплаты» — вспомогательный реквизит формы: флажок, который живёт, пока открыто окно.

§ 3.3. Разворачиваем «Объект»: откуда в форме реквизиты товара

К вопросу 1. Ответ. Всё, из чего состоит запись: стандартные реквизиты вроде кода и наименования и реквизиты, заведённые в дереве справочника.

К вопросу 2. Ответ. Из типа основного реквизита. В форме хранится одна строка «Объект» с типом объекта справочника, а состав типа платформа берёт из описания справочника.

К вопросу 3. Ответ. Внутри «Объекта» новый реквизит появился сам. На экране ничего не изменилось: поля для него никто не положил.

К вопросу 4. Указание. Какие части формы хранятся в ней самой, а какие приносит тип?

Полное решение. У формы две разные части. Данные записи видны через тип основного реквизита, и этот тип всегда описывает объект таким, какой он сейчас, — поэтому новый реквизит внутри «Объекта» появляется сам. Раскладка — элементы, поля на экране — хранится в самой форме: это решение, принятое когда-то и записанное. Новое поле само себя не положит. Отсюда «отставание» своей формы: отстаёт не то, что форма знает, а то, что она показывает.

К вопросу 5. Ответ. Реквизит «Артикул» у записи, о которой разговаривает форма. Путь с другого начала ведёт к значению, которое форма держит у себя.

К вопросу 6. Ответ. На звено длиннее: Объект.Товары.Количество.

К вопросу 7. Ответ. Развернув основной реквизит: отдельными строками реквизиты объекта в списке формы не перечисляются.

К упражнению «По образцу». Ответ. Из дерева справочника — ИНН, Телефон и КонтактноеЛицо; стандартные — ссылка, код, наименование, пометка удаления. Родителя нет: справочник контрагентов не иерархический.

К упражнению «Своё: предскажите путь». Ответ. В форме контрагента — Объект.ИНН; в форме поступления — Объект.Товары.Цена.

К упражнению «Ловушка: „реквизит добавил, а форма не видит"». Ответ. Форма видит новый реквизит — данными, внутри «Объекта». Не видно поля. Нужно не пересоздавать форму, а положить поле, перетащив реквизит в элементы.

Полное решение. Пересоздание решило бы задачу грубо: конструктор снял бы свежий снимок, и поле появилось бы — но вместе с этим пропала бы вся раскладка, которую разработчик успел сделать. Путаница в том, что «форма не видит» смешивает две части формы. Данные у неё свежие, отстала раскладка — и лечится именно она, одним перетаскиванием.

К упражнению «Обратный ход». Ответ. «Комментарий» — реквизит объекта: он хранится в записи, о которой разговаривает форма, и в дереве объекта найдётся.

К упражнению «На чтение». Ответ. «Объект» — данные документа поступления, хранятся в базе. «ИтогоВес» — реквизит формы: живёт, пока открыто окно, и считается формой, в базе его нет.

§ 3.4. Дополнительные реквизиты формы: данные помимо записи

К вопросу 1. Ответ. Рядом с «Объектом», а не внутри него. Путь к ним — одно имя, без «Объект.».

К вопросу 2. Ответ. Вспомогательное значение для расчёта, временное значение ввода, переключатель режима.

К вопросу 3. Ответ. Понадобится ли это значение завтра другому человеку, открывшему ту же запись. Да — в запись; нет — в форму.

К вопросу 4. Ответ. Реквизит — это данные; на экране появляется элемент. Пока из реквизита не сделали элемент, пользователю показывать нечего.

К вопросу 5. Ответ. Даёт место для значения и возможность вывести его флажком. Не даёт реакции на изменение: чтобы флажок что-то прятал, нужен обработчик.

К вопросу 6. Указание. Одно из свойств — про вопрос при закрытии, другое — про память между открытиями. Какое у кого?

Полное решение. «Сохраняемые данные» — свойство реквизита. Оно делает изменение этого реквизита правкой данных формы: форма помечает себя изменённой и при закрытии спрашивает, сохранить ли. Сохранение данных в настройках — свойство формы, и оно про другое: значение отмеченного реквизита запоминается для пользователя и возвращается при следующем открытии. Первое отвечает на вопрос «было ли что сохранять», второе — «помнить ли выбор».

К вопросу 7. Ответ. Значение реквизита формы живёт, пока открыто окно: закрыли — оно пропало. Сохранение в настройках у формы включено не было.

К упражнению «По образцу». Ответ. В списке реквизитов формы контрагента рядом с «Объектом» появляется «ПоказыватьКонтакты», а после перетаскивания в элементы — поле, показанное флажком.

К упражнению «Своё: запись или форма». Ответ. Дата последней сверки — в запись: её спросит и другой человек. Строка поиска — в форму: она нужна одному окну. Количество строк — в форму: его можно посчитать в любой момент. Примечание к поступлению — в запись: оно часть документа.

К упражнению «Ловушка: „сделай, чтобы флажок работал"». Ответ. Сделано место для значения и флажок на экране. Не сделан обработчик, который на изменение флажка прячет и показывает поля. Это не ошибка, а половина задачи.

Полное решение. Заказчик видит результат на экране и ждёт поведения. Но поведение и данные — разные слои: реквизит формы хранит значение, а реакцию на его изменение задаёт обработчик. Сделанное не лишнее: без реквизита обработчику нечего было бы проверять. Честный ответ заказчику — «значение заведено, поведение будет добавлено», а не «сейчас починим».

К упражнению «Обратный ход». Ответ. Свойство «Сохраняемые данные» у реквизита формы, в котором хранится режим просмотра. Скорее всего, оно включено, и форма считает переключение режима правкой данных.

К упражнению «На чтение». Ответ. «Отбор» — строка, по которой, скорее всего, ищут в табличной части; «ИтогоВес» — посчитанный при открытии или при изменении строк итог. Оба нужны одному окну, завтра другому пользователю не понадобятся.

§ 3.5. Типы реквизитов формы: простые, ссылочные, особые

К вопросу 1. Ответ. Простые — одно значение; ссылочные — указатель на запись; особые — целая структура: таблица, список и дерево значений, динамический список.

К вопросу 2. Ответ. Особые. Реквизит объекта хранится в базе, и тип ему можно дать лишь такой, какой база умеет хранить в записи; данные формы живут в открытом окне, и ограничения хранения на них не действуют.

К вопросу 3. Ответ. Пропадёт выбор — сама ссылка в реквизите формы. Останется склад: запись лежит в базе и от закрытия окна не зависит.

К вопросу 4. Указание. Сравните по четырём признакам: где задана, где строки, кто видит, какой путь.

Полное решение. Табличная часть задана в дереве объекта, её строки хранятся в базе у записи, видны любой форме объекта и запросу, путь к ней — Объект.Товары. Таблица значений задана в форме, строки живут в данных открытого окна, видит их только эта форма, путь — просто имя реквизита. Похожи они внешне — строки и колонки, — но первая часть записи, а вторая часть разговора.

К вопросу 5. Ответ. Чтобы показать то, что посчитано, а не записано. Например, остатки товара по складам: они хранятся в регистре, а в карточке товара их удобно показать таблицей.

К вопросу 6. Ответ. К особым: «Список» формы списка — динамический список, со своими свойствами.

К вопросу 7. Ответ. Вид элемента следует из типа: строка, число и дата — поле ввода, булево — поле-флажок, ссылка — поле с кнопкой выбора, таблица значений — таблица.

К упражнению «По образцу». Ответ. Рядом с «Объектом» появляется «ПоследниеПоступления» с колонками «Документ» и «Сумма», а в элементах — таблица. В Предприятии она пустая: заполнить её может только обработчик.

К упражнению «Своё: подберите тип». Ответ. Склад для просмотра — ссылка на «Склады»; варианты сортировки — список значений; итоги по месяцам — таблица значений; признак «только просмотр» — булево.

К упражнению «Ловушка: „удалил выбор — удалился склад"». Ответ. Поле хранит ссылку на склад, а не сам склад. Очистить поле — значит убрать ссылку; запись склада в базе останется.

Полное решение. Страх понятен: в поле видно наименование склада, и кажется, что это и есть склад. Но реквизит формы — временный и хранит только указатель на запись. Очистка поля меняет указатель, а не то, на что он указывал. Чтобы склад действительно исчез, его нужно пометить на удаление в самом справочнике — совсем другое действие в другом месте.

К упражнению «Обратный ход». Ответ. В реквизитах формы: таблица, которой нет среди табличных частей объекта, — реквизит формы, скорее всего таблица значений. Её строки не хранятся в записи: их при открытии или по действию кладёт обработчик.

К упражнению «На чтение». Ответ. «Объект» и «Список» — основные реквизиты разных видов форм, и вместе в одной форме они не встречаются: основной реквизит один. «ИтогиПоМесяцам» — обычный дополнительный реквизит.

§ 3.6. Форма и запись: две жизни одних данных

К вопросу 1. Ответ. Форма живёт от открытия окна до закрытия. Запись лежит в базе, пока её не удалили.

К вопросу 2. Ответ. Столько, сколько людей открыли запись. У каждой формы внутри своя копия данных этой записи.

К вопросу 3. Ответ. Сервер читает запись из базы, копия попадает в данные формы, клиент строит по описанию формы окно и показывает копию.

К вопросу 4. Ответ. Прежний артикул: правка изменила копию в форме, а не запись в базе.

К вопросу 5. Ответ. «Записать», «Записать и закрыть», а у документа ещё и «Провести». Закрытие окна записью не является.

К вопросу 6. Указание. Что вообще живёт в форме?

Полное решение. Теряется всё, что жило в форме: и собственные её реквизиты — флажки, отборы, посчитанные таблицы, — и копия записи с несохранёнными правками. В базе остаётся то, что там было до открытия окна. Именно поэтому платформа перед закрытием измененной формы спрашивает о сохранении: другого шанса не будет.

К вопросу 7. Ответ. Увидит товар и все его данные — открыть на просмотр никто не мешает. Не удастся изменить: запись заперта для правки, пока вы не запишете или не закроете форму.

К упражнению «По образцу». Ответ. В списке контрагентов телефон прежний, пока не нажата запись; после закрытия без сохранения карточка открывается с прежним телефоном.

К упражнению «Своё: предскажите результат». Ответ. Из базы напечаталось бы прежнее наименование, из формы — новое. Разница и есть та самая граница между записью и копией.

К упражнению «Ловушка: „я же всё исправил"». Ответ. Скорее всего, он правил карточки и закрывал их, не записывая, — отвечая «нет» на вопрос о сохранении или закрывая крестиком. В базу правки не попали.

Полное решение. Ощущение «я всё исправил» опирается на то, что человек видел новые значения на экране. Видел он копию. Объяснять стоит не через устройство платформы, а через действие: правка считается сделанной, когда нажата запись; до этого она живёт только в открытом окне. Проверить легко — открыть список рядом: он показывает базу, а не чужую форму.

К упражнению «Обратный ход». Ответ. Скорее всего, ту же запись правит сейчас другой сеанс и она заперта для изменения. Начать стоит с вопроса, кто ещё держит эту карточку открытой; вторая возможность — не хватает прав на изменение.

К упражнению «На чтение». Ответ. Оба значения исчезли вместе с формой: «ИтогоВес» жил в форме, изменённый «Вес» лежал в копии записи. В базе — прежний вес.

§ 3.7. Чужая форма: основной реквизит и всё остальное

К вопросу 1. Ответ. С основного: он выделен полужирным и называет предмет разговора. Пока не назван предмет, остальные реквизиты не к чему отнести.

К вопросу 2. Ответ. Объект справочника или документа — форма об одной записи; динамический список — о множестве записей; основного нет — форма не о записи: помощник, настройки, служебный диалог.

К вопросу 3. Ответ. Откуда берётся значение, кто и когда его меняет и что с ним станет при закрытии формы.

К вопросу 4. Ответ. Потому что данные формы живут, пока открыто окно: при закрытии значение исчезнет вместе с формой.

К вопросу 5. Указание. Кто кладёт в такую таблицу строки?

Полное решение. Таблица значений — место для того, что посчитано, а не записано. Из базы она сама ничего не читает, поэтому её появление означает, что строки кто-то кладёт: обработчик при открытии или по команде, а иногда сам пользователь, если таблице разрешено добавлять строки. Отсюда следующий шаг разбора — найти, где эта таблица наполняется: там и будет видно, зачем форме такой реквизит.

К вопросу 6. Ответ. Служебное значение, придержанный до нужного момента результат, связку между командами формы — или след прежнего решения, если реквизит нигде не используется.

К вопросу 7. Ответ. Искать реквизит формы в дереве объекта; принимать развёрнутый «Объект» за список реквизитов формы; считать, что дополнительный реквизит где-то хранится.

К упражнению «По образцу». Ответ. Основной реквизит «Объект» типа СправочникОбъект.Товары — форма об одной записи справочника; внутри него состав товара из дерева; дополнительных реквизитов столько, сколько вы завели сами, и у каждого известно, откуда он взялся.

К упражнению «Своё: объясните каждый». Ответ. Каждая фраза должна быть о работе пользователя, а не об устройстве: «флажок решает, показывать ли подробности», «в таблице — остатки по складам, чтобы не открывать отчёт». Фраза вида «булево, потому что булево» объяснением не считается.

К упражнению «Ловушка: „этого поля нет в базе"». Указание. С какого имени начинается путь у этого поля?

Полное решение. Форма не сломана: поле связано не с реквизитом объекта, а с реквизитом формы, и в дереве справочника такого искать бессмысленно. Смотреть нужно в список реквизитов формы: там «Остаток» найдётся рядом с «Объектом», а не внутри него, и путь у поля будет без «Объект.». Значение в базе не хранится — его при открытии формы кто-то считает, чаще всего по регистру.

К упражнению «Обратный ход». Ответ. Возможны три объяснения: реквизит держит служебное значение и на экран не выводится; его кладёт одна команда, а читает другая; он остался от прежнего решения. Различают поиском: где «ВыбранныйСклад» используется — у элемента, в команде, в модуле формы.

К упражнению «На чтение». Ответ. Форма о множестве записей — список товаров. «ТекущийТовар», скорее всего, держит товар, на котором стоит курсор, чтобы форма могла что-то о нём показать или сделать; в базе это значение не хранится и исчезнет вместе с окном.

§ 4.1. Элемент формы: то, что пользователь видит и трогает

Решение записано у самого поля — в свойстве, где сказано, откуда оно берёт значение. Читать эту запись мы будем в следующем параграфе, а сначала договоримся, что считать полем и чем оно отличается от всего остального, что стоит в окне. Слово для этого в 1С есть: элемент формы.

1. Элемент — это то, что видно

Всё, что пользователь видит в окне и на что может нажать, — элементы формы. Поле ввода, флажок, таблица, кнопка, подпись над группой полей: каждый из них — отдельный элемент со своим именем и своими свойствами.

Список короткий, и это не случайность: из этих пяти видов элементов собирается любая форма, какой бы сложной она ни выглядела. Разнообразие даёт не их число, а настройки каждого — у поля, у группы и у декорации есть ещё и собственное свойство «Вид» со своим списком значений: им задают, каким именно полем или какой группой элемент будет. Слово одно, уровня два: вид элемента и вид поля. Виды поля разберём дальше в этой главе, а виды группы и декорации — в главе о композиции.

Элемент формы — единица того, что видно. Данные отвечают на вопрос «о чём форма», элементы — на вопрос «что у неё на экране».

2. Живут элементы деревом

Эти пять видов не лежат россыпью: они выстроены в дерево, и корень у него один — элемент «Форма», сама форма как целое.

Форма                     ← корень
├── Наименование          ← поле
├── Артикул               ← поле
├── ПоказыватьПодробности ← поле-флажок
├── ОстаткиПоСкладам      ← таблица
└── ЕдиницаИзмерения      ← поле

Вложенность в этом дереве — не украшение, а порядок показа: что вложено в группу, то внутри её рамки и окажется, а порядок строк задаёт порядок показа. Развернётся он сверху вниз или слева направо — решают настройки группы; об этом разговор в главе о композиции, здесь достаточно увидеть, что структура есть и что читают её сверху вниз.

3. У каждого элемента своё имя

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

Последняя строка объясняет добрую половину путаницы. Перетащили реквизит «Артикул» в элементы — редактор создал поле и назвал его тоже «Артикул». Одинаковые имена в двух списках выглядят как одна вещь, а вещей две: строка в реквизитах — данные, строка в элементах — способ их показать.

Совпадение имён — привычка редактора, а не свойство платформы. Имя элемента можно сменить, и от этого не изменится ни одно значение в базе.

4. Элемент живёт только в форме

Реквизит объекта задан в дереве, и любая форма этого объекта видит его через свой основной реквизит — так же, как мы разбирали в прошлой главе. С элементом не так: он существует внутри одной формы и больше нигде.

Справочник «Товары»
├── Реквизиты ──────── общие для всех
└── Формы
    ├── ФормаЭлемента ─ свои элементы
    └── ФормаСписка ─── свои элементы

Отсюда следствие, которое пригодится при разборе. Одно и то же значение в двух формах показывают два разных элемента, и настроены они могут быть по-разному: в карточке артикул — поле ввода, в списке — колонка. Спорить, «как выглядит артикул», бессмысленно, не назвав форму.

5. Свойства: чем элементом управляют

У элемента есть палитра свойств, и почти всё, что он умеет, задано там. Свойств много, и в палитре они разложены по своим группам; нам для чтения удобно держать в голове три: про данные, про внешний вид, про поведение. Деление это наше, а не платформенное: иное свойство попадает сразу в две группы — заголовок, например, и про вид, и про данные, если оставить его пустым.

Первая строка — ось всей главы, и есть она не у всех. Путь к данным задают там, где есть что показывать: у поля и у таблицы. Остальным трём показывать нечего.

Документация о декорации говорит прямо: это элемент, предназначенный для оформления, в отличие от поля. Она на экране видна, а к разговору о товаре отношения не имеет.

Внешний вид и поведение развернём в конце главы; здесь довольно того, что по смыслу свойства делятся на эти три группы.

6. Что из этого следует для чтения

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

Первые два вопроса закрываются взглядом на структуру элементов, вторые два — палитрой свойств. Порядок именно такой: сначала опознать элемент, потом спрашивать, чем он занят.

7. В Конфигураторе

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

1. Откройте форму элемента «Товаров» и перейдите к структуре элементов.

2. Выпишите все элементы сверху вниз и против каждого — его вид: поле, таблица, группа, кнопка, декорация.

3. Найдите корневой элемент «Форма» и убедитесь, что остальные вложены в него.

4. Щёлкните по полю «Артикул» и посмотрите палитру свойств: имя, свойства внешнего вида, свойство с путём к данным.

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

Пятый шаг — главный. Реквизит без элемента и элемент без реквизита — доказательство с двух сторон: данные и элементы разные списки, и один другому не равен.

Главное в одном абзаце

Элемент формы — единица того, что видно: поле, таблица, кнопка, группа, декорация; из этих пяти видов собирается любое окно, а разнообразие даёт не их число, а настройки каждого. Элементы выстроены деревом с корнем «Форма», и порядок в дереве задаёт порядок показа. У каждого элемента своё имя, и то, что оно часто совпадает с именем реквизита, — привычка редактора, а не тождество: строка в реквизитах это данные, строка в элементах — способ их показать. Живёт элемент только в своей форме, поэтому одно значение в карточке и в списке показывают разные элементы, настроенные по-разному. Управляют элементом свойства, и по смыслу их удобно делить на три группы: данные, внешний вид, поведение. Путь к данным есть только у тех, кому есть что показывать, — у поля и у таблицы; группа собирает, кнопка действует, декорация поясняет.

Имена совпадают, списки разные, а на экране всё выглядит одним целым. Если элемент — не данные, то что именно изменится, если его убрать? И что останется от формы, если убрать реквизит?

Контрольные вопросы

1. Что такое элемент формы и какие пять видов элементов бывают?
2. Как устроена структура элементов и что означает порядок в ней?
3. Почему имя элемента часто совпадает с именем реквизита и что это означает?
4. Где живёт элемент и почему его нет в дереве объекта?
5. Одно значение показано в карточке и в списке. Сколько тут элементов?
6. На какие три группы делятся свойства элемента?
7. У каких элементов нет пути к данным и почему?

Упражнения

По образцу. Выпишите структуру элементов формы элемента «Контрагентов» и проставьте против каждой строки вид элемента.

Своё: назовите вид. Для каждого из описаний назовите вид элемента: рамка «Контактные данные» вокруг двух полей; надпись «Заполняется автоматически»; строка с телефоном; кнопка «Провести»; список поступлений внизу карточки.

Ловушка: «переименовал поле — потерял данные». Разработчик переименовал в форме элемент «Артикул» в «ПолеАртикула» и боится, что в базе что-то испортится. Что на самом деле изменилось и что нет?

Обратный ход. В структуре элементов есть строка, для которой в реквизитах формы нет пары, а в дереве объекта — тоже нет. Что это может быть?

На чтение. В форме два элемента с именами «Наименование» и «НаименованиеПодпись». Что можно предположить о каждом, не открывая свойства?

Ответы — в конце части.

§ 4.2. Почему элементы не равны данным

Откройте карточку товара и уберите из структуры поле «Артикул», не трогая реквизиты. В списке товаров артикул никуда не денется — его просто перестанут показывать в одной карточке. А теперь наоборот: представьте, что исчез реквизит формы, а поле осталось. Адрес у поля есть, вести ему некуда. Два удаления, два разных исхода, и вся суть параграфа — в этой разнице: то, что хранят, и то, чем показывают, живут врозь.

1. Два удаления

Проще всего увидеть разницу, сравнив два действия, которые на экране дают похожий результат.

Речь именно о реквизите формы. Реквизит объекта убирают в дереве, и это разговор о хранении, а не о показе: значение исчезает у всех записей сразу.

Первая строка — обычное дело: так прячут от пользователя то, что ему не нужно. Вторая — почти всегда ошибка, и заметна она не сразу. Элементы, у которых пути к данным нет вовсе, — декорации, кнопки, группы — от такого удаления не страдают: им и показывать было нечего.

Элемент можно убрать без потерь для данных. Данные без элемента живут, элемент без данных — нет.

2. Главный обман: «нарисовал поле — завёл данные»

Ошибка новичка звучит так: раз поле на форме появилось, значит, и место для значения появилось. Растёт она из жеста, который мы делали не раз.

перетащили реквизит в элементы
├── создан элемент     ← как видно
└── задана связь       ← с чем связан

Жест один, действий два, и редактор делает оба сам, ни о чём не спрашивая. Скрытым второе не остаётся: связь видна в свойствах созданного элемента. А вот если добавить элемент не перетаскиванием, а вручную, задавать её придётся самому — иначе поле останется ни с чем.

Последняя строка — самая коварная: пустое поле выглядит одинаково в двух самых частых случаях, а бывают и другие.

3. Четыре сочетания

Раз это две вещи, они сочетаются четырьмя способами — и все четыре встречаются в живых формах.

Верхняя левая клетка — то, что видно в форме чаще всего. Правая верхняя знакома по прошлой главе: реквизит формы без элемента — служебное значение или результат, который кладёт в него обработчик. Нижняя левая — элементы, которым нечего показывать по их природе.

Есть ли что показывать — решает реквизит формы. Показано ли оно и как — решает элемент со своими свойствами.

4. Один реквизит — сколько угодно элементов

Раз элемент только показывает, ничто не мешает показать одно значение несколько раз и по-разному.

Объект.Артикул
├── поле в карточке
├── колонка в списке
└── поле в форме выбора

Все три элемента показывают одно и то же значение из базы: изменили в одном месте, записали — увидели везде. Обратное неверно: свойство с путём к данным у элемента одно — одна строка, один адрес. Вести он может куда угодно — в реквизит формы, в реквизит объекта, в колонку табличной части, — но он один.

5. Связь называется путём к данным

У элемента есть свойство, в котором записано, что он показывает. Записано оно именем: «Объект.Артикул», «ПоказыватьПодробности» — те самые пути, которые мы читали в прошлой главе.

Пусто это свойство — элемент ни с чем не связан. Заполнено — связан ровно с тем, что там написано. Читать и задавать его будем в следующем параграфе; здесь важно другое: связь — не подразумевается, а записана, и её видно. А раз видно, ею можно пользоваться при разборе поломок.

6. Зачем это при чтении чужой формы

Разделение данных и элементов превращает три частых жалобы в три разных поиска.

Третью строку мы разбирали в главе о данных, первые две — дело этой главы. Общее у них одно: прежде чем чинить, называют, что именно сломано — показ или данные.

7. В Конфигураторе и в Предприятии

Опыт с удалением, после которого ничего не придётся восстанавливать из копии.

1. Откройте форму элемента «Товаров» и удалите из структуры элементов поле «Артикул». Реквизиты не трогайте.

2. Обновите конфигурацию базы данных и откройте карточку товара в Предприятии: поля нет.

3. Откройте список товаров: колонка артикула на месте, и значение в ней прежнее. Данные никуда не делись — их перестала показывать одна форма.

4. Вернитесь в форму и перетащите «Артикул» из реквизитов обратно в элементы. Обновите конфигурацию: поле вернулось, значение прежнее.

Четвёртый шаг стоит проделать внимательно: возвращённое поле встанет, скорее всего, не туда, где стояло. Данные это не задело — а порядок на экране пришлось восстанавливать руками. Ровно в этом и состоит разница между тем, что хранится, и тем, что показывают.

Главное в одном абзаце

Элемент и данные — две разные вещи с разной судьбой: уберёшь элемент — значение останется, уберёшь реквизит — показывать станет нечего. Главный обман новичка, «нарисовал поле — завёл данные», растёт из перетаскивания: жест один, а действий за ним два — создать элемент и связать его с данными. Сочетаний поэтому четыре, и все они живые: реквизит с элементом — обычное поле, реквизит без элемента — значение, которое не показывают, элемент без реквизита — декорация, кнопка или группа, и пустое место, когда нет ни того ни другого. Есть ли что показывать — решает реквизит, показано ли оно и как — элемент со своими свойствами; одно значение показывают сколько нужно элементов, а адрес у элемента один. Связь между ними не подразумевается, а записана в свойстве элемента — в пути к данным.

Связь записана, и записана именем. Но какое имя туда попадает, что оно означает по частям — и что будет, если написать не то?

Контрольные вопросы

1. Что происходит с данными, если удалить элемент, и что — если удалить реквизит?
2. Почему возникает обман «нарисовал поле — завёл данные»?
3. Какие два действия скрыты в перетаскивании реквизита в элементы?
4. Назовите четыре сочетания реквизита и элемента и приведите пример каждого.
5. Сколько элементов может показывать один реквизит и сколько реквизитов может показывать один элемент?
6. Поле на форме пустое. Какие причины у этого возможны?
7. Где записана связь элемента с данными?

Упражнения

По образцу. Проделайте опыт из параграфа на форме элемента «Контрагентов»: удалите поле телефона, посмотрите список, верните обратно.

Своё: разложите по клеткам. Отнесите к одной из четырёх клеток: кнопка «Записать», поле артикула, реквизит формы «ОстаткиПоСкладам» без выведенной таблицы, надпись «Все цены без НДС».

Ловушка: «удалил поле — потерял данные». Коллега случайно удалил с формы поле «ЕдиницаИзмерения» и говорит, что теперь единицы у товаров пропали. Как проверить это за минуту и что вы ему скажете?

Обратный ход. В форме есть поле, а значения в нём никогда не видно, хотя у товаров значение заполнено. Какие объяснения возможны и в каком порядке их проверять?

На чтение. В форме поступления два элемента связаны с «Объект.Контрагент»: поле в шапке и ещё одно поле рядом с итогом — показывает, но ввода не принимает. Что это значит и ошибка ли это?

Ответы — в конце части.

§ 4.3. Поле и его путь к данным

В свойство попадает адрес — имя того, что поле показывает. Документация говорит об этом свойстве коротко: оно содержит путь к реквизиту, с которым связан элемент. Адрес этот читается по частям, и прочитать его — значит ответить на главный вопрос о любом поле: откуда оно берёт значение.

1. Поле — элемент, который показывает одно значение

Из пяти видов элементов поле встречается чаще прочих, и работа у него простая: показать одно значение и, если разрешено, дать его изменить. Строки — не его дело, для них есть таблица.

В документации это сказано так: поле предназначено для показа и редактирования реквизитов формы нетабличных типов, а внутри таблицы поле становится её колонкой. Читать это нужно как «поле показывает одно значение, а не таблицу целиком»: значение это может быть и из табличной части — тогда поле и живёт колонкой. К колонкам вернёмся в главе о списках.

2. Путь читается по частям

Путь — это имя, собранное через точку. Первая часть называет то, чем располагает форма, то есть её реквизит — чаще всего основной, «Объект»; остальные части уточняют, что взять внутри.

Правило чтения у нас уже есть — оно из главы о данных: начинается с «Объект.» — значит, перед нами данные записи, о которой форма разговаривает; начинается с другого имени — значит, форма держит это значение у себя.

Путь к данным — адрес, а не копия. Поле не держит значение у себя: оно показывает то, что лежит в данных формы по этому адресу, и по этому же адресу отправляет введённое обратно.

3. Путь не пишут, его выбирают

Свободного текста здесь нет: путь задают, выбирая из списка того, чем форма располагает.

Отсюда следствие, успокаивающее новичка: выбирая из списка, ошибиться трудно — там только то, что у формы есть. Набрать путь руками редактор тоже позволяет, и вот тогда опечатка возможна. А испортиться путь может и позже — об этом чуть ниже.

4. Из пути поле узнаёт свой тип

Связь даёт полю больше, чем значение. Из данных приходит тип, а из типа — то, как поле выглядит и ведёт себя по умолчанию.

Правило, которое встречалось ещё в разговоре об автоформах, здесь получает точное объяснение. Вид поля следует из типа реквизита не потому, что платформа угадывает, а потому, что поле спрашивает тип по своему адресу. Слово «по умолчанию» тут не лишнее: у поля есть и собственное свойство «Вид», которым выбор платформы можно изменить, — об этом следующий параграф.

Поле не хранит тип у себя: оно спрашивает его у данных, на которые указывает. А вид, подсказанный типом, можно и переопределить.

5. Когда путь ведёт в пустоту

Опечатки нет, а сломаться связь всё-таки может: реквизит удалили или переименовали, а поле осталось со старым адресом.

было:  Объект.Артикул  → реквизит
стало: Объект.Артикул  → нет такого

Эти два случая стоит различать с самого начала: путь не задан — связи никогда не было; путь ведёт в пустоту — связь была и устарела. Поле в обоих случаях пустое, а чинят их по-разному: в первом связь задают, во втором ищут, что случилось с реквизитом.

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

6. Как читать поле в чужой форме

Разбор одного поля укладывается в три вопроса, и все три закрываются свойством с путём.

Есть и четвёртый вопрос, который задают, когда пути нет вовсе: чем занят элемент, если он ничего не показывает? Ответов два. Либо это кнопка, группа или декорация — им путь и не положен. Либо это поле, которому связь просто не задали: так бывает у элемента, добавленного вручную.

7. В Конфигураторе

Соберём и прочитаем связь своими руками.

1. Откройте форму элемента «Товаров», выделите поле «Артикул» и найдите в палитре свойств путь к данным. Прочитайте его вслух по частям.

2. Посмотрите путь у поля-флажка «ПоказыватьПодробности»: он из одной части — это данные формы, а не записи.

3. Добавьте в элементы новое поле вручную, не перетаскиванием. Посмотрите на предпросмотр: поле есть, показывать ему нечего.

4. Задайте новому полю путь к данным, выбрав «Объект.Наименование». Теперь на форме два элемента показывают одно значение — то самое, о чём говорил прошлый параграф.

5. Удалите добавленное поле: оно было нужно для опыта.

Третий шаг стоит запомнить: именно так выглядит элемент, которому не задали связь. Не «сломан», не «пуст» — просто ни с чем не связан.

Главное в одном абзаце

У поля есть свойство, в котором записан путь к данным — адрес того, что поле показывает; документация так и говорит: путь к реквизиту, с которым связан элемент. Читается адрес по частям через точку: первая часть называет реквизит формы, остальные уточняют, что взять внутри, — «Объект.Артикул» это данные записи, «ПоказыватьПодробности» данные самой формы. Пишут путь не руками: его выбирают из списка того, чем форма располагает, поэтому опечатки почти исключены — зато адрес может повиснуть, если реквизит потом удалили или переименовали. Из пути поле узнаёт тип, а из типа берётся его вид и поведение: календарь у даты, кнопка выбора у ссылки, флажок у булева — поле не знает своего типа, оно узнаёт его у данных. Поэтому разбор любого поля начинается с одного места: посмотреть путь и прочитать его по частям.

Тип пришёл из данных и сам выбрал полю вид. Но у поля есть и собственное свойство «Вид» — значит, выбор платформы можно изменить? И насколько далеко это заходит: одно значение — сколько способов показать?

Контрольные вопросы

1. Что записано в свойстве «путь к данным» и как оно читается?
2. Что означает путь, начинающийся с «Объект.», и чем он отличается от пути из одной части?
3. Как выглядит путь к колонке табличной части?
4. Почему опечатка в пути почти невозможна и как он тогда может повиснуть?
5. Откуда поле берёт свой тип и что из этого следует для его вида?
6. Что показывает поле, которому не задали путь?
7. Какие три вопроса о поле закрывает его путь к данным?

Упражнения

По образцу. Выпишите пути к данным всех полей формы элемента «Контрагентов» и отметьте, какие из них ведут в запись, а какие — в данные формы.

Своё: предскажите вид. Не открывая редактор, скажите, что появится у поля, связанного с реквизитом «Дата» документа, с реквизитом «Контрагент» и с реквизитом формы типа Булево.

Ловушка: «поле сломалось». После того как из справочника убрали реквизит, в форме осталось поле, которое ничего не показывает. Коллега предлагает пересобрать форму заново. Что вы предложите вместо этого?

Обратный ход. У поля путь «Объект.Товары.Цена». Что можно сказать об этом поле и где оно, скорее всего, находится на форме?

На чтение. В форме два элемента: у первого путь «Объект.Контрагент», у второго пути нет вовсе, а на экране в нём виден текст. Что это за элементы?

Ответы — в конце части.

§ 4.4. Виды полей: одно значение, разные способы показать

Выделите поле «Артикул» и раскройте в палитре список у строки «Вид»: выбран в нём один вариант — тот, что подставила платформа, глядя на строковый тип. Выбор этот не окончательный: вариант в списке меняют, как любую другую настройку. Здесь и становится видно во всей полноте, что элемент и то, что он показывает, — разные вещи: артикул один, а способов его показать несколько.

1. Свойство «Вид» и кто его заполняет

У поля есть свойство, которое решает, чем оно будет на экране.

Значение по умолчанию — не приказ, а предложение. Строка получает поле ввода потому, что это самый ходовой вид для строки, а не потому, что иначе нельзя.

2. Пять рабочих видов

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

Остальные нужны для особых задач: поле календаря показывает месяц целиком, поле индикатора — шкалу заполнения, поля табличного и текстового документа — встроенный документ. Встретив такое поле в чужой форме, вы узнаете его по имени вида и по тому, что оно показывает.

Доступен, впрочем, не весь набор сразу: выбор сужает тип данных, на которые поле указывает.

3. Вид ограничен типом

Свобода тут не полная, и ограничивают её данные.

Правило простое: вид меняет способ показа, но не сам показываемый предмет. Флажок возможен, когда за полем булево, — и то лишь один из допустимых видов: булево показывают и полем ввода, и надписью. А строку флажком не покажешь: нечего ставить и снимать.

Тип решает, что показывают. Вид решает, как. Второе выбирают из того, что позволяет первое.

4. Надпись и декорация — не одно и то же

Самая полезная пара в этом параграфе. Оба показывают текст, который нельзя изменить, а различаются тем, откуда текст берётся.

Отсюда правило чтения чужой формы: увидели текст, который выглядит как подпись, — посмотрите в структуре, что это за элемент, и проверьте путь к данным. Поле с путём — данные, показанные без права ввода. Декорация — просто надпись, пути к данным у неё не бывает.

5. Зачем менять вид

Поводов немного, и все они про работу пользователя.

Первая строка — самая частая, и у неё есть соперник: свойство поведения, которое запрещает изменение, оставляя поле полем. Разница в том, что видит пользователь: надпись выглядит как текст, а запрещённое к изменению поле — как поле, в которое не пускают.

6. Один реквизит — два вида рядом

Раз вид принадлежит элементу, одно значение можно показать дважды и по-разному на одной форме.

Объект.Артикул
├── поле ввода    ← в карточке правят
└── поле надписи  ← в шапке показывают

Оба элемента смотрят по одному адресу: изменили в поле ввода — надпись обновилась. Это прямое продолжение правила из разговора о том, почему элементы не равны данным: сколько угодно элементов на один реквизит, и каждый настроен по-своему.

7. В Конфигураторе и в Предприятии

Опыт на две минуты: одно значение, два способа показать.

1. Откройте форму элемента «Товаров» и выделите поле «Артикул». Найдите в палитре свойство «Вид» и посмотрите, что предлагает список.

2. Смените вид на «поле надписи». Обновите конфигурацию базы данных и откройте карточку товара: артикул виден, но не вводится.

3. Верните полю вид «поле ввода»: карточка снова даёт править артикул.

4. Выделите поле-флажок «ПоказыватьПодробности» и посмотрите список видов у него. Он короче — тип булево позволяет меньше.

5. Ничего не меняя, закройте форму. Если что-то поменяли — верните: база серии должна остаться прежней.

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

Главное в одном абзаце

У поля есть свойство «Вид», и платформа заполняет его сама по типу данных из пути — но это предложение, а не приказ. Рабочих видов пять: поле ввода, поле надписи, поле флажка, поле переключателя, поле картинки; всего же видов у поля около двух десятков, и остальные нужны для особых задач. Свобода выбора ограничена типом: флажок возможен, когда за полем булево, переключатель — когда есть набор вариантов, а строку ни тем ни другим не покажешь. Отсюда правило: тип решает, что показывают, вид — как. Поле надписи и декорация выглядят одинаково, но первое связано с данными и меняется вместе с ними, а второе показывает текст, записанный в форме, — различает их путь к данным. Менять вид стоит ради работы пользователя: показать без права ввода, дать выбор на виду, показать признак картинкой; и одно значение спокойно показывают два элемента разного вида на одной форме.

Вид выбран, путь задан, значение на экране. Но поле может оказаться невидимым, недоступным для ввода или без подписи — и всё это тоже чьи-то решения. Где они записаны?

Контрольные вопросы

1. Какое свойство решает, чем поле будет на экране, и кто его заполняет?
2. Назовите пять видов полей, которые встречаются чаще всего.
3. Почему нельзя показать строку полем флажка?
4. Чем поле надписи отличается от декорации и как их различить в чужой форме?
5. Зачем менять вид поля? Назовите два повода.
6. Что произойдёт со значением в базе, если сменить вид поля?
7. Можно ли показать один реквизит двумя полями разного вида на одной форме?

Упражнения

По образцу. Смените вид поля «Телефон» в форме элемента «Контрагентов» на надпись, посмотрите в Предприятии и верните обратно.

Своё: подберите вид. Какой вид вы дадите полю для каждого случая: ИНН, который менеджеру нельзя править; признак «архивный» у контрагента; выбор способа доставки из трёх вариантов; логотип контрагента.

Ловушка: «сделай поле некликабельным». Заказчик просит, чтобы поле суммы в документе «нельзя было трогать». Назовите два способа и объясните, чем они отличаются для пользователя; точные настройки второго разберём дальше.

Обратный ход. В чужой форме текст показывается и меняется при изменении данных, а ввести в него ничего нельзя. Что это за элемент и как проверить догадку?

На чтение. В форме поле связано с реквизитом типа Булево, а вид у него — поле ввода. Что увидит пользователь и зачем так могли сделать?

Ответы — в конце части.

§ 4.5. Свойства элемента: видимость, доступность, заголовок, подсказка

Записаны они там же, где путь и вид, — в палитре свойств элемента, среди тех самых свойств внешнего вида и поведения, о которых говорилось в начале главы. Четыре свойства из неё встречаются почти у каждого элемента и решают судьбу поля на экране: видно ли его, можно ли в него вводить, что написано рядом и что всплывает при наведении курсора.

1. Четыре свойства, которые есть почти у всех

Свойств у элемента десятки, но эти четыре читают первыми.

Все четыре — про показ, а не про данные. Значение в базе от них не меняется: погасить поле и спрятать его — не то же самое, что стереть значение.

2. Видимость: элемент есть, на экране его нет

Документация говорит коротко: ложь — поле не отображается. Элемент при этом никуда не девается: он остаётся в структуре, со своим путём и видом, просто его не показывают.

Это и есть декларативность в самом чистом виде: прятать поле — не действие, а правило. Никто не пишет «спрятать поле», кто-то один раз снял флажок в свойстве.

Спрятанное поле — не удалённое: оно осталось в структуре. И спрятано оно не навсегда — пользователь часто может вернуть его себе сам.

3. Доступность и только просмотр

Два свойства, которые легко спутать, потому что оба про «нельзя изменить».

Документация добавляет к «только просмотру» важную оговорку: свойство имеет смысл лишь там, где редактирование не запрещено прикладным смыслом или правами. Иначе говоря, это не защита, а удобство: поле, которое незачем трогать.

И третий способ мы уже знаем — сменить вид на надпись. Три способа, три разных впечатления у пользователя.

4. Заголовок и подсказка

Заголовок — подпись к элементу. Пустой он не означает «подписи не будет»: документация говорит, что пустая строка — это автоматическое определение заголовка. Платформа возьмёт его из представления реквизита — то самое правило из разговора об автоформах. Убрать подпись совсем можно другим свойством, — оно задаёт, где стоит заголовок, и среди его значений есть «нет».

Подсказка — всплывающий текст при наведении курсора, и у неё есть соседнее свойство, задающее способ показа: всплывать, стоять рядом кнопкой и другие варианты.

Пишут подсказки не для украшения. Поле «Артикул» в подсказке не нуждается, а поле «Коэффициент» — очень.

5. Элемент есть, а на экране его нет

Это самое частое недоумение при разборе чужой формы, и причин у него несколько.

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

Прежде чем открывать модуль, посмотрите свойство. Чаще всего ответ там.

6. Пользователь тоже настраивает форму

Про третью строку стоит сказать отдельно, потому что она удивляет: часть решений принимает не разработчик.

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

Прятать элемент свойством или кодом — договорённость команды, а не правило платформы. Для чтения формы свойство удобнее: оно видно в палитре, а код виден только тому, кто открыл модуль.

7. В Конфигураторе и в Предприятии

Опыт на все четыре свойства сразу.

1. Откройте форму элемента «Товаров» и снимите видимость у поля «ЕдиницаИзмерения». Обновите конфигурацию и посмотрите карточку: поля нет.

2. В Предприятии откройте настройку формы и найдите скрытое поле в списке. Поставьте флажок: поле вернулось — у вас одного.

3. Верните видимость в Конфигураторе, а в Предприятии сбросьте свою настройку формы.

4. Задайте полю «Артикул» подсказку «Внутренний код товара» и посмотрите, как она всплывает.

5. Очистите у этого поля заголовок и посмотрите, что подпись осталась: платформа собрала её сама.

6. Верните всё как было: база серии должна остаться прежней.

Второй шаг стоит проделать даже тем, кто уверен, что знает ответ. Он показывает: форма, которую вы собрали, — не последнее слово. Последнее остаётся за тем, кто с ней работает.

Главное в одном абзаце

Четыре свойства элемента решают его судьбу на экране: видимость — показывать ли его, доступность — можно ли с ним работать, заголовок — что написано рядом, подсказка — что всплывёт при наведении курсора; данных они не касаются вовсе. Спрятанный элемент не удалён: он остаётся в структуре со своим путём и видом, и это чистая декларативность — не действие «спрятать», а правило в свойстве. Запретить изменение можно тремя способами, и пользователь увидит три разные вещи: надпись вместо поля, поле, не принимающее ввод, или приглушённое поле. Пустой заголовок означает не «подписи нет», а «подпись соберёт платформа». А когда элемент есть, но на экране его нет, причин несколько: снята видимость у самого элемента или у группы над ним, пользователь убрал поле себе в настройке формы, не хватает прав или видимость меняет код, — и проверять их стоит в этом порядке, начиная с палитры свойств.

Читать одно поле мы научились: путь, вид, четыре свойства. Но в чужой форме полей два десятка — с какого начать и как не утонуть в свойствах?

Контрольные вопросы

1. Какие четыре свойства элемента читают первыми и что задаёт каждое?
2. Чем спрятанный элемент отличается от удалённого?
3. Почему видимость — пример декларативности?
4. Назовите три способа не дать пользователю изменить значение и разницу между ними.
5. Что означает пустое свойство «Заголовок»?
6. Элемент есть, а на экране его нет. Какие причины возможны и в каком порядке их проверять?
7. Что может сделать с формой сам пользователь и что из этого следует?

Упражнения

По образцу. Снимите видимость у поля «КонтактноеЛицо» в форме элемента «Контрагентов», проверьте в Предприятии и верните обратно.

Своё: подберите свойство. Что вы зададите для каждого случая: телефон должен быть виден, но не правиться; поле «Комментарий» нужно спрятать от всех; у поля «ИНН» должно всплывать пояснение; подпись к полю «Наименование» нужно изменить на «Название товара».

Ловушка: «поле исчезло». Пользователь звонит: «из карточки пропал артикул, верните». В форме поле есть, видимость стоит. Что вы спросите и куда посмотрите?

Обратный ход. У поля заголовок пуст, а подпись на экране есть. Откуда она взялась и что будет, если в свойстве написать свой текст?

На чтение. В чужой форме поле «Сумма» погашено, а рядом надпись показывает ту же сумму. Что сделал автор формы и зачем, скорее всего?

Ответы — в конце части.

§ 4.6. Чужая форма: разбор полей и путей к данным

Начинают не с поля, а со списка: чужую форму разбирают не глядя на экран, а идя сверху вниз по структуре элементов и записывая про каждую строку три вещи. Свойств у элемента десятки, но для разбора хватает нескольких — вида, пути к данным и тех, что решают, что пользователь может с полем сделать. Утонуть в остальных не получится, если сразу завести таблицу.

1. Таблица разбора

Выглядит она так, и заполняется по одной строке на элемент.

Три первые колонки списываются с редактора, четвёртая — та, ради которой всё затевалось: в ней вы своими словами говорите, откуда значение и что с ним делает пользователь.

2. Идти по структуре, а не по экрану

Соблазн разбирать по картинке велик, но структура надёжнее.

Экран пригодится потом — чтобы сверить прочитанное с тем, что достаётся пользователю. Но первым читают дерево: оно полное.

3. Три вопроса к каждому полю

Вопросы те же, что в прошлых параграфах, только теперь их задают подряд и быстро.

Заголовок смотрят не всегда, а когда подпись на экране расходится с именем реквизита: это верный признак, что её задали руками.

4. Что считать находкой

Разбор нужен не ради таблицы: в ней ищут места, где форма говорит о замысле автора.

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

5. Что видно по путям в сумме

Когда пути выписаны, из них складывается портрет формы — ещё до того, как вы поняли её замысел.

пути с «Объект.»  → форма об одной записи
пути без него     → значение не из записи
путей нет вовсе   → форма не связана
                    с данными напрямую

Если почти все пути ведут в «Объект.», перед вами обычная карточка. Если половина путей — в реквизиты формы, значит, значение приходит не из записи; чаще всего его готовит код, но это стоит проверить. Если путей нет совсем, данные появятся от действий пользователя или из кода: так устроены помощники, диалоги и рабочие места — те самые формы, у которых в центре задача, а не предмет. Разговор о них — в главе об особых формах.

6. Четыре ловушки

Первая: читать экран вместо структуры. Скрытые элементы так и останутся незамеченными, а именно в них часто вся соль.

Вторая: принять декорацию за поле. На экране текст выглядит одинаково, а различает их вид элемента в структуре: поле это или декорация. Путь к данным — подтверждение: у декорации его не бывает вовсе.

Третья: забыть про группы. Поле может быть видимым, а группа над ним — нет; на экране не будет ни того ни другого.

Четвёртая: счесть пустое поле сломанным. Пустым оно бывает и когда связи нет, и когда значение просто не заполнено.

7. Разбор по шагам

Шесть шагов, которые складываются с разбором реквизитов из главы о данных.

1. Откройте структуру элементов и выпишите все элементы сверху вниз, отмечая вид каждого.

2. Для каждого поля запишите путь к данным; для элементов без пути поставьте прочерк.

3. Отметьте элементы, у которых снята видимость или доступность, и группы, в которых они лежат.

4. Сверьте список путей со списком реквизитов: найдите реквизиты, которым элемента не досталось.

5. Объясните каждую строку одной фразой про работу пользователя.

6. Откройте форму в Предприятии и сверьте: то ли вы прочитали.

Шестой шаг — не формальность. Прочитанное в редакторе и увиденное в Предприятии расходятся чаще, чем кажется, и каждое расхождение — это чья-то настройка, которую вы пропустили.

Главное в одном абзаце

Чужую форму разбирают по структуре элементов, а не по экрану: структура полная, в ней видно и скрытое. На каждый элемент заводят строку таблицы и записывают три вещи — вид, путь к данным и то, что пользователь может с ним сделать; заголовок смотрят, когда подпись на экране расходится с именем реквизита. Находки ищут в готовой таблице: поле без пути, два поля с одним путём, поле с необычным видом, снятая видимость, а сравнением с реквизитами — значение, которому элемента не досталось. По путям в сумме виден портрет формы: сплошные «Объект.» — обычная карточка, много собственных реквизитов — значение приходит не из записи, путей нет вовсе — форма не связана с данными напрямую. И четыре ловушки: читать экран вместо структуры, принять декорацию за поле, забыть про группу над полем и счесть пустое поле сломанным.

Поля разобраны поодиночке, и каждое объяснено. Но экран — не список полей: они стоят рядами, собраны в рамки, разложены по страницам. Кто и где решает, как всё это размещается?

Контрольные вопросы

1. Почему разбор начинают со структуры элементов, а не с экрана?
2. Какие три вещи записывают про каждый элемент?
3. Когда стоит посмотреть на заголовок элемента?
4. Назовите три находки, ради которых составляют таблицу разбора.
5. Как найти реквизит, которому не досталось элемента?
6. Что можно сказать о форме, если почти все пути начинаются с «Объект.»?
7. Назовите четыре ловушки разбора полей.

Упражнения

По образцу. Составьте таблицу разбора для формы элемента «Товаров» — той, что вы собирали сами. Ответы известны заранее, проверяется порядок.

Своё: объясните каждое поле. Возьмите форму, где есть поле-флажок и поле надписи, и объясните каждую строку одной фразой про работу пользователя.

Ловушка: «в форме нет поля склада». Коллега разбирает форму поступления по экрану и говорит, что склад в ней не выводится. Где он мог его не заметить?

Обратный ход. В таблице разбора у двух полей один и тот же путь, и у одного из них вид «поле надписи». Что задумал автор формы?

На чтение. В форме десять элементов, и ни у одного нет пути к данным. Что это за форма и где искать её данные?

Ответы — в конце части.

Ответы к части 4

Ответы собраны здесь, а не под вопросами: подсказка, увиденная сразу после вопроса, отменяет попытку вспомнить. У каждого ответа до трёх ступеней: сам ответ, указание — если ответ не дался сразу — и полное решение там, где рассуждение важнее вывода.

§ 4.1. Элемент формы: то, что пользователь видит и трогает

К вопросу 1. Ответ. Элемент формы — единица того, что видно в окне. Видов пять: поле, таблица, кнопка, группа, декорация.

К вопросу 2. Ответ. Элементы выстроены деревом с корнем «Форма», и порядок в дереве — это порядок на экране: что выше, то и показано выше; что вложено в группу, то внутри её рамки.

К вопросу 3. Указание. Кто дал элементу имя?

Полное решение. Имя элементу дал редактор, когда реквизит перетащили в элементы: проще всего было назвать его так же. Тождества за этим нет. Строка в реквизитах — данные, строка в элементах — способ их показать, и имя элемента можно сменить, ничего не потеряв: в базе от этого не изменится ни одно значение. Одинаковые имена — привычка редактора, и путаница из-за неё стоит дороже, чем кажется.

К вопросу 4. Ответ. Внутри своей формы и больше нигде. В дереве объекта элементов нет: там заданы данные, а как их показывать — дело каждой формы.

К вопросу 5. Ответ. Два: в карточке своё поле, в списке своя колонка. Это разные элементы разных форм, и настроены они могут быть по-разному.

К вопросу 6. Ответ. Данные — откуда элемент берёт значение; внешний вид — как он выглядит; поведение — что с ним можно делать.

К вопросу 7. Ответ. У группы, кнопки и декорации: группа собирает другие элементы, кнопка запускает команду, декорация поясняет. Показывать им нечего, поэтому и пути к данным у них нет. Он есть у поля и у таблицы.

К упражнению «По образцу». Ответ. В форме элемента «Контрагентов» — поля наименования, кода, ИНН, телефона и контактного лица; если вы выводили флажок «ПоказыватьКонтакты», рядом будет поле-флажок. Корень у структуры один — «Форма».

К упражнению «Своё: назовите вид». Ответ. Рамка «Контактные данные» — группа; надпись «Заполняется автоматически» — декорация; строка с телефоном — поле; кнопка «Провести» — кнопка; список поступлений внизу карточки — таблица.

К упражнению «Ловушка: „переименовал поле — потерял данные"». Указание. Что вообще хранится в базе — элементы или реквизиты?

Полное решение. Изменилось только имя элемента внутри этой формы. В базе не изменилось ничего: там лежат значения реквизитов, а элемент — способ их показать. Поле по-прежнему показывает артикул, потому что связь задана не именем, а путём к данным. Осторожность нужна в другом месте: на имя элемента может ссылаться код формы, если он есть, — тогда переименование придётся повторить и там.

К упражнению «Обратный ход». Ответ. Это один из тех элементов, у которых пути к данным нет: декорация — надпись или картинка, группа, собирающая другие элементы, или кнопка, у которой вместо данных команда.

К упражнению «На чтение». Ответ. «Наименование» — поле, показывающее реквизит с тем же именем; «НаименованиеПодпись» — скорее всего декорация или поле-надпись рядом с ним. Проверяется это одним взглядом: есть ли у второго элемента путь к данным.

§ 4.2. Почему элементы не равны данным

К вопросу 1. Ответ. Удалили элемент — значение осталось, его просто перестали показывать. Удалили реквизит формы — элемент, который на него ссылался, остался с путём, ведущим в пустоту.

К вопросу 2. Указание. Сколько действий скрыто в одном движении мышью?

Полное решение. Обман растёт из перетаскивания. Реквизит перенесли в элементы — редактор создал элемент и тут же задал ему связь, и со стороны это выглядит одним действием. Отсюда ощущение, что поле и есть данные. Проверяется оно легко: добавьте элемент вручную — связь не появится, и поле окажется ни с чем.

К вопросу 3. Ответ. Создать элемент и задать ему связь с данными — путь к данным.

К вопросу 4. Ответ. Реквизит с элементом — обычное поле; реквизит без элемента — служебное значение, которое не показывают; элемент без реквизита — декорация, кнопка, группа; нет ни того ни другого — пустое место.

К вопросу 5. Ответ. Один реквизит показывают сколько нужно элементов — поле в карточке, колонка в списке, поле в форме выбора. У элемента свойство с путём одно: один адрес.

К вопросу 6. Ответ. Самые частые две: значение не заполнено или элемент ни с чем не связан. Бывают и другие — например, значение заполняет обработчик, которого нет.

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

К упражнению «По образцу». Ответ. В списке контрагентов телефон остаётся на месте: удалили элемент, а не данные. После возврата поле, скорее всего, встанет в конец формы — порядок придётся поправить руками.

К упражнению «Своё: разложите по клеткам». Ответ. Кнопка «Записать» — элемент без реквизита; поле артикула — реквизит с элементом; реквизит формы «ОстаткиПоСкладам» без таблицы — реквизит без элемента; надпись «Все цены без НДС» — элемент без реквизита.

К упражнению «Ловушка: „удалил поле — потерял данные"». Указание. Где посмотреть значение, не открывая эту форму?

Полное решение. Проверка занимает минуту: откройте список товаров или отчёт — единицы на месте. Удалён был элемент, то есть способ показать значение в одной форме; сами значения лежат в записях и видны всем остальным формам и запросам. Восстановить показ просто — перетащить реквизит обратно в элементы; поправить придётся разве что порядок полей.

К упражнению «Обратный ход». Ответ. Порядок проверки такой: сначала посмотреть путь к данным у этого поля — задан ли он и туда ли ведёт; потом — не заполняет ли значение обработчик, которого нет; и только потом искать причину в самих данных.

К упражнению «На чтение». Ответ. Ошибки нет: один реквизит показывают два элемента, и настроены они по-разному — в шапке для ввода, у итога для просмотра. Значение у обоих одно и то же, потому что адрес один.

§ 4.3. Поле и его путь к данным

К вопросу 1. Ответ. Адрес того, что поле показывает, — путь к реквизиту, с которым связан элемент. Читается по частям через точку, слева направо.

К вопросу 2. Ответ. Путь с «Объект.» ведёт в данные записи, о которой форма разговаривает. Путь из одной части — в реквизит самой формы, значение которого живёт, пока открыто окно.

К вопросу 3. Ответ. Из трёх частей: основной реквизит, табличная часть, реквизит строки — «Объект.Товары.Количество».

К вопросу 4. Указание. Откуда берутся части пути, когда его задают?

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

К вопросу 5. Ответ. Тип приходит из данных по пути, и из него по умолчанию следует вид поля и его поведение: календарь у даты, флажок у булева, кнопка выбора у ссылки. Переопределить выбор платформы можно свойством «Вид».

К вопросу 6. Ответ. Ничего: поле есть, а показывать ему нечего. Это не поломка — связь просто не задана.

К вопросу 7. Ответ. Откуда значение; данные это записи или формы; где искать источник — в дереве объекта или в реквизитах формы.

К упражнению «По образцу». Ответ. У полей наименования, кода, ИНН, телефона и контактного лица пути начинаются с «Объект.» — это данные записи. У флажка «ПоказыватьКонтакты», если вы его выводили, путь из одной части — данные формы.

К упражнению «Своё: предскажите вид». Ответ. У даты — поле с кнопкой календаря; у контрагента — поле с кнопкой выбора; у булева — поле, показанное флажком.

К упражнению «Ловушка: „поле сломалось"». Указание. Что именно перестало существовать — поле или его адрес?

Полное решение. Пересобирать форму незачем: сломалась одна связь, а не форма. Посмотрите у поля путь к данным — он ведёт на реквизит, которого больше нет. Дальше два пути: если реквизит убрали намеренно, удалите и поле; если его переименовали, задайте полю новый адрес. Форма при этом остаётся своей, со всей раскладкой, которую иначе пришлось бы собирать заново.

К упражнению «Обратный ход». Ответ. Путь из трёх частей ведёт в строку табличной части, значит, это колонка таблицы товаров, а не поле в шапке. Искать его надо внутри элемента-таблицы.

К упражнению «На чтение». Ответ. Первый — поле, связанное с реквизитом объекта. Второй — декорация: текст на экране у неё есть, а пути к данным не бывает вовсе.

§ 4.4. Виды полей: одно значение, разные способы показать

К вопросу 1. Ответ. Свойство «Вид». Платформа заполняет его сама по типу данных, на которые указывает путь, а разработчик может выбрать другой вид из допустимых.

К вопросу 2. Ответ. Поле ввода, поле надписи, поле флажка, поле переключателя, поле картинки.

К вопросу 3. Ответ. Флажку нужно значение, которое бывает только истинным или ложным. У строки такого смысла нет — ставить и снимать нечего.

К вопросу 4. Указание. Откуда каждый из них берёт текст?

Полное решение. Поле надписи — это поле, только вид у него другой: у него есть путь к данным, и на экране оно показывает значение, которое меняется вместе с данными. Декорация — другой вид элемента, пути к данным у неё нет вовсе, а текст записан в самой форме и сам по себе не меняется. Различают их в чужой форме одним движением: смотрят, есть ли у элемента путь к данным.

К вопросу 5. Ответ. Показать значение без права ввода; дать выбор из нескольких вариантов на виду; показать признак картинкой.

К вопросу 6. Ответ. Ничего. Вид — свойство элемента, то есть способа показать; значения в базе он не касается.

К вопросу 7. Ответ. Можно: оба поля смотрят по одному адресу, и меняются вместе. Например, поле ввода в карточке и надпись в шапке.

К упражнению «По образцу». Ответ. Телефон виден, но не вводится; в базе значение прежнее. После возврата вида поле снова принимает ввод.

К упражнению «Своё: подберите вид». Ответ. ИНН, который нельзя править, — поле надписи (или поле ввода со свойством, запрещающим изменение); признак «архивный» — поле флажка; выбор способа доставки — поле переключателя; логотип — поле картинки.

К упражнению «Ловушка: „сделай поле некликабельным"». Ответ. Первый способ — сменить вид на надпись: пользователь увидит текст, и поля там больше не будет. Второй — оставить поле полем, но запретить изменение свойством поведения: поле видно как поле, но в него не пускают. Выбор зависит от того, что важнее — убрать вид поля или сохранить привычную рамку.

К упражнению «Обратный ход». Ответ. Скорее всего, поле с видом «надпись»: текст меняется вместе с данными, значит, у элемента есть путь к данным. Проверяется взглядом в палитру свойств — путь и вид стоят рядом.

К упражнению «На чтение». Ответ. Пользователь увидит не флажок, а поле, в котором пишется «Да» или «Нет». Так делают редко — например, когда значение нужно показать словами в одном ряду с другими полями.

§ 4.5. Свойства элемента: видимость, доступность, заголовок, подсказка

К вопросу 1. Ответ. Видимость — показывать ли элемент; доступность — можно ли с ним работать; заголовок — подпись рядом; подсказка — текст при наведении курсора.

К вопросу 2. Ответ. Спрятанный остаётся в структуре элементов со своим путём и видом — его просто не показывают. Удалённого там нет, и собирать его придётся заново.

К вопросу 3. Указание. Что именно сделал разработчик, когда поле исчезло?

Полное решение. Никто не писал «спрятать поле». Снято свойство — задано правило, а прячет платформа сама, каждый раз при открытии формы. Это та же механика, что и во всей книге: «само сработало» означает, что где-то задано правило. Отсюда и порядок разбора: сначала ищут свойство, а не код.

К вопросу 4. Ответ. Сменить вид на надпись — пользователь увидит текст, и поля не будет; поставить «только просмотр» — поле выглядит полем, но ввода не принимает; снять доступность — поле приглушено, до него не добраться.

К вопросу 5. Ответ. Что подпись соберёт платформа — из представления реквизита. Убрать подпись совсем можно свойством, которое задаёт положение заголовка.

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

К вопросу 7. Ответ. Пользователь может скрыть поля, вывести те, которых не было, переставить их и сгруппировать — если у него есть право сохранять свои настройки. Отсюда следствие: свойством прячут от взгляда, а не от доступа.

К упражнению «По образцу». Ответ. Поле исчезает из карточки, но остаётся в структуре элементов; значение контактного лица в базе не меняется и видно в списке.

К упражнению «Своё: подберите свойство». Ответ. Телефон — «только просмотр» (или вид «надпись»); «Комментарий» — снять видимость; ИНН — заполнить подсказку; подпись к наименованию — записать свой заголовок.

К упражнению «Ловушка: „поле исчезло"». Указание. У всех ли пропал артикул?

Полное решение. Первый вопрос — видят ли артикул другие пользователи. Если видят, дело не в форме, а в настройке этого человека: он мог снять флажок в настройке формы, и вернуть поле можно там же. Если не видят никто — смотрите видимость у самого поля и у группы, в которой оно лежит, потом права, и только потом модуль формы.

К упражнению «Обратный ход». Ответ. Подпись собрала платформа из представления реквизита. Если написать в свойстве свой текст, на экране появится он — автоматическая подпись больше подставляться не будет.

К упражнению «На чтение». Ответ. Сумму считают, а не вводят: поле оставили на месте, но закрыли от ввода, а рядом показали значение надписью, чтобы его было видно и при работе с другими полями. Данные у обоих элементов одни.

§ 4.6. Чужая форма: разбор полей и путей к данным

К вопросу 1. Ответ. Структура полная: в ней видно и то, что скрыто, и порядок, заданный разработчиком, а рядом — палитра свойств. Экран показывает только показанное.

К вопросу 2. Ответ. Что это за элемент, откуда он берёт значение и что с ним может сделать пользователь.

К вопросу 3. Ответ. Когда подпись на экране расходится с именем реквизита: значит, заголовок задали руками.

К вопросу 4. Ответ. Например: поле без пути к данным; два поля с одним путём; поле со снятой видимостью. Годятся и другие строки таблицы находок.

К вопросу 5. Ответ. Сравнить два списка — реквизиты формы и элементы. Реквизит, которому не досталось элемента, в таблице разбора не появится.

К вопросу 6. Ответ. Что форма об одной записи: обычная карточка справочника или документа.

К вопросу 7. Ответ. Читать экран вместо структуры; принять декорацию за поле; забыть про группу над полем; счесть пустое поле сломанным.

К упражнению «По образцу». Ответ. В таблице окажутся поля наименования, артикула и единицы с путями через «Объект.», поле-флажок с путём из одной части и таблица остатков, у которой путь тоже свой, без «Объект.».

К упражнению «Своё: объясните каждое поле». Ответ. Фразы должны быть про работу: «флажком пользователь разворачивает подробности», «надпись показывает посчитанный итог, править его нельзя». Объяснение вида «булево, потому что булево» не считается.

К упражнению «Ловушка: „в форме нет поля склада"». Указание. Что коллега мог не увидеть на экране?

Полное решение. Смотреть надо в структуру элементов. Поле может лежать в свёрнутой или скрытой группе, у него может быть снята видимость, а может его убрал себе сам пользователь в настройке формы. Все три случая на экране выглядят одинаково — поля нет, — и различаются только в редакторе. Если поля нет и в структуре, тогда вопрос другой: есть ли вообще реквизит склада у документа.

К упражнению «Обратный ход». Ответ. Одно значение показано дважды: полем ввода там, где его правят, и надписью там, где его нужно видеть, не отвлекаясь от других полей. Значение у обоих одно — адрес один.

К упражнению «На чтение». Ответ. Форма не связана с данными напрямую: скорее всего, это помощник, диалог или рабочее место. Данные у неё появятся от действий пользователя или из кода, а искать их надо в реквизитах формы — и в том, что кладут в них команды.

§ 5.1. Авторазмещение: у формы нет координат

Решает платформа, и решает каждый раз заново — в тот момент, когда открывает окно. Места на экране у элемента нет и быть не может: нигде в свойствах поля не записано, что оно стоит во второй строке слева. Записано другое — где элемент стоит в дереве и что ему разрешено. Из этого платформа и собирает экран.

1. Координат нет

Тому, кто рисовал формы в других системах, это место кажется странным, поэтому скажем прямо.

Мышью тащить можно и в дереве, и по предпросмотру — но платформа при этом меняет не координаты, а место элемента в дереве и его группу. Координат нет и в описании формы, которое уходит на клиента: их просто негде записать.

Элемент не стоит на месте — он стоит в дереве. Место на экране платформа вычисляет при каждом открытии.

2. Почему так сделано

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

Нарисованная по координатам форма в этих условиях ломается: подпись не помещается, поле уезжает за край. Форма, собранная по правилам, перестраивается — потому что правила не говорят «здесь», они говорят «после этого, внутри этой группы, во всю ширину».

3. Чем управляют вместо координат

Рычагов немного, и все они про правила, а не про точки.

Слово «пожелание» здесь не смягчение. Документация говорит о ширине поля ввода так: задаётся в символах, используется при расчёте макета формы, ноль — автоматическое определение. Высота считается строками. Пожелание — потому что платформа взвешивает его против других пожеланий и против свободного места: если места мало, поле будет сжато, если много и растягивание разрешено — раздаст свободное. Точного «шестьсот точек» в управляемой форме не бывает, и положение в группе — тоже правило выравнивания, а не смещение от угла.

4. «Решай сама» — обычное значение

У свойств размещения есть третье состояние — не «да» и не «нет», а «решай сама», — и у каждого свойства оно записано по-своему.

Растягивать по горизонтали
├── Истина          ← растягивать
├── Ложь            ← не растягивать
└── не задано       ← решает платформа

Ширина
├── число в символах ← пожелание
└── ноль             ← решает платформа

Документация описывает это прямо: у растягивания неопределённое значение означает автоматическое определение, у ширины ту же роль играет ноль, а положение в группе со значением «авто» берётся от родительской группы. Форма, в которой всюду оставлено «решай сама», — не недоделанная: это форма, где разработчик не спорил с платформой без причины.

Незаданное значение — не забытая настройка, а решение доверить выбор платформе.

5. Что из этого следует

Три следствия, которые меняют привычки.

Отсюда правило разбора: увидев на экране странное размещение, ищут не ошибку рисования, а правило — порядок, группу, растягивание. И наоборот: собирая свою форму, задают правила, а проверяют глазами.

6. Ловушка для тех, кто рисовал раньше

Самая частая ошибка новичка с опытом — искать в управляемой форме то, чего в ней нет.

Эта потеря кажется обидной ровно до первого открытия формы на другом экране. Управляемая форма не мешает разработчику — она не даёт испортить чужой экран одним движением мыши. Испортить осознанно, задав неудачные правила, она, конечно, не помешает: об этом вся глава.

7. В Конфигураторе и в Предприятии

Опыт, который показывает авторазмещение в действии.

1. Откройте карточку товара в Предприятии и растяните окно во всю ширину, потом сожмите до половины. Посмотрите, что стало с полями и подписями.

2. Вернитесь в Конфигуратор, откройте форму элемента «Товаров» и найдите у поля наименования свойства размера и растягивания. Убедитесь, что координат среди них нет.

3. Разрешите полю «Артикул» растягиваться по горизонтали. Обновите конфигурацию и посмотрите карточку в широком окне.

4. Верните свойство как было: база серии должна остаться прежней.

5. Скажите вслух, чем задано положение каждого поля на этой форме. Если в ответе нет слов «порядок», «группа» и «растягивание», посмотрите ещё раз.

Главное в одном абзаце

В управляемой форме у элемента нет координат: место на экране платформа вычисляет при каждом открытии, а разработчик задаёт не точку, а правила — порядок в дереве, вложенность в группу, растягивание, положение в группе и ширину-пожелание. Сделано это потому, что условия открытия неизвестны заранее: клиент, размер окна, масштаб, длина подписей на другом языке. Нарисованная по координатам форма в таких условиях ломается, собранная по правилам — перестраивается. У свойств размещения есть третье состояние — «решай сама»: незаданное растягивание, нулевая ширина; это не забытая настройка, а решение доверить выбор платформе. Отсюда привычки: «подвинь поле правее» выполняется не мышью, а порядком, группой или растягиванием; проверять форму надо в нескольких размерах окна; а разбирая чужую, ищут не ошибку рисования, а правило.

Правила названы, и первое из них — вложенность. Элементы не просто идут друг за другом: они собраны в рамки, и внутри каждой рамки свой порядок. Что такое эта рамка и что она решает?

Контрольные вопросы

1. Где в управляемой форме записано место элемента на экране?
2. Почему у элементов нет координат — назовите две причины из условий открытия.
3. Чем управляют вместо координат? Назовите три рычага.
4. Что означает незаданное значение у свойств размещения и как оно записано у растягивания и у ширины?
5. Почему ширина элемента — пожелание, а не точный размер?
6. Что отвечать на просьбу «подвинь это поле правее»?
7. Почему форму стоит проверять в разных размерах окна?

Упражнения

По образцу. Откройте список контрагентов в узком и широком окне и опишите, что изменилось в размещении колонок.

Своё: переведите просьбу. Переведите на язык правил: «пусть телефон стоит справа от наименования», «пусть наименование занимает всю ширину», «пусть ИНН будет поуже».

Ловушка: «форма разъехалась». Коллега жалуется: на его ноутбуке карточка выглядит иначе, чем на вашем мониторе, и требует «прибить поля на место». Что вы объясните и что предложите проверить?

Обратный ход. В форме поле стоит во всю ширину окна, а соседнее — узкое. Какими свойствами это могло быть задано?

На чтение. Разработчик задал всем полям формы точную ширину и запретил растягивание. Что случится с этой формой на узком экране и на широком?

Ответы — в конце части.

§ 5.2. Группы: рамка, внутри которой свой порядок

Каждое поле нашей карточки товара стоит под предыдущим — наименование, артикул, единица, — и это не привычка платформы, а правило: так их кладёт сама форма, по тому же правилу, что и вертикальная группа. Любую пару полей можно поставить рядом, собрав в свою группу. Группа решает сразу две вещи: что стоит вместе и как оно внутри выстраивается — столбиком или в строку. Первое — про смысл, второе — про экран, и оба решения записаны в одном элементе.

1. Группа — элемент без данных

Группа стоит в структуре наравне с полями, но данных у неё нет: показывать ей нечего, а потому и пути к данным не положено — об этом шла речь в разговоре об элементах. Её работа — держать в себе другие элементы. Слово «рамка» тут условное: рисовать рамку группа не обязана, и почему — разберём дальше.

Форма
├── Наименование        ← поле
└── Учёт                ← группа
    ├── Артикул         ← поле
    └── ЕдиницаИзмерения ← поле

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

Группа не показывает значений — только рамку, заголовок, порядок. Она отвечает на вопрос, кто с кем стоит рядом.

2. Главное свойство: как выстраивать вложенное

У обычной группы и у страницы есть свойство «Группировка» — им и решается, лягут поля столбиком или встанут в строку.

Последнее значение — правило, которое само смотрит на ширину окна: на широком экране поля встанут рядом, на узком опустятся друг под друга, и делать для этого ничего не нужно. «Возможно» здесь считается по ширине, которая нужна вложенным элементам: если она не влезает, платформа переносит их вниз.

3. Группа в группе — так собирают строки

Одной группы редко хватает: чаще всего форма — это вертикальная стопка, в которой некоторые ряды разложены в строку. Бывает и иначе — наверху может стоять группа страниц, — но стопка встречается чаще прочего.

Форма              ← вертикальная
├── Наименование
├── Учёт           ← горизонтальная
│   ├── Артикул
│   └── ЕдиницаИзмерения
└── ПоказыватьПодробности

Читается такое дерево сверху вниз, с поправкой на направление каждой группы. По нему можно нарисовать экран, не открывая Предприятие, — этим мы займёмся отдельно, когда дойдём до скетча.

4. Рамка и заголовок — отдельные решения

Группа может выглядеть по-разному, вплоть до полной невидимости, и это настраивают двумя свойствами.

Отсюда важное для чтения чужой формы: группа в дереве есть, а рамки на экране нет — и это не ошибка. Возможностей две: у группы отключено выделение — или у неё снято свойство «Объединённая». Про второе документация говорит прямо: тогда элементы такой группы располагаются в родительской, а из свойств самой группы действуют только цвет фона и группировка.

Внешний вид группы на этом настроен. Остаётся вопрос важнее — ради чего вообще собирают элементы в группы.

5. Зачем собирать в группы

Поводов три, и все встречаются в живых формах.

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

Видимость, доступность и «только просмотр» группы достаются всему, что внутри. Это удобно, когда помнишь, и загадочно, когда забыл.

6. Что группы говорят при чтении

Группы — самая говорящая часть композиции: по ним видно, как автор формы представлял себе работу пользователя.

Последняя строка читается двояко. Чаще это след: поля из группы вынесли, а саму группу забыли убрать. Но бывает и замысел — группу оставили, чтобы прятать одно поле вместе с её заголовком.

7. В Конфигураторе и в Предприятии

Соберём первую группу — она останется в форме и дальше.

1. Откройте форму элемента «Товаров» и добавьте в элементы группу. Назовите её «Учёт», заголовок задайте «Учёт».

2. Перетащите в неё поля «Артикул» и «ЕдиницаИзмерения». В структуре они должны оказаться вложенными.

3. Поставьте группировку «горизонтальная» и посмотрите на предпросмотр: поля встали в строку.

4. Обновите конфигурацию базы данных и откройте карточку товара. Сожмите окно: посмотрите, что стало со строкой.

5. Переключите группировку на «горизонтальная, если возможно» и повторите опыт с узким окном.

6. Оставьте группу на форме: дальше мы будем собирать композицию вокруг неё.

Пятый шаг стоит проделать внимательно. Разница между «горизонтальной» и «горизонтальной, если возможно» — это разница между правилом жёстким и правилом с оговоркой; на широком экране они выглядят одинаково.

Главное в одном абзаце

Группа — элемент, который ничего не показывает: данных у неё нет, а работа её в том, чтобы держать в себе другие элементы и задавать им свойством «Группировка» направление — вертикально или горизонтально, всегда или пока хватает ширины. Группы вкладывают друг в друга, и обычная форма оказывается вертикальной стопкой, в которой некоторые ряды разложены в строку. Рамка и заголовок — отдельные решения: выделение бывает слабым, обычным, сильным или никаким, поэтому группа в дереве может быть, а рамки на экране нет; то же самое даёт снятое свойство «Объединённая» — тогда элементы группы располагаются прямо в родительской, а из свойств самой группы действуют только цвет фона и группировка. Собирают в группы ради смысла, ради размещения и ради того, чтобы управлять всем сразу: свойства группы достаются всему, что внутри, — потому и видимость проверяют у всех групп, в которые элемент вложен. А при чтении чужой формы группы показывают, как автор представлял себе работу пользователя.

Рамка собрала поля в блок, блоки легли стопкой. Но в форме документа блоков столько, что в окно они не помещаются, и половина из них нужна не всегда. Куда девать остальное?

Контрольные вопросы

1. Что такое группа и почему у неё нет пути к данным?
2. Какое свойство группы решает, как выстроятся вложенные элементы, и какие у него значения?
3. Чем «горизонтальная» отличается от «горизонтальной, если возможно»?
4. Как из групп собирается обычная форма — опишите словами.
5. Почему группа может быть в дереве, а рамки на экране нет?
6. Что происходит со свойствами группы для вложенных элементов?
7. О чём говорит одинокий элемент в собственной группе?

Упражнения

По образцу. Соберите в форме элемента «Контрагентов» группу «Контакты» и положите в неё телефон и контактное лицо.

Своё: разложите карточку. Нарисуйте на бумаге дерево групп для карточки контрагента: наименование, ИНН, телефон, контактное лицо. Объясните каждую группу одной фразой.

Ловушка: «рамка пропала». Разработчик собрал группу, задал ей заголовок, а на экране ни рамки, ни заголовка. Какие два объяснения возможны и где смотреть?

Обратный ход. На экране два поля стоят в строку. Что можно сказать о дереве элементов, не открывая его?

На чтение. В чужой форме группа «Дополнительно» содержит одно поле и имеет сильное выделение. Что, скорее всего, случилось с этой формой раньше?

Ответы — в конце части.

§ 5.3. Страницы: форма, которую показывают по частям

Остальное раскладывают по страницам. Страницы — тоже группы, только особые: они показывают не всё содержимое сразу, а одну часть за раз, и пользователь сам выбирает какую, переключая закладки. Так форма документа, которая не помещается в окно, остаётся одной формой — просто показанной по частям.

1. Две группы, а не одна

Страничная раскладка собирается из групп с разным значением свойства «Вид» — «Страницы» и «Страница», — и путать их не стоит.

Форма
├── Номер, Дата
└── Страницы             ← группа «Страницы»
    ├── Шапка            ← группа «Страница»
    │   ├── Контрагент
    │   └── Склад
    └── Товары           ← группа «Страница»
        └── таблица товаров

Страница внутри устроена как обычная группа: у неё своя группировка и свой «Заголовок» — он и становится надписью на закладке. Всё, что мы знаем о группах, работает и здесь.

«Страницы» — это переключатель, «Страница» — это содержимое. Одна группа держит набор, другая — то, что в нём лежит.

2. Закладки можно показывать по-разному

У группы «Страницы» есть свойство «Отображение страниц», которое решает, где будут закладки, — и будут ли вообще.

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

Значение «нет» только кажется странным. Страницы без закладок нужны, когда пользователя ведут по шагам и переключают страницы командами «Далее» и «Назад». Так устроены помощники; к ним вернёмся, когда дойдём до особых форм.

3. Какая страница открывается первой

При открытии формы видна одна страница, и это тоже решено правилом, а не случаем: у группы «Страницы» есть свойство «Текущая страница».

Отсюда вопрос при чтении чужой формы: почему открывается не первая закладка? Ответ ищут в этом свойстве. Если там пусто, а открывается всё равно не первая, страницу переключает код при открытии формы — это уже за границей книги, но знать, что так бывает, полезно.

4. Что класть на какую страницу

Страницы экономят место, но прячут содержимое. Поэтому раскладывают не по удобству разработчика, а по работе.

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

Обратная сторона тоже есть. Что лежит на второй закладке, пользователь видит, только открыв её. Поле, которое обязательно заполнить, на второй закладке легко пропустить — и узнать о нём лишь по ошибке при записи.

Страница откладывает показ, а не данные. Откладывать можно то, что нужно не всегда, — но не то, без чего нельзя записать.

5. Что страницы говорят при чтении

Страницы — самое крупное решение композиции, и по ним первым делом видно, как автор делил работу.

Читают страницы в том же порядке, что и всё дерево: сперва набор, потом каждая страница как обычная группа.

6. Страница — не отдельная форма

Иногда новичок, увидев закладки, решает, что каждая — своя форма. Нет: форма одна, данные у неё общие, и переключение закладок ничего не открывает и не закрывает.

Это важно при чтении путей к данным: реквизиты у формы одни на все закладки, и пути полей на разных страницах ведут в одни и те же данные.

7. В Конфигураторе и в Предприятии

Соберём первую свою форму документа — поступления — и разложим её по двум закладкам.

1. Откройте в дереве документ «ПоступлениеТоваров» и конструктором создайте ему форму документа. Назначьте её основной.

2. Добавьте в элементы группу «Страницы», а в неё две страницы: «Шапка» и «Товары».

3. Перетащите на страницу «Шапка» поля контрагента и склада, на страницу «Товары» — таблицу товаров. Номер и дату оставьте над страницами.

4. Обновите конфигурацию базы данных и откройте поступление № 12 в Предприятии. Переключите закладки: номер и дата остаются на месте.

5. Поменяйте положение закладок на «слева» и посмотрите ещё раз. Верните «сверху».

6. Оставьте форму: она понадобится в главе о списках, когда будем разбирать таблицу товаров.

Главное в одном абзаце

Страницы — способ показать форму по частям: на экране одна закладка, остальные ждут, пока пользователь их откроет. Собирается такая раскладка из групп с двумя значениями свойства «Вид»: «Страницы» держат набор и показывают закладки, «Страница» держит содержимое одной закладки и внутри устроена как обычная группа. Где будут закладки — сверху, снизу, сбоку, в виде пролистывания или нигде — решает свойство «Отображение страниц»; страницы без закладок нужны помощникам, которые ведут пользователя по шагам. Какая страница откроется первой, записано в свойстве «Текущая страница». Раскладывают по работе: на первую — то, что нужно каждый раз, на следующие — то, что нужно не всегда, а то, что нужно на любой закладке, — над страницами. Прятать на второй закладке то, без чего нельзя записать, не стоит. И страница — не отдельная форма: данные у всех закладок общие, записывается форма разом.

Поля разложены по группам и закладкам. Но в форме бывает и то, что не поле и не группа: пояснение под полем, картинка, линия, отделяющая одно от другого. Зачем они, если ничего не показывают из данных?

Контрольные вопросы

1. Из групп каких двух видов собирается страничная раскладка и чем они различаются?
2. Как устроена страница изнутри?
3. Какие бывают варианты показа закладок и зачем нужно значение «нет»?
4. Где записано, какая страница откроется первой?
5. Что кладут на первую страницу, что — на следующие, а что — вне страниц?
6. Почему обязательное поле не стоит прятать на вторую закладку?
7. Чем страница отличается от отдельной формы?

Упражнения

По образцу. Разложите по двум закладкам форму элемента «Контрагентов»: «Основное» — наименование и ИНН, «Контакты» — телефон и контактное лицо.

Своё: разложите реализацию. Документ «РеализацияТоваров» устроен так же, как поступление. Нарисуйте дерево его формы на закладках и объясните, что вы оставили над страницами и почему.

Ловушка: «каждая закладка — своя форма». Коллега уверен, что изменения на закладке «Товары» записываются отдельно от шапки. Что вы ему объясните?

Обратный ход. Форма открывается сразу на второй закладке. Где искать причину и в каком порядке?

На чтение. В чужой форме группа «Страницы» с четырьмя страницами, а закладок на экране нет, и внизу кнопки «Далее» и «Назад». Что это за форма?

Ответы — в конце части.

§ 5.4. Декорации: то, что в форме ради пользователя, а не ради данных

Затем, чтобы форма была понятна. Декорация ничего не показывает из данных и ничего не принимает — она поясняет, отмечает, оформляет. Видов у неё два: надпись и картинка. А линии, которая напрашивается после разговора о группах, среди них нет — и почему, разберём в этом же параграфе.

1. Два вида, и оба без данных

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

Двух видов хватает для оформления, не связанного с данными: что нужно сказать словами — надпись, что показать значком — картинка.

Декорация говорит с пользователем от имени автора формы, а не от имени записи: пути к данным у неё нет, и сказать что-то о записи ей нечем.

2. Надпись

Текст надписи записан в свойстве «Заголовок» самой декорации. Свойство называется так же, как подпись у поля, но работает иначе: у поля заголовок подписывает поле, а у надписи он и есть весь показываемый текст, ни к чему не привязанный. Меняется он только тогда, когда его поменяли в форме.

С полем надписи её путают постоянно, и различение то же, что в разговоре о видах полей: поле надписи показывает значение из данных и меняется вместе с ним, декорация показывает текст, набранный разработчиком, и не меняется сама. Различает их вид элемента в структуре.

3. Картинка

Картинка-декорация показывает изображение, выбранное из картинок конфигурации: значок, логотип, пиктограмму предупреждения.

Различает их, как и надпись с полем надписи, вид элемента и путь к данным. Подсказкой служит и сама картинка: у каждого товара своя — почти наверняка поле; одна и та же у всех — скорее декорация, но проверить всё равно стоит по пути.

4. Разделителя нет — есть группа

Линии, отделяющей одно от другого, среди видов декорации нет. В управляемой форме разделяют не линией, а правилом — группой.

Это ещё одно проявление принципа, с которого начиналась глава: не рисуем, а задаём правило. Разделение — не картинка на экране, а смысловое решение «это одно дело, а это другое», и записано оно в структуре.

Увидели в чужой форме линию — ищите не декорацию, а группу.

5. Надпись-ссылка

Надпись можно показать как гиперссылку, и тогда пользователь станет на неё нажимать. Что при этом произойдёт, декорация сама не знает: это задано в обработчике нажатия.

Для чтения формы этого достаточно: ссылка есть — значит, есть и код, который её обслуживает. Сам код — за границей книги.

6. Когда декорация к месту

Декорации легко добавлять, поэтому их легко и переборщить.

Последняя строка — самая частая ошибка: пояснение, которое должно зависеть от записи, сделали декорацией, и оно одинаково у всех записей, хотя должно было меняться. Если текст меняется вместе с данными, это поле надписи, а не декорация. А пояснение к одному полю чаще лучше положить в подсказку этого поля, о которой шла речь в разговоре о свойствах.

7. В Конфигураторе и в Предприятии

Добавим одно пояснение к группе «Учёт» — оно останется в форме.

1. Откройте форму элемента «Товаров» и добавьте декорацию вида «надпись» внутрь группы «Учёт», после полей.

2. Задайте ей заголовок «Артикул и единицу заполняет отдел закупок».

3. Посмотрите на предпросмотр и найдите надпись в структуре: вид элемента — декорация, пути к данным нет.

4. Обновите конфигурацию базы данных и откройте карточку товара. Откройте другой товар: надпись та же — она про форму, а не про запись.

5. Поставьте у группы «Учёт» сильное выделение и посмотрите, как появилась рамка. Верните выделение, как было.

Пятый шаг — ответ на вопрос о линии: то, что пользователь видит как разделитель, разработчик задаёт свойством группы.

Главное в одном абзаце

Декорация — элемент для оформления: данных у неё нет, пути к данным не бывает, и говорит она с пользователем от имени автора формы, а не от имени записи. Видов два: надпись, текст которой записан в её заголовке, и картинка, выбранная из картинок конфигурации. С полем надписи и полем картинки их различает вид элемента в структуре: поле показывает данные и меняется вместе с ними, декорация одинакова у всех записей. Разделителя среди декораций нет — разделяют группой с выделением и заголовком, и линию в чужой форме ищут в свойствах группы. Надпись может быть ссылкой; что случится по нажатию, задано обработчиком, то есть кодом. Декорация к месту, когда поясняет то, что не зависит от записи; текст, который должен меняться с данными, — дело поля, а пояснение к одному полю чаще уместнее в его подсказке.

Все детали композиции названы: группы, страницы, декорации. Но дерево элементов и экран до сих пор живут у нас порознь — в одном месте строки, в другом прямоугольники. Можно ли по одному сразу увидеть другое?

Контрольные вопросы

1. Какие два вида декораций бывают и чем они отличаются от полей?
2. Где записан текст надписи-декорации?
3. Как отличить картинку-декорацию от поля картинки?
4. Почему среди декораций нет разделителя и чем разделяют блоки полей?
5. Что означает надпись, показанная как гиперссылка?
6. Когда декорация не к месту? Назовите два случая.
7. Что лучше для пояснения к одному полю — надпись или подсказка?

Упражнения

По образцу. Добавьте в форму элемента «Контрагентов» надпись «ИНН — 10 или 12 цифр» рядом с полем ИНН и проверьте в Предприятии.

Своё: декорация или поле. Для каждого решите, чем это сделать: «Документ проведён» — меняется от документа к документу; «Все цены без НДС» — одинаково для всех; логотип фирмы в шапке; фотография товара.

Ловушка: «добавь линию между блоками». Заказчик просит «провести черту» между шапкой документа и его товарами. Разработчик ищет в палитре декорацию «разделитель» и не находит. Что вы ему подскажете?

Обратный ход. В чужой форме над полями контрагента стоит заголовок «Покупатель» с линией. Какой элемент вы ожидаете найти в структуре?

На чтение. В форме надпись «Нажмите, чтобы заполнить по умолчанию» подчёркнута и выглядит как ссылка. Что можно сказать о форме, не открывая модуль?

Ответы — в конце части.

§ 5.5. От дерева к скетчу и обратно

Можно — и это главный навык главы. Дерево элементов и экран — два взгляда на одну форму: дерево говорит, что в чём лежит и в каком порядке, экран показывает, как это легло. Кто умеет переводить одно в другое, тот читает форму, не открывая Предприятие, и собирает её, не гадая в редакторе.

1. Два описания одной формы

У нас уже есть оба способа записи, и оба встречались в книге не раз.

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

2. Правила перевода

Перевод держится на нескольких правилах, и все они уже встречались по отдельности.

Ещё одно правило — отрицательное: элемент со снятой видимостью на скетч не попадает. Его место в дереве, а не на экране.

Дерево читают сверху вниз, и каждая группа говорит, как разложить то, что в ней лежит. Больше для скетча ничего не нужно.