# Запуск

Для запуска тестов необходимо запустить 1С:Предприятие с параметром `RunUnitTests`, при необходимости можно указать путь к файлу конфигурации запуска.

## Конфигурация запуска

Конфигурация настраивается в файле json и может иметь следующие параметры:

| Имя параметра     | Тип       | Значение по умолчанию | Описание                                                                                                     |
|-------------------|-----------|-----------------------|--------------------------------------------------------------------------------------------------------------|
| `filter`          | `Object`  | Object, смотрите ниже | Параметры фильтрации, поиска тестов                                                                          |
| `reportFormat`    | `String`  | `"jUnit"`             | Формат отчета о тестировании, возможные значения: `"jUnit"`, `"JSON"`                                        |
| `reportPath`      | `String`  | `""`                  | Путь к формируемому отчету, можно указать или каталог (в которому будет создан файл отчета) или путь к файлу |
| `closeAfterTests` | `Boolean` | `True`                | Признак закрытия 1С:Предприятие по завершению тестирования                                                   |
| `showReport`      | `Boolean` | `True`                | Открыть форму отчета завершению тестирования                                                                 |
| `logging`         | `Object`  | Смотрите ниже         | Параметры логирования, подробнее ниже                                                                        |

Параметры фильтрации:

| Имя параметра | Тип     | Значение по умолчанию | Описание                                                                                                                    |
|---------------|---------|-----------------------|-----------------------------------------------------------------------------------------------------------------------------|
| `extensions`  | `Array` | `["tests"]`           | Список имен расширений, из которых грузятся тесты                                                                           |
| `modules`     | `Array` | `Null`                | Список имен модулей, из которых грузятся тесты                                                                              |
| `tests`       | `Array` | `Null`                | Список полных путей к исполняемым тестам (`[имя модуля.имя теста]`) |
| `suites`      | `Array` | `Null`                | **Не реализованно.** Список имен тестовых наборов, которые будут запускаться                                                |
| `tags`        | `Array` | `Null`                | **Не реализованно.** Список тегов, которые будут запускаться                                                                |
| `contexts`    | `Array` | `Null`                | Список имен контекстов исполнения, в которых будут запускаться тесты                                  |
| `paths`       | `Array` | `Null`                | **Не реализованно.** Список полных путей к исполняемым тестам (`[имя модуля.имя теста|имя модуля.имя теста.имя контекста]`) |

Параметры логирования:

| Имя параметра | Тип       | Значение по умолчанию | Описание                                                            |
|---------------|-----------|-----------------------|---------------------------------------------------------------------|
| `file`        | `String`  | `""`                  | Путь к файлу лога                   |
| `enable`      | `Boolean` | `Null`                | Признак использования логирования. Если не указан, зависит от файла, если он указан - вкл, если не указан - выкл                     |
| `level`       | `String`  | `"debug"`             | Уровень детализации лога. Возможные значения: `"debug"`, `"info"`, `"error"` |

Примеры:

1. Запустить тесты из расширения `tests`, расположенные в модулях `МодульТестов1`, `МодульТестов2`, закрыть предприятие по завершении и сохранить отчет в формате `junit`

    ```JSON
    {
        "filter": {
            "modules": ["МодульТестов1", "МодульТестов2"]
        },
        "reportPath": "C:\\temp\\jUnit\\report.xml",
        "reportFormat": "jUnit",
        "closeAfterTests": true
    }
    ```

2. Запустить все тесты из расширения `YAXUNIT` и сохранить отчет файл `C:\temp\jUnit\report.xml`, остальные параметры будут установлены по умолчанию

    ```JSON
    {
        "filter": {
            "extensions": ["YAXUNIT"]
        },
        "reportPath": "C:\\temp\\jUnit\\report.xml"
    }
    ```

3. Запустить все тесты с выводом подробного лога в файл, сохранить отчет файл `C:\temp\jUnit\report.xml`

    ```JSON
    {
        "reportPath": "C:\\temp\\jUnit\\report.xml",
        "logging": {
            "file": "C:\\temp\\jUnit\\tests.log",
            "level": "debug"
        }
    }
    ```

## Строка запуска предприятия

`[путь к клиенту 1С] ENTERPRISE [Параметры подключения к ИБ] [Параметры авторизации] /C RunUnitTests=/путь/к/конфигурационному/файлу`

*После загрузки расширения в информационную базу необходимо отключить у него `безопасный режим` и `защиту от опасных действий`*

Пример:

`"C:\Program Files\1cv8\8.3.18.1698\bin\1cv8c.exe" ENTERPRISE /IBName MyInfoBase /N Admin /C RunUnitTests=C:\tmp\test-config.json`
  Запуск тестов в режиме тонкого клиента на информационной базе `MyInfoBase` под пользователем `Admin` по конфигурации указанной в файле `C:\tmp\test-config.json`