Partager via

Restrictions relatives à la configuration de l’adaptateur de fichier

  • Article

Restrictions et règles lors de l’utilisation de l’adaptateur de fichier.

Masque de fichier et nom de fichier gotchas

Le masque de fichier est une chaîne qui spécifie le type de fichier que le gestionnaire de réception FILE récupère dans l'emplacement de réception. Le nom de fichier est une chaîne qui spécifie le nom du fichier dans lequel le gestionnaire d'envoi FILE écrit le message.

Les restrictions suivantes s'appliquent aux propriétés Nom de fichier et Masque de fichier :

  • Il n'est possible de spécifier qu'un seul masque de fichier ou nom de fichier par emplacement de réception.

  • Vous ne pouvez pas spécifier le chemin d'accès complet ou une partie du chemin d'accès conjointement avec le masque ou le nom de fichier. Ceux-ci sont toujours constitué d'un nom sans le chemin d'accès.

  • Le masque et le nom de fichier ne respectent pas la casse.

  • Le nom de fichier ne peut contenir aucun des caractères suivants : <> / | " ? * ;

  • Le masque de fichier ne peut contenir aucun des caractères suivants : <> / | " ;

  • Les noms d’appareils réservés suivants ne peuvent pas être utilisés comme nom de fichier : CON, PRN, AUX, CLOCK$, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8 et LPT9. En outre, toute combinaison de ces éléments avec des extensions n'est pas autorisée.

  • Les volumes de disques Windows utilisent la convention d’affectation de noms 8.3 (8dot3) par défaut, qui utilise des noms de fichiers courts et longs. Les volumes de disque non système désactivent la convention d’affectation de noms 8dot3 et utilisent donc uniquement des noms de fichiers longs.

    Lorsque 8dot3 est activé, les fichiers et leurs extensions de fichier sont convertis en un nom court. Par exemple, testabcdefgh.docx est converti testab~1.docen . Notez que le nom de fichier est raccourci et que l’extension de fichier est raccourcie de .docx à doc.

    Ce comportement a un impact sur la façon dont l’adaptateur de fichier reçoit le fichier. Si un masque de fichier est défini sur , les fichiers correspondant à la fois *.xml aux *.xmlextensions et *.xmln sont récupérés.

    Pour voir si la convention d’affectation de noms 8dot3 est activée sur vos disques, ouvrez une invite de commandes en tant qu’administrateur, tapez fsutil 8dot3name query c:, ou fsutil 8dot3name query d:, et ainsi de suite. L’exemple de sortie se présente comme suit :

    C:\WINDOWS\system32>fsutil 8dot3name query c:
The volume state is: 0 (8dot3 name creation is enabled).
The registry state is: 2 (Per volume setting - the default).

Based on the above two settings, 8dot3 name creation is enabled on c:

    L’adaptateur de fichier utilise la fonction FindFirstFile. Cette fonction inclut les résultats de recherche qui ont les noms de fichiers courts et longs. Pour afficher les noms de fichiers courts et longs dans un dossier, ouvrez une invite de commandes, accédez à votre dossier, puis tapez dir /x. Dans une invite de commandes, vous pouvez également taper dir c:\foldername /x.

    Si vous modifiez le paramètre 8dot3name sur un volume, les nouveaux fichiers utilisent le nouveau paramètre. Tous les fichiers existants conservent leur nom jusqu’à ce qu’ils soient déplacés.

    Pour récupérer uniquement les fichiers prévus et obtenir de meilleures performances (moins de surcharge) lors d’une charge plus élevée, il peut être préférable de configurer l’adaptateur de fichiers pour utiliser un volume où 8dot3name est désactivé.

  • La longueur totale du chemin d'accès au fichier, du masque de fichier et du nom de fichier (sans substitution de macro) ne doit pas dépasser 256 caractères. Il s'agit d'une restriction de la base de données MessageBox.

  • Le chemin d’accès au fichier ne peut pas commencer par «\\ ? ».

  • Les chemins d'accès ne peuvent pas comporter de lettres correspondant à des lecteurs réseau mappés, car celles-ci sont liées à des sessions utilisateur.

    Le moteur de messagerie BizTalk valide toujours les propriétés Masque de fichier et Nom de fichier au moment de la conception sur la base des éléments répertoriés ci-dessus. L'adaptateur FILE valide également ces propriétés au moment de l'exécution si l'adaptateur envoie le message via un port dynamique.

Notes

L'adaptateur FILE ne récupère pas les fichiers système ou les fichiers en lecture seule. Seuls les fichiers se trouvant sur le disque sont récupérés, à l'exception des fichiers de périphérique.

Utilisation de macros dans les noms de fichiers

Vous pouvez définir un ensemble prédéfini de macros pour créer de façon dynamique les fichiers dans lesquels le gestionnaire d'envoi FILE écrit des messages. Avant de créer un fichier dans le système de fichiers, le gestionnaire d'envoi FILE remplace toutes les macros dans le nom de fichier par leurs valeurs individuelles. Vous pouvez utiliser plusieurs macros dans un nom de fichier.

Vous pouvez utiliser les macros de nom de fichier lors de la configuration du gestionnaire d'envoi FILE à l'aide du modèle d'objet de l'Explorateur BizTalk.

Le gestionnaire d'envoi FILE ne remplace pas les macros par une valeur si les conditions suivantes sont remplies :

  • La propriété système correspondante n'est pas définie.

  • La macro est mal orthographiée.

  • La valeur de la macro contient des symboles de nom de fichier non valides.

    Si une de ces conditions est remplie, le gestionnaire d'envoi FILE conserve les macros telles que dans le nom de fichier (par exemple, Myfile_%MessageID%.xml).

    Le tableau suivant indique les macros prises en charge et décrit leur remplacement par le gestionnaire d'envoi FILE.

Nom de macro Valeur de remplacement
%datetime% Date et heure UTC au format AAAA-MM-JJThhmmss (par exemple, 1997-07-12T103508).
%datetime_bts2000% Date et heure UTC au format AAAAMMJJhhmmsss, où sss correspond aux secondes et aux millisecondes (par exemple, 199707121035234 signifie 1997/07/12, 10:35:23 et 400 millisecondes).
%datetime.tz% Heure et date locales ainsi que le fuseau horaire GMT au format AAAA-MM-JJThhmmssTZD (par exemple, 1997-07-12T103508+800).
%DestinationParty% Nom du tiers de destination. La valeur provient de la propriété de contexte de message BTS.DestinationParty.
%DestinationPartyQualifier% Qualificateur du tiers de destination. La valeur provient de la propriété de contexte de message BTS.DestinationPartyQualifier.
%MessageID% GUID (Globally Unique Identifier) du message dans BizTalk Server. La valeur provient directement de la propriété de contexte de message BTS. MessageID.
%SourceFileName% Nom du fichier à partir duquel l'adaptateur FILE lit le message. Le nom de fichier inclut l’extension et exclut le chemin du fichier, par exemple, Sample.xml. Lors de la substitution de cette propriété, l’adaptateur de fichier extrait le nom du fichier du chemin d’accès absolu stocké dans file . Propriété de contexte ReceivedFileName . Si la propriété de contexte n'inclut pas de valeur (par exemple, si un message a été reçu sur un adaptateur autre que l'adaptateur FILE), la macro n'est pas remplacée et est conservée dans le nom de fichier telle que (par exemple, C:\Drop\%SourceFileName%). Note: L’implémentation correcte de cette macro nécessite que le message de sortie soit le même message que le message reçu.
%SourceParty% Nom du tiers source qui a envoyé le message à l'adaptateur FILE. Note: L’implémentation correcte de cette macro nécessite que le message de sortie soit le même message que le message reçu.
%SourcePartyQualifier% Qualificateur du tiers source qui a envoyé le message à l'adaptateur FILE. Note: L’implémentation correcte de cette macro nécessite que le message de sortie soit le même message que le message reçu.
%time% Heure UTC au format hhmmss.
%time.tz% Heure locale ainsi que le fuseau horaire GMT au format hhmmssTZD (par exemple, 124525+530).

Recevoir les propriétés de dossier et d’emplacement de destination gotchas

L'emplacement de réception FILE est une chaîne contenant le chemin d'accès à un dossier sur un système de fichiers ou un partage réseau depuis lequel le gestionnaire de réception FILE lit des fichiers. L'emplacement de destination FILE est une chaîne contenant le chemin d'accès à un dossier sur un système de fichiers ou un partage réseau dans lequel le gestionnaire d'envoi FILE écrit des fichiers.

Les restrictions suivantes s'appliquent aux propriétés Dossier de réception et Emplacement de destination :

  • L’existence du chemin d’accès au fichier sur un système de fichiers ou un partage réseau n’est pas requise au moment où vous spécifiez la propriété dans l’utilisateur.

  • Le chemin d'accès au fichier doit toujours être absolu.

  • Vous pouvez spécifier le chemin du fichier au format UNC (Universal Naming Convention) (par exemple, \\<server>\<share>).

  • Si le chemin du fichier est au format UNC, le nom du serveur ne doit pas contenir les caractères suivants : ' ~ ! @ # $ ^ & * ( ) = + [ ] { } \ | ; : ' " , <> / ? ;

  • Vous ne pouvez pas utiliser les symboles de dossier parent (\..\) et actuel (\.\) dans le chemin d'accès au fichier.

  • Le chemin d'accès au fichier ne respecte pas la casse.

  • Le chemin d’accès au fichier ne peut contenir aucun des caractères suivants : <> / | " ? * ;

  • Vous ne pouvez pas utiliser les noms de périphérique réservés suivants dans le chemin d'accès au fichier : CON, PRN, AUX, CLOCK$, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8 et LPT9.

  • La longueur totale du chemin d'accès au fichier, ou du nom du fichier (sans substitution de macro) ne doit pas dépasser 256 caractères. (La base de données MessageBox impose cette restriction.)

  • L'adaptateur FILE ne prend pas en charge la spécification Unicode du chemin d'accès au fichier (par exemple, « \\?\ »).

    Restrictions relatives à la propriété Dossier de réception uniquement :

  • Ne définissez pas la propriété Dossier de réception sur un dossier utilisant un système de fichiers distribués Microsoft Windows NT avec un lien symbolique. Avec un système de fichiers distribués Windows NT, vous pouvez uniquement utiliser les dossiers ayant un chemin d'accès direct au réseau dans les emplacements de réception de l'adaptateur FILE.

  • Lorsque des documents sont envoyés à un chemin d'accès UNC et que plusieurs serveurs reçoivent les documents à l'emplacement de réception pour l'adaptateur FILE, un seul serveur récupère et traite la plupart des documents envoyés. Pour plus d’informations sur le renommage des fichiers, consultez la section Adaptateur de réception de fichier de l’Adaptateur de fichier.

    Restrictions relatives à la propriété Dossier d'envoi uniquement :

  • Il se peut que l'adaptateur FILE ne dispose pas de ressources de système d'exploitation suffisantes pour traiter simultanément les messages d'un lot lorsqu'il est exécuté sur un système d'exploitation non-serveur, tel que Microsoft Windows Vista.

    Lors de la conception, l'adaptateur FILE valide le chemin d'accès au fichier à l'aide des règles mentionnées précédemment. Il valide également le message au moment de l'exécution si l'adaptateur envoie le message via un port dynamique à l'aide d'un adaptateur FILE.