Пользовательские проверки выполняет ваше приложение, и через Api присылает в Zidium результат.
Прежде чем реализовывать пользовательскую проверку, посмотрите — нет ли такого функционала среди Системных проверок. Системные проверки использовать легче, для них не нужно писать никакого кода.
Подробнее о принципах работы проверок читайте в статье Проверки (принцип работы)
Для отправки пользовательской проверки используйте следующий код:
// Получим проверку, если её ещё нет, то проверка будет создана автоматически
var unitTest = component.GetOrCreateUnitTestControl("CookieTransportService.DataCollectionTest");
// Отправим проверку, актуальную 10 минут
unitTest.SendResult(UnitTestResult.Success, TimeSpan.FromMinutes(10), "Приложение работает нормально");
В этом примере предполагается, что вы уже получили и запомнили компонент в переменной component. Как это сделать, читайте в разделе Компоненты (How To).
Вы можете сохранить unitTest где-то в своём приложении, чтобы не получать проверку заново при каждой отправке результата.
Для создания или получения проверки выполните POST-запрос:
АдресВашегоСервисаApi/GetOrCreateUnitTest
{
"Token": {
"SecretKey": "caf508d2-XXXX-XXXX-XXXX-6a2ef73a2b49"
},
"Data": {
"ComponentId": "11111111-2222-3333-4444-555555555555",
"SystemName": "CookieTransportService.DataCollectionTest"}
}
Здесь:
В ответ возвратится сообщение следующего формата:
{
"Data": {
"Id": "c40b3723-7952-4592-a184-c62d890fa5aa",
"TypeId": "464993cf-a11b-44d3-bc55-2dd0d7f76b24",
"SystemName": "CookieTransportService.DataCollectionTest",
"DisplayName": "CookieTransportService.DataCollectionTest"
},
"Code": 10
}
Нужно убедиться, что Code равно 10, что означает успешное выполнение. Из ответа нужно взять и сохранить Id, это Id проверки, который потребуется на следующем шаге для отправки результата. Однажды получив Id проверки, вы можете сохранить его где-то в своём приложении, чтобы не получать проверку каждый раз при отправке результата.
Для отправки результата пользовательской проверки выполните POST-запрос:
АдресВашегоСервисаApi/SendUnitTestResult
{
"Token": {
"SecretKey": "caf508d2-XXXX-XXXX-XXXX-6a2ef73a2b49"
},
"Data": {
"UnitTestId": "c40b3723-7952-4592-a184-c62d890fa5aa",
"Result": "Success",
"Message": "Приложение работает нормально",
"ActualIntervalSeconds": 600
}
}
Здесь:
В примере мы задали интервал актуальности равным 10 минутам. Если в течении 10 минут Zidium не получит новый результат этой проверки от приложения, то будет считаться, что ваше приложение больше не работает правильно, и цвет проверки поменяется на красный. Если вы не хотите такого поведения, то можете указать заведомо большой интервал актуальности.
Подробнее о работе с проверками читайте в разделе Проверки.