API UDDI - find_service
Descripción
La función find_service busca servicios asociados con un negocio específico.
La respuesta incluye un elemento serviceList raíz y un elemento serviceInfo para cada empresa coincidente. Si el operador UDDI devuelve solo una lista parcial de resultados coincidentes, el atributo truncado del elemento serviceList se establecerá en verdadero. Si no se encuentran coincidencias, se devuelve un elemento serviceList con cero subelementos.
Sintaxis de la versión 2.0
<find_service businessKey = "uuid_key" generic = "2.0" [maxRows = "nn"]
xmlns = "urn:uddi-org:api_v2">
[<findQualifiers/>]
[<name/> [<name/>]...]
[<categoryBag/>]
[<tModelBag/>]
</find_service>
Argumentos
businessKey : atributo uuid_key obligatorio que especifica la businessEntity asociada.
maxRows : atributo opcional para especificar el número máximo de filas que se devolverán. Si se excede maxRows, el atributo truncado del elemento serviceList se establecerá en verdadero.
findQualifiers : elemento opcional para anular la funcionalidad de búsqueda predeterminada. Por ejemplo, el calificador de búsqueda exactNameMatch coincidirá con nombres comerciales exactos.
nombre : el nombre completo o parcial del servicio. UDDI 2.0 le permite especificar hasta cinco nombres de servicios.
categoryBag : elemento opcional para buscar por categoría. Si se especifica más de una categoría, la búsqueda se realiza mediante un AND lógico.
tModelBag : elemento opcional para buscar por tModels. Si se especifica más de un tModel, la búsqueda se realiza mediante un AND lógico.
Error devuelto
Si se produce algún error al procesar esta llamada a la API, se devolverá un elemento dispositionReport a la persona que llama dentro de una falla SOAP. La siguiente información del número de error será relevante:
E_invalidKeyPassed : significa que el valor de uuid_key pasado no coincide con ningún valor de serviceKey o tModelKey conocido. La estructura del error indicará qué condición ocurrió primero y la clave no válida se indicará claramente en el texto.
E_tooManyOptions : se especificaron demasiadas opciones de búsqueda.
E_unsupported : el findQualifier especificado no es compatible.