Deploying the IBM Gift Center on a Madisons extended site starter store in WebSphere Commerce

WebSphere® Commerce V7 Feature Pack 1 ships the IBM® Gift Center solution along with a sample SAR. This short tutorial shows how to deploy the Gift Center for the Madisons starter store on a Madisons-based extended site.

Priyajith Chembakassery (priyajith@in.ibm.com), Staff Software Engineer, IBM

Photo of Priyajith ChembakasseryPriyajith Chembakassery is a Staff Software Engineer with the IBM India Software Labs, Bangalore. He works with the WebSphere Commerce development team in India.



Siddharth C. Ravikanthrao (siddharth.cr@in.ibm.com), Staff Software Engineer, IBM

Photo of Siddharth RavikanthraoSiddharth C. Ravikanthrao is a Staff Software Engineer with IBM India Software Labs, Bangalore. He has 4 years of experience with WebSphere Commerce development. He has worked with the WebSphere Commerce Sales Center, Gift Center, Service provider, and SEO solutions.



03 November 2010

Before you start

This short tutorial demonstrates how to deploy the IBM Gift Center for the Madisons starter store on a Madisons-based extended site. WebSphere Commerce V7 Feature Pack 1 ships the Gift Center solution along with a sample SAR, which demonstrates the Gift Center capability on the Madisons starter store. However, you can deploy the sample store on a Madisons-based extended site with some changes to the bootstrap data for the IBM Gift Center solution.

Prerequisites

You need to be familiar with WebSphere Commerce and SQL.

System requirements

Duration

1 to 2 hours


Introduction

The IBM Gift Center for Madisons starter store is a reference application that is deployed as an add-on to a Madisons starter store to showcase the Gift Registry functionality, which was delivered in Feature Pack 1 of WebSphere Commerce V7. The limitation of this reference application is that you cannot deploy it in on an extended site store model. This tutorial provides instructions on how to deploy this reference application on a Madisons-based extended site.

This tutorial assumes that:

  1. A Madisons-based extended site is already published and functional with one or more e-sites created.
  2. Feature Pack 1 of WebSphere Commerce V7 has been installed and the foundation feature is enabled. Follow the steps in Enabling WebSphere Commerce foundation if it is not enabled already.
  3. The IBM Gift Center for Madisons starter store is downloaded (refer to the System requirements section) and copied to:
    • Developer Edition: Copy the downloaded SAR file to the WCDEInstallDir/conf/sar folder, where WCDEInstallDir points to the installation directory of the WebSphere Commerce development environment. Create the folder structure conf/sar under WCDEInstallDir if it does not exist.
    • Enterprise or Professional Edition: Copy the downloaded SAR file to the WC_installdir/conf/sar folder, where WC_installdir points to the installation directory of WebSphere Commerce. Create the folder structure conf/sar under WC_installdir if it does not exist.

Publishing the IBM Gift Center for Madisons starter store

To publish the Gift Center on the MadisonsStoreFrontAssetStore:

  1. Open the WebSphere Commerce Administration console.
  2. Log on using your WebSphere Commerce administrator ID and password.
  3. From the Administration console Site/Store Selection page, select the Site radio button and click OK. The Site Administration Console home page displays.
  4. From the menu at the top, select Store Archives > Publish. The Store Archives page displays, listing the SAR files that are available for publishing.
  5. From the store archives list, select the check box next to GiftCenterMadisons.sar, as shown in Figure 1. Click Next.
    Figure 1. Select the GiftCenterMadisons SAR for publish
    Select the GiftCenterMadisons SAR for publish
  6. The Parameters page displays. From the Target Store list, select MadisonStorefrontAssetStore, as shown in Figure 2. Click Next.
    Figure 2. Select the target store
    Select the target store
  7. The Summary page displays, listing the store archive and store selected. It also displays the location to which the store archive will be published. After reviewing the summary information (Figure 3), click Finish.
    Figure 3. Review the summary
    Review the summary
  8. A confirmation dialog displays, telling you the number of the publishing job. Click OK. The Publish Job Status page displays. The publishing state is reflected in the Publish Status column.
  9. Click Refresh to update the status. Once publishing is complete, the Publish Status column displays "Successful".
  10. Log out of WebSphere Commerce Administration console by selecting the Logout link at the top left of the page.

Preparing the Gift Center bootstrap entries for the extended site

The tutorial provides an SQL file in the Download section of the tutorial, which contains the bootstrap entries to be loaded. Perform the following steps to load the bootstrap data:

  1. Download the SQL file into your local file system.
  2. Run the following SQL statement to identify the Store ID of the extended site on which the Gift Center needs to be deployed:
    SELECT STOREENT_ID FROM STOREENT WHERE IDENTIFIER='<Your e-site store name>'

    Replace the <Your e-site store name> with the name of your e-site.

  3. Open the downloaded SQL file in a text editor and replace all occurrences of the text $storeId$ with the store ID value retrieved from the step above. Save the file.
  4. Run the SQL file on the WebSphere Commerce database to update the boot strap entries for the Gift Center. Ensure that all the statements run successfully.
  5. Restart the WebSphere Commerce server.

Repeat the above steps for all the e-sites that require the Gift Registry functionality.


Verifying the deployment

  1. Launch the extended site on which the Gift Center is deployed using the following URL:
    http://<servername>/webapp/wcs/stores/servlet/StoreView?storeId=
    <your_e-site_store_id>
  2. Create a gift registry following the instructions given in IBM Gift Center for the Madisons starter store.

This concludes the steps to deploy the Gift Registry capability on the Madisons-based extended site.


Conclusion

In this tutorial, you learned how to deploy the IBM Gift Center for the Madisons starter store reference application on a Madisons-based extended site. With this information, you can enable the Gift Registry feature on your online store, which is based on the extended site store model.


Download

DescriptionNameSize
SQL fileGR.SQL.zip2KB

Resources

Comments

developerWorks: Sign in

Required fields are indicated with an asterisk (*).


Need an IBM ID?
Forgot your IBM ID?


Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.

 


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name



The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.

 


All information submitted is secure.

Dig deeper into Commerce on developerWorks


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Commerce, WebSphere
ArticleID=563853
ArticleTitle=Deploying the IBM Gift Center on a Madisons extended site starter store in WebSphere Commerce
publish-date=11032010