---

Agile Test Automation Framework (ATAF)

Documentation

• Published developer handbook (GitHub Pages root): https://it-at-m.github.io/agile-test-automation-framework/
• Releases (used in place of an in-repo changelog): github.com/it-at-m/agile-test-automation-framework/releases
• Maven coordinates: de.muenchen.ataf:{core,rest,web}:0.3.4 on Maven Central (after the next release)

Creating a release

1. Open the Actions tab and select Release Maven.
2. Use 0.3.4 as the releaseVersion.
3. Use 0.3.5-SNAPSHOT as the developmentVersion.
4. Run the workflow (signs and deploys to Maven Central; may open a follow-up PR for the next snapshot).

Details: Releases handbook.

About ATAF

The Agile Test Automation Framework (ATAF) is a Java 21 framework for Cucumber-based BDD tests and traditional TestNG/JUnit test suites, with optional Jira/Xray integration. It is designed for agile projects: fast setup, maintainable test automation, and integration into modern development workflows. In addition to browser-based and API testing, it provides hooks for managing test executions in Jira and Xray.

The framework was developed in 2023–2024 to support the first iteration of the ZMS / eAppointment project of the Landeshauptstadt München and is today used in the zmsautomation test suite as well as other Munich projects. It was built primarily by colleagues from digital@M for use at it@M.

It provides:

• Support for both BDD testing with Cucumber and traditional test cases with TestNG and JUnit
• Seamless integration with popular testing libraries
• Easy-to-configure runners for TestNG and JUnit
• Integration with Jira and Xray using their existing REST APIs for test management

For prerequisites, installation, writing and running tests, property files, supported webdrivers, reporting, and the full project history see the handbook.

Contact

Overview

Munich contact: it@M – opensource@muenchen.de

ATAF was built primarily by colleagues from digital@M for use at it@M, the IT service provider of the Landeshauptstadt München.

---

Über ATAF

Das Agile Test Automation Framework (ATAF) ist ein Java-21-Framework für Cucumber-basierte BDD-Tests und klassische TestNG/JUnit-Testsuites mit optionaler Jira-/Xray-Anbindung. Es wurde für agile Projekte entworfen: schnelle Einrichtung, wartbare Testautomatisierung und Integration in moderne Entwicklungs-Workflows. Neben Browser- und API-Tests bietet es Hooks für die Verwaltung von Testausführungen in Jira und Xray.

Das Framework wurde 2023–2024 entwickelt, um die erste Iteration des ZMS-/eAppointment-Projekts der Landeshauptstadt München zu unterstützen, und wird heute in der zmsautomation-Testsuite sowie weiteren Münchner Projekten eingesetzt. Es wurde überwiegend von Kolleg:innen aus digital@M für den Einsatz bei it@M entwickelt.

Es bietet:

• Unterstützung sowohl für BDD-Tests mit Cucumber als auch für klassische Testfälle mit TestNG und JUnit
• Nahtlose Integration in verbreitete Test-Bibliotheken
• Einfach konfigurierbare Runner für TestNG und JUnit
• Anbindung an Jira und Xray über deren REST-APIs für das Testmanagement

Voraussetzungen, Installation, Tests schreiben und ausführen, Property-Dateien, unterstützte Webdriver, Reporting und die vollständige Projektgeschichte stehen im Handbuch.

Kontakt

Übersicht

Münchner Kontakt: it@M – opensource@muenchen.de

ATAF wurde überwiegend von Kolleg:innen aus digital@M für den Einsatz bei it@M, dem IT-Dienstleister der Landeshauptstadt München, entwickelt.

Dokumentation (Deutsch)

• Veröffentlichtes Entwicklerhandbuch (GitHub Pages, deutsche Version): https://it-at-m.github.io/agile-test-automation-framework/de/
• Releases (ersetzt einen Changelog im Repository): github.com/it-at-m/agile-test-automation-framework/releases
• Maven-Koordinaten: de.muenchen.ataf:{core,rest,web}:0.3.4 auf Maven Central (nach dem nächsten Release)

Release erstellen

1. In GitHub den Reiter Actions öffnen und Release Maven wählen.
2. 0.3.4 als releaseVersion verwenden.
3. 0.3.5-SNAPSHOT als developmentVersion verwenden.
4. Workflow starten (signiert und veröffentlicht auf Maven Central; ggf. Follow-up-PR für den nächsten Snapshot).

Details: Releases-Handbuch.

(back to top)