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 RegistryLookup

Utilice el nodo RegistryLookup para recuperar cualquier tipo de entidad almacenado en WebSphere Service Registry and Repository (WSRR). Las entidades que coincidan con los criterios de búsqueda especificados se almacenarán en el entorno local. El mensaje de entrada no se modificará.

Finalidad

El nodo RegistryLookup recupera cualquier tipo de entrada conservada en WSRR.

Los datos se recuperan según los criterios de búsqueda definidos por las propiedades del nodo, posiblemente complementadas o alteradas por definiciones del entorno local en el tiempo de ejecución; consulte Alteraciones temporales del entorno local para obtener más detalles.

Los datos recuperados se colocan en el árbol del entorno local, dejándolo disponible para los nodos posteriores. El mensaje de entrada que recibe el nodo se propaga al terminal de salida sin modificar.

Proceso de nodo RegistryLookup

El nodo RegistryLookup se encuentra en el cajón Servicios web de la paleta de nodos del flujo de mensajes y se representa en el WebSphere Message Broker Toolkit mediante el icono siguiente:

Icono de nodo RegistryLookup
Cuando el nodo RegistryLookup recibe un mensaje, se llevan a cabo los pasos siguientes en secuencia.
  1. El nodo RegistryLookup recupera los datos de WSRR utilizando los criterios de búsqueda especificados.
  2. Si se encuentra una coincidencia, o varias, el nodo RegistryLookup añade una representación de esas entidades en el árbol de entorno local.
    • Si se ha establecido Política de coincidencia en Una, WSRR devuelve una sola entidad y se añade al árbol de entorno local. Si el registro contiene más de una entidad que coincida con los criterios de búsqueda especificado, no será posible determinar cuál es la que devuelve WSRR. Es posible que se devuelva una diferente cada vez que se emite la consulta.
    • Si se ha establecido Política de coincidencia en Todas, todas las entidades coincidentes se añadirán al árbol de entorno local. El orden de las entidades viene determinado por WSRR y puede variar entre consultas.

    El mensaje de entrada se propaga sin modificaciones al terminal de salida. El árbol de entorno local se propaga al terminal de salida, donde está disponible para su proceso adicional por parte de los nodos de transformación. La representación exacta de una entidad en el árbol de entorno local depende de la propiedad Política de profundidad. Consulte Salida del nodo RegistryLookup para obtener los detalles del árbol de salida de entorno local.

    Añada un Compute a un flujo de mensajes para interpretar y actuar sobre los datos devueltos. Por ejemplo, si el árbol de entorno local contiene diversas direcciones de punto final para que las utilicen posteriores nodos de solicitud, el nodo Compute debería seleccionar la dirección necesaria y configurar las cabeceras de transporte o los valores de entorno local necesarios para los nodos de solicitud.

  3. Si no se encuentra ninguna coincidencia, el nodo RegistryLookup propaga el mensaje de entrada al terminal NoMatch.
  4. Si se produce un error de proceso, por ejemplo si el servidor de WSRR que se ha configurado en el objeto de servicio configurado DefaultWSRR no se puede conectar, o si se agota el tiempo de conexión, el nodo RegistryLookup propaga el mensaje de entrada sin modificaciones al terminal de anomalías. La ExceptionList se rellena con los detalles del error.

Alteraciones temporales del entorno local

Puede alterar temporalmente las propiedades del nodo RegistryLookup utilizando los valores de entorno local. Consulte el apartado Definición dinámica de los criterios de búsqueda.

Terminales y propiedades

Cuando haya colocado una instancia del nodo RegistryLookup en un flujo de mensajes, podrá configurarlo; consulte el apartado Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades.

Los terminales del nodo RegistryLookup están descritos en la siguiente tabla.

Terminal Descripción
In (de entrada) El terminal de entrada que acepta un mensaje para que lo procese el nodo.
Failure (de anomalías) El terminal de salida al cual se direcciona el mensaje si se produce un error en el proceso del nodo.
Out (de salida) El terminal de salida al cual se envía el mensaje de entrada y sin modificaciones y el entorno local actualizado que contiene los datos de registro coincidentes.
NoMatch (de no coincidencias) El terminal al cual se envía el mensaje de entrada si no se encuentra ninguna entidad coincidente en base a los criterios de búsqueda especificados.

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 RegistryLookup están descritas en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No El tipo de nodo (RegistryLookup) El nombre del nodo
Descripción corta No No Ninguno Descripción corta del nodo
Descripción larga No No Ninguno Texto que describe el propósito del nodo en el flujo de mensajes

Las propiedades básicas del nodo RegistryLookup se describen en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Nombre No Ninguno Escriba los valores de serie para una o más de las propiedades Nombre, Espacio de nombre y Versión para las entidades o artefactos que desee recuperar de WSRR.

Al menos es necesaria una de las propiedades. Si deja los tres valores de propiedad en blanco, obtendrá un mensaje de error al intentar guardarlo.

name
Espacio de nombres No Ninguno namespace
Versión No Ninguno serviceVersion
Propiedades del usuario No No Ninguno Permite especificar en una consulta propiedades definidas por el usuario. Añada las Propiedades de usuario pulsando Añadir. Las Propiedades de usuario hacen referencia a las Propiedades adicionales que se utilizan para catalogar las entidades en WSRR. Escriba valores para Nombre de propiedad, que es la coincidencia sensible a mayúsculas y minúsculas de la propiedad adicional en WSRR, Tipo de propiedad y Valor de propiedad. El Tipo de propiedad puede ser:
  • una Serie (String, el valor predeterminado), en cuyo caso el Valor de propiedad es una serie de caracteres que deben coincidir con el valor de propiedad adicional presente en WSRR
  • XPATH, o ESQL, en cuyo caso el Valor de propiedad es una expresión XPath o ESQL que localiza un campo del árbol de mensajes que contiene la serie de caracteres que debe coincidir con el valor de propiedad presente en WSRR.
 
Clasificación No No Ninguno

La propiedad del sistema de clasificación Web Ontology Language (OWL). Cada clasificador es una clase en OWL y tiene un URI (Uniform Resource Identifier). Si utiliza las clasificaciones en el registro facilitará la búsqueda de objetos y también podrá añadir significado a los objetos personalizados que son exclusivos para un sistema particular.

Añada una Clasificación pulsando en Añadir y escribiendo el URI de OWL completo para la clasificación del OWL. Por ejemplo, puede definir un estado de ciclo vital de un punto final de servicio en particular.

 
Política de coincidencia No Una WSRR puede contener diversas entidades que coincidan con el criterio de búsqueda especificado en las propiedades anteriores. Si se ha establecido Política de coincidencia en Una, se devolverá al menos una entidad coincidente. Si se ha establecido Política de coincidencia en Todas, se devolverán todas las entidades coincidentes. Consulte el apartado Salida del nodo RegistryLookup  

Las propiedades Avanzadas del nodo RegistryLookup están descritas en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción
Política de profundidad No Devolver sólo coincidentes (Profundidad = 0)

Especifique la profundidad de la consulta WSRR y el contenido de los datos de entidad que se han de devolver. Las entidades devueltas se almacenan en el árbol de mensajes ServiceRegistry en el entorno local (LocalEnvironment).

Seleccione Devolver sólo coincidentes (Profundidad = 0) para utilizar una profundidad de consulta WSRR de 0 y devolver solamente las entidades coincidentes.

Seleccione Devolver sólo coincidentes, mostrando relaciones inmediatas (sólo para compatibilidad) para utilizar una profundidad de consulta WSRR de 1 y devolver solamente las entidades coincidentes. Las entidades devueltas incluyen elementos que listan los bsrURI de las entidades hijo relacionadas. Esta opción proporciona compatibilidad con las versiones de WebSphere Message Broker anteriores a la versión 6.1.0.4, utilizando el formato de salida que se utilizaba en esas versiones anteriores. Esta opción está en desuso, utilice una de las otras opciones.

Seleccione Devolver coincidentes y entidades relacionadas inmediatamente (Profundidad = 1) para utilizar una profundidad de consulta WSRR de 1 y devolver las entidades coincidentes y las entidades hijo relacionadas inmediatamente.

Seleccione Devolver coincidentes y todas las entidades relacionadas (Profundidad = -1) para utilizar una profundidad de consulta WSRR de -1 y devolver las entidades coincidentes y todas las entidades hijo relacionadas.

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:46


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