Utilice el nodo SAPRequest para enviar peticiones a una aplicación SAP.
Este tema contiene las siguientes secciones:
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:
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.
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 ********
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.
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).
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. |
Propiedad | O | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Componente de adaptador primario | Sí | 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 | Sí | 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 | Sí | Sí | 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 |
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 | 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 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. |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Modalidad de transacción | No | No | Automática | Especifica cómo se manejan las actualizaciones.
Para obtener más información sobre la transaccionalidad, consulte Confirmaciones de transacción BAPI de SAP. |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Ubicación de método | Sí | 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 | Sí | 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. |
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. |
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. |