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:
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: 
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:
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.
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.
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.
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.
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).
| 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. |
| 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 |
| 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. |
| 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.
| 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.
| 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.
|
|
| 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 |
| 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.
| 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. |
| 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 |
| 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. |