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 PHPCompute

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.

Finalidad

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:

  • Examinar un mensaje de entrada y, en función del contenido, propagarlo sin modificaciones al terminal de salida del nodo.
  • Cambiar parte de un mensaje de entrada y propagar el mensaje cambiado al terminal de salida utilizando PHP.
  • Crear y construir un nuevo mensaje de salida que sea independiente del mensaje de entrada utilizando PHP.

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:

Icono del nodo PHPCompute

Utilización del nodo PHPCompute en un flujo de mensajes

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.

Especificación PHP

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.

Configuración del nodo PHPCompute

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:

  1. Opcional: En el separador Descripción, entre una descripción corta, una descripción larga, o ambas. En este separador también puede renombrar el nodo.
  2. En el separador Básicas, utilice la propiedad Script PHP para especificar el nombre del archivo PHP. Seleccione la propiedad Invocar método 'evaluate()' en definición de clase PHP si el código en el archivo de script PHP incluye un método de evaluación.
  3. En el separador Opciones de analizador, seleccione la propiedad Utilizar analizador compacto XMLNSC para dominio XMLNS para especificar que se utiliza el analizador compacto XMLNSC para los mensajes en el dominio XMLNS.
  4. En el separador Validación, especifique las propiedades de validación del analizador del nodo. Para obtener más información sobre la validación, consulte Validar mensajes. Para obtener información sobre cómo cumplimentar este separador, consulte Propiedades del separador de validación.

Terminales y propiedades

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

Las propiedades de Descripción del nodo PHPCompute se describen en la siguiente tabla:
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   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:
  • Ninguno
  • Contenido y valor
  • Contenido
  • Heredar
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:
  • Rastreo de usuario
  • Anotaciones de error locales
  • Excepción
  • Lista de excepciones
 
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:59:03


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