If required, before the actual import, delete all existing product data using CRXDE Lite:
The present document is primarily addressed to business users who want to inform themselves about the available features and have a quick access on how to use these features.
The content of the present document is valid for the following combinations of software versions:
Intershop | AEM Connector | Adobe Experience Manager |
---|---|---|
7.4 7.4 CI | 1.1 | 6.0 |
Documentation: eCommerce Integration with Intershop
The documentation of the eCommerce integration with Intershop is attached to this page. These information are especially important for the product and catalog import: For example: How to configure the catalog importer?
The following information can be found there:
There is a variety of ways to import product and catalog data. The product and catalog data can be imported when initially setting up the environment, or after changes have been made in the Intershop data.
Product and catalog data is maintained in Intershop 7 and can be imported into the AEM system via different import modes:
Actual product information imported from Intershop or any other source is held in the CRX repository under:
/etc/commerce/products
The Intershop Product und Catalog Importer is available under:
http://localhost:4502/etc/importers/intershop.html
As the name says, full import means an import of all online catalog and product data from IS7 into the AEM. The current version does not take care for the deletion of obsolete catalogs & products.
Example:
Delete the existing product data from the AEM
If required, before the actual import, delete all existing product data using CRXDE Lite:
In CRXDE Lite, navigate to the sub-tree holding the product data:
/etc/commerce/products
Delete the node that holds your product data; for example, Outdoors.
Click Save All to persist the change.
Preconditions:
Imports all product and catalog data which were changed since the last import.
Check the information held in AEM for the relevant product(s), in the appropriate sub-tree under:
/etc/commerce/products
In Intershop 7 system: update the information held on the relevant product(s).
Open the Intershop importer in AEM:
/etc/importers/intershop.html
Select the checkbox Incremental Import.
Click Import Catalog to start the import.
When complete, you can verify the data imported at: http://localhost:4502/crx/de/index.jsp#/etc/commerce/products.
The import process can take a long time so you can select specific areas of the catalog for an express update that is triggered manually. This uses the export feed together with the standard attributes configuration.
The products which will be part of the next express update can be selected manually within the product section in the Intershop 7.
Check the information held in AEM for the relevant product(s), in the appropriate sub-tree under:
/etc/commerce/products
In Intershop enter a product detail page and use the checkbox Express Update to mark a product for Express Update in AEM:
Currently all product prices within the Geometrixx demo store are updated dynamically from the IS7.
A customer can add a product to the cart while browsing the according product detail page (Geometrixx Outdoors).
Note
There is currently no error handling implemented regarding max. quantity or something else. Only wrong formats are handled by a customer notification.
Example:
Every customer has its own cart. So the customer can find all relevant information about the current shopping session:
The upper left section of the shopping cart displays all information about the existing items in the basket:
Below the cart all order promotion messages are currently displayed, if there are any applied to the cart (see also section Promotions).
The cart summary is available on the cart page, all checkout step pages as well as on the order details page (my account).
There you can find the cart overview including information like taxes, shipping & costs and so on.
Dependent on the storefront site, which uses the cart summary, different information appear on the cart summary.
Example:
The first checkout page shows on the right side the cart summary with the following information:
Example:
The second checkout page shows on the right side the cart summary with the following information:
Example:
The order detail page (part of my account - order history - order detail page) shows on the right side the cart summary with the following information:
Example:
A customer can remove an item from the cart. Afterwards the cart summary is updated directly.
Note
There is currently no confirmation question available. A click on the remove button removes the item immediately.
Example:
A customer can change the quantity of cart item. If a customer sets the quantity to "0", the item will be removed from the cart.
In case the customer tries to set an invalid character (only positive numbers are allowed), an user notification appears:
Example:
A customer can register himself on the storefront of the Geometrixx Outdoors store and thus create an account. The following information can be entered while the registration:
The password and the password confirmation must match. Otherwise a user notification appears and the registration is not finished:
After the registration a confirmation page appears (see example - step 3).
Note
Currently it is possible to register plenty of accounts with the same e-mail address. There is no error handling while the registration process implemented to avoid that - a confirmation page appears if the user types in:
An error handling is available later while the login process (only the first registered e-mail address is valid). After the registration a customer is not automatically logged in.
Furthermore, the account is not created within the Intershop system. This needs a login downstream.
There is currently officially no field mandatory, but later the login needs a valid e-mail and a password (the last name must currently not exist).
Example:
A customer can log in if an account was created before. The customer has to enter an e-mail address and the corresponding valid password. After a successful login the customer is lead to the already opened storefront page (see section customer registration - example - step 1).
If the customer does not exist within the IS7, he will be created with some predefined attributes, which are displayed in the screenshots (step 3) below.
If the last name is not available for the first login, the Intershop system uses the e-mail address to create the account with all mandatory fields (also for the last name).
Example:
An already logged in customer (in the Geometrixx Outdoors storefront) can log off himself. This process deletes the current session.
Example:
A customer can reuse an anonymously created basket after logging in. This way a customer can easily continue shopping without adding again all products to the cart.
If the customer has an already existing cart, the items are automatically added to the personalized cart.
A registered customer will get an abandoned basket after the next login. Therefore no existing cookies (including the basket ID) are needed.
Note
Currently only a checkout as a registered user is supported. An unregistered checkout leads currently to some errors.
A user can trigger the checkout process via:
A customer has to enter a billing address while the first checkout step. Therefore the following information must be entered:
Note
All mandatory fields are already pre-filled with the stored information in the IS7 (see screenshot above).
The entered invoice address will be part of the created order.
A simple input validation, which ensures that all mandatory input fields have at least one character entered, is triggered by the Next button.
The first found empty input field will be mentioned in the upcoming customer notification:
Example:
During the 2-step-checkout the customer has to enter the shipping address for his whole order. Per default the shipping address is equal to the invoice address.
A customer can specify a differing address.
Note
All mandatory fields are already pre-filled with the stored information in the IS7 (see screenshot above).
The entered shipping address will be part of the created order.
A simple input validation, which ensures that all mandatory input fields have at least one character entered, is triggered by the Next button.
The first found empty input field will be mentioned in the upcoming customer notification:
Example:
At the moment a customer has to select a delivery method while the checkout process. Predefined are the following dummy shipping methods:
Example:
The choice of the selected shipping method within the storefront has currently no influences on the used shipping method, because the shipping method Standard Ground is hard coded.
Therefore this shipping method has to be defined in the Intershop system:
If the shipping method Standard Ground does not exist or has the status inactive, an error will occur while the submit order process:
Note
The cart summary and order calculation uses the set shipping costs managed by the Intershop system.
At the moment a customer has to select a payment method while the checkout process. For demo purposes only the payment method credit cart is implemented as a dummy component.
The customer can choose between three different credit cards and has to enter the following information on the first step of the checkout:
At the second step of the checkout process, the customer has to enter the corresponding Card Verifiable Certificates (CVC) before the order can be submited:
The choice of the selected payment method within the storefront has currently no influences on the used payment method, because the payment method BPS_INVOICE is hard coded.
Therefore this payment method has to be defined in the Intershop system:
If the shipping method BPS_INVOICE does not exist or has the status inactive, an error will occur after an order is submited.
For all input fields exists a validation, which is triggered by the Next button.
The validation checks the following input:
On the second checkout step, the customer has the possibility to review the current order. All important information about the current order are displayed:
Currently only the payment method credit card is implemented. Due to this fact, the customer has to enter a valid CVC-Number. Elsewise, the following customer notification appears after a clicking Submit Order.
If a valid CVC-Number was entered and the customer clicks Submit Order a customer confirmation page is displayed:
Additionally, the order is created in the Intershop system:
General tab of the order:
Promotions tab of the order:
Payment tab of the order
The order confirmation page provides a link to the Order History page, where all orders are listed, sorted by the creation date (see section My Account for more detailed information).
If the Intershop system is correctly configured an order confirmation e-mail is sent to the customers e-mail address.
Preamble : Since a sync between Intershop and Adobe Promotions is yet to be implemented, promotions need to be maintained on both systems to display some promotion specific content.
Documentation: Create a promotion in AEM.
To add some promotion specific content on the Geometrixx Outdoors storefront, it is currently necessary to create the promotion also in the AEM.
Therefore, a Marketing Manager has to create a customer segment within the AEM, which serves as a promotion rule.
Afterwards a campaign is needed to cluster all promotion specific content, which is related to a defined customer segment.
You can find all information about the creation of a promotion in the AEM here: Create a Promotion in Adobe
Due to the fact that the Intershop system handles the basket calculation, it is also necessary to create and manage the promotions in the Intershop system.
Up to now these promotion discount types are working:
Note
Free gift promotions and line item promotions are not implemented yet.
If a promotion applies to the cart, the only text that occurs in the Adobe Geometrixx Outdoor storefront is the description below the cart (hard coded within the JSP file - no component available), managed by the Intershop system:
The promotion description displayed on the cart page and the submit order page if the promotion is triggered.
Example (cart):
Example (submit order page):
The promotion discounts for free shipping and order promotions are displayed on the cart summary:
Note
Promotions with Promotion Code are not displayed below the cart. They are interpreted as voucher and therefore displayed within the cart summary (see section Promotion Code).
Limitations of the promotion functionality
At the moment a customer can add a promotion code on the cart page and during checkout.
Example: Cart
Example: Checkout step 1
Example: Checkout step 2 / submit order
After a promotion code is successfully added, the promotion is displayed within the cart summary on the cart page and on both checkout pages (for example: Checkout step 2 / submit order).
The current displayed name consists of the "Promotion Code" + ": " + "Promotion Description" (these information are managed by the Intershop system).
Note
At the moment it is not possible to remove a promotion code.
The my account section allows the Geometrixx Outdoors customer to see all available order information stored in the Intershop system. The account settings and profile information were not touched by the Intershop implementation yet.
The Open Orders section can be reached via the Open Orders link in the My Account section:
A page displays all open orders sorted descending by the creation date.
Definition of an open order: status in pending, in progress or new
The following information are available in the list view:
On the right side recently viewed items are displayed with some information (image, name, price).
The Order History section can be reached via the Order History link within the My Account section or via the order number link of the order confirmation page.
Example: Open orders link (my account)
Example: Order confirmation page (after submit order)
Both links lead to the order history list holding all orders placed within the last 12 months.
The following information are available in the list view:
On the right side recently viewed items are displayed with some information (image, name, price).
The order detail page shows some information about a selected order. Use teh links from the Order History page or the Open Orders page (see above).
The following information about the order are available:
Note
Promotion messages are not displayed at the moment.
The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.