hybris - setup accelerator site

Open a command line window and navigate to yourpath/bin/platform and execute the command

1. Setantenv.bat to ensure Ant is on your classpath

2. Ant clean which ask to press enter and after that it shows build successful. Now you can see the config folder generated in your hybris path which is responsible for configuration files.

3. Ant all 
Import the codebase into eclipse
File -> Import -> general -> existing projects into workspace and click on Next.

Click browse button and select your hybris path which shows all the available extension.
Select the required extension and click finish.

Preparing Eclipse Ant view
Windows -> show view -> ant we can see the ant symbol 
Click Add Build files in Ant window. Select and expand the 

Platform extension and select build.xml
Set the Ant provided by hybris which is installed  currently. Windows -> preferences - > Ant ( runtime ) click on Ant home and browse the path/bin/platform/ apache –ant-1.9.1
Now start the server command is hybrisserver.bat
…Path/bin/platform> hybrisserver.bat

After server started we need to initialize the system

 Go to http://localhost:9001 to open the hac ( Hybris management console) and click on initialize button.
Here the port number 9001 is set in platform -> project.properties file tomcat.http.port=9001

Ant command Modulegen is used to generate sets of dependent extensions to easily start new projects or create new applications. 
Start the ant task called modulegen. In the example below, you can see the script with the following information:

modulegen:
[input]
[input] Please choose the name of your module extension. It has to start with a letter followed by letters and/or numbers.
[input] Press [Enter] to use the default value [training]
storefront
[input]
[input] Please choose the base package name of your extensions. It has to fulfill java package name convention. Each extension
in the module will
add its name to this package.
[input] Press [Enter] to use the default value [org.training]
org.storefront
[input]
[input] Please choose a template for generation.
[input] Press [Enter] to use the default value ([accelerator], b2baccelerator)
Accelerator

After this a copy of different extension like ( **core, **facades, **storefront, **cockpit, **fulfilmentprocess, **test, **initialdata)

Hybris BackOffice Tools...

 Hybris BackOffice Tools

Hmc:- 

Hmc stands for Hybris Management Console. Easy to configure and customize via XML configuration.HMC tool for technical business users, developers and Administrators,By Using HMC Manage Product,Order,Customer data and business processes. Manage users and access rights.

Cockpits:-

Product Cockpit –

The hybris Product Cockpit Module enables cockpit end users to manage and structure product information and catalogs in high-volume and collaborative environments. Product and category administration

 

WCMS Cockpit –

The WCMS Cockpit Module supports regular websites.WCMS Cockpit provides a multi-channel publishing system that allows you to easily maintain websites.It provides an intuitive, graphical user interface for data presentation and management.

Admin Cockpit – 

The hybris Administration Cockpit is used for the manipulation of Data Validation constraints,Instances of types and manage B2B data.The aim of the hybris Administration Cockpit is to provide functionality similar to the hybris Management Console (hMC), but in a more intuitive and user-friendly fashion, as it is expected from the numerous hybris cockpits.

Customer Service Cockpit -

Customer Service module provides the dedicated solution for the call-center environment. It means by using this Cockpit to perform Call center activities.

Print Cockpit – 

Print Cockpit is use to manage printed catalogs. The Print Cockpit Module adds the desktop publishing functionality to the hybris Platform. It enables you to produce sales catalogs, leaflets, and other printed material.

Import Cockpit –

It reduces the complexity of importing data by allowing you to define import mappings using intuitive graphical user interface tool.By using this cockpit Keep your content accurate by importing the most current product. Aggregate all product information scattered across various systems and departments.Support the long-tail approach by enabling easy supplier on-boarding.information from your suppliers and business partners.

Report Cockpit –.

The hybris Reporting Module provides a cockpit in which users are able to configure and display graphical statistics and reports in one central location. The reports are shown using widgets technology. Report Cockpit access to operational reports

 

BackOffice CockpitNG:-

Next Generation Cockpit Framework (Cockpit NG) is highly extensible and Configurable(XML).Present there are Several areas  BackOffice CockpitNG Modules available they are Commerce Search,Backoffice admin area,OMS Cockpit & Admin.The CokpitNG is a Single User Interface for all Backend Business Tools easy to use and role based interface for all business and administrative users.Application mashup can be designed at runtime using the Application Orchestrator interface or XML configuration. BackOffice CockpitNG will replace hmc in the Future. The “ybackoffice” extension template is used to generate a custom extension within which you implement your own components.

Interesting IMPEX in hybris

Impex:

·         As we know that everything is an extension in hybris, so  integrated text-based import/export extension is called impex .

·         Before going to know impex one must have knowledge on Comma-Separated Values (CSV) data files.

·         Impex file is allowed to create,update,delete and exporting platform related data to and from comma-seperated values(CSV)data files both during runtime and hybris commerce suite initialization or update process.

Key Features:

ü  Import and export hybris Commerce Suite data from and into CSV files.

ü  To feed data into database we go for impex.

ü  Impex file is developed based on the "BeanShell Script".

The ImpEx extension is a converter between items in the hybris Commerce Suite and a CSV file, and the other way round as shown below:

By using Hybris Impex extension it is easy to:

ü                 Update data at run time

ü                 Creating initial data for a project or migrating existing data from one hybris            Commerce Suite into another.

Impex Syntax:

Before going to syntax first we should know terminology used while writing impex file. There are different line types appear  are:

• Headers in header section 
•  Lines of values value line section
•  Comments 
•  Macro definitions 

Header:

An ImpEx header line has the following structure:

mode type[modifier=value];attribute[modifier=value];attribute[modifier=value];attribute[modifier=value][;...];attribute[modifier=value]

• Mode specifies what is to be done with the following value lines (insert, update, and so on)
• Type defines the type of item to be processed (category, product, media, type, and so on)
• Attribute describes which item attributes the columns are mapped to. The value lines supply the actual values for the items that are translated using the header settings.
• Modifier gives additional information for translating a value record to the mapped type attribute.
  
  

Example for header row:

INSERT_UPDATE category;code[unique=true];name[lang=de];name[lang=en];$supercategories;$thumbnail;description[lang=de];order

Red color-Mode

Blue color-item Type

Orange color-Attribute

Violet color- Modifier

$- macros

     This header states that each following value line creates or updates a category   instance, until another header occurs.

Value of line:

The values inserted in attributes level in type are called value of line.

Ex: In the above example true, en etc represents value of line

Comments:

A comment starts with hash symbol #.

Ex: # inserting values into category type---- comment

INSERT_UPDATE  Category ;id[unique=true];name

Macro definitions:

Macro definitions start with the dollar symbol $, and they are referenced by $macro name. impex extension allows definitions of macros. you don't have to type repeating strings into your csv file.

Macro must be first  statement in impex file. We can have any number of macros.

Ex: $catalog=catalog(id)-- macro
$catalogVersion=catalogVersion($catalog,version)--- macro
INSERT Product; code; $catalogVersion--- Header

Wherever the term $catalogVersion appears, it is replaced by: catalogVersion(catalog(id),version)

In hybris, Data feeding can be done in 3 ways: 

1.  Through HAC 
2. Through HMC
3.  Programmatic Way

1.     Through HAC: 

1.               start server and navigate to http://localhost:9001 
2.       Goto console tab -->select ImpEximport 
3.           write or copy impex statement-->click on validate content then if script valid it will display saying that import script is valid. 
4.      After Validating Click on Impex Import Tab. Now Impex Script is imported.

2.    Through HMC:

•      Start server and navigate to http://localhost:9001/hmc/hybris 
•     In tree menu select system-->Extract system-->select Tools 
•     Tools extracted-->select import-->New window is opened 
•     click on import file-->new window opened
•      select choose file-->select that impex file-->next upload file 
•          finally select start button -->your record is successfully uploaded

3.    Through Programmatic way:

As an alternative to populate the data model, we will use the ImpEx approach.

ImpEx files for essential data and project data can be prepared without the need for additional data configuration.

Convention:

During the initialization and update processes, the platform looks for ImpEx files in the <extension_name> /resources/impex folder. In particular:

    For essential data: The platform scans the <extension_name> /resources/impex  folders for files with names that match the pattern essentialdata*.impex and imports the files during the essential data creation.

    For project data: The platform scans the <extension_name> /resources/impex folders for files with names that match the pattern projectdata*.impex and imports the files during the project data creation.

The ImpEx directory does not exist by default. You must create it and copy files to it.

For example, if you have the following folder structure:

    resources/impex/essentialdataOne.impex

    resources/impex/essDataOne.impex

    resources/impex/DataOne.csv

    resources/impex/projectdataOne.impex

The files essentialdataOne.impex and projectdataOne.impex are located and imported during the essential and project data imports respectively.