Adaptateur FILE

  • Article

L'adaptateur FILE transfère les fichiers vers et à partir de Microsoft BizTalk Server. L’adaptateur de fichier se compose de deux cartes : une carte de réception et une carte d’envoi.

Cette section décrit la prise en charge des workflows et traitements par lot pour les adaptateurs de réception et d'envoi FILE.

Adaptateur de réception de fichier

Utilisez l’adaptateur de réception de fichiers pour lire les messages des fichiers et les envoyer au serveur. L’adaptateur de réception lit le fichier et crée un objet BizTalk Message, afin que BizTalk Server puisse traiter le message. Lors de la lecture à partir du fichier, l'adaptateur verrouille le fichier pour s'assurer qu'aucune modification ne puisse être apportée au contenu du fichier.

Notes

L'adaptateur de réception FILE ne récupère pas les fichiers en lecture seule ou les fichiers système. Pour améliorer les performances, veillez à disposer d’un masque de fichiers qui n’inclut pas ces fichiers.

L'adaptateur de réception FILE lit les messages à partir de fichiers présents sur des systèmes de fichiers locaux ou des partages réseau. Lorsque l'emplacement spécifié sur un partage réseau est indisponible du fait de problèmes réseau, l'adaptateur de réception tente une nouvelle opération de lecture (le nombre de tentatives peut être configuré dans la console Administration de BizTalk Server). Après la lecture du message et son acceptation par le moteur de messagerie BizTalk, l'adaptateur de réception supprime le fichier du système de fichiers ou du partage réseau. Si le message a été lu mais que le pipeline n'a pas pu traiter le message, l'adaptateur le place dans la file d'attente de messages interrompus, puis supprime le fichier du système de fichiers ou du partage réseau. Si l'adaptateur de réception FILE ne peut pas envoyer (ou interrompre) le message à la base de données MessageBox, il ne supprime pas le fichier original du système de fichiers ou du partage réseau.

Vous pouvez également configurer l'adaptateur de réception FILE pour renommer des fichiers lors de leur traitement. Vous devez renommer des fichiers pour vous assurer que l'adaptateur de réception ne génère pas de messages en double si l'emplacement de réception est arrêté et redémarré. Il s'agit d'une option configurable pour les emplacements de réception FILE. Par défaut, le changement de nom est désactivé. Lorsqu'il est activé, l'adaptateur de réception FILE ajoute l'extension .BTS-WIP au fichier. L'adaptateur de réception lit ensuite les messages à partir du fichier renommé dans l'emplacement de réception, puis l'envoie au serveur. Après l'envoi d'un fichier par l'adaptateur de réception, ce dernier supprime le fichier renommé du système de fichiers ou du partage réseau. Si un message a été lu mais que son traitement a échoué dans le pipeline, l'adaptateur de réception le place dans la file d'attente de messages interrompus de la base de données MessageBox, puis supprime le fichier renommé du partage réseau.

Notes

Renommer les fichiers n'a aucun impact sur les performances.

Si l'adaptateur de réception FILE lit le message mais ne le stocke pas dans la base de données MessageBox, le fichier renommé retrouve son nom original, sans l'extension .BTS-WIP. Notez que l'adaptateur de réception ne lit pas les fichiers avec l'extension .BTS-WIP si l'option de changement de nom est activée.

Utilisation des notifications de modification de fichier et de l’interrogation

L'adaptateur de réception FILE s'appuie sur les notifications de modification de fichier Windows pour déterminer quand récupérer un fichier du répertoire ou du partage spécifié. Si l'adaptateur de réception FILE reçoit une notification de modification de fichier Windows avant l'écriture complète du fichier dans le répertoire ou le partage spécifié, alors le fichier est verrouillé et l'adaptateur de réception FILE ne récupère pas le fichier. Dans ce scénario, l’adaptateur de réception de fichier interroge activement le répertoire ou le partage spécifié à l’intervalle d’interrogation (ms) spécifié dans la boîte de dialogue Paramètres avancés disponible lors de la configuration d’un emplacement de réception de fichier. Lorsque l'adaptateur de réception FILE interroge un répertoire ou un partage, il récupère les fichiers déverrouillés du partage et les envoie à la base de données MessageBox.

Notes

L’adaptateur de fichier BizTalk Server n’a été testé que sur le système de fichiers NTFS et est pris en charge sur.

Avec les notifications de modification de fichier Windows suivantes, l'adaptateur de réception FILE récupère un fichier de l'emplacement spécifié :

FILE_NOTIFY_CHANGE_ATTRIBUTES

Toute modification d'attribut dans la sous-arborescence ou le répertoire surveillé génère le renvoi d'une opération d'attente d'une notification de modification.

FILE_NOTIFY_CHANGE_FILE_NAME

Toute modification de nom de fichier dans la sous-arborescence ou le répertoire surveillé génère le renvoi d'une opération d'attente d'une notification de modification. Les modifications incluent le changement, la création ou la suppression d'un nom de fichier.

FILE_NOTIFY_CHANGE_SIZE

Toute modification de taille de fichier dans la sous-arborescence ou le répertoire surveillé génère le renvoi d'une opération d'attente d'une notification de modification. Le système d'exploitation détecte une modification de taille de fichier uniquement lorsque le fichier est écrit sur le disque. Pour les systèmes d'exploitation qui utilisent la mise en cache étendue, la détection se produit uniquement lorsque le cache est suffisamment vidé.

FILE_NOTIFY_CHANGE_LAST_WRITE

Toute modification de l'heure de dernière écriture des fichiers dans la sous-arborescence ou le répertoire surveillé génère le renvoi d'une opération d'attente d'une notification de modification. Le système d'exploitation détecte une modification à la dernière écriture uniquement lorsque le fichier est écrit sur le disque. Pour les systèmes d'exploitation qui utilisent la mise en cache étendue, la détection se produit uniquement lorsque le cache est suffisamment vidé.

Pour plus d’informations sur la fonction FindFirstChangeNotification , consultez https://msdn.microsoft.com/library/windows/desktop/aa364417(v=vs.85).aspx.

Prise en charge du traitement par lot par l'adaptateur de réception FILE

L'adaptateur de réception FILE envoie des messages au serveur par lots. L'adaptateur de réception FILE commence par créer un seul lot par emplacement de réception en collectant tous les fichiers lisibles disponibles dans l'emplacement de réception. Les lots sont envoyés à la base de données MessageBox par l'adaptateur de réception, une fois que tous les fichiers disponibles ont été collectés ou que le nombre de fichiers collectés dépasse la taille maximale du lot.

Une fois que tous les messages du lot ont été lus et envoyés à la base de données MessageBox, l'adaptateur de réception FILE supprime les fichiers correspondants de l'emplacement de réception. Si certains messages du lot n'ont pas été traités correctement, l'adaptateur de réception FILE les interrompt et supprime les fichiers correspondants de l'emplacement de réception. Si certains ou tous les messages ne peuvent pas être stockés dans la base de données MessageBox, toute l'opération de traitement par lot est annulée et tous les fichiers correspondants restent en l'état dans l'emplacement de réception.

Adaptateur d'envoi FILE

L'adaptateur d'envoi FILE transmet des messages depuis la base de données MessageBox vers une adresse de destination (URL) spécifiée. Vous définissez l'URL, composée d'un chemin d'accès et d'un nom de fichier, à l'aide de caractères génériques liés aux propriétés de contexte du message. L'adaptateur d'envoi FILE fait correspondre les caractères génériques au nom de fichier réel avant d'écrire le message dans le fichier.

Lors de l'écriture d'un message dans un fichier, l'adaptateur d'envoi FILE obtient le contenu du message du corps de l'objet de message BizTalk. L'adaptateur d'envoi FILE ignore les autres parties du message dans l'objet de message BizTalk. Une fois que l'adaptateur FILE a écrit le message dans un fichier, il supprime le message de la base de données MessageBox. L'adaptateur FILE écrit des fichiers dans le système de fichiers soit directement, soit à l'aide du cache du système de fichiers qui peut améliorer les performances, en particulier pour les fichiers volumineux.

Prise en charge du traitement par lot par l'adaptateur d'envoi FILE

L'adaptateur d'envoi FILE obtient des lots de messages de la base de données MessageBox et les écrit dans des fichiers dans des emplacements de destination, sur le système de fichiers ou le partage réseau. La taille des lots de l'adaptateur d'envoi FILE ne peut pas être configurée ; elle est prédéfinie sur 20. Si BizTalk Server ne peut pas écrire certains messages d'un lot dans des fichiers, le système renvoie ces messages à la base de données MessageBox pour une nouvelle tentative de traitement. Vous pouvez configurer l'intervalle entre chaque tentative, ainsi que le nombre de tentatives, à l'aide de la console Administration de BizTalk Server.

Contenu de cette section