Configurer l’adaptateur de fichier

Article
07/21/2023

Comment configurer l’adaptateur de fichier, lire les recommandations de sécurité et afficher les autorisations requises.

Vous pouvez créer un emplacement de réception et un port d’envoi à l’aide de BizTalk Server Administration ou par programmation. Cette rubrique se concentre sur la console Administration BizTalk Server. Pour les étapes programmatiques, accédez à Créer l’emplacement de réception ou envoyer le port par programmation.

Important

À compter de BizTalk Server 2016, vous pouvez vous connecter à un partage de fichiers Azure à l’aide de l’adaptateur De fichiers. Le compte de stockage Azure doit être monté sur votre BizTalk Server. Prise en main d’Azure File Storage sur Windows répertorie les étapes de montage.

Recommandations de sécurité

L'adaptateur FILE permet de transférer des fichiers entre BizTalk Server et un répertoire. Il est vivement recommandé de respecter les informations suivantes pour la sécurisation et le déploiement de l'adaptateur FILE dans votre environnement.

N’ouvrez pas de ports pour vous connecter à un partage de fichiers dans le réseau de périmètre. Vous devez utiliser l'adaptateur FILE dans des environnements approuvés, tel qu'un intranet.
Définissez des listes de contrôle d’accès discrétionnaires (DACL) fortes dans les répertoires de dépôt de l’emplacement de réception. Par exemple, vous devez définir des autorisations en lecture, écriture et suppression de fichiers et de sous-dossiers pour le répertoire dans lequel l'emplacement de réception des fichiers sélectionne des messages, afin que seuls les utilisateurs autorisés puissent déposer des messages dans cet emplacement.
Lorsque vous utilisez l'adaptateur FILE pour extraire des données critiques, il est recommandé d'utiliser le protocole IPSec (Internet Protocol Security).

Autorisations requises

Les gestionnaires d’adaptateurs s’exécutent dans le contexte de sécurité de l’hôte instance sélectionné pour le gestionnaire d’adaptateur. L’hôte instance utilise la Logon propriété dans le nom d’hôte - Propriétés de l’instance d’hôte dans l’administration BizTalk. Ce Logon compte doit disposer d’autorisations spécifiques sur tous les dossiers ou partages utilisés par l’adaptateur de fichier.

L’hôte instance compte d’utilisateur utilisé par le gestionnaire nécessite les autorisations suivantes. A ✔ signifie que l’autorisation est requise. Une entrée vide signifie que l’autorisation n’est pas requise.

Autorisations	Gestionnaire de réception	Gestionnaire d'envoi
Contrôle total	✔ au niveau du partage (si vous accédez à un partage de fichiers)
Parcourir le dossier / exécuter le fichier		✔ au niveau du fichier
Lister le dossier / lire les données	✔ au niveau du fichier	✔ au niveau du fichier
Lire les attributs		✔ au niveau du fichier
Lire les attributs étendus		✔ au niveau du fichier
Créer des fichiers / écrire des données		✔ au niveau du fichier
Créer des dossiers / ajouter des données		✔ au niveau du fichier
Supprimer des sous-dossiers et des fichiers	✔ au niveau du fichier	✔ au niveau du fichier
Autorisations de lecture		✔ au niveau du fichier
Modifier		✔ au niveau du partage (si vous accédez à un partage de fichiers)

Conseil

Au niveau du fichier, ouvrez les autorisations avancées sur le fichier ou le dossier pour afficher ces autorisations.

Notes

Chaque hôte ne peut être associé qu'à un seul gestionnaire de réception.

Configurer l’emplacement de réception

Notes

Avant d’effectuer la procédure suivante, vous devez avoir déjà ajouté un port de réception unidirectionnel. Consultez Comment créer un port de réception.

Dans la console Administration BizTalk Server, développez BizTalk Server Administration, BizTalk Group, Applications, puis développez l’application sous laquelle vous souhaitez créer un emplacement de réception.
Dans le volet gauche, cliquez sur le nœud Ports de réception . Dans le volet droit, cliquez avec le bouton droit sur le port de réception associé à un emplacement de réception existant ou auquel associer un nouvel emplacement, puis cliquez sur Propriétés.
Dans le volet gauche de la boîte de dialogue Propriétés du port de réception , sélectionnez Emplacements de réception, puis dans le volet droit double-cliquez sur un emplacement de réception existant ou cliquez sur Nouveau pour créer un nouvel emplacement de réception.
Dans la boîte de dialogue Propriétés de l’emplacement de réception, dans la section Transport , sélectionnez Type de fichier dans la liste déroulante, puis cliquez sur Configurer pour configurer les propriétés de transport de l’emplacement de réception.

Sous l’onglet Général , procédez comme suit :

Propriété	Pour
Dossier Receive	Obligatoire. Entrez le chemin d’accès à un dossier sur le système de fichiers, le partage réseau ou le partage de fichiers Azure où le gestionnaire de réception de fichiers lit les fichiers. Vous pouvez entrer le chemin directement dans la zone de texte Recevoir le dossier ou le sélectionner dans le système de fichiers à l’aide du bouton Parcourir . Lorsque vous recherchez le dossier, vous pouvez également créer un dossier à l’aide de Créer un nouveau dossier. Si vous utilisez un partage Stockage de fichiers Azure, entrez `\\yourfilestoragename.file.core.windows.net\yourfilesharename`. Type: String Note: Ne définissez pas la propriété Receive folder sur un dossier qui utilise le système de fichiers distribué NT avec un lien symbolique. Si vous utilisez un système de fichiers distribué NT, vous pouvez uniquement utiliser des dossiers avec des chemins réseau simples dans les emplacements de réception de l’adaptateur de fichiers. Pour connaître les restrictions sur cette propriété, consultez Restrictions lors de la configuration de l’adaptateur de fichier. Note: L’URI d’un port d’envoi ou d’un emplacement de réception ne peut pas dépasser 256 caractères.
Masque de fichier	Obligatoire. Indiquer le masque des fichiers. Ce masque peut contenir la valeur générique standard « * ». Valeur par défaut : .xml Type:* String Pour connaître les restrictions sur cette propriété, consultez Restrictions lors de la configuration de l’adaptateur de fichier.
Adresse publique	Indiquer l'adresse publique de cet emplacement. BizTalk Server expose cette adresse aux partenaires externes. Si cette propriété n'est pas spécifiée, le moteur d'exécution la remplace par : < file:// Receive folder>/<File mask> La valeur de cette propriété exige un préfixe d'adaptateur. Type: String Longueur minimale : 0 Longueur maximale : 256
Nombre de tentatives	Indiquer le nombre de tentatives d'accès à l'emplacement de réception sur le partage réseau en cas d'indisponibilité temporaire. Valeur par défaut : 5 Type: Long Valeur minimale : 0 Valeur maximale : MAX_LONG
Intervalle entre chaque tentative (min)	Indiquer l'intervalle (en minutes) devant séparer chaque tentative d'accès à l'emplacement de réception sur le partage réseau en cas d'indisponibilité temporaire. Valeur par défaut : 5 minutes Type: Long Valeur minimale : 0 Valeur maximale : MAX_LONG

Sous l’onglet Authentification , procédez comme suit :

Propriété	Pour
Utiliser ces informations d'identification lorsque l'hôte n'a pas accès au partage de réseau	Obligatoire uniquement lors de l’utilisation d’un partage réseau ou d’un partage de fichiers Azure. Valeur par défaut : Faux Type: Boolean
Nom d'utilisateur	Si vous utilisez un partage réseau, entrez le nom d’utilisateur qui a accès au partage. Si vous utilisez un partage de stockage de fichiers Azure, entrez le nom de votre compte de stockage. Type: String Note: Si plusieurs emplacements de réception mappés au même partage réseau sont configurés avec d’autres informations d’identification, les mêmes informations d’identification doivent être utilisées pour tous les emplacements de réception. Windows ne permet pas d'établir plusieurs connexions à un partage réseau depuis le même ordinateur si vous tentez d'utiliser plusieurs jeux d'informations d'identification.
Mot de passe	Si vous utilisez un partage réseau, entrez le mot de passe du compte qui a accès au partage réseau. Si vous utilisez un partage de stockage de fichiers Azure, entrez la clé d’accès du compte de stockage ; qui est répertorié dans le Portail Azure. Type: String

Sous l’onglet Traitement par lots , procédez comme suit :

Propriété	Pour
Nombre de messages dans un lot	Indiquez le nombre maximal de messages à soumettre en un lot. Valeur par défaut : 5 Type: Int Valeur minimale : 1 Valeur maximale : 256
Taille maximale du lot (en octets)	Indiquer le nombre maximal d'octets par lot. Valeur par défaut : 102400 Type: Int Valeur minimale : 1024 Valeur maximale : MAX_LONG

L'adaptateur FILE limite le lot à la première valeur atteinte : nombre maximal de messages ou nombre d'octets maximal autorisé.

Sélectionnez OK.
Entrez les valeurs appropriées dans la boîte de dialogue Propriétés de l’emplacement de réception pour terminer la configuration de l’emplacement de réception, puis cliquez sur OK pour enregistrer les paramètres. Pour plus d'informations sur la boîte de dialogue Propriétés de l'emplacement de réception , consultez la rubrique Création d'un emplacement de réception.

Configurer le port d’envoi

Dans la console d’administration BizTalk Server, créez un port d’envoi ou double-cliquez sur un port d’envoi existant pour le modifier. Consultez Comment créer un port d’envoi. Configurez toutes les options de port d’envoi et spécifiez FILE pour l’option Type dans la section Transport de l’onglet Général .
Sélectionnez le bouton Configurer en regard de Type.

Sous l’onglet Général , procédez comme suit :

Propriété	Pour
Emplacement de destination	Obligatoire. Entrez le chemin d’accès à l’emplacement sur le système de fichiers, le partage public ou le partage de fichiers Azure pour écrire les messages de sortie. Vous pouvez entrer le chemin d’accès directement dans l’emplacement de destination ou le sélectionner dans le système de fichiers à l’aide du bouton Parcourir . Lorsque vous recherchez le dossier dans la boîte de dialogue Rechercher un dossier , vous pouvez également créer un dossier en cliquant sur Créer un dossier. Si vous utilisez un partage de stockage de fichiers Azure, entrez `\\yourfilestoragename.file.core.windows.net\yourfilesharename`. Type: String Note: L’URI d’un port d’envoi ou d’un emplacement de réception ne peut pas dépasser 256 caractères.
Nom de fichier	Indique le nom du fichier dans lequel le gestionnaire d'envoi FILE écrit le message. Pour connaître les restrictions sur cette propriété, notamment l’utilisation de macros dans le nom de fichier, consultez Restrictions lors de la configuration de l’adaptateur de fichier.
Mode de copie	Définissez le mode de copie à utiliser lors de l’écriture d’un message dans un fichier. Les valeurs autorisées sont : Ajouter : le gestionnaire d'envoi FILE ouvre un fichier s'il existe et ajoute un message à la fin du fichier. Si le fichier n'existe pas, il le crée. Remplacer. le gestionnaire d'envoi FILE ouvre un fichier s'il existe et remplace son contenu. Si le fichier n'existe pas, il le crée. Créer un nouveau. si aucun fichier n'existe, le gestionnaire d'envoi FILE en crée un et y enregistre des éléments. si le fichier existe déjà, il signale une erreur et applique la procédure logique commune pour les nouvelles tentatives sur l'adaptateur pour les ports d'envoi. Il s'agit d'un mode de copie par défaut pour le gestionnaire d'envoi FILE.
Autoriser le cache lors de l'écriture	Précise si la mise en cache du système de fichiers doit être appliquée lors de l'écriture d'un message dans un fichier. Les options valides sont les suivantes : Faux N’utilisez pas le cache du système de fichiers. Vrai Utilisez le cache du système de fichiers. Valeur par défaut : False Important : la définition de cette propriété sur True peut augmenter les performances de l’adaptateur de fichiers au risque de perte de données potentielle en cas de perte d’alimentation et que toutes les données ne sont pas écrites sur le disque.
Utiliser le fichier temporaire lors de l'écriture	Définit si le fichier de sortie doit d'abord être écrit dans un fichier temporaire, puis renommé une fois l'opération d'écriture terminée. Si cette option est activée, le fichier temporaire est créé avec l’extension BTS-WIP. Les options valides sont Vrai L’adaptateur de fichier crée un fichier temporaire lors de l’écriture dans le dossier cible. Faux L’adaptateur de fichier ne crée pas de fichier temporaire lors de l’écriture dans le dossier cible. Valeur par défaut : False Remarque : cette option n’est disponible que lorsque la propriété CopyMode a la valeur Create new

Sous l’onglet Authentification , procédez comme suit :

Propriété	Pour
Utiliser ces informations d'identification lorsque l'hôte n'a pas accès au partage de réseau	Obligatoire uniquement lors de l’utilisation d’un partage réseau ou d’un partage de fichiers Azure. Valeur par défaut : Faux Type: Boolean
Nom d'utilisateur	Si vous utilisez un partage réseau, entrez le nom d’utilisateur qui a accès au partage. Si vous utilisez un partage de stockage de fichiers Azure, entrez le nom de votre compte de stockage. Type: String
Mot de passe	Si vous utilisez un partage réseau, entrez le mot de passe du compte qui a accès au partage réseau. Si vous utilisez un partage de stockage de fichiers Azure, entrez la clé d’accès du compte de stockage ; qui est répertorié dans le Portail Azure. Type: String

Sélectionnez OK pour enregistrer vos paramètres.

Définir les propriétés d’un port d’envoi dynamique

Un port d'envoi dynamique ne fournit aucune option de configuration relative au transport dans la console Administration de BizTalk, car ces propriétés doivent être fournies avec les propriétés de contexte associées au message. Vous pouvez définir celles-ci dans un pipeline personnalisé ou dans une orchestration. Pour définir les propriétés de configuration de message dans une orchestration, vous pouvez effectuer les opérations suivantes :

Ajoutez une forme Construire un message à votre orchestration.
Configurez la forme Construire un message pour construire un nouveau message. par exemple Message_2.
Ajoutez une forme d’affectation de message à la forme Construire un message .
Ajoutez du code à la forme Affectation de message pour initialiser le message que vous avez construit et définir les propriétés de configuration appropriées pour le message. Le code suivant initialise un message nommé Message_2 qui a été construit avec une forme De construction de message , puis définit deux propriétés de configuration pour le message. Dans ce scénario, le message Message_1 a été initialement reçu par l'orchestration :
```
Message_2=Message_1;  
Message_2(FILE.CopyMode)= 0; //0=Append  
Message_2(FILE.AllowCacheOnWrite)= true;  
Message_2(FILE.UseTempFileOnWrite)= true;  
```

Configurer le gestionnaire de réception ou d’envoi

Dans la console Administration BizTalk Server, développez BizTalk Server Administration, Groupe BizTalk, Paramètres de plateforme, puis cliquez sur Adaptateurs.
Dans la liste développée des adaptateurs, cliquez sur FICHIER. Dans le volet droit, cliquez avec le bouton droit sur le gestionnaire de réception ou d’envoi que vous souhaitez configurer. Sélectionner Propriétés.
Dans la liste Nom d’hôte , sélectionnez l’hôte pour exécuter le gestionnaire.
Cliquez sur OK.