Skip to content


Repository files navigation

Process to Text (P2T)

This webservice is used to translate a petrinet into plain text.

Live demo

URL Description Embedded UI Swagger UI

Related repositories

URL Description Text2Process Webservice WoPeD-Client


URL Description Docker Hub

Requirements for development

  • IDE of your choice
  • Java 11

Configuration guide

It is recommended to use IntelliJ IDE.

  1. Git clone this project onto your machine.
  2. Start IntelliJ and open the project.
  3. Wait until all files have been loaded.
  4. Run Application with the Start-Button or with mvn spring-boot:run


Testing via Swagger UI

  1. Start the application.
  2. Navigate to http://localhost:8080/p2t/swagger-ui.
  3. Paste your petrinet (the content of the xml file) in the body of the POST /p2t/generateText endpoint.

Testing via the embedded GUI

  1. Start the application.
  2. Navigate to http://localhost:8080/p2t/.
  3. Paste your petrinet (the content of the xml file) in the first text area and submit the form.

Testing with Postman

  1. Add a new collection in Postman.
  2. Add a new request in your created collection.
  3. For your request change Get to Post.
  4. Enter URL http://localhost:8080/p2t/generateText
  5. Open the body configuration and choose raw.
  6. Copy the content of a .pnml file (must be a sound petrinet) in the body of the request.
  7. Click send button

Testing via the WoPeD-Client

  1. Start the application.
  2. Follow the installation instructions of the WoPeD-Client (
  3. Start WoPeD-Client and.
  4. Open the configuration and navigate to NLP Tools. Adapt the Process2Text configuration:
    • Server host: localhost
    • Port: 8080
    • URI: /p2t
  5. Test your configuration.
  6. Close the configuration and import or create a new petrinet.
  7. Navigate to Analyse -> Translate to text and execute. The petrinet will now be transformed by your locally started P2T webservice.

Hosting the webservice yourself

Option 1: Use our pre-build docker image

  1. Pull our pre-build docker image from docker hub (see above).
  2. Run this image on your server.

Option 2: Build the docker image yourself

  1. Build your own docker image with the Dockerfile.
  2. Run this image on your server.


This repository uses jars that are unavailable on Maven central. Hence, these jar files are stored in this repository in the folder lib. The chosen procedure was described in this SO answer.


To check the formatting of all Java files, run mvn spotless:check.
If formatting are identified, run mvn spotless:apply to automatically reformat that affected files.