Compartir vía

Restricciones al configurar el adaptador de archivo

  • Artículo

Restricciones y reglas al usar el adaptador de archivos.

Máscara de archivo y nombre de archivo gotchas

La máscara de archivo es una cadena que especifica el tipo del archivo que el controlador de recepción de archivo seleccionará de la ubicación de recepción. El nombre de archivo es una cadena que especifica el nombre del archivo donde el controlador de envío de archivo escribirá el mensaje.

Las siguientes restricciones son aplicables a las propiedades de máscara de archivo y nombre de archivo:

  • Sólo se puede especificar una máscara de archivo o nombre de archivo por ubicación de recepción o puerto de envío.

  • No se permite la ruta completa del archivo, o parte de ésta, junto con la máscara de archivo o nombre de archivo. La máscara de archivo y nombre de archivo siempre representa un nombre sin ruta.

  • La máscara de archivo y el nombre de archivo no distinguen entre mayúsculas y minúsculas.

  • El nombre de archivo no puede contener ninguno de los siguientes caracteres: <> : / | " ? * ;

  • La máscara de archivo no puede contener ninguno de los siguientes caracteres: <> : / | " ;

  • Los siguientes nombres de dispositivo reservados no se pueden usar como nombre de un archivo: CON, PRN, AUX, CLOCK$, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8 y LPT9. Asimismo, no se permite ninguna combinación de éstos con extensiones.

  • Los volúmenes de disco de Windows usan la convención de nomenclatura 8.3 (8dot3) de forma predeterminada, que usa nombres de archivo cortos y largos. Los volúmenes de disco que no son del sistema deshabilitan la convención de nomenclatura 8dot3 y, por tanto, solo usan nombres de archivo largos.

    Cuando 8dot3 está habilitado, los archivos y sus extensiones de archivo se convierten en un nombre corto. Por ejemplo, testabcdefgh.docx se convierte en testab~1.doc. Observe que el nombre de archivo se abrevia y la extensión de archivo se acorta de .docx a doc.

    Este comportamiento afecta al modo en que el adaptador de archivos recibe el archivo. Si una máscara de archivo se establece *.xmlen , se seleccionan los archivos que coinciden con *.xml las extensiones y *.xmln .

    Para ver si la convención de nomenclatura 8dot3 está habilitada en los discos, abra un símbolo del sistema como Administrador y escriba fsutil 8dot3name query c:, o fsutil 8dot3name query d:, etc. La salida de ejemplo es similar a la siguiente:

    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:

    El adaptador de archivo usa la función FindFirstFile. Esta función incluye resultados de búsqueda que tienen los nombres de archivo cortos y largos. Para ver los nombres de archivo cortos y largos en una carpeta, abra un símbolo del sistema, vaya a la carpeta y escriba dir /x. En un símbolo del sistema, también puede escribir dir c:\foldername /x.

    Si cambia la configuración 8dot3name en un volumen, los nuevos archivos usan la nueva configuración. Los archivos existentes conservan sus nombres hasta que se mueven.

    Para recoger solo los archivos previstos y para obtener un mejor rendimiento (menos sobrecarga) durante una carga mayor, puede ser mejor configurar el adaptador de archivos para que use un volumen en el que 8dot3name esté deshabilitado.

  • Asegúrese de que la longitud de la ruta de archivo, la máscara de archivo y el nombre de archivo (sin sustitución de macros) no supera los 256 caracteres. (Ésta es una restricción de la base de datos de cuadros de mensajes.)

  • La ruta de acceso del archivo no puede comenzar por "\\?".

  • Las letras de unidad de red asignadas no se pueden utilizar en la ruta de archivo porque están basadas en las sesiones de usuario.

    El motor de mensajería de BizTalk siempre valida las propiedades de máscara de archivo y nombre de archivo en tiempo de diseño mediante los elementos que se mostraron en una lista anteriormente. Asimismo, el adaptador de archivo valida las propiedades de máscara de archivo y nombre de archivo en tiempo de ejecución si el adaptador envía el mensaje en un puerto dinámico.

Nota:

El adaptador de archivo no selecciona archivos de sistema o archivos de sólo lectura. Sólo se seleccionan archivos basados en disco, no archivos de dispositivos

Uso de macros en nombres de archivo

Puede utilizar un conjunto predefinido de macros para crear dinámicamente los archivos en los que el controlador de envío de archivo escribe los mensajes. Antes de crear un archivo en el sistema de archivos, el controlador de envío de archivo reemplaza todas las macros en el nombre de archivo con sus valores individuales. Puede utilizar varias macros diferentes en un nombre de archivo.

Puede usar las macros de nombre de archivo mientras configura el controlador de envío de archivo mediante el modelo de objetos del Explorador de BizTalk.

El controlador de envío de archivo no reemplaza las macros con un valor si se cumple cualquiera de las siguientes condiciones:

  • La propiedad de sistema correspondiente no está definida.

  • La macro no se ha escrito correctamente.

  • El valor de la macro contiene símbolos que no son válidos en el nombre de archivo.

    Si se produce cualquiera de estas condiciones, el controlador de envío de archivo no modifica las macros del nombre de archivo, por ejemplo, Myfile_%MessageID%.xml.

    La siguiente tabla enumera las macros admitidas y describe cómo el controlador de envío de archivo las reemplaza.

Un nombre de macro Valor de sustitución
%datetime% La hora y fecha de la hora universal coordinada (UTC) en el formato AAAA-MM-DDThhmmss (por ejemplo, 1997-07-12T103508).
%datetime_bts2000% Hora y fecha UTC con formato AAAMMDDhhmmss, donde sss representa los segundos y milisegundos (por ejemplo, 199707121035234 significa 1997/07/12, 10:35:23 y 400 milisegundos).
%datetime.tz% Hora y fecha local, y diferencia de zona horaria respecto de GMT, con formato AAAA-MM-DDThhmmssDZH (por ejemplo, 1997-07-12T103508+ 800).
%DestinationParty% Nombre de la entidad de destino. El valor procede de la propiedad de contexto del mensaje BTS.DestinationParty.
%DestinationPartyQualifier% Calificador de la entidad de destino. El valor procede de la propiedad de contexto del mensaje BTS.DestinationPartyQualifier.
%MessageID% Identificador único global (GUID) del mensaje en BizTalk Server. El valor procede directamente de la propiedad de contexto del mensaje BTS. MessageID.
%SourceFileName% Nombre del archivo del que el adaptador de archivo leyó el mensaje. El nombre de archivo incluye la extensión y excluye la ruta de acceso del archivo, por ejemplo, Sample.xml. Al sustituir esta propiedad, el adaptador de archivo extrae el nombre de archivo de la ruta de acceso de archivo absoluta almacenada en el archivo. Propiedad de contexto ReceivedFileName . Si la propiedad de contexto no tiene un valor (por ejemplo, si se recibió un mensaje en un adaptador distinto del adaptador de archivo), la macro no se sustituirá y permanecerá en el nombre de archivo tal cual (por ejemplo, C:\Drop\%SourceFileName%). Nota: La implementación correcta de esta macro requiere que el mensaje de salida sea el mismo que el mensaje recibido.
%SourceParty% Nombre de la entidad de origen de la que procede el mensaje recibido por el adaptador de archivo. Nota: La implementación correcta de esta macro requiere que el mensaje de salida sea el mismo que el mensaje recibido.
%SourcePartyQualifier% Calificador de la entidad de origen de la que procede el mensaje recibido por el adaptador de archivo. Nota: La implementación correcta de esta macro requiere que el mensaje de salida sea el mismo que el mensaje recibido.
%time% Hora UTC con formato hhmmss.
%time.tz% Hora local, y diferencia de zona horaria en relación con GMT, con formato hhmmssDZH (por ejemplo, 124525+530).

Recibir propiedades de ubicación de carpeta y destino gotchas

La ubicación de recepción de archivos es una cadena que contiene una ruta de acceso a una carpeta de un sistema de archivos o un recurso compartido de red del que el controlador de recepción de archivo lee archivos. La ubicación de destino de archivos es una cadena que contiene una ruta de acceso a una carpeta de un sistema de archivos o un recurso compartido de red donde el controlador de envío de archivo escribe archivos.

Las siguientes restricciones se aplican a las propiedades de la carpeta de recepción y de la ubicación de destino:

  • No es necesario que haya una ruta de acceso de archivos en un sistema de archivos o un recurso compartido de red en el momento en que se especifica la propiedad en el usuario.

  • La ruta de acceso debe ser siempre absoluta.

  • Puede especificar la ruta de acceso del archivo mediante el formato de convención de nomenclatura universal (UNC) (por ejemplo, \\<server>\<share>).

  • Si la ruta de acceso del archivo está en formato UNC, el nombre del servidor no debe contener los siguientes caracteres: ' ~ ! @ # $ ^ & * ( ) = + [ ] { } \ | ; : ' " , <> / ? ;

  • No pueden utilizarse símbolos de carpeta principal (\..\) o actual (\.\) en ninguna parte de la ruta de acceso del archivo.

  • La ruta de acceso de archivos no distingue mayúsculas de minúsculas.

  • La ruta de acceso del archivo no puede contener ninguno de los siguientes caracteres: <> : / | " ? * ;

  • No se pueden usar los siguientes nombres de dispositivo reservados en la ruta de acceso de archivos: CON, PRN, AUX, CLOCK$, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8 y LPT9.

  • La longitud total de la ruta de acceso de archivos, la máscara de archivo o el nombre de archivo (sin sustitución de macros) no debe exceder 256 caracteres. La base de datos de cuadro de mensajes impone esta restricción.

  • El adaptador de archivo no admite la especificación Unicode de la ruta de acceso de archivos (por ejemplo, "\\?\").

    Restricciones solo para la propiedad de la carpeta de recepción:

  • No establezca la propiedad de la carpeta de recepción en una carpeta que use el sistema de archivos distribuido de Microsoft Windows NT con un vínculo simbólico. Si utiliza el sistema de archivos distribuido de Windows NT, solo puede usar carpetas con rutas de acceso de red directas en las ubicaciones de recepción del adaptador de archivo.

  • Cuando se envían documentos a una ruta UNC y tiene más de un servidor que recibe documentos en la ubicación de recepción del adaptador de archivo, solo un servidor recogerá y procesará la mayor parte de los documentos enviados a esa ruta UNC. Para obtener más información sobre el cambio de nombre de archivo, vea la sección Adaptador de recepción de archivos del adaptador de archivo.

    Restricciones solo para la propiedad de la carpeta de envío:

  • El adaptador de archivos puede no disponer de los recursos de sistema operativo suficientes para procesar todos los mensajes de un lote de forma concurrente al ejecutar un sistema operativo sin servidor, como Microsoft Windows Vista.

    El adaptador de archivo valida la ruta de acceso de archivos en tiempo de diseño usando las reglas mencionadas anteriormente. Además, el adaptador de archivo valida el mensaje en tiempo de ejecución si el adaptador envía el mensaje a través de un puerto dinámico con un adaptador de archivo.