API UDDI - find_service
Descrizione
La funzione find_service cerca i servizi associati a un'attività specifica.
La risposta include un elemento serviceList radice e un elemento serviceInfo per ciascuna società corrispondente. Se l'operatore UDDI restituisce solo un elenco parziale di risultati corrispondenti, l'attributo troncato dell'elemento serviceList verrà impostato su true. Se non vengono trovate corrispondenze, viene restituito un elemento serviceList con zero sottoelementi.
Sintassi della versione 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>
argomenti
businessKey : attributo uuid_key obbligatorio che specifica il businessEntity associato.
maxRows : attributo facoltativo per specificare il numero massimo di righe da restituire. Se maxRows viene superato, l'attributo troncato dell'elemento serviceList verrà impostato su true.
findQualifiers : elemento facoltativo per sostituire la funzionalità di ricerca predefinita. Ad esempio, il qualificatore find exactNameMatch corrisponderà ai nomi esatti dell'attività.
nome : il nome completo o parziale del servizio. UDDI 2.0 consente di specificare fino a cinque nomi di servizi.
categoryBag - Elemento opzionale per la ricerca per categoria. Se viene specificata più di una categoria, la ricerca viene eseguita tramite un AND logico.
tModelBag : elemento facoltativo da cercare per tModels. Se viene specificato più di un tModel, la ricerca viene eseguita tramite un AND logico.
Errore restituito
Se si verifica un errore durante l'elaborazione di questa chiamata API, un elemento dispositionReport verrà restituito al chiamante all'interno di un errore SOAP. Saranno rilevanti le seguenti informazioni sul numero di errore:
E_invalidKeyPassed : significa che il valore uuid_key passato non corrisponde a nessun valore noto di serviceKey o tModelKey. La struttura dell'errore indicherà quale condizione si è verificata per prima e la chiave non valida verrà indicata chiaramente nel testo.
E_tooManyOptions : sono state specificate troppe opzioni di ricerca.
E_unsupported - Il findQualifier specificato non è supportato.