tia-testsuite

name	tia-testsuite
description	TIA Portal TestSuite and Application Test operations. Use for managing test sets, application tests, style guide rules, and automated system testing workflows.
license	MIT

TIA Portal TestSuite — Automated Testing

Scope

Automated testing using the TIA Portal TestSuite Openness API. Covers Application Tests (PLC-based), Style Guide (Static analysis), and System Tests (OPC UA based).

---

Reference files

Load ONLY the reference file(s) relevant to the task. Do not load all files at once.

Reference file	Load when the task involves
references/application-test.md	Managing PLC Application Test sets, groups, and cases; executing tests on simulation.
references/style-guide.md	Managing and executing Style Guide rule sets; updating rule set files.
references/system-test.md	Managing System Test cases; OPC UA server interface validation.
references/test-results.md	Accessing and interpreting TestSuite service results and execution states.

---

Key Workflows

Application Testing

1. Locate the TestSuiteService on the Project.
2. Access ApplicationTestSets composition.
3. Manage ApplicationTestSet and TestCase objects.
4. Execute tests via TestCaseExecutor.

Style Guide

1. Access StyleGuideSystemGroups on the TestSuiteService.
2. Manage RuleSet objects and compositions.
3. Execute checks via RuleSetExecutor.

System Testing

1. Access SystemTestSystemGroups on the TestSuiteService.
2. Manage SystemTestCase objects.
3. Execute tests via SystemTestCaseExecutor.

Enforcement

1. Verify the existence of the target PLC software or OPC UA server before running tests.
2. Properly handle test failures using the TestResults and TestResultsMessage properties.