Ajout d'un script de prétraitement ou de post-traitement à une application

Article
10/14/2023

Cette rubrique décrit comment ajouter un script de pré-traitement ou de post-traitement à une application à l'aide de la console Administration de BizTalk Server ou de la ligne de commande. Lorsque vous ajoutez un script à une application, le script est inclus dans le fichier .msi de l'application et s'exécute quand l'application est importée, installée ou désinstallée.

Lorsque vous ajoutez un script, vous devez préciser s'il s'agit d'un script de pré-traitement qui s'exécute avant l'importation ou l'installation d'une application, ou d'un script de post-traitement qui s'exécute après l'importation ou l'installation. Les scripts de prétraitement et de post-traitement s’exécutent également lors de la désinstallation, dans l’ordre opposé à celui dans lequel ils s’exécutaient lors de l’installation : les scripts de prétraitement s’exécutent après la désinstallation et les scripts de post-traitement s’exécutent avant la désinstallation.

Vous pouvez également supprimer un script d'une application. Pour obtenir des instructions, consultez Comment supprimer un script de prétraitement ou de post-traitement d’une application.

Prérequis

Pour effectuer les procédures décrites dans cette rubrique, vous devez être connecté avec un compte membre du groupe administrateurs BizTalk Server. Pour plus d’informations sur les autorisations, consultez Autorisations requises pour le déploiement et la gestion d’une application BizTalk.

Pour ajouter un script à une application

Utilisation de la console Administration de BizTalk Server

Cliquez sur Démarrer, sur Tous les programmes, sur Microsoft BizTalk Server 20xx, puis sur administration BizTalk Server.
Développez le groupe BizTalk, puis Applications, et cliquez avec le bouton droit sur le dossier de l'application à laquelle vous souhaitez ajouter un script.
Pointez sur Ajouter et effectuez l’une des opérations suivantes :
- Cliquez sur Scripts de prétraitement si vous souhaitez que le script s’exécute avant le début de l’importation ou de l’installation de l’application ou après la désinstallation.
- Cliquez sur Scripts de post-traitement si vous souhaitez que le script s’exécute après l’importation ou l’installation de l’application, ou avant la désinstallation.
Cliquez sur Ajouter et accédez au fichier de script à ajouter.
Sélectionnez le fichier de script, puis cliquez sur Ouvrir.
Si vous souhaitez remplacer un fichier de script qui existe déjà dans l’application, sélectionnez la zone Remplacer tous les case activée. Le fichier de script doit porter le même nom que celui qui doit être remplacé. Sinon, le nouveau script est ajouté et le script existant demeure inchangé dans l'application.
Cliquez sur la liste déroulante Type de fichier, puis sur le type de fichier : System.BizTalk :PreprocessingScript ou System.BizTalk :PostprocessingScript.
Si nécessaire, dans Emplacement de destination, tapez le chemin d’accès où vous souhaitez que le fichier de script soit copié lors de l’installation de l’application, puis cliquez sur OK. Le chemin d'accès par défaut installe le script dans le dossier d'installation de l'application (%BTAD_InstallDir%).

Notes

Si vous n'indiquez pas de chemin d'accès, le script ne sera pas copié dans le système de fichiers local lors de l'installation. Si ce script doit être exécuté pendant la désinstallation d'une application, vous devez indiquer le chemin d'accès, sinon le script ne sera pas copié dans le système de fichiers local et ne pourra pas être exécuté pendant une désinstallation.

Le script est ajouté à l'application et s'affiche dans le dossier Ressources de l'application.

Utilisation de la ligne de commande

Ouvrez une invite de commandes comme suit : cliquez sur Démarrer, sur Exécuter, tapez cmd, puis cliquez sur OK.

Tapez la commande suivante en utilisant les valeurs appropriées, comme décrit dans le tableau suivant :

BTSTask AddResource [/ApplicationName :value] /Type :System.BizTalk :PreProcessingScript|System.BizTalk :PostProcessingScript [/Overwrite] /Source :value [/Destination :value] [/Server :value] [/Database :value][/Property :Args="argument list"]

Exemple :

BTSTask AddResource /ApplicationName :MyApplication /Type :System.BizTalk :PreProcessingScript /Overwrite /Source :"C :\Source Scripts\MyScript.vbs » /Destination :"C :\New Scripts\MyScript.vbs » /Server :MyDatabaseServer /Database :BizTalkMgmtDb /Property :Args="argument1 argument2 »

Paramètre	Valeur
/Applicationname	Nom de l'application BizTalk à laquelle ajouter le script. Si le nom de l'application n'est pas spécifié, l'application utilisée est l'application BizTalk définie par défaut. Si le nom comprend des espaces, vous devez le placer entre guillemets doubles (« ).
/Type	System.BizTalk :PreProcessingScript ou System.BizTalk :PostProcessingScript, selon le type de script à ajouter. Utilisez System.BizTalk :PreProcessingScript si vous souhaitez que le script s’exécute avant l’importation ou l’installation de l’application ou après la désinstallation. Utilisez System.BizTalk :PostProcessingScript si vous souhaitez que le script s’exécute après l’importation ou l’installation de l’application, ou avant la désinstallation.
/Écraser	Met à jour un script existant. Si cette option n'est pas spécifiée et qu'un script, dont le nom est le même que celui du fichier de script à ajouter, existe déjà dans l'application, l'opération d'ajout échoue.
/Source	Chemin d'accès complet du fichier de script, nom du fichier inclus. Si le chemin d'accès comprend des espaces, vous devez le placer entre guillemets doubles (").
/Destination	Chemin d'accès complet de l'emplacement où le fichier de script doit être copié lorsque l'application est installée à partir du fichier .MSI. Si ce paramètre n'est pas défini, le fichier n'est pas copié dans le système de fichiers local lors de l'installation. Si le chemin d'accès comprend des espaces, vous devez le placer entre guillemets doubles (").
/Serveur	Nom de l'instance SQL Server hébergeant la base de données de gestion BizTalk et indiqué sous la forme NomServeur\NomInstance,Port. Le nom de l'instance est uniquement requis lorsqu'il est différent du nom du serveur. Le port est uniquement requis lorsque le serveur SQL Server utilise un numéro de port autre que celui par défaut (1433). Exemples : Server=MyServer Server=MyServer\MySQLServer,1533 Si vous n'indiquez pas de nom pour l'instance SQL Server, le nom d'instance utilisé est celui de l'instance SQL Server exécutée sur l'ordinateur local.
/Base	Nom de la base de données de gestion BizTalk. Si vous ne l'indiquez pas, la base de données utilisée est la base de données de gestion BizTalk s'exécutant au sein de l'instance locale de SQL Server.
/Property:Args=	Zéro ou plusieurs arguments. Les arguments fournis ici sont transmis au script lorsque ce dernier est appelé.

Voir aussi

Gestion des scripts de prétraitement et de post-traitement
Commande AddResource : script de prétraitement
Commande AddResource : script de post-traitement

Share via