At WorkWithPlus we are strongly committed to bringing the full power of WorkWithPlus to the next step in GeneXus evolution: GeneXus Next.
As we work in migrating our products to this new environment, we would like to share with our community our progress, so we can so we can advance together into GeneXus Next.
You will find instructions on how to set up WorkWithPlus in GeneXus Next below, and also, we will include a section showing our progress and limitations on our first Beta versions.
WorkWithPlus for GeneXus Next is currently available in a timed-limited BETA.
Timed-beta means WorkWithPlus for GeneXus Next will stop working after 60 days of it's released date.
We strongly recommend NOT using this version for production purposes.
WorkWithPlus can only be used in "GeneXus Next Desktop IDE".
We recommend using the latest version available in GeneXus Download Center.
Minimum version is the version released on April 3rd, 2025:
- CORE-bl: 185394 (1.0.928)
- UI: 785 (0.0.785)
WorkWithPlus also requires internet access to the following URL:
- https://workwithplus-next.s3.us-east-1.amazonaws.com/webui/latest/
First, start by setting up GeneXus Next by following GeneXus instructions: https://wiki.genexus.com/commwiki/wiki?48854
Once you can successfully:
- Launch GeneXus Next
- Create Knowledge Base
- Build the Knowledge Base
You can proceed to install WorkWithPlus.
To download WorkWithPlus - GeneXus Next Edition beta go to our developer site, and filter by the word "next" and with GeneXus version set to "all"
https://developer.workwithplus.com/downloads
WorkWithPlus is currently being distributed as a ".zip" file, which contains necessary resources, and a script with the installation instructions (currently only for Windows environment)
- Add WorkWithPlus files to GeneXus Next installation (only needed once)
- GeneXus must be stopped for this part. If it is running, please, stop GeneXus Next using the "ddown" script.
- Download WorkWithPlus for GeneXus Next setup files.
- Unzip the contents of the file. You will need this files each time you start GeneXus, so it is advisable to put the files inside GeneXus Next installation folder.
- Modify GeneXus Next "docker-compose.yml" file (details on this below).
- Start GeneXus Next with WorkWithPlus
- Start GeneXus Next using the "dup" script.
- Run the script "WorkWithPlus_Next_Docker_Deploy.bat"
- Refresh GeneXus Next UI in your browser (do not use the 'reconnect' option)
Important:
- WorkWithPlus installation script will restart GeneXus Next once finished. Please, be careful if you have any unsaved work.
- After you build your Knowledge Base for the first time, you will need to manually copy the user controls to the build folder. Please check the known limitations section.
- Each time you stop GeneXus using the "ddown" script, WorkWithPlus will be uninstalled. Therefore, you will have to execute the installation script the next time you start GeneXus (step 2).
In order to make WorkWithPlus available in GeneXus next, you must set an environment variable within GeneXus UI docker container.
The easiest way to achieve this, is to modify GeneXus Next "docker-compose.yml" file.
This file can be found in the GeneXus Next installation directory (same directory where "dup" and "ddown" scripts are located).
Edit the file and locate the section where the "gxweb" container is declared, and add the following environment variable: "GX_IDE_CONFIG_PATH: /app/config.json"
The resulting section should look like:
gxweb:
environment:
GX_IDE_CONFIG_PATH: /app/config.json
depends_on:
- gxms
image: ${GXWEB_IDE_IMAGE:-genexus/next-webui}:${GXWEB_IDE_VERSION:-0.0.785}
Important: In the "docker-compose.yml" file, indentation is important. You can get the following error if indentation is not correct:
yaml: line 73: did not find expected key
In that case, please fix spaces manually by comparing other sections of the "docker-compose.yml" file.
Although we do not provide scripts for Linux and mac environments, the commands in the script should be easily executed in any environment's command line, as they only involve coping files to the GeneXus docker container. Please note, the "docker" command has to be visible/accessible from your location (must be included in the PATH)
docker cp "./resources/packages/." genexus-gxms-1:app
docker cp "./resources/modules/." genexus-gxms-1:app/Modules
docker cp "./resources/usercontrols/." genexus-gxms-1:app/UserControls
docker cp "./resources/resources/." genexus-gxms-1:app/WorkWithPlus
docker cp "./resources/config.json" genexus-gxweb-1:app
After you successfully copied the files, you just need to restart GeneXus containers
docker restart genexus-gxms-1
docker restart genexus-gxweb-1
|