Partager via

Ajout d'un assembly .NET à une application

  • Article

Cette rubrique décrit comment ajouter un assembly .NET qui n'est pas un assembly BizTalk à une application BizTalk à l'aide de la console Administration de BizTalk Server ou de la ligne de commande. Lorsque vous ajoutez un assembly .NET à une application, gardez les points importants suivants à l'esprit :

  • Si vous souhaitez remplacer un assembly existant déjà dans l'application, précisez l'option de remplacement. L'option de remplacement est nécessaire uniquement si les deux assemblys ont le même LUID. Si cette option n'est pas spécifiée, et qu'un assembly ayant le même LUID que celui en cours d'ajout existe déjà dans l'application, l'opération d'ajout échoue. Vous pouvez afficher les LUID des artefacts dans une application à l’aide de la commande ListApp.

  • Lorsque vous ajoutez un assembly .NET, 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. Sélectionnez cette option si votre application comprend une stratégie et un assembly dont dépend la stratégie. Vous devez procéder ainsi car lorsque vous importez une application contenant une stratégie, tous les assemblys dont dépend la stratégie doivent être présents dans le GAC.

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

    • Rendre visible aux composants COM (regasm). 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, un assembly COM géré est ajouté au Registre Windows sur l'ordinateur local au cours de la procédure d'installation. Si vous spécifiez cette option, vous devez également préciser un emplacement pour le fichier dans Destination.

    • Inscrire les composants traités (regsvcs). 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, un assembly COM+ géré est ajouté au Registre Windows sur l'ordinateur local au cours de la procédure d'installation. Si vous spécifiez cette option, vous devez également préciser un emplacement pour le fichier dans Destination.

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 assembly .NET à 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, développez le groupe BizTalk, développez Applications, puis développez l’application à laquelle vous souhaitez ajouter l’assembly .NET.

  3. Cliquez avec le bouton droit sur le dossier Ressources , pointez sur Ajouter, puis cliquez sur Ressources.

  4. Cliquez sur Ajouter, sur l’assembly, puis sur Ouvrir.

  5. Dans la liste déroulante Type de fichier, sélectionnez System.BizTalk :Assembly.

  6. Dans Options, sélectionnez les options de déploiement pour cet assembly.

  7. Dans Destination, tapez le chemin d’accès complet de l’emplacement où le fichier doit être copié lorsque l’application est installée à partir du fichier .msi, y compris le nom du fichier. Si ce chemin d'accès n'est pas fourni, le fichier n'est pas copié dans le système de fichiers local lors de l'installation. Pour copier le fichier dans le dossier d'installation de l'application, vous pouvez inclure dans le chemin d'accès la variable d'environnement %BTAD_InstallDir%, qui extrait la valeur du dossier d'installation de l'application au moment où l'application est installée. Ainsi, vous n'avez pas besoin de connaître le chemin d'accès au dossier d'installation de l'application lorsque vous indiquez l'emplacement de destination.

    Exemple : %BTADInstall_Dir%\Assemblies\Orchestrations.dll

  8. Cliquez sur l’onglet Dépendances et affichez les artefacts dont dépend cet assembly.

  9. Si un artefact dont dépend cet assembly n’est pas présent dans cette application et que vous souhaitez l’ajouter, cliquez sur Ajouter à l’application, accédez à l’artefact, puis cliquez sur Ouvrir.

  10. Lorsque vous avez terminé, 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 remplaçant par les valeurs appropriées, comme décrit dans le tableau suivant.

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

    Exemple :

    BTSTask AddResource /ApplicationName :MyApplication /Type :System.BizTalk :Assembly /Overwrite /Source :"C :\Source Assemblies\MyAssembly.dll » /Destination :"%BTAD_InstallDir%\New Assemblies\MyAssembly.dll » /Options :GacOnAdd,RegasmOnInstall /Server :MyDatabaseServer /Database :BizTalkMgmtDb

    Paramètre Valeur
    /Applicationname Nom de l'application BizTalk à laquelle ajouter l'assembly. Si le nom de l'application n'est pas spécifié, l'application utilisée est l'application BizTalk définie par défaut pour le groupe. Si le nom comprend des espaces, vous devez le placer entre guillemets doubles (« ).
    /Type System.BizTalk :Assembly (cette valeur ne respecte pas la casse.)
    /Écraser Option permettant de mettre à jour un assembly existant. Si cette option n'est pas spécifiée et qu'un assembly, dont le nom complet est le même que celui de l'assembly à ajouter, existe déjà dans l'application, l'opération AddResource échoue. Le nom complet de l'assembly se compose de son nom de fichier, 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.
    /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 comprend des espaces, vous devez le placer entre guillemets doubles ("). Si vous spécifiez l'option RegasmOnInstall ou RegsvcsOnInstall, vous devez également spécifier Destination. Note: Vous pouvez utiliser la variable d’environnement %BTAD_InstallDir% dans le chemin d’accès. Elle extrait la valeur du dossier d'installation de l'application au moment où l'application est installée. Ainsi, vous n'avez pas besoin de connaître le chemin d'accès au dossier d'installation de l'application lorsque vous indiquez l'emplacement de destination. Exemple : %BTAD_InstallDir%\Assemblies\Orchestrations.dll
    /Options - GacOnAdd : installez l’assembly dans le Global Assembly Cache (GAC) sur l’ordinateur local pendant l’opération AddResource.
    - GacOnInstall : installez l’assembly dans le GAC lorsque l’application est installée à partir du fichier .msi.
    - GacOnImport : installez l’assembly dans le GAC lorsque le fichier .msi de l’application est importé.
    - RegasmOnInstall : ajoutez un assembly COM managé au Registre Windows lorsque l’application est installée à partir du fichier .msi. Si vous définissez cette option, vous devez également définir le paramètre Destination.
    - RegsvcsOnInstall : Ajoutez un assembly COM+ managé au Registre Windows lorsque l’application est installée à partir du fichier .msi. Si vous définissez cette option, vous devez également définir le paramètre Destination.

    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 .NET, certificats et autres ressources
Commande AddResource : assembly .NET
Création et modification des applications BizTalk