diff --git a/content/en/docs/releasenotes/workstation/_index.md b/content/en/docs/releasenotes/workstation/_index.md index e497733841b..a59236e6062 100644 --- a/content/en/docs/releasenotes/workstation/_index.md +++ b/content/en/docs/releasenotes/workstation/_index.md @@ -10,36 +10,76 @@ cascade: These release notes cover changes made to the [Mendix Workstation](/mendix-workstation/). +## 3.8.0 + +### Release date: June 18, 2026 + +### Workstation Management + +#### New Features + +* Workspace Usage Reports – You can now view detailed usage reports that show how Workstations are being used across your different workspaces and company. This helps you understand and optimize your Workstation deployment. +* Automated Usage Metrics Collection – Workstation Clients now automatically report their daily active usage to the server, tracking which stations were used and on which days. This data powers the new usage reports, giving you valuable insights without extra effort. +* Printer Device Support – We added full support for setting up and managing new printer device types directly within the Management UI. This expands the range of peripherals you can integrate with your Workstations. +* Manual Bulk Configuration Push – A new **Sync Clients** button has been added to the station overview page, allowing you to manually sync client configurations for workstations that are out of sync. This provides a quick way to ensure all clients have the latest settings. +* Workspace Environment Types – Workspaces can now be assigned an environment type (Test, Acceptance, Production) when created, and this can be changed in the workspace settings. This helps you better organize and manage your different development and deployment stages. +* Serial Device Detection by pnpId – We added support for detecting serial devices using their pnpId. This provides another robust method for reliably identifying and connecting to serial devices. + +#### Improvements + +* Streamlined Station Detail Page – The station detail page UI has been improved by making options like **detect card reader** and **dev mode edit** less prominent. This declutters the interface and highlights the most frequently used settings. + +### Workstation Client + +#### New Features + +* Printer Device Support – The Workstation Client now fully supports the new printer device type. This means your Workstation Clients can seamlessly interact with configured printers. + + {{% alert color="info" %}}Only raw text and label printers are supported.{{% /alert %}} + +* New Diagnostics Page – A new Diagnostics page is available on the Client (when developer mode is enabled). This page displays crucial information like available printers, serial ports, card readers, credentials, station configuration, system info, and log levels, making troubleshooting much easier. +* Serial Device Detection by pnpId – The client now supports detecting serial devices using their pnpId. This enhances the reliability of connecting to serial devices, especially in environments where port assignments might change. + +#### Fixes + +* Studio Pro Login Blocked – Fixed an issue where the client blocked sign-in to Studio Pro when six or more devices were configured, due to an overlap in port usage. Studio Pro users can now sign in without issues, regardless of the number of configured devices. + +### Workstation Connector + +#### Improvements + +* Improved Get/Create Device Action – The `Get/Create Device` action now returns an empty object instead of throwing an error when no matching device is found. This makes your custom integrations more robust and prevents unexpected crashes. + ## 3.7.0 ### Release date: May 21, 2026 ### Workstation Management -#### New features +#### New Features -* Smart configuration updates (auto-refresh) - You can now choose if your workstation configurations should automatically update when changes are made, or if you prefer to trigger updates manually. This gives you more control and ensures your workstations always have the correct settings with less effort. -* Real-time workstation status - The Workstation Management UI now shows the live configuration status of each Workstation Client, letting you quickly see if a workstation is **Up to Date** or **Outdated**. This provides immediate insight into your deployment's health. -* Enhanced Serial Device detection settings - You can now configure Workstation Management to identify your serial devices using more reliable information like their Friendly Name, Serial Number, or Manufacturer. This helps your Workstation Clients reliably find and connect to the correct serial device, even if its port number changes. +* Smart configuration updates (auto-refresh) – You can now choose if your workstation configurations should automatically update when changes are made, or if you prefer to trigger updates manually. This gives you more control and ensures your workstations always have the correct settings with less effort. +* Real-time workstation status – The Workstation Management UI now shows the live configuration status of each Workstation Client, letting you quickly see if a workstation is **Up to Date** or **Outdated**. This provides immediate insight into your deployment's health. +* Enhanced Serial Device detection settings – You can now configure Workstation Management to identify your serial devices using more reliable information like their Friendly Name, Serial Number, or Manufacturer. This helps your Workstation Clients reliably find and connect to the correct serial device, even if its port number changes. #### Improvements -* Configurable auto-refresh behavior - We have provided options for how auto-refresh works, including default settings for workspaces and how clients respond in both automatic and manual modes. This allows for flexible management of your workstation configurations. +* Configurable auto-refresh behavior – We have provided options for how auto-refresh works, including default settings for workspaces and how clients respond in both automatic and manual modes. This allows for flexible management of your workstation configurations. -#### Bug Fixes +#### Fixes -* UI inconsistencies - We have fixed several visual inconsistencies in the Management UI, particularly improving the display and user experience when using dark mode. This makes the interface cleaner and more consistent for everyone. +* UI inconsistencies – We have fixed several visual inconsistencies in the Management UI, particularly improving the display and user experience when using dark mode. This makes the interface cleaner and more consistent for everyone. ### Workstation Client #### New Features -* Automatic Client startup - The Workstation Client application now automatically launches silently in the background when your system starts up. This ensures your workstations are always ready to go without needing manual intervention after a reboot. -* Smart Serial Device finder - The client can now use the Friendly Name, Serial Number, or Manufacturer to find and connect to serial devices. This means your client can reliably connect to the right device even if its assigned port changes. +* Automatic Client startup – The Workstation Client application now automatically launches silently in the background when your system starts up. This ensures your workstations are always ready to go without needing manual intervention after a reboot. +* Smart Serial Device finder – The client can now use the Friendly Name, Serial Number, or Manufacturer to find and connect to serial devices. This means your client can reliably connect to the right device even if its assigned port changes. #### Improvements -* Granular configuration change response - The client now handles configuration changes more smoothly and with less downtime. This means your stations will experience fewer interruptions and apply new settings more efficiently. +* Granular configuration change response – The client now handles configuration changes more smoothly and with less downtime. This means your stations will experience fewer interruptions and apply new settings more efficiently. ## 3.6.1 @@ -110,9 +150,9 @@ For more information, see [Nanoflows](/mendix-workstation/build-app/#javascript- * We have deprecated the following actions: - * `SendMessage` - Deprecated in favor of `SendDeviceMessage` and `WaitForDeviceMessage` - * `SubscribeToMessages` - Deprecated in favor of `GetCreateDevice` - * `SubscribeToErrors` - Deprecated in favor of `GetCreateDevice` + * `SendMessage` – Deprecated in favor of `SendDeviceMessage` and `WaitForDeviceMessage` + * `SubscribeToMessages` – Deprecated in favor of `GetCreateDevice` + * `SubscribeToErrors` – Deprecated in favor of `GetCreateDevice` The deprecated actions are longer exposed as nanoflows and have been moved to the `_USE_ME/Deprecated` folder. @@ -124,21 +164,21 @@ For more information, see [Nanoflows](/mendix-workstation/build-app/#javascript- #### New Features -* Updated access controls for Computer Admin role - The Computer Admin role now has updated access permissions, allowing them only to read and view existing bulk registration tokens and their associated details. +* Updated access controls for Computer Admin role – The Computer Admin role now has updated access permissions, allowing them only to read and view existing bulk registration tokens and their associated details. -* Improved UI for bulk registration token management - We have updated the user interface for managing bulk registration tokens, enhancing the overall user experience and making it more intuitive to work with. +* Improved UI for bulk registration token management – We have updated the user interface for managing bulk registration tokens, enhancing the overall user experience and making it more intuitive to work with. #### Fixes -* Unassigned computers excluded from station export - We have fixed an issue where unassigned computers were incorrectly included in station exports. Now, unassigned computers are no longer exportable as stations and will not appear in the list of stations available for download, ensuring cleaner and more accurate exports. +* Unassigned computers excluded from station export – We have fixed an issue where unassigned computers were incorrectly included in station exports. Now, unassigned computers are no longer exportable as stations and will not appear in the list of stations available for download, ensuring cleaner and more accurate exports. -* Duplicate station naming in single import - The single import behavior has been updated to accept duplicate names by automatically adding a numeric suffix when a station with the same name is imported, ensuring unique identification and smoother workflow. We have addressed an issue where empty stations were unintentionally created. +* Duplicate station naming in single import – The single import behavior has been updated to accept duplicate names by automatically adding a numeric suffix when a station with the same name is imported, ensuring unique identification and smoother workflow. We have addressed an issue where empty stations were unintentionally created. ### Workstation Client #### Fixes -* Robust remote deregistration error handling - We have fixed an issue where an uncaught error pop-up could occasionally appear if Workstation Management crashed immediately after a remote deregistration of a station. This ensures a more stable and resilient client experience. +* Robust remote deregistration error handling – We have fixed an issue where an uncaught error pop-up could occasionally appear if Workstation Management crashed immediately after a remote deregistration of a station. This ensures a more stable and resilient client experience. ## 3.4.0 @@ -148,43 +188,43 @@ For more information, see [Nanoflows](/mendix-workstation/build-app/#javascript- #### New Features -* Enhanced bulk registration process - We have improved the bulk registration experience to make managing multiple workstations even more efficient and intuitive. +* Enhanced bulk registration process – We have improved the bulk registration experience to make managing multiple workstations even more efficient and intuitive. - * New unassigned stations list - If a newly registered station cannot be automatically matched with a preconfigured station, it now appears in the new **Unassigned Stations** list. Before you can edit these unassigned stations, you must first either accept or manually assign them, giving you better control over station assignments. - * Code snippet copier - To simplify the registration process from the terminal, we have added a convenient code snippet copier, making the process quicker and less prone to errors. - * Reopenable registration token - You can now reopen and copy the registration token if you need to access it again after initial generation. - * Token expiration banner - A clear banner now displays if your registration token has expired, helping you stay informed and avoid registration issues. + * New unassigned stations list – If a newly registered station cannot be automatically matched with a preconfigured station, it now appears in the new **Unassigned Stations** list. Before you can edit these unassigned stations, you must first either accept or manually assign them, giving you better control over station assignments. + * Code snippet copier – To simplify the registration process from the terminal, we have added a convenient code snippet copier, making the process quicker and less prone to errors. + * Reopenable registration token – You can now reopen and copy the registration token if you need to access it again after initial generation. + * Token expiration banner – A clear banner now displays if your registration token has expired, helping you stay informed and avoid registration issues. -* Advanced station import options - We have enhanced the station import process by providing more robust options for handling duplicate stations. When importing, you can now specify how you want to manage existing named stations. The following options are available: +* Advanced station import options – We have enhanced the station import process by providing more robust options for handling duplicate stations. When importing, you can now specify how you want to manage existing named stations. The following options are available: - * **Ignore** - Existing stations will not be updated or imported. - * **Duplicate** - A new station will be created with a suffix number. - * **Replace** - The existing station will be entirely replaced by the imported one. - * **Merge** - This option allows for a more granular approach. If you choose to merge, you can then decide whether to ignore, replace, or duplicate individual duplicate devices. + * **Ignore** – Existing stations will not be updated or imported. + * **Duplicate** – A new station will be created with a suffix number. + * **Replace** – The existing station will be entirely replaced by the imported one. + * **Merge** – This option allows for a more granular approach. If you choose to merge, you can then decide whether to ignore, replace, or duplicate individual duplicate devices. #### Fixes -* **Add Device Configuration** dialog stability - We have fixed a bug that was causing the **Add Device Configuration** dialog to close unexpectedly, ensuring a smoother configuration experience. -* Improved import summary UI - We have reworked the import summary UI for better usability and user experience, providing clearer and more intuitive feedback on your import operations. +* **Add Device Configuration** dialog stability – We have fixed a bug that was causing the **Add Device Configuration** dialog to close unexpectedly, ensuring a smoother configuration experience. +* Improved import summary UI – We have reworked the import summary UI for better usability and user experience, providing clearer and more intuitive feedback on your import operations. #### Known Bugs and Limitations -* Linux terminal registration errors - When registering clients from the terminal on Linux, users may encounter misleading error messages. Despite the error messages, the registration process itself is successful. -* Manual refresh required for UI updates - To display the most up-to-date information, you must currently refresh the token expiration banner and the unassigned stations list manually by using the **Refresh** button. +* Linux terminal registration errors – When registering clients from the terminal on Linux, users may encounter misleading error messages. Despite the error messages, the registration process itself is successful. +* Manual refresh required for UI updates – To display the most up-to-date information, you must currently refresh the token expiration banner and the unassigned stations list manually by using the **Refresh** button. ### Workstation Client #### New Features -* Automatic client reset on deregistration - To ensure a clean state and seamless management, the client now automatically resets itself when it is deregistered from Workstation Management. -* Improved handling of unknown computer status - When a computer is not matched to an available station, the client now displays a **Waiting** message, indicating that the system is awaiting configuration. +* Automatic client reset on deregistration – To ensure a clean state and seamless management, the client now automatically resets itself when it is deregistered from Workstation Management. +* Improved handling of unknown computer status – When a computer is not matched to an available station, the client now displays a **Waiting** message, indicating that the system is awaiting configuration. #### Fixes -* Uninstallation cleanup - We have resolved an issue where the *Mendix Workstation* folder was not being completely removed during uninstallation. This fix ensures a cleaner uninstallation process. -* Error handling for bulk registration - We have fixed an error that occurred when attempting to bulk re-register an unassigned station from PowerShell, leading to a more robust registration experience. -* Special character display in license agreements - We have fixed an issue that caused special characters to display incorrectly within the license agreement. All text is now rendered accurately. -* Flexible BLE characteristic matching - We have resolved an issue where BLE characteristics and services were case-sensitive and did not accept standard UUID formats. Now, BLE characteristics can be specified in uppercase and can contain dashes, providing greater flexibility and compatibility. For example, `EF680301-9B35-4933-9B10-52FFA9740042` will now be correctly recognized. +* Uninstallation cleanup – We have resolved an issue where the *Mendix Workstation* folder was not being completely removed during uninstallation. This fix ensures a cleaner uninstallation process. +* Error handling for bulk registration – We have fixed an error that occurred when attempting to bulk re-register an unassigned station from PowerShell, leading to a more robust registration experience. +* Special character display in license agreements – We have fixed an issue that caused special characters to display incorrectly within the license agreement. All text is now rendered accurately. +* Flexible BLE characteristic matching – We have resolved an issue where BLE characteristics and services were case-sensitive and did not accept standard UUID formats. Now, BLE characteristics can be specified in uppercase and can contain dashes, providing greater flexibility and compatibility. For example, `EF680301-9B35-4933-9B10-52FFA9740042` will now be correctly recognized. ## 3.3.0 @@ -194,25 +234,25 @@ For more information, see [Nanoflows](/mendix-workstation/build-app/#javascript- #### New Features -* Automatic suffixing for duplicate workstations - To make managing your workstations even smoother, we have implemented automatic suffixing for imported workstations that have duplicate names. This helps prevent naming conflicts and keeps your environment tidy. -* Feedback module replaced by the new Forum Space - We have removed the Feedback function in the Workstation Management. Don't worry, your voice is still incredibly important to us! Please share your questions, ideas, and feedback in the new dedicated [Mendix Forum Space for Mendix Workstation](https://community.mendix.com/link/spaces/mendix-workstation-client). This change will help us centralize discussions and provide better support. -* Special characters in Workspace names - You can now use special characters in your Workspace names, giving you more flexibility and personalization. -* Unique auto-accepted computer names - We have added a uniqueness validation to the **Auto-Accepted Computer Name** field used for bulk registration. This ensures that each computer name is distinct, preventing potential conflicts during the registration process. +* Automatic suffixing for duplicate workstations – To make managing your workstations even smoother, we have implemented automatic suffixing for imported workstations that have duplicate names. This helps prevent naming conflicts and keeps your environment tidy. +* Feedback module replaced by the new Forum Space – We have removed the Feedback function in the Workstation Management. Don't worry, your voice is still incredibly important to us! Please share your questions, ideas, and feedback in the new dedicated [Mendix Forum Space for Mendix Workstation](https://community.mendix.com/link/spaces/mendix-workstation-client). This change will help us centralize discussions and provide better support. +* Special characters in Workspace names – You can now use special characters in your Workspace names, giving you more flexibility and personalization. +* Unique auto-accepted computer names – We have added a uniqueness validation to the **Auto-Accepted Computer Name** field used for bulk registration. This ensures that each computer name is distinct, preventing potential conflicts during the registration process. #### Fixes -* Enhanced export and import experience - We have revised the UI for the import and export process for a better user experience. +* Enhanced export and import experience – We have revised the UI for the import and export process for a better user experience. * The **Select individual stations** dropdown has been reworked for better usability. * The **Import summary** now provides clearer insights into your import operations. -* Runtime error prevention - We have addressed and fixed several issues that were causing runtime errors, leading to a more stable experience. -* Duplicate application prevention during import - We have resolved a bug that caused applications to be duplicated when importing stations. Now, when importing stations that reference an application, the system checks for existing applications with the same identifying properties (like URL and Public Key). If an application already exists, it is reused, preventing unnecessary duplicates and ensuring a cleaner application registry. -* Input validation for station creation - We have fixed an issue in the station creation process where clicking **Continue** with an empty input field could lead to an error. The process is now more robust. +* Runtime error prevention – We have addressed and fixed several issues that were causing runtime errors, leading to a more stable experience. +* Duplicate application prevention during import – We have resolved a bug that caused applications to be duplicated when importing stations. Now, when importing stations that reference an application, the system checks for existing applications with the same identifying properties (like URL and Public Key). If an application already exists, it is reused, preventing unnecessary duplicates and ensuring a cleaner application registry. +* Input validation for station creation – We have fixed an issue in the station creation process where clicking **Continue** with an empty input field could lead to an error. The process is now more robust. ### Workstation Client #### Fixes -* File name emission for the file connector - We have resolved an issue where the file connector was not returning the changed file name when subscribing to file changes. Now, when you subscribe to a file path, the file connector correctly emits the specific file names on file change events, providing more precise information. +* File name emission for the file connector – We have resolved an issue where the file connector was not returning the changed file name when subscribing to file changes. Now, when you subscribe to a file path, the file connector correctly emits the specific file names on file change events, providing more precise information. ## 3.2.0 @@ -236,20 +276,20 @@ On the **Station** page, have added a new **Refresh Client** action. You can use #### Fixes -* Dark mode display - We have resolved some display issues which could occur when using Workstation Management in dark mode. -* Workspace sorting - We have corrected an issue affecting the sorting behavior of workspaces. -* Application configuration duplication - We have fixed a problem that could lead to users inadvertently creating duplicate application configurations by adding a space before or after the key or URL. +* Dark mode display – We have resolved some display issues which could occur when using Workstation Management in dark mode. +* Workspace sorting – We have corrected an issue affecting the sorting behavior of workspaces. +* Application configuration duplication – We have fixed a problem that could lead to users inadvertently creating duplicate application configurations by adding a space before or after the key or URL. #### Known Bugs and Limitations -* Importing duplicate app configurations - Attempting to import a configuration that includes applications already defined (for example, with an existing URL and Public Key) results in UI errors. +* Importing duplicate app configurations – Attempting to import a configuration that includes applications already defined (for example, with an existing URL and Public Key) results in UI errors. {{% alert color="info" %}} To work around this issue, you can can import the configuration by excluding the applications and then manually setting them up afterward. {{% /alert %}} -* Indistinguishable station duplicates - Importing the same station multiple times creates duplicates that are currently not distinguishable within the system. -* Duplicate application creation on import - When importing multiple stations that all use the same application, and applications are included in the import, the application is created multiple times (once for each station). +* Indistinguishable station duplicates – Importing the same station multiple times creates duplicates that are currently not distinguishable within the system. +* Duplicate application creation on import – When importing multiple stations that all use the same application, and applications are included in the import, the application is created multiple times (once for each station). ### Workstation Client @@ -265,14 +305,14 @@ The Workstation Client automatically resets on the next refresh when its associa #### Fixes and Other Changes -* Linux ARM64 executable name - For improved consistency, we have removed the spaces from the executable name of the Workstation Client (Linux ARM64 version). -* Bluetooth LE device discovery - We have addressed an issue where the discovery process for Bluetooth LE devices did not correctly recognize the full device name, which previously led to failed connection attempts. The Workstation Client now accurately matches Bluetooth BT advertisement names. +* Linux ARM64 executable name – For improved consistency, we have removed the spaces from the executable name of the Workstation Client (Linux ARM64 version). +* Bluetooth LE device discovery – We have addressed an issue where the discovery process for Bluetooth LE devices did not correctly recognize the full device name, which previously led to failed connection attempts. The Workstation Client now accurately matches Bluetooth BT advertisement names. ### Workstation Connector #### Fixes -* Refresh of the updated device list - We have fixed an issue where updates to the device list were not immediately sent to the web application after a configuration update, requiring a manual refresh. The list is now updated immediately. +* Refresh of the updated device list – We have fixed an issue where updates to the device list were not immediately sent to the web application after a configuration update, requiring a manual refresh. The list is now updated immediately. ## 3.1.0 @@ -416,7 +456,7 @@ The third pre-release of Mendix Workstation is available under the conditions of #### Workstation Management * The **Team** page enables users to share workspaces and assign individual permissions, facilitating collaborative deployment of Workstation projects across multiple environments and sites at scale. -* Apps are managed at workspace level on the **Apps** page. Each app can be enabled or disabled individually - per station, for a group of stations, or for all stations within a workspace. +* Apps are managed at workspace level on the **Apps** page. Each app can be enabled or disabled individually – per station, for a group of stations, or for all stations within a workspace. * App keys are generated from **Apps** and then copied into a workspace app, allowing a single instance of a deployed app to be used with multiple workspaces. * The **Test Your Station** page can be activated or deactivated on the **Settings** page. * Stations in a workspace can be grouped into a **Station Group**.