Работа со SberWorks Meta

Авторизация в системе META.Hub

1. Перейдите на страницу авторизации.

Увеличить

2. В соответствующие поля введите логин и пароль для входа в систему.
3. Нажмите кнопку Войти.

Увеличить

Смена транспортного (временного) пароля

1. Перейдите на страницу авторизации в систему.
2. Введите логин и транспортный пароль.
3. В открывшейся форме заполните поля:

• текущий пароль — введите транспортный пароль, присвоенный администратором.
• новый пароль — введите новый пароль, отвечающий требованиям информационной безопасности:
  • длина не менее 8 символов;
  • пароль одновременно содержит цифры, специальные символы (! @ # $ % ^ & * ( ) _ + = -".), строчные и прописные буквы;
  • пароль не совпадает с текущим паролем и именем учётной записи (логином);
• новый пароль еще раз — введите новый пароль повторно;
• нажмите кнопку Сменить;
• на странице появится сообщение: «Пароль изменен. Войдите в систему с новым паролем».

Увеличить

ID Компонента (meta.componentId)

Увеличить

Увеличить

Увеличить

Работа с отчётами

1. Авторизуйтесь в системе.
2. Перейдите в раздел Отчёты.
   

   Увеличить

3. На открывшейся странице заполните параметры формирования отчета.
4. Нажмите кнопку Сформировать для формирования отчета или кнопку Очистить фильтр для очистки выбранных параметров.
5. Сформированный отчёт сохранится на ПК в папке Загрузки.

Увеличить

Работа с сервисом META.Mock

Увеличить

Увеличить

Увеличить

1. Перейдите на вкладку Проектные области.
2. Нажмите кнопку Добавить проектную область.
   

   Увеличить

3. В открывшейся форме Создание проектной области заполните все поля:

• В поле Имя введите название проектной области.
• В поле Описание введите описание проектной области.
• В поле Базовая url оставьте значение по умолчанию.
• В поле Пользователи введите логин пользователя проектной области (можно указать несколько пользователей для одной проектной области).
• В поле Эмуляция заглушки выберите тип эмуляции заглушки в представленной версии доступен только тип REST.
  

  Увеличить

Увеличить

1. Перейдите на вкладку Проектные области.
2. Нажмите кнопку Редактировать справа от нужной проектной области.
   

   Увеличить

3. В открывшейся форме Редактирование проектной области внесите изменения в необходимые поля.
   

   Увеличить

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

1. Перейдите на вкладку Проектные области.
2. Нажмите кнопку Удалить справа от нужной проектной области.
3. Подтвердите удаление в открывшемся окне. В результате проектная область будет удалена из списка.
   

   Увеличить

1. Перейдите на вкладку Проектные области.
2. Введите в строку поиска имя проектной области.
3. Нажмите Enter или нажмите кнопку Поиск.

1. На стартовой странице МЕТА.Mock выберите нужную проектную область.
2. Нажмите кнопку в правом верхнем углу страницы.
   

   Увеличить

3. Откроется страница Конфигурация транспорта проектной области. На странице представлены конфигурационные параметры выбранной проектной области (в представленной версии доступен только тип REST).
   

   Увеличить

• На странице выбранной проектной области в меню Добавить выберите пункт RESТ-эмуляция.
  

  Увеличить

• В результате откроется форма создания новой заглушки.
  

  Увеличить

• В открывшейся форме заполните поля:
  • В поле Наименование введите наименование заглушки;
  • В поле Endpoint URL введите значение, уникальное для REST-заглушек в выбранной проектной области (должно начинаться с символа "/"). Примечание: эти поля можно автоматически заполнить данными существующего REST API, выполнив его поиск в базе МЕТА через поле поиска.
  • Выберите HTTP-метод: GET (значение по умолчанию), POST, PUT, DELETE, PATCH.
  • Из списка Код ответа выберите одно из стандартных для HTTP-протокола значений, которое эмуляция должна возвращать в ответе на запрос (по умолчанию установлен код 200:ОК).
  • В средней части экранной формы на вкладках установите при необходимости значения необязательных параметров REST-эмуляции.
  • На вкладке Headers с помощью кнопки Добавить заголовок задайте заготовки, которые будет возвращать эмуляция в ответе. Управлять созданными заголовками (удалять, изменять, отключать) можно через Список заголовков.
  

  Увеличить

• На вкладке Cookies с помощью кнопки Добавить Cookie задайте параметры cookie, которые будет возвращать эмуляция в ответе. Управлять созданными cookie (удалять, изменять, отключать) можно через Список Cookies.
  

  Увеличить

• На вкладке Credentials установите полномочия на обращение к этой эмуляции.
• Если это не было сделано ранее для данной проектной области, задайте параметры авторизации: нажмите кнопку Администрирование и на открывшейся форме Список прав создайте пару логин/пароль.
  

  Увеличить

• После этого из созданного списка может выбран и сохранен произвольный перечень полномочий (пар логин/пароль) для текущей эмуляции. Впоследствии управлять полномочиями ранее созданной эмуляции (удалять или отключать) можно через вкладку Список Credentials.
  

  Увеличить

• В случае использования для этой эмуляции модели машинного обучения, на вкладке Machine Learning установите переключатель использовать ML в положение Включен и из раскрывающегося списка выберите необходимый ML-запрос, если он был ранее создан и прошел процедуру обучения модели.
• В случае использования переменных в тексте эмуляции, на вкладке Область переменных задайте (выберите из раскрывающегося списка) ранее созданную область переменных. Если область переменных не была определена, с этой же экранной формы перейдите к созданию новой области и описанию ее переменных.
• После этого из созданного списка может выбран и сохранен произвольный перечень полномочий (пар логин/пароль) для текущей эмуляции. Впоследствии управлять полномочиями ранее созданной эмуляции (удалять или отключать) можно через вкладку Credentials.
  

  Увеличить

• На вкладке События задайте Лимит запросов — ограничение на количество обращений к создаваемой заглушке в минуту и (или) в час. При превышении этих значений пользователь получит уведомление.
• На вкладке Прочее:
  • задайте таймаут для эмуляции задержки ответа;
  • определите видимость эмуляции (оставьте приватной и доступной только для пользователей текущей проектной области или сделайте публичной и разрешите просматривать и переиспользовать любым зарегистрированным пользователям);
  • включите или отключите сохраненную эмуляцию.
  

  Увеличить

• Выберите Тип шаблона:
  • Groovy;
  • Json;
  • Xml.
• Если в необязательных параметрах на вкладке Machine Learning переключатель использовать ML находится в положении Выключен, заполните поле Текст эмуляции.
  

  Увеличить

• Для создания новой заглушки нажмите кнопку Сохранить. Чтобы отменить создание, нажмите кнопку Отмена. Примечание: если одно или несколько полей формы создания новой заглушки будет не заполнено, под каждым пустым полем появится соответствующее сообщение.

Увеличить

Поиск API и генерация шаблона REST-заглушки

1. На странице выбранной проектной области в меню Добавить выберите пункт RESТ-эмуляция.
   

   Увеличить

Увеличить

2. В открывшейся форме заполните поля:
   • В поле Наименование введите наименование заглушки.
   • В поле поиска введите нужное значение.
   

   Увеличить

3. Из раскрывающегося списка с результатами поиска выберите необходимый метод API. На форме создания заглушки будут автоматически заполнены поля Endpoint URL и HTTP-метод.
4. В поле Тип шаблона выберите значение Json.
5. Для создания новой заглушки нажмите кнопку Сохранить. Чтобы отменить создание, нажмите кнопку Отмена.
6. В списке заглушек выбранной проектной области появится созданная заглушка.

Генерация REST-заглушки по спецификации OpenAPI v3

• На экранной форме Проектной области нажать кнопку Загрузить OAS3 и выбрать локальный файл спецификации (поддерживается спецификация в формате yaml или json).
  

  Увеличить

Использование Statefull в REST-заглушке

1. Пройдите авторизацию и перейдите на стартовую страницу META.Mock.
2. Создайте область переменных.
3. Выберите из доступных любую проектную область с включенным транспортом REST. Если для данного пользователя доступных проектных областей с включенным транспортом REST нет, оформите заявку на создание проектной области.
4. Нажмите кнопку Области переменных и перейдите к форме Список областей.
5. Нажмите кнопку Создать новую область. В открывшейся форме Создание области заполните следующие поля:
   • Наименование области — Демонстрационная область;
   • Описание — Демонстрационная область переменных.
6. Нажмите кнопку Добавить переменную.
   

   Увеличить

• Введите параметры переменной:
  • Имя — var01;
  • Тип — Строка;
  • Значение — 0;
  • Переключатель Константа — выкл;
  • Описание — Демонстрационная переменная.
  

  Увеличить

Увеличить

7. После завершения ввода переменных нажмите кнопку Сохранить. Отобразится форма Список областей с только что созданной областью переменных.
8. В этой же проектной области создайте новую REST-эмуляцию со следующими параметрами:
   • Наименование эмуляции — Тестовая заглушка REST 1;
   • Endpoint URL — /mock007;
   • HTTP-метод — GET;
   • Использовать ML — выкл;
   • Включить — вкл;
   • Тип шаблона — groovy;
   • Область переменных — Демонстрационная область.
9. Заполните поле Текст эмуляции следующим кодом:

10. На странице проектной области, в которой была создана REST-заглушка, нажмите кнопку для просмотра конфигурации транспорта проектной области. Откроется страница Конфигурация транспорта проектной области.
11. Скопируйте URL транспорта для REST-эмуляции.
12. Вставьте в адресную строку браузера скопированный URL транспорта, добавьте к нему Endpoint URL созданной REST-эмуляции (в данном примере это /mock007) и выполните HTTP-запрос. Браузер должен отобразить ответ эмуляции со значением переменной, добавленной на этапе создания области переменных.

Увеличить

Увеличить

Увеличить

Использование Groovy и FreeMarker в REST-заглушках

• механизмом формирования данных на основе скрипта на языке программирования Groovy, в том числе с использованием Spring Cloud Contract DSL Response;
• механизмом формирования данных при помощи движка шаблонов FreeMarker.

Использование Groovy в REST-эмуляциях

• query — Map<String, String> — query-параметры запроса;
• path — List — сегменты пути запроса, относительно базового url проектной области;
• headers — Map<String, String> — заголовки запроса;
• body — в зависимости от Content-Type — тело запроса, если Content-Type application/json — Map<String, Object>, String в ином случае response — ответ, содержащий:
  • response.headers — набор http-заголовков;
  • response.statusCode — http-status;
  • response.cookies — множество http-cookies.

Использование Spring Cloud Contract DSL Response в REST-эмуляциях

<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-contract-spec</artifactId>
<version>2.1.4.RELEASE</version> 
</dependency>

• body(...) - тело ответа;
• headers(...) - набор http-заголовков;
• status(...) - http status.

Использование FreeMarker в REST-эмуляциях

• request.query — Map<String, String> — query-параметры запроса;
• request.path — List<String> — сегменты пути запроса, относительно базового url проектной области;
• request.headers — Map<String, String> — заголовки запроса;
• request.body — Map<String, Object> — тело запроса, доступно в случае, если тело запроса имеет тип application/json.

count: emulation_url?count=3
{

"id": "${statics["java.util.UUID"].randomUUID().toString()}",

"result": {
"code": 200,
"message": "Ok",
"items": [
<#assign count = request.query['count']?number>
<#list 1..count as idx>
{
"index": ${idx},
"id": "${statics["java.util.UUID"].randomUUID().toString()}"
} <#if idx?is_last == false>,</#if>
</#list>]
}

<#assign countVar=someVariable?number>
<#assign countVar++>
<@saveVariables someVariable=countVar/>

{
"id": "${statics["java.util.UUID"].randomUUID().toString()}",
"result": {
"code": "OK",
"message": "Count from request ${count}",
<#assign countVal=count?number>
<#assign countVal++>
"updated": "Count after increment ${countVal}"
<@saveVariables count=countVal/>
}
}

История вызовов

1. На экранной форме проектной области нажмите кнопку История.
   

   Увеличить

2. На открывшейся экранной форме История представлен список записей об обращениях к эмуляциям, разделенный отдельно по каждому типу эмуляции (REST, MMT и КСШ/ESB).
3. Выберите запись (соответствующую интересующему вас) вызову по типу эмуляции и времени ее вызова.
   

   Увеличить

4. Нажмите на строку с выбранной записью — откроется форма со всеми параметрами вызова эмуляции и ее ответа.
   

   Увеличить

Увеличить

Увеличить

Увеличить

Увеличить

1. На стартовой странице МЕТА.Mock выберите из списка нужную заглушку.
2. Нажмите кнопку Редактировать справа от заглушки. Откроется карточка заглушки с доступными для редактирования полями.
   

   Увеличить

   

   Увеличить

3. Внесите необходимые изменения в значения полей.
4. Для сохранения изменений нажмите кнопку Сохранить. Чтобы отменить изменения, нажмите кнопку Отмена.

1. На стартовой странице МЕТА.Mock выберите из списка необходимую заглушку.
2. Нажмите кнопку Удалить справа от заглушки.
   

   Увеличить

3. Подтвердите удаление, нажав кнопку ОК в открывшейся форме.
   

   Увеличить

Увеличить