Home

Overview

Hybris Impex Editor adds support to Impex language by providing features like:

• Syntax highlighting
• Autocompletion
• [Discovery of data model change] (#discovery-of-data-model-change)

Ressources

• Impex Syntax
• Impex topic in expet.hybris.com
• Writing Hybris Impex with Style

Installation

From eclipse marketplace.

1. Select Help > Eclipse Marketplace...
2. In the search box enter the keyword "hybris" and choose hybris Impex editor v1.5.5 and click Install

Using eclispe update site

1. Select Help > Install New Software...
2. In the Add Site dialog, enter http://eljoujat.github.io/updates/ , and click OK.
3. Place a checkmark next to Impex, confirm that the sub-components are all checked, and click Install.

Manual installation

1. Go to https://github.com/eljoujat/eclipseimpexeditor/releases
2. Fetch all the latest release jar files
3. Put the file into dropins (e.g. /opt/eclipse/dropins) folder and restart eclipse

Usage

Configure the plugin in eclipse preferences

Search for "Impex" in the settings and you will find the plugin configuraiton page.

It's possible to customize the feel and look of the Impex file:

And you can configure the connection with hybris, to execute and validate the Impex with any running instance of hybris!

Indexing and updating model

After you configured the URL and credentials for your (local) hybris instance, please index the schema data by right clicking on any impex file and going to the impex plugin submenu > Refresh Model.

Syntax highlighting

The Syntax highlighting feature uses the rule-based scanner class. The scanner takes a given number of rules, and consumes the Impex file and evaluates each token. If the token matches a rule, the scanner exits with the corresponding properties.

The ruleset is based on the Hybris Impex syntax documentation

Before :

After :

Autocompletion

The auto-completion is the most liked what the most user look for in any text editor since I have stored the data definition, this feature was easy to implement as well:

How to build from code source.

This project is built using Eclipse Tycho (https://www.eclipse.org/tycho/) and requires at least maven 3.0 (http://maven.apache.org/download.html) to be built via CLI.

1. fork the code source git clone https://github.com/eljoujat/eclipseimpexeditor.git
2. cd eclipseimpexeditor
3. mvn clean package

The first run will take quite a while since maven will download all the required dependencies in order to build everything.

In order to use the generated eclipse plugins in Eclipse, you will need m2e (https://www.eclipse.org/m2e) and the m2eclipse-tycho plugin (https://github.com/tesla/m2eclipse-tycho/). Update sites to install these plugins :

• m2e stable update site : http://download.eclipse.org/technology/m2e/releases/
• m2eclipse-tycho dev update site : http://repo1.maven.org/maven2/.m2e/connectors/m2eclipse-tycho/0.7.0/N/0.7.0.201309291400/

What next:

Other features I'm working on are:

• Validate the impex with error markers.
• Execute the impex .
• Hyperlink features to easily locate where an Item is already valued from the same impex .
• Find usage Features, find all usage for the selected defined and selected item.
• Formatting .

Other existing plugins for Hybris

0. https://github.com/ShahnazK/hylips (abandoned?)
1. https://github.com/erikwennerberg/impexPlugin (a little bit better coloring, e.g. semicolon is in different color)