Nodo FileInput

Utilice el nodo FileInput para procesar mensajes leídos de archivos.

Finalidad

Se pueden leer uno o varios mensajes de un solo archivo y cada mensaje se propaga como una transacción de flujo independiente. La parte de un archivo que genera una transacción de flujo de mensajes se denomina registro. Un archivo puede constar de un solo registro o de una serie de registros. Las propiedades del nodo especifican cómo el nodo FileInput determina los registros de un archivo.

El nodo FileInput se encuentra en la bandeja Archivo de la paleta y está representado en el WebSphere Message Broker Toolkit por el siguiente icono:

Icono de nodo FileInput

Estructura de mensajes

El nodo FileInput maneja los mensajes en los siguientes dominios de mensaje:
  • DFDL
  • XMLNSC
  • DataObject
  • JSON
  • BLOB
  • MIME
  • MRM
  • JMSMap
  • JMSStream
  • XMLNS

Cuando el nodo FileInput propaga un mensaje, almacena información sobre el mismo en el árbol de mensajes LocalEnvironment.File. Si el archivo de entrada está vacío, se propaga un mensaje vacío (suponiendo que sea válido). En la siguiente tabla se muestra la estructura del árbol de mensajes LocalEnvironment.File. Los elementos contienen datos acerca del registro actual.

Nombre de elemento Tipo de datos de elemento Descripción
Directory CHARACTER La vía de acceso de directorio absoluta del directorio de entrada en el formato utilizado por el sistema de archivos del intermediario. Por ejemplo, en los sistemas Windows empieza por el prefijo de letra de unidad (como C:).
Name CHARACTER Nombre y extensión de archivo.
LastModified TIMESTAMP Fecha y hora de la última modificación del archivo.
TimeStamp CHARACTER La fecha y hora, en la hora UTC (Coordinated Universal Time), en la que el nodo de entrada ha empezado a procesar el archivo como una serie de caracteres. Estos datos son la serie utilizada para crear nombres de archivos de archivado y restitución, si se incluye una indicación de fecha y hora.
Los siguientes elementos contienen datos sobre el registro actual:
Offset INTEGER Inicio del registro en el archivo. El primer registro empieza en el desplazamiento 0. Cuando el desplazamiento forma parte del árbol de mensajes de fin de datos, este valor es la longitud del archivo de entrada.
Record INTEGER Número del registro en el archivo. El primer registro es el registro número 1. Cuando el registro parte del árbol de mensajes de fin de datos, este valor es el número de registros.
Delimitador CHARACTER Los caracteres utilizados para separar este registro del registro anterior, si se especifica Delimitados en Detección de registros. El primer registro tiene un delimitador nulo. Cuando el delimitador forma parte del árbol de mensajes de fin de datos, ese valor es el delimitador que sigue al último registro, si hay alguno.
IsEmpty BOOLEAN Indica si el registro propagado por el flujo de mensajes está vacío. IsEmpty se establece en TRUE si el registro actual está vacío. Cuando IsEmpty forma parte del árbol de mensajes Fin de datos, esta propiedad siempre se establece en TRUE.

Utilización de este nodo en un flujo de mensajes

El nodo FileInput se puede utilizar en cualquier flujo de mensajes que deba aceptar mensajes en archivos. También puede consultar los ejemplos siguientes para ver cómo se debe utilizar este nodo:

Puede ver información sobre los ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit o el Information Center en línea. Puede ejecutar ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit.

Si configura un nodo de archivo para utilizar FTP, puede que la red lo necesite para conectarse a un servidor proxy FTP, en lugar de hacerlo directamente al servidor FTP remoto. La forma de configurar los nodos de archivo para utilizar un proxy FTP dependerá de cómo gestione las solicitudes ese proxy. Para algunos proxies FTP, deberá codificar la información del servidor FTP de destino en las credenciales de inicio de sesión que cree con el mandato mqsisetdbparms. Por ejemplo, algunos proxies FTP dan soporte a los valores siguientes:
Username: NombreUsuarioHostDestinoFtp@NombreUsuarioProxy@NombreHostFtpDestino 
Password: ContraseñaUsuarioFtpDestino@ContraseñaUsuarioProxy
Otros proxies podrían necesitar distintas codificaciones o puede que requieran una configuración externa o tal vez no pueda utilizarlos con los nodos de archivo.

Configuración del nodo FileInput

Cuando haya colocado una instancia del nodo FileInput en un flujo de mensajes, podrá configurarlo; consulte Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades. Todas las propiedades obligatorias para las que debe especificar un valor (las propiedades que no tienen un valor predeterminado definido) están marcadas con un asterisco.

Configure el nodo FileInput:

  1. Opcional: En el separador Descripción, escriba una Descripción corta, una Descripción larga o ambas. En este separador también puede renombrar el nodo.
  2. En el separador Básicas, especifique los directorios y los archivos que debe procesar el nodo FileInput, junto con lo que hará con los archivos duplicados que encuentre.
    • En Directorio de entrada, especifique el directorio del que el nodo FileInput obtiene archivos. Especifique el directorio como una vía de acceso de directorio relativa o absoluta. Si la vía de acceso de directorio es relativa, se basa en el directorio especificado en la variable de entorno MQSI_FILENODES_ROOT_DIRECTORY. Un ejemplo en sistemas Windows es C:\fileinput. Un ejemplo en sistemas UNIX es /var/fileinput.

      El nodo FileInput crea un subdirectorio mqsitransitin en el directorio de entrada especificado para contener y bloquear los archivos de entrada mientras se están procesando. Si se elimina un grupo de ejecución que procesa archivos en este directorio de entrada, compruebe el subdirectorio mqsitransitin para determinar si hay archivos procesados parcialmente o sin procesar. Traslade dichos archivos al directorio de entrada (y elimine el prefijo de UUID del grupo de ejecución de los nombres de archivo) de modo que puedan procesarse en otro grupo de ejecución. Para obtener más información acerca del subdirectorio mqsitransitin, consulte Cómo varios nodos de archivo comparten el acceso a archivos del mismo directorio.

    • Seleccione Incluir subdirectorios locales si desea procesar los archivos de la estructura de directorios que están dentro del Directorio de entrada. El intermediario debe tener acceso al directorio de nivel superior que ha especificado; si el intermediario no tiene acceso a un subdirectorio concreto, no se busca dicho subdirectorio y se graba un mensaje para el rastreo de usuario. Los archivos se procesan según su antigüedad, es decir que primero se procesan los archivos más antiguos independientemente del lugar en la estructura de directorios en el que hayan aparecido. La decisión sobre si se procesan los archivos o bien se ignoran se determina, en primer lugar, según el nombre o patrón del archivo y, en segundo lugar, según el patrón de exclusión del archivo.

      Si selecciona las propiedades Incluir subdirectorios locales y Transferencia remota, sólo se buscan archivos que procesar en los subdirectorios del sistema local. Mientras que en el sistema remoto, sólo se buscan archivos que procesar en el directorio de nivel superior que ha especificado.

    • En Nombre de archivo o patrón, especifique un patrón para el nombre de archivo. Es un nombre de archivo o una secuencia de caracteres (un patrón) que coincide con un nombre de archivo. Un patrón es una secuencia que contiene como mínimo uno de los siguientes caracteres comodín:
      Carácter comodín Descripción Ejemplo
      * Cualquier secuencia de cero o más caracteres *.xml coincide con todos los nombres de archivo con una extensión xml
      ? Cualquier carácter individual f??????.csv coincide con todos los nombres de archivo que consten de la letra f seguida de seis caracteres y después la secuencia .csv.
      Para que un archivo pueda procesarse, su nombre debe coincidir con el patrón.

      Si especifica un patrón de nombre de archivo que contenga caracteres comodín, el nodo FileInput copiará los caracteres en el nombre de archivo que ha coincidido con los comodines, junto con todos los caracteres intermedios, en el elemento LocalEnvironment.Wildcard.WildcardMatch. Si desea más información, consulte Patrones de nombres de archivos.

    • En Patrón de exclusión de archivos, especifique un patrón para nombres de archivo que desee excluir del proceso. Especifique un nombre de archivo o una secuencia de caracteres (un patrón) que coincida con un nombre de archivo. Un patrón es una secuencia que contiene como mínimo uno de los caracteres comodín detallados en Caracteres comodín. Para excluir un archivo del proceso, su nombre debe coincidir con el patrón.
    • Seleccione Acción si el proceso es satisfactorio para especificar la acción que el nodo FileInput lleva a cabo después de procesar satisfactoriamente el archivo. La acción puede ser trasladar el archivo a un subdirectorio de archivado, aumentar la indicación de fecha y hora y trasladar el archivo de origen al subdirectorio de archivado o suprimir el archivo.
      • Si selecciona Mover a subdirectorio de archivado, el archivo de origen se mueve al subdirectorio de archivado del directorio de entrada. El nombre de subdirectorio es mqsiarchive. Por ejemplo, si el directorio de entrada es /var/fileinput, la vía de acceso absoluta del subdirectorio de archivado es /var/fileinput/mqsiarchive. Si este directorio no existe, el intermediario lo creará la primera vez que se intente mover un archivo al mismo.
      • Si selecciona Añadir indicación de fecha y hora y mover a subdirectorio de archivado, la fecha y hora actual se añaden al archivo y el archivo se moverá a mqsiarchive.
      • Si selecciona Suprimir, el archivo se suprimir después de un proceso satisfactorio.
      El nodo FileInput graba un mensaje en el rastreo de usuario, si el rastreo de usuario está en funcionamiento, siempre que procesa un archivo.
    • Seleccione Sustituir archivos archivadores duplicados si desea sustituir un archivo en el subdirectorio de archivado por un archivo con el mismo nombre procesado satisfactoriamente. Si no establece esta opción y existe un archivo con el mismo nombre en el subdirectorio de archivado, el nodo genera una excepción cuando intente mover un archivo procesado satisfactoriamente.
  3. En el separador Análisis de mensaje de entrada, establezca valores para las propiedades que el nodo utiliza para determinar cómo analizar el mensaje de entrada.
    • En Dominio de mensajes, en la lista que se proporciona seleccione el nombre del analizador que utiliza. El valor predeterminado es BLOB. Puede elegir entre las siguientes opciones:
      • DFDL
      • XMLNSC
      • DataObject
      • JSON
      • BLOB
      • MIME
      • MRM
      • JMSMap
      • JMSStream
      • XMLNS
      También puede especificar un analizador definido por el usuario, si es lo adecuado.
    • Si utiliza el analizador DFDL, el analizador MRM o el analizador XMLNSC en modalidad de validación, seleccione el Modelo de mensaje relevante en la lista. Esta lista se llena con conjuntos de mensajes disponibles cuando se selecciona MRM o XMLNSC como Dominio de mensajes, o con archivos de esquema DFDL disponibles al seleccionar DFDL como Dominio de mensajes.
    • Si utiliza los analizadores DFDL o MRM, seleccione el mensaje correcto en la lista de Mensaje. Esta lista se llena con los mensajes definidos en el Modelo de mensaje que se ha seleccionado.
    • Si está utilizando el analizador MRM, seleccione el formato del mensaje en la lista de Formato físico. Esta lista incluye todos los formatos físicos que se han definido para este Modelo de mensaje.
    • Especifique el ID de juego de caracteres codificado del mensaje ID de juego de caracteres codificado del mensaje.
    • Seleccione la codificación del mensaje en la lista Codificación del mensaje o especifique un valor de codificación numérica. Para obtener más información sobre la codificación, consulte Conversión de datos.
  4. En el subseparador Opciones de análisis:
    • De forma predeterminada, Temporización de análisis está establecido en A petición con lo cual el análisis del mensaje se retrasa. Para hacer que el mensaje entero que se analice inmediatamente, establezca esta propiedad en Inmediato o Completo. Consulte Análisis a petición para obtener más detalles.
    • Si está utilizando el analizador XMLNSC, establezca los valores de las propiedades que determinen cómo funciona el analizador XMLNSC. Para obtener más información, consulte Manipular mensajes en el dominio XMLNSC.
  5. En el separador Sondeo, especifique un valor para el Intervalo de sondeo. Esta propiedad controla la frecuencia con la que el nodo FileInput accede al sistema de archivos para buscar archivos para procesar.

    Después de la exploración inicial del directorio cuando se inicia el flujo, siempre que se detecte que el directorio no contiene ningún archivo que coincida con el patrón de entrada, el nodo FileInput espera durante el periodo definido por esta propiedad. Este proceso evita que el nodo FileInput tenga que acceder continuamente al sistema de archivos y consumir grandes cantidades de recursos del sistema.

    Cuanto más pequeño sea el valor establecido en esta propiedad, más rápidamente el nodo FileInput descubrirá archivos que se encuentran en el directorio de entrada. No obstante, un valor menor aumenta la utilización de los recursos del sistema. Si se indica un valor más grande se reducirá el uso de los recursos del sistema, pero será a costa de que el nodo FileInput descubra los archivos a procesar menos rápidamente.

    No utilice esta propiedad como forma de regular el trabajo o para planificar el proceso. Si desea que el nodo FileInput supervise el directorio de entrada sólo durante determinados periodos, debe iniciar y detener el flujo de mensajes en los momentos oportunos.

    Si selecciona la propiedad Transferencia remota y establece la propiedad Retardo de exploración en el separador FTP, el valor que establezca para Retardo de exploración altera temporalmente el valor establecido para Intervalo de sondeo.

  6. Utilice el separador Reintento para definir cómo se realiza el proceso de reintento cuando un flujo de mensajes sufre una anomalía:
    • Mecanismo de reintento determina la acción que debe efectuarse si se produjera una anomalía en el flujo:
      • Seleccione Anomalía para que el nodo notifique una anomalía sin realizar ningún reintento.
      • Seleccione Reintento corto para que el nodo realice reintentos antes de notificar una anomalía, si la condición persiste. El número de reintentos se especifica en Umbral de reintentos.
      • Seleccione Reintento corto y después reintento largo para que en primer lugar el nodo reintente con el valor especificado en Umbral de reintentos como el número de intentos que va a realizar. Si la condición persiste una vez que se ha alcanzado el valor Umbral de reintentos, el nodo utiliza el valor de Intervalo de reintento largo entre los intentos.
    • Especifique un valor para la propiedad Umbral de reintentos. El número de veces que el nodo reintenta la transacción de flujo si la propiedad Mecanismo de reintento está establecida en Reintento corto o Reintento corto y después reintento largo.
    • Especifique un valor para la propiedad Intervalo de reintento corto. El periodo de tiempo, especificado en segundos, que se debe esperar entre reintentos cortos.
    • Especifique un valor para la propiedad Intervalo de reintento largo. El periodo de tiempo que se debe esperar entre reintentos largos hasta que un mensaje es satisfactorio, el flujo de mensajes se detiene o el flujo de mensajes se vuelve a desplegar. La propiedad de intermediario MinLongRetryInterval define el valor mínimo que puede aceptar el Intervalo de reintento largo. Si el valor es inferior al mínimo, se utiliza el valor del intermediario.
    • Especifique un valor para la propiedad Acción si el archivo falla para determinar lo que debe hacer el nodo con el archivo de entrada después de que todos los intentos de procesar su contenido fallen:
      • Mover a subdirectorio de restitución. El archivo se mueve al subdirectorio de restitución del directorio de entrada. El nombre de este subdirectorio es mqsibackout. Si el directorio de entrada es /var/fileinput, la vía de acceso absoluta del subdirectorio de restitución es /var/fileinput/mqsibackout. Si este subdirectorio no existe, el intermediario lo creará la primera vez que se intente mover un archivo al mismo. Si el archivo no se puede mover a este subdirectorio, quizás porque allí existe un archivo con el mismo nombre, el nodo añade la fecha y hora actual al nombre de archivo y hace un segundo intento de mover el archivo. Si este segundo intento falla, el nodo detiene el proceso. Se emiten los mensajes BIP3331 y BIP3325. Resuelva el problema con el subdirectorio o archivo antes de intentar reiniciar el flujo de mensajes.
      • Suprimir. El archivo se suprime después de que falle el proceso.
      • Añadir indicación de fecha y hora y mover a subdirectorio de restitución. La fecha y la hora actuales se añaden al nombre de archivo y, a continuación, el archivo se traslada al subdirectorio de restitución.
  7. Utilice el separador Registros y elementos para especificar cómo cada archivo se interpreta como registros:
    • Utilice la propiedad Detección de registros para determinar cómo se parte el archivo en registros, cada uno de los que genera un solo mensaje. Elija una de las siguientes opciones:
      • Todo el archivo especifica que todo el archivo es un solo registro.
      • Longitud fija especifica que cada registro tiene una longitud con un número de bytes fijo. Cada registro contiene el número de bytes especificado en la propiedad Longitud, salvo posiblemente un registro final más corto en el archivo.
      • Seleccione Delimitados, si los registros que está procesando están separados, o interrumpidos, por un fin de línea de DOS o UNIX o por una secuencia de bytes de delimitador definido por el usuario. Especifique el delimitador y el tipo de delimitador en las propiedades Delimitador y Tipo de delimitador.
      • Seleccione Secuencia de registros analizados si el archivo contiene una secuencia de uno o varios registros reconocidos en serie por el analizador especificado en Dominio de mensajes. El nodo propaga cada registro reconocido como mensaje independiente. Si selecciona la opción de Detección de registros, el analizador especificado en Dominio de mensajes debe ser XMLNSC o MRM (formato físico CWF o TDS).
    • Si ha especificado Longitud fija en la propiedad Detección de registros, utilice Longitud para especificar la longitud requerida del registro de salida en bytes. Este valor debe estar en el rango de 1 byte a 100 MB. El valor predeterminado es 80 bytes.

      Si especifica Todo el archivo, Longitud fija o Delimitados en Detección de registros, un límite de 100 MB se aplica a la longitud de los registros. Si especifica Secuencia de registros analizados en Detección de registros, el nodo FileInput no determina ni limita la longitud de un registro. Los nodos que están en sentido descendente en el flujo de mensajes pueden intentar determinar la longitud de registro o procesar un registro largo. Si tiene pensado procesar registros de gran tamaño de esta forma, asegúrese de que el intermediario tiene suficiente memoria. Es posible que tenga que aplicar las técnicas de flujo descritas en el ejemplo de Mensajes grandes para aprovechar al máximo la memoria disponible.

    • Si ha especificado Delimitados en Detección de registros, utilice Delimitador para especificar el delimitador que se va a utilizar. Elija entre:
      • Fin de línea de DOS o UNIX, que en sistemas UNIX, especifica el carácter de salto de línea (<LF>, X'0A') y, en los sistemas Windows, especifica un carácter de retorno de carro seguido de un carácter de salto de línea (<CR><LF>, X'0D0A'). El nodo trata las dos series como delimitadores, sin tener en cuenta el sistema en el que se ejecuta el intermediario. Si las dos aparecen en el mismo archivo, el nodo reconoce a las dos como delimitadores. El nodo no reconoce X'15' que, en sistemas z/OS, es el byte de 'nueva línea'; especifique un valor Delimitador personalizado en esta propiedad y un valor 15 en la propiedad Delimitador personalizado si el archivo de entrada se ha codificado utilizando nuevas líneas EBCDIC, como archivos EBCDIC de un sistema z/OS.
      • Delimitador personalizado, que permite especificar una secuencia de bytes en Delimitador personalizado
    • En Delimitador personalizado, especifique el byte o bytes delimitadores que se deben utilizar cuando Delimitador personalizado se establece en la propiedad Delimitador. Especifique este valor como una serie de número par de dígitos hexadecimales. El valor predeterminado es X'0A' y la longitud máxima de la serie es 16 bytes (representada por 32 dígitos hexadecimales).
    • Si ha especificado Delimitados en Detección de registros, utilice Tipo de delimitador para especificar el tipo de delimitador. Los valores permitidos son:
      • Infijo. Si selecciona este valor, cada delimitador separa dos registros. Si el archivo finaliza con un delimitador, el contenido del archivo, de longitud cero, que sigue al delimitador final todavía se propaga como un mensaje, aunque no contiene datos.
      • Posfijo. Si especifica este valor, cada delimitador termina un registro. Si el archivo finaliza con un delimitador, no se propaga ningún registro vacío después del delimitador. Si el archivo no finaliza con un delimitador, el archivo se procesa como si hubiera un delimitador después de los bytes finales del archivo. Posfijo es el valor predeterminado.
    • El nodo FileInput considera cada aparición del delimitador en el archivo de entrada como separación (Infijo) o terminación (Posfijo) de cada registro. Si el archivo empieza con un delimitador, el nodo trata el contenido del archivo (longitud cero) que precede a ese delimitador como un registro y propaga un registro vacío al flujo. El delimitador nunca se incluye en el mensaje propagado.
  8. Utilice el separador Validación para proporcionar validación basándose en el conjunto de mensajes para los mensajes predefinidos. Para obtener más información sobre la validación, consulte Validar mensajes. Para obtener más información sobre cómo cumplimentar este separador, consulte Propiedades del separador de validación.
  9. En el separador FTP, seleccione la propiedad Transferencia remota si desea que el nodo lea los archivos desde un servidor FTP o SFTP utilizando las propiedades siguientes:
    • En Protocolo de transferencia, especifique el protocolo que se debe utilizar para la transferencia de archivos remota. Los valores posibles son FTP y SFTP.
    • En Servidor remoto y puerto indique la dirección IP y el número de puerto del servidor FTP o SFTP que se vaya a utilizar. Utilice una de las sintaxis siguientes:
      • dirección_IP_o_URL
      • dirección_IP_o_URL:número_puerto
      Si especifica la dirección IP en formato IPv6, asegúrese de encerrarla entre corchetes, como en los ejemplos siguientes:
      • [12a::13bd:24cd]
      • [12a::13bd:24cd]:123 donde 123 es el número de puerto
      Si está utilizando FTP y no especifica un número de puerto, se supone que se trata del puerto 21. Si está utilizando SFTP y no especifica un número de puerto, se supone que se trata del número de puerto 22. Sin embargo, si se ha definido un servicio configurable FtpServer, puede especificar el nombre del servicio configurable en este campo. Para obtener información sobre cómo interactúan una definición de servicio configurable FtpServer y las propiedades de este separador, consulte Propiedades del servicio configurable FtpServer.
    • En Identidad de seguridad, especifique el nombre de una identidad de seguridad que se haya definido utilizando el mandato mqsisetdbparms. El identificador de usuario y la contraseña que se deben utilizar para iniciar la sesión en el servidor FTP o SFTP se obtienen de esta definición, cuyo nombre debe tener un prefijo ftp::. El valor de esta propiedad se altera temporalmente mediante el valor de la propiedad securityIdentity del servicio configurable FtpServer, si se ha establecido.
    • En Directorio de servidor, especifique el directorio en el servidor FTP o SFTP desde el que va a transferir los archivos. El valor predeterminado es un punto (.) que significa el directorio predeterminado después del inicio de sesión. Si especifica una vía de acceso relativa, el directorio se basará en el directorio predeterminado después del inicio de sesión FTP o SFTP. Asegúrese de que la sintaxis de la vía de acceso se ajuste a los estándares de sistemas de archivos del servidor FTP o SFTP. El valor de esta propiedad se altera temporalmente mediante el valor de la propiedad remoteDirectory del servicio configurable FtpServer, si se ha establecido.

      Si selecciona las propiedades Transferencia remota y Incluir subdirectorios locales, sólo se buscan archivos que procesar en los subdirectorios del sistema local. Mientras que en el sistema remoto, sólo se buscan archivos que procesar en el directorio de nivel superior que ha especificado.

    • En Modalidad de transferencia, especifique cómo se transfieren los archivos. Seleccione Binaria si el contenido del archivo no se va a transformar. Seleccione ASCII si el archivo se va a transmitir como ASCII. El valor de esta propiedad se altera temporalmente mediante el valor de la propiedad transferMode del servicio configurable FtpServer, si se ha establecido.

      Esta propiedad es válida solamente cuando se selecciona FTP como protocolo para la transferencia remota. Si ha especificado SFTP como protocolo, se hace caso omiso de la propiedad Modalidad de transferencia y se utiliza codificación binaria.

    • En Retardo de exploración, especifique el retardo, en segundos, entre las exploraciones de directorios. El valor predeterminado es 60 segundos. El valor establecido en esta propiedad altera temporalmente el valor establecido para el intervalo de sondeo en el separador Sondeo cuando se ha seleccionado la propiedad Transferencia remota. El valor de esta propiedad se altera temporalmente mediante el valor de la propiedad scanDelay del servicio configurable FtpServer, si se ha establecido.
  10. En el separador Transacciones, establezca la modalidad de transacción. Aunque todas las operaciones de archivo son no transaccionales, la modalidad de transacción de este nodo de entrada determina si el resto de los nodos del flujo se van a ejecutar bajo el punto de sincronismo. Seleccione Sí si desea tratar transaccionalmente las actualizaciones de flujo, si es posible, y No si no lo desea. El valor predeterminado para esta propiedad es No.
  11. Opcional: en el separador Instancias, establezca los valores para las propiedades que controlan las instancias (hebras) adicionales que están disponibles para un nodo. Para obtener más información, consulte Propiedades configurables del flujo de mensajes.

Terminales y propiedades

Los terminales de nodo FileInput se describen en la siguiente tabla.

Terminal Descripción
Failure (de anomalías) El terminal de salida al que se direcciona un mensaje si se produce un error antes de que el mensaje se propague al terminal Out (de salida). Los mensajes propagados a este terminal no se validan, incluso si ha especificado, utilizando la propiedad Validar, que la validación debe llevarse a cabo.
Out (de salida) El terminal de salida al que se direcciona un mensaje si éste se extrae satisfactoriamente del archivo de entrada. Si no se producen errores en el nodo de entrada, un mensaje recibido de un recurso externo siempre se envía primero al terminal de salida.
End of Data (fin de datos) El terminal de salida al que se direcciona el mensaje de fin de datos una vez que se han procesado todos los mensajes de un archivo. La transacción de flujo de mensajes de fin de datos se inicia sólo si este terminal está conectado.
Catch (de captación) El terminal de salida al que se direcciona un mensaje si se genera una excepción en sentido descendente y después este nodo la capta. Las excepciones se detectan sólo si este terminal está conectado.

Las tablas siguientes describen las propiedades del nodo. La columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco si tiene que entrar un valor cuando no hay definido ningún valor predeterminado); la columna con la cabecera C indica si la propiedad es configurable (puede cambiar el valor cuando añade el flujo de mensajes al archivo BAR para desplegarlo).

Propiedades de Descripción:

Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No FileInput El nombre del nodo.
Descripción corta No No Ninguno Descripción breve del nodo.
Descripción larga No No Ninguno Texto que describe la finalidad del nodo en el flujo de mensajes.

Propiedades de Básicas:

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Directorio de entrada Sí Sí Ninguno La vía de acceso del directorio del que se procesan los archivos de entrada. El directorio debe encontrarse en el sistema de archivos al que el intermediario tiene acceso. Si el directorio de entrada no existe, no se procesa ningún archivo. El nodo FileInput comprueba la existencia del directorio de entrada a intervalos definidos por la propiedad Retardo de exploración. El directorio de entrada debe existir, aun cuando se procesen archivos a través de FTP o SFTP.

El nodo FileInput crea un subdirectorio mqsitransitin en el directorio de entrada especificado. El subdirectorio mqsitransitin mantiene y bloquea los archivos de entrada mientras se están procesando. Si se elimina un grupo de ejecución que procesa archivos en este directorio de entrada, compruebe el subdirectorio mqsitransitin para determinar si hay archivos procesados parcialmente o sin procesar. Traslade dichos archivos al directorio de entrada (y elimine el prefijo de UUID del grupo de ejecución de los nombres de archivo) de modo que puedan procesarse en otro grupo de ejecución.

inputDirectory
Incluir subdirectorios locales Sí Sí Falso Determina si se deben buscar archivos para procesar en todos los subdirectorios bajo el directorio de entrada especificado. Si selecciona esta propiedad y la propiedad Transferencia remota, sólo se buscan archivos en el directorio de nivel superior que ha especificado en el sistema remoto. recursiveDirectories
Nombre de archivo o patrón Sí Sí * Un nombre de archivo o una serie que contiene caracteres comodín especiales (* o ?) que identifican el archivo o los archivos del directorio de entrada que se deben procesar. filenamePattern
Patrón de exclusión de archivos No Sí Ninguno Una serie simple que contiene caracteres comodín (* y ?) que identifica archivos que se excluyen del proceso. excludePattern
Acción si el proceso es satisfactorio Sí No Suprimir La acción que el nodo lleva a cabo en el archivo después de procesar satisfactoriamente el contenido. Las opciones válidas son:
  • Mover a subdirectorio de archivado
  • Añadir indicación de fecha y hora y mover a subdirectorio de archivado
  • Suprimir
 
Sustituir archivos archivadores duplicados Sí No Deseleccionado Esta propiedad controla si el nodo sustituye los archivos de archivado existentes por el mismo nombre como el archivo de entrada. Sólo se aplica cuando Acción si el proceso es satisfactorio no es Suprimir.  

En la tabla siguiente se describen las propiedades de Análisis de mensajes de entrada del nodo FileInput:

Propiedad O C Valor predeterminado Descripción
Dominio de mensajes No No BLOB Dominio que se utiliza para analizar el mensaje. Si el campo está en blanco, el valor predeterminado es BLOB.
Modelo de mensaje No No Deseleccionado Nombre o ubicación del archivo de esquemas de modelos de mensaje en el que se define el mensaje. Esta lista se llena con todos los archivos de esquemas de modelos de mensajes disponibles para el Dominio de mensajes que ha seleccionado.
Mensaje No No Deseleccionado El nombre o ubicación de un elemento global que modela un documento de datos entero y está incluido en su archivo de esquema de modelo de mensaje. Esta lista se llena con todos los mensajes disponibles que se han definido en el Modelo de mensaje que ha seleccionado.
Formato físico No No Deseleccionado Nombre del formato físico del mensaje. Si está utilizando el analizador MRM o IDOC, seleccione el formato físico del mensaje de entrada de la lista. Esta lista incluye todos los formatos físicos que ha definido para este modelo de mensaje seleccionado. Si establece la propiedad Dominio de mensajes en DataObject, puede establecer esta propiedad en XML o IDoc ALE de SAP. Establezca esta propiedad en IDoc ALE de SAP cuando tenga que analizar una corriente de bits desde un origen externo y generar un árbol de mensajes.
ID de juego de caracteres codificado del mensaje Sí No Valor predeterminado del sistema de intermediario El ID del juego de caracteres codificado utilizado para interpretar los bytes del archivo que se lee. La propiedad de mandato mqsiapplybaroverride es messageCodedCharSetIdProperty.
Codificación del mensaje Sí No Determinado por el sistema de intermediario El esquema de codificación para números y caracteres grandes utilizado para interpretar los bytes del archivo que se lee. Los valores válidos son Determinado por el sistema de intermediario o un valor de codificación numérica. Para obtener más información sobre la codificación, consulte Conversión de datos. La propiedad de mandato mqsiapplybaroverride es messageEncodingProperty.

Propiedades de Opciones de análisis:

Propiedad O C Valor predeterminado Descripción
Temporización del análisis No No A petición Esta propiedad controla cuándo se analiza un mensaje de entrada. Los valores válidos son:
  • A petición
  • Inmediato
  • Completo

Si desea ver una descripción completa de esta propiedad, consulte Análisis a petición.

Crear árbol utilizando tipos de datos de esquema XML No No Deseleccionado Esta propiedad controla si los elementos de sintaxis del árbol de mensajes toman los tipos de datos del esquema XML.
Utilizar analizador compacto XMLNSC para dominio XMLNS No No Deseleccionado Especifica si el analizador compacto XMLNSC se utiliza para mensajes en el dominio XMLNS. Si establece esta propiedad, los datos del mensaje se visualizarán bajo XMLNSC en los nodos que estén conectados al terminal de salida cuando uno de los siguientes elementos sea XMLNS:
  • La cabecera MQRFH2 de entrada.
  • La propiedad de Análisis de mensajes de entrada, Dominio de mensajes.
Retener el contenido mixto No No Deseleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes para texto mixto en un mensaje de entrada. Si selecciona el recuadro, se crean elementos para el texto mixto. Si deselecciona el recuadro, el texto mixto se ignora y no se crea ningún elemento.
Retener los comentarios No No No seleccionado Especifica si el analizador XMLNSC crea elementos en el árbol de mensajes para comentarios en un mensaje de entrada. Si selecciona el recuadro, se crean elementos para los comentarios. Si deselecciona el recuadro, los comentarios se ignoran y no se crea ningún elemento.
Retener las instrucciones de proceso No No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes para instrucciones de proceso en un mensaje de entrada. Si selecciona el recuadro, se crean elementos para las instrucciones de proceso. Si deselecciona el recuadro, las instrucciones de proceso se ignoran y no se crea ningún elemento.
Elementos opacos No No Espacio en blanco Esta propiedad se utiliza para especificar una lista de elementos del mensaje de entrada que el analizador XMLNSC deba analizar de forma opaca. El análisis opaco sólo se realiza si la validación no está habilitada (es decir, si Validar tiene el valor Ninguno); las entradas que se especifiquen en Elementos opacos se omiten si la validación está habilitada.

Propiedad de Sondeo:

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Intervalo de sondeo (segundos) Sí Sí 5 El intervalo de sondeo en segundos. waitInterval

Propiedades de Reintento:

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Mecanismo de reintento Sí No Anomalía Cómo maneja el nodo una anomalía del flujo. Las opciones válidas son:
  • Anomalía
  • Reintento corto
  • Reintento corto y largo
 
Umbral de reintentos Sí Sí 0 El número de veces que debe reintentarse la transacción de flujos cuando el valor de la propiedad Mecanismo de reintento es Reintento corto. retryThreshold
Intervalo de reintento corto No Sí 0 El intervalo, en segundos, entre cada reintento si la propiedad Umbral de reintentos no es cero. shortRetryInterval
Intervalo de reintento largo No Sí 300 El intervalo entre reintentos si la propiedad Mecanismo de reintento es Reintento corto y largo y se ha agotado el umbral de reintentos. longRetryInterval
Acción si el archivo falla Sí Sí Mover a subdirectorio de restitución Acción que el nodo lleva a cabo con el archivo de entrada si todos los intentos para procesar el contenido de este archivo fallan. Las opciones válidas son:
  • Mover a subdirectorio de restitución
  • Suprimir
  • Añadir indicación de fecha y hora y mover a subdirectorio de restitución
 

Propiedades de Registros y elementos:

Propiedad O C Valor predeterminado Descripción
Detección de registros Sí No Todo el archivo El mecanismo utilizado para identificar registros en el archivo de entrada. Las opciones válidas son:
  • Todo el archivo

    Cuando establece esta propiedad en Todo el archivo, no se da soporte a los archivos superiores a 2 Gb.

  • Longitud fija
  • Delimitados
  • Secuencia de registros analizados
Longitud Sí No 80 La longitud de cada registro cuando se selecciona la detección de registros Longitud fija.
Delimitador Sí No Fin de línea de DOS o UNIX El tipo de bytes de delimitador que separan o terminan cada registro cuando se ha seleccionado la detección de registros Delimitados. Las opciones válidas son:
  • Fin de línea de DOS o UNIX
  • Delimitador personalizado
Delimitador personalizado No No   Los bytes de delimitador, expresados en hexadecimal, cuando se selecciona la detección de registros Delimitados y el Delimitador personalizado. Esta propiedad sólo es obligatoria si la propiedad Delimitador no se ha establecido en Delimitador personalizado.
Tipo de delimitador Sí No Posfijo La posición del delimitador cuando se selecciona la detección de registros Delimitados. Las opciones válidas son:
  • Posfijo
  • Infijo
Esta propiedad se ignora salvo que la propiedad Delimitador se establezca en Delimitador personalizado.
Saltar el primer registro Sí No FALSE Omitir el primer registro del archivo. El nodo FileInput leerá el primer registro del archivo pero no lo propagará al terminal de salida. Los registros se propagarán según lo habitual a partir del segundo registro. Utilice esta opción cuando el primer registro sea una cabecera que no sea necesario procesar. No es válido utilizar esta opción cuando se utiliza el archivo completo.

Propiedades de Validación:

Para ver la descripción completa de estas propiedades, consulte Propiedades de validación.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Validar No Sí Ninguno Esta propiedad controla si tiene lugar la validación. Los valores válidos son:
  • Ninguno
  • Contenido y valor
  • Contenido
validateMaster
Acción para anomalía No No Excepción Esta propiedad controla qué sucede si falla la validación. Los valores válidos son:
  • Rastreo de usuario
  • Anotaciones de error locales
  • Excepción
  • Lista de excepciones
 

Propiedades de FTP:

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Transferencia remota No Sí Deseleccionado Esta propiedad define si el nodo utiliza las propiedades de transferencia remota de archivos que se listan en el separador FTP y lee archivos tanto de un servidor FTP como SFTP. Si selecciona esta propiedad y la propiedad Incluir subdirectorios locales, sólo se buscan archivos en el directorio de nivel superior que ha especificado en el sistema remoto. fileFtp
Protocolo de transferencia No Sí FTP Esta propiedad especifica el protocolo que se debe utilizar para la transferencia remota. Los valores válidos son:
  • FTP
  • SFTP
remoteTransferType
Servidor remoto y puerto No Sí Ninguno Esta propiedad puede tener cualquiera de estos valores:
  • La dirección IP o el nombre (y, opcionalmente, el número de puerto) de un servidor FTP o SFTP remoto; por ejemplo, ftp.server.com:21 o sftp.server.com:22
  • El nombre de un servicio configurable de tipo FtpServer
Si se especifica un nombre de servicio configurable, se podrán alterar temporalmente las propiedades (alguna o todas) de la transferencia remota en el separador FTP mediante el servicio configurable.
fileFtpServer
Identidad de seguridad No Sí   El nombre de la identificación de usuario que se utiliza para acceder al servidor FTP o SFTP. Esta propiedad se altera temporalmente mediante la propiedad securityIdentity, si está establecida, en el servicio configurable FtpServer. fileFtpUser
Directorio de servidor No Sí "." El directorio en el servidor FTP o SFTP desde el que se transfieren los archivos. Si especifica esta propiedad como vía de acceso relativa, es relativa al directorio padre después del inicio de sesión. Esta propiedad se altera temporalmente mediante la propiedad remoteDirectory, si está establecida, en el servicio configurable FtpServer. fileFtpDirectory
Modalidad de transferencia No No Binaria La modalidad de transferencia FTP para la transferencia de datos de archivos. Esta propiedad es válida solamente cuando se selecciona FTP como protocolo para la transferencia remota. Los valores válidos son:
  • Binaria
  • ASCII
Esta propiedad se altera temporalmente mediante la propiedad transferMode, si está establecida, en el servicio configurable FtpServer.

Si ha especificado SFTP como el protocolo para la transferencia remota, se hace caso omiso de la propiedad Modalidad de transferencia y se utiliza codificación binaria.

 
Retardo de exploración No Sí 60 El retardo, en segundos entre exploraciones de directorio remotas. Esta propiedad altera temporalmente el valor establecido para el Intervalo de sondeo cuando se ha seleccionado la propiedad Transferencia remota. Esta propiedad se altera temporalmente mediante la propiedad scanDelay, si está establecida, en el servicio configurable FtpServer.  

Propiedades de Transacciones:

Propiedad O C Valor predeterminado Descripción
Modalidad de transacción No Sí No La modalidad de transacción de este nodo de entrada determina si el resto de los nodos del flujo se ejecutan bajo el punto de sincronismo. Las opciones válidas son:
  • Sí
  • No
Propiedades de Instancias. Para ver la descripción completa de estas propiedades, consulte Propiedades configurables del flujo de mensajes.
Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Agrupación de instancias adicionales No Sí Utilizar agrupación asociada al flujo de mensajes La agrupación de la que se obtienen instancias adicionales.
  • Si selecciona Utilizar agrupación asociada al flujo de mensajes, las instancias adicionales se obtendrán del flujo de mensajes.
  • Si selecciona Utilizar agrupación asociada al nodo, se asignan instancias adicionales desde las instancias adicionales del nodo basándose en el número especificado en la propiedad Instancias adicionales.
componentLevel
Instancias adicionales No Sí 0 El número de instancias adicionales que el nodo puede iniciar si la propiedad Agrupación de instancias adicionales se establece en Utilizar agrupación asociada al nodo. additionalInstances
Las propiedades de supervisión del nodo se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Sucesos No No Ninguno Los sucesos que se han definido para el nodo se visualizan en este separador. De forma predeterminada, no se define ningún suceso de supervisión en ningún nodo en un flujo de mensajes. Utilice Añadir, Editar y Suprimir para crear, cambiar o suprimir sucesos de supervisión para el nodo; consulte Configuración de orígenes de sucesos de supervisión utilizando propiedades de supervisión para obtener detalles.

Puede habilitar e inhabilitar sucesos que se muestran aquí seleccionando o deseleccionando el recuadro Habilitado.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última actualización
        
        Última actualización : 2012-07-13 19:53:07


Tema de referenciaTema de referencia | Versión 8.0.0.1 | ac55150_