Ejemplo Northwind Smart Client

Actualización: noviembre 2007

Nota:
Este ejemplo sólo se ejecuta en Microsoft Office Excel 2007 y Microsoft Office Word 2007.

En este ejemplo se utilizan las personalizaciones de documento para Excel y Word con el fin de implementar un sistema de seguimiento de pedidos basado en la base de datos de ejemplo Northwind para Microsoft SQL Server. En el ejemplo se incluyen las siguientes características:

Plantilla Catalog de Northwind. Los clientes utilizan esta plantilla de Excel para explorar las diferentes ofertas de productos de Northwind Supply Company. La plantilla recupera información de los productos de la base de datos Northwind de SQL Server llamando al servicio Web de Northwind. Con esta plantilla, los clientes pueden comprar varios productos, ver y actualizar sus pedidos y completar los pedidos con la información de envío. El libro retiene la información del pedido entre un uso y otro para permitir al cliente utilizar el catálogo sin conexión.

Nota:

La plantilla no recupera los pedidos que ya se han enviado; sólo crea y edita los pedidos nuevos.
Servicio Web de Northwind. Una vez que los clientes completan sus pedidos, hacen clic en Checkout, que envía el pedido al servicio Web de Northwind. El servicio Web agrega la información del pedido al libro Order Rollup de Northwind y devuelve un identificador de pedido.
Libro Order Rollup de Northwind. Este libro de Excel proporciona una vista consolidada de todos los pedidos nuevos que se envían a través del catálogo y el servicio Web de Northwind. Los usuarios pueden realizar un seguimiento del historial de pedidos de la compañía para ver qué productos se compran, quién los compra, con qué frecuencia y cuánto se compra.
Sitio Web de Northwind. Los usuarios pueden ver una lista de todos los pedidos que se han enviado al servicio Web de Northwind desde una página ASPX. Esta página lee los datos del libro Order Rollup de Northwind. Los usuarios pueden seleccionar un pedido y hacer clic en el botón Create Invoice para escribir los datos de ese pedido en un nuevo documento creado desde la plantilla de facturas de Northwind. También pueden ver las facturas que ya han sido creadas haciendo clic en View Invoice.
Plantilla Invoice de Northwind. Los empleados de Northwind Supply Company utilizan esta plantilla de Word para crear facturas para los clientes. Cuando un empleado abre la plantilla, se crea la factura con los datos si éstos se han agregado ya a la caché de datos mediante el sitio Web de Northwind. Si no hay datos en la caché de datos, se muestra un formulario Windows Forms y el usuario puede seleccionar para qué cliente y qué pedido se crea la factura. La plantilla Invoice de Northwind crea a continuación una factura a partir de los datos del libro Order Rollup de Northwind.

Nota:
La plantilla no recupera los pedidos que ya se han enviado; sólo crea y edita los pedidos nuevos.

Nota de seguridad:
Este ejemplo de código está pensado para explicar un concepto y sólo muestra el código relevante para ese concepto. Es posible que no cumpla los requisitos de seguridad de un entorno específico y no se debe usar exactamente como en el ejemplo. Se recomienda agregar código de seguridad y de control de errores para que los proyectos sean más sólidos y seguros. Microsoft proporciona este código de ejemplo "TAL CUAL" sin ninguna garantía.

Este ejemplo de código está pensado para explicar un concepto y sólo muestra el código relevante para ese concepto. Es posible que no cumpla los requisitos de seguridad de un entorno específico y no se debe usar exactamente como en el ejemplo. Se recomienda agregar código de seguridad y de control de errores para que los proyectos sean más sólidos y seguros. Microsoft proporciona este código de ejemplo "TAL CUAL" sin ninguna garantía.

Para obtener información sobre la instalación del proyecto de ejemplo en el equipo, vea Cómo: Instalar y utilizar archivos de ejemplo de la Ayuda.

Download sample

Para ejecutar este ejemplo

En la subcarpeta App_Code del proyecto NorthwindWebService, abra el archivo Service.vb (en Visual Basic) o Service.cs (en C#).
Busque el comentario con la etiqueta TODO:.
Cambie el valor de la variable workbookLocation para señalar a la ubicación de la instalación del ejemplo.
En el proyecto NorthwindWebSite, abra el archivo Default.aspx.vb (en Visual Basic) o Default.aspx.cs (en C#).
Busque los dos comentarios con la etiqueta TODO:.
Cambie los valores de las variables invoiceDirectory y workbookLocation para señalar a la ubicación de la instalación del ejemplo.
Seleccione el proyecto NorthwindInvoice.
En el menú Project, haga clic en NorthwindInvoice Properties.
Haga clic en la ficha Settings.
En la página Settings, cambie el valor de RollupLocation para que señale la ubicación de NorthwindOrderRollup.xls en el equipo.
Presione F5.
En el panel de acciones, seleccione una categoría de productos.
Seleccione un producto en la hoja de cálculo y, a continuación, haga clic en Order.
Escriba un número positivo en el cuadro de diálogo y, a continuación, haga clic en OK.
En el panel de acciones, haga clic en View Cart.

Puede eliminar un producto del pedido o cambiar la cantidad.
Haga clic en Continue Shopping para agregar más productos al pedido.

O bien

Haga clic en Checkout para finalizar el pedido.
Escriba la información de envío en el cuadro de diálogo y, a continuación, haga clic en OK para enviar el pedido.

El pedido se envía al servicio Web de Northwind.
Para ver el historial de pedidos de todos los productos, abra el libro Order Rollup de Northwind y visualice los informes que están disponibles en el panel de acciones.
Para crear una factura para un pedido, abra el sitio Web de Northwind, haga clic en un identificador de pedido. A continuación, haga clic en Create Invoice.

El sitio web de Northwind lee los datos del pedido desde la memoria caché de datos en el libro Order Rollup de Northwind y los guarda en un nuevo documento creado a partir de la plantilla Invoice de Northwind.
Para ver la factura, haga clic en View Invoice en la página Web.

O bien

Abra el nuevo documento de Word en la carpeta NorthwindInvoice\bin o NorthwindInvoice\bin\Debug.
Para crear otra factura, abra la plantilla Invoice de Northwind, seleccione un cliente y un identificador de pedido y, a continuación, haga clic en OK.