Utilice el nodo SAPInput para aceptar entrada de una aplicación SAP.
Este tema contiene las siguientes secciones:
Utilice el nodo SAPInput para aceptar entrada de aplicaciones SAP. Por ejemplo, el nodo SAPInput puede supervisar un sistema SAP para nuevos pedidos de compra. Cuando se produce un nuevo pedido de compra, el nodo SAPInput genera un árbol de mensaje que representa el objeto de empresa con los nuevos detalles del pedido de compra. El árbol de mensaje se propaga al terminal de salida para que el resto del flujo de mensajes pueda utilizar los datos para actualizar otros sistemas o para auditar los cambios.
El nodo SAPInput se representa en la bandeja WebSphere Adapters de la paleta de nodos de flujos de mensajes, y se representa en el WebSphere Message Broker Toolkit con el siguiente icono:
El nodo SAPInput necesita un componente de adaptador para funcionar correctamente. El componente se establece utilizando la propiedad de nodo Componente de adaptador y definiciones de objeto de empresa, que están almacenadas en el conjunto de mensajes al que hace referencia desde el nodo. Por esta razón, debe proporcionar un conjunto de mensajes. De forma predeterminada, el mensaje que se propaga desde el nodo SAPInput está en el dominio de DataObject, por lo tanto la propiedad Dominio de mensajes se establece en DataObject. No puede especificar un dominio distinto. El nodo detecta automáticamente el tipo de mensaje.
El nodo SAPInput rellena la lista de destinos de Route-to-label con el nombre del enlace de método. Si añade un nodo RouteToLabel al flujo de mensajes después del nodo SAPInput, el nodo RouteToLabel puede utilizar el nombre del enlace de método para direccionar el mensaje a la parte correcta del flujo de mensajes para su proceso.
Puede desplegar sólo un nodo de entrada que utiliza un componente de adaptador concreto para un grupo de ejecución, aunque puede desplegar varios nodos de entrada que utilizan componentes de adaptador distintos para un grupo de ejecución.
mqsisetdbparms nombre de intermediario -n nombre de adaptador -u nombre de usuario -p contraseña
Por ejemplo:mqsisetdbparms BRK1 -n eis::SAPCustomerInbound.inadapter -u sapuid -p ********
Utilización de servicios configurables para nodos SAP
Los nodos SAP pueden obtener detalles de conexiones SAP del componente adaptador o de un servicio configurable. Utilizando un servicio configurable, puede cambiar los detalles de conexión de un adaptador sin tener que volver a desplegar el adaptador. Para obtener más información sobre la creación, el cambio, la notificación y la supresión de servicios configurables para SAP, consulte Cambiar detalles de conexión para adaptadores SAP.
Direccionamiento IDoc genérico
Al utilizar el nodo SAPInput en modalidad passthrough, WebSphere Message Broker puede recibir ningún IDoc y ruta de acuerdo con el tipo de IDoc. Para obtener más información, consulte Direccionamiento IDoc genérico. Puede utilizar un patrón para procesar IDoc de varios tipos con un solo ID de programa RFC sin tener que volver a desplegar ni volver a descubrir los conjuntos de mensajes y adaptadores existentes, incluso cuando añada nuevos tipos de IDoc. Para obtener más información, consulte el patrón: Distribución de datos SAP a WebSphere MQ: unidireccional (para IDoc). Puede ver patrones en el Information Center mediante los enlaces sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit, o cuando utilice el Information Center en línea.
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.
Cuando haya colocado una instancia del nodo SAPInput en un flujo de mensajes, podrá configurarlo; consulte el tema Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades. Si efectúa una doble pulsación en un nodo SAPInput, abra el asistente Conexión de adaptador. 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.
Los terminales de nodo SAPInput se describen en la siguiente tabla.
Terminal | Descripción |
---|---|
Out (de salida) | Los sucesos de Objeto de empresa del adaptador se envían al terminal de salida. |
Failure (de anomalías) | Si se produce un error en el nodo SAPInput, el mensaje se propaga al terminal Failure (de anomalías). La información sobre el error y sucesos de objeto de empresa también se puede propagar al terminal Failure (de anomalías). |
Catch (de captación) | Los sucesos de Objeto de empresa se envían al terminal Catch (de captación) si provocan una excepción sin detectar en el flujo de mensajes. Si el terminal Catch (de captación) no está conectado, el proceso de reintento se activa para manejar el objeto de empresa. |
Las tablas siguientes describen las propiedades del nodo. Las columnas con la cabecera O indican si la propiedad es obligatoria (marcada con un asterisco si tiene que entrar un valor cuando no hay definido ningún valor predeterminado); las columnas con la cabecera C indican si la propiedad es configurable (puede cambiar el valor cuando añade el flujo de mensajes al archivo BAR para desplegarlo).
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Nombre de nodo | No | No | El tipo de nodo, SAPInput | El nombre del nodo. |
Descripción corta | No | No | Una descripción breve del nodo. | |
Descripción larga | No | No | Texto que describe la finalidad del nodo en el flujo de mensajes. |
Propiedad | O | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Componente de adaptador primario | Sí | Sí | Nombre del componente de adaptador que contiene propiedades de configuración para el adaptador. Especifique un nombre de un archivo de adaptador o pulse Examinar para seleccionar un archivo de adaptador
en la lista de archivos que están disponibles en proyectos de conjuntos de mensajes referenciados. Cuando el nodo SAPInput recibe datos del sistema SAP, asocia los datos a un nombre de método, dependiendo del nombre de la operación de servicio que se haya asignado a este tipo de datos cuando se ha ejecutado el asistente Conexión de adaptador. El nodo SAPInput intenta gestionar métodos que se han definido en el adaptador primario. Si el tipo de datos que se reciben no corresponde a ninguno de los métodos que se han definido en el adaptador primario, el nodo puede gestionar los métodos que se han definido en los adaptadores secundarios coincidentes que se despliegan en el mismo grupo de ejecución. |
adapterComponent | |
Modalidad de adaptador secundario | No | Sí | Ninguna | Especifica si el nodo puede gestionar métodos que se hayan en adaptadores secundarios. Si ha establecido la propiedad Modalidad de adaptador secundario en Ninguna, el nodo gestiona solamente los métodos definidos en el adaptador primario. Si el tipo de datos que se reciben no corresponden a ninguno de los métodos que se han definido en el adaptador primario, se produce una anomalía. Si establece esta propiedad en Todos los adaptadores de la aplicación, el nodo puede manejar métodos que esté definidos en los adaptadores de entrada SAP coincidentes que se hayan desplegado en la misma aplicación. Si el nodo se despliega como recurso independiente (es decir, no se incluye en una aplicación), el nodo puede llamar a métodos que se definen en el adaptador de entrada SAP que también se despliega como recurso independiente. |
secondaryAdapterMode |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Tiempo máximo de espera de cliente (seg) | No | Sí | 60 | El tiempo (en segundos) que debe esperar el sistema SAP una respuesta que debe devolver un nodo SAPReply. El valor predeterminado es de 60 segundos. Si se envía una respuesta a un nodo SAPReply después del tiempo de espera, el nodo SAPReply emite una excepción. Si el intermediario está detenido mientras el adaptador está esperando que un nodo SAPReply proporcione una respuesta, se vuelve a enviar al sistema SAP una anomalía del sistema. Si establece esta propiedad en cero (0), el sistema SAP espera indefinidamente una respuesta que debe devolver un nodo SAPReply. Esta propiedad es aplicable sólo a la modalidad de devolución de llamada síncrona; no se aplica a las BAPI o IDOC asíncronas. Si establece esta propiedad para un nodo SAPInput que se ha configurado con un adaptador que no es para devoluciones de llamada síncronas, se emitirá un aviso. |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Establecer lista de destinos | No | No | Seleccionado | Especifica si se tiene que añadir el nombre de enlace de método a la lista de destinos Route-to-label. Si selecciona este recuadro, se añade el nombre de enlace de método para que pueda utilizar un nodo RouteToLabel en el flujo de mensajes después del nodo SAPInput. |
Prefijo de etiqueta | No | No | El prefijo se añade al nombre de etiqueta al direccionar a una etiqueta. Añada un prefijo de etiqueta para evitar un conflicto de los nodos de etiqueta correspondientes cuando se incluyen varios nodos de entrada de Adaptadores de WebSphere en el mismo flujo de mensajes. De forma predeterminada, no hay ningún prefijo de etiqueta, por lo que el nombre de método y el nombre de etiqueta son idénticos. |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Dominio de mensajes | No | No | DataObject | Dominio que se utiliza para analizar el mensaje de entrada. De forma predeterminada, el mensaje que se propaga desde el nodo SAPInput está en el dominio de DataObject. No puede especificar un dominio distinto. |
Conjunto de mensajes | Sí | No | Se establece automáticamente | Nombre del conjunto de mensajes en el que se define el mensaje
de entrada. Este campo se establece automáticamente en la propiedad Componente de adaptador. Si establece esta propiedad y, a continuación, actualiza las dependencias del proyecto para eliminar esta referencia de conjunto de mensajes, se emite un aviso. Actualice la propiedad Conjunto de mensajes o restaure la referencia a este proyecto de conjunto de mensajes. |
Tipo de mensaje | No | No | Nombre del mensaje de entrada. El nodo detecta automáticamente el tipo de mensaje. Esta propiedad no se puede establecer. | |
Formato del mensaje | No | No | Nombre del formato físico del mensaje de entrada. Esta propiedad no se puede establecer. |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Modalidad de transacción | No | No | Sí | La modalidad de transacción de este nodo de entrada determina si el resto de los nodos del flujo de mensajes se ejecutan bajo el punto de sincronismo. |
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.
|
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. De forma predeterminada, no se otorga ninguna instancia adicional al nodo. | additionalInstances |
Propiedad | O | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Mecanismo de reintento | No | No | Anomalía | Especifica cómo se maneja el proceso de
reintento cuando se retrotrae una anomalía al nodo
SAPInput.
|
|
Umbral de reintentos | No | Sí | 0 | El número máximo de veces que se lleva a cabo el proceso de reintento para el reintento corto. | retryThreshold |
Intervalo de reintento corto | No | Sí | 0 | El intervalo entre reintentos cortos. | shortRetryInterval |
Intervalo de reintento largo | No | Sí | 0 | El intervalo entre reintentos largos. | longRetryInterval |
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. |