Modèle (exemple de déploiement d'une application)

Article
07/21/2023

Cette rubrique décrit l'utilisation de l'exemple de modèle pour le déploiement d'une application.

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 le début de l'installation et de l'importation de l'application, ainsi qu'une fois la désinstallation terminée. Les scripts de post-traitement sont appelés après la fin de l'installation et de l'importation de l'application, ainsi qu'avant le début de la désinstallation.

Vous pouvez écrire de tels scripts pour qu'ils soient appelés pour chacune de ces opérations. Vous pouvez également les configurer de manière à ce qu'ils soient exécutés uniquement après l'une d'entre elles. 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 illustre l'écriture et le déploiement d'un script de façon à ce qu'il soit appelé avant ou après une seule opération. Pour ce faire, écrivez un script chargé de vérifier les valeurs de trois variables d'environnement pour déterminer le contexte de l'opération au sein duquel le script est appelé. En fonction de ce contexte, le script continue ou interrompt l'exécution.

Cette rubrique présente les étapes suivantes :

Définition de l'emplacement du fichier journal, de manière à pouvoir générer un fichier journal des opérations du script.

Notes

Il est recommandé de toujours générer un fichier journal pour vérifier les opérations de script et résoudre les problèmes éventuels.
Création d'une application BizTalk et ajout des exemples de scripts à celle-ci.
Export d'un fichier .msi contenant les artefacts de l'application.
Suppression de l'application dans le groupe BizTalk, de manière à y importer de nouveau le fichier .msi et l'installer à partir de ce fichier.
Importation de l'application et vérification du fichier journal pour s'assurer de la réussite de l'opération.
Installation de l'application et vérification du fichier journal pour s'assurer que le journal d'installation y a bien été ajouté.
Affichage des fichiers journaux et consignation de la nature et de l'heure des opérations réalisées par les scripts.

Fonctions de l'exemple

Deux fichiers .bat fournis avec cet exemple contiennent les valeurs des variables d'environnement pour les opérations d'importation, d'installation et de désinstallation. Le fichier SamplePreProcessing.bat inclut les variables d'un script de pré-traitement. Le fichier SamplePostProcessing.bat inclut les variables d'un script de post-traitement. Les fichiers présentent également la méthode d'enregistrement des messages à partir de scripts. Vous pouvez copier les sections appropriées dans vos scripts.

Important

Certains commentaires contenus dans les fichiers de script sont incorrects, à savoir :

Dans le fichier SamplePreProcessing.bat, le commentaire de script « Pré-désinstallation du script appelée pour une application existante » devrait plutôt afficher « Post-désinstallation du script appelée pour une application existante ».

Dans le fichier SamplePostProcessing.bat, le commentaire de script « Post-désinstallation du script appelée pour une application existante » devrait plutôt afficher « Pré-désinstallation du script appelée pour une application existante ».

Accès à l'exemple

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

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

Comme indiqué précédemment, l'exemple inclut les deux fichiers suivants :

SamplePreProcessing.bat
SamplePostProcessing.bat

Guide pratique pour utiliser cet exemple

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

Pour définir l'emplacement des journaux

Ouvrez les exemples de scripts et modifiez la variable LogFile de sorte qu'elle renvoie à l'emplacement dans lequel les fichiers journaux doivent être générés. Vous devez indiquer le chemin d'accès complet, y compris le nom de fichier. S’il comprend des espaces, vous devez placer le chemin entre guillemets doubles (« ).

Exemple :

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

Pour créer une application

Cliquez sur Démarrer, sur Tous les programmes, sur Microsoft BizTalk Server 20xx, puis sur administration BizTalk Server.
Dans l'arborescence de la console, développez Administration de BizTalk Server, puis développez le groupe BizTalk.
Cliquez avec le bouton droit sur Applications , puis cliquez sur Nouveau.
Dans Nom de l’application, tapez SamplesTemplate, puis cliquez sur OK.

Pour ajouter les scripts à l'application

Développez le dossier de l’application SamplesTemplate que vous venez de créer, puis cliquez avec le bouton droit sur Ressources dans le volet gauche.
Pointez sur Ajouter et cliquez sur Scripts de prétraitement.
Cliquez sur Ajouter et accédez à SamplePreProcessing.bat.
Sélectionnez le fichier et cliquez sur Ouvrir.
Dans Type de fichier, cliquez sur System.BizTalk :PreprocessingScript, puis sur OK.

Le fichier SamplePreProcessing.bat est ajouté à l'application, et affiché dans le dossier Ressources associé.
Cliquez de nouveau avec le bouton droit sur Ressources, pointez sur Ajouter, puis cliquez sur Scripts de post-traitement.
Cliquez sur Ajouter et accédez à SamplePostProcessing.bat.
Sélectionnez le fichier et cliquez sur Ouvrir.
Dans Type de fichier, cliquez sur System.BizTalk :PostprocessingScript, puis sur OK.

Le fichier SamplePostProcessing.bat est ajouté à l'application, et affiché dans le dossier Ressources associé.

Pour exporter un fichier .msi

Dans la console Administration BizTalk Server, cliquez avec le bouton droit sur l’application SamplesTemplate, pointez sur Exporter, puis cliquez sur Fichier MSI.
Dans la page Bienvenue dans l’Assistant Exportation, cliquez sur Suivant.
Dans la page Sélectionner des ressources, cliquez sur Suivant.
Dans la page Spécifier les hôtes IIS, cliquez sur Suivant.
Dans la page Dépendances, cliquez sur Suivant.
Dans la page Destination, dans Nom de l’application de destination, tapez le nom de l’application.
Dans le fichier MSI à générer, tapez le chemin d’accès complet du fichier MSI, puis cliquez sur Exporter. Exemple : C:\MSI\SamplesTemplate.msi
Sur la page Résumé, cliquez sur Terminer.

Supprimer l’application

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

Pour importer le fichier .msi

Dans la console Administration BizTalk Server, cliquez avec le bouton droit sur Applications, pointez sur Importer, puis cliquez sur Fichier MSI.
Dans la page Bienvenue dans l’Assistant Importation, dans le fichier MSI à importer, tapez le chemin 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 (....) .
Dans la page Paramètres de l’application, dans la liste déroulante Nom de l’application, sélectionnez le nom de l’application.
Dans Applications disponibles auxquelles ajouter des références, sélectionnez les applications auxquelles ajouter des références, le cas échéant, puis cliquez sur Suivant.
Dans la page Paramètres de l’environnement cible de l’application, cliquez sur Suivant.

Notes

Il est inutile de spécifier un environnement cible dans le cadre de cet exemple. Pour obtenir des informations générales sur cette fonctionnalité, consultez Liaison de fichiers et déploiement d’applications. Pour obtenir des instructions sur l’ajout de fichiers de liaison, consultez Guide pratique pour ajouter un fichier de liaison à une application.
Dans la page Résumé de l’importation, vérifiez que les informations récapitulatives sont correctes, puis cliquez sur Importer.
Dans la page Résultats, cliquez sur Terminer.
Ouvrez le fichier journal créé lors de l'exécution des scripts, puis vérifiez que l'opération d'importation y a été consignée.

Pour installer l'application

Double-cliquez sur le fichier .msi, puis exécutez l'Assistant Installation.
Ouvrez le fichier journal, puis vérifiez que l'opération d'installation y a été consignée.

Pour vérifier le bon fonctionnement des scripts

Ouvrez les fichiers journaux, puis vérifiez qu'ils ont été exécutés lors des opérations spécifiées.

Voir aussi

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