progress / adetran

Progress OpenEdge Visual Translator and Translation Manager archive

adetran

Open source version of OpenEdge Translation Manager and Visual Translator

This software is released as an open source project under the Apache 2.0 license.

This package contains both OpenEdge Translation Manager and the Visual Translator Tool. The software is NOT supported by Progress Software. Pull requests will likely be rejected or ignored. Feel free to clone the repository.

Some very basic sanity testing has been done against OpenEdge 12 to ensure this builds and major functionality works. There are some known issues.

Building

You will need to ensure you are in a proenv session so that $DLC environment variable is set. The build uses gradle and an open source plugin called 'latte' to build the application. You will need a development license of Progress OpenEdge in order to build the software.

Use the following command line to perform the build.

./gradlew build

Once the source code is built you will find the output in the build directory. The primary build output is build/tranman.pl and build/resources. The build/resources folder contains the images that are needed. The build also generates build/adetran/data/kit.db and build/adetran/data/xlatedb.db.

Running

Since both Translation Manager and Visual Translator are GUI only applications, you will need to compile and build on Windows. You can run the Visual Translator tool or the Translation Manager application using prowin. You will need to configure the PROPATH to include both the build/tranman.pl and build/resources folder. There are launch scripts that take care of this for you.

You can launch the application using the sample startup programs provided for both Visual Translator and Translation Manager application. The launcher scripts below configure the PROPATH to include the needed entries.

To launch visual translator:

prowin -p launch_visual_translator.p

To launch Translation Manager:

prowin -p launch_tranman.p

NOTE: the above wrappers are only for convenience created as part of this repository and are not part of the original code base.

Help

For help and instructions visit https://docs.progress.com. Translation Manager and Visual Translator are not distributed with OpenEdge 12. You may need to refer to the OpenEdge 11 help content.

License

License Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.”

Differences in releases

The code in this repository is based on the original adetran source. There are some differences between this version and the Progress provided version available via Progress Communities website.

• The license checks in Translation Manager and Visual Translator have been removed. Part of this removal triggered some small adjustments to the menu sensitivity code.
• Some code reorganization has been done to better fit with the Gradle defaults.
• The license for the code in this repository is under Apache 2.0, rather than the Possenet public license. You can still access the possenet version of the adetran code from the Progress communities website if you so desire.
• The export of translation kits relies on a library that is no longer shipped with OpenEdge 12.0. This library code is not part of this repository.
• The template glossaries that are originally came from Microsoft have been removed as the license prohibits redistribution.
• This version has no support from Progress Software.

What doesn't work

Because of license requirements some functionality won't work and would need to be replaced.

• The glossaries that were included in the data folder are not present. You will need to provide your own glossaries of standard terms.
• The export and import of translation kits is missing a critical .dll. The code that performs this relies on a C based library that is not shipped with OpenEdge unless you have a Translation Manager or Visual Translator license.

It is left as an exercise to the reader to find a solution to this. The Microsoft .NET zip classes are one possible solution. Unfortunately, Microsoft did not implement zip file comment support in their library so this may be an incomplete solution.