API UDDI - find_business

Descrição

A função find_business procura empresas que correspondam aos critérios especificados.

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

Sintaxe da versão 2.0

<find_business generic = "2.0" [maxRows = "nn"] 
   xmlns = "urn:uddi-org:api_v2">
   [<findQualifiers/>]
   [<name/> [<name/>]...]
   [<discoveryURLs/>]
   [<identifierBag/>]
   [<categoryBag/>]
   [<tModelBag/>]
</find_business>

Argumentos

maxRows - atributo opcional para especificar o número máximo de linhas a serem retornadas; se maxRows for excedido, o atributo truncado do elemento bindingDetail 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 da empresa. UDDI 2.0 permite que você especifique até cinco nomes comerciais.

discoveryURLs - Elemento opcional para pesquisar por URLs de descoberta. Se mais de um discoveryURL for especificado, a pesquisa será realizada por meio de um OU lógico.

identifierBag - Elemento opcional para pesquisar por identificador. Se mais de um identificador for especificado, a pesquisa será realizada por meio de um OU lógico.

categoryBag - Elemento opcional para pesquisar por categoria. Por exemplo, você pode pesquisar por códigos NAICS. Se mais de uma categoria for especificada, a pesquisa é realizada por meio de um AND lógico.

tModelBag - Elemento opcional para pesquisar por registros tModel. 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 sobre o número do 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_unsupported - significa que um dos valores findQualifier transmitidos era inválido. O qualificador inválido será indicado claramente no texto.

E_tooManyOptions - Significa que o limite definido pela implementação no número de argumentos de nome foi excedido.