Readme_XmlManuInstructions

Mis à jour : 5 décembre 2005

L'exemple d'application XMLManuInstructions affiche des instructions en ligne pour générer des produits. Les données de cette application sont extraites des colonnes suivantes de la base de données Microsoft SQL Server AdventureWorks :

• Colonne de type XML Instructions de la table Production.ProductModel
• Colonne de type XML Diagram de la table Production.Illustration

Cet exemple n'est pas pris en charge sur Windows 2000 et les systèmes d'exploitation antérieurs.

-

Emplacement par défaut :

lecteur:\Program Files\Microsoft SQL Server\90\Samples\

Engine\XML\XmlManuInstructions.

Les exemples sont fournis à titre éducatif uniquement. Ils ne sont pas destinés à être utilisés dans un environnement de production et n'ont pas été testés à cet usage. Microsoft ne fournit aucun support technique pour ces exemples. Les exemples d'applications et les assemblys ne doivent pas être utilisés avec votre base de données SQL Server de production ou votre serveur de rapports, ou y être connectés, sans l'autorisation de l'administrateur système.

Scénario

Un développeur veut créer une application qui accède à des instructions de fabrication en XML à partir d'un service Web et affiche ces instructions.

Langages

Transact-SQL, XML, XSD, XSLT, Visual C# et Visual Basic.

Fonctionnalités

L'exemple XmlManuInstructions utilise les fonctionnalités suivantes de SQL Server 2005.

Domaine d'application	Fonctionnalités
Général	XML, services Web hébergés par SQL Server

Configuration requise

Avant d'exécuter cet exemple, vérifiez que le logiciel suivant est installé :

• Microsoft SQL Server 2005 ou Microsoft SQL Server 2005 Express Edition (SQL Server Express). Vous pouvez obtenir SQL Server Express gratuitement à partir du site Web SQL Server 2005 Express Edition Documentation et exemples.
• Base de données AdventureWorks fournie avec SQL Server 2005 et également disponible sur le site Web du SQL Server Developer Center (Centre des développeurs SQL Server).
• Les exemples du moteur de base de données SQL Server 2005. Ces exemples accompagnent SQL Server 2005. Vous pouvez télécharger la dernière version des exemples sur le site Web du SQL Server Developer Center (Centre des développeurs SQL Server).

Le Kit de développement .NET Framework SDK 2.0 ou Microsoft Visual Studio 2005. Vous pouvez obtenir gratuitement le Kit de développement .NET Framework SDK. Consultez Installation du SDK .NET Framework.

Génération de l'exemple

Si vous n'avez pas encore créé un fichier de clé de nom fort, utilisez la procédure suivante pour générer ce fichier.

Pour générer un fichier de clé de nom fort

1. Ouvrez une invite de commandes Microsoft Visual Studio 2005. Cliquez sur Démarrer, pointez sur Tous les programmes et sur Kit de développement Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

   -- Ou --

   Ouvrez une invite de commandes Microsoft .NET Framework. Cliquez sur Démarrer, pointez sur Tous les programmes et sur Kit de développement Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

2. Utilisez la commande CD (changer de répertoire) pour remplacer le dossier actif dans la fenêtre de l'invite de commandes par le dossier dans lequel les exemples sont installés.

   Remarque :

   Pour déterminer le dossier dans lequel se trouvent les exemples, cliquez sur le bouton Démarrer, pointez successivement sur Tous les programmes, sur Microsoft SQL Server 2005 et sur Documentation et didacticiels, puis cliquez sur le répertoire Samples. Si l'emplacement d'installation par défaut a été utilisé, les exemples se trouvent dans <lecteur_système>:\Program Files\Microsoft SQL Server\100\Samples.

3. À l'invite de commandes, exécutez la commande suivante pour générer le fichier de clé :

   sn -k SampleKey.snk

   Important :
   Pour plus d'informations sur la paire de clés de nom fort, consultez l'article de sécurité concernant les noms forts et la sécurité dans .NET Framework, dans le Centre de développement .NET sur MSDN.

Utilisez la procédure suivante pour générer l'exemple :

Pour générer l'exemple

1. Vérifiez que la base de données exemple AdventureWorks est installée.

2. Dans SQL Server Management Studio, chargez et exécutez le script Scripts\install.sql. Vous pouvez aussi exécuter la commande suivante dans une fenêtre d'invite de commandes :

   sqlcmd -E -I -i Scripts\install.sql

   Ce script crée les éléments suivants :

   • La procédure stockée GetManuInstructions
   • Le point de terminaison HTTP sql_AdvWorksEndPointManuInstructions

3. Dans l'Explorateur Windows, cliquez avec le bouton droit sur le dossier CS\XmlManuInstructions où l'exemple a été installé, cliquez sur Propriétés, puis sur l'onglet Partage Web, sélectionnez Partager ce dossier, puis cliquez sur OK à deux reprises. Vous créez ainsi pour l'exemple un dossier virtuel IIS qui permet à l'application de fonctionner correctement.

4. Installez la Visionneuse SVG à partir du site Web http://www.adobe.co (en anglais). Veillez à cliquer sur Enregistrer sous et non sur Ouvrir.

   Remarque :
   Pour installer cette visionneuse, vous devez disposer des privilèges d'administrateur sur votre ordinateur. Respectez la procédure suivante pour installer la visionneuse dans le contexte administrateur sans avoir à fermer votre session actuelle.

   1. Dans le menu Exécuter, tapez la commande suivante : runas /user:Administrator cmd.
   2. À l'invite de commandes, entrez le mot de passe du compte Administrator.
   3. À l'invite de commandes, tapez le chemin d'accès du fichier svgview.exe, par exemple C:\downloads\svgview.exe, et appuyez sur Entrée.

   Remarque :
   Bien que votre compte d'utilisateur possède les privilèges d'administrateur, vous devez exécuter le programme d'installation sous le compte nommé « Administrator », sans quoi il ne fonctionne pas.

5. Générez l'application avec Microsoft Visual Studio 2005 ou tapez la commande suivante dans une fenêtre d'invite de commandes .NET Framework ou Microsoft Visual Studio 2005 :

   msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\ xmlmanuinstructions.sln

Exécution de l'exemple

Utilisez la procédure suivante pour exécuter l'exemple :

Pour exécuter l'exemple

1. Exécutez CS/XmlManuInstructions/bin/debug/XmlManuInstructions.exe.

2. Entrez 7 comme valeur d'identificateur de modèle de produit (ProductModelID). Cliquez sur Show Instructions pour afficher l'ensemble des instructions de fabrication pour le modèle spécifié. Pour obtenir des informations sur le format de la demande SOAP, cliquez sur Show Request. Pour obtenir des informations sur le format de la réponse SOAP de SQL Server 2005, cliquez sur Show Response. Pour obtenir des informations sur le fichier XSLT utilisé pour rendre les instructions, cliquez sur Show XSL. Vous pouvez rechercher dans la table ProductModel table les valeurs de ProductModelID pour lesquelles il existe des instructions de fabrication en XML.

Suppression de l'exemple

Pour supprimer l'exemple, procédez comme suit :

Pour supprimer l'exemple

1. Ouvrez le fichier Scripts\cleanup.sql dans Management Studio et exécutez le contenu du fichier. Vous pouvez aussi exécuter la commande suivante dans une fenêtre d'invite de commandes : sqlcmd -E -I -i Scripts\cleanup.sql

Commentaires

Les exemples sont fournis à titre éducatif uniquement. Ils ne sont pas destinés à être utilisés dans un environnement de production et n'ont pas été testés à cet usage. Microsoft ne fournit aucun support technique pour ces exemples. Les exemples d'applications et les assemblys ne doivent pas être utilisés avec votre base de données SQL Server de production ou votre serveur de rapports, ou y être connectés, sans l'autorisation de l'administrateur système.

Historique des modifications

Version	Historique
5 décembre 2005	Contenu modifié : Modification des instructions concernant la génération d'un fichier de clé, y compris le nom et l'emplacement de ce fichier.