GST 4.00 upgrade guide
Review when migrating to Genero Studio 4.00.
This is an incremental upgrade guide that covers only topics related to the Genero Studio version specified in the page title. Check prior upgrade guides if you migrate from an earlier version. Make sure to also read about the new features for this version.
Corresponding new features page: GST 4.00 new features.
Report design documents
Update report design documents (.4rp) to the current version by using the gsreport command line utility. For further information, see Update report design documents to the current version.
Business records
In Genero Studio 3.20 and earlier, the business record relationship was defined by the primaryFields and foreignFields properties. These properties have been replaced in GST 4.00 by the whereParameters property.
Code Editor and remote configuration
In Genero Studio 3.20 and earlier, Code Editor compiled the edited file locally even when using a remote configuration. Starting with 4.00, with a remote configuration, Code Editor compiles the edited file using the remote server.
To use a local compilation process in remote configuration, select the Optimize for slow network checkbox in the General Preferences.
Hiding specific document error messages
You may notice new warning and informational messages display in the Document Errors tab. You can configure Genero Studio to hide these messages from the display. For more information, see Messages configuration.
Filters return to Genero Studio Help
The ability to filter by manual was removed in the Help for Genero Studio 4.00.01 (EAP1). Filters have been reinstated in Genero Studio 4.00.02 (EAP2). See Genero Studio Help.
Report Writer drag-and-drop behavior
Prior to Genero Studio 4.00.03, it was not possible to drag and drop a report element from one parent to another parent in the main work area. If the element was moved within the parent, the element's alignment might change (for example, dragging an element downward might change the Alignment property from near to far).
From Genero Studio 4.00.03 onward, elements can be moved from one parent to another by drag and drop, and dropping the element in another location does not change its alignment.
Template 2.3x desupported
Template 2.3x is desupported from Genero Studio 4.00 onward.
Changes in earlier versions
Make sure to check the upgrade notes of earlier versions, to not miss changes introduced in maintenance releases. For more details, see GST 3.20 upgrade guide.