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.0.2023-07-31.

Release notes can be found here

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. Screenshot of import wizard showing a list of HISinOne extensions for import

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. Screenshot of preferences dialogue showing configuration parameters for extension import.

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.

Create a new ticket

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.

  1. Introduction
  2. Installation
  3. Auto Start Plugins
  4. Manually Started Plugins
  5. Bug Reports