Nodo .NETInput

Utilice el nodo .NETInput para recuperar datos de muchas fuentes diferentes, como por ejemplo MSMQ, archivos o bases de datos, accediendo a los datos mediante código .NET.

Este tema contiene las secciones siguientes:

Finalidad

El nodo .NETInput obtiene datos de un origen que el creador especifica para iniciar un flujo de mensajes. Los mensajes de salida que se crean en el nodo .NETInput se forman mediante la interpretación de la información que se obtiene del origen de datos; como por ejemplo, aplicaciones .NET o COM.

El nodo .NETInput utiliza cualquier lenguaje compatible con Common Language Runtime (CLR) para crear el mensaje; como por ejemplo, C#, Visual Basic (VB), F# y C++/CLI.

El desarrollador del flujo de mensajes tiene el control del código .NET, lo que hace que el nodo .NETInput sea flexible en cuanto al lugar del que puede recuperar datos. Por ejemplo, puede escribir código .NET que lee mensajes de una fuente MSMQ, una cola WebSphere MQ, el sistema de archivos o de una base de datos. Cuando esté escribiendo código para un nodo .NETInput, se proporcionan dos plantillas dentro de Microsoft Visual Studio.

El nodo .NETInput está incluido en la bandeja .NET de la paleta y está representado en IBM® Integration Toolkit con el siguiente icono: .NETInput

El nodo .NETInput sólo se ejecuta en intermediarios de Windows. Se produce un error si intenta desplegar un flujo de mensajes que contenga un nodo .NETInput en un intermediario que se ejecuta en un sistema que no es Windows. Asegúrese de que el intermediario se esté ejecutando en Windows antes de desplegar el flujo de mensajes.

Cuando esté escribiendo codigo para un nodo .NETInput, se proporcionan dos plantillas dentro de Microsoft Visual Studio. Estos dos plantillas son para dos estilos de interacción diferentes:

  • Un nodo .NETInput basado en el sondeo
  • Un nodo .NETInput controlad por menús

Utilización de este nodo en un flujo de mensajes

Debe asociar el nodo .NETInput con un conjunto .NET que contenga el código que controla la interacción del nodo .NETInput con el origen de datos o mensajes, que se propagan a través del flujo de mensajes.

Para obtener más información, consulte Escritura de un código para un nodo .NETInput.

Debe escribir código para personalizar el comportamiento del nodo .NETInput utilizando los esqueletos de código de plantilla que se suministran para Microsoft Visual Studio. El nodo .NETInput debe configurarse con un conjunto .NET que contenga el código del nodo. El código consta de una clase que deriva de una de las clases base abstractas proporcionadas (NBPollingConnector o NBEventConnector) que están en el conjunto IBM.Broker.Plugin.dll.

Sólo se crea una instancia de un determinado nodo .NETInput, independientemente del número de hebras que se ejecutan para el flujo de mensajes, ya sea como resultado de instancias adicionales o de varios nodos de entrada. Por lo tanto, todo el código .NET de usuario debe ser de enhebramiento seguro y reentrada. Para obtener más información sobre cómo hacer que un nodo sea de enhebramiento seguro y asegurarse de que las funciones implementadas e iniciadas por extensiones definidas por el usuario sean reentrantes, consulte Modelo de ejecución de extensiones definidas por el usuario y Consideraciones acerca de las hebras para extensiones definidas por el usuario.

El código que se escribe para el nodo de entrada .NET no participa en transacciones Integration Bus.

Para obtener más información sobre la creación de código .NET para un nodo .NETCompute, puede acceder a la documentación de la API .NET que se incluye con la instalación de IBM Integration Bus desde la ubicación del menú Inicio en Windows.

Configuración del nodo .NETInput

Cuando coloca una instancia del nodo .NETInput en un flujo de mensajes; debe configurarlo, consulte Configurar un nodo de flujo de mensajes. Para configurar el nodo, puede arrastrar un archivo de ensamblado desde un explorador de archivos hasta el nodo, o pulsar el botón Examinar. Las propiedades del nodo se visualizan en la vista Propiedades.

Todas las propiedades obligatorias para las que debe especificar un valor (las que no tienen un valor predeterminado definido) están marcadas con un asterisco.

Clonación de un nodo .NETInput

Puede reproducir los parámetros y atributos que ha personalizado para un nodo .NETInput creando un nodo Cloned a partir de él. El nodo Cloned no tiene ninguna propiedad especial propia y no se puede crear desde la bandeja de la paleta. Sólo se puede crear desde un nodo .NETInput configurado, existente.

Para crear un nodo Cloned, debe seleccionar el nodo .NETInput, pulsar con el botón derecho del ratón, y luego seleccionarCrear nodo clonado ...

El nodo Cloned se guarda en la bandeja de la paleta .NET con el nombre asignado y está representado en IBM Integration Toolkit por el icono del nodo elegido.

Cuando se crea una instancia de un nodo Cloned, se configura con las propiedades y los valores que se han especificado para el nodo .NETInput del que se ha clonado.

Si desea modificar las propiedades o valores de un nodo Cloned, puede configurarlos. Consulte Configurar un nodo de flujo de mensajes.

Puede configurar una instancia de un nodo Cloned cuando lo arrastra a una correlación de datos gráficos. Para configurar el nodo, puede arrastrar un archivo de ensamblado de un explorador de archivos al nodo. Las propiedades del nodo se visualizan en la vista Propiedades.

Todas las propiedades obligatorias para las que debe especificar un valor (las que no tienen un valor predeterminado definido) están marcadas con un asterisco.

Validación de mensajes

Establezca las propiedades de validación para definir cómo se validan los mensajes generados por el nodo .NETInput.

Para obtener más información, consulte Validar mensajes y Propiedades de validación.

Terminales y propiedades

Los terminales del nodo .NETInput están descritos 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). Aunque esté establecida la propiedad Validación, los mensajes propagados a este terminal no se validan.
Out (de salida) 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.
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 de nodo que el usuario puede establecer en un separador especificado. La columna con la cabecera M indica si la propiedad es obligatoria (marcada en el kit de herramientas con un asterisco si es necesario especificar un valor cuando no existe ningún valor predeterminado definido). La columna con la cabecera C indica si la propiedad es configurable (puede cambiar el valor cuando añada el flujo de mensajes al archivo BAR para desplegarlo).

Propiedades de Descripción:
Propiedad M C Valor predeterminado Descripción
Nombre de nodo No No El tipo de nodo El nombre del nodo.
Descripción corta No No   Una descripción breve del nodo.
Descripción larga No No   Texto que describe el propósito del nodo en el flujo de mensajes.
Propiedades de Básico:
Propiedad M C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Nombre de ensamblado Sí Sí   El conjunto que implementa el nodo. Utilice la opción Examinar para seleccionar un conjunto; también se puede soltar un archivo .dll de conjunto en el nodo para completar automáticamente esta propiedad. assemblyName
Nombre de clase No Sí   Nombre de la clase que implementa el nodo. Es necesario un valor para esta propiedad sólo si dos o más nodos están a la vista en el mismo conjunto, o para nombrar de forma explícita una subclase como nodo de implementación. connectorClassName
Propiedades de Análisis de mensaje de entrada:
Propiedad M C 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 No seleccionado 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 No seleccionado Nombre o ubicación de la raíz de mensaje dentro del archivo de esquemas de modelos 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 No seleccionado Nombre del formato físico del mensaje. Si utiliza el analizador MRM o IDoc, seleccione el formato físico del mensaje de entrada en la lista. Esta lista incluye todos los formatos físicos que se han definido para el 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 desee analizar una corriente de bits desde un origen externo y generar un árbol de mensajes.
ID de juego de caracteres codificado del mensaje No No Valor predeterminado del sistema de intermediario El ID del juego de caracteres codificado utilizado para interpretar bytes del archivo que se lee. La propiedad de mandato mqsiapplybaroverride es messageCodedCharSetIdProperty.
Codificación del mensaje No No Determinado por el sistema de intermediario El esquema de codificación para números y caracteres grandes que se utiliza para interpretar 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 M C Valor predeterminado Descripción
Temporización del análisis Sí No A petición Esta propiedad controla cuándo se analiza un mensaje de entrada. Los valores válidos son A petición, Inmediato y Completo.

De forma predeterminada, Temporización del análisis está establecido en A petición, con lo cual el análisis del mensaje se retrasa. Para que el mensaje se analice de forma inmediata, consulte Análisis a petición.

Crear árbol utilizando los tipos de datos de esquema XML Sí No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos de sintaxis en el árbol de mensajes con tipos de datos tomados del esquema XML. Esta propiedad sólo se puede seleccionar si se establece la propiedad Validar del separador Validación en Contenido o Contenido y valor.
Utilizar analizador compacto XMLNSC para dominio XMLNS Sí No No seleccionado Esta propiedad controla 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 nodos que estén conectados al terminal de salida cuando la cabecera MQRFH2 de entrada o la propiedad de Análisis de mensaje de entrada Dominio de mensajes sea XMLNS. Para obtener más información, consulte Manipulación de mensajes en el dominio XMLNSC.
Retener el contenido mixto Sí No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra 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 Sí No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra 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 Sí No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra 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 Sí 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.

Las propiedades de Validación del nodo .NETInput se describen en la tabla siguiente. Establezca estas propiedades si desea que el analizador valide el cuerpo de los mensajes para el Modelo de mensaje. (Si un mensaje se propaga al terminal de anomalías del nodo, no se valida.)

Para obtener más información, consulte Validar mensajes y Propiedades de validación.

Propiedades de Validación:
Propiedad M C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Validar Sí Sí Ninguno Esta propiedad controla si tiene lugar la validación. Los valores válidos son Ninguno, Contenido, Contenido y valor y Heredar. validateMaster
Acción para anomalía Sí No Excepción Esta propiedad controla qué sucede si falla la validación. Sólo puede establecer esta propiedad si establece Validar en Contenido o Contenido y valor. Los valores válidos son Rastreo de usuario, Registros de errores locales, Excepción y Lista de excepciones.  

Para obtener una descripción completa de las propiedades de Instancias, consulte Propiedades configurables del flujo de mensajes.

Propiedades de Instancias:
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 que se basa en el número especificado en la propiedad Instancias adicionales.
 
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
Propiedades de Panel de supervisión:
Propiedad O C Valor predeterminado Descripción
Sucesos No No Ninguno Los sucesos definidos 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.

Las propiedades de Microsoft Visual Studio del nodo .NETInput se describen en la tabla siguiente. Estas propiedades se envían en tiempo de ejecución como parte del despliegue al conector de entrada.

Para obtener más información, consulte Creación de mensajes utilizando un nodo .NETInput.

Propiedades de Visual Studio:
Propiedad M C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Nombre de proyecto de Visual Studio No No   El proyecto o la solución de Microsoft Visual Studio que contiene el código del nodo.  
Propiedades Avanzadas:
Propiedad M C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Nombre de dominio de aplicación No Sí   El .NET AppDomain que aloja el nodo. AppDomain
Versión No Sí   La versión del conjunto. AssemblyVersion
Cultura No Sí   La cultura del conjunto. AssemblyCulture
Señal de clave pública No Sí   La señal de clave pública del conjunto. AssemblyPublicKeyToken
Propiedades de Usuario:
Propiedad M C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
<Nombre proporcionado por el usuario> No No   El nodo proporciona una tabla en la que el usuario puede Añadir, Modificar o Suprimir filas, cada una de las cuales proporciona un par Nombre: Valor.  
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Última actualización:
        
        Última actualización: 2013-07-16 12:52:33


Tema de referenciaTema de referencia | IBM Integration Bus Versión 9.0.0.0 | bc16290_