API UDDI - save_service

Descrizione

La chiamata API save_service aggiunge o aggiorna uno o più elementi businessService.

Questa chiamata API restituisce un messaggio serviceDetail contenente i risultati finali della chiamata che riflette le informazioni appena registrate per gli elementi businessService interessati. Nei casi in cui nella richiesta vengono passati più elementi businessService, il risultato conterrà i risultati finali per ogni businessService passato e questi avverranno nello stesso ordine in cui si trovano nella richiesta. Se la stessa entità è elencata più di una volta nel messaggio save_service, può essere elencata una volta nel risultato per ogni comparsa nel messaggio save_service. In tal caso, l'ultima comparsa nei risultati rappresenta lo stato salvato finale.

Sintassi della versione 2.0

<save_service generic = "2.0" 
   xmlns = "urn:uddi-org:api_v2" >
   <authInfo/>
   <businessService/> [<businessService/>.]
</save_service>

argomenti

authInfo : questo argomento obbligatorio è un elemento che contiene un token di autenticazione. I token di autenticazione vengono ottenuti utilizzando la chiamata API get_authToken.

businessService : è possibile passare uno o più elementi businessService completi. Allo scopo di eseguire aggiornamenti di andata e ritorno, questi dati possono essere ottenuti in anticipo utilizzando la chiamata API get_serviceDetail o con qualsiasi altro mezzo.

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_authTokenExpired - Significa che il valore del token di autenticazione passato nell'argomento authInfo non è più valido perché il token è scaduto.

E_authTokenRequired - Significa che il valore del token di autenticazione passato nell'argomento authInfo è mancante o non è valido.

E_invalidKeyPassed - Significa che la richiesta non può essere soddisfatta perché uno o più valori uuid_key specificati non sono un valore chiave valido. Sono inclusi tutti i riferimenti tModelKey, nonché i riferimenti a valori serviceKey o bindingKey che non esistono.

E_userMismatch - Significa che uno o più dei valori uuid_key passati si riferiscono a dati che non sono controllati dall'individuo che è rappresentato dal token di autenticazione. La chiave che ha causato l'errore sarà chiaramente indicata nel testo dell'errore.

E_invalidValue : un valore passato in un attributo keyValue non ha superato la convalida. Ciò si applica a categorizzazioni controllate, identificatori e altri elenchi di codici convalidati. Il testo dell'errore indicherà chiaramente la combinazione di chiave e valore che non ha superato la convalida.

E_requestTimeout - Significa che la richiesta non può essere eseguita perché un servizio validate_values ​​necessario non ha risposto in un ragionevole lasso di tempo. I dettagli che identificano il servizio in errore verranno inclusi nell'elemento dispositionReport.

E_valueNotAllowed : il fornitore della tassonomia ha posto delle restrizioni sui tipi di informazioni che dovrebbero essere incluse in quella posizione all'interno di una tassonomia specifica. Un servizio validate_values ​​scelto dal sito dell'operatore ha rifiutato questo businessEntity per almeno una categoria specificata.

E_accountLimitExceeded : indica che i limiti dell'account utente sono stati superati.