Ecl1: Eclipse Toolset for HISinOne Extensions
Introduction
Ecl1 is an Eclipse toolset that supports the development of HISinOne extensions. The current released version of the ecl1 toolset is 1.9.2.2023-11-07.
Release notes can be found here
- Wizard for new extension projects, that creates an empty project fitting to the required structure
- Import Wizard for existing extension projects
- Wizard to provide individual checkers for the enrollment process
- Visualization of extension points in all projects
- Automated support for projects contributing to an extension point in HISinOne
- Extended Classpath support for embedding infrastructure extensions
- Export wizard to create HIS specific hotfix XML snippets
- Update Check for ecl1 on startup
- And more!
Installation
You can install the current version of the Ecl1 via our update site.
To use the Ecl1 toolset you need Eclipse Neon (2016-06) or later and Java 8 or above. It runs both on Windows and Linux systems.
Note that since January 2017, Eclipse must be run with a JDK8 >= 8u101 having strong encryption to be able to update from Sourceforge sites.
After you have installed Ecl1, you should have a new category "HISinOne" for new projects, if you try to create a new project for example via pressing Ctrl + N
As an alternative option, you can download the latest plugin version via sourceforge as an update site archive.
Auto Start Plugins
Some plugins of ecl1 are started when eclipse starts.
To disable auto start plugins, navigate to: Window → Preferences → General → Startup and Shutdown and uncheck the undesired plugins.
The following plugins are automatically started:
Ecl1 Classpath Container
This plugin initializes the ecl1 classpath container when eclipse is started. Without a properly initialized ecl1 classpath container, eclipse cannot compile webapps. Further information about classpath containers can be found here.
This plugin also enriches the classpath of JUnit tests and Java Applications. Without this enriching JUnit tests from HISinOne-Extensions will fail.
Ecl1 Git Auto Lfs Prune
Runs git lfs prune in every git versioned project in the workspace. Git lfs prune deletes local copies of LFS files that are old, thus freeing up disk space. Further information about git lfs prune can be found here.
Ecl1 Update Git Hooks
Installs a git hook script in every HISinOne-Extension in the current workspace. These git hook scripts try to enforce the rule that every commit message must include a ticket number (format: #123456). Further information about git hooks can be found here.
Ecl1 Update Check
Checks for ecl1 updates and proceeds to install them if found. Ecl1 updates can also be installed through the regular install mechanism of eclipse.
Manually Started Plugins
Create a new Extension
Ecl1 adds an entry to the creation-assistant:
To create a new extension select "HISinOne Extension Project" from the category "HISinOne" after selecting New from File menu or pressing Ctrl + N.
After selecting the wizard for a new HISinOne Extension Project, you need to choose a name for the extension you want to develop. Ideally, you pick a name that follows the java package naming conventions, as you can see in the following screenshot.
Finally, you now have a fully operational HISinOne-extension skeleton. It even has a Git repository prepared for sharing with fellow developers.
Import existing extensions
The invisibility of other extensions is a challenge. We try to tackle this hurdle with a dedicated import wizard for HISinOne-Extensions
In the category HISinOne the wizard Extension Import offers a simple one-click way of importing a set of existing extensions into your workspace.
To make the import suitable to your custom environment, build server as source for available extensions and git server as version control system are configurable.
Commit Exporter
Export wizard to create HIS specific hotfix XML snippets. Useful for creating hotfixes for HISinOne.
Git Batch Pull
Adds a "Git Batch Pull Command" button to eclipse. When pressed, eclipse executes git pull for all git versioned projects in the workspace.
HIS Runtime Classpath Provider
Enriches the classpath when starting JUnit-Test from HIS-extensions. Without it, the JUnit-Tests don't run when started from eclipse.
HIS Extension Point Collector
Every HIS extension has a extension.ant.properties. When a HIS extension is built, ecl1 scans the extension for extended extension points and updates the extension.ant.properties accordingly.
Bug and Feature Requests
If you miss a certain detail in the Ecl1 toolset or just found a bug please give us notice via the HIS bug tracker.
Please contact your HIS representative, if you don't have access rights to the bug tracker.
We also have a legacy bug tracker that we do not check anymore. Do not use anymore! Legacy bug tracker at sourceforge.