Partager via

Ajout d'un artefact BAM à une application

  • Article

Cette rubrique explique comment ajouter un artefact BAM à une application BizTalk à l'aide de la console Administration de BizTalk Server ou de la ligne de commande. L'ajout d'un fichier de définition BAM n'entraîne pas le déploiement de la définition BAM. Celle-ci est déployée lors de l'importation du fichier .msi de l'application.

Pour remplacer un artefact BAM qui existe déjà dans l'application, précisez l'option de remplacement. L’option de remplacement est requise uniquement lorsque l’artefact BAM existant a le même nom de fichier que celui que vous souhaitez ajouter. S’il n’est pas spécifié et que l’artefact BAM existe déjà dans l’application avec le même nom de fichier que celui ajouté, l’opération d’ajout échoue.

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 artefact BAM à une application

Utilisation de la console Administration de BizTalk Server

  1. Cliquez sur Démarrer, sur Al Programs, 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 un fichier d’artefact BAM.

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

  4. Cliquez sur Ajouter, sélectionnez le fichier de l’artefact BAM, puis cliquez sur Ouvrir.

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

  6. Dans Destination, tapez le chemin d’accès complet de l’emplacement où le fichier d’artefact doit être copié lorsque l’application est installée à partir du fichier .msi, y compris le nom du fichier. Si ce chemin n'est pas défini, le fichier ne sera pas copié dans le système de fichiers local lors de l'installation, mais il sera déployé lors de l'importation du fichier .msi.

    Exemple : C :\My Applications\MyBAMfile.xml

  7. 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 :Bam [/Overwrite] /Source :value [/Destination :value] [/Server :value] [/Database :value]

    Exemple :

    BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Bam /Overwrite /Source:"C:\Source BAMfiles\MyBAMfile.xml" /Destination:"%BTADInstallDir%\ BAMfiles\MyBAMfile.xml" /Server:MyDatabaseServer /Database:BizTalkMgmtDb

    Paramètre Valeur
    /Applicationname Nom de l'application BizTalk à laquelle ajouter l'artefact BAM. 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 :Bam (cette valeur ne respecte pas la casse.)
    /Écraser Option permettant de remplacer un artefact BAM. Si cette option n'est pas spécifiée et qu'un artefact BAM, dont le nom de fichier est le même que celui de l'artefact BAM à ajouter, existe déjà dans l'application, l'opération AddResource échoue.
    /Source Chemin d'accès complet de l'artefact BAM, 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'artefact BAM 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. Si le chemin d'accès comprend des espaces, vous devez le placer entre guillemets doubles ("). Vous pouvez utiliser la variable d'environnement %BTADInstallDir% dans le chemin d'accès pour spécifier le dossier d'installation de l'application.
    /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 : artefact BAM
Création et modification des applications BizTalk
Importer une application BizTalk