Ajout d'un assembly BizTalk à une application

  • Article

Cette rubrique décrit comment ajouter un assembly BizTalk à une application à l'aide de la console Administration de BizTalk Server ou de la ligne de commande.

Lorsque vous ajoutez un assembly BizTalk à une application, gardez les points importants suivants à l'esprit :

  • Si vous voulez ajouter un assembly et replacer un assembly ayant le même LUID que celui qui existe déjà dans l'application, sélectionnez l'option Remplacer. S’il n’est pas spécifié et qu’un assembly qui a le même LUID que l’assembly ajouté existe déjà dans l’application, l’opération échoue. Le LUID de l'assembly se compose du nom de fichier de l'assembly, d'un jeton de clé publique, de sa culture et de sa version. Vous pouvez afficher les LUID des artefacts dans une application à l’aide de la commande ListApp.

  • L'opération d'ajout échoue également si l'assembly que vous ajoutez dépend d'un artefact qui n'est pas inclus dans l'application.

  • Lorsque vous ajoutez un assembly BizTalk, vous pouvez préciser une ou plusieurs des options suivantes pour installer l'assembly dans le GAC (global assembly cache) :

    • Ajouter au Global Assembly Cache lors de l'ajout de la ressource (gacutil) : Si vous sélectionnez cette option, l'assembly est installé dans le GAC sur l'ordinateur local lorsque l'assembly est ajouté à une application, suite à l'utilisation des procédures de cette rubrique.

    • Ajouter au Global Assembly Cache lors de l'importation du fichier MSI (gacutil) : Lorsque vous sélectionnez cette option, si l'application est exportée vers un fichier .msi et que le fichier .msi est importé dans un groupe BizTalk, l'assembly est installé dans le GAC sur l'ordinateur local au cours de la procédure d'importation.

    • Ajouter au Global Assembly Cache lors de l'installation du fichier MSI (gacutil) : Lorsque vous sélectionnez cette option, si l'application est exportée vers un fichier .msi et que l'application est installée sur un ordinateur à partir du fichier .msi, l'assembly est installé dans le GAC sur l'ordinateur local au cours de la procédure d'installation.

Prérequis

Pour effectuer les procédures de 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 assembly BizTalk à une application

Utilisation de la console Administration de BizTalk Server

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

  2. Dans l’arborescence de la console, développez BizTalk Server Administration et le groupe BizTalk contenant l’application à laquelle vous souhaitez ajouter l’assembly BizTalk.

  3. Développez Applications, ainsi que l'application à laquelle vous souhaitez ajouter l'assembly BizTalk.

  4. Cliquez avec le bouton droit sur Ressources, pointez sur Ajouter , puis cliquez sur Assemblys BizTalk.

  5. Cliquez sur Ajouter, sélectionnez le fichier d’assembly BizTalk, puis cliquez sur Ouvrir.

  6. Dans Destination, tapez le chemin d’accès complet de l’emplacement où le fichier d’assembly doit être copié lorsque l’application est installée à partir du fichier .msi, y compris le nom du fichier. S’il n’est pas fourni, le fichier d’assembly n’est pas copié dans le système de fichiers local pendant l’installation.

  7. Dans Options, spécifiez les options d’installation de l’assembly BizTalk sur le GAC, puis cliquez sur OK.

Utilisation de la ligne de commande

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

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

    BTSTask AddResource [/ApplicationName :value] /Type :System.BizTalk :BizTalkAssembly [/Overwrite] /Source :value [/Destination :value] [/Options :GacOnAdd|GacOnInstall|GacOnImport] [/Server :value] [/Database :value]

    Exemple :

    BTSTask AddResource /ApplicationName :MyApplication /Type :System.BizTalk :BizTalkAssembly /Overwrite /Source :"C :\BizTalk Assemblies\MyOrchestration.dll » /Destination :"C :\New BizTalk Assemblys\ MyOrchestration.dll " /Server :MyDatabaseServer /Database :BizTalkMgmtDbDb

    Paramètre Valeur
    /Applicationname Nom de l'application BizTalk à laquelle ajouter l'assembly BizTalk. 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:BizTalkAssembly
    /Écraser Option permettant de mettre à jour un assembly existant. Si cette option n'est pas spécifiée et qu'un assembly, dont le LUID est le même que celui de l'assembly à ajouter, existe déjà dans l'application, l'opération AddResource échoue. Vous pouvez afficher les LUID des artefacts dans une application à l’aide de la commande ListApp. Si une autre application dépend de l'assembly qui doit être remplacé, l'opération AddResource échoue, même lorsque ce paramètre est spécifié.
    /Source Chemin d'accès complet du fichier de l'assembly, 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 l'assembly doit être copié lorsque l'application est installée à partir du fichier .msi. S’il n’est pas fourni, le fichier d’assembly n’est pas copié dans le système de fichiers local pendant l’installation. Si le chemin d'accès comprend des espaces, vous devez le placer entre guillemets doubles (").
    /Options - GacOnAdd : spécifiez pour installer l’assembly sur le global assembly cache (GAC) sur l’ordinateur local pendant l’opération AddResource.
    - GacOnInstall : spécifiez d’installer l’assembly sur le GAC lorsque l’application est installée à partir du fichier .msi.
    - GacOnImport : spécifiez d’installer l’assembly sur le GAC lorsque l’application .msi fichier est importé.

    Si vous spécifiez plusieurs options, séparez-les par des virgules.
    /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.

Voir aussi

Gestion des assemblys BizTalk
Commande AddResource : Assembly BizTalk