Importer une application BizTalk

Article
10/14/2023

Cette rubrique décrit comment importer une application BizTalk dans un groupe BizTalk à l'aide de la console Administration de BizTalk Server ou de l'invite de commandes. Importer une application BizTalk inscrit les artefacts dans la base de données de gestion BizTalk et écrit les données des artefacts dans les bases de données BizTalk appropriées. Pour plus d’informations, consultez Ce qui se passe lors de l’importation d’artefacts. Le fait d'importer une application n'installe pas l'application. Vous devez installer une application incluant des artefacts basés sur un fichier pour qu'elle puisse s'exécuter.

Lorsque vous importez une application à l'aide de la console Administration de BizTalk Server, l'emplacement à partir duquel vous lancez l'Assistant MSI d'importation détermine si vous pouvez créer ou non une application pendant que vous importez les artefacts. Si vous démarrez l'Assistant en cliquant avec le bouton droit sur le groupe BizTalk, vous devez fournir un nom d'application. Si une application du groupe BizTalk porte déjà le nom que vous spécifiez, les artefacts du fichier sont importés dans cette application. Dans le cas contraire, une nouvelle application portant le nom spécifié est créée et les artefacts sont importés dans cette application. Si vous lancez l'Assistant en cliquant avec le bouton droit sur une application, vous ne pouvez pas spécifier de nom d'application et les artefacts sont importés dans l'application actuelle.

Lorsque vous utilisez l'outil de ligne de commande BTSTask pour importer un fichier .msi, il n'est pas obligatoire de spécifier un nom d'application. Si vous ne spécifiez pas de nom, les artefacts du fichier sont importés dans l'application par défaut.

Après avoir importé les artefacts, vous pouvez les afficher dans le dossier approprié figurant dans le dossier de l'application sur la console Administration de BizTalk Server. Vous pouvez également afficher une liste d’artefacts dans l’application à l’aide de BTSTask, comme décrit dans Commande ListApp.

Prérequis

Pour importer une application BizTalk, vous devez être connecté avec un compte membre du groupe d'administrateurs BizTalk Server. Pour installer une application BizTalk, vous devez également disposer d'autorisations en écriture sur le système de fichiers local. Pour plus d’informations sur les autorisations, consultez Autorisations requises pour le déploiement et la gestion d’une application BizTalk.

Considérations relatives à l'importation d'applications

Lors de l'importation d'une application, tenez compte des éléments suivants :

Importation d’applications à partir de versions précédentes de BizTalk Server. Si vous importez des applications à partir de BizTalk Server 2006 R2 ou BizTalk Server 2009 et que les applications contiennent des données de partie EDI/AS2, l’importation de l’application peut échouer, car le modèle de gestion des partenaires commerciaux a considérablement changé en BizTalk Server. Vous devez plutôt utiliser l'outil de migration de tiers pour migrer les données de tiers depuis les versions précédentes de BizTalk Server. Pour plus d’informations sur l’outil, consultez Utilitaires de migration EDI.
Les liaisons existantes sont toujours remplacées par les liaisons importées. Lorsque vous importez un fichier .msi contenant des liaisons dans une application existante, les liaisons existantes sont remplacées par celles importées portant le même nom, et ce même si vous n'avez pas sélectionné l'option de remplacement des artefacts existants lors de l'importation du fichier .msi. Pour éviter que les liaisons de l'application exportée ne remplacent les liaisons de l'application dans laquelle vous importez le fichier .msi, ne sélectionnez pas le fichier de liaison en tant que ressource à exporter pendant l'opération d'exportation. Pour plus d’informations, consultez Guide pratique pour exporter une application BizTalk.

À 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. Lorsque vous importez une application, les liaisons sont appliquées dans l'ordre suivant :
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.
L'hôte doit exister dans le groupe. Un hôte correspondant à l'hôte spécifié dans les liaisons d'application contenues dans le fichier .msi doit déjà exister dans le groupe BizTalk, sans quoi l'opération d'importation échoue. En outre, le niveau de confiance de l'hôte doit correspondre.
Vous pouvez avoir à ajouter une référence à une autre application. Si l'application que vous importez est dépendante d'un artefact présent dans une autre application, vous devez ajouter une référence à cette application. L'application et l'artefact requis doivent déjà exister dans le groupe. L'Assistant Importation fournit cette option. Toutefois, si vous utilisez la commande ImportApp de BTSTask, vous devez ajouter la référence à l’application après l’importation, comme décrit dans Comment ajouter une référence à une autre application. Pour plus d’informations, consultez Dépendances et déploiement d’applications. L'Assistant Importation établit des correspondances entre les références et les applications existantes du groupe et vous permet d'ajouter ou de modifier une référence. Effectuez l'étape supplémentaire permettant de vérifier que l'application référencée contient l'artefact requis.
Si une opération d'importation expire, fractionnez l'application en fichiers .msi supplémentaires. Une opération d'importation expire si elle dépasse 3 600 secondes. Si vous essayez d'importer un fichier .msi et que l'opération arrive à expiration, vous devez diviser le contenu de l'application en plusieurs fichiers .msi en réexportant l'application et en sélectionnant un sous-ensemble d'artefacts à exporter. Pour plus d’informations, consultez Guide pratique pour exporter une application BizTalk.

Important

Pour des raisons de sécurité, pendant l'exportation d'une application, les mots de passe sont supprimés des liaisons d'application. Néanmoins, ils ne sont pas supprimés des fichiers de liaison ajoutés à l'application. Après avoir importé l'application, vous devez reconfigurer les mots de passe afin que l'application fonctionne correctement. Pour ce faire, modifiez le fichier de liaison ou utilisez la console Administration. Pour plus d’informations sur la modification d’un fichier de liaison, consultez Personnalisation des fichiers de liaison. Pour plus d’informations sur la configuration de la sécurité des adaptateurs, consultez Utilisation d’adaptateurs.

Notes

Si une importation échoue, BizTalk Server annule toutes les opérations d'importation sauf pour les actions effectuées par des scripts personnalisés.

Notes

Si vous créez un filtre pour un port d'envoi dans une application qui utilise un schéma de propriété d'une autre application et que vous importiez ensuite la première application dans un nouveau groupe BizTalk, vous ne recevrez pas de message vous avertissant de l'absence de schéma et le filtrage ne fonctionnera pas une fois l'application installée et démarrée. Vous pouvez corriger ce problème en important l'application qui contient le schéma avant d'installer l'application sans schéma.