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

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

Configure the connection with hybris, to execute and validate the Impex with any running instance of hybris. In the back ground the plugin will fetch your hybris models schema one time. The plugin works by using the HAC functionality and you dont need any additional extensions.

You can as well customize the look and feel of your syntax coloring.

Indexing Schema and Validating Impex

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)