How to Convert a Basket to a PurchaseOrder
For the latest version of Commerce Server 2007 Help, see the Microsoft Web site.
A PurchaseOrder represents a completed order, a shopping cart that has already gone through the checkout process. After you run the Checkout pipeline on a Basket, convert the Basket to a PurchaseOrder by using the SaveAsOrder method.
To convert a Basket to a PurchaseOrder
In Visual Studio, create a new Commerce Server Web application.
Add the Microsoft.CommerceServer.Runtime reference to the Web application.
Add a using directive for the Microsoft.CommerceServer.Runtime.Orders namespace.
Create or retrieve a Basket.
Call the SaveAsOrder method.
Save the updated PurchaseOrder.
Example
The following code shows an example of how to convert a Basket to a PurchaseOrder. In a full Commerce Server application, you would run the Checkout pipeline on the Basket before you convert the Basket to a PurchaseOrder.
using System;
using System.Collections;
using System.Web;
using Microsoft.CommerceServer.Runtime.Orders;
public partial class Default_aspx : System.Web.UI.Page
{
protected void Page_Load(object sender, EventArgs e)
{
// For this example, create a new Guid for the user's ID.
// If this were part of a full CommerceServer site that
// implemented logons, we could get the ID of the current
// user from the CommerceContext.
Guid userID = Guid.NewGuid();
// Create a new Basket named "test basket".
Basket myBasket = OrderContext.Current.GetBasket(userID, "test basket");
// In a full Commerce Server application you would add
// OrderForms, LineItems, Payments, and so on to the Basket,
// and then run the Basket, Payment, and Checkout pipeline
// on the Basket before you converted the Basket to a
// PurchaseOrder. In this small sample we'll just convert the
// Basket directly to a PurchaseOrder.
// First, display the Basket's name, so that we can confirm
// it's the same as the PurchaseOrder's name.
Response.Write("Basket name: " + myBasket.Name + "<br>");
// Convert the Basket to a PurchaseOrder, and save the.
// PurchaseOrder.
PurchaseOrder myPurchaseOrder = myBasket.SaveAsOrder();
// Display the PurchaseOrder's name.
Response.Write("PurchaseOrder name: " + myPurchaseOrder.Name + "<br>");
} // end Page_Load method
} // end Default_aspx class