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

Продукты
Все продукты

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

На заметку. Больше информации об объектах доступно в обучающем курсе Объектная модель данных Creatio.

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

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

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

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

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

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

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

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

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

Пример. Создадим деталь, которая отобразит на странице контакта перечень его заявок.

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

  1. Откройте нужный раздел, например, раздел Контакты.
  2. Кликните Вид —> Открыть мастер раздела.
  3. В блоке Страницы раздела мастера разделов:
    • Кликните Редактировать страницу, если в разделе настроена только одна страница.
    • Кликните по ссылке на соответствующую страницу, если в разделе настроено несколько страниц редактирования.
  4. Перейдите на вкладку, где должна располагаться деталь.
  5. Нажмите кнопку Добавить деталь.
  6. В окне настройки детали справа от поля Деталь нажмите кнопку btn_add.png.
  7. В появившемся меню выберите Добавить по существующему объекту (Рис. 1).
    Рис. 1 — Создание детали по существующему объекту
    scr_create_detail_from_section_wizard.png
  8. В открывшемся окне (Рис. 2):
    1. Укажите объект, на основании которого будет создана деталь. В нашем примере это “Заявки” .
    2. Укажите заголовок детали, по которому ее будет легко найти в перечне объектов. В нашем примере это “Заявки контакта”.
    3. При необходимости добавьте переводы заголовка. Подробнее о переводах читайте в статье: Добавить переводы новых элементов интерфейса.
    4. Если вы хотите, чтобы данные на детали можно было редактировать непосредственно в строке реестра, не переходя на отдельную страницу, то установите признак Сделать реестр редактируемым.
    5. Нажмите Сохранить.
      Рис. 2 — Пример настройки детали в мастере разделов на основании существующего объекта
      scr_set_detail_from_existing_object_in_section_wizard.png
  9. В окне настройки детали в блоке Какие записи показать на странице? настройте правила отображения записей раздела Заявки на новой детали:
    1. В поле У которых колонка детали укажите колонку объекта детали, по значению которой приложение будет определять, отображать ли запись на странице. В нашем примере это колонка “Создал”.
    2. В поле Равна колонке страницы укажите колонку страницы текущего раздела, значение которой необходимо сравнить со значением ранее заполненного поля У которых колонка детали. В нашем примере это колонка “Id”.
      В результате на странице контакта отобразятся только те записи раздела Заявки, у которых в поле Создал указан этот контакт.
  10. Нажмите Сохранить.
  11. Сохраните изменения в мастере разделов.

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

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

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

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

На заметку. Как добавить пользовательский раздел в систему, описано в статье Добавить новый раздел.

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

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

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

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

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

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

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

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

      Рис. 7 — Создание справочного поля
      gif_drag_lookup_in_detail_wizard.gif
    3. Укажите параметры справочного поля во всплывающем окне Новая колонка.

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

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

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

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

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

        Рис. 9 — Блокировка удаления записей
        scr_block_deleting_records.png
      5. Сохраните изменения в окне Новая колонка.

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

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

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