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 EndpointLookup

Utilice el nodo EndpointLookup para recuperar la información de punto final de servicio que se conserva 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. En función de la configuración del nodo, también se puede establecer el destino URL de servicio web que utilizan los nodos de solicitud SOAP y HTTP. El mensaje de entrada no se modificará.

Finalidad

El nodo EndpointLookup recupera la información de punto final de servicio relacionada con un servicio WSRR descrito por WSDL. Una definición de WSDL define un servicio en cuanto a una interfaz (a la que se hace relación como portType) que está disponible en un puerto especificado. El puerto WSDL define la información de punto final necesaria para acceder al servicio. Los puntos finales se recuperan según los criterios de búsqueda definidos por las propiedades del nodo, opcionalmente complementadas o alteradas por definiciones de entorno local en el tiempo de ejecución. Consulte Alteraciones temporales de LocalEnvironment 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. Además, el nodo EndpointLookup puede definir automáticamente el URL de destino que debe utilizar un nodo SOAPRequest, SOAPAsyncRequest o HTTPRequest posterior, en función del valor de la propiedad Política de coincidencia, consulte Proceso de nodo EndpointLookup. Esta acción se lleva a cabo a través del nodo, estableciendo las alteraciones temporales de entorno local que utilizan esos nodos.

Proceso de nodo EndpointLookup

El nodo EndpointLookup 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 EndpointLookup
Cuando el nodo EndpointLookup recibe un mensaje, se llevan a cabo los pasos siguientes en secuencia.
  1. El nodo EndpointLookup recupera los datos de servicio de WSRR utilizando los criterios de búsqueda especificados.
  2. Si se encuentra una coincidencia, o varias, el nodo EndpointLookup añade una representación de esos puntos finales 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. Es posible que se devuelva una entidad diferente cada vez que se emite la consulta. Además, el valor de punto final recuperado se ha establecido como alteración temporal de entorno local para el URL de destino que utilizan los nodos SOAPRequest, SOAPAsyncRequest o HTTPRequest. 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.
    • 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 URL de destino que utilizan los nodos SOAPRequest, SOAPAsyncRequest o HTTPRequest no se ha establecido. En su lugar, deberá añadir un nodo Compute al flujo de mensajes para seleccionar la dirección necesaria y configurar los valores de entorno local que necesitan esos nodos de solicitud.

    El mensaje de entrada se propaga sin modificaciones al terminal de salida (Out). 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. Consulte Salida del nodo EndpointLookup para obtener los detalles del árbol de salida de entorno local.

  3. Si no se encuentra ninguna coincidencia, el nodo EndpointLookup 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 EndpointLookup propaga el mensaje de entrada sin modificaciones al terminal de anomalías. La ExceptionList se rellena con los detalles del error.

Ejemplo

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.

Alteraciones temporales de LocalEnvironment

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

Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No El tipo de nodo: EndpointLookup El nombre del nodo.
Descripción corta No No Ninguno Una descripción breve 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 EndpointLookup se describen en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Nombre de tipo de puerto No Ninguno Tuple de nombre que identifica exclusivamente un tipo de puerto de servicio WebSphere Service Registry and Repository definido por WSRR. Al menos es necesaria una de las propiedades. Si deja tres valores de propiedad en blanco, aparecerá un mensaje de error cuando intente guardarlo. name
Espacio de nombres de tipo de puerto No Ninguno namespace
Versión de tipo de puerto No Ninguno portVersion
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. Especifique 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 adicional presente en WSRR.

Estas propiedades Propiedades del usuario y Clasificación se utilizan en la consulta solamente para identificar el puerto de servicio WSDL.

 
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.

Estas propiedades Propiedades del usuario y Clasificación se utilizan en la consulta solamente para identificar el puerto de servicio WSDL.

 
Política de coincidencia No Una WSRR puede contener varias entidades que coincidan con los criterios de búsqueda especificados 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 EndpointLookup.

Si solicita una entidad con una sola coincidencia estableciendo Política de coincidencia en Una, el valor de punto final recuperado se ha establecido como alteración temporal de entorno local para el URL de destino que utilizan los nodos SOAPRequest, SOAPAsyncRequest o HTTPRequest.

 
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 | ac55830_