Обращения

1. Создать схему объекта сервиса 

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

2. На панели инструментов реестра раздела нажмите [ Добавить ] —> [ Объект ] ([ Add ] —> [ Object ]).

   

3. В дизайнере схем заполните свойства схемы:

   • [ Код ] ([ Code ]) — "UsrServiceTerms".
   • [ Заголовок ] ([ Title ]) — "Сервис расчета временных параметров" ("Service for calculating terms").
   • [ Родительский объект ] ([ Parent object ]) — выберите "BaseEntity".
   

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

   1. В контекстном меню узла [ Колонки ] ([ Columns ]) структуры объекта нажмите —> [ Справочник ] ([ Lookup ].

      

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

      • [ Код ] ([ Code ]) — "UsrReactionTimeUnit".
      • [ Заголовок ] ([ Title ]) — "Единица измерения времени реакции" ("Response time unit").
      • [ Справочник ] ([ Lookup ]) — выберите "TimeUnit".
      

5. Аналогично добавьте другие колонки.

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

   Значения свойств колонок

   Колонка	Свойство	Значение свойства
   Колонка, которая хранит значение срока реакции	[ Тип данных ] ([ Data type ])	"Целое" ("Integer")
   	[ Код ] ([ Code ])	"UsrReactionTimeValue"
   	[ Заголовок ] ([ Title ])	"Значение времени реакции" ("Response time")
   Колонка, которая указывает единицу измерения времени разрешения	[ Тип данных ] ([ Data type ])	"Справочник" ("Lookup")
   	[ Код ] ([ Code ])	"UsrSolutionTimeUnit"
   	[ Заголовок ] ([ Title ])	"Единица измерения времени разрешения" ("Resolve time unit")
   	[ Справочник ] ([ Lookup ])	Выберите "TimeUnit"
   Колонка, которая хранит значение срока разрешения	[ Тип данных ] ([ Data type ])	"Целое" ("Integer")
   	[ Код ] ([ Code ])	"UsrSolutionTimeValue"
   	[ Заголовок ] ([ Title ])	"Значение времени разрешения" ("Resolution time")
   Колонка, которая хранит календарь. По этому календарю рассчитываются сроки в обращении.	[ Тип данных ] ([ Data type ])	"Справочник" ("Lookup")
   	[ Код ] ([ Code ])	"UsrCalendarId"
   	[ Заголовок ] ([ Title ])	"Используемый календарь" ("Calendar that is used")
   	[ Справочник ] ([ Lookup ])	Выберите "Calendar"
   Колонка, которая хранит ссылку на сервисный договор для возможности выполнения фильтрации	[ Тип данных ] ([ Data type ])	"Справочник" ("Lookup")
   	[ Код ] ([ Code ])	"UsrServicePactId"
   	[ Заголовок ] ([ Title ])	"Сервисный договор" ("Service agreement")
   	[ Справочник ] ([ Lookup ])	Выберите "ServicePact"
   Колонка, которая хранит ссылку на сервис для возможности выполнения фильтрации	[ Тип данных ] ([ Data type ])	"Справочник" ("Lookup")
   	[ Код ] ([ Code ])	"UsrServiceItemId"
   	[ Заголовок ] ([ Title ])	"Сервис" ("Service")
   	[ Справочник ] ([ Lookup ])	Выберите "ServiceItem"

6. На панели инструментов дизайнера объекта нажмите [ Опубликовать ] ([ Publish ]) для создания соответствующей таблицы в базе данных.

2. Создать справочник с временными параметрами 

1. Перейдите в дизайнер системы по кнопке . В блоке [ Настройка системы ] ([ System setup ]) перейдите по ссылке [ Справочники ] ([ Lookups ]).

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

   1. На панели инструментов раздела [ Справочники ] ([ Lookups ]) нажмите [ Добавить справочник ] ([ New lookup ]) и заполните свойства справочника:

      • [ Название ] ([ Name ]) — "Пользовательские сроки реакции и разрешения" ("Custom response and resolution deadlines").
      • [ Объект ] ([ Object ]) — выберите "Сервис расчета временных параметров" ("Service for calculating terms").
      
   2. На панели инструментов страницы настройки справочника нажмите [ Сохранить ] ([ Save ]) для сохранения справочника.
3. Откройте справочник [ Пользовательские сроки реакции и разрешения ] ([ Custom response and resolution deadlines ]).

4. Настройте отображение колонок реестра. Для этого воспользуйтесь инструкцией, которая приведена в статье Реестр раздела.

   Колонки, которые необходимо отобразить:

   • [ Сервис ] ([ Service ]).
   • [ Сервисный договор ] ([ Service agreement ]).
   • [ Используемый календарь ] ([ Calendar that it used ]).
   • [ Единица измерения времени разрешения ] ([ Resolve time unit ]).
   • [ Время разрешения ] ([ Resolution time ]).
   • [ Единица измерения времени реакции ] ([ Response time unit ]).
   • [ Время реакции ] ([ Response time ]).

5. На панели инструментов страницы настройки справочника нажмите [ Добавить ] ([ New ]) и заполните значения полей справочника:

   • [ Сервис ] ([ Service ]) — выберите "Восстановление утерянных данных" ("Lost data recovery").
   • [ Сервисный договор ] ([ Service agreement ]) — выберите "78 — Elite Systems".
   • [ Используемый календарь ] ([ Calendar that it used ]) — выберите "Типовой календарь" ("Default calendar").
   • [ Единица измерения времени разрешения ] ([ Resolve time unit ]) — выберите "Календарных дней" ("Calendar days").
   • [ Время разрешения ] ([ Resolution time ]) — "1".
   • [ Единица измерения времени реакции ] ([ Response time unit ]) — выберите "Календарных часов" ("Calendar hours").
   • [ Время реакции ] ([ Response time ]) — "2".
   

3. Реализовать получение временных параметров 

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

2. На панели инструментов реестра раздела нажмите [ Добавить ] —> [ Исходный код ] ([ Add ] —> [ Source code ]).

   

3. В дизайнере исходного кода заполните свойства схемы:

   • [ Код ] ([ Code ]) — "UsrServiceTermsStrategy".
   • [ Заголовок ] ([ Title ]) — "Правило расчета временных параметров" ("Rule for calculating terms").
   

   Для применения изменений свойств нажмите [ Применить ] ([ Apply ]).

4. Реализуйте логику получения временных параметров.

   1. Создайте класс, который является наследником абстрактного класса BaseTermStrategy.

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

      Параметры конструктора:

      • UserConnection userConnection — текущее подключение пользователя.
      • Dictionary<string, object> — параметры, на основании которых выполняется расчет.

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

   UsrServiceTermsStrategy

   Code copied

   namespace Terrasoft.Configuration
   {
       using System;
       using System.Collections.Generic;
       using Terrasoft.Common;
       using Terrasoft.Configuration.Calendars;
       using Terrasoft.Core;
       using Terrasoft.Core.Entities;
       using CalendarsTimeUnit = Calendars.TimeUnit;
       using SystemSettings = Terrasoft.Core.Configuration.SysSettings;
       public class UsrServiceTermsStrategy: BaseTermStrategy<CaseTermInterval, CaseTermStates>
       {
           /* Класс-контейнер для хранения данных, которые получены из точки входа. */
           protected class StrategyData
           {
               public Guid ServiceItemId {
                   get;
                   set;
               }
               public Guid ServicePactId {
                   get;
                   set;
               }
           }
           /* Поле, которое хранит полученные из точки входа данные. */
           protected StrategyData _strategyData;
           /* Параметризированный конструктор, который необходим для корректной инициализации классом-селектором. */
           public UsrServiceTermsStrategy(UserConnection userConnection, Dictionary<string, object> args) : base(userConnection) {
               _strategyData = args.ToObject<StrategyData>();
           }
           /* Метод, который получает данные и возвращает их в экземпляре класса CaseTermInterval. */
           public override CaseTermInterval GetTermInterval(CaseTermStates mask) {
               var result = new CaseTermInterval();
               /* Создает EntitySchemaQuery-запрос. */
               var esq = new EntitySchemaQuery(UserConnection.EntitySchemaManager, "UsrServiceTerms");
               /* Добавляет колонки в запрос. */
               string reactionTimeUnitColumnName = esq.AddColumn("UsrReactionTimeUnit.Code").Name;
               string reactionTimeValueColumnName = esq.AddColumn("UsrReactionTimeValue").Name;
               string solutionTimeUnitColumnName = esq.AddColumn("UsrSolutionTimeUnit.Code").Name;
               string solutionTimeValueColumnName = esq.AddColumn("UsrSolutionTimeValue").Name;
               string calendarColumnName = esq.AddColumn("UsrCalendarId.Id").Name;
               /* Добавляет фильтры в запрос. */
               var esqFirstFilter = esq.CreateFilterWithParameters(FilterComparisonType.Equal, "UsrServiceItemId", _strategyData.ServiceItemId);
               var esqSecondFilter = esq.CreateFilterWithParameters(FilterComparisonType.Equal, "UsrServicePactId", _strategyData.ServicePactId);
               esq.Filters.Add(esqFirstFilter);
               esq.Filters.Add(esqSecondFilter);
               /* Выполняет и обрабатывает результаты запроса. */
               EntityCollection entityCollection = esq.GetEntityCollection(UserConnection);
               if (entityCollection.IsNotEmpty()) {
                   /* Добавляет к возвращаемому значению время реакции. */
                   if (!mask.HasFlag(CaseTermStates.ContainsResponse)) {
                       result.ResponseTerm = new TimeTerm {
                           Type = entityCollection[0].GetTypedColumnValue<CalendarsTimeUnit>(reactionTimeUnitColumnName),
                           Value = entityCollection[0].GetTypedColumnValue<int>(reactionTimeValueColumnName),
                           CalendarId = entityCollection[0].GetTypedColumnValue<Guid>(calendarColumnName)
                       };
                   }
                   /* Добавляет к возвращаемому значению время разрешения. */
                   if (!mask.HasFlag(CaseTermStates.ContainsResolve)) {
                       result.ResolveTerm = new TimeTerm {
                           Type = entityCollection[0].GetTypedColumnValue<CalendarsTimeUnit>(solutionTimeUnitColumnName),
                           Value = entityCollection[0].GetTypedColumnValue<int>(solutionTimeValueColumnName),
                           CalendarId = entityCollection[0].GetTypedColumnValue<Guid>(calendarColumnName)
                       };
                   }
               }
               return result;
           }
       }
   }

5. На панели инструментов дизайнера исходного кода нажмите [ Сохранить ] ([ Save ]) для временного сохранения изменений в метаданных схемы.
6. На панели инструментов дизайнера исходного кода нажмите [ Опубликовать ] ([ Publish ]) для выполнения изменений на уровне базы данных.

4. Подключить пользовательское правило расчета сроков 

1. Перейдите в дизайнер системы по кнопке . В блоке [ Настройка системы ] ([ System setup ]) перейдите по ссылке [ Справочники ] ([ Lookups ]).
2. Откройте справочник [ Правила расчета сроков по обращениям ] ([ Case deadline calculation schemas ]).

3. На панели инструментов страницы настройки справочника нажмите [ Добавить ] ([ New ]) и заполните значения полей справочника:

   • [ Название ] ([ Name ]) — "Стратегия для 78 — Elite Systems" ("Strategy for 78 — Elite Systems").
   • [ Обработчик ] ([ Handler ]) — "Terrasoft.Configuration.UsrServiceTermsStrategy".
   • Установите признак [ По умолчанию ] ([ Default ]).
   

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

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

1. Перейдите в рабочее место [ Сервис ] ([ Service ]).
2. Создайте обращение. Для этого воспользуйтесь инструкцией, которая приведена в статье Создать обращение.
3. В поле [ Контрагент ] ([ Account ]) выберите "Elite Systems".
4. В поле [ Сервис ] ([ Service ]) выберите "Восстановление утерянных данных" ("Lost data recovery").

В результате выполнения примера на страницу обращения добавлено пользовательское правило для расчета временных параметров обращений. Время реакции (т. е. значение поля [ Время реакции ] ([ Response time ])) — 2 часа. Время разрешения (т. е. значение поля [ Время разрешения ] ([ Resolution time ])) — 1 рабочий день.