Samples > Sample stores > Consumer direct sample store > IBM Gift Center for the Consumer direct sample store > IBM Gift Center > Customize the Web (presentation) layer > IBM Gift Center actions


GiftRegistryPurchaseRecordUpdate action

This action updates an existing purchase record for items bought from a gift registry. Use this action with SSL to ensure that all personal information is encrypted.

To do so, type the action with the HTTPS secure protocol.


URL structure

http://host/path/

The fully qualified name of the WebSphere Commerce Server and the configuration path (for example, wcserver.mydomain.ibm.com is fully qualified).
Diagram of the URL structure: The URL starts with the fully qualified name of the WebSphere Commerce Server and the configuration path, followed by the URL name, , and the ? character. End the URL with a list of parameters in the form of name-value pairs. Separate each <a href=name-value pair with the & character. For a detailed description of the parameters and their values, see the list entitled Parameter values." />


Parameter values

For all parameters, if there is a co-registrant, then specify <parameter>_2 for the co-registrant's information. For example, for the first_name_i parameter, if there is a co-registrant, then specify firstName_2 for the co-registrant's information.

URL

Required: The URL to be called when the action completes successfully.

purchaseRecordId

Required: The unique identifier for the gift purchase record.

storeId

Required: The store reference number, which is required to help identify to which stores a gift registry belongs.

orderItemId

The unique identifier of an item within the order for a purchased gift registry item.

errorViewName

Overrides the error view when an error occurs.

giftItemId_i

A unique identifier for the item to be purchased from the gift registry.

quantity_i

The quantity of this item, specified by the gift registrant. Note that this is the total quantity, not the additional quantity. The default is 1. If you specify a value of zero, then the action removes this purchase record from the database.

transactionId_i

The transaction identifier generated by gift registry channels other than the Web (for example, transactions from in-store kiosks or call centers).

registrantMemo_i

The brief note or memo provided by the gift registrant, regarding the purchase order.

purchaseDate_i

The date when the gift was purchased.

personalNote_i

A personal note from the gift giver to the gift registrant. The registrant sees this note upon receiving the gift.

purchaseLocation_i

The location where the gift giver purchased the gift.

isNoteSent_i

Specifies whether a thank-you note was sent to the gift giver. Valid values are...

0

(Default) A thank-you note was not sent to the purchaser.

1

A thank-you note was sent to the purchaser.

firstName_i

The first name of the gift registrant. If there is a co-registrant, then specify firstName_2 for the co-registrant's information.

middleName_i

The middle name of the gift registrant, if applicable. If there is a co-registrant, then specify middleName_2 for the co-registrant's information.

lastName_i

The last name of the gift registrant. If there is a co-registrant, then specify lastName_2 for the co-registrant's information.

personTitle_i

A prefix to the gift registrant's name (for example, Mr. Ms, or Dr.). If there is a co-registrant, then specify personTitle_2 for the co-registrant's information.

suffix_i

A suffix to the gift registrant's name (for example, Senior or Junior). If there is a co-registrant, then specify suffix_2 for the co-registrant's information.

address1_i

The first line of the gift registrant's contact address. If there is a co-registrant, then specify address1_2 for the co-registrant's information.

address2_i

The second line of the gift registrant's contact address. If there is a co-registrant, then specify address2_2 for the co-registrant's information.

address3_i

The third line of the gift registrant's contact address. If there is a co-registrant, then specify address3_2 for the co-registrant's information.

city_i

The name of the city within the gift registrant's contact address. If there is a co-registrant, then specify city_2 for the co-registrant's information.

state_i

The name of the state, province, or equivalent within the gift registrant's contact address. If there is a co-registrant, then specify state_2 for the co-registrant's information.

country_i

The name of the country or region within the gift registrant's contact address. If there is a co-registrant, then specify country_2 for the co-registrant's information.

zipCode_i

The ZIP or postal code within the gift registrant's contact address. If there is a co-registrant, then specify zipCode_2 for the co-registrant's information.

email1_i

The gift registrant's primary e-mail or Web address. If there is a co-registrant, then specify email1_2 for the co-registrant's information.

email2_i

The gift registrant's secondary e-mail or Web address. If there is a co-registrant, then specify email2_2 for the co-registrant's information.

phone1_i

The gift registrant's primary phone number. If there is a co-registrant, then specify phone1_2 for the co-registrant's information.

phone2_i

The gift registrant's secondary phone number. If there is a co-registrant, then specify phone2_2 for the co-registrant's information.

phone3_i

The gift registrant's third phone number. If there is a co-registrant, then specify phone3_2 for the co-registrant's information.

fax_i

The gift registrant's fax number. If there is a co-registrant, then specify fax_2 for the co-registrant's information.


Example

The following example updates purchase record 55 for item 5000, which a gift giver has bought under order number 12345 for gift registry 888 at store 1001.

https://myhostname/webapp/wcs/stores/servlet/GiftRegistryPurchaseRecordUpdate?
URL=/webapp/wcs/stores/servlet/&PurchaseRecordId=55&storeId=1001&catEntryId_1=5000
&orderItemId_1=12345


Behavior


Exception conditions


Related concepts

IBM Gift Center architecture

Related reference

IBM Gift Center actions

Overview of customizing IBM Gift Center


+

Search Tips   |   Advanced Search