Release notes
Sep 26 2022
Sep 08 2022
Aug 23 2022
Aug 23, 2022,
FORMCYCLE 7.1.0
Features
- Support for WebDAV.
- This feature requires an appropriate license.
- The new backend menu Data, WebDAV connection lets you set up connections to a WebDAV server.
- The new workflow action Save to WebDAV server lets you transmit files to another system via the WebDAV protocol.
- New switch condition added to the workflow.
- Use the switch action to check a value against many multiple cases. For each case, you can then run different actions. Compared with existing yes/no conditions, the switch makes your workflow easier to read, especially when you have many cases. For example, if you have a select field selMartialStatus, you can use the switch condition to test the value against the possible options single, married, divorced, widowed, in a partnership.
- Automatic database and system updates when launching Xima® Formcycle
- Xima® Formcycle can now run all requires updates when it is started, so that you do not have to run a manual update anymore via the backend. This reduces the time it takes to update the system, and helps to avoid down times.
- For new installations, this feature is enabled by default.
- For existing installations, you can enable this feature in the backend via the menu System, Database.
- Login via Azure AD
- The backend menu External users (authenticators) now lets you retrieve users from an Azure AD.
- URL for monitoring the frontend server status
- Use the URL https://<domain>/<context>/monitor/fs/connection?name=MyFrontendServer to check whether the master is connected to a certain frontend server. You can also trigger a reconnection when the server is not connected.
- Due to security concerns, this URL is disabled by default. To enable it, you need to configure the application properties monitoring.enabled and monitoring.allowed.hosts.
- Support for internationalized email addresses and UTF-8 headers
- Xima® Formcycle can now send emails to internationalized email addresses such as 山田太郎＠株式.会社, provided the email server supports it.
- To enable support for internationalized email addresses, go to the system or client mail server settings and enable the option Server suppports UTF-8 message headers (RFC6532).
Changes
Backend
- To avoid issues when migrating data between different database systems, Xima® Formcycle now always treats all names case insensitiv. For example, when you have a client file named demo.txt, you cannot create a new file named Demo.txt anymore, even if your database supports it. No migration is required for existing systems that make use of such names. However, on the long term, we recommend you avoid these kind of name conflicts.
- Fixes issues with downloading forms from password protected form stores. Also, the form store is now always displayed in the correct language.
- If the hardware ID of a server has changed, when you attempt to update the license via the license menu page, a dialog shows up that lets you choose whether you want to register a new hardware ID or overwrite an existing one.
- You can now use callback links with URL parameters for external users (authenticator). This may be necessary when the identity provider does not allow URL parameters in the callback URL.
Inbox
- Previously, the inbox had only a predefined filter to display form records that arrived latest. It is now possible to filter form records to any modification range.
- The appointment view of the inbox now displays appointments faded out, when they belong to form records that are either saved or are waiting for a double opt-in.
- Improved the syntax of word fill functions. Parameters should now be enclosed in quotation marks. This lets you use arbitrary characters, including special characters. For example: selTrainPass.cb("1. class") oder selBookTitle.cb("The Final Odyssey is \"Comet Cowboy\"")
Workflow
- The actions Create text file and Export as XML now let you access the content of the created files via variables.
- The POST request of the old workflow now lets you add custom headers as well.
Frontend forms
- JQuery and JQuery UI were updated to the current version.
- The function $.xutil._load now also restores the number of element repetitions as well as the values of repeated elements.
- The data type email for input fields does not allow a dot at the end of email addresses anymore. Domain names may end on a dot to indicate that it is a fully qualified domain name. However, in practice, many common email providers do not allow such email addresses.
Form designer
- In the form designer it is possible to define for each form field in which status and for which user groups it should be available. If a form field is not available, the values are no longer displayed in the data table of the inbox anymore.
- You can now select the number of print export columns for select elements. You can find this option in the form designer in the tab Advanced (at the bottom in the panel Word and PDF export). When the number of columns is set to a value greater than 1, the select options are placed next to each other in columns when you create a Word or PDF export.
Fixes
Backend
- In full screen mode of the rich text editor, the button for the placeholder dialogue now works again.
- When you download a file in the backend, now always in a new browser tab to avoid losing the currently opened page.
- Several minor UI fixes.
Inbox
- Web Content Accessibility Guidelines (WCAG) conformity in the inbox has been improved.
- If there are multiple values for a form field, that values are all displayed in the data table of the inbox.
Workflow
- If an unhandled exception occurs in the new workflow, the error page now always appears. It doesn't matter that another response page has been defined in an action that has already been executed.
- LDAP workflow actions that use an existingLDAP query are executed correctly again.
- Fixed an issue where filling a form field in a Word document filling a form field in a Word document was sometimes not possible.
Frontend forms
- The session ID is now correctly forwarded when saving temporarily. In the case of forms with login, it was previously necessary to log in again after saving the form.
- The conformity of web forms to the German accessibility guidelines (Verordnung zur Schaffung barrierefreier Informationstechnik) has been improved..
Form designer
- The Word and PDF export feature now generates the correct Word function for creating checkboxes if used within repeated containers.
- Form fields can have conditions that control whether they are visible, required, or editable. Such a condition may also reference a hidden variable field. Server validation now validates such conditions correctly as well.
- If own HTML is entered in the rich text editor via the source code view in the form designer, this is now kept as far as possible and no longer cleaned up.
- Improvement regarding false positives in relation to bot detection.
For plugin developers
- PrimeFaces was update to version 11.
- Updated pac4j. Plugins that provide custom authenticators should be checked and may required adjustments.
- The builtin class PluginServletActionRetVal for the return value of servlet action plugin now contains constructors for all available parameters. Use of a custom implemenation of IPluginServletActionRetVal should be avoided, since these custom classes may not be available when communicating with a frontend server.
- The form preview in the form designer is now placed inside a shadow root. This improves the encapsulation of the designer CSS and the form CSS, and prevents custom form CSS from affecting the layout of the designer.
- As a consequence, widget plugins now also need to separate their CSS.
- IPluginFormElementWidget#getCssData has to return only the CSS required for the form layout.
- IPluginFormElementWidget#getCssDataForDesignerUi has to return only the CSS that is needed to style the form designer UI.
- @font-face rules need to be added outside the shadow root, not all browsers support @font-face within a shadow root yet (e.g. chromium)
- In addition, due to the shadow root, it is no longer possible to directly select elements in the form, starting at document context. If a widget plugin contains custom JavaScript for the designer that selects elements within the form preview, the JavaScript needs to be adjusted.
- The function IFormDesigner.getFormDesignPanel() can be used to access the element in which the form is located. Inside this element, it is now possible to search for child elements in the form. For example:
- As a consequence, widget plugins now also need to separate their CSS.
import { instance } from "@de-xima/fc-form-designer";
function main() {
// Instead of selecting elements directly from the global scope
$(".XTextField");
// Select elements starting from the form design panel
instance().getFormDesignPanel().find(".XTextField");
}
function main() {
// Instead of selecting elements directly from the global scope
$(".XTextField");
// Select elements starting from the form design panel
instance().getFormDesignPanel().find(".XTextField");
}
Checksummen
Jul 19 2022
Jun 24 2022
Jun 24 2022
May 24 2022
May 24, 2022,
FORMCYCLE 7.0.13
Features
- Added a new malware scanner plugin type. This plugin type makes it possible to scan for malware and viruses in files with the virus scanner software of your choice. When a malware scanner plugin is installed, files uploaded in the backend and files uploaded by users via frontend form are scanned for malware. We currently offer plugins for Microsoft Defender (Windows) and ClamAV (Linux).
- Added a new role permission for deleting form records. This permission controls whether a user is allowed to delete form records in the inbox. By default, all users with access to the inbox are granted this permission.
- Previously Xima® Formcycle blocked any attempts to include backend pages in third-party pages via iframes. This is still the default, but you can add exceptions for third-party pages that are allowed to include backend pages, see System General.
- Added new placeholder variables for selected elements displayed as questions. For example, let's say you have got a form with a select element named sel1, with 3 questions Q1, Q2, Q3 and 3 answers A1, A2, A3. When the selected answers are Q1-A1, Q2-A1, Q2-A2, Q3-A1, Q3-A2, Q3-A3, then:
- [%sel1%] resolves to A1;A1,A2;A1,A2,A3
- [%sel1_0%] resolves to A1, [%sel1_1%] resolves to A1,A2, and [%sel1_2%] resolves to A1,A2,A3
Changes (Backend)
- The configuration page Data LDAP connections lets you connect query an existing active directory. Previously a username and password were required, which meant that you could not connect to public directories. The username and password are now optional.
- When a form store provides an icon, that icon is shown in the import dialog instead of the generic form store icon.
- The form designer lets you translate the form into different languages. Previously, you could select all languages that were installed on the system that hosts the Xima® Formcycle server, but you could not add custom language codes. Since version 7.0.13, you can select between one of the languages configured on the Files & templates I18N variables page. To add a custom language, add a new language to the i18n variables. In addition, you can also show all languages previously available if that becomes necessary.
Changes (Frontend)
- When printing a form, it always uses up the entire available width. This also fixes the zoom feature of the print service plugin.
- The JavaScript functions jQuery.fn.autocompleteDB and jQuery.fn.autocompleteLDAP allow additional parameters to be passed to the query via the params argument. Previously, you could only pass string parameters, now you can also pass HTML elements and JQuery instances - the value of the form element is then sent as a parameter to the query.
- Improved performance for forms with select elements and many conditions.
- Improved variables replacement in various properties of a form element in the form designer:
- Form-specific variables such as [%$PROJECT_ALIAS%] or [%$PROJECT_TITLE%] are now replaced.
- Variables in the default value of select elements are now replaced.
Fixes
- Improved the detection when the connection to the database is lost and when the database is available again.
- When selecting a database type, no error message regarding missing drivers is shown anymore when you select MySQL 5 and the driver is installed on the system.
- Improved server validation when a form element is unavailable or disabled due to the state or user group condition
- Fixed a bug in the automatic height calculation of textarea elements.
- A bug related to upload elements with automatic uploads was fixed: Files were not saved correctly when the form element had an underscore in its name.
- The correct English translation is shown for appointment elements when the language is changed, e.g. via the languages switcher plugin.
- When the server validation is enabled for a form element and an existing form record is submitted again, only the newly submitted data were validated previously. This was fixed so that the existing data is taken into account as well.
- Saving form data in the offline app did not work when select elements contained options with a value longer than a single character. This can be fixed by updating to Xima® Formcycle 7.0.13.
- Minor bug fixes related to server validation.
- Minor bug fixes in the form and workflow designer.
- The very first form version backup is now loaded correctly as well.
- When inserting a form template and the template was a container or fieldset, sometimes elements in the container or fieldset were removed and not inserted correctly.
- Sometimes the form preview did not display correctly.
- Workflow actions could be dragged and dropped to multiple drop points simultaneously, which resulted in the action being added multiple times. This was fixed so that an action can be dropped only to one drop point at a time.
- Minor bug fixes in the backend UI.
Checksums
Apr 01 2022
Apr 1, 2022,
FORMCYCLE 7.0.12
Changes
- Update the included Spring framework dependency to the latest version. Previous version contain a version of the Spring framework that is vulnerable to CVE-2022-22965. Currently, we are not aware of any scenario where this vulnerability can be exploited. We still recommend you upgrade to the latest Xima® Formcycle version.