Communication Web Service > Get Links Components

Ir a probar servicio

La operación Obtener los enlaces de los componentes (Get Links Components): está englobada en el Servicio Communication Web Service que da soporte a la gestión de las comunicaciones entre los componentes. Esta operación se emplea con el objetivo de que el servidor nodejs pueda obtener las conexiones para un determinado puerto de un componente de esta manera puede saber con qué otros componentes se comunica y que puertos intervienen.

Este servicio es controlado por el componente TMM (módulo de Gestión de Transacción).El método acepta de entrada una estructura con el Id del usuario que tiene la sesión iniciada, el identificador de instancia del componente a consultar y el puerto en cuestión, estos valores son obligatorio y además no nulo. La operación calcula la tabla de enrutamiento de los componentes y busca la ruta para el componente y puerto proporcionado. Devuelve como respuesta una estructura con una variable que indica si el inicio ha tenido éxito o no, una cadena con los puertos a los que se puede conectar y un mensaje correspondiente a la operación realizada.

getLinksComponents(structure params);

Parámetros de Entrada

params

structure con los parámetros de entrada y el orden a seguir:

string	userId	Id de usuario con una sesión iniciada en el sistema. Parámetro obligatorio no nulo.
string	componentInstance	Instancia del componente. Parámetro obligatorio no nulo.
string	PortId	Puerto del componente. Parámetro obligatorio no nulo.

Valores de Salida

result

structure con los valores de salida:

boolean	gotten	true si tiene éxito la inserción en la B.D. de interacción, false si no.
string	portList	Cadena con lista concatenada de puertos que conectan con el puerto consultado.
string	message	Mensaje de éxito o de error y su tipo.

Ejemplo Petición XML


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.cos.acg.ual.es/">

   <soapenv:Header/>

   <soapenv:Body>

	  <ws:getLinksComponents>

		 <params>

			<userId> "ejemplo de Id" </userID>

			<componentInstance> "ejemplo de identificador de componente" </componentInstance>

			<portId> "ejemplo de puerto" </portId>

			</params>

	  </ws:getLinksComponents>

   </soapenv:Body>

</soapenv:Envelope>

Ejemplo Respuesta XML


<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

   <soap:Body>

	  <ns2:getLinksComponentsResponse xmlns:ns2="http://ws.cos.acg.ual.es/">

		 <result>

			<gotten> "ejemplo true o false" </gotten>

			<portList> "ejemplo lista de puertos" </portList>

			<message> "ejemplo mensaje de exito o de error" </message>

		 </result>

	  </ns2:getLinksComponentsResponse>

   </soap:Body>

</soap:Envelope>

Mensajes de Error
Not found o Empty userId Error	Se produce cuando se omite este parámetro en la llamada al servicio o no se proporciona un valor.
Not found o Empty Component Instance Error	Se produce cuando se omite este parámetro en la llamada al servicio o no se proporciona un valor.
Not found o Empty Port Error	Se produce cuando se omite este parámetro en la llamada al servicio o no se proporciona un valor. También cuando el puerto consultado no existe en la base de datos.
PSQLException	Se producen por problemas en la conexión a la base de datos.
Error in Architectural Models DB	Se producen por problemas en la consulta a la base de datos de modelos de arquitectura.
Internal Server Error	Se producen por fallos en el servidor al buscar alguna clase necesaria para la ejecución.

Example Error Response XML


<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

   <soap:Body>

      <ns2:getLinksComponentsResponse xmlns:ns2="http://ws.cos.acg.ual.es/">

         <result>

		 	<gotten>  false </gotten>

			<portList> "No connected ports" </portList>

			<message> > Not found o Empty Port Error </message>

         </result>

      </ns2:getLinksComponentsResponse>

   </soap:Body>

</soap:Envelope>

Probar el Servicio
Rellene Parámetros de Entrada: ID de usuario: Instancia de componente: ID de puerto:		Respuesta de Salida obtenida: Obtenido: Lista de puertos: Mensaje:

WS Publicos

Session Web Service

Interaction Web Service

Component Web Service