Samples > Starter stores > Starter store enhancements > IBM Gift Center for the Madisons starter store > Site flow and interactions


IBM Gift Center for Madisons: Registry management flows

The gift registry sample pages include registry management flows to list, display, update, track, and announce a registry.

The following table summarizes the JSP files that support registry management flows. Any Web services called by specific links and buttons on the store pages are identified in the right column.

The top-level JSP files are located at this path:

Some of the included JSP files and fragments are located at the previous path, whereas others are located in various subdirectories within the Madisons directory:

Gift registry page JSP files Links and buttons
Manage Your Registries

Displays a list of registries that the customer owns and registries that the customer has accessed to manage as a co-registrant. From this page, the customer can access and manage a registry as a co-registrant by entering the registry number and password for the registry.

GiftRegistryListSelection.jsp

Includes:

  • ManageRegistryList.jsp displays the registry list.

  • The links under the Event Type column display the Registered Products page for the selected gift registry.

  • The Submit button calls the AjaxGiftListServiceAuthenticate service to authenticate the co-registrant to access the gift registry. If successful, the customer is redirected to GiftRegistryManage. If not successful, an error message displays.

  • The pagination buttons control the registry navigation. When the number of registries exceeds the page size, pagination buttons are available to navigate to the corresponding page.

List of [name]'s registries

Displays a list of registries that the customer owns. The customer can access this page from the left sidebar of the My Account page.

MyRegistryList.jsp

Includes:

  • MyRegistryListTable.jsp displays the registry list.

  • The links under the Event Type column display the Registered Products page for the selected gift registry.

  • The pagination buttons control the registry navigation. When the number of registries exceeds the page size, pagination buttons are available to navigate to the corresponding page.

Registry Information

Displays the registry profile, which includes information such as the event type, description, date, registrant or co-registrant details and preferences.

GiftRegistryProfileDisplay.jsp

Includes:

  • GiftRegistryCreateConfirmPage.jsp displays the read-only view of the gift registry profile. When the customer clicks the Edit button, this page is hidden from view.

  • The Edit button displays the gift registry information in a form view so that the user can make changes to registry information.

Edit Your Registry

Updates the registry profile. This page displays information such as the event type, description, date, registrant or co-registrant details and preferences.

GiftRegistryProfileDisplay.jsp
(same as previous row)

Includes:

  • EventInfoSnippet.jspf displays the fields in the Event Information section.

  • RegistryPasswordSnippet.jspf displays the fields in the Registry Password section.

  • PreferencesSnippet.jspf displays the fields in the Guest Access Preference, E-Mail Notification Preference, and Madisons Gift Certificate sections.

  • An asynchronous call is made to RegistrantInfoDisplay.jsp to display the registrant or co-registrant sections depending on the event selected.

  • ShipPreferencesSnippet.jspf displays the shipping preferences.

  • GiftRegistryCreateConfirmPage.jsp displays the read-only view of the Registry Information. When the user clicks on the Edit button, this page is hidden from view.

  • The Save button calls the AjaxGiftListServiceUpdateGiftList service to update the gift registry profile. If successful, the read-only view of the updated gift registry profile displays. If not successful, an error message displays.

Registered Products (owner)

Registry owners, and others with manage access to this registry, use this page to update the quantity of an item or delete items from the gift registry.

GiftRegistryManageDisplay.jsp

Includes:

  • GiftRegistryNavDisplay.jspf displays a list of links for customers to navigate to other registry management pages.

  • EventInfoDisplaySnippet.jspf displays the summary information about the event such as the registrant's or co-registrant's first name, last name, event date, and registry ID.

  • CatalogEntryPriceDisplay.jspf displays the price of the items in the registry.

  • DeleteRegistryPopUp.jspf displays the delete registry pop-up window.

  • The Announcement link displays the page to announce the gift registry.

  • The Open Another Registry displays the list of registries that the current user can manage.

  • The Registry Information link displays the Registry Information page.

  • The Registered Products link displays the Registered Products (owner) page.

  • The Received Gifts link displays the Received Gifts page for this registry.

  • The Delete Registry link calls the AjaxGiftListServiceDeleteItem service to delete the corresponding gift item. After a successful deletion, the customer is redirected to the Open Another Registry page.

  • The Update button calls the AjaxGiftListServiceUpdateItem service to update the quantity requested for this gift item.

  • The Delete button calls the AjaxGiftListServiceDeleteItem service to delete the corresponding gift item. After a successful deletion, the customer is redirected to the Open Another Registry page.

  • The Complete Registry button calls the AjaxGiftListServiceCompleteGiftList service to determine if this registry can be completed. If successful, the customer is redirected to the Complete Gift Registry page. If not successful, an error message displays.

  • The Sort By selection sorts the list of items in the gift registry based on the selected sort parameter. The following sort parameters and their sort order are provided by default:

    1. Part Number, ascending.

    2. Quantity Requested, descending.

    3. Quantity Received, descending.

    4. Quantity Pending, descending.

    5. Price Per Item, ascending.

  • The pagination buttons control the registry navigation. When the number of registries exceeds the page size, pagination buttons are available to navigate to the corresponding page.

Registered Products (gift giver)

Gift givers use this page to buy items in the registry for the registry owners.

GiftRegistryGiftGiverDisplay.jsp

Includes:

  • EventInfoDisplaySnippet.jspf displays the summary information about the event such as the registrant's or co-registrant's first name, last name, event date, and registry ID.

  • CatalogEntryPriceDisplay.jspf displays the price of the items in the registry.

  • The Add To Cart button calls the AjaxOrderChangeServiceItemAdd service to add the selected gift items to the shopping cart.

  • The Sort By selection sorts the list of items in the gift registry based on the selected sort parameter. The following sort parameters and their sort order are provided by default:

    1. Part Number, ascending.

    2. Quantity Requested, descending.

    3. Quantity Received, descending.

    4. Quantity Pending, descending.

    5. Price Per Item, ascending.

  • The pagination buttons control the registry navigation. When the number of registries exceeds the page size, pagination buttons are available to navigate to the corresponding page.

Received Gifts

Registry owners, and others with manage access to this registry, use this page to view and update the received gifts for this gift registry.

GiftRegistryReceivedGiftsDisplay.jsp

Includes:

  • GiftRegistryNavDisplay.jspf displays a list of links for customers to navigate to other registry management pages.

  • EventInfoDisplaySnippet.jspf displays the summary information about the event such as the registrant's or co-registrant's first name, last name, event date, and registry ID.

  • CatalogEntryPriceDisplay.jspf displays the price of the items in the registry.

  • The Announcement link displays the page to announce the gift registry.

  • The Open Another Registry displays the list of registries that the current user can manage.

  • The Registry Information link displays the Registry Information page.

  • The Registered Products link displays the Registered Products (owner) page.

  • The Received Gifts link displays the Received Gifts page for this registry.

  • The Save button calls the AjaxGiftListServiceUpdatePurchaseRecord service to update the changes made to the gifts in the registry.

  • The Sort By selection sorts the list of items in the gift registry based on the selected sort parameter. The following sort parameters and their sort order are provided by default:

    1. Part Number, ascending.

    2. Quantity Requested, descending.

    3. Quantity Received, descending.

    4. Quantity Pending, descending.

    5. Price Per Item, ascending.

  • The pagination buttons control the registry navigation. When the number of registries exceeds the page size, pagination buttons are available to navigate to the corresponding page.

Registry Completion

Allows a user to complete their gift registry. The user can buy the remaining gift registry items at a discount.

CompleteRegistry.jsp

  • The Announcement link displays the page to announce the gift registry.

  • The Open Another Registry displays the list of registries that the current user can manage.

  • The Registry Information link displays the Registry Information page.

  • The Registered Products link displays the Registered Products (owner) page.

  • The Received Gifts link displays the Received Gifts page for this registry.

  • The Sort By selection sorts the list of items in the gift registry based on the selected sort parameter. The following sort parameters and their sort order are provided by default:

    1. Part Number, ascending.

    2. Quantity Requested, descending.

    3. Quantity Received, descending.

    4. Quantity Pending, descending.

    5. Price Per Item, ascending.

  • The Delete button calls the AjaxGiftListServiceDeleteItem service to delete the corresponding gift item. After a successful deletion, the customer is redirected to the Open Another Registry page.

  • The pagination buttons control the registry navigation. When the number of registries exceeds the page size, pagination buttons are available to navigate to the corresponding page.

Announce Your Registry

Customers can announce their gift registry by sending e-mails to guests and others.

GiftRegistryAnnouncementDisplay.jsp

Includes:

  • GiftRegistryNavDisplay.jspf displays a list of links for customers to navigate to other registry management pages.

  • The Announcement History link displays the Announcement History page.

  • The Send button calls AjaxGiftListServiceAnnounceGiftList. If successful, the Announcement History page displays. If not successful, an error message displays.

  • The Cancel button displays the Registered Products page.

Announcement History

Displays all the gift registry announcements the customer has made.

GiftRegistryAnnouncementHistoryDisplay.jsp

Includes:

  • GiftRegistryNavDisplay.jspf displays a list of links for customers to navigate to other registry management pages.

  • Click the Previous button navigates to the previous page of the announcement history.

  • Click the Next button navigates to the next page of the announcement history.

Related reference

IBM Gift Center for Madisons: Registry home page flows

IBM Gift Center for Madisons: Registry creation flows

IBM Gift Center for Madisons: Registry shopping flows

IBM Gift Center for Madisons: Registry search flows


+

Search Tips   |   Advanced Search