Smart Client Northwind, exemple

Mise à jour : novembre 2007

Remarque :

Cet exemple s'exécute uniquement dans Microsoft Office Excel 2007 et Microsoft Office Word 2007.

Cet exemple utilise des personnalisations au niveau du document pour Excel et Word afin d'implémenter un système du suivi des commandes basé sur l'exemple de base de données Northwind pour Microsoft SQL Server. Il inclut les fonctionnalités suivantes :

  • Modèle Northwind Catalog. Ce modèle Excel est utilisé par les clients pour parcourir les différentes offres de produits de la société Northwind Supply Company. Il récupère les informations relatives aux produits à partir de la base de données SQL Server Northwind en appelant le service Web Northwind. Les clients peuvent utiliser ce modèle pour acheter différents produits, afficher et mettre à jour leurs commandes et compléter leurs commandes en indiquant des informations relatives à l'expédition. Le classeur conserve les informations relatives à la commande entre les différentes utilisations pour permettre au client d'utiliser le catalogue hors connexion.

    Remarque :

    Le modèle ne récupère pas les commandes qui ont déjà été soumises ; il crée et modifie uniquement les nouvelles commandes.

  • Service Web Northwind. Une fois que les clients ont complété leurs commandes, ils cliquent sur Checkout, ce qui soumet la commande au service Web Northwind. Le service Web ajoute les informations relatives à la commande dans le classeur Northwind Order Rollup et retourne un ID de commande (Order ID).

  • Classeur Northwind Order Rollup. Ce classeur Excel fournit un affichage consolidé de toutes les nouvelles commandes qui sont soumises par l'intermédiaire du catalogue Northwind et du service Web Northwind. Les utilisateurs peuvent suivre l'historique des commandes de la société afin d'identifier les produits achetés, les acheteurs, ainsi que la fréquence et le montant des achats.

  • Site Web Northwind. Les utilisateurs peuvent afficher, dans une page ASPX, la liste de toutes les commandes qui ont été soumises au service Web Northwind. Cette page lit les données contenues dans le classeur Northwind Order Rollup. Les utilisateurs peuvent sélectionner une commande et cliquer sur le bouton Create Invoice pour écrire les données relatives à cette commande dans un nouveau document créé à partir du modèle Northwind Invoice. Ils peuvent également afficher les factures qui ont déjà été créées en cliquant sur View Invoice.

  • Modèle Northwind Invoice. Ce modèle Word est utilisé par les employés de la société Northwind Supply Company pour créer des factures pour les clients. Lorsqu'un employé ouvre le modèle, la facture correspondant aux données est créée si des données ont déjà été ajoutées au cache de données par le site Web Northwind. S'il n'y a pas de données dans le cache de données, un Windows Form est affiché et l'utilisateur peut sélectionner le client et la commande pour lesquels créer la facture. Le modèle Northwind Invoice crée ensuite une facture à partir des données contenues dans le classeur Northwind Order Rollup.

Note de sécurité :

Cet exemple de code est destiné à illustrer un concept et affiche uniquement le code correspondant. Il peut ne pas répondre aux exigences de sécurité d'un environnement spécifique et ne doit pas être utilisé tel quel. Nous vous conseillons d'ajouter un code de gestion des erreurs et de sécurité afin de renforcer la sécurité et la fiabilité de vos projets. Microsoft fournit cet exemple de code « EN L'ÉTAT », sans garantie d'aucune sorte.

Pour plus d'informations sur l'installation de l'exemple de projet sur votre ordinateur, consultez Comment : installer et utiliser des fichiers d'exemple figurant dans l'aide.

Download sample

Pour exécuter cet exemple

  1. Dans le sous-dossier App_Code du projet NorthwindWebService, ouvrez le fichier Service.vb (en Visual Basic) ou Service.cs (en C#).

  2. Recherchez le commentaire qui porte l'étiquette TODO:.

  3. Modifiez la valeur de la variable workbookLocation pour pointer vers l'emplacement d'installation de l'exemple.

  4. Dans le projet NorthwindWebSite, ouvrez le fichier Default.aspx.vb (en Visual Basic) ou Default.aspx.cs (en C#).

  5. Recherchez les deux commentaires qui portent l'étiquette TODO:.

  6. Modifiez la valeur des variables invoiceDirectory et workbookLocation pour pointer vers l'emplacement d'installation de l'exemple.

  7. Sélectionnez le projet NorthwindInvoice.

  8. Dans le menu Projet, cliquez sur NorthwindInvoice Properties.

  9. Cliquez sur l'onglet Paramètres.

  10. Sur la page Paramètres, modifiez la valeur RollupLocation pour pointer sur l'emplacement de NorthwindOrderRollup.xls sur votre ordinateur.

  11. Appuyez sur F5.

  12. Dans le volet Actions, sélectionnez une catégorie de produits.

  13. Sélectionnez un produit dans la feuille de calcul, puis cliquez sur Order.

  14. Saisissez un nombre positif dans la boîte de dialogue, puis cliquez sur OK.

  15. Dans le volet Actions, cliquez sur View Cart.

    Vous pouvez supprimer un produit de la commande ou modifier la quantité commandée.

  16. Cliquez sur Continue Shopping pour ajouter d'autres produits à la commande.

    - ou -

    Cliquez sur Checkout pour terminer la commande.

  17. Tapez les informations relatives à l'expédition dans la boîte de dialogue, puis cliquez sur OK pour soumettre la commande.

    La commande est soumise au service Web Northwind.

  18. Pour consulter l'historique des commandes pour tous les produits, ouvrez le classeur Northwind Order Rollup et affichez les rapports qui sont disponibles dans le volet Actions.

  19. Pour créer une facture correspondant à une commande, ouvrez le site Web Northwind, puis cliquez sur un ID de commande (Order ID) et sur Create Invoice.

    Le site Web Northwind lit les données de commande stockées dans le cache de données du classeur Northwind Order Rollup, puis les enregistre dans un nouveau document créé à partir du modèle Northwind Invoice.

  20. Pour consulter la facture, cliquez sur View Invoice sur la page Web.

    - ou -

    Ouvrez le nouveau document Word dans le dossier NorthwindInvoice\bin ou NorthwindInvoice\bin\Debug.

  21. Pour créer une autre facture, ouvrez le modèle Northwind Invoice, sélectionnez un client (Customer) et un ID de commande (Order ID), puis cliquez sur OK.

Configuration requise

  • Base de données SQL Server Northwind.

Démonstrations

  • Lecture de données à partir d'une base de données SQL Server.

  • Listes de données de liaison sur des feuilles de calcul protégées.

  • Utilisation de Windows Forms.

  • Utilisation du volet Actions.

  • Mise en cache de groupes de données.

  • Mise en cache d'objets métier personnalisés.

  • Traitement côté serveur de documents Visual Studio Tools pour Office.

  • Utilisation de contrôles hôtes XMLNodes de Word.

  • Utilisation de la validation de données Excel.

  • Détermination de l'état en ligne ou hors connexion de l'ordinateur client actuel.

  • Appel à un service Web.

Voir aussi

Concepts

Mise en cache des données

Accès aux données des documents sur le serveur

Vue d'ensemble du volet Actions

Vue d'ensemble des éléments hôtes et des contrôles hôtes

Autres ressources

Exemples au niveau du document