Using the provided Dev-image

We provide a ready-to-go image of a virtual machine, running Debian 12, for VirtualBox.

The machine is setup with all the required software and helper scripts, to enable development of custom codeunits.

Getting the image running

The image is build for VirtualBox, so install that.

Once you have the image downloaded, start the import wizard in VirtualBox (ctrl + i) and follow it.

Now you should be able to boot the VM. The username and password for the user is noted in the comment on the VM.

The machine includes the following programs:

• Firefox, to access the local Tomcat server
• NetBeans 11.3, to develop codeunits
• DBeaver CE 24, to access the local DB

Deploying codeunits

To deploy you code to the local Tomcat instance do the following:

1. build the project (right-click it in the project-browser on the left and select build)
2. copy the generated .jar file from /home/developer/NetBeansProjects/[ApplicationName]/dist to /mnt/sda/deploy
3. Clear the cache (open http://localhost:8080/app/service?CacheClear)

Debugging codeunits

Attach the NetBeans debugger to the local Tomat server:

Click "debug" in the top-left menu -> click "attach debugger" -> click "OK", the default settings should work

Add a breakpoint to you code and try to invoke it from the browser.

Updating the API and platform

To update the local environment to the latest version of the TS-API and TS Platform, open a terminal and execute the following commands.

updateAPI
ts -w app upgrade-alphaapp

You will be prompted to input the password for the user.