Страница записи

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

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

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

   

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

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

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

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

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

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

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

   Для этого в свойстве methods реализуйте методы:

   • isRunning() — проверяет находится ли заказ на стадии Исполнение (In progress) и определяет доступность добавленного пункта.
   • showOrderInfo() — метод-обработчик действия. В информационном окне отображает планируемую дату завершения заказа. Действие страницы записи применяется к конкретному объекту, который открыт на странице. Для доступа к значениям полей объекта страницы записи в методе-обработчике действия необходимо использовать методы модели представления get() (получить значение) и set() (установить значение).
   • getActions() — переопределенный базовый метод. Возвращает коллекцию действий замещающей страницы.

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

   OrderPageV2

   define("OrderPageV2", ["OrderConfigurationConstants"], function(OrderConfigurationConstants) {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "Order",
           /* Методы модели представления страницы записи. */
           methods: {
               /* Проверяет стадию заказа для определения доступности пункта меню. */
               isRunning: function() {
                   /* Метод возвращает true, если статус заказа [Исполнение], иначе возвращает false. */
                   if (this.get("Status")) {
                       return this.get("Status").value === OrderConfigurationConstants.Order.OrderStatus.Running;
                   }
                   return false;
               },
               /* Метод-обработчик действия. В информационном окне отображает дату выполнения заказа. */
               showOrderInfo: function() {
                   /* Получает дату выполнения заказа. */
                   var dueDate = this.get("DueDate");
                   /* Отображает информационное окно. */
                   this.showInformationDialog(dueDate);
               },
               /* Переопределяет базовый виртуальный метод, который возвращает коллекцию действий страницы записи. */
               getActions: function() {
                   /* Вызывается родительская реализация метода для получения коллекции проинициализированных действий базовой страницы. */
                   var actionMenuItems = this.callParent(arguments);
                   /* Добавляет линию-разделитель. */
                   actionMenuItems.addItem(this.getButtonMenuItem({
                       Type: "Terrasoft.MenuSeparator",
                       Caption: ""
                   }));
                   /* Добавляет пункт меню в список действий страницы записи. */
                   actionMenuItems.addItem(this.getButtonMenuItem({
                       /* Привязывает заголовок пункта меню к локализуемой строке схемы. */
                       "Caption": {bindTo: "Resources.Strings.InfoActionCaption"},
                       /* Привязывает метод-обработчик действия. */
                       "Tag": "showOrderInfo",
                       /* Привязывает свойство доступности пункта меню к значению, которое возвращает метод isRunning(). */
                       "Enabled": {bindTo: "isRunning"}
                   }));
                   return actionMenuItems;
               }
           }
       };
   });
   

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

В результате на страницу заказа, который находится на стадии Исполнение (In progress), добавлено действие Показать дату выполнения (Show execution date).

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

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

• Локализуемую строку, которая содержит текст пункта меню.
• Метод, который определяет доступность пункта меню.

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

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

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

   

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

   • Код (Code) — "OrderSectionV2".
   • Заголовок (Title) — "Раздел заказа" ("Order section").
   • Родительский объект (Parent object) — выберите "OrderSectionV2".
   
4. Добавьте локализуемую строку с текстом пункта меню, который планируется добавить. Для этого выполните шаг 4 алгоритма создания схемы замещающей модели представления страницы заказа.

5. Реализуйте логику работы пункта меню. Для этого в свойстве methods реализуйте метод isRunning(), который проверяет находится ли заказ на стадии Исполнение (In progress) и определяет доступность добавленного пункта.

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

   OrderSectionV2

   define("OrderSectionV2", ["OrderConfigurationConstants"], function(OrderConfigurationConstants) {
       return {
           /* Название схемы страницы раздела. */
           entitySchemaName: "Order",
           /* Методы модели представления страницы раздела. */
           methods: {
               /* Проверяет стадию заказа для определения доступности пункта меню. */
               isRunning: function(activeRowId) {
                   activeRowId = this.get("ActiveRow");
                   /* Получает коллекцию данных списочного представления реестра раздела. */
                   var gridData = this.get("GridData");
                   /* Получает модель выбранного заказа по заданному значению первичной колонки. */
                   var selectedOrder = gridData.get(activeRowId);
                   /* Получает свойства модели — статуса выбранного заказа. */
                   var selectedOrderStatus = selectedOrder.get("Status");
                   /* Метод возвращает true, если статус заказа [Исполнение], иначе возвращает false. */
                   return selectedOrderStatus.value === OrderConfigurationConstants.Order.OrderStatus.Running;
               }
           }
       };
   });
   

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

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

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

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

В результате выполнения примера на страницу заказа добавлено действие Показать дату выполнения (Show execution date).

Если заказ находится на стадии Исполнение (In progress), то действие Показать дату выполнения (Show execution date) активно.

В результате выбора действия Показать дату выполнения (Show execution date), в информационном окне отображается планируемая дата выполнения заказа.

Если заказ не находится на стадии Исполнение (In progress), то действие Показать дату выполнения (Show execution date) неактивно.