Поле

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

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

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

   

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

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

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

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

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

      

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

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

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

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

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

   

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

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

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

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

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

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

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

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

   ActivityPageV2

   define("ActivityPageV2", [], function() {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "Activity",
           /* Отображение поля на странице записи. */
           diff: /**SCHEMA_DIFF*/[
               /* Метаданные для добавления на страницу пользовательского поля. */
               {
                   /* Выполняется операция добавления элемента на страницу. */
                   "operation": "insert",
                   /* Мета-имя родительского контейнера, в который добавляется поле. */
                   "parentName": "Header",
                   /* Поле добавляется в коллекцию элементов родительского элемента. */
                   "propertyName": "items",
                   /* Мета-имя добавляемого поля. */
                   "name": "UsrMeetingPlace",
                   /* Свойства, передаваемые в конструктор элемента. */
                   "values": {
                       /* Привязка заголовка поля к локализуемой строке схемы. */
                       "caption": {"bindTo": "Resources.Strings.MeetingPlaceCaption"},
                       /* Настройка расположения поля. */
                       "layout": {
                           /* Номер столбца. */
                           "column": 0,
                           /* Номер строки. */
                           "row": 5,
                           /* Диапазон занимаемых столбцов. */
                           "colSpan": 12
                       }
                   }
               }
           ]/**SCHEMA_DIFF*/
       };
   });
   

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

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

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

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

В результате выполнения примера на страницу активности добавлено поле Место встречи (Meeting place).

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

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

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

   

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

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

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

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

   ContactPageV2

   define("ContactPageV2", [], function() {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "Contact",
           /* Отображение поля на странице записи. */
           diff: [
               /* Метаданные для добавления на страницу поля [Страна]. */
               {
                   /* Выполняется операция добавления элемента на страницу. */
                   "operation": "insert",
                   /* Мета-имя родительского контейнера, в который добавляется поле. */
                   "parentName": "ProfileContainer",
                   /* Поле добавляется в коллекцию элементов родительского элемента. */
                   "propertyName": "items",
                   /* Мета-имя добавляемого поля. */
                   "name": "Country",
                   /* Свойства, передаваемые в конструктор элемента. */
                   "values": {
                       /* Тип поля — справочник. */
                       "contentType": Terrasoft.ContentType.LOOKUP,
                       /* Настройка расположения поля. */
                       "layout": {
                           /* Номер столбца. */
                           "column": 0,
                           /* Номер строки. */
                           "row": 6,
                           /* Диапазон занимаемых столбцов. */
                           "colSpan": 24
                       }
                   }
               }
           ]
       };
   });
   

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

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

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

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

Пример. Добавить поле с изображением на страницу статьи базы знаний. Использовать изображение, которое приведено ниже.

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

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

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

   

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

   • Код (Code) — "KnowledgeBase".
   • Заголовок (Title) — "Статья базы знаний" ("Knowledge base article").
   • Родительский объект (Parent object) — выберите "KnowledgeBase".
   

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

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

   2. В выпадающем меню нажмите Другие —> Ссылка на изображение (Other —> Image Link).

      

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

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

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

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

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

   

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

   • Код (Code) — "KnowledgeBasePageV2".
   • Заголовок (Title) — "Knowledge base edit page".
   • Родительский объект (Parent object) — выберите "KnowledgeBasePageV2".
   

4. Добавьте изображение.

   1. В контекстном меню узла Изображения (Images) нажмите кнопку .

   2. Заполните свойства изображения.

      • Код (Code) — "DefaultLogo".
      • Изображение (Image) — выберите файл с изображением.
      
   3. Для добавления изображения нажмите Добавить (Add).
5. В объявлении класса модели представления в качестве зависимостей добавьте модули KnowledgeBasePageV2Resources и ConfigurationConstants.

6. Настройте расположение поля с изображением.

   Поле с изображением планируется разместить в верхней части страницы статьи базы знаний. Добавление поля с изображением может нарушить расположение полей базовой страницы. Чтобы этого избежать, кроме размещения поля с изображением, необходимо дополнительно изменить расположение существующих полей, которые находятся в верхней части страницы. Это поля Название (Name), Тип (Type), Изменил (Modified By).

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

      • getPhotoSrcMethod() — получает изображение по ссылке.
      • beforePhotoFileSelected() — вызывается перед открытием диалогового окна выбора изображения.
      • onPhotoChange() — вызывается при изменении изображения.
      • onPhotoUploaded() — сохраняет ссылку на измененное изображение в колонке объекта.
   2. В массив модификаций diff добавьте конфигурационный объект с настройками расположения поля с изображением и существующих полей на странице. Поле с изображением добавляется на страницу с использованием вспомогательного контейнера-обертки PhotoContainer с классом "image-edit-container".

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

   KnowledgeBasePageV2

   define("KnowledgeBasePageV2", ["KnowledgeBasePageV2Resources", "ConfigurationConstants"], function(resources, ConfigurationConstants) {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "KnowledgeBase",
           /* Методы модели представления страницы раздела. */
           methods: {
               /* Вызывается перед открытием диалогового окна выбора изображения. */
               beforePhotoFileSelected: function() {
                   return true;
               },
               /* Получает изображение по ссылке. */
               getPhotoSrcMethod: function() {
                   /* Получает ссылку на изображение из колонки объекта. */
                   var imageColumnValue = this.get("UsrLogo");
                   /* Если ссылка установлена, то метод возвращает url файла с изображением. */
                   if (imageColumnValue) {
                       return this.getSchemaImageUrl(imageColumnValue);
                   }
                   /* Если ссылка не установлена, то возвращает изображение по умолчанию. */
                   return this.Terrasoft.ImageUrlBuilder.getUrl(this.get("Resources.Images.DefaultLogo"));
               },
               /* Обрабатывает изменение изображения.
               photo — файл с изображением. */
               onPhotoChange: function(photo) {
                   if (!photo) {
                       this.set("UsrLogo", null);
                       return;
                   }
                   /* Выполняет загрузку файла в базу данных. По окончании загрузки вызывается onPhotoUploaded. */
                   this.Terrasoft.ImageApi.upload({
                       file: photo,
                       onComplete: this.onPhotoUploaded,
                       onError: this.Terrasoft.emptyFn,
                       scope: this
                   });
               },
               /* Сохраняет ссылку на измененное изображение.
               imageId — Id сохраненного файла из базы данных. */
               onPhotoUploaded: function(imageId) {
                   var imageData = {
                       value: imageId,
                       displayValue: "Image"
                   };
                   /* Колонке изображения присваивается ссылка на изображение. */
                   this.set("UsrLogo", imageData);
               }
           },
           /* Отображение поля на странице раздела. */
           diff: /**SCHEMA_DIFF*/[
               /* Метаданные для добавления на страницу записи пользовательского поля с изображением. */
               {
                   /* Выполняется операция добавления элемента на страницу. */
                   "operation": "insert",
                   /* Мета-имя родительского контейнера, в который добавляется поле. */
                   "parentName": "Header",
                   /* Изображение добавляется в коллекцию элементов родительского элемента. */
                   "propertyName": "items",
                   /* Мета-имя добавляемого изображения. */
                   "name": "PhotoContainer",
                   /* Свойства, передаваемые в конструктор элемента. */
                   "values": {
                       /* Тип добавляемого элемента — контейнер. */
                       "itemType": Terrasoft.ViewItemType.CONTAINER,
                       /* Имя CSS класса. */
                       "wrapClass": ["image-edit-container"],
                       /* Настройка расположения изображения. */
                       "layout": { 
                           /* Номер столбца. */
                           "column": 0, 
                           /* Номер строки. */
                           "row": 0, 
                           /* Диапазон занимаемых строк. */
                           "rowSpan": 3, 
                           /* Диапазон занимаемых столбцов. */
                           "colSpan": 3 
                       },
                       /* Массив дочерних элементов. */
                       "items": []
                   }
               },
               /* Поле [UsrLogo] — поле с логотипом контрагента. */
               {
                   "operation": "insert",
                   "parentName": "PhotoContainer",
                   "propertyName": "items",
                   "name": "UsrLogo",
                   "values": {
                       /* Метод, который получает изображение по ссылке. */
                       "getSrcMethod": "getPhotoSrcMethod",
                       /* Метод, который вызывается при изменении изображения. */
                       "onPhotoChange": "onPhotoChange",
                       /* Метод, который вызывается перед вызовом диалогового окна выбора изображения. */
                       "beforeFileSelected": "beforePhotoFileSelected",
                       /* Свойство, которое определяет возможность редактирования изображения. */
                       "readonly": false,
                       /* View-генератор элемента управления. */
                       "generator": "ImageCustomGeneratorV2.generateCustomImageControl"
                   }
               },
               /* Изменение расположения поля [Name]. */
               {
                   /* Выполняется операция изменения существующего элемента. */
                   "operation": "merge",
                   "name": "Name",
                   "parentName": "Header",
                   "propertyName": "items",
                   "values": {
                       "bindTo": "Name",
                       "layout": {
                           "column": 3,
                           "row": 0,
                           "colSpan": 20
                       }
                   }
               },
               /* Изменение расположения поля [ModifiedBy]. */
               {
                   "operation": "merge",
                   "name": "ModifiedBy",
                   "parentName": "Header",
                   "propertyName": "items",
                   "values": {
                       "bindTo": "ModifiedBy",
                       "layout": {
                           "column": 3,
                           "row": 2,
                           "colSpan": 20
                       }
                   }
               },
               /* Изменение расположения поля [Type]. */
               {
                   "operation": "merge",
                   "name": "Type",
                   "parentName": "Header",
                   "propertyName": "items",
                   "values": {
                       "bindTo": "Type",
                       "layout": {
                           "column": 3,
                           "row": 1,
                           "colSpan": 20
                       },
                       "contentType": Terrasoft.ContentType.ENUM
                   }
               }
           ]/**SCHEMA_DIFF*/
       };
   });
   

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

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

Чтобы посмотреть результат выполнения примера, обновите страницу раздела База знаний (Knowledge base).

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

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

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

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

   

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

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

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

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

   2. В выпадающем меню нажмите Число —> Деньги (Number —> Currency).

      

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

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

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

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

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

   

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

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

4. Настройте расположение вычисляемого поля.

   1. В свойство attributes добавьте атрибут UsrBalance, в котором укажите зависимость от колонок Amount и PaymentAmount, а также метод-обработчик calculateBalance().

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

      • calculateBalance() — метод-обработчик события изменения колонок Amount и PaymentAmount. Используется для расчета значения колонки UsrBalance, которая указана в атрибуте UsrBalance.

        В методе-обработчике необходимо учесть тип данных, который будет получен в результате выполнения и отображен в вычисляемом поле. Например, тип данных Дробное число (0.01) (Decimal (0.01)) предполагает число с двумя знаками после запятой. В таком случае перед записью результата в поле объекта необходимо преобразовать тип данных с помощью функции toFixed(). Исходный код примера преобразования типа данных представлен ниже.

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

        /* Расчет разницы между значениями в колонках [Amount] и [PaymentAmount]. */
        var result = amount - paymentAmount;
        /* Результат расчета присваивается в качестве значения колонке [UsrBalance]. */
        this.set("UsrBalance", result.toFixed(2));
        

      • onEntityInitialized() — переопределяет базовый виртуальный метод. Срабатывает после выполнения инициализации схемы объекта страницы записи. В метод onEntityInitialized() добавьте вызов метода-обработчика calculateBalance(), который обеспечит расчет суммы остатка для оплаты в момент открытия страницы записи, а не только после изменений в колонках-зависимостях.
   3. В массив модификаций diff добавьте конфигурационный объект с настройками расположения вычисляемого поля.

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

   OrderPageV2

   define("OrderPageV2", [], function() {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "Order",
           details: /**SCHEMA_DETAILS*/{}/**SCHEMA_DETAILS*/,
           /* Атрибуты модели представления. */
           attributes: {
               /* Название атрибута модели представления. */
               "UsrBalance": {
                   /* Тип данных колонки модели представления. */
                   dataValueType: Terrasoft.DataValueType.FLOAT,
                   /* Массив конфигурационных объектов, которые определяют зависимости колонки [UsrBalance]. */
                   dependencies: [
                       {
                           /* Значение колонки [UsrBalance] зависит от значений колонок [Amount] и [PaymentAmount]. */
                           columns: ["Amount", "PaymentAmount"],
                           /* Метод-обработчик, который вызывается при изменении значения одной из колонок [Amount] и [PaymentAmount]. */
                           methodName: "calculateBalance"
                       }
                   ]
               }
           },
           /* Методы модели представления страницы записи. */
           methods: {
               /* Переопределение базового метода Terrasoft.BasePageV2.onEntityInitialized, который срабатывает после окончания инициализации схемы объекта страницы записи. */
               onEntityInitialized: function() {
                   /* Вызывается родительская реализация метода. */
                   this.callParent(arguments);
                   /* Вызов метода-обработчика, который рассчитывает значение колонки [UsrBalance]. */
                   this.calculateBalance();
               },
               /* Метод-обработчик, который рассчитывает значение колонки [UsrBalance]. */
               calculateBalance: function() {
                   /* Проверка выполнения инициализации колонок [Amount] и [PaymentAmount] в момент открытия страницы записи. Если нет, то для них устанавливаются нулевые значения. */
                   var amount = this.get("Amount");
                   if (!amount) {
                       amount = 0;
                   }
                   var paymentAmount = this.get("PaymentAmount");
                   if (!paymentAmount) {
                       paymentAmount = 0;
                   }
                   /* Расчет разницы между значениями колонок [Amount] и [PaymentAmount]. */
                   var result = amount - paymentAmount;
                   /* Результат расчета присваивается в качестве значения колонке [UsrBalance]. */
                   this.set("UsrBalance", result);
               }
           },
           /* Отображение поля на странице записи. */
           diff: /**SCHEMA_DIFF*/[
               /* Метаданные для добавления на страницу записи вычисляемого поля. */
               {
                   /* Выполняется операция добавления элемента на страницу. */
                   "operation": "insert",
                   /* Мета-имя родительского контейнера, в который добавляется поле. */
                   "parentName": "Header",
                   /* Поле добавляется в коллекцию элементов родительского элемента. */
                   "propertyName": "items",
                   /* Мета-имя добавляемого поля. */
                   "name": "UsrBalance",
                   /* Свойства, передаваемые в конструктор элемента. */
                   "values": {
                       /* Привязка значения элемента управления к колонке модели представления. */
                       "bindTo": "UsrBalance",
                       /* Настройка расположения поля. */
                       "layout": {
                           /* Номер столбца. */
                           "column": 12, 
                           /* Номер строки. */
                           "row": 2, 
                           /* Диапазон занимаемых столбцов. */
                           "colSpan": 12
                       }
                   }
               }
           ]/**SCHEMA_DIFF*/
       };
   });
   

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

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

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

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

В результате выполнения примера на страницу заказа добавлено вычисляемое поле Остаток для оплаты (Payment balance). Значение поля — разница между суммой заказа (поле Итого (Total)) и суммой оплаты (поле Сумма оплаты (Payment amount)).

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

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

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

   

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

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

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

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

   2. В выпадающем меню нажмите Справочник (Lookup).

      

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

      • Код (Code) — "UsrCurrency".
      • Заголовок (Title) — "Валюта" ("Currency").
      • Справочник (Lookup) — выберите "Currency".

      • Значение по умолчанию (Default value).

        1. В поле Значение по умолчанию (Default value) нажмите .
        2. Тип значения (Default value type) — выберите "Cистемная настройка" ("System setting").

        3. Cистемная настройка (System setting) — выберите "Базовая валюта" ("Base currency", код PrimaryCurrency).

           

   Свойства колонки представлены на рисунке ниже.

   

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

   Свойства добавляемых колонок

   Тип данных (Data type)	Код (Code)	Заголовок (Title)
   Деньги (Currency)	"UsrAmount"	"Общая сумма" ("Amount")
   Деньги (Currency)	"UsrPrimaryAmount"	"Сумма в базовой валюте" ("Amount, base currency")
   Дробное число (0,0001) (Decimal (0.0001))	"UsrCurrencyRate"	"Курс валют" ("Exchange rate")

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

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

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

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

   

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

   • Код (Code) — "ProjectPageV2".
   • Заголовок (Title) — "Страница редактирования проекта" ("Project edit page").
   • Родительский объект (Parent object) — выберите "ProjectPageV2".
   
4. В объявлении класса модели представления в качестве зависимостей добавьте модули MoneyModule, MultiCurrencyEdit, MultiCurrencyEditUtilities.

5. Настройте расположение мультивалютного поля.

   1. В свойство attributes добавьте атрибуты:

      • UsrCurrency — валюта. Соответствует колонке UsrCurrency.
      • UsrCurrencyRate — курс валюты. Соответствует колонке UsrCurrencyRate.
      • UsrAmount — общая сумма. Соответствует колонке UsrAmount.
      • UsrPrimaryAmount — сумма в базовой валюте. Соответствует колонке UsrPrimaryAmount.
      • Currency — валюта. Соответствует колонке Currency. Это колонка, с которой взаимодействует мультивалютный модуль. В атрибуте Currency объявите виртуальную колонку, которую с помощью метода-обработчика свяжите с колонкой UsrCurrency.
      • CurrencyRateList — коллекция курсов валют. Предназначен для корректной работы мультивалютного модуля.
      • CurrencyButtonMenuList — коллекция для кнопки выбора валюты. Предназначен для корректной работы мультивалютного модуля.
   2. В свойство mixins добавьте миксин MultiCurrencyEditUtilities.

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

      • onEntityInitialized() — переопределяет базовый виртуальный метод. Срабатывает после выполнения инициализации схемы объекта страницы записи.
      • setCurrencyRate() — устанавливает курс валюты.
      • recalculateAmount() — пересчитывает общую сумму.
      • recalculatePrimaryAmount() — пересчитывает сумму в базовой валюте.
      • onVirtualCurrencyChange() — метод-обработчик изменения виртуальной колонки валюты.
   4. В массив модификаций diff добавьте конфигурационный объект с настройками расположения мультивалютного поля.

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

   ProjectPageV2

   /* В качестве зависимостей укажите модули MoneyModule, MultiCurrencyEdit и MultiCurrencyEditUtilities. */
   define("ProjectPageV2", ["MoneyModule", "MultiCurrencyEdit", "MultiCurrencyEditUtilities"],
       function(MoneyModule, MultiCurrencyEdit, MultiCurrencyEditUtilities) {
           return {
               /* Название схемы объекта страницы записи. */
               entitySchemaName: "Project",
               /* Атрибуты модели представления. */
               attributes: {
                   /* Валюта. */
                   "UsrCurrency": {
                       /* Тип данных колонки модели представления. */
                       "dataValueType": this.Terrasoft.DataValueType.LOOKUP,
                       /* Конфигурация справочника валют. */
                       "lookupListConfig": {
                           "columns": ["Division", "Symbol"]
                       }
                   },
                   /* Курс. */
                   "UsrCurrencyRate": {
                       "dataValueType": this.Terrasoft.DataValueType.FLOAT,
                       /* Массив конфигурационных объектов, которые определяют зависимости колонки [UsrCurrencyRate]. */
                       "dependencies": [
                           {
                               /* Значение колонки [UsrCurrencyRate] зависит от значения колонки [UsrCurrency]. */
                               "columns": ["UsrCurrency"],
                               /* Метод-обработчик. */
                               "methodName": "setCurrencyRate"
                           }
                       ]
                   },
                   /* Общая сумма. */
                   "UsrAmount": {
                       "dataValueType": this.Terrasoft.DataValueType.FLOAT,
                       "dependencies": [
                           {
                               "columns": ["UsrCurrencyRate", "UsrCurrency"],
                               "methodName": "recalculateAmount"
                           }
                       ]
                   },
                   /* Сумма в базовой валюте. */
                   "UsrPrimaryAmount": {
                       "dependencies": [
                           {
                               "columns": ["UsrAmount"],
                               "methodName": "recalculatePrimaryAmount"
                           }
                       ]
                   },
                   /* Валюта — виртуальная колонка для совместимости с модулем MultiCurrencyEditUtilities. */
                   "Currency": {
                       "type": this.Terrasoft.ViewModelColumnType.VIRTUAL_COLUMN,
                       "dataValueType": this.Terrasoft.DataValueType.LOOKUP,
                       "lookupListConfig": {
                           "columns": ["Division"]
                       },
                       "dependencies": [
                           {
                               "columns": ["Currency"],
                               "methodName": "onVirtualCurrencyChange"
                           }
                       ]
                   },
                   /* Коллекция курсов валют. */
                   "CurrencyRateList": {
                       dataValueType: this.Terrasoft.DataValueType.COLLECTION,
                       value: this.Ext.create("Terrasoft.Collection")
                   },
                   /* Коллекция для кнопки выбора валюты. */
                   "CurrencyButtonMenuList": {
                       dataValueType: this.Terrasoft.DataValueType.COLLECTION,
                       value: this.Ext.create("Terrasoft.BaseViewModelCollection")
                   }
               },
               /* Миксины модели представления. */
               mixins: {
                   /* Миксин управления мультивалютностью на странице записи. */
                   MultiCurrencyEditUtilities: "Terrasoft.MultiCurrencyEditUtilities"
               },
               /* Методы модели представления страницы записи. */
               methods: {
                   /* Переопределение базового метода Terrasoft.BasePageV2.onEntityInitialized(). */
                   onEntityInitialized: function() {
                       /* Вызывается родительская реализация метода. */
                       this.callParent(arguments);
                       this.set("Currency", this.get("UsrCurrency"), {silent: true});
                       /* Инициализация миксина управления мультивалютностью. */
                       this.mixins.MultiCurrencyEditUtilities.init.call(this);
                   },
                   /* Устанавливает курс валюты. */
                   setCurrencyRate: function() {
                       /* Загружает курс валют на дату начала проекта. */
                       MoneyModule.LoadCurrencyRate.call(this, "UsrCurrency", "UsrCurrencyRate", this.get("StartDate"));
                   },
                   /* Пересчитывает сумму. */
                   recalculateAmount: function() {
                       var currency = this.get("UsrCurrency");
                       var division = currency ? currency.Division : null;
                       MoneyModule.RecalcCurrencyValue.call(this, "UsrCurrencyRate", "UsrAmount", "UsrPrimaryAmount", division);
                   },
                   /* Пересчитывает сумму в базовой валюте. */
                   recalculatePrimaryAmount: function() {
                       var currency = this.get("UsrCurrency");
                       var division = currency ? currency.Division : null;
                       MoneyModule.RecalcBaseValue.call(this, "UsrCurrencyRate", "UsrAmount", "UsrPrimaryAmount", division);
                   },
                   /* Обработчик изменения виртуальной колонки валюты. */
                   onVirtualCurrencyChange: function() {
                       var currency = this.get("Currency");
                       this.set("UsrCurrency", currency);
                   }
               },
               /* Отображение поля на странице записи. */
               diff: /**SCHEMA_DIFF*/[
                   /* Метаданные для добавления на страницу записи мультивалютного поля. */
                   {
                       /* Выполняется операция добавления элемента на страницу. */
                       "operation": "insert",
                       /* Мета-имя родительского контейнера, в который добавляется поле. */
                       "parentName": "Header",
                       /* Поле добавляется в коллекцию элементов родительского элемента. */
                       "propertyName": "items",
                       /* Мета-имя добавляемого поля. */
                       "name": "UsrAmount",
                       /* Свойства, передаваемые в конструктор элемента. */
                       "values": {
                           /* Привязка значения элемента управления к колонке модели представления. */
                           "bindTo": "UsrAmount",
                           /* Настройка расположения поля. */
                           "layout": { 
                               /* Номер столбца. */
                               "column": 0, 
                               /* Номер строки. */
                               "row": 2, 
                               /* Диапазон занимаемых столбцов. */
                               "colSpan": 12 
                           },
                           /* Наименование колонки, которая содержит сумму в базовой валюте. */
                           "primaryAmount": "UsrPrimaryAmount",
                           /* Наименование колонки, которая содержит валюту суммы. */
                           "currency": "UsrCurrency",
                           /* Наименование колонки, которая содержит курс валюты. */
                           "rate": "UsrCurrencyRate",
                           /* Свойство, которое определяет доступность для редактирования поля суммы в базовой валюте. */
                           "primaryAmountEnabled": false,
                           /* Генератор представления элемента управления. */
                           "generator": "MultiCurrencyEditViewGenerator.generate"
                       }
                   }
               ]/**SCHEMA_DIFF*/
           };
       });
   

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

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

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

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

Значение поля автоматически пересчитывается после выбора валюты в выпадающем списке.

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

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

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

   

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

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

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

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

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

      • Код (Code) — "CreatedOnLessDueDateMessage".
      • Значение (Value) — "Дата создания должна быть меньше даты закрытия" ("Created on must be less than Closed on").
      
   3. Для добавления локализуемой строки нажмите Добавить (Add).

5. Реализуйте валидацию поля типа Дата/Время (Date/Time).

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

   • dueDateValidator() — метод-валидатор, который определяет выполнение условия.
   • setValidationConfig() — переопределенный базовый метод, в котором метод-валидатор привязан к колонкам DueDate и CreatedOn.

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

   OpportunityPageV2

   define("OpportunityPageV2", [], function() {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "Opportunity",
           /* Методы модели представления страницы раздела. */
           methods: {
               /* Метод-валидатор значения колонок [DueDate] и [CreatedOn]. */
               dueDateValidator: function() {
                   /* Переменная для хранения сообщения об ошибке валидации. */
                   var invalidMessage = "";
                   /* Проверка значений колонок [DueDate] и [CreatedOn]. */
                   if (this.get("DueDate") < this.get("CreatedOn")) {
                       /* Если значение колонки [DueDate] меньше значения колонки [CreatedOn], то в переменную invalidMessage помещается значение локализуемой строки с сообщением об ошибке валидации. */
                       invalidMessage = this.get("Resources.Strings.CreatedOnLessDueDateMessage");
                   }
                   /* Объект, свойство которого содержит сообщение об ошибке валидации. Если валидация прошла успешна, то в объекте возвращается пустая строка. */
                   return {
                       /* Сообщение об ошибке валидации. */
                       invalidMessage: invalidMessage
                   };
               },
               /* Переопределение базового метода, который инициализирует пользовательские валидаторы. */
               setValidationConfig: function() {
                   /* Вызывает инициализацию валидаторов родительской модели представления. */
                   this.callParent(arguments);
                   /* Для колонки [DueDate] добавляется метод-валидатор dueDateValidator(). */
                   this.addColumnValidator("DueDate", this.dueDateValidator);
                   /* Для колонки [CreatedOn] добавляется метод-валидатор dueDateValidator(). */
                   this.addColumnValidator("CreatedOn", this.dueDateValidator);
               }
           }
       };
   });
   

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

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

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

1. Обновите страницу раздела Продажи (Opportunities).
2. В поле Дата закрытия (Closed on) выберите дату, значение которой меньше значения поля Дата создания (Created on).

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

При попытке сохранить продажу, у которой значение поля Дата закрытия (Closed on) меньше значения поля Дата создания (Created on) отображается информационное сообщение.

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

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

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

   

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

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

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

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

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

      • Код (Code) — "InvalidPhoneFormatMessage".
      • Значение (Value) — "Введите номер в формате: +44 ХХХ ХХХ ХХХХ" ("Enter the number in format +44 ХХХ ХХХ ХХХХ").
      
   3. Для добавления локализуемой строки нажмите Добавить (Add).
5. В объявлении класса модели представления в качестве зависимостей добавьте модуль ConfigurationConstants.

6. Реализуйте валидацию поля типа Строка (String).

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

   • phoneValidator() — метод-валидатор, который определяет выполнение условия.
   • setValidationConfig() — переопределенный базовый метод, в котором метод-валидатор привязан к колонке Phone.

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

   ContactPageV2

   define("ContactPageV2", ["ConfigurationConstants"], function(ConfigurationConstants) {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "Contact",
           /* Методы модели представления страницы записи. */
           methods: {
               /* Переопределение базового метода, который инициализирует пользовательские валидаторы. */
               setValidationConfig: function() {
                   /* Вызывает инициализацию валидаторов родительской модели представления. */
                   this.callParent(arguments);
                   /* Для колонки [Phone] добавляется метод-валидатор phoneValidator(). */
                   this.addColumnValidator("Phone", this.phoneValidator);
               },
               /* Метод-валидатор значения колонки [Phone]. */
               phoneValidator: function(value) {
                   /* Переменная для хранения сообщения об ошибке валидации. */
                   var invalidMessage = "";
                   /* Переменная для хранения результата проверки номера. */
                   var isValid = true;
                   /* Переменная для хранения номера телефона. */
                   var number = value || this.get("Phone");
                   /* Определение правильности формата номера с помощью регулярного выражения. */
                   isValid = (Ext.isEmpty(number) ||
                       new RegExp("^\\+44\\s[0-9]{3}\\s[0-9]{3}\\s[0-9]{4}$").test(number));
                   /* Если формат номера неправильный, то заполняется сообщение об ошибке. */
                   if (!isValid) {
                       invalidMessage = this.get("Resources.Strings.InvalidPhoneFormatMessage");
                   }
                   /* Объект, свойство которого содержит сообщение об ошибке валидации. Если валидация прошла успешна, то в объекте возвращается пустая строка. */
                   return {
                       invalidMessage: invalidMessage
                   };
               }
           }
       };
   });
   

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

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

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

1. Обновите страницу раздела Контакты (Contacts).
2. В поле Рабочий телефон (Business phone) введите номер телефона, который не соответствует маске +44 ХХХ ХХХ ХХХХ.

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

При попытке сохранить контакт, у которого номер телефона не соответствует маске +44 ХХХ ХХХ ХХХХ, отображается информационное сообщение.

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

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

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

   

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

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

4. Настройте логику заполнения поля.

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

   • onEntityInitialized() — переопределенный базовый виртуальный метод. Срабатывает после окончания инициализации схемы объекта. В метод onEntityInitialized() добавьте вызов метода-обработчика setDeadline(), который обеспечит установку значения поля Крайний срок (Deadline) в момент открытия страницы записи.
   • setDeadline() — метод-обработчик, который рассчитывает значение поля Крайний срок (Deadline).

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

   ProjectPageV2

   define("ProjectPageV2", [], function() {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "Project",
           /* Методы модели представления страницы записи. */
           methods: {
               /* Переопределение базового метода Terrasoft.BasePageV2.onEntityInitialized, который срабатывает после окончания инициализации схемы объекта страницы записи. */
               onEntityInitialized: function() {
                   /* Вызывается родительская реализация метода. */
                   this.callParent(arguments);
                   /* Вызов метода-обработчика, который рассчитывает значение колонки [Deadline]. */
                   this.setDeadline();
               },
               /* Метод-обработчик, который рассчитывает значение колонки [Deadline]. */
               setDeadline: function() {
                   /* Значение колонки [Deadline]. */
                   var deadline = this.get("Deadline");
                   /* Проверяет установку режима новой записи. */
                   var newmode = this.isNewMode();
                   /* Если значение не установлено и режим новой записи установлен. */
                   if (!deadline && newmode) {
                       /* Получает значение колонки [StartDate]. */
                       var newDate = new Date(this.get("StartDate"));
                       newDate.setDate(newDate.getDate() + 10);
                       /* Установка значения колонки [Deadline]. */
                       this.set("Deadline", newDate);
                   }
               }
           }
       };
   });
   

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

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

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

В результате выполнения примера на странице добавления проекта значение поля Крайний срок (Deadline) устанавливается на 10 дней больше значения поля Начало (Start).

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

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

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

   

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

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

5. Реализуйте обязательность поля.

   Для этого задайте свойство rules для колонки Phone:

   1. В свойстве ruleType укажите значение BINDPARAMETER, которое задает тип бизнес-правила. Типы правил представлены перечислением BusinessRuleModule.enums.RuleType.
   2. В свойстве property укажите значение REQUIRED, которое устанавливает обязательность заполнения колонки. Свойства бизнес-правила BINDPARAMETER представлены перечислением BusinessRuleModule.enums.Property.
   3. В массиве conditions укажите условия выполнения бизнес-правила. Значение колонки Type должно быть равно конфигурационной константе ConfigurationConstants.ContactType.Client, которая содержит идентификатор записи "Клиент" ("Customer") справочника Типы контактов (Contact types).

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

   ContactPageV2

   /* В качестве зависимостей укажите модули BusinessRuleModule и ConfigurationConstants. */
   define("ContactPageV2", ["BusinessRuleModule", "ConfigurationConstants"],
       function(BusinessRuleModule, ConfigurationConstants) {
           return {
               /* Название схемы объекта страницы записи. */
               entitySchemaName: "Contact",
               /* Бизнес-правила модели представления страницы записи. */
               rules: {
                   /* Набор правил для колонки [Phone] модели представления. */
                   "Phone": {
                       /* Зависимость обязательности поля [Phone] от значения в поле [Type]. */
                       "BindParameterRequiredAccountByType": {
                           /* Тип правила BINDPARAMETER. */
                           "ruleType": BusinessRuleModule.enums.RuleType.BINDPARAMETER,
                           /* Правило регулирует свойство REQUIRED. */
                           "property": BusinessRuleModule.enums.Property.REQUIRED,
                           /* Массив условий для срабатывания правила. Определяет равно ли значение в колонке [Type] значению "Клиент". */
                           "conditions": [{
                               /* Выражение левой части условия. */
                               "leftExpression": {
                                   /* Тип выражения — атрибут (колонка) модели представления. */
                                   "type": BusinessRuleModule.enums.ValueType.ATTRIBUTE,
                                   /* Название колонки модели представления, значение которой сравнивается в выражении. */
                                   "attribute": "Type"
                               },
                               /* Тип операции сравнения — равно. */
                               "comparisonType": Terrasoft.ComparisonType.EQUAL,
                               /* Выражение правой части условия. */
                               "rightExpression": {
                                   /* Тип выражения — константное значение. */
                                   "type": BusinessRuleModule.enums.ValueType.CONSTANT,
                                   /* Значение, с которым сравнивается выражение левой части. */
                                   "value": ConfigurationConstants.ContactType.Client
                               }
                           }]
                       }
                   }
               }
           };
       });
   

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

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

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

1. Обновите страницу раздела Контакты (Contacts).
2. При необходимости, в поле Тип контакта (Type) страницы контакта выберите "Клиент" ("Customer").

В результате выполнения примера поле Рабочий телефон (Business phone) является обязательным для контакта типа "Клиент" ("Customer").

При попытке сохранить контакт типа "Клиент" ("Customer"), у которого не заполнено поле Рабочий телефон (Business phone), отображается информационное сообщение.

Поле Рабочий телефон (Business phone) является необязательным для другого типа контакта (например, "Сотрудник" ("Employee").

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

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

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

   

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

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

4. Реализуйте фильтрацию значений справочного поля.

   Для этого задайте свойство attributes для колонки Owner:

   • В свойстве dataValueType укажите значение LOOKUP, которое устанавливает тип данных колонки. Типы данных колонки представлены перечислением Terrasoft.core.enums.DataValueType.
   • В свойстве lookupListConfig укажите конфигурационный объект поля-справочника.
   • В массиве filters укажите функцию, которая возвращает коллекцию фильтров.

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

   AccountPageV2

   define("AccountPageV2", [], function() {
       return {
           /* Название схемы объекта страницы записи. */
           "entitySchemaName": "Account",
           /* Атрибуты модели представления. */
           "attributes": {
               /* Колонка модели представления. */
               "Owner": {
                   /* Тип данных колонки модели представления. */
                   "dataValueType": Terrasoft.DataValueType.LOOKUP,
                   /* Конфигурационный объект атрибута типа LOOKUP. */
                   "lookupListConfig": {
                       /* Массив фильтров, которые применяются к запросу для формирования данных поля-справочника. */
                       "filters": [
                           function() {
                               var filterGroup = Ext.create("Terrasoft.FilterGroup");
                               /* Добавляет фильтр "IsUser" в результирующую коллекцию фильтров.
                               Выбирает все записи из корневой схемы Contact, к которой присоединена колонка [Id] из схемы [SysAdminUnit], для которых [Id] не равен null. */
                               filterGroup.add("IsUser", Terrasoft.createColumnIsNotNullFilter("[SysAdminUnit:Contact].Id"));
                               /* Добавляет фильтр "IsActive" в результирующую коллекцию фильтров.
                               Выбирает все записи из корневой схемы [Contact], к которой присоединена колонка [Active] из схемы [SysAdminUnit], для которых Active=true. */
                               filterGroup.add("IsActive",
                                   Terrasoft.createColumnFilterWithParameter(
                                       Terrasoft.ComparisonType.EQUAL,
                                       "[SysAdminUnit:Contact].Active",
                                       true));
                               return filterGroup;
                           }
                       ]
                   }
               }
           }
       };
   });
   	

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

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

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

В результате выполнения примера при заполнении справочного поля Ответственный (Owner) настроена фильтрация контактов на странице контрагента.

Например, контакт Andrew Z. Barber не доступен для выбора в справочном поле Ответственный (Owner) на странице контрагента, поскольку является неактивным.

Контакт Sheldon Mallen не доступен для выбора в справочном поле Ответственный (Owner) на странице контрагента, поскольку не имеет связанного пользователя системы.

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

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

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

   

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

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

5. Реализуйте фильтрацию значений связанных справочных полей.

   1. В свойство rules для колонок City и Region:

      • В свойстве ruleType укажите значение FILTRATION, которое задает тип бизнес-правила. Типы правил представлены перечислением BusinessRuleModule.enums.RuleType.
      • В свойстве autocomplete укажите значение true, которое выполняет обратную фильтрацию, т. е. автозаполнение полей Страна (Country) и Область/штат (State/province) в зависимости от выбранного города.

   2. В массив модификаций diff добавьте конфигурационный объект с настройками расположения полей Страна (Country), Область/штат (State/province), Город (City).

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

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

   ContactPageV2

   /* В качестве зависимостей укажите модуль BusinessRuleModule. */
   define("ContactPageV2", ["BusinessRuleModule"],
       function(BusinessRuleModule) {
           return {
               /* Название схемы объекта страницы записи. */
               entitySchemaName: "Contact",
               /* Бизнес-правила модели представления страницы записи. */
               rules: {
                   /* Набор правил для колонки [City] модели представления. */
                   "City": {
                       /* Правило фильтрации колонки [City] по значению колонки [Region]. */
                       "FiltrationCityByRegion": {
                           /* Тип правила FILTRATION. */
                           "ruleType": BusinessRuleModule.enums.RuleType.FILTRATION,
                           /* Выполняется обратная фильтрация. */
                           "autocomplete": true,
                           /* Выполняется очистка значения при изменении значения колонки [Region]. */
                           "autoClean": true,
                           /* Путь к колонке для фильтрации в справочной схеме [City], на которую ссылается колонка [City] модели представления страницы записи. */
                           "baseAttributePatch": "Region",
                           /* Тип операции сравнения в фильтре. */
                           "comparisonType": Terrasoft.ComparisonType.EQUAL,
                           /* Тип выражения — атрибут (колонка) модели представления. */
                           "type": BusinessRuleModule.enums.ValueType.ATTRIBUTE,
                           /* Название колонки модели представления, значение которой сравнивается в выражении. */
                           "attribute": "Region"
                       }
                   },
                   /* Набор правил для колонки [Region] модели представления. */
                   "Region": {
                       "FiltrationRegionByCountry": {
                           "ruleType": BusinessRuleModule.enums.RuleType.FILTRATION,
                           "autocomplete": true,
                           "autoClean": true,
                           "baseAttributePatch": "Country",
                           "comparisonType": Terrasoft.ComparisonType.EQUAL,
                           "type": BusinessRuleModule.enums.ValueType.ATTRIBUTE,
                           "attribute": "Country"
                       }
                   }
               },
               /* Отображение полей на странице записи. */
               diff: [
                   /* Метаданные для добавления на страницу записи поля [Country]. */
                   {
                       /* Выполняется операция добавления элемента на страницу. */
                       "operation": "insert",
                       /* Мета-имя родительского контейнера, в который добавляется поле. */
                       "parentName": "ProfileContainer",
                       /* Поле добавляется в коллекцию элементов родительского элемента. */
                       "propertyName": "items",
                       /* Мета-имя добавляемого поля. */
                       "name": "Country",
                       /* Свойства, передаваемые в конструктор элемента. */
                       "values": {
                           /* Тип поля — справочник. */
                           "contentType": Terrasoft.ContentType.LOOKUP,
                           /* Настройка расположения поля. */
                           "layout": {
                               /* Номер столбца. */
                               "column": 0,
                               /* Номер строки. */
                               "row": 6,
                               /* Диапазон занимаемых столбцов. */
                               "colSpan": 24
                           }
                       }
                   },
                   /* Метаданные для добавления на страницу записи поля [Region]. */
                   {
                       "operation": "insert",
                       "parentName": "ProfileContainer",
                       "propertyName": "items",
                       "name": "Region",
                       "values": {
                           "contentType": Terrasoft.ContentType.LOOKUP,
                           "layout": {
                               "column": 0,
                               "row": 7,
                               "colSpan": 24
                           }
                       }
                   },
                   /* Метаданные для добавления на страницу записи поля [City]. */
                   {
                       "operation": "insert",
                       "parentName": "ProfileContainer",
                       "propertyName": "items",
                       "name": "City",
                       "values": {
                           "contentType": Terrasoft.ContentType.LOOKUP,
                           "layout": {
                               "column": 0,
                               "row": 8,
                               "colSpan": 24
                           }
                       }
                   }
               ]
           };
       });
   

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

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

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

В результате выполнения примера в профиль контакта на страницу контакта добавлены связанные справочные поля Страна (Country), Область/штат (State/province), Город (City).

В профиле контакта можно изменить страну контакта.

Также фильтрация выполняется в окне выбора страны.

Перечень доступных для выбора областей/штатов зависит от страны, выбранной в поле Страна (Country). Фильтрация выполняется как в поле ввода значения, так и в окне выбора области/штата.

Перечень доступных для выбора городов зависит от области/штата, выбранного в поле Область/штат (State/province). Фильтрация выполняется как в поле ввода значения, так и в окне выбора города.

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

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

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

   

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

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

5. Реализуйте условия блокировки поля.

   1. В свойство rules для колонки Phone:

      • В свойстве ruleType укажите значение BINDPARAMETER, которое задает тип бизнес-правила. Типы правил представлены перечислением BusinessRuleModule.enums.RuleType.
      • В свойстве property укажите значение ENABLED, которое устанавливает доступность колонки. Свойства бизнес-правила BINDPARAMETER представлены перечислением BusinessRuleModule.enums.Property.
      • В массиве conditions укажите условия выполнения бизнес-правила. Значение колонки MobilePhone не должно быть пустым.

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

   ContactPageV2

   /* В качестве зависимостей укажите модуль BusinessRuleModule. */
   define("ContactPageV2", ["BusinessRuleModule"], function(BusinessRuleModule) {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "Contact",
           /* Бизнес-правила модели представления страницы записи. */
           rules: {
               /* Набор правил для колонки [Phone] модели представления. */
               "Phone": {
                   /* Зависимость обязательности поля [Phone] от значения в поле [MobilePhone]. */
                   "BindParameterEnabledPhoneByMobile": {
                       /* Тип правила BINDPARAMETER. */
                       "ruleType": BusinessRuleModule.enums.RuleType.BINDPARAMETER,
                       /* Правило регулирует свойство ENABLED. */
                       "property": BusinessRuleModule.enums.Property.ENABLED,
                       /* Массив условий для срабатывания правила. Определяет установлено ли значение в колонке [MobilePhone]. */
                       "conditions": [{
                           /* Выражение левой части условия. */
                           "leftExpression": {
                               /* Тип выражения — атрибут (колонка) модели представления. */
                               "type": BusinessRuleModule.enums.ValueType.ATTRIBUTE,
                               /* Название колонки модели представления, значение которой сравнивается в выражении. */
                               "attribute": "MobilePhone"
                           },
                           /* Тип операции сравнения — не равно. */
                           "comparisonType": Terrasoft.ComparisonType.NOT_EQUAL,
                           /* Выражение правой части условия. */
                           "rightExpression": {
                               /* Тип выражения — константное значение. */
                               "type": BusinessRuleModule.enums.ValueType.CONSTANT,
                               /* Значение, с которым сравнивается выражение левой части. */
                               "value": ""
                           }
                       }]
                   }
               }
           }
       };
   });
   

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

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

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

В результате выполнения примера на странице контакта поле Рабочий телефон (Business phone) заблокировано при отсутствии значения в поле Мобильный телефон (Mobile phone).

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

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

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

   

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

   • Код (Code) — "InvoicePageV2".
   • Заголовок (Title) — "Страница редактирования счета" ("Invoice edit page").
   • Родительский объект (Parent object) — выберите "InvoicePageV2".
   
4. В объявлении класса модели представления в качестве зависимостей добавьте модуль InvoiceConfigurationConstants.

5. Реализуйте исключения и условия блокировки полей.

   1. В свойство attributes добавьте атрибут IsModelItemsEnabled, который включает механизм блокировки полей.

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

      • getDisableExclusionsColumnTags() — исключает блокировку колонки.
      • getDisableExclusionsDetailSchemaNames() — исключает блокировку детали.
      • setCardLockoutStatus() — настраивает условия блокировки полей.
      • onEntityInitialized() — переопределяет базовый виртуальный метод. Срабатывает после выполнения инициализации схемы объекта страницы записи.
   3. В массив модификаций diff добавьте конфигурационный объект с настройками контейнера CardContentWrapper, в котором планируется блокировать поля.

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

   InvoicePageV2

   /* В качестве зависимостей укажите модуль InvoiceConfigurationConstants. */
   define("InvoicePageV2", ["InvoiceConfigurationConstants"], function(InvoiceConfigurationConstants) {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "Invoice",
           /* Атрибуты модели представления. */
           attributes: {
               "IsModelItemsEnabled": {
                   /* Тип данных колонки модели представления. */
                   dataValueType: Terrasoft.DataValueType.BOOLEAN,
                   value: true,
                   /* Массив конфигурационных объектов, которые определяют зависимости атрибута [IsModelItemsEnabled]. */
                   dependencies: [{
                       /* Значение колонки [IsModelItemsEnabled] зависит от значения колонки [PaymentStatus]. */
                       columns: ["PaymentStatus"],
                       /* Метод-обработчик. */
                       methodName: "setCardLockoutStatus"
                   }]
               }
           },
           /* Методы модели представления страницы записи. */
           methods: {
               /* Исключение блокировки колонки [PaymentStatus]. */
               getDisableExclusionsColumnTags: function() {
                   return ["PaymentStatus"];
               },
               /* Исключение блокировки детали [ActivityDetailV2]. */
               getDisableExclusionsDetailSchemaNames: function() {
                   return ["ActivityDetailV2"];
               },
               /* Настройка условий блокировки полей. */
               setCardLockoutStatus: function() {
                   var state = this.get("PaymentStatus");
                   if (state.value === InvoiceConfigurationConstants.Invoice.PaymentStatus.Paid) {
                       this.set("IsModelItemsEnabled", false);
                   } else {
                       this.set("IsModelItemsEnabled", true);
                   }
               },
               /* Переопределение базового метода Terrasoft.BasePageV2.onEntityInitialized(). */
               onEntityInitialized: function() {
                   /* Вызывается родительская реализация метода. */
                   this.callParent(arguments);
                   this.setCardLockoutStatus();
               }
           },
           details: /**SCHEMA_DETAILS*/{}/**SCHEMA_DETAILS*/,
           /* Отображение контейнера блокировки на странице записи. */
           diff: /**SCHEMA_DIFF*/[
               {
                   /* Выполняется операция изменения существующего элемента. */
                   "operation": "merge",
                   /* Мета-имя родительского контейнера, в котором блокируются поля. */
                   "name": "CardContentWrapper",
                   /* Свойства, передаваемые в конструктор элемента. */
                   "values": {
                       /* Генератор представления элемента управления. */
                       "generator": "DisableControlsGenerator.generatePartial"
                   }
               }
           ]/**SCHEMA_DIFF*/
       };
   });
   

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

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

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

В результате выполнения примера на странице счета, у которого в поле Состояние оплаты (Payment status) выбрано значение "Оплачен полностью" ("Paid")), заблокировано большинство полей. Незаблокированными остаются:

• Поле Состояние оплаты (Payment status).
• Деталь Активности (Activities).
• Поля, для которых в свойстве enabled массива модификаций diff указано значение true.

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

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

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

   

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

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

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

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

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

      

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

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

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

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

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

   

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

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

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

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

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

      • Код (Code) — "MeetingPlaceCaption".
      • Значение (Value) — "Место встречи" ("Meeting place").
      
   3. Для добавления локализуемой строки нажмите Добавить (Add).
5. В объявлении класса модели представления в качестве зависимостей добавьте модули BusinessRuleModule и ConfigurationConstants.

6. Реализуйте условия отображения поля.

   1. В свойство rules для колонки UsrMeetingPlace:

      1. В свойстве ruleType укажите значение BINDPARAMETER, которое задает тип бизнес-правила. Типы правил представлены перечислением BusinessRuleModule.enums.RuleType.
      2. В свойстве property укажите значение VISIBLE, которое устанавливает видимость колонки. Свойства бизнес-правила BINDPARAMETER представлены перечислением BusinessRuleModule.enums.Property.
      3. В массиве conditions укажите условия выполнения бизнес-правила. Значение колонки ActivityCategory должно быть равно конфигурационной константе ConfigurationConstants.Activity.ActivityCategory.Meeting, которая содержит идентификатор записи "Встреча" ("Meeting") справочника Категории активностей (Activity categories).
   2. В массив модификаций diff добавьте конфигурационный объект с настройками расположения поля Место встречи (Meeting place).

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

   ActivityPageV2

   /* В качестве зависимостей укажите модули BusinessRuleModule и ConfigurationConstants. */
   define("ActivityPageV2", ["BusinessRuleModule", "ConfigurationConstants"],
       function(BusinessRuleModule, ConfigurationConstants) {
           return {
               /* Название схемы объекта страницы записи. */
               entitySchemaName: "Activity",
               /* Отображение поля на странице записи. */
               diff: /**SCHEMA_DIFF*/[
               /* Метаданные для добавления на страницу записи поля [UsrMeetingPlace]. */
                   {
                       /* Выполняется операция добавления элемента на страницу. */
                       "operation": "insert",
                       /* Мета-имя родительского контейнера, в который добавляется поле. */
                       "parentName": "Header",
                       /* Поле добавляется в коллекцию элементов родительского элемента. */
                       "propertyName": "items",
                       /* Мета-имя добавляемого поля. */
                       "name": "UsrMeetingPlace",
                       /* Свойства, передаваемые в конструктор элемента. */
                       "values": {
                           /* Привязка заголовка поля к локализуемой строке схемы. */
                           "caption": {"bindTo": "Resources.Strings.MeetingPlaceCaption"},
                           /* Настройка расположения поля. */
                           "layout": { 
                               /* Номер столбца. */
                               "column": 0, 
                               /* Номер строки. */
                               "row": 5, 
                               /* Диапазон занимаемых столбцов. */
                               "colSpan": 12 
                           }
                       }
                   }
               ]/**SCHEMA_DIFF*/,
               /* Бизнес-правила модели представления страницы записи. */
               rules: {
                   /* Набор правил для колонки [UsrMeetingPlace] модели представления. */
                   "UsrMeetingPlace": {
                       /* Зависимость видимости поля [UsrMeetingPlace] от значения в поле [ActivityCategory]. */
                       "BindParametrVisibilePlaceByType": {
                           /* Тип правила BINDPARAMETER. */
                           "ruleType": BusinessRuleModule.enums.RuleType.BINDPARAMETER,
                           /* Правило регулирует свойство VISIBLE. */
                           "property": BusinessRuleModule.enums.Property.VISIBLE,
                           /* Массив условий для срабатывания правила. Определяет равно ли значение в колонке [ActivityCategory] значению "Встреча". */
                           "conditions": [{
                               /* Выражение левой части условия. */
                               "leftExpression": {
                                   /* Тип выражения — атрибут (колонка) модели представления. */
                                   "type": BusinessRuleModule.enums.ValueType.ATTRIBUTE,
                                   /* Название колонки модели представления, значение которой сравнивается в выражении. */
                                   "attribute": "ActivityCategory"
                               },
                               /* Тип операции сравнения — равно. */
                               "comparisonType": Terrasoft.ComparisonType.EQUAL,
                               /* Выражение правой части условия. */
                               "rightExpression": {
                                   /* Тип выражения — константное значение. */
                                   "type": BusinessRuleModule.enums.ValueType.CONSTANT,
                                   /* Значение, с которым сравнивается выражение левой части. */
                                   "value": ConfigurationConstants.Activity.ActivityCategory.Meeting
                               }
                           }]
                       }
                   }
               }
           };
       });
   

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

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

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

1. Обновите страницу раздела Активности (Activities).
2. При необходимости, в поле Категория (Category) страницы активности выберите значение "Встреча" ("Meeting")).

В результате выполнения примера поле Место встречи (Meeting place) отображается для активности категории "Встреча" ("Meeting").

Поле Место встречи (Meeting place) не отображается для другой категории активности (например, "Выполнить" ("To do")).

1. Создать системные настройки 

1. Создайте системную настройку с маской кода продукта.

   1. Перейдите в дизайнер системы по кнопке .
   2. В блоке Настройка системы (System setup) перейдите по ссылке Системные настройки (System settings).
   3. На панели инструментов раздела нажмите на кнопку Добавить настройку (Add setting).

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

      • Название (Name) — "Маска кода продукта" ("Product code mask").
      • Код (Code) — "ProductCodeMask".
      • Тип (Type) — выберите "Строка неограниченной длины" ("Unlimited length text").
      • Значение по умолчанию (Default value) — "ART_{0:00000}".
      

2. Создайте системную настройку с текущим кодом продукта.

   1. Перейдите в дизайнер системы по кнопке .
   2. В блоке Настройка системы (System setup) перейдите по ссылке Системные настройки (System settings).
   3. На панели инструментов раздела нажмите на кнопку Добавить настройку (Add setting).

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

      • Название (Name) — "Текущий код продукта" ("Product last number").
      • Код (Code) — "ProductLastNumber".
      • Тип (Type) — выберите "Целое число" ("Integer").
      

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

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

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

   

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

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

4. Реализуйте автонумерацию поля.

   Для этого в свойстве methods реализуйте метод onEntityInitialized() — переопределенный базовый виртуальный метод. Срабатывает после окончания инициализации схемы объекта. В метод onEntityInitialized() добавьте вызов метода-обработчика getIncrementCode(), который присвоит сгенерированный номер полю Код (Code).

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

   ProductPageV2

   define("ProductPageV2", [], function() {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "Product",
           /* Методы модели представления страницы записи. */
           methods: {
               /* Переопределение базового метода Terrasoft.BasePageV2.onEntityInitialized, который срабатывает после окончания инициализации схемы объекта страницы записи. */
               onEntityInitialized: function() {
                   /* Вызывается родительская реализация метода. */
                   this.callParent(arguments);
                   /* Код генерируется, если создается новый элемент или копия существующего. */
                   if (this.isAddMode() || this.isCopyMode()) {
                       /* Вызов базового метода Terrasoft.BasePageV2.getIncrementCode, который генерирует номер по ранее заданной маске. */
                       this.getIncrementCode(function(response) {
                           /* Сгенерированный номер возвращается в колонку [Code]. */
                           this.set("Code", response);
                       });
                   }
               }
           }
       };
   });
   

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

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

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

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

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

1. Создать системные настройки 

1. Создайте системную настройку с маской кода продукта.

   1. Перейдите в дизайнер системы по кнопке .
   2. В блоке Настройка системы (System setup) перейдите по ссылке Системные настройки (System settings).
   3. На панели инструментов раздела нажмите на кнопку Добавить настройку (Add setting).

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

      • Название (Name) — "Маска кода продукта" ("Product code mask").
      • Код (Code) — "ProductCodeMask".
      • Тип (Type) — выберите "Строка неограниченной длины" ("Unlimited length text").
      • Значение по умолчанию (Default value) — "ART_{0:00000}".
      

2. Создайте системную настройку с текущим кодом продукта.

   1. Перейдите в дизайнер системы по кнопке .
   2. В блоке Настройка системы (System setup) перейдите по ссылке Системные настройки (System settings).
   3. На панели инструментов раздела нажмите на кнопку Добавить настройку (Add setting).

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

      • Название (Name) — "Текущий код продукта" ("Product last number").
      • Код (Code) — "ProductLastNumber".
      • Тип (Type) — выберите "Целое число" ("Integer").
      

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

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

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

   

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

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

4. В схему добавьте событие.

   1. Перейдите в узел События (Events) структуры объекта.

   2. В блоке Добавление (Adding) установите признак Перед добавлением записи (Before record added). Событию присвоено имя ProductInserting.

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

5. Реализуйте событийный подпроцесс.

   1. На панели инструментов дизайнера объектов нажмите Открыть процесс (Open process).

   2. В области элементов дизайнера нажмите Действия системы (System actions) и разместите элемент Событийный подпроцесс (Event sub-process) в рабочей области дизайнера процессов.

      
   3. На панели настройки элементов заполните свойство Заголовок (Title) — "Product Inserting Sub-process".

   4. Настройте элементы событийного подпроцесса.

      1. Настройте начальное событие Сообщение (Message).

         • Заголовок (Title) — "Before product adding".
         • При получении какого сообщения запускать процесс? (Which message event should start the process?) — "ProductInserting".
         

      2. Добавьте логический оператор Исключающее "ИЛИ" (Exclusive gateway (OR)).

         Для этого в меню начального события Сообщение (Message) выберите Исключающее "ИЛИ" (Exclusive gateway (OR)).

      3. Добавьте действие системы Задание-сценарий (Script task).

         1. В области элементов дизайнера нажмите Действия системы (System actions) и разместите действие системы Задание-сценарий (Script task) в рабочей области подпроцесса.

            
         2. Действию системы Задание-сценарий (Script task) добавьте имя "Определить схему объекта для генерации номера" ("Get entity schema to generate number").

         3. Добавьте код действия системы Задание-сценарий (Script task).

            Код действия системы Задание-сценарий (Script task)

            /* Установка схемы для генерации номера. */
            UserTask1.EntitySchema = Entity.Schema;
            return true;
            

            UserTask1 — код действия системы Выполнить действие процесса (User task) Выполнить генерацию номера (Generate number), настройка которого описана на следующем шаге. Изменить код можно в расширенном режиме настройки действия системы Выполнить действие процесса (User task).

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

      4. Добавьте действие системы Выполнить действие процесса (User task).

         1. В области элементов дизайнера нажмите Действия системы (System actions) и разместите действие системы Выполнить действие процесса (User task) в рабочей области подпроцесса.

            

         2. Заполните свойства действия системы.

            • Заголовок (Title) — "Выполнить генерацию номера" ("Generate number").
            • Какое пользовательское действие выполнить? (Which user task to perform?) — выберите "Generate ordinal number". Системное действие генерирует текущий порядковый номер в соответствии с маской, которая установлена в системной настройке ProductCodeMask.
            

      5. Добавьте действие системы Задание-сценарий (Script task).

         1. В области элементов дизайнера нажмите Действия системы (System actions) и разместите действие системы Задание-сценарий (Script task) в рабочей области подпроцесса.

            
         2. Действию системы Задание-сценарий (Script task) добавьте имя "Записать полученный номер в колонку объекта" ("Save number to entity column").

         3. Добавьте код действия системы Задание-сценарий (Script task).

            Код действия системы Задание-сценарий (Script task)

            Entity.SetColumnValue("Code", UserTask1.ResultCode);
            return true;
            

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

      6. Добавьте событие Останов (Terminate).

         Для этого в области элементов дизайнера нажмите Останов (Terminate) и разместите событие в рабочей области подпроцесса.

         

   5. Настройте потоки.

      1. Настройте условный поток между логическим оператором Исключающее "ИЛИ" (Exclusive gateway (OR)) и действием системы Определить схему объекта для генерации номера (Get entity schema to generate number).

         1. В меню логического оператора Исключающее "ИЛИ" (Exclusive gateway (OR)) нажмите на кнопку и соедините логический оператор Исключающее "ИЛИ" (Exclusive gateway (OR)) с действием системы Определить схему объекта для генерации номера (Get entity schema to generate number).

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

            • Заголовок (Title) — "Код не заполнен" ("Code is empty").

            • Условие перехода (Condition to move down the flow).

              1. На панели настройки элементов в свойстве Условие перехода (Condition to move down the flow) нажмите кнопку .

              2. Задайте формулу.

                 string.IsNullOrEmpty(Entity.GetTypedColumnValue<string>("Code"))
                 

              3. Сохраните изменения.

      2. Настройте поток по умолчанию между логическим оператором Исключающее "ИЛИ" (Exclusive gateway (OR)) и событием Останов (Terminate).

         1. В меню логического оператора Исключающее "ИЛИ" (Exclusive gateway (OR)) нажмите на кнопку и соедините логический оператор Исключающее "ИЛИ" (Exclusive gateway (OR)) с событием Останов (Terminate).

         2. Трансформируйте поток управления в поток по умолчанию. Для этого в меню потока нажмите —> Поток по умолчанию (Default flow).

            

      3. Настройте потоки управления.

         1. В меню действия системы Определить схему объекта для генерации номера (Get entity schema to generate number) нажмите на кнопку и соедините действие системы Определить схему объекта для генерации номера (Get entity schema to generate number) с действием системы Выполнить генерацию номера (Generate number).
         2. В меню действия системы Выполнить генерацию номера (Generate number) нажмите на кнопку и соедините действие системы Выполнить генерацию номера (Generate number) с действием системы Записать полученный номер в колонку объекта (Save number to entity column).

   Событийный подпроцесс представлен на рисунке ниже.

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

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

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

1. Очистите кэш браузера.
2. Обновите страницу раздела Продукты (Products).
3. Добавьте и сохраните новый продукт (например, Test product).

    

Автогенерация кода и его сохранение в колонку выполняется на стороне сервера при возникновении события Перед сохранением записи (Before Record Saved), которое возникает на стороне сервера после отправки запроса на добавление записи из front-end части. Поэтому значение кода невозможно сразу отобразить на странице добавления продукта. Номер отобразится после сохранения продукта.

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

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

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

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

   

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

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

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

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

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

      • Код (Code) — "InfoButtonCaption".
      • Значение (Value) — "Это обязательное поле" ("This is obligatory field").
      
   3. Для добавления локализуемой строки нажмите Добавить (Add).

5. Реализуйте информационную кнопку.

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

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

   ContactPageV2

   define("ContactPageV2", [], function () {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "Contact",
           /* Отображение информационной кнопки к полю на странице записи. */
           diff: /**SCHEMA_DIFF*/[
               /* Метаданные для добавления текста информационной кнопки. */
               {
                   /* Выполняется операция изменения существующего элемента. */
                   "operation": "merge",
                   /* Мета-имя родительского контейнера, в который добавляется информационная кнопка. */
                   "parentName": "ProfileContainer",
                   /* Информационная кнопка добавляется в коллекцию элементов родительского элемента. */
                   "propertyName": "items",
                   /* Мета-имя изменяемого поля. */
                   "name": "AccountName",
                   /* Свойства, передаваемые в конструктор элемента. */
                   "values": {
                       /* Настройка расположения информационной кнопки. */
                       "layout": { 
                           /* Номер столбца. */
                           "column": 0, 
                           /* Номер строки. */
                           "row": 1, 
                           /* Диапазон занимаемых столбцов. */
                           "colSpan": 22, 
                           /* Диапазон занимаемых строк. */
                           "rowSpan": 1 
                       }
                   }
               },
               {
                   /* Выполняется операция добавления элемента на страницу. */
                   "operation": "insert",
                   "parentName": "ProfileContainer",
                   "propertyName": "items",
                   "name": "SimpleInfoButton",
                   "values": {
                       "layout": { 
                           "column": 22, 
                           "row": 1, 
                           "colSpan": 1, 
                           "rowSpan": 1 
                       },
                       /* Тип добавляемого элемента — информационная кнопка. */
                       "itemType": Terrasoft.ViewItemType.INFORMATION_BUTTON,
                       /* Текст подсказки. */
                       "content": { "bindTo": "Resources.Strings.InfoButtonCaption" }
                   }
               }
           ]/**SCHEMA_DIFF*/
       };
   });
   

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

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

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

В результате выполнения примера в профиль контакта страницы контакта добавлена информационная кнопка к полю ФИО (Full name).

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

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

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

   

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

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

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

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

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

      • Код (Code) — "TypeFieldHint".
      • Значение (Value) — "Выберите из списка тип контакта. <a href="https://academy.terrasoft.ua/docs/user/bazis_platformy/interfejs/stranitsy_zapisey/stranicy_zapisej" target="_blank">Узнать больше</a>" ("Choose the type of the contact from the list. <a href="https://academy.creatio.com/docs/user/platform_basics/user_interface/record_pages_shortcut/record_pages" target="_blank">Read more</a>").
      
   3. Для добавления локализуемой строки нажмите Добавить (Add).

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

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

   ContactPageV2

   define("ContactPageV2", [], function () {
       return {
           /* Название схемы объекта страницы записи. */
           entitySchemaName: "Contact",
           /* Отображение всплывающей подсказки. */
           diff: /**SCHEMA_DIFF*/[
               /* Метаданные для добавления к полю всплывающей подсказки. */
               {
                   /* Выполняется операция изменения существующего элемента. */
                   "operation": "merge",
                   /* Мета-имя изменяемого поля. */
                   "name": "Type",
                   /* Мета-имя родительского контейнера, в котором изменяется поле. */
                   "parentName": "ContactGeneralInfoBlock",
                   /* Поле изменяется в коллекции элементов родительского элемента. */
                   "propertyName": "items",
                   /* Свойства, передаваемые в конструктор элемента. */
                   "values": {
                       /* Свойство поля, которое отвечает за отображение подсказки. */
                       "tip": {
                           /* Текст подсказки. */
                           "content": { "bindTo": "Resources.Strings.TypeFieldHint" },
                           /* Режим отображения подсказки.
                           По умолчанию режим WIDE - толщина зеленой полоски, которая отображается в подсказке. */
                           "displayMode": Terrasoft.controls.TipEnums.displayMode.WIDE
                       }
                   }
               }
           ]/**SCHEMA_DIFF*/
       };
   });
   

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

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

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

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