Создать новую деталь

Деталь — это элемент страницы, на котором представлены записи объекта, связанного с текущей записью. Детали используются, когда на странице записи необходимо отобразить данные из другой сущности, которые связаны с текущей записью. Например, все знаменательные события контакта или адреса контрагента. Большинство деталей имеют собственный реестр. На детали отображаются только те записи, которые связаны с текущей записью раздела. Обычно связь устанавливается по справочной колонке детали, в которой используется объект страницы записи (чаще всего это объект раздела). Детали с полями редактирования или нестандартными данными, например, Файлы и ссылки, а также детали, данные которых не имеют прямой связи с текущей записью, создаются только средствами разработки. Подробнее читайте в документации по разработке, статья Деталь.

Например, на детали Участники активности представлен список участников текущей активности. А на детали Активности представлен список активностей, связанных с текущим контактом, контрагентом и т. д.

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

Деталь может быть создана:

• На основании существующего объекта системы. Например, после добавления нового пользовательского раздела вы можете отобразить его данные в виде детали в других разделах системы. Также этой возможностью можно воспользоваться, когда вам нужно использовать на страницах разделов детали, созданные на основании одного объекта, но отличные по свойствам. Подробнее >>>
• На основании нового объекта системы. Например, в пользовательском разделе Заявки для заявок от сотрудников на оформление больничного можно отобразить перечень медицинских документов. Эта возможность используется в случаях, когда в приложении еще не создан объект, данные которого вы планируете отобразить на странице. Подробнее >>>

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

Создать деталь на основании существующего объекта 

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

• Если вы создаете деталь на основании пользовательского объекта, убедитесь, что ваши текущие изменения сохраняются в том же пакете или в зависимом от него.
• Если вы создаете деталь на основании базового объекта, убедитесь, что пакете, в котором сохраняются ваши изменения, настроена зависимость от пакета, в котором сохранен базовый объект (обычно это пакет Base или пакет с функциональностью продукта, например, “SalesEnterprise”).

Подробнее о пакетах читайте в документации по разработке, статья Общие принципы работы с пакетами.

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

1. Откройте нужный раздел, например, раздел Контакты.
2. Кликните Вид —> Открыть мастер раздела.
3. В блоке Страницы раздела мастера разделов:
   • Кликните Редактировать страницу, если в разделе настроена только одна страница.
   • Кликните по ссылке на соответствующую страницу, если в разделе настроено несколько страниц редактирования.
4. Перейдите на вкладку, где должна располагаться деталь.
5. Нажмите кнопку Добавить деталь.
6. В окне настройки детали справа от поля Деталь нажмите кнопку .
7. В появившемся меню выберите Добавить по существующему объекту (Рис. 1).
   Рис. 1 — Создание детали по существующему объекту

   
8. В открывшемся окне (Рис. 2):
   1. Укажите объект, на основании которого будет создана деталь. В нашем примере это “Заявки” .
   2. Укажите заголовок детали, по которому ее будет легко найти в перечне объектов. В нашем примере это “Заявки контакта”.
   3. При необходимости добавьте переводы заголовка. Подробнее о переводах читайте в статье: Добавить переводы новых элементов интерфейса.
   4. Если вы хотите, чтобы данные на детали можно было редактировать непосредственно в строке реестра, не переходя на отдельную страницу, то установите признак Сделать реестр редактируемым.
   5. Нажмите Сохранить.
      Рис. 2 — Пример настройки детали в мастере разделов на основании существующего объекта

      
9. В окне настройки детали в блоке Какие записи показать на странице? настройте правила отображения записей раздела Заявки на новой детали:
   1. В поле У которых колонка детали укажите колонку объекта детали, по значению которой приложение будет определять, отображать ли запись на странице. В нашем примере это колонка “Создал”.
   2. В поле Равна колонке страницы укажите колонку страницы текущего раздела, значение которой необходимо сравнить со значением ранее заполненного поля У которых колонка детали. В нашем примере это колонка “Id”.
      В результате на странице контакта отобразятся только те записи раздела Заявки, у которых в поле Создал указан этот контакт.
10. Нажмите Сохранить.
11. Сохраните изменения в мастере разделов.

В результате в приложении будут созданы схема и страница детали. Новая деталь будет зарегистрирована и добавлена на страницу записи. Страница редактирования детали идентична странице пользовательского раздела Заявки. Все изменения, которые вы внесете на страницу детали отобразятся также на странице раздела. В пакете, в котором сохраняются изменения, появятся схема (клиентский модуль) и данные новой детали, а также обновленные объект, схема и страница редактирования раздела Контакты.

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

Создать деталь на основании нового объекта 

1. Откройте нужный раздел, например, раздел Заявки.
2. Кликните Вид —> Открыть мастер раздела.
3. В блоке Страницы раздела мастера разделов:
   • Кликните Редактировать страницу, если в разделе настроена только одна страница.
   • Кликните по ссылке на соответствующую страницу, если в разделе настроено несколько страниц редактирования.
4. Перейдите на вкладку, где должна располагаться деталь.
5. Нажмите кнопку Добавить деталь.
6. В окне настройки детали справа от поля Деталь нажмите кнопку .
7. В появившемся меню выберите Добавить по новому объекту (Рис. 3).
   Рис. 3 — Создание детали по новому объекту

   
8. В открывшемся окне (Рис. 4) укажите:
   1. Заголовок объекта, в перечне объектов конфигурации. В нашем примере это “Медицинские документы”.
   2. Заголовок детали, по которому ее можно будет найти в перечне объектов в мастере разделов. В нашем примере это “Медицинские документы”.
   3. Уникальный код, который отобразится в перечне объектов конфигурации. Код обязательно должен содержать префикс, определяющий создателя объекта. Этот префикс задается в системной настройке “Префикс названия объекта”. В нашем примере это “UsrMedicalDocuments”.
   4. Если вы хотите, чтобы данные на детали можно было редактировать непосредственно в строке реестра, не переходя на отдельную страницу, то установите признак Сделать реестр редактируемым.
   5. Данные в блоке Как связать деталь с текущей страницей? заполнятся автоматически.
   6. Нажмите Сохранить.
      Рис. 4 — Пример заполнения параметров новой детали

      
9. В окне настройки детали все параметры заполнятся автоматически. Нажмите Сохранить.
10. Сохраните изменения в мастере разделов.

В результате в приложении будут созданы объект, схема и страница детали. Новая деталь будет зарегистрирована и добавлена на страницу пользовательского раздела Заявки.

Деталь будет также доступна в перечне существующих деталей в мастере разделов. При необходимости вы сможете добавить ее на страницу любого раздела, с которым у детали можно будет установить связь. На странице детали отобразятся поля Название (обязательное) и Заявки, по которому определяется связь записей детали с текущей записью раздела. Чтобы добавить другие поля, необходимо отредактировать страницу детали. Подробнее: Настроить существующую деталь на странице записи. В пакете, в котором сохраняются изменения, появятся объект, страница, схема (клиентский модуль) и связи новой детали. Если раздел, на страницу которого вы добавляли деталь, сохранен в другом пакете, то после сохранения изменений в мастере раздела в ваш пакет будут сохранены также обновленные объект, схема и страница редактирования раздела.

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

Создать деталь для последующего добавления на страницу записи 

Вы можете создать и настроить деталь в мастере деталей. Эта возможность удобна, например, для совместной работы над no-code кастомизацией приложения. Новая деталь будет доступна для выбора в перечне деталей в мастере разделов и отобразится в разделе Управление конфигурацией. Вы сможете добавить ее на страницу любого раздела, с которым у данной детали можно установить связь, а также перенести в другую среду. Аналогично мастеру разделов, в мастере деталей вы можете создавать детали на основании существующих либо новых объектов приложения. Рассмотрим работу в мастере деталей на примере создания пользовательской детали на основании нового объекта.

1. Нажмите —> Дизайнер системы.
2. В группе Настройка системы перейдите по ссылке Мастер деталей.
3. На открывшейся странице (Рис. 5):
   1. В блоке По какому объекту создать деталь? выберите “Новому объекту”.
   2. Укажите заголовок новой детали, который будет отображаться в перечне доступных деталей в мастере разделов. В нашем примере это “Регистрационные документы”.
   3. Введите заголовок и уникальный код нового объекта, по которым его можно будет найти в перечне конфигурационных элементов. В нашем примере это “Регистрационные документы” и “UsrRegistrationDocuments” соответственно.
      Рис. 5 — Пример настройки детали на основании нового объекта

      
4. Свяжите новую деталь с объектом раздела Контакты. Для этого:
   1. Нажмите Страница, чтобы перейти к настройке страницы записи детали (Рис. 6).
      Рис. 6 — Переход к редактированию страницы детали

      

   2. Перетащите колонку Справочник из области Новая колонка левой части рабочей области дизайнера в правую часть (Рис. 7). Отобразится окно Новая колонка.

      Рис. 7 — Создание справочного поля

      

   3. Укажите параметры справочного поля во всплывающем окне Новая колонка.

      1. В поле Заголовок введите название поля, которое будут видеть пользователи, например, “Контакт“.

      2. В поле Код (на английском) после префикса укажите уникальное название поля в базе данных, например, “UsrContact”.

         Важно. Поле Код (на английском) должно содержать префикс, указывающий на автора конфигурационных изменений. Префикс задается в системной настройке “Префикс названия объекта“. По умолчанию в системной настройке установлено значение “Usr”.

      3. В поле Справочник выберите объект раздела, с которым необходимо связать деталь. Например, чтобы связать деталь с записями раздела Контакты, выберите объект “Контакт” в качестве справочника.

         Рис. 8 — Настройки справочной колонки, по которой деталь связывается с разделом

         

      4. Если необходимо, чтобы содержащиеся на детали записи не удалялись при удалении записи, с которой связана деталь, то выберите опцию Блокировать удаление, если есть связанные записи (Рис. 9).

         Рис. 9 — Блокировка удаления записей

         

      5. Сохраните изменения в окне Новая колонка.

5. Настройте страницу детали. Добавьте на нее поля и группы полей, в которых будут храниться данные регистрационных документов. В нашем примере это Тип документа, Серия, Номер, Выдан. Настройка полей детали выполняется аналогично настройке полей страницы. Подробнее: Настроить поля страницы.

6. Затем сохраните деталь по кнопке Сохранить.

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