Деталь

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

Назначение детали — отображение дополнительных данных для основного объекта раздела. Детали раздела отображаются во вкладках страницы записи раздела в контейнере вкладок.

Структура и типы деталей 

Составляющие детали:

• Схема объекта детали связана с объектом раздела. Например, детали Адреса (Addresses) страницы контакта соответствует схема объекта ContactAddress пакета Base. Связь с объектом раздела выполняется по обязательной колонке Contact объекта детали.
• Схема модели представления детали позволяет настроить структуру, расположение и поведение элементов пользовательского интерфейса детали. Например, деталь Адреса (Addresses) страницы контакта настраивается в схеме ContactAddressDetailV2 модели представления детали, которая наследует схему BaseAddressDetailV2) пакета UIv2.
• Схема модели представления страницы записи детали позволяет настроить страницу детали. Например, свойства страницы детали Адреса (Addresses) страницы контакта настраивается в схеме ContactAddressPageV2 модели представления страницы записи детали, которая наследует схему BaseAddressPageV2 пакета UIv2.

Типы деталей, которые предоставляет Creatio:

• Деталь с редактируемым реестром.
• Деталь со страницей добавления.
• Деталь с выбором из справочника.
• Деталь с полями.
• Деталь типа Файлы и ссылки (Attachments).

Тип детали зависит от метода ввода и отображения данных.

Реализовать деталь 

Функциональность базовой детали реализована в схеме BaseDetailV2 пакета NUI.

Инструменты, которые позволяют реализовать деталь:

• Мастер деталей.
• Creatio IDE.

Реализовать некоторые типы деталей невозможно исключительно в мастере деталей. В этом случае необходимо использовать комбинацию мастера деталей и Creatio IDE. Особенности использования инструментов при реализации разных типов деталей будут рассмотрены далее.

Общий алгоритм реализации детали с использованием мастера деталей:

1. Создайте пользовательскую деталь. Для этого воспользуйтесь инструкцией, которая приведена в статье Создать новую деталь.
2. Добавьте пользовательскую деталь на страницу записи. Для этого воспользуйтесь инструкцией, которая приведена в статье Настроить существующую деталь на странице записи.
3. Настройте внешний вид пользовательской детали (опционально). Для этого воспользуйтесь инструкцией, которая приведена в статье Настроить существующую деталь на странице записи.

Общий алгоритм реализации детали с использованием Creatio IDE:

1. Создайте пользовательскую деталь.

   1. Создайте схему объекта детали. Для этого воспользуйтесь инструкцией, которая приведена в статье Разработка конфигурационных элементов.
   2. Создайте схему модели представления детали. Для этого воспользуйтесь инструкцией, которая приведена в статье Разработка конфигурационных элементов.
   3. Добавьте пользовательские стили детали (опционально).
   4. Зарегистрируйте деталь в базе данных (опционально).

2. Добавьте пользовательскую деталь на страницу записи.

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

3. Настройте внешний вид пользовательской детали (опционально). Для этого воспользуйтесь инструкцией, которая приведена в статье Настроить существующую деталь на странице записи.

Реализовать деталь с редактируемым реестром 

Деталь с редактируемым реестром позволяет вводить и редактировать данные в реестре детали. Данные отображаются в списочном представлении. Деталь с редактируемым реестром является подвидом детали с реестром. Функциональность базовой детали с реестром реализована в схеме BaseGridDetailV2 пакета NUI. Примером детали с редактируемым реестром является деталь Продукты (Products) страницы заказа. Данные каждого продукта редактируются на странице заказа.

Использовать мастер деталей для реализации детали с редактируемым реестром 

1. Создайте пользовательскую деталь.

   • Настройте редактируемый реестр. Для этого в мастере деталей установите признак Сделать реестр редактируемым (Make the list editable). В другом случае будет создана деталь со страницей добавления.
   • Настройте многострочный текст (опционально). Для отображения данных в несколько строк установите признак Многострочный текст (Multi-line text). Многострочный текст доступен к использованию только для колонок типа Строка (String).
2. Выполните шаг 2 общего алгоритма реализации детали с использованием мастера деталей.

Использовать Creatio IDE для реализации детали с редактируемым реестром 

Чтобы реализовать деталь с редактируемым реестром с использованием Creatio IDE:

1. Создайте пользовательскую деталь.

   1. Создайте схему объекта детали.

      • В качестве родительского объекта выберите BaseEntity.
      • В схему объекта добавьте колонку типа Строка (String) и другие необходимые колонки.

   2. Создайте схему модели представления детали с редактируемым реестром.

      • В качестве родительского объекта выберите BaseGridDetailV2.
      • На панели инструментов в контекстном меню узла Локализуемые строки (Localizable strings) выберите локализуемую строку Caption и в свойстве Значение (Value) задайте название детали.

      • Реализуйте редактируемый реестр.

        1. В зависимости добавьте схемы модулей ConfigurationGrid, ConfigurationGridGenerator, ConfigurationGridUtilitiesV2.
        2. В свойство mixins добавьте миксин ConfigurationGridUtilitiesV2.
        3. В свойство attributes добавьте атрибут IsEditable со значением true свойства value.
      • Реализуйте многострочный текст (опционально). Для этого в свойство attributes добавьте колонку типа Строка (String) со значением Terrasoft.ContentType.LONG_TEXT свойства contentType.

      Пример схемы ContactPageV2 модели представления детали с редактируемым реестром UsrCourierServiceDetail, у которой для колонки UsrDescription используется многострочный текст, приведен ниже.

      Пример схемы замещающей модели представления

      /* Определение схемы и установка ее зависимостей от других модулей. */
      define("UsrCourierServiceDetail", ["ConfigurationGrid", "ConfigurationGridGenerator", "ConfigurationGridUtilitiesV2"], function() {
          return {
              /* Название схемы объекта детали. */
              entitySchemaName: "UsrCourierService",
              /* Перечень атрибутов схемы. */
              attributes: {
                  /* Признак возможности редактирования. */
                  "IsEditable": {
                      /* Тип данных — логический. */
                      dataValueType: Terrasoft.DataValueType.BOOLEAN,
                      /* Тип атрибута — виртуальная колонка модели представления. */
                      type: Terrasoft.ViewModelColumnType.VIRTUAL_COLUMN,
                      /* Устанавливаемое значение. */
                      value: true
                  }
              },
              /* Используемые миксины. */
              mixins: {
                  ConfigurationGridUtilities: "Terrasoft.ConfigurationGridUtilitiesV2"
              },
              /* Массив модификаций модели представления. */
              diff: /**SCHEMA_DIFF*/[
                  {
                      /* Тип операции — слияние. */
                      "operation": "merge",
                      /* Название элемента схемы, над которым производится действие. */
                      "name": "DataGrid",
                      /* Объект, свойства которого будут объединены со свойствами элемента схемы. */
                      "values": {
                          /* Имя класса. */
                          "className": "Terrasoft.ConfigurationGrid",
                          /* Генератор представления должен генерировать только часть представления. */
                          "generator": "ConfigurationGridGenerator.generatePartial",
                          /* Привязка события получения конфигурации элементов редактирования активной строки к методу-обработчику. */
                          "generateControlsConfig": {"bindTo": "generateActiveRowControlsConfig"},
                          /* Привязка события смены активной записи к методу-обработчику. */
                          "changeRow": {"bindTo": "changeRow"},
                          /* Привязка события отмены выбора записи к методу-обработчику. */
                          "unSelectRow": {"bindTo": "unSelectRow"},
                          /* Привязка  события клика на реестре к методу-обработчику. */
                          "onGridClick": {"bindTo": "onGridClick"},
                          /* Действия, производимые с активной записью. */
                          "activeRowActions": [
                              /* Настройка действия [Сохранить]. */
                              {
                                  /* Имя класса элемента управления, с которым связано действие. */
                                  "className": "Terrasoft.Button",
                                  /* Стиль отображения — прозрачная кнопка. */
                                  "style": this.Terrasoft.controls.ButtonEnums.style.TRANSPARENT,
                                  /* Тег. */
                                  "tag": "save",
                                  /* Значение маркера. */
                                  "markerValue": "save",
                                  /* Привязка к изображению кнопки. */
                                  "imageConfig": {"bindTo": "Resources.Images.SaveIcon"}
                              },
                              /* Настройка действия [Редактировать в карточке]. */
                              {
                                  "className": "Terrasoft.Button",
                                  "style": this.Terrasoft.controls.ButtonEnums.style.TRANSPARENT,
                                  "tag": "card",
                                  "markerValue": "card",
                                  "imageConfig": {"bindTo": "Resources.Images.CardIcon"}
                              },
                              /* Настройка действия [Копировать]. */
                              {
                                  "className": "Terrasoft.Button",
                                  "style": Terrasoft.controls.ButtonEnums.style.TRANSPARENT,
                                  "tag": "copy",
                                  "markerValue": "copy",
                                  "imageConfig": {"bindTo": "Resources.Images.CopyIcon"}
                              },
                              /* Настройка действия [Отменить]. */
                              {
                                  "className": "Terrasoft.Button",
                                  "style": this.Terrasoft.controls.ButtonEnums.style.TRANSPARENT,
                                  "tag": "cancel",
                                  "markerValue": "cancel",
                                  "imageConfig": {"bindTo": "Resources.Images.CancelIcon"}
                              },
                              /* Настройка действия [Удалить]. */
                              {
                                  "className": "Terrasoft.Button",
                                  "style": this.Terrasoft.controls.ButtonEnums.style.TRANSPARENT,
                                  "tag": "remove",
                                  "markerValue": "remove",
                                  "imageConfig": {"bindTo": "Resources.Images.RemoveIcon"}
                              }
                          ],
                          /* Привязка к методу, который инициализирует подписку на события нажатия кнопок в активной строке. */
                          "initActiveRowKeyMap": {"bindTo": "initActiveRowKeyMap"},
                          /* Привязка события выполнения действия активной записи к методу-обработчику. */
                          "activeRowAction": {"bindTo": "onActiveRowAction"},
                          /* Признак возможности выбора нескольких записей. */
                          "multiSelect": {"bindTo": "MultiSelect"},
                          /* Колонка описания. */
                          "UsrDescription": {
                              /* Тип отображения - длинный текст. */
                              "contentType": Terrasoft.ContentType.LONG_TEXT
                          }
                      }
                  }
              ]/**SCHEMA_DIFF*/
          };
      });
      

   3. Зарегистрируйте деталь в базе данных. Для этого выполните SQL-запрос к таблице [SysDetails] базы данных.

      SQL-запрос

      DECLARE 
      -- Название схемы детали.
      @ClientUnitSchemaName NVARCHAR(100) = 'UsrИмяСхемыДетали',
      -- Название схемы объекта детали.
      @EntitySchemaName NVARCHAR(100) = 'UsrИмяСхемыОбъектаДетали',
      -- Название детали.
      @DetailCaption NVARCHAR(100) = 'ИмяДетали'
      
      INSERT INTO SysDetail(
          Caption,
          DetailSchemaUId,
          EntitySchemaUId
      )
      VALUES(
          @DetailCaption,
          (SELECT TOP 1 UId
          from SysSchema
          WHERE Name = @ClientUnitSchemaName),
          (SELECT TOP 1 UId
          from SysSchema
          WHERE Name = @EntitySchemaName)
      )
      

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

2. Добавьте пользовательскую деталь на страницу записи.

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

   • В качестве родительского объекта выберите схему модели представления, которую необходимо заместить.
   • В свойство details добавьте деталь.
   • В массив модификаций diff добавьте конфигурационный объект модели представления детали.

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

   Пример схемы замещающей модели представления

   define("ContactPageV2", [], function() {
       return {
           entitySchemaName: "Contact",
           details: /**SCHEMA_DETAILS*/ {
               /* Добавление детали с полями. */
               "UsrRegDocumentFieldsDetail": {
                   /* Название клиентской схемы детали. */
                   "schemaName": "UsrRegDocumentFieldsDetail",
                   /* Фильтрация записей детали текущего контакта (физ. лица). */
                   "filter": {
                       /* Колонка объекта детали. */
                       "detailColumn": "UsrContact",
                       /* Колонка идентификатора контакта. */
                       "masterColumn": "Id"
                   }
               }
           } /**SCHEMA_DETAILS*/ ,
           diff: /**SCHEMA_DIFF*/ [{
               /* Добавление нового элемента. */
               "operation": "insert",
               /* Название элемента. */
               "name": "UsrRegDocumentFieldsDetail",
               /* Конфигурационный объект значений. */
               "values": {
                   /* Тип элемента. */
                   "itemType": Terrasoft.ViewItemType.DETAIL
               },
               /* Имя элемента-контейнера. */
               "parentName": "HistoryTab",
               /* Имя свойства элемента-контейнера, который содержит коллекцию вложенных элементов. */
               "propertyName": "items",
               /* Индекс добавляемого в коллекцию элемента. */
               "index": 0
           }] /**SCHEMA_DIFF*/
       };
   });
   

Реализовать деталь со страницей добавления 

Деталь со страницей добавления позволяет вводить и редактировать данные на странице детали. Деталь со страницей добавления является подвидом детали с реестром. Функциональность базовой детали с реестром реализована в схеме BaseGridDetailV2 пакета NUI. Примером детали со страницей добавления является деталь Адреса (Addresses) страницы контакта. Данные каждого адреса вводятся и редактируются на странице Адрес контакта (Contact address).

Чтобы реализовать деталь со страницей добавления с использованием мастера деталей, используйте общий алгоритм реализации детали с использованием мастера деталей.

Чтобы реализовать деталь со страницей добавления с использованием Creatio IDE:

1. Создайте пользовательскую деталь.

   1. Создайте схему объекта детали.

      • В качестве родительского объекта выберите BaseEntity.
      • В схему объекта добавьте необходимые колонки.

   2. Создайте схему модели представления детали со страницей добавления.

      • В качестве родительского объекта выберите BaseGridDetailV2.
      • На панели инструментов в контекстном меню узла Локализуемые строки (Localizable strings) выберите локализуемую строку Caption и в свойстве Значение (Value) задайте название детали.

   3. Создайте схему модели представления страницы записи детали. Для этого воспользуйтесь инструкцией, которая приведена в статье Разработка конфигурационных элементов.

      • В качестве родительского объекта выберите BasePageV2.
      • В массив модификаций diff добавьте конфигурационный объект модели представления детали.

      Пример схемы UsrCourierDetailPage модели представления страницы записи детали UsrCourierInOrder приведен ниже.

      Пример схемы модели представления страницы записи детали

      define("UsrCourierDetailPage", [], function() {
          return {
              /* Название схемы объекта детали. */
              entitySchemaName: "UsrCourierInOrder",
              details: /**SCHEMA_DETAILS*/{}/**SCHEMA_DETAILS*/,
              /* Массив модификаций. */
              diff: /**SCHEMA_DIFF*/[
                  /* Метаданные для добавления поля [Заказ]. */
                  {
                      "operation": "insert",
                      /* Название поля. */
                      "name": "Order",
                      "values": {
                          /* Настройка расположения поля на странице записи. */
                          "layout": {
                              "colSpan": 12,
                              "rowSpan": 1,
                              "column": 0,
                              "row": 0,
                              "layoutName": "Header"
                          },
                          /* Привязка к колонке [Order] схемы объекта. */
                          "bindTo": "UsrOrder"
                      },
                      "parentName": "Header",
                      "propertyName": "items",
                      "index": 0
                  },
                  /* Метаданные для добавления поля [Контакт]. */
                  {
                      "operation": "insert",
                      /* Название поля. */
                      "name": "Contact",
                      "values": {
                          /* Настройка расположения поля на странице записи. */
                          "layout": {
                              "colSpan": 12,
                              "rowSpan": 1,
                              "column": 12,
                              "row": 0,
                              "layoutName": "Header"
                          },
                          /* Привязка к колонке [Contact] схемы объекта. */
                          "bindTo": "UsrContact"
                      },
                      "parentName": "Header",
                      "propertyName": "items",
                      "index": 1
                  }
              ]/**SCHEMA_DIFF*/,
              methods: {},
              rules: {}
          };
      });
      

   4. Зарегистрируйте деталь в базе данных.

      1. Зарегистрируйте связь между схемой объекта детали и схемой реестра детали. Для этого выполните SQL-запрос к таблице [SysDetails] базы данных.

         SQL-запрос

         DECLARE 
         -- Название схемы детали.
         @DetailSchemaName NCHAR(100) = 'UsrИмяСхемыДетали',
         -- Название схемы объекта детали.
         @EntitySchemaName NVARCHAR(100) = 'UsrИмяСхемыОбъектаДетали',
         -- Название детали.
         @DetailCaption NVARCHAR(100) = 'ИмяДетали'
         
         INSERT INTO SysDetail(
             ProcessListeners,
             Caption,
             DetailSchemaUId,
             EntitySchemaUId
         )
         VALUES (
             0,
             @DetailCaption,
             (SELECT TOP 1 UId
             FROM SysSchema
             WHERE name = @DetailSchemaName),
             (SELECT TOP 1 UId
             FROM SysSchema
             WHERE name = @EntitySchemaName)
         )
         

      2. Зарегистрируйте связь между схемой объекта детали и схемой страницы записи детали. Для этого выполните SQL-запрос к таблицам [SysModuleEntity] и [SysModuleEdit] базы данных.

         SQL-запрос

         DECLARE 
         -- Название схемы страницы детали.
         @CardSchemaName NCHAR(100) = 'UsrИмяСхемыСтраницыДетали',
         -- Название схемы объекта детали.
         @EntitySchemaName NVARCHAR(100) = 'UsrИмяСхемыОбъектаДетали',
         -- Название страницы детали.
         @PageCaption NVARCHAR(100) = 'ИмяСтраницыДетали',
         -- Пустая строка.
         @Blank NCHAR(100) = ''
         
         INSERT INTO SysModuleEntity(
             ProcessListeners,
             SysEntitySchemaUId
         )
         VALUES (
             0,
             (SELECT TOP 1 UId
             FROM SysSchema
             WHERE Name = @EntitySchemaName
             )
         )
         
         INSERT INTO SysModuleEdit(
             SysModuleEntityId,
             UseModuleDetails,
             Position,
             HelpContextId,
             ProcessListeners,
             CardSchemaUId,
             ActionKindCaption,
             ActionKindName,
             PageCaption
         )
         VALUES (
             (SELECT TOP 1 Id
             FROM SysModuleEntity
             WHERE SysEntitySchemaUId = (
                 SELECT TOP 1 UId
                 FROM SysSchema
                 WHERE Name = @EntitySchemaName
                 )
             ),
             1,
             0,
             @Blank,
             0,
             (SELECT TOP 1 UId
              FROM SysSchema
              WHERE name = @CardSchemaName
             ),
             @Blank,
             @Blank,
             @PageCaption
         )
         

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

   5. Для применения изменений перезапустите приложение в IIS.

2. Добавьте пользовательскую деталь на страницу записи.

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

   • В качестве родительского объекта выберите схему модели представления, которую необходимо заместить.
   • В свойство details добавьте деталь.
   • В массив модификаций diff добавьте конфигурационный объект модели представления детали.
3. Выполните шаг 4 общего алгоритма реализации детали с использованием Creatio IDE. Без выполнения этого шага деталь отображается на странице записи, но не содержит записей, поскольку не указаны колонки для отображения.

Реализовать деталь с выбором из справочника 

Деталь с выбором из справочника позволяет выбирать данные из справочника, который отображается в модальном окне. Деталь с выбором из справочника является подвидом детали с реестром. Функциональность базовой детали с реестром реализована в схеме BaseGridDetailV2 пакета NUI. Примером детали с выбором из справочника является деталь Продукты (Products) страницы лида. Выбор продукта выполняется в модальном окне Выбор: Продукты (Select: Products).

Использовать мастер деталей для реализации детали с выбором из справочника 

1. Создайте пользовательскую деталь.

   • Добавьте на деталь колонку типа Справочник (Lookup).
   • Настройте вид справочника. Для этого в свойстве Вид справочника (Lookup view) выберите значение "Всплывающее окно" ("Selection window").
2. Выполните шаг 2 общего алгоритма реализации детали с использованием мастера деталей.

Использовать Creatio IDE для реализации детали с выбором из справочника 

1. Создайте пользовательскую деталь.

   1. Создайте схему объекта детали.

      • В качестве родительского объекта выберите BaseEntity.
      • В схему объекта добавьте колонку типа Справочник (Lookup) и другие необходимые колонки.

   2. Создайте схему модели представления детали с выбором из справочника.

      • В качестве родительского объекта выберите BaseGridDetailV2.
      • На панели инструментов в контекстном меню узла Локализуемые строки (Localizable strings) выберите локализуемую строку Caption и в свойстве Значение (Value) задайте название детали.

2. Добавьте пользовательскую деталь на страницу записи.

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

   • В качестве родительского объекта выберите схему модели представления, которую необходимо заместить.
   • В зависимости схемы модели представления страницы записи добавьте схему модуля ConfigurationEnums.

   • В свойство methods добавьте методы:

     • onDocumentInsert() — обрабатывает событие добавления записей в реестр детали.
     • onCardSaved() — обрабатывает событие сохранения страницы записи с деталью.
     • openDocumentLookup() — вызывает модальное окно справочника.
     • Вспомогательные методы управления данными.
   • В массив модификаций diff добавьте конфигурационный объект модели представления детали.

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

   Пример схемы замещающей модели представления

   /* Определение схемы и установка ее зависимостей от других модулей. */
   define("UsrCourierCertDetail", ["ConfigurationEnums"],
       function(configurationEnums) {
           return {
               /* Название схемы объекта детали. */
               entitySchemaName: "UsrCourierCertInOrder",
               /* Методы схемы детали. */
               methods: {
                   /* Возвращает колонки, которые выбираются запросом. */
                   getGridDataColumns: function() {
                       return {
                           "Id": {path: "Id"},
                           "Document": {path: "UsrDocument"},
                           "Document.Number": {path: "UsrDocument.Number"}
                       };
                   },
   
                   /* Конфигурирует и отображает модальное окно справочника. */
                   openDocumentLookup: function() {
                       /* Конфигурационный объект. */
                       var config = {
                           /* Название схемы объекта, записи которого будут отображены в справочнике. */
                           entitySchemaName: "Document",
                           /* Возможность множественного выбора. */
                           multiSelect: true,
                           /* Колонки, которые будут использованы в справочнике, например, для сортировки. */
                           columns: ["Number", "Date", "Type"]
                       };
                       var OrderId = this.get("MasterRecordId");
                       if (this.Ext.isEmpty(OrderId)) {
                           return;
                       }
                       /* Экземпляр класса EntitySchemaQuery. */
                       var esq = this.Ext.create("Terrasoft.EntitySchemaQuery", {
                           /* Установка корневой схемы. */
                           rootSchemaName: this.entitySchemaName
                       });
                       /* Добавление колонки Id. */
                       esq.addColumn("Id");
                       /* Добавление колонки Id из схемы Document. */
                       esq.addColumn("Document.Id", "DocumentId");
                       /* Создание и добавление фильтров в коллекцию запроса. */
                       esq.filters.add("filterOrder", this.Terrasoft.createColumnFilterWithParameter(
                           this.Terrasoft.ComparisonType.EQUAL, "UsrOrder", OrderId));
                       /* Получение всей коллекции записей и отображение ее в модальном окне справочника. */
                       esq.getEntityCollection(function(result) {
                           var existsDocumentsCollection = [];
                           if (result.success) {
                               result.collection.each(function(item) {
                                   existsDocumentsCollection.push(item.get("DocumentId"));
                               });
                           }
                           /* Добавление фильтра в конфигурационный объект. */
                           if (existsDocumentsCollection.length > 0) {
                               var existsFilter = this.Terrasoft.createColumnInFilterWithParameters("Id",
                                   existsDocumentsCollection);
                               existsFilter.comparisonType = this.Terrasoft.ComparisonType.NOT_EQUAL;
                               existsFilter.Name = "existsFilter";
                               config.filters = existsFilter;
                           }
                           /* Вызов модального окна справочника. */
                           this.openLookup(config, this.addCallBack, this);
                       }, this);
                   },
   
                   /* Обработчик события сохранения страницы записи. */
                   onCardSaved: function() {
                       this.openDocumentLookup();
                   },
   
                   /* Открывает справочник документов в случае если страница заказа была ранее сохранена. */
                   addRecord: function() {
                       var masterCardState = this.sandbox.publish("GetCardState", null, [this.sandbox.id]);
                       var isNewRecord = (masterCardState.state === configurationEnums.CardStateV2.ADD ||
                       masterCardState.state === configurationEnums.CardStateV2.COPY);
                       if (isNewRecord === true) {
                           var args = {
                               isSilent: true,
                               messageTags: [this.sandbox.id]
                           };
                           this.sandbox.publish("SaveRecord", args, [this.sandbox.id]);
                           return;
                       }
                       this.openDocumentLookup();
                   },
   
                   /* Добавление выбранных продуктов. */
                   addCallBack: function(args) {
                       /* Экземпляр класса пакетного запроса BatchQuery. */
                       var bq = this.Ext.create("Terrasoft.BatchQuery");
                       var OrderId = this.get("MasterRecordId");
                       /* Коллекция выбранных в справочнике документов. */
                       this.selectedRows = args.selectedRows.getItems();
                       /* Коллекция, передаваемая в запрос. */
                       this.selectedItems = [];
                       /* Копирование необходимых данных. */
                       this.selectedRows.forEach(function(item) {
                           item.OrderId = OrderId;
                           item.DocumentId = item.value;
                           bq.add(this.getDocumentInsertQuery(item));
                           this.selectedItems.push(item.value);
                       }, this);
                       /* Выполнение пакетного запроса, если он не пустой. */
                       if (bq.queries.length) {
                           this.showBodyMask.call(this);
                           bq.execute(this.onDocumentInsert, this);
                       }
                   },
   
                   /* Возвращает запрос на добавление текущего объекта. */
                   getDocumentInsertQuery: function(item) {
                       var insert = Ext.create("Terrasoft.InsertQuery", {
                           rootSchemaName: this.entitySchemaName
                       });
                       insert.setParameterValue("UsrOrder", item.OrderId, this.Terrasoft.DataValueType.GUID);
                       insert.setParameterValue("UsrDocument", item.DocumentId, this.Terrasoft.DataValueType.GUID);
                       return insert;
                   },
   
                   /* Метод, вызываемый при добавлении записей в реестр детали. */
                   onDocumentInsert: function(response) {
                       this.hideBodyMask.call(this);
                       this.beforeLoadGridData();
                       var filterCollection = [];
                       response.queryResults.forEach(function(item) {
                           filterCollection.push(item.id);
                       });
                       var esq = Ext.create("Terrasoft.EntitySchemaQuery", {
                           rootSchemaName: this.entitySchemaName
                       });
                       this.initQueryColumns(esq);
                       esq.filters.add("recordId", Terrasoft.createColumnInFilterWithParameters("Id", filterCollection));
                       /* Создание модели представления. */
                       esq.on("createviewmodel", this.createViewModel, this);
                       esq.getEntityCollection(function(response) {
                           this.afterLoadGridData();
                           if (response.success) {
                               var responseCollection = response.collection;
                               this.prepareResponseCollection(responseCollection);
                               this.getGridData().loadAll(responseCollection);
                           }
                       }, this);
                   },
   
                   /* Метод, вызываемый при удалении выбранных записей детали. */
                   deleteRecords: function() {
                       var selectedRows = this.getSelectedItems();
                       if (selectedRows.length > 0) {
                           this.set("SelectedRows", selectedRows);
                           this.callParent(arguments);
                       }
                   },
   
                   /* Скрыть пункт меню Копировать. */
                   getCopyRecordMenuItem: Terrasoft.emptyFn,
                   /* Скрыть пункт меню Изменить. */
                   getEditRecordMenuItem: Terrasoft.emptyFn,
                   /* Возвращает имя колонки по умолчанию для фильтра. */
                   getFilterDefaultColumnName: function() {
                       return "UsrDocument";
                   }
               },
               /* Массив модификаций. */
               diff: /**SCHEMA_DIFF*/[
                   {
                       /* Тип операции — слияние. */
                       "operation": "merge",
                       /* Название элемента схемы, над которым производится действие. */
                       "name": "DataGrid",
                       /* Объект, свойства которого будут объединены со свойствами элемента схемы. */
                       "values": {
                           "rowDataItemMarkerColumnName": "UsrDocument"
                       }
                   },
                   {
                       /* Тип операции — слияние. */
                       "operation": "merge",
                       /* Название элемента схемы, над которым производится действие. */
                       "name": "AddRecordButton",
                       /* Объект, свойства которого будут объединены со свойствами элемента схемы. */
                       "values": {
                           "visible": {"bindTo": "getToolsVisible"}
                       }
                   }
               ]/**SCHEMA_DIFF*/
           };
       }
   );
           

3. Выполните шаг 4 общего алгоритма реализации детали с использованием Creatio IDE. Без выполнения этого шага деталь отображается на странице записи, но не содержит записей, поскольку не указаны колонки для отображения.

Реализовать деталь с полями 

Деталь с полями позволяет вводить и редактировать данные непосредственно в полях детали. Может содержать несколько групп полей. Примером детали с полями является деталь Средства связи (Communication options) страницы контакта.

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

• Добавить записи на деталь без сохранения страницы, которая содержит текущую деталь.
• Работать с деталью, как со страницей записи.
• Использовать базовую валидацию полей.
• Реализовать пользовательскую валидацию полей.
• Добавить виртуальную запись.
• Расширить логику поведения записей.

Реализовать деталь с полями невозможно исключительно в мастере деталей, поскольку по умолчанию через мастер деталей создается деталь с реестром. Для реализации необходимо использовать комбинацию мастера деталей и Creatio IDE.

Реализация детали с полями для продуктов линейки Financial Services Creatio имеет свои особенности. Функциональность базовой детали с полями продуктов линейки Financial Services Creatio реализована в схеме BaseFieldsDetail пакета BaseFinance. Модель представления записи детали с полями реализована в схеме BaseFieldRowViewModel пакета BaseFinance.

Использовать комбинацию мастера деталей и Creatio IDE для реализации детали с полями 

1. Для реализации детали с полями в CRM продуктах Creatio cкачайте пакет sdkFieldsDetailPackage.
2. Для реализации детали с полями в CRM продуктах Creatio импортируйте пакет в пользовательское приложение. Для этого воспользуйтесь инструкцией, которая приведена в статье Перенести пакеты.
3. Для реализации детали с полями в CRM продуктах Creatio добавьте пакет sdkFieldsDetailPackage в зависимости пользовательского пакета. Для этого воспользуйтесь инструкцией, которая приведена в статье Создать пользовательский пакет.
4. Выполните шаг 1 общего алгоритма реализации детали с использованием мастера деталей. При необходимости, выполните настройку колонки детали, использовав Creatio IDE.
5. Используя Creatio IDE, замените родительский объект объекта детали на BaseFieldsDetail.
6. Выполните шаг 2 общего алгоритма реализации детали с использованием мастера деталей.

Использовать Creatio IDE для реализации детали с полями 

1. Для реализации детали с полями в CRM продуктах Creatio выполните шаги 1-3 алгоритма реализации детали с полями с помощью комбинации мастера деталей и Creatio IDE.

2. Создайте пользовательскую деталь.

   1. Создайте схему объекта детали.

      • В качестве родительского объекта выберите BaseEntity.
      • В схему объекта добавьте необходимые колонки.

   2. Создайте схему модели представления детали с полями.

      • В качестве родительского объекта выберите BaseFieldsDetail.
      • На панели инструментов в контекстном меню узла Локализуемые строки (Localizable strings) выберите локализуемую строку Caption и в свойстве Значение (Value) задайте название детали.
      • В свойство methods добавьте метод getDisplayColumns, который возвращает массив с названиями колонок, отображающихся как поля в детали.

   3. Добавьте пользовательские стили детали (опционально).

      1. Создайте схему модуля, в которой определите стили. Для этого воспользуйтесь инструкцией, которая приведена в статье Разработка конфигурационных элементов.

      2. Укажите наследуемый класс.

         • Для реализации детали с полями в CRM продуктах Creatio укажите UsrBaseFieldRowViewModel.
         • Для реализации детали с полями в продуктах линейки Financial Services Creatio укажите BaseFieldRowViewModel.
      3. В зависимости схемы модели представления реестра детали добавьте схему модуля с реализацией стилей.

      4. В свойство methods добавьте методы переопределения базовых CSS-классов стилей:

         • getRowViewModelClassName() — возвращает имя класса модели представления записи на детали.
         • getLeftRowContainerWrapClass() — возвращает массив строк с названиями CSS-классов, используемых для генерации представления контейнеров, содержащих подписи полей записей.

   4. Зарегистрируйте деталь в базе данных. Для этого выполните SQL-запрос к таблице [SysDetails] базы данных.

      SQL-запрос

      DECLARE 
      -- Название схемы детали.
      @ClientUnitSchemaName NVARCHAR(100) = 'UsrИмяСхемыДетали',
      -- Название схемы объекта детали.
      @EntitySchemaName NVARCHAR(100) = 'UsrИмяСхемыОбъектаДетали',
      -- Название детали.
      @DetailCaption NVARCHAR(100) = 'ИмяДетали'
      
      INSERT INTO SysDetail(
          Caption,
          DetailSchemaUId,
          EntitySchemaUId
      )
      VALUES(
          @DetailCaption,
          (SELECT TOP 1 UId
          from SysSchema
          WHERE Name = @ClientUnitSchemaName),
          (SELECT TOP 1 UId
          from SysSchema
          WHERE Name = @EntitySchemaName)
      )
      

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

3. Добавьте пользовательскую деталь на страницу записи.

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

   • В качестве родительского объекта выберите схему модели представления, которую необходимо заместить.
   • В свойство details добавьте деталь.
   • В массив модификаций diff добавьте конфигурационный объект модели представления детали.

   Пример схемы ContactPageV2 замещающей модели представления страницы записи, на которой размещена деталь с полями UsrRegDocumentFieldsDetail приведен ниже.

   Пример схемы замещающей модели представления

   define("ContactPageV2", [], function() {
       return {
           entitySchemaName: "Contact",
           details: /**SCHEMA_DETAILS*/ {
               /* Добавление детали с полями. */
               "UsrRegDocumentFieldsDetail": {
                   /* Название клиентской схемы детали. */
                   "schemaName": "UsrRegDocumentFieldsDetail",
                   /* Фильтрация записей детали текущего контакта (физ. лица). */
                   "filter": {
                       /* Колонка объекта детали. */
                       "detailColumn": "UsrContact",
                       /* Колонка идентификатора контакта. */
                       "masterColumn": "Id"
                   }
               }
           } /**SCHEMA_DETAILS*/ ,
           diff: /**SCHEMA_DIFF*/ [{
               /* Добавление нового элемента. */
               "operation": "insert",
               /* Название элемента. */
               "name": "UsrRegDocumentFieldsDetail",
               /* Конфигурационный объект значений. */
               "values": {
                   /* Тип элемента. */
                   "itemType": Terrasoft.ViewItemType.DETAIL
               },
               /* Имя элемента-контейнера. */
               "parentName": "HistoryTab",
               /* Имя свойства элемента-контейнера, который содержит коллекцию вложенных элементов. */
               "propertyName": "items",
               /* Индекс добавляемого в коллекцию элемента. */
               "index": 0
           }] /**SCHEMA_DIFF*/
       };
   });
   

Реализовать деталь типа Файлы и ссылки (Attachments) 

Деталь типа Файлы и ссылки (Attachments) позволяет хранить внешние файлы, ссылки на веб-ресурсы и статьи базы знаний. Доступна во всех разделах приложения. Функциональность базовой детали типа Файлы и ссылки (Attachments) реализована в схеме FileDetailV2 пакета UIv2. Деталь типа Файлы и ссылки (Attachments) описана в статье Файлы и примечания. Примером детали типа Файлы и ссылки (Attachments) является деталь Файлы и ссылки (Attachments) страницы контакта.

Реализовать деталь типа Файлы и ссылки (Attachments) невозможно исключительно в мастере деталей, поскольку по умолчанию через мастер деталей создается деталь с реестром. Для реализации необходимо использовать комбинацию мастера деталей и Creatio IDE.

Чтобы реализовать деталь типа Файлы и ссылки (Attachments) с использованием комбинации мастера деталей и Creatio IDE:

1. Создайте пользовательскую деталь.

   1. Настройте объект детали типа Файлы и ссылки (Attachments).

      • Для этого в свойстве По какому объекту создать деталь? (How to create detail?) выберите "Существующему объекту" ("Based on existing object").
      • Для этого в свойстве Объект (Object) выберите "Файл и ссылка объекта [ИмяПользовательскогоРаздела]" ("[CustomSectionName] attachment").
   2. Используя Creatio IDE, замените родительский объект страницы записи детали на FileDetailV2.

   3. Добавьте пользовательские стили детали (опционально).

      1. Создайте схему модуля, в которой определите стили. Для этого воспользуйтесь инструкцией, которая приведена в статье Разработка конфигурационных элементов.
      2. В зависимости схемы модели представления детали добавьте схему модуля с реализацией стилей.
2. Выполните шаг 2 общего алгоритма реализации детали с использованием мастера деталей.

Реализовать множественное добавление записей на деталь 

По умолчанию деталь позволяет добавлять только одну запись. Назначение миксина LookupMultiAddMixin — расширение действия по добавлению записи на деталь. Использование миксина позволяет пользователю выбирать несколько записей из справочника за один раз.

Чтобы реализовать множественное добавление записей на деталь:

1. Создайте схему замещающей модели представления детали. Для этого воспользуйтесь инструкцией, которая приведена в статье Разработка конфигурационных элементов.
2. В свойство mixins добавьте миксин LookupMultiAddMixin.

3. В свойстве methods:

   • Переопределите методы.

     • init() — реализует логику, выполняемую при загрузке модуля. В методе выполните инициализацию миксина LookupMultiAddMixin. Метод init() описан в статье Виды модулей.
     • getAddRecordButtonVisible() — отвечает за отображение кнопки добавления.
     • onCardSaved() — отвечает за сохранение страницы детали. В переопределенном методе используйте метод openLookupWithMultiSelect(), который вызывает справочное окно для множественного выбора.
     • addRecord() — отвечает за добавление записи на деталь. Как и для метода onCardSaved(), в переопределенном методе используйте метод openLookupWithMultiSelect(). Значение true указывает на необходимость выполнения проверки является ли запись новой.
   • Реализуйте метод getMultiSelectLookupConfig(), который связан с методом openLookupWithMultiSelect(). Метод getMultiSelectLookupConfig() выполняет конфигурирование справочного окна и возвращает объект конфигурации для справочного окна.

Удалить деталь 

Чтобы удалить деталь:

1. В SVN-хранилище снимите блокировку с файлов детали, которую необходимо удалить.

2. Удалите записи из базы данных. Для этого выполните SQL-запрос в базу данных.

   SQL-запрос

   DECLARE @Caption nvarchar(max);
   SET @Caption = 'UsrИмяСхемыДетали';
   DECLARE @UId UNIQUEIDENTIFIER;
   select @UId = EntitySchemaUId from SysDetail
   where Caption = @Caption
   delete from SysDetail where EntitySchemaUId = @UId
   

3. Перейдите в раздел Конфигурация (Configuration) и удалите схему модели представления детали и схему объекта детали.