Кнопка

Создать схему замещающей модели представления раздела 

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

2. На панели инструментов реестра раздела нажмите Добавить —> Замещающая модель представления (Add —> Replacing view model).

   

3. Заполните свойства схемы.

   • Код (Code) — "AccountSectionV2".
   • Заголовок (Title) — "Раздел контрагенты" ("Account section").
   • Родительский объект (Parent object) — выберите "AccountSectionV2".
   

4. Добавьте локализуемую строку.

   1. В контекстном меню узла Локализуемые строки (Localizable strings) нажмите кнопку .

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

      • Код (Code) — "OpenPrimaryContactButtonCaption".
      • Значение (Value) — "Основной контакт" ("Primary contact").
      
   3. Для добавления локализуемой строки нажмите Добавить (Add).

5. Реализуйте логику работы кнопки.

   1. В свойстве methods реализуйте методы:

      • isAccountPrimaryContactSet() — проверяет заполнение поля Основной контакт (Primary contact) страницы.
      • onOpenPrimaryContactClick() — метод-обработчик нажатия кнопки. Выполняет переход на страницу основного контакта.
   2. В массив модификаций diff добавьте конфигурационный объект с настройками расположения кнопки на странице.

   Обращение к выделенной записи выполняется через атрибут ActiveRow модели представления раздела. Атрибут возвращает значение первичной колонки выделенной записи. В свою очередь, значение первичной колонки выделенной записи может использоваться для получения значений, загруженных в реестр полей выбранного объекта, например, из коллекции данных списочного представления реестра раздела, которая хранится в свойстве GridData модели представления реестра.

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

   AccountSectionV2

   define("AccountSectionV2", [], function() {
       return {
           /* Название схемы объекта раздела. */
           entitySchemaName: "Account",
           /* Методы модели представления раздела. */
           methods: {
               /* Метод-обработчик нажатия кнопки. */
               onOpenPrimaryContactClick: function() {
                   /* Получение идентификатора выбранной записи. */
                   var activeRow = this.get("ActiveRow");
                   if (!activeRow) {
                       return;
                   }
                   /* Определение идентификатора основного контакта. */
                   var primaryId = this.get("GridData").get(activeRow).get("PrimaryContact").value;
                   if (!primaryId) {
                       return;
                   }
                   /* Формирование строки адреса. */
                   var requestUrl = "CardModuleV2/ContactPageV2/edit/" + primaryId;
                   /* Публикация сообщения о пополнении истории навигации по страницам и переход на страницу основного контакта. */
                   this.sandbox.publish("PushHistoryState", {
                       hash: requestUrl
                   });
               },
               /* Проверяет заполнение поля [Основной контакт] выбранного элемента. */
               isAccountPrimaryContactSet: function() {
                   var activeRow = this.get("ActiveRow");
                   if (!activeRow) {
                       return false;
                   }
                   var pc = this.get("GridData").get(activeRow).get("PrimaryContact");
                   return (pc || pc !== "") ? true : false;
               }
           },
           /* Отображение кнопки в разделе. */
           diff: /**SCHEMA_DIFF*/[
               /* Метаданные для добавления в раздел пользовательской кнопки. */
               {
                   /* Выполняется операция добавления элемента на страницу. */
                   "operation": "insert",
                   /* Мета-имя родительского контейнера, в который добавляется кнопка. */
                   "parentName": "ActionButtonsContainer",
                   /* Кнопка добавляется в коллекцию элементов родительского элемента. */
                   "propertyName": "items",
                   /* Мета-имя добавляемой кнопки. */
                   "name": "MainContactSectionButton",
                   /* Свойства, передаваемые в конструктор элемента. */
                   "values": {
                       /* Тип добавляемого элемента — кнопка. */
                       "itemType": Terrasoft.ViewItemType.BUTTON,
                       /* Привязка заголовка кнопки к локализуемой строке схемы. */
                       "caption": { bindTo: "Resources.Strings.OpenPrimaryContactButtonCaption" },
                       /* Привязка метода-обработчика нажатия кнопки. */
                       "click": { bindTo: "onOpenPrimaryContactClick" },
                       /* Привязка свойства доступности кнопки. */
                       "enabled": { bindTo: "isAccountPrimaryContactSet" },
                       /* Настройка расположения кнопки. */
                       "layout": {
                           /* Номер столбца. */
                           "column": 1,
                           /* Номер строки. */
                           "row": 6,
                           /* Диапазон занимаемых столбцов. */
                           "colSpan": 1
                       }
                   }
               }
           ]/**SCHEMA_DIFF*/
       };
   });
   

6. На панели инструментов дизайнера нажмите Сохранить (Save).

Результат выполнения примера 

Чтобы посмотреть результат выполнения примера:

1. Очистите кэш браузера.
2. Обновите страницу раздела Контрагенты (Accounts).

В результате выполнения примера на панель инструментов раздела Контрагенты (Accounts) добавлена кнопка Основной контакт (Primary contact). Кнопка активна при выборе в реестре раздела контрагента, для которого указан основной контакт.

При нажатии на кнопку Основной контакт (Primary contact) открывается страница основного контакта активного контрагента.

Создать схему замещающей модели представления раздела 

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

2. На панели инструментов реестра раздела нажмите Добавить —> Замещающая модель представления (Add —> Replacing view model).

   

3. Заполните свойства схемы.

   • Код (Code) — "AccountSectionV2".
   • Заголовок (Title) — "Раздел контрагенты" ("Account section").
   • Родительский объект (Parent object) — выберите "AccountSectionV2".
   

4. Добавьте локализуемую строку.

   1. В контекстном меню узла Локализуемые строки (Localizable strings) нажмите кнопку .

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

      • Код (Code) — "OpenPrimaryContactButtonCaption".
      • Значение (Value) — "Основной контакт" ("Primary contact").
      
   3. Для добавления локализуемой строки нажмите Добавить (Add).

5. Реализуйте логику работы кнопки.

   1. В свойство attributes добавьте атрибут ButtonEnabled типа Terrasoft.DataValueType.BOOLEAN, который сохраняет состояние доступности кнопки.

   2. В свойстве methods реализуйте методы:

      • onOpenPrimaryContactClick() — выполняет переход на страницу основного контакта.
      • onCardRendered() — подписка на события загрузки данных в реестр и событие изменения активной записи реестра. Выполняется после отрисовки страницы контрагента в совмещенном режиме.
      • isPrimaryContactExist() — определяет наличие основного контакта для активной записи реестра.
      • setButtonEnabled() — устанавливает значение атрибута ButtonEnabled в зависимости от наличия основного контакта контрагента.
   3. В массив модификаций diff добавьте конфигурационный объект с настройками расположения кнопки на странице.

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

   AccountSectionV2

   define("AccountSectionV2", [], function() {
       return {
           /* Название схемы объекта раздела. */
           entitySchemaName: "Account",
           attributes: {
               /* Атрибут для хранения состояния доступности кнопки. */
               "ButtonEnabled": {
                   "dataValueType": Terrasoft.DataValueType.BOOLEAN,
                   "type": Terrasoft.ViewModelColumnType.VIRTUAL_COLUMN,
                   "value": false
               }
           },
           /* Методы модели представления раздела. */
           methods: {
               /* Метод-обработчик нажатия кнопки. */
               onOpenPrimaryContactClick: function() {
                   /* Определение активной записи вертикального реестра. */
                   var activeRow = this.get("ActiveRow");
                   if (activeRow) {
                       /* Определение идентификатора основного контакта. */
                       var primaryId = this.get("GridData").get(activeRow).get("PrimaryContact").value;
                       if (primaryId) {
                           /* Формирование строки адреса. */
                           var requestUrl = "CardModuleV2/ContactPageV2/edit/" + primaryId;
                           /* Публикация сообщения о пополнении истории навигации по страницам и переход на страницу основного контакта. */
                           this.sandbox.publish("PushHistoryState", {
                               hash: requestUrl
                           });
                       }
                   }
               },
               /* Выполняется после отрисовки страницы контрагента. */
               onCardRendered: function() {
                   this.callParent();
                   /* Данные реестра. */
                   var gridData = this.get("GridData");
                   var activeRow = this.get("ActiveRow");
                   if (activeRow)
                   {
                       this.setButtonEnabled(activeRow, this);
                   }
                   /* После закрытия страницы основного контакта теряется активная запись. Ее нужно восстановить и для нее проверить наличие основного контакта. */
                   else {
                       var historyState = this.sandbox.publish("GetHistoryState");
                       var hash = historyState.hash;
                       if (hash && hash.valuePairs)
                       {
                           activeRow = hash.valuePairs[0].name;
                           /* Восстановление активной записи. */
                           this.set("ActiveRow", activeRow);
                           /* Сохранение контекста в локальную переменную. */
                           var self = this;
                           /* Подписка на событие полной загрузки данных в вертикальный реестр. */
                           gridData.on("dataloaded", function() {
                               self.setButtonEnabled(activeRow, self);
                           });
                       }
                   }
                   /* Подписка на событие изменения активной записи реестра. */
                   gridData.on("itemchanged", function() {
                       this.setButtonEnabled(activeRow, this);
                   }, this);
               },
               /* Определяет наличие основного контакта для активной записи реестра. */
               isPrimaryContactExist: function(id) {
                   var pc = this.get("GridData").get(id).get("PrimaryContact");
                   return (pc || pc !== "") ? true : false;
               },
               /* Устанавливает значение атрибута ButtonEnabled в зависимости от того, определен ли основной контакт. */
               setButtonEnabled: function(activeRow, context) {
                   if (context.isPrimaryContactExist(activeRow)) {
                       context.set("ButtonEnabled", true);
                   }
                   else {
                       context.set("ButtonEnabled", false);
                   }
               }
           },
           /* Отображение кнопки на странице записи. */
           diff: [
               /* Метаданные для добавления на страницу пользовательской кнопки. */
               {
                   /* Выполняется операция добавления элемента на страницу. */
                   "operation": "insert",
                   /* Мета-имя родительского контейнера, в который добавляется кнопка. */
                   "parentName": "CombinedModeActionButtonsCardLeftContainer",
                   /* Кнопка добавляется в коллекцию элементов родительского элемента. */
                   "propertyName": "items",
                   /* Мета-имя добавляемой кнопки. */
                   "name": "MainContactButton",
                   /* Свойства, передаваемые в конструктор элемента. */
                   "values": {
                       /* Тип добавляемого элемента — кнопка. */
                       "itemType": Terrasoft.ViewItemType.BUTTON,
                       /* Привязка заголовка кнопки к локализуемой строке схемы. */
                       "caption": {bindTo: "Resources.Strings.OpenPrimaryContactButtonCaption"},
                       /* Привязка метода-обработчика нажатия кнопки. */
                       "click": {bindTo: "onOpenPrimaryContactClick"},
                       /* Стиль отображения кнопки. */
                       "style": Terrasoft.controls.ButtonEnums.style.GREEN,
                       /* Привязка свойства доступности кнопки. */
                       "enabled": {bindTo: "ButtonEnabled"}
                   }
               }
           ]
       };
   });
   

6. На панели инструментов дизайнера нажмите Сохранить (Save).

Результат выполнения примера 

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

В результате выполнения примера на панель инструментов раздела Контрагенты (Accounts) добавлена кнопка Основной контакт (Primary contact).

Если для контрагента указан основной контакт, то при нажатии на кнопку Основной контакт (Primary contact) открывается страница этого контакта.

Если для контрагента не указан основной контакт, то кнопка Основной контакт (Primary contact) неактивна.

1. Изменить способ добавления контрагента 

По умолчанию для добавления контрагента используется мини-карточка.

Чтобы для добавления контрагента использовать страницу добавления:

1. Перейдите в дизайнер системы по кнопке .
2. В блоке Настройка системы (System setup) перейдите по ссылке Системные настройки (System settings).
3. Выберите настройку Использовать миникарточку добавления контрагента (Enable account mini page add mode, код HasAccountMiniPageAddMode).

4. Снимите признак Значение по умолчанию (Default value).

   
5. Выполните повторный вход в приложение.

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

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

2. На панели инструментов реестра раздела нажмите Добавить —> Замещающая модель представления (Add —> Replacing view model).

   

3. Заполните свойства схемы.

   • Код (Code) — "AccountPageV2".
   • Заголовок (Title) — "Страница редактирования контрагента" ("Account edit page").
   • Родительский объект (Parent object) — выберите "AccountPageV2".
   

4. Добавьте локализуемую строку.

   1. В контекстном меню узла Локализуемые строки (Localizable strings) нажмите кнопку .

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

      • Код (Code) — "OpenPrimaryContactButtonCaption".
      • Значение (Value) — "Основной контакт" ("Primary contact").
      
   3. Для добавления локализуемой строки нажмите Добавить (Add).

5. Реализуйте логику работы кнопки.

   1. В свойстве methods реализуйте методы:

      • isAccountPrimaryContactSet() — проверяет заполнение поля Основной контакт (Primary contact) страницы.
      • onOpenPrimaryContactClick() — метод-обработчик нажатия кнопки. Выполняет переход на страницу основного контакта.
   2. В массив модификаций diff добавьте конфигурационный объект с настройками расположения кнопки на странице.

   Исходный код схемы замещающей модели представления страницы контрагента представлен ниже.

   AccountPageV2

   define("AccountPageV2", [], function() {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "Account",
           /* Методы модели представления страницы записи. */
           methods: {
               /* Проверяет заполнение поле [Основной контакт] страницы записи. */
               isAccountPrimaryContactSet: function() {
                   return this.get("PrimaryContact") ? true : false;
               },
               /* Метод-обработчик нажатия кнопки. */
               onOpenPrimaryContactClick: function() {
                   var primaryContactObject = this.get("PrimaryContact");
                   if (primaryContactObject) {
                       /* Определение идентификатора основного контакта. */
                       var primaryContactId = primaryContactObject.value;
                       /* Формирование строки адреса. */
                       var requestUrl = "CardModuleV2/ContactPageV2/edit/" + primaryContactId;
                       // Публикация сообщения о пополнении истории навигации по страницам и переход на страницу основного контакта. */
                       this.sandbox.publish("PushHistoryState", {
                           hash: requestUrl
                       });
                   }
               }
           },
           /* Отображение кнопки на странице записи. */
           diff: [
               /* Метаданные для добавления на страницу пользовательской кнопки. */
               {
                   /* Выполняется операция добавления элемента на страницу. */
                   "operation": "insert",
                   /* Мета-имя родительского контейнера, в который добавляется кнопка. */
                   "parentName": "LeftContainer",
                   /* Кнопка добавляется в коллекцию элементов родительского элемента. */
                   "propertyName": "items",
                   /* Мета-имя добавляемой кнопки. */
                   "name": "PrimaryContactButton",
                   /* Свойства, передаваемые в конструктор элемента. */
                   "values": {
                       /* Тип добавляемого элемента — кнопка. */
                       "itemType": Terrasoft.ViewItemType.BUTTON,
                       /* Привязка заголовка кнопки к локализуемой строке схемы. */
                       "caption": {bindTo: "Resources.Strings.OpenPrimaryContactButtonCaption"},
                       /* Привязка метода-обработчика нажатия кнопки. */
                       "click": {bindTo: "onOpenPrimaryContactClick"},
                       /* Привязка свойства доступности кнопки. */
                       "enabled": {bindTo: "isAccountPrimaryContactSet"},
                       /* Стиль отображения кнопки. */
                       "style": Terrasoft.controls.ButtonEnums.style.BLUE
                   }
               }
           ]
       };
   });
   

6. На панели инструментов дизайнера нажмите Сохранить (Save).

Результат выполнения примера 

Чтобы посмотреть результат выполнения примера:

1. Обновите страницу раздела Контрагенты (Accounts).
2. На панели инструментов раздела Контрагенты (Accounts) нажмите кнопку Добавить контрагента (New account).

В результате выполнения примера на панель инструментов страницы добавления контрагента добавлена неактивна кнопка Основной контакт (Primary contact).

Кнопка Основной контакт (Primary contact) активируется после указания основного контакта контрагента. При нажатии на кнопку Основной контакт (Primary contact) открывается страница этого контакта.

1. Создать схему замещающего объекта 

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

2. На панели инструментов реестра раздела нажмите Добавить —> Замещающий объект (Add —> Replacing object).

   

3. Заполните свойства схемы.

   • Код (Code) — "Product".
   • Заголовок (Title) — "Продукт" ("Product").
   • Родительский объект (Parent object) — выберите "Product".
   

4. В схему добавьте колонку.

   1. В контекстном меню узла Колонки (Columns) структуры объекта нажмите .

   2. В выпадающем меню нажмите Строка —> Строка (50 символов) (Text —> Text (50 characters)).

      

   3. Заполните свойства добавляемой колонки.

      • Код (Code) — "UsrColor".
      • Заголовок (Title) — "Цвет" ("Color").
      
5. На панели инструментов дизайнера объектов нажмите Сохранить (Save), а затем Опубликовать (Publish).

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

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

2. На панели инструментов реестра раздела нажмите Добавить —> Замещающая модель представления (Add —> Replacing view model).

   

3. Заполните свойства схемы.

   • Код (Code) — "ProductPageV2".
   • Заголовок (Title) — "Страница редактирования продукта" ("Edit page - Product").
   • Родительский объект (Parent object) — выберите "ProductPageV2".
   

4. Настройте расположение кнопки. Для этого в массив модификаций diff добавьте конфигурационный объект с настройками расположения кнопки на странице.

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

   ProductPageV2

   define("ProductPageV2", [], function() {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "Product",
           /* Отображение кнопки на странице записи. */
           diff: /**SCHEMA_DIFF*/[
               /* Кнопка выбора цвета. */
               {
                   /* Выполняется операция добавления элемента на страницу. */
                   "operation": "insert",
                   /* Мета-имя родительского контейнера, в который добавляется кнопка. */
                   "parentName": "ProductGeneralInfoBlock",
                   /* Кнопка добавляется в коллекцию элементов родительского элемента. */
                   "propertyName": "items",
                   /* Мета-имя добавляемой кнопки. */
                   "name": "ColorButton",
                   /* Свойства, передаваемые в конструктор элемента. */
                   "values": {
                       /* Тип добавляемого элемента — кнопка выбора цвета. */
                       "itemType": this.Terrasoft.ViewItemType.COLOR_BUTTON,
                       /* Привязка значения элемента управления к колонке модели представления. */
                       "value": { "bindTo": "UsrColor" },
                       /* Настройка расположения кнопки. */
                       "layout": { 
                           /* Номер столбца. */
                           "column": 5,
                           /* Номер строки. */
                           "row": 6, 
                           /* Диапазон занимаемых столбцов. */
                           "colSpan": 12
                       }
                   }
               }
           ]/**SCHEMA_DIFF*/
       };
   });
   

5. На панели инструментов дизайнера нажмите Сохранить (Save).

Результат выполнения примера 

Чтобы посмотреть результат выполнения примера:

1. Обновите страницу раздела Продукты (Products).
2. Откройте страницу продукта.

В результате выполнения примера на страницу продукта добавлена кнопка выбора цвета.

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

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

2. На панели инструментов реестра раздела нажмите Добавить —> Замещающая модель представления (Add —> Replacing view model).

   

3. Заполните свойства схемы.

   • Код (Code) — "ContactPageV2".
   • Заголовок (Title) — "Схема отображения карточки контакта" ("Display schema — Contact card").
   • Родительский объект (Parent object) — выберите "ContactPageV2".
   

4. Добавьте локализуемую строку, которая содержит текст подсказки.

   1. В контекстном меню узла Локализуемые строки (Localizable strings) нажмите кнопку .

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

      • Код (Code) — "SaveButtonHint".
      • Значение (Value) — "Нажмите, чтобы сохранить изменения" ("Press to save changes").
      
   3. Для добавления локализуемой строки нажмите Добавить (Add).

5. Настройте всплывающую подсказку к кнопке Сохранить (Save) страницы контакта. Для этого в массив модификаций diff добавьте конфигурационный объект кнопки на странице.

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

   define("ContactPageV2", [], function () {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "Contact",
           /* Отображение всплывающей подсказки. */
           diff: /**SCHEMA_DIFF*/[
               /* Метаданные для добавления к кнопке всплывающей подсказки. */
               {
                   /* Выполняется операция изменения существующего элемента. */
                   "operation": "merge",
                   /* Мета-имя родительского контейнера, в котором изменяется кнопка. */
                   "parentName": "LeftContainer",
                   /* Кнопка изменяется в коллекции элементов родительского элемента. */
                   "propertyName": "items",
                   /* Мета-имя изменяемой кнопки. */
                   "name": "SaveButton",
                   /* Свойства, передаваемые в конструктор элемента. */
                   "values": {
                       /* Всплывающая подсказка для кнопки. */
                       "hint": { "bindTo": "Resources.Strings.SaveButtonHint" } 
                   }
               }
           ]/**SCHEMA_DIFF*/
       };
   });
   

   define("ContactPageV2", [], function () {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "Contact",
           /* Отображение всплывающей подсказки. */
           diff: /**SCHEMA_DIFF*/[
               /* Метаданные для добавления к кнопке всплывающей подсказки. */
               {
                   /* Выполняется операция изменения существующего элемента. */
                   "operation": "merge",
                   /* Мета-имя родительского контейнера, в котором изменяется кнопка. */
                   "parentName": "LeftContainer",
                   /* Кнопка изменяется в коллекции элементов родительского элемента. */
                   "propertyName": "items",
                   /* Мета-имя изменяемой кнопки. */
                   "name": "SaveButton",
                   /* Свойства, передаваемые в конструктор элемента. */
                   "values": {
                       /* Массив подсказок для кнопки. */
                       "tips": [] 
                   }
               },
               /* Конфигурационный объект простой подсказки. */
               {
                   /* Выполняется операция добавления элемента. */
                   "operation": "insert",
                   /* Мета-имя добавляемой кнопки. */
                   "parentName": "SaveButton",
                   /* Подсказка добавляется в коллекцию элементов родительского элемента. */
                   "propertyName": "tips",
                   /* Мета-имя добавляемой подсказки. */
                   "name": "CustomShowedTip",
                   /* Свойства, передаваемые в конструктор элемента. */
                   "values": {
                       /* Текст подсказки. */
                       "content": {"bindTo": "Resources.Strings.SaveButtonHint"}
                       /* Здесь можно дополнительно настроить другие параметры отображения и работы всплывающей подсказки. */
                   }
               },
           ]/**SCHEMA_DIFF*/
       };
   });
   

6. На панели инструментов дизайнера нажмите Сохранить (Save).

Результат выполнения примера 

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

Создать схему замещающей модели представления раздела 

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

2. На панели инструментов реестра раздела нажмите Добавить —> Замещающая модель представления (Add —> Replacing view model).

   

3. Заполните свойства схемы.

   • Код (Code) — "ContactSectionV2".
   • Заголовок (Title) — "Раздел контакты" ("Contact section").
   • Родительский объект (Parent object) — выберите "ContactSectionV2".
   

4. Добавьте локализуемую строку.

   1. В контекстном меню узла Локализуемые строки (Localizable strings) нажмите кнопку .

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

      • Код (Code) — "ShowAgeOfContactButtonCaption".
      • Значение (Value) — "Показать возраст" ("Show age").
      
   3. Для добавления локализуемой строки нажмите Добавить (Add).

5. Реализуйте логику работы кнопки.

   1. В свойстве methods реализуйте методы:

      • onActiveRowAction() — присваивает метод-обработчик кнопке, расположенной в строке активной записи раздела.
      • onShowAgeButtonClicked() — метод-обработчик нажатия кнопки. Возвращает возраст контакта во всплывающем окне.
   2. В массив модификаций diff добавьте конфигурационный объект с настройками расположения кнопки на странице.

   Обращение к выделенной записи выполняется через атрибут ActiveRow модели представления раздела. Атрибут возвращает значение первичной колонки выделенной записи. В свою очередь, значение первичной колонки выделенной записи может использоваться для получения значений, загруженных в реестр полей выбранного объекта.

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

   ContactSectionV2

   define("ContactSectionV2", ["ContactSectionV2Resources"], function (resources) {
       return {
           /* Название схемы объекта раздела. */
           entitySchemaName: "Contact",
           /* Методы модели представления раздела. */
           methods: {
               onActiveRowAction: function (buttonTag) {
                   switch (buttonTag) {
                       case "showAgeButton":
                           this.onShowAgeButtonClicked();
                           break;
                       default:
                           this.callParent(arguments);
                           break;
                   }
               },
               /* Метод-обработчик нажатия кнопки. */
               onShowAgeButtonClicked: function () {
                   var message = "";
                   var activeRow = this.getActiveRow();
                   var recordId = activeRow.get("Id");
                   /* Создаем экземпляр класса Terrasoft.EntitySchemaQuery с корневой схемой Contact. */
                   var esq = this.Ext.create("Terrasoft.EntitySchemaQuery", {
                       rootSchemaName: "Contact"
                   });
                   /* Добавление колонки с возрастом. */
                   esq.addColumn("Age", "Age");
                   /* Получение записи из выборки по Id объекта. */
                   esq.getEntity(recordId, function(result) {
                       if (!result.success) {
                           this.showInformationDialog("Error");
                           return;
                       }
                       message += "Age of contact is "+ result.entity.get("Age");
                       this.showInformationDialog(message);
                   }, this);
               }
           },
           /* Отображение кнопки в разделе. */
           diff: /**SCHEMA_DIFF*/[
               /* Метаданные для добавления в раздел пользовательской кнопки. */
               {
                   /* Выполняется операция добавления элемента на страницу. */
                   "operation": "insert",
                   /* Мета-имя добавляемой кнопки. */
                   "name": "DataGridActiveRowShowAgeButton",
                   /* Мета-имя родительского контейнера, в который добавляется кнопка. */
                   "parentName": "DataGrid",
                   /* Кнопка добавляется в коллекцию элементов родительского элемента. */
                   "propertyName": "activeRowActions",
                   /* Свойства, передаваемые в конструктор элемента. */
                   "values": {
                       "className": "Terrasoft.Button",
                       "style": Terrasoft.controls.ButtonEnums.style.GREEN,
                       /* Привязка заголовка кнопки к локализуемой строке схемы. */
                       "caption": resources.localizableStrings.ShowAgeOfContactButtonCaption,
                       "tag": "showAgeButton"
                   }
               }
           ]/**SCHEMA_DIFF*/
       };
   });
   

6. На панели инструментов дизайнера нажмите Сохранить (Save).

Результат выполнения примера 

Чтобы посмотреть результат выполнения примера:

1. Очистите кэш браузера.
2. Обновите страницу раздела Контакты (Contacts).

В результате выполнения примера в строку активной записи раздела Контакты (Contacts) добавлена кнопка Показать возраст (Show Age). При нажатии на кнопку Показать возраст (Show Age) отображается всплывающее окно с информацией о возрасте контакта.