Ajouter un fichier de liaison à une application

Vue d’ensemble

Utilisez la console Administration BizTalk Server ou la ligne de commande pour ajouter un fichier de liaison à une application BizTalk. Vous pouvez effectuer cette opération pour faciliter le déploiement d’applications ou d’assemblys, comme décrit dans Fichiers de liaison et Déploiement d’applications.

Vous pouvez exporter des liaisons dans un fichier .xml à partir d’une application BizTalk pour un assembly, une application ou un groupe, comme décrit dans Exportation de liaisons, puis utiliser l’une des procédures de cette rubrique pour ajouter le fichier de liaison à une application.

Dans ce cas, le fichier de liaison est ajouté à base de données de gestion BizTalk et s'affiche dans la console Administration de BizTalk Server, dans le dossier Ressources de l'application. Contrairement à l'importation d'un fichier de liaison, l'ajout d'un tel fichier ne s'applique pas immédiatement aux liaisons existantes. Au lieu de cela, les liaisons sont appliquées lorsque l'application est importée dans un autre groupe BizTalk.

Important

Pour des raisons de sécurité, lorsque vous exportez des liaisons, BizTalk Server ne conserve pas les mots de passe des liaisons du fichier. Une fois les liaisons importées, vous devez reconfigurer les mots de passe des ports d'envoi et des emplacements de réception pour qu'ils fonctionnent. Vous configurez ces mots de passe dans la boîte de dialogue Propriétés du transport de la console Administration de BizTalk Server pour le port d'envoi ou l'emplacement de réception. Consultez Créer un port d’envoi ou Créer un emplacement de réception.

Notes

Lorsque vous utilisez un fichier de liaison, vous devez vérifier que les artefacts ont été liés à l’hôte correct et que le niveau d’approbation est approprié.

Lorsque vous ajoutez un fichier de liaison à une application, vous pouvez spécifier une valeur pour l'environnement de déploiement cible avec une chaîne qui représente l'environnement, telle que Test ou Production. Vous pouvez utiliser la chaîne de votre choix pour cette valeur. Ensuite, lorsque vous importez l'application, vous pouvez sélectionner le fichier de liaison à appliquer, en fournissant la valeur spécifiée pour son environnement de déploiement cible. Ce faisant, les liaisons sont appliquées depuis le fichier de liaison. Toutes les liaisons existant dans l'application, portant le même nom que les liaisons du fichier, sont automatiquement remplacées.

Lorsque vous importez une application, les liaisons sont appliquées dans l'ordre suivant. À mesure que des liaisons sont appliquées au cours du processus d'importation, les liaisons déjà appliquées sont remplacées par de nouvelles liaisons qui portent le même nom. Autrement dit, la liaison d'un nom donné la plus récente est celle qui est effectivement appliquée.

1. Liaisons d'application générées par BizTalk Server, n'ayant pas été explicitement ajoutées à l'application au moyen d'un fichier de liaison, mais ayant été sélectionnées par l'utilisateur pour leur exportation dans le fichier .msi de l'application.

2. Fichiers de liaison ajoutés de manière explicite mais pour lesquels aucun environnement de déploiement cible n'a été défini. À l'intérieur de cet ensemble, l'application des liaisons ne respecte pas d'ordre particulier.

3. Liaisons ajoutées de manière explicite auxquelles est associé un environnement de déploiement cible correspondant à l'environnement de déploiement sélectionné pour l'importation de l'application. À l'intérieur de cet ensemble, l'application des liaisons ne respecte pas d'ordre particulier.

   Pour plus d’informations sur l’importation d’applications et l’application de liaisons, consultez Importer une application BizTalk.

Prérequis

Connectez-vous avec un compte membre du groupe Administrateurs BizTalk Server. Autorisations requises pour le déploiement et la gestion d’une application BizTalk fournit plus de détails.

Ajouter un fichier de liaison à l’aide de BizTalk Administration

1. Ouvrez BizTalk Server Administration (dans le menu Démarrer).

2. Développez BizTalk Server Administration, développez le groupe BizTalk, développez Applications, puis cliquez avec le bouton droit sur l’application à laquelle vous souhaitez ajouter un fichier de liaison.

3. Pointez sur Ajouter, puis cliquez sur Ressources.

4. Cliquez sur Ajouter, sélectionnez le fichier à ajouter, puis cliquez sur Ouvrir.

5. Pour remplacer un fichier de liaison existant dans cette application portant le même nom de fichier, sélectionnez la zone Remplacer tous les case activée. Si vous ne spécifiez pas cette option et qu'un fichier du même nom existe déjà dans l'application, l'opération d'ajout échouera.

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

7. Dans Environnement cible, tapez une chaîne pour représenter l’environnement de déploiement cible dans lequel vous souhaitez appliquer les liaisons de ce fichier, telles que Test, puis cliquez sur OK.

   Important

   Si vous laissez ce champ vierge, les liaisons de ce fichier seront appliquées à l'importation de l'application.

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

Ajouter un fichier de liaison à l’aide de la ligne de commande

1. Ouvrez une invite de commandes (dans le menu >Démarrer, sélectionnez cmd>Invite de commandes).

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 :BizTalkBinding [/Overwrite] /Source :value/Property :TargetEnvironment="value » [/Server :value] [/Database :value]

   Exemple :

   BTSTask AddResource /ApplicationName :"My Application » /Type :System.BizTalk :BizTalkBinding /Source :"C :\Binding Files\MyBinding.xml » /Property :TargetEnvironment="Production » /Server :MyDatabaseServer /Database :BizTalkMgmtDb

   Paramètre	Valeur
   /Applicationname	Nom de l'application BizTalk à laquelle ajouter le fichier de liaison. 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 :BizTalkBinding (cette valeur ne respecte pas la casse.)
   /Écraser	Option permettant de mettre à jour un fichier de liaison existant. Si ce fichier n’est pas spécifié et s’il existe déjà un fichier de liaison dans l’application portant le même nom de fichier que le fichier ajouté, l’opération AddResource échoue.
   /Source	Chemin d'accès complet du fichier de liaison, nom du fichier inclus. Si le chemin d'accès comprend des espaces, vous devez le placer entre guillemets doubles (").
   /Property:TargetEnvironment=	Chaîne indiquant l'environnement de déploiement cible. Vous pouvez la chaîne de votre choix (ex. : Production). Exemple : /Property :TargetEnvironment="Production » Si elle n’est pas spécifiée, la valeur <Default> est automatiquement appliquée. La valeur est sensible à la casse. Si elle comprend des espaces, vous devez la placer entre guillemets doubles ("). La longueur maximale de cette valeur ne doit pas dépasser 128 caractères.
   /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 : liaison BizTalk
Création et modification des applications BizTalk