API UDDI - save_business
Descrizione
La chiamata API save_business viene utilizzata per salvare o aggiornare le informazioni su un elemento businessEntity completo.
Questa API restituisce un messaggio businessDetail contenente i risultati finali della chiamata che riflette le nuove informazioni registrate per le informazioni businessEntity fornite. Questi risultati includeranno tutti i servizi aziendali contenuti per riferimento. Se la stessa entità determinata dalla chiave di corrispondenza, è elencata più di una volta nel messaggio save_business, può essere elencata una volta nel risultato per ogni comparsa nel messaggio save_business. In tal caso, l'ultima comparsa nei risultati rappresenta lo stato salvato finale.
Sintassi della versione 2.0
<save_business generic = "2.0"
xmlns = "urn:uddi-org:api_v2" >
<authInfo/>
<businessEntity/> [<businessEntity/>.]
</save_business>
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.
businessEntity - È possibile trasmettere uno o più elementi businessEntity completi. Questi elementi possono essere ottenuti in anticipo utilizzando la chiamata API get_businessDetail 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_invalidProjection - Significa che è stato effettuato un tentativo di salvare un businessEntity contenente una proiezione del servizio che non corrisponde al businessService proiettato. La chiave di servizio di almeno uno di questi servizi aziendali verrà inclusa in dispositionReport.
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.