Fichier Lisezmoi pour l’exemple XmlManuInstructions

  • Article

[Cette rubrique est une documentation préliminaire susceptible d'être modifiée dans les versions ultérieures. Les rubriques vierges sont incluses comme espaces réservés. REMARQUE : Afin de vous donner accès à des contenus toujours plus nombreux en langue française, Microsoft met à votre disposition des articles et de la documentation dont la traduction a pu être réalisée en utilisant des outils et méthodes spécifiques, et notamment grâce à l’utilisation d’un système de traduction automatique. La traduction d’une partie du contenu de la documentation de cette version préliminaire a fait appel à l’utilisation de telles méthodes. Nous sommes conscients que certains contenus ainsi traduits peuvent contenir des erreurs de vocabulaire, de syntaxe ou de grammaire. La version finale de ce contenu sera traduite à l’aide de méthodes traditionnelles, ce qui permettra de garantir un niveau de qualité comparable à celui des versions précédentes.]

Cet exemple fonctionne uniquement avec SQL Server 2005 et SQL Server 2008. Il ne fonctionnera pas avec les versions de SQL Server antérieures à SQL Server 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

Emplacement par défaut :

C:\Program Files\Microsoft SQL Server\100\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.

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é :

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.

    Notes

    Pour déterminer le dossier dans lequel se trouvent les exemples, cliquez sur 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

    Notes

    Pour plus d'informations sur la paire de clés avec nom fort, consultez « Security Briefs: Strong Names and Security in the .NET Framework » (en anglais) dans le Centre de Développement du .NET sur MSDN.

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

Pour générer l'exemple

  1. Assurez-vous que l’exemple de base de données AdventureWorks est installé.

  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 Adobe (en anglais). Veillez à cliquer sur Enregistrer sous et non sur Ouvrir.

    Notes

    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.

    Notes

    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, 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.