ПРИЛОЖЕНИЕ 4 91 Форма документа «Журнал регистрации работ»

97 ПРИЛОЖЕНИЕ 7

98 Технические аспекты интеграции СУЭ и СУИ

1. 
   Описание интерфейсов систем СУЭ и СУИ
   
   1. 
      Интерфейс системы СУЭ
      
      1. 
         Запросы к системе СУЭ, используемые при взаимодействии
         

2. 
   Поля запросов UpdateFKIncident
   

3. 
   Поля запросов CreateFKChange, UpdateFKChange
   

2. 
   Интерфейс системы СУИ
   
   1. 
      Запросы к системе СУИ, используемые при взаимодействии
      

2. 
   Поля запроса createIssue
   

3. 
   Поля запроса updateIssue
   

4. 
   Поля запроса addComment
   

1. 
   Поля запроса addBase64EncodedAttachmentsToIssue
   

   Поле в веб-сервисе	Тип	Комментарий
   in1	String	Номер заявки в СУИ
   in2	Array of String	Список имен вложенных файлов
   in3	Array of String	Массив содержимого вложенных файлов, закодированного в base64

1. 
   Сценарии
   
   1. 
      Сценарии взаимодействия при обработке Инцидентов
      

Рисунок . Схема взаимодействия СУЭ-СУИ при обработке инцидентов

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

• 
  Назначение Инцидента в СУЭ на команду специалистов Исполнителя;
  
• 
  Обновление Инцидента в СУЭ по изменениям соответствующей ему Заявки в СУИ;
  
• 
  Обновление Заявки в СУИ по изменениям соответствующего ей Инцидента в СУЭ;
  
• 
  Запрос дополнительной информации из СУИ в СУЭ;
  
• 
  Передача информации о решении Заявки из СУИ в СУЭ.
  

1. 
   Назначение Инцидента в СУЭ на команду специалистов Исполнителя
   

После сохранения Инцидента в системе СУЭ происходит передача данных в СУИ через запрос createIssue. Перечень передаваемых из СУЭ в систему СУИ полей приведен в таблице раздела 1.1 данного Приложения.

• 
  В СУИ регистрируется Заявка по поступившей из СУЭ информации;
  
• 
  При регистрации Заявки в СУИ ей присваивается уникальный код формата HD-99999;
  
• 
  Номер Заявки, зарегистрированной в СУИ, записывается в специальное поле Инцидента в СУЭ.
  

2. 
   Обновление Инцидента в СУЭ по изменениям соответствующей Заявки в СУИ
   

После изменения значимых полей Заявки СУИ происходит передача данных в Инцидент СУЭ через запрос UpdateFKIncident. Структура запроса приведена в 1.1.2. данного Приложения.

3. 
   Обновление Заявки в СУИ по изменениям соответствующего Инцидента в СУЭ
   

После изменения значимых полей в Инциденте СУЭ происходит передача данных в Заявку СУИ путем последовательного вызова запросов:

• 
  updateIssue;
  
• 
  addComment;
  
• 
  addBase64EncodedAttachmentsToIssue (при появлении новых вложенных файлов).
  

4. 
   Запрос дополнительной информации из СУИ в СУЭ
   

Вызывается запрос системы СУЭ UpdateFKIncident с передачей следующих полей:

5. 
   Предоставление в СУЭ дополнительной информации
   

Вызываются запросы системы СУИ с передачей следующих полей:

Запрос updateIssue:

Запрос addBase64EncodedAttachmentsToIssue:

6. 
   Передача информации о решении Заявки из СУИ в СУЭ
   

По завершении обработки Заявки в СУИ, необходимо передать информацию по решению в СУЭ. Для этого Заявка в СУИ переводиться в Статус соответствующий статусу «Решен» в СУЭ и в поле Решение фиксируется решение по Заявке. Перечень полей передаваемых в рамках данного взаимодействия приведен в таблице:

2. 
   Сценарии взаимодействия при обработке Ошибок ППО
   

Рисунок . Схема взаимодействия СУЭ-СУИ при обработке ошибок ППО

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

• 
  Назначение Инцидента являющегося Ошибкой ППО на команду специалистов Исполнителя;
  
• 
  Создание объектов Патч и Версия;
  
• 
  Передача информации о Патче из СУИ в СУЭ;
  
• 
  Фиксация в Заявке СУИ информации о связанных с ней обновлениях;
  
• 
  Обновление Изменения категории Патч в СУЭ;
  
• 
  Обработка Версии в СУИ;
  
• 
  Обработка Изменения (Версии) в СУЭ.
  

1. 
   Назначение Инцидента являющегося Ошибкой ППО на команду специалистов Исполнителя
   

2. 
   Создание объектов Патч и Версия
   

Обновления типа Патч должны создаваться в СУИ и затем посредством интеграции передаваться в СУЭ как объект Изменение с Категорией «Патч».

Обновления типа Версия создаются Исполнителем в системе СУИ, Изменения с Категорией «Версия» создаются Заказчиком в СУЭ самостоятельно на основании документа «План выпуска версий».

3. 
   Передача информации о Патче из СУИ в СУЭ
   

• 
  После регистрации обновления типа Патч в системе СУИ происходит передача данных в СУЭ для создания Изменения с категорией Патч. Перечень передаваемых из системы СУИ в СУЭ полей приведен в таблице раздела 1.1.3;
  
• 
  В СУЭ регистрируется Изменение с категорией Патч;
  
• 
  При регистрации Изменения с категорией Патч ему присваивается уникальный код – ID Изменения;
  
• 
  ID Изменения, зарегистрированного в СУЭ, записывается в специальное поле Обновления типа Патч в СУИ.
  

4. 
   Фиксация в Заявке СУИ информации о связанных с ней обновлениях
   

Заявка в системе СУИ, являющаяся Ошибкой ППО, обязательно должна быть привязана к Версии, в рамках которой она будет устранена. Номер Версии, к которой привязана Заявка СУИ, должен быть передан в поле [EsoVersion] объекта Заявка;

Заявка в системе СУИ, являющаяся Ошибкой ППО, может быть привязана к одному или нескольким Патчам, в рамках которых она будет устранена. ID Патчей, в которых данная Ошибка будет устранена, должны быть переданы в поле [EsoReferences] объекта Заявка;

Номера Патча(ей) должны передаваться в Инцидент СУЭ в виде массива значений.

5. 
   Обновление Изменения категории Патч в СУЭ
   

В обновлении типа Патч в СУИ должна быть зафиксирована информация о номере Версии в которую будет включен данный Патч. Номер Версии должен передаваться в Изменение категории Патч в СУЭ.

6. 
   Обработка Версии в СУИ
   

7. 
   Обработка Изменения (Версии) в СУЭ