API UDDI - find_service

Descrição

A função find_service pesquisa serviços associados a um determinado negócio.

A resposta inclui um elemento raiz serviceList e um elemento serviceInfo para cada empresa correspondente. Se o operador UDDI retornar apenas uma lista parcial de resultados correspondentes, o atributo truncado do elemento serviceList será definido como verdadeiro. Se nenhuma correspondência for encontrada, um elemento serviceList com zero subelementos é retornado.

Sintaxe da versão 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 obrigatório especificando o businessEntity associado.

maxRows - atributo opcional para especificar o número máximo de linhas a serem retornadas. Se maxRows for excedido, o atributo truncado do elemento serviceList será definido como verdadeiro.

findQualifiers - elemento opcional para substituir a funcionalidade de pesquisa padrão. Por exemplo, o qualificador find exactNameMatch corresponderá aos nomes comerciais exatos.

nome - o nome completo ou parcial do serviço. UDDI 2.0 permite que você especifique até cinco nomes de serviço.

categoryBag - Elemento opcional para pesquisar por categoria. Se mais de uma categoria for especificada, a pesquisa é realizada por meio de um AND lógico.

tModelBag - elemento opcional para pesquisar por tModels. Se mais de um tModel for especificado, a pesquisa será realizada por meio de um AND lógico.

Erro Retornado

Se ocorrer algum erro no processamento desta chamada de API, um elemento dispositionReport será retornado ao chamador dentro de uma falha SOAP. As seguintes informações de número de erro serão relevantes -

E_invalidKeyPassed - Significa que o valor uuid_key passado não correspondeu a nenhum valor conhecido de serviceKey ou tModelKey. A estrutura do erro indicará qual condição ocorreu primeiro e a chave inválida será indicada claramente no texto.

E_tooManyOptions - Muitas opções de pesquisa foram especificadas.

E_unsupported - O findQualifier especificado não é compatível.