Releases: OP-TED/efx-toolkit-java
EFX Toolkit for Java 2.0.0-alpha.4
EFX Toolkit 2.0.0-alpha.4 Release Notes
The EFX Toolkit for Java developers is a library that enables the transpilation of EFX expressions and templates to different target languages. It also includes an implementation of an EFX-to-XPath transpiler.
In this release
This release fixes an a bug that caused variables and parameters to be in the wrong order in the generated XSL.
A "qualifier" parameter was added in various methods, to allow the use of the corresponding new feature in the eForms Core Library 1.4.0.
The dependency on ANTLR was updated to version 4.13.1.
EFX-1 Support
Although this is a pre-release version of the EFX Toolkit, it provides production-level support for EFX-1 transpilation. EFX-1 is the current version of EFX released with SDK 1.
NOTE: Transpilation of EFX-1 to XPath and XSL in this version of the EFX Toolkit is better than what is provided by EFX Toolkit 1.3.0.
EFX-2 Support
The new version of EFX is still under development and will be released with SDK 2.0.0. For more information of EFX-2 see the release notes of the eForms SDK 2.0.0-alpha.1.
Breaking changes
For users of the Toolkit that have implemented custom transpilers, this release contains a few breaking changes from 1.3.0.
More specifically:
- Some additional methods have been added to the SymbolResolver, ScriptGenerator and MarkupGenerator API. As a guide for your implementations please look a the implementations included in the EFX Toolkit for use by the EFX-to-XPath transpilation.
- Some deprecated methods were removed.
- An extensive refactoring in the type management system has rearranged the package structure. As a result some import statements in your code will need to be updated.
Users of the Toolkit that only use the included EFX-to-XPath transpiler will not be affected by the above changes.
Future development
Further alpha and beta releases of SDK 2 and EFX Toolkit 2 will be issued. While in "alpha" development stage, further breaking changes may be introduced.
You can download the latest EFX Toolkit from Maven Central.
Documentation for the EFX Toolkit is available at: https://docs.ted.europa.eu/eforms/latest/efx-toolkit
This version of the EFX Toolkit has a compile-time dependency on the following versions of eForms SDK versions and uses the EFX grammar that each version provides:
- eForms SDK 1.x.x
- eForms SDK 2.0.0-alpha.1
It also depends on the eForms Core Java library version 1.4.0.
EFX Toolkit for Java 2.0.0-alpha.3
Release Notes
The EFX Toolkit for Java developers is a library that enables the transpilation of EFX expressions and templates to different target languages. It also includes an implementation of an EFX-to-XPath transpiler.
In this release
This release fixes an a bug that caused an exception to be thrown by XSLT processors when trying to format sequences of dates or times.
This bug was reported by a user in eForms Notice Viewer issue #88.
EFX-1 Support
Although this is a pre-release version of the EFX Toolkit, it provides production-level support for EFX-1 transpilation. EFX-1 is the current version of EFX released with SDK 1.
NOTE: Transpilation of EFX-1 to XPath and XSL in this version of the EFX Toolkit is better than what is provided by EFX Toolkit 1.3.0.
EFX-2 Support
The new version of EFX is still under development and will be released with SDK 2.0.0. For more information of EFX-2 see the release notes of the eForms SDK 2.0.0-alpha.1.
Breaking changes
For users of the Toolkit that have implemented custom transpilers, this release contains a few breaking changes.
More specifically:
- Some additional methods have been added to the SymbolResolver, ScriptGenerator and MarkupGenerator API. As a guide for your implementations please look a the implementations included in the EFX Toolkit for use by the EFX-to-XPath transpilation.
- Some deprecated methods were removed.
- An extensive refactoring in the type management system has rearranged the package structure. As a result some import statements in your code will need to be updated.
Users of the Toolkit that only use the included EFX-to-XPath transpiler will not be affected by the above changes.
Future development
Further alpha and beta releases of SDK 2 and EFX Toolkit 2 will be issued. While in "alpha" development stage, further braking changes may be introduced. SDK 2 and EFX 2 are expected to continue to be under development through the first quarter of 2024.
You can download the latest EFX Toolkit from Maven Central.
Documentation for the EFX Toolkit is available at: https://docs.ted.europa.eu/eforms/latest/efx-toolkit
This version of the EFX Toolkit has a compile-time dependency on the following versions of eForms SDK versions and uses the EFX grammar that each version provides:
- eForms SDK 1.x.x
- eForms SDK 2.0.0-alpha.1
It also depends on the eForms Core Java library version 1.3.0.
EFX Toolkit for Java 2.0.0-alpha.2
Release Notes
The EFX Toolkit for Java developers is a library that enables the transpilation of EFX expressions and templates to different target languages. It also includes an implementation of an EFX-to-XPath transpiler.
In this release
This release improves translation of EFX-1 templates as follows:
- Renders sequences of labels when a sequence expression is used to provide asset-ids.
- Renders distinct labels from sequences.
- Improves date and time formatting.
This release also includes a refactoring that moved XPath processing classes to the eForms Core Library 1.2.0 to improve reusability.
There are no changes in EFX-2 translation included in this release.
EFX-1 Support
Although this is a pre-release version of the EFX Toolkit, it provides production-level support for EFX-1 transpilation. EFX-1 is the current version of EFX released with SDK 1.
NOTE: Transpilation of EFX-1 to XPath and XSL in this version of the EFX Toolkit is better than what is provided by EFX Toolkit 1.3.0.
EFX-2 Support
The new version of EFX is still under development and will be released with SDK 2.0.0. For more information of EFX-2 see the release notes of the eForms SDK 2.0.0-alpha.1.
Breaking changes
For users of the Toolkit that have implemented custom transpilers, this release contains a few breaking changes.
More specifically:
- Some additional methods have been added to the SymbolResolver, ScriptGenerator and MarkupGenerator API. As a guide for your implementations please look a the implementations included in the EFX Toolkit for use by the EFX-to-XPath transpilation.
- Some deprecated methods were removed.
- An extensive refactoring in the type management system has rearranged the package structure. As a result some import statements in your code will need to be updated.
Users of the Toolkit that only use the included EFX-to-XPath transpiler will not be affected by the above changes.
Future development
Further alpha and beta releases of SDK 2 and EFX Toolkit 2 will be issued. While in "alpha" development stage, further braking changes may be introduced. SDK 2 and EFX 2 are expected to continue to be under development through the first quarter of 2024.
You can download the latest EFX Toolkit from Maven Central.
Documentation for the EFX Toolkit is available at: https://docs.ted.europa.eu/eforms/latest/efx-toolkit
This version of the EFX Toolkit has a compile-time dependency on the following versions of eForms SDK versions and uses the EFX grammar that each version provides:
- eForms SDK 1.x.x
- eForms SDK 2.0.0-alpha.1
It also depends on the eForms Core Java library version 1.3.0.
EFX Toolkit for Java 2.0.0-alpha.1
Release Notes
The EFX Toolkit for Java developers is a library that enables the transpilation of EFX expressions and templates to different target languages. It also includes an implementation of an EFX-to-XPath transpiler.
In this release
This release:
- Improves translation of EFX-1.
- Adds support for translating EFX-2 expressions and templates.
- Removes support of the obsolete EFX versions included in pre-release versions of the SDK (SDK 0.x.x).
- Introduces some breaking changes in the interfaces that need to be implemented by new translators (SymbolResolver, ScriptGenerator, MarkupGenerator).
EFX-1 Support
Although this is a pre-release version of the EFX Toolkit, it provides production-level support for EFX-1 transpilation.
EFX-1 is the current version of EFX released with SDK 1. Transpilation of EFX-1 to XPath is on par with the EFX Toolkit 1.3.0.
EFX-2 Support
The new version of EFX is still under development and will be released with SDK 2.0.0. For more information of EFX-2 see the release notes of the eForms SDK 2.0.0-alpha.1.
Breaking changes
For users of the Toolkit that have implemented custom transpilers, this release contains a few breaking changes.
More specifically:
- Some additional methods have been added to the SymbolResolver, ScriptGenerator and MarkupGenerator API. As a guide for your implementations please look a the implementations included in the EFX Toolkit for use by the EFX-to-XPath transpilation.
- Some deprecated methods were removed.
- An extensive refactoring in the type management system has rearranged the package structure. As a result some import statements in your code will need to be updated.
Users of the Toolkit that only use the included EFX-to-XPath transpiler will not be affected by the above changes.
Future development
Further alpha and beta releases of SDK 2 and EFX Toolkit 2 will be issued. While in "alpha" development stage, further braking changes may be introduced. SDK 2 and EFX 2 are expected to continue to be under development util late 2023.
You can download the latest EFX Toolkit from Maven Central.
Documentation for the EFX Toolkit is available at: https://docs.ted.europa.eu/eforms/latest/efx-toolkit
This version of the EFX Toolkit has a compile-time dependency on the following versions of eForms SDK versions and uses the EFX grammar that each version provides:
- eForms SDK 1.x.x
- eForms SDK 2.0.0-alpha.1
It also depends on the eForms Core Java library version 1.0.5.
EFX Toolkit for Java 1.3.0
Release Notes
The EFX Toolkit for Java developers is a library that enables the transpilation of EFX expressions and templates to different target languages. It also includes an implementation of an EFX-to-XPath transpiler.
In this release:
- Updated the XPath 2.0 parser, XPathContextualizer and XPathScriptGenerator to correctly translate sequences.
- Improved numeric formatting. The EfxTranslator API now includes overloaded methods that permit control of numeric formatting. The existing API has been preserved.
- Improved handling of multilingual text fields by adding automatic selection of the visualisation language.
You can download the latest EFX Toolkit from Maven Central.
Documentation for the EFX Toolkit is available at: https://docs.ted.europa.eu/eforms/latest/efx-toolkit
This version of the EFX Toolkit has a compile-time dependency on the following versions of eForms SDK versions and uses the EFX grammar that each version provides:
- eForms SDK 0.6.x
- eForms SDK 0.7.x
- eForms SDK 1.x.x
It also depends on the eForms Core Java library version 1.0.5.
EFX Toolkit for Java 1.2.0
Release Notes
The EFX Toolkit for Java developers is a library that enables the transpilation of EFX expressions and templates to different target languages. It also includes an implementation of an EFX-to-XPath transpiler.
In this release:
- We fixed a bug in the
XPathScriptGeneratorthat was causing references to fields of typemeasure(duration) to throw an exception when multiple values where matched by the reference. - We fixed an issue in the
SdkSymbolResolverthat was causing some code labels to be resolved incorrectly. TheSdkSymbolResolvernow correctly looks for the root codelist associated with a field in the codelist metadata provided in thecodelistsfolder, instead of relying on the codelist constraint metadata provided infields.json.
⚠️ CAUTION: If you have implemented your ownSymbolResolvermake sure that your implementation ofgetRootCodelistOfFieldretrieves the parent codelist information fromcodelists/codelists.jsonor directly from the.gcfiles in thecodelistsfolder of the eForms SDK. - We refactored the code to move to the eForms Core Java library some common entity classes that were not specific to EFX (
SdkEntityFactory,SdkField,SdkNode,SdkCodelist). We also moved into the EFX Toolkit some reusable classes (SdkSymbolResolver,ComponentFactory) from the eForms Notice Viewer sample application. The result of this refactoring isefx-toolkit-java-1.2.0,eforms-core-java-1.0.0andeforms-notice-viewer-0.6.0.
You can download the latest EFX Toolkit from Maven Central.
Documentation for the EFX Toolkit is available at: https://docs.ted.europa.eu/eforms/latest/efx-toolkit
This version of the EFX Toolkit has a compile-time dependency on the following versions of eForms SDK versions and uses the EFX grammar that each version provides:
- eForms SDK 0.6.x
- eForms SDK 0.7.x
- eForms SDK 1.x.x
It also depends on the eForms Core Java library version 1.0.0.
EFX Toolkit for Java 1.1.1
EFX Toolkit 1.1.1 Release Notes
The EFX Toolkit for Java developers is a library that enables the transpilation of EFX expressions and templates to different target languages. It also includes an implementation of an EFX-to-XPath transpiler.
In this release:
- We fixed a bug that was causing (in some cases) the wrong relative XPath to be calculated for fields that point to XML attributes.
- We fixed an issue with variable scoping in EFX Templates.
You can download the latest EFX Toolkit from Maven Central.
Documentation for the EFX Toolkit is available at: https://docs.ted.europa.eu/eforms/latest/efx-toolkit
This version of the EFX Toolkit has a compile-time dependency on the following versions of eForms SDK versions and uses the EFX grammar that each version provides:
- eForms SDK 0.6.x
- eForms SDK 0.7.x
- eForms SDK 1.x.x
It also depends on the eForms Core Java library version 0.1.1.
EFX Toolkit for Java 1.1.0
EFX Toolkit 1.1.0 Release Notes
The EFX Toolkit for Java developers is a library that enables the transpilation of EFX expressions and templates to different target languages. It also includes an implementation of an EFX-to-XPath transpiler.
In this release:
In this release we moved some utility classes to a new java library: eforms-core-java. These utility classes enable the parallel use of multiple major versions of the SDK by applications. We decided to extract this functionality to a new shared library so that it can also be used by applications that do not necessarily need EFX translation.
This release also removes the need to use the "classindex" annotation processor plugin. You can remove the following section from your pom.xml:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>${version.compiler.plugin}</version>
<configuration>
<annotationProcessorPaths>
<annotationProcessorPath>
<groupId>org.atteo.classindex</groupId>
<artifactId>classindex</artifactId>
<version>${version.classindex}</version>
</annotationProcessorPath>
</annotationProcessorPaths>
</configuration>
</plugin>
You can download the latest EFX Toolkit from Maven Central.
Documentation for the EFX Toolkit is available at: https://docs.ted.europa.eu/eforms/latest/efx-toolkit
This version of the EFX Toolkit has a compile-time dependency on the following versions of eForms SDK versions and uses the EFX grammar that each version provides:
- eForms SDK 0.6.x
- eForms SDK 0.7.x
- eForms SDK 1.x.x
It also depends on the eForms Core Java library version 0.1.0.
EFX Toolkit for Java 1.0.3
EFX Toolkit 1.0.3 Release Notes
The EFX Toolkit for Java developers is a library that enables the transpilation of EFX expressions and templates to different target languages. It also includes an implementation of an EFX-to-XPath transpiler.
In this release:
This patch fixes and issue in the translation of indirect label references (e.g. #{BT-123-Field}). The issue prevented applications from being able to render sequences of labels when the indirect reference returned sequences of values.
You can see how this change can be utilised by applications by looking at the changes released in version 0.4.0 of eforms-notice-viewer, which can now use a sequence of values returned by an indirect label reference to generate a comma separated list of labels.
You can download the latest EFX Toolkit from Maven Central.
Documentation for the EFX Toolkit is available at: https://docs.ted.europa.eu/eforms/latest/efx-toolkit
This version of the EFX Toolkit has a compile-time dependency on the following versions of eForms SDK versions and uses the EFX grammar that each version provides:
- eForms SDK 0.6.x
- eForms SDK 0.7.x
- eForms SDK 1.x.x
EFX Toolkit for Java 1.0.2
EFX Toolkit 1.0.2 Release Notes
The EFX Toolkit for Java developers is a library that enables the transpilation of EFX expressions and templates to different target languages. It also includes an implementation of an EFX-to-XPath transpiler.
In this release:
This patch fixes a bug in the translation of shorthand indirect label references (e.g. #{BT-123-Field}). The bug affected only fields pointing to XML attributes.
You can download the latest EFX Toolkit from Maven Central.
Documentation for the EFX Toolkit is available at: https://docs.ted.europa.eu/eforms/latest/efx-toolkit
This version of the EFX Toolkit has a compile-time dependency on the following versions of eForms SDK versions and uses the EFX grammar that each version provides:
- eForms SDK 0.6.x
- eForms SDK 0.7.x
- eForms SDK 1.x.x