Partage via

Modèle (exemple de déploiement d’application)

Cette rubrique explique comment utiliser l’exemple de modèle pour le déploiement d’applications.

Vous pouvez créer et utiliser deux types de scripts de déploiement pour personnaliser le déploiement d’applications BizTalk : les scripts de prétraitement et les scripts de post-traitement. Les scripts de prétraitement sont appelés avant que l’installation de l’application et l’importation commence et une fois la désinstallation terminée. Les scripts de post-traitement sont appelés une fois l’installation de l’application terminée et l’importation et avant le début de la désinstallation.

Vous pouvez écrire des scripts de pré-traitement et de post-traitement afin qu’ils soient appelés pour chacune de ces opérations. Vous pouvez également configurer des scripts pour qu’ils s’exécutent après un seul d’entre eux. Pour plus d’informations sur l’écriture de scripts, consultez Utilisation de scripts de pré-traitement et de post-traitement pour personnaliser le déploiement d’applications.

Cette rubrique montre comment écrire et déployer un script afin qu’il soit appelé avant ou après une seule opération. Pour ce faire, écrivez un script qui vérifie les valeurs de trois variables d’environnement pour déterminer l’opération dans le contexte où elle est appelée. En fonction de ce contexte, le script continue ou interrompt l’exécution.

Cette rubrique explique comment effectuer les étapes suivantes :

  1. Définissez l’emplacement du fichier journal afin de pouvoir générer un fichier journal des opérations de script.

    Note

    En guise de bonne pratique, vous devez toujours générer un fichier journal afin de pouvoir vérifier les opérations de script et résoudre les problèmes.

  2. Créez une application BizTalk et ajoutez-y les exemples de scripts.

  3. Exportez un fichier .msi contenant les artefacts de l’application.

  4. Supprimez l’application du groupe BizTalk pour pouvoir importer le fichier .msi dans le même groupe, ainsi que l’installer à partir du fichier .msi.

  5. Importez l’application et vérifiez le fichier journal pour voir que l’opération d’importation a été enregistrée.

  6. Installez l’application et vérifiez le fichier journal pour voir que le journal d’installation a été ajouté au fichier journal.

  7. Affichez les fichiers journaux et notez les opérations effectuées par les scripts et quand ils ont été effectués.

Ce que fait cet exemple

Deux fichiers .bat fournis pour cet exemple contiennent les valeurs des variables d’environnement pour l’importation, l’installation et la désinstallation. SamplePreProcessing.bat contient des variables pour un script de prétraitement. SamplePostProcessing.bat contient des variables pour un script de post-traitement. Les fichiers montrent également comment consigner des messages à partir de scripts. Vous pouvez copier les sections pertinentes de ces fichiers dans vos scripts.

Important

Certains des commentaires dans les fichiers de script sont incorrects, comme suit :

Dans SamplePreProcessing.bat, le commentaire de script « Préinstallation du script appelé pour une application existante » doit lire « Post uninstall part of the script called for an existing application ».

Dans SamplePostProcessing.bat, le commentaire du script « Partie de désinstallation postérieure de l'application existante appelée » doit être modifié en « Partie de désinstallation préalable de l'application existante appelée ».

Où trouver cet exemple

L’exemple se trouve dans le dossier d’installation de BizTalk Server, comme suit :

<Chemin d’exemples>\Déploiement d’application\Modèle

Comme mentionné précédemment, l’exemple inclut les deux fichiers suivants :

  • SamplePreProcessing.bat

  • SamplePostProcessing.bat

Comment utiliser cet exemple

Pour exécuter l’exemple, procédez comme suit.

Pour définir l’emplacement de journalisation

  • Ouvrez les exemples de script et modifiez la variable LogFile pour pointer vers l’emplacement où les fichiers journaux doivent être écrits. Vous devez fournir le chemin d’accès complet, y compris le nom du fichier. S’il inclut des espaces, vous devez placer le chemin entre guillemets doubles (").

    Exemple :

    set LogFile="<Samples Path>\ApplicationDeployment\Templates\SampleLogOut.txt"

Pour créer une application

  1. Cliquez sur Démarrer, sur Tous les programmes, sur Microsoft BizTalk Server 20xx, puis sur Administration de BizTalk Server.

  2. Dans l’arborescence de la console, développez l’administration de BizTalk Server et développez le groupe BizTalk.

  3. Cliquez avec le bouton droit sur Applications , puis cliquez sur Nouveau.

  4. Dans le nom de l’application, tapez SamplesTemplate, puis cliquez sur OK.

Pour ajouter les scripts à l’application

  1. Développez le dossier de l’application SamplesTemplate que vous venez de créer et cliquez avec le bouton droit sur Ressources dans le volet gauche.

  2. Pointez sur Ajouter et cliquez sur Scripts de prétraitement.

  3. Cliquez sur Ajouter et accédez à SamplePreProcessing.bat.

  4. Sélectionnez le fichier, puis cliquez sur Ouvrir.

  5. Dans le type de fichier, cliquez sur System.BizTalk :PreprocessingScript, puis sur OK.

    SamplePreProcessing.bat est ajouté à l’application et s’affiche dans le dossier Ressources de l’application.

  6. Cliquez à nouveau avec le bouton droit sur Ressources, pointez sur Ajouter, puis cliquez sur Scripts de post-traitement.

  7. Cliquez sur Ajouter et accédez à SamplePostProcessing.bat.

  8. Sélectionnez le fichier, puis cliquez sur Ouvrir.

  9. Dans le type de fichier, cliquez sur System.BizTalk :PostprocessingScript, puis sur OK.

    SamplePostProcessing.bat est ajouté à l’application et s’affiche dans le dossier Ressources de l’application.

Pour exporter un fichier .msi

  1. Dans la console Administration de BizTalk Server, cliquez avec le bouton droit sur l’application SamplesTemplate, pointez sur Exporter, puis cliquez sur Fichier MSI.

  2. Dans la page Bienvenue dans l’Assistant Exportation, cliquez sur Suivant.

  3. Dans la page Sélectionner des ressources, cliquez sur Suivant.

  4. Dans la page Spécifier les hôtes IIS, cliquez sur Suivant.

  5. Dans la page Dépendances, cliquez sur Suivant.

  6. Dans la page Destination, dans le nom de l’application de destination, tapez le nom de l’application.

  7. Dans le fichier MSI à générer, tapez le chemin complet du fichier MSI, puis cliquez sur Exporter. Exemple : C:\MSI\SamplesTemplate.msi

  8. Dans la page Résumé, cliquez sur Terminer.

Supprimer l’application

  • Dans la console Administration de BizTalk Server, cliquez avec le bouton droit sur l’application SamplesTemplate, puis cliquez sur Supprimer.

Pour importer le fichier .msi

  1. Dans la console Administration de BizTalk Server, cliquez avec le bouton droit sur Applications, pointez sur Importer, puis cliquez sur Fichier MSI.

  2. Dans la page Bienvenue dans l’Assistant Importation, dans le fichier MSI à importer, tapez le chemin d’accès du fichier .msi que vous avez précédemment exporté, puis cliquez sur Suivant. Si nécessaire, vous pouvez rechercher le fichier MSI en cliquant sur le bouton (....) .

  3. Dans la page Paramètres de l’application, dans la liste déroulante Nom de l’application, sélectionnez le nom de l’application.

  4. Dans Applications disponibles pour ajouter des références, sélectionnez les applications auxquelles ajouter des références, le cas échéant, puis cliquez sur Suivant.

  5. Dans la page Paramètres de l’environnement cible de l’application, cliquez sur Suivant.

    Note

    Vous n’avez pas besoin de spécifier un environnement cible à des fins de cet exemple. Pour plus d’informations sur cette fonctionnalité, consultez Fichiers de liaison et déploiement d’applications. Pour obtenir des instructions sur l’ajout de fichiers de liaison, consultez Comment ajouter un fichier de liaison à une application.

  6. Dans la page Importer un résumé, vérifiez que les informations récapitulatives sont correctes, puis cliquez sur Importer.

  7. Dans la page Résultats, cliquez sur Terminer.

  8. Ouvrez le fichier journal créé lors de l’exécution des scripts et vérifiez que l’opération d’importation a été journalisée.

Pour installer l’application

  1. Double-cliquez sur le fichier .msi et exécutez l’Assistant Installation.

  2. Ouvrez le fichier journal et vérifiez que l’opération d’installation a été ajoutée aux informations de journalisation.

Pour vérifier que les scripts fonctionnent correctement

  • Ouvrez les fichiers journaux et vérifiez qu’ils ont été exécutés pendant les opérations spécifiées.

Voir aussi

Déploiement d’applications (dossier d’exemples BizTalk Server)
Déploiement d’applications BizTalk

  • Last updated on