Partager via

Ajout d'un composant COM à une application

  • Article

Cette rubrique décrit comment ajouter un composant COM à une application BizTalk à l'aide de la console Administration de BizTalk Server ou de l'invite de commandes :

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

  • Si vous souhaitez remplacer un composant COM existant déjà dans l'application, précisez l'option de remplacement. L’option permettant d'écraser n’est nécessaire que lorsque les deux artefacts sont dotés du même identificateur local unique (LUID). Si cette option n'est pas spécifiée, et qu'un composant COM 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.

  • BizTalk Server ne vérifie pas la présence des dépendances des composants COM, c’est pourquoi vous devez vérifiez que tous les artefacts dont dépend le composant sont présents.

  • Si vous ajoutez un composant COM ou COM+ non managé pour ordinateur 64 bits et essayez d'installer l'application comprenant ledit composant sur un ordinateur 32 bits, vous n'y parviendrez pas. Un tel composant ne peut être installé que sur un ordinateur 64 bits.

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 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 BizTalk Server.

  2. Dans l’arborescence de la console, développez BizTalk Server Administration, développez le groupe BizTalk, applications, puis 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, sélectionnez ou désactivez la zone d’case activée Inscrire le fichier à destination (regsvr32) selon que vous souhaitez ou non ajouter le composant au Registre Windows lorsque l’application est installée.

  7. Dans Destination, tapez le chemin d’accès 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 lors de l'installation. Ce chemin d’accès est obligatoire si vous avez sélectionné la zone Inscrire le fichier à destination (regsvr32) case activée à 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, 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 :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 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 :Com (cette valeur ne respecte pas la casse.)
    /Écraser Option permettant de mettre à jour un composant COM existant. Si cette option n'est pas spécifiée et qu'un composant COM, dont l’identificateur unique local LUID est le même que celui du composant COM à 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.
    /Source Chemin d'accès complet du fichier de composant COM, 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 .dll du composant COM 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. Par conséquent, le composant ne peut pas être ajouté au Registre Windows au cours de cette installation. Si le chemin d'accès comprend des espaces, vous devez le placer entre guillemets doubles ("). Si vous définissez le paramètre Regsvr32OnInstallOption, vous devez également définir le paramètre Destination.
    /Options Regsvr32OnInstall. Permet d'ajouter le composant COM 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.
    /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 : composant COM
Création et modification des applications BizTalk