xUnitFor1C Documentation

The xUnitFor1C toolset consists of the following main components:

• xddTestRunner.epf: The core test runner and browser. It is designed to execute tests for both Ordinary (Thick Client) and Managed (Thin Client) 1C:Enterprise 8 applications.
• Tests/: A directory containing test examples and self-tests used to verify the functionality of xddTestRunner.epf (located in the selftests subfolder).

Specific test examples provided in the repository include:

• Form Opening Tests: Tests\CommonApp\тесты_ОткрытиеФормКонфигурации.epf tests the opening of all forms for Catalogs, Documents, Reports, and Data Processors. For Catalogs and Documents, it creates, copies, or overwrites elements within a transaction.
• Permission/Session Tests: Tests\CommonApp\Тест_ЗапускТестовВСеансеДругихПользователей.epf demonstrates running tests for users with limited rights. Users are created on-the-fly from simple templates.
• Report Comparison Tests: Tests\CommonApp\Тест_ПроверитьОтчетНаСоответствиеЭталону.epf demonstrates how to test a report by comparing its output against an expected template.

Handle Subordinate Catalogs

If a subordinate catalog requires an explicit owner (when multiple owners are possible), specify the owner type in the Подчиненные section of the Справочники configuration.

{
    "smoke": {
        "Справочники": {
            "Подчиненные": {
                "БанковскиеСчета": "Контрагенты"
            }
        }
    }
}

Set default values for new objects (ЗначенияРеквизитовНовых)

To ensure forms can open when certain mandatory fields are required, you can define default values for attributes of newly created objects.

• Simple types: Boolean, String, Number, DateTime are passed directly.
• Reference types (CatalogRef):
  • Enums: Use the name of the enum value as defined in metadata.
  • Catalogs: A new element will be created using the provided string as its name.

{
    "smoke": {
        "Справочники": {
            "ЗначенияРеквизитовНовых": {
                "Номенклатура": {
                    "ВестиУчетПоСериям": true,
                    "ВестиУчетПоХарактеристикам": true
                },
                "СотрудникиОрганизаций": {
                    "Физлицо": "Тестовое физлицо"
                }
            }
        }
    }
}

You can support the project in several ways:

1. Usage and Feedback: If you develop on 1C:Enterprise 8, try using xUnitFor1C for your testing. Report bugs or suggest features using the GitHub issue tracker.
2. Code Contributions: If you are familiar with the source code, you can pick up one of the open issues to implement.
3. Writing Articles: If you use xUnitFor1C in practice, consider writing an article about it (e.g., on Infostart).

For detailed technical instructions on how to contribute to the code, refer to the Contributor Guide.

For versions 4.1.X.X and higher, smoke tests are configured using a json file. The file must contain a single root object with the key smoke.

Loading the configuration

• Interactive mode: Use the "Load settings from file" (Загрузить настройки из файла) command in the "Load tests" (Загрузить тесты) menu. This must be done before loading the smoke tests themselves. If tests are already loaded, you must reload them after loading the settings.
• Command line: Pass the path to the configuration file using the xddConfig parameter within the /Execute argument.

Example Command Line Invocation (Batch/CMD)

@echo off

set XDD_IBaseConn=Srvr="main:2841";Ref="test_ibase";
set XDD_IBaseUser="Администратор"
set XDD_IBasePass=""

rem Paths to executable directories
set XDD_V8Bin=C:\Program Files (x86)\1cv82\8.2.19.130\bin
set XDD_xUnitDir=W:\xUnitFor1C

"%XDD_V8Bin%\1cv8.exe" ENTERPRISE /IBConnectionString %XDD_IBaseConn% /N %XDD_IBaseUser% /P %XDD_IBasePass% /RunModeOrdinaryApplication /Execute "%XDD_xUnitDir%\bin\xddTestRunner.epf" /C "xddConfig ""W:\\smoke.json"""; xddRun ЗагрузчикФайла ""%XDD_xUnitDir%\bin\Tests\Smoke\тесты_ОткрытиеФормКонфигурации.epf""";