Partager via

Comment ajouter un composant COM à une application

Cette rubrique explique comment utiliser la console Administration de BizTalk Server ou la ligne de commande pour ajouter un composant COM à une application BizTalk :

Lors de l’ajout d’un composant COM à une application, gardez à l’esprit les points importants suivants :

  • Si vous souhaitez remplacer un composant COM qui existe déjà dans l’application, spécifiez l’option Remplacer. L’option de remplacement est requise uniquement lorsque les deux artefacts ont le même identificateur unique localement (LUID). S’il n’est pas spécifié et qu’un composant COM existe déjà dans l’application avec le même LUID que celui ajouté, l’opération d’ajout échoue. Vous pouvez afficher les LUID pour les artefacts d’une application à l’aide de la commande ListApp.

  • BizTalk Server ne vérifie pas les dépendances des composants COM pour vérifier qu’ils sont présents. Vous devez donc vérifier que tous les artefacts sur lesquels dépend le composant sont présents.

  • Si vous ajoutez un composant COM ou COM+ non managé 64 bits et que vous tentez d’installer l’application qui inclut le composant COM ou COM+ sur un ordinateur 32 bits, le composant n’est pas installé. Il s’installe uniquement sur un ordinateur 64 bits.

Conditions préalables

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 composant COM à une application

Utilisation de la console Administration de BizTalk Server

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

  2. Dans l’arborescence de la console, développez Administration de BizTalk Server, développez le groupe BizTalk, développez Applications, puis développez l’application à laquelle vous souhaitez ajouter un composant COM.

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

  4. Cliquez sur Ajouter, sélectionnez le composant COM, puis cliquez sur Ouvrir.

  5. Dans la liste déroulante Type de fichier , cliquez sur System.BizTalk :Com.

  6. Dans Options, activez ou désactivez la case à cocher Inscrire le fichier à destination (regsvr32) selon que vous souhaitez que le composant soit ajouté au Registre Windows lorsque l’application est installée.

  7. Dans Destination, tapez le chemin complet de l’emplacement où le composant COM 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 pendant l’installation. Ce chemin d’accès est requis si vous avez sélectionné la case à cocher Inscrire le fichier à destination (regsvr32) à l’étape précédente.

    Exemple : %BTAD_InstallDir%\MyComponent.dll

  8. 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, cliquez sur Exécuter, tapez cmd, puis cliquez sur OK.

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

    BTSTask AddResource [/ApplicationName :value] /Type :System.BizTalk :Com [/Overwrite] /Source :value [/Destination :value] [/Options :Regsvr32OnInstall] [/Server :value] [/Database :value]

    Exemple:

    BTSTask AddResource /ApplicationName :MyApplication /Type :System.BizTalk :Com /Overwrite /Source :«C:\Source Components\COM.dll» /Destination :«C:\New Components\COM.dll» /Options :Regsvr32OnInstall /Server :MyDatabaseServer /Database :BizTalkMgmtDb

    Paramètre Valeur
    /ApplicationName Nom de l’application BizTalk à laquelle ajouter le composant COM. Si le nom de l’application n’est pas spécifié, l’application BizTalk par défaut pour le groupe est utilisée. Si le nom inclut des espaces, vous devez le placer entre guillemets doubles (").
    /Type System.BizTalk :Com (Cette valeur n’est pas sensible à la casse.)
    /Écraser Option de mise à jour d’un composant COM existant. S’il n’est pas spécifié et qu’un composant COM existe déjà dans l’application qui a le même LUID que le composant COM ajouté, l’opération AddResource échoue. Vous pouvez afficher les LUID pour les artefacts d’une application à l’aide de la commande ListApp.
    /Source Chemin complet du fichier du composant COM .dll, y compris son nom. Si le chemin inclut des espaces, vous devez l’inclure entre guillemets doubles (").
    /Destination Chemin complet de l’emplacement où le fichier du composant COM .dll doit être copié lorsque l’application est installée à partir du fichier .msi. S’il n’est pas fourni, le fichier n’est pas copié dans le système de fichiers local pendant l’installation ; par conséquent, le composant ne peut pas être ajouté au Registre Windows pendant l’installation. Si le chemin inclut des espaces, vous devez l’inclure entre guillemets doubles ("). Si vous spécifiez Regsvr32OnInstallOption, vous devez également spécifier Destination.
    /Options Regsvr32OnInstall. Spécifiez d’ajouter le composant COM au Registre Windows lorsque l’application est installée à partir du fichier .msi. Si vous spécifiez cette option, vous devez également spécifier destination.
    /Serveur Nom de l’instance SQL Server hébergeant la base de données de gestion BizTalk, sous la forme ServerName\InstanceName,Port.

    Le nom de l’instance n’est requis que lorsque le nom de l’instance est différent du nom du serveur. Le port n’est requis que lorsque SQL Server utilise un numéro de port autre que la valeur par défaut (1433).

    Exemples:

    Serveur=MyServer

    Server=MyServer\MySQLServer,1533

    S’il n’est pas fourni, le nom de l’instance SQL Server s’exécutant sur l’ordinateur local est utilisé.
    /Base de données Nom de la base de données de gestion BizTalk. Si elle n’est pas spécifiée, la base de données de gestion BizTalk s’exécutant dans l’instance locale de SQL Server est utilisée.

Voir aussi

Gestion des assemblys, certificats et autres ressources .NET
Commande AddResource : composant COM
Création et modification d’applications BizTalk