Utilice el nodo PHPCompute para direccionar y transformar un mensaje de entrada, utilizando el lenguaje de script PHP.
El soporte para el lenguaje de script PHP está disponible en todos los sistemas operativos en los que se da soporte a WebSphere Message Broker.
El nodo PHPCompute puede utilizar el lenguaje de script PHP para direccionar y transformar mensajes de entrada.
Utilizando este nodo podrá conseguir los siguientes objetivos:
El nodo PHPCompute se encuentra en la bandeja Transformación de la paleta y está representado en el WebSphere Message Broker Toolkit mediante el siguiente icono:
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.
Cree sentencias PHP para personalizar el comportamiento del nodo PHPCompute. Por ejemplo, puede personalizar el nodo para crear uno o más mensajes de salida utilizando nuevos datos o el contenido de un mensaje de entrada o base de datos (sin cambiar o modificado). Por ejemplo, es posible que desee modificar un valor en el mensaje de entrada añadiendo un valor de una base de datos y almacenar el resultado en un campo en el mensaje de salida.
Cree las sentencias PHP que desee en un archivo de script PHP y asegúrese de que exista en el espacio de trabajo antes de asociarlo con el nodo PHPCompute.
Si el archivo de script PHP necesario existe, impórtelo al espacio de trabajo antes de asociarlo con el nodo PHPCompute (consulte Importación de archivos desde el sistema de archivos a WebSphere Message Broker Toolkit).
Si un archivo PHP no existe para este nodo, cree uno en la carpeta de proyecto con la extensión de archivo .php (por ejemplo, myfile.php). Para obtener más información sobre la creación de un archivo de script PHP, consulte Crear código PHP para un nodo PHPCompute.
El nodo PHPCompute proporciona soporte para el protocolo simple de gestión de red (SNMP). Los archivos MIB (Management Information Base) se instalan durante la instalación de WebSphere Message Broker, y su ubicación se especifica mediante la variable de entorno MIBDIRS.
Una vez que haya puesto una instancia del nodo PHPCompute en un flujo de mensajes, puede configurarlo. Para obtener más información sobre cómo configurar nodos, consulte Configurar un nodo de flujo de mensajes.
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 en esta vista.
Para configurar el nodo PHPCompute:
Los terminales del nodo PHPCompute están descritos en la siguiente tabla.
Terminal | Tipo | Descripción |
---|---|---|
In (de entrada) | Datos de entrada | El terminal de entrada que acepta un mensaje para que lo procese el nodo. |
Out (de salida) | Datos de salida | El terminal de salida al que se dirige el mensaje transformado. |
Failure (de anomalías) | Datos de salida | El terminal de salida al que se direcciona el mensaje si se detecta una anomalía durante el cálculo. Aunque esté establecida la propiedad Validar, los mensajes que se propagan al terminal de anomalías (Failure) del nodo no se validan. |
* (dinámico) | Salida dinámica | Pueden crearse terminales de salida dinámicos (o no crearse ninguno), para dar soporte al direccionamiento de mensajes. |
Puede definir terminales de salida dinámicos en el nodo PHPCompute. No todos los terminales de salida dinámicos que se crean en un nodo PHPCompute necesitan correlacionarse con una expresión de la tabla de filtros. Si alguno de los terminales de salida dinámicos no está correlacionado, nunca se le propagarán mensajes a él. Se pueden correlacionar varias expresiones al mismo único terminal de salida dinámico. No existe ningún terminal de salida estático al que se pase directamente el mensaje. Para obtener más información sobre cómo utilizar terminales dinámicos, consulte Utilización de terminales dinámicos.
Las tablas siguientes describen las propiedades del nodo. La columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco si tiene que entrar un valor cuando no hay definido ningún valor predeterminado); la columna con la cabecera C indica si la propiedad es configurable (puede cambiar el valor cuando añade el flujo de mensajes al archivo BAR para desplegarlo).
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Nombre de nodo | No | No | PHPCompute | El nombre del nodo. |
Descripción corta | No | No | Descripción breve del nodo. | |
Descripción larga | No | No | Texto que describe el propósito del nodo en el flujo de mensajes. |
Las propiedades Básicas del nodo PHPCompute se describen en la siguiente tabla:
Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Script PHP | Sí | Sí | Serie que contiene el nombre del archivo de script PHP. | ScriptName |
Las propiedades de análisis del nodo PHPCompute se describen en la siguiente tabla.
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Utilizar analizador compacto XMLNSC para dominio XMLNS | No | No | False | Esta propiedad controla si el analizador compacto XMLNSC se utiliza para mensajes en el dominio XMLNS. Si establece esta propiedad, los datos del mensaje aparecerán bajo XMLNSC en los nodos que estén conectados al terminal de salida cuando la cabecera MQRFH2 de entrada o la propiedad Análisis de mensaje de entrada, Dominio de mensajes, es XMLNS. |
En la tabla siguiente se describen las propiedades de validación del nodo PHPCompute.
Para ver la descripción completa de estas propiedades, consulte Propiedades de validación.
Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Validar | No | No | Ninguno | Esta propiedad controla si tiene lugar la validación. Los valores válidos son:
|
validateMaster |
Acción para anomalía | No | 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:
|
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. |