WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Nodo SAPRequest

Utilice el nodo SAPRequest para enviar peticiones a una aplicación SAP.

Este tema contiene las siguientes secciones:

Finalidad

Utilice el nodo SAPRequest para enviar solicitudes a aplicaciones SAP. Por ejemplo, el nodo SAPRequest puede solicitar información de un Sistema de información de empresa (EIS) de SAP. Se envía un cliente objeto de empresa a SAP, lo que hace que SAP recupere información sobre un cliente, como un detalles de cuenta y dirección. La información de respuesta que recupera el nodo SAPRequest se podrá utilizar por el resto del flujo de mensajes. El nodo SAPRequest puede enviar y recibir datos empresariales.

El nodo SAPRequest 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:

Icono de nodo SAPRequest

Utilización del nodo SAPRequest en un flujo de mensajes

El nodo SAPRequest 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 SAPRequest 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.

Para maximizar el rendimiento y evitar la conversión de datos innecesaria, asegúrese de que los mensajes que se pasen al nodo SAPRequest contengan los tipos de datos correctos. El dominio DataObject es el dominio predeterminado cuando se analizan mensajes generados por el nodo SAPRequest. Sin embargo, al pasar datos al nodo SAPRequest (por ejemplo, utilizando un nodo MQInput), el uso de un dominio diferente puede mejorar el rendimiento. Por ejemplo, utilice el analizador XMLNSC con el nodo MQInput para analizar mensajes XML.

El nodo SAPRequest da soporte a las transacciones locales mediante el gestor de transacciones local del intermediario.

Puede desplegar varios nodos de solicitud de Adaptadores de WebSphere que utilicen el mismo componente de adaptador en un grupo de ejecución.

El nodo SAPRequest puede utilizar una identidad que está presente en un mensaje de entrada y propagarla a SAP mediante la propiedad Propagate en el perfil de seguridad definido en el nodo. Para obtener más información, consulte Propagación de las credenciales de seguridad a una solicitud SAP.

Para mantener de forma eficaz la agrupación de conexiones con SAP, puede establecer un valor de tiempo de espera de conexión en un servicio configurable. De forma predeterminada, la propiedad connectionIdleTimeout se establece en cero, lo que indica que no se produce ningún tiempo de espera excedido. No obstante, se abren conexiones nuevas a SAP con ID de usuario diferentes, por tanto, no establezca esta propiedad en cero si utiliza la propagación de identidad. Para obtener más información, consulte Configuración de las conexiones EIS para que caduquen después de un período de tiempo especificado.

Puede utilizar el mandato mqsisetdbparms en el siguiente formato para configurar un nombre de cuenta con un nombre de usuario y una contraseña para el Adaptador para Software SAP. El mandato mqsisetdbparms almacena la contraseña en formato sensible a las mayúsculas y minúsculas. Sin embargo, cuando la GUI de SAP establece una contraseña, automáticamente la convierte a mayúsculas. Por tanto, para conectar al sistema SAP, especifique una contraseña en mayúsculas.
mqsisetdbparms nombre de intermediario -n nombre de adaptador -u nombre de usuario -p CONTRASEÑA
Por ejemplo,
mqsisetdbparms BRK1 -n eis::SAPCustomerOutbound.outadapter -u sapuid -p ********
Consulte el ejemplo siguiente 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.

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.

Terminales y propiedades

Cuando haya colocado una instancia del nodo SAPRequest 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 SAPRequest, 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 SAPRequest se describen en la siguiente tabla.

Terminal Descripción
In (de entrada) El terminal de entrada que acepta el objeto de empresa de solicitud.
Out (de salida) El terminal de salida al que se envía el objeto de empresa de respuesta si representa la finalización satisfactoria de la solicitud y si se requiere proceso adicional dentro del flujo de mensajes.
Failure (de anomalías) Si se produce un error en el nodo SAPRequest, 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).

Las tablas siguientes describen las propiedades de nodo. Las columnas con la cabecera O indican si la propiedad es obligatoria (marcada con un asterisco en el panel 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).

Las propiedades de descripción del nodo SAPRequest se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No El tipo de nodo, SAPRequest 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.
Las propiedades básicas del nodo SAPRequest se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Componente de adaptador primario No   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 SAPRequest recibe datos del sistema SAP, asocia esos datos a un nombre de método. El nodo SAPRequest intenta invocar a los métodos que se han definido en el adaptador primario. Si el método no se ha definido en el adaptador primario, el nodo puede invocar a métodos que se hayan definido en adaptadores secundarios coincidentes que se despliegan en el mismo grupo de ejecución.

 
Modalidad de adaptador secundario No Ninguna Especifica si el nodo puede invocar a métodos que se hayan en adaptadores secundarios.

Si establece la propiedad Modalidad de adaptador secundario en Ninguna, el nodo SAPRequest invoca solamente métodos que se han definido en el adaptador primario. Si no se ha definido el método en el adaptador primario, se produce un error.

Si establece esta propiedad en Todos los adaptadores de la aplicación, el nodo puede invocar a métodos que estén definidos en adaptadores de entrada SAP que se han 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 salida SAP que también se despliega como recurso independiente.

secondaryAdapterMode
Método predeterminado   El enlace de método predeterminado a utilizar. Esta propiedad lista los métodos que están definidos por el adaptador. Puede alterar temporalmente esta propiedad estableciendo el nombre de método en el subárbol LocalEnvironment.Adapter. Para obtener más información, consulte Estructura del árbol de entorno local.

Los nombres del método corresponden a los nombres de operación de servicio, que configura el asistente Conexión de adaptador. En la mayoría de los casos, los nombres se basan en el nombre del servicio que se está descubriendo (por ejemplo, una BAPI).

defaultMethod
En la tabla siguiente se describen las propiedades de Análisis de mensajes de respuesta del nodo SAPRequest.
Propiedad O C Valor predeterminado Descripción
Dominio de mensajes No No DataObject Dominio que se utiliza para analizar el mensaje de respuesta. De forma predeterminada, el mensaje que se propaga desde el nodo SAPRequest está en el dominio de DataObject. No puede especificar un dominio distinto.
Conjunto de mensajes 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 respuesta. 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 respuesta. Esta propiedad no se puede establecer.
Las propiedades de transaccionalidad del nodo SAPRequest se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Modalidad de transacción No No Automática Especifica cómo se manejan las actualizaciones.
  • Si selecciona , el nodo SAPRequest participará en la transacción local que inicia el nodo de entrada del flujo de mensajes.
  • Si selecciona No, el nodo SAPRequest no participará en la transacción local que inicia el nodo de entrada del flujo de mensajes.
  • Si selecciona Automática, el nodo SAPRequest utiliza el valor que se establece en el nodo de entrada que dirige el flujo de mensajes. Por ejemplo, si el flujo de mensajes se dirige mediante un nodo SAPInput, la SAPRequest asume la Modalidad de transacción establecida en el nodo SAPInput.

Para obtener más información sobre la transaccionalidad, consulte Confirmaciones de transacción BAPI de SAP.

Las propiedades de solicitud del nodo SAPRequest se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Ubicación de método No $LocalEnvironment/Adapter/MethodName La ubicación del método de negocio (como por ejemplo createPurchaseOrder o deletePurchaseOrder) que se utiliza para desencadenar el nodo SAPRequest con el fin de llevar a cabo una acción en el sistema externo.
Ubicación de datos No $Body La ubicación del árbol de mensajes de entrada de la que se recuperan los datos para formar la solicitud que se envía del nodo SAPRequest al EIS.
Las propiedades de resultado del nodo SAPRequest se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Ubicación de datos de salida No No $OutputRoot La ubicación del árbol de mensajes al que el nodo SAPRequest envía la salida.
Copiar entorno local No No Seleccionado Esta propiedad controla cómo se copia el entorno local en el mensaje de salida. Si selecciona este recuadro de selección, se crea una nueva copia del entorno local en el árbol (en cada nodo del flujo de mensajes) y se rellena con el contenido del entorno local del nodo preferente. Por lo tanto, si un nodo cambia el entorno local, los nodos anteriores en el flujo de mensajes no ven estos cambios porque tienen sus propias copias. Este comportamiento puede ser un problema si utiliza un nodo FlowOrder, o si utiliza el mandato propagate en un nodo Compute.

Si deselecciona el recuadro de selección, cada nodo no genera su propia copia de seguridad del entorno local, sino que utiliza el entorno local que el nodo anterior le pasa. Por lo tanto, si un nodo cambia el entorno local, esos cambios los verán los nodos en sentido ascendente.

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, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:58:39


Tema de referenciaTema de referencia | Versión 8.0.0.5 | ac37300_