Gestione degli errori nell'assieme

Modifica online

Utilizzare la sezione di cattura dell'assieme per descrivere la gestione degli errori generati durante l'esecuzione dell'assieme.

Informazioni su questa attività

Nota: questa attività fa riferimento alla configurazione di una definizione API OpenAPI 2.0 . Per i dettagli su come configurare una definizione API OpenAPI 3.0 , vedi Modifica di una definizione API OpenAPI 3.0.

Puoi completare questa attività utilizzando l'applicazione IU API Designer o utilizzando l'IU API Manager basata sul browser.

La sezione di cattura dell'assieme viene utilizzata per implementare un assieme nel caso in cui venga generato un errore durante l'esecuzione dell'assieme. Ad esempio, l'assembly potrebbe contenere un throw elemento, l'API potrebbe non riuscire ad autenticarsi oppure una politica potrebbe non essere eseguita correttamente. Ogni errore può essere gestito con un catch differente e ogni catch può gestire più errori di stato.

Procedura

Per creare una cattura e includervi elementi, completare la seguente procedura:
  1. Nel riquadro di navigazione, fare clic su Icona di sviluppo nel quadro di navigazione "Sviluppo ", quindi selezionare la scheda "API".
    Viene aperta la pagina Sviluppa .
  2. Fare clic sul titolo della definizione API a cui si desidera applicare una cattura.
  3. Selezionare la scheda Gateway , quindi fare clic su Politiche nel riquadro di navigazione.
  4. Impostare l'opzione Mostra catture nella barra dei menu del canvas sulla posizione Mostra .
  5. Fai clic Presa sull'area di lavoro oppure Prendere sull'icona, Icona Cattura se visualizzata.
    Si apre il foglio delle proprietà per le catture dell'API.
  6. Per aggiungere un catch predefinito eseguito quando viene generato un errore non rilevato, fare clic su Aggiungi catch predefinito.
    Nota: se si dispone di un catch predefinito prima di un altro catch in precedenza, il catch predefinito verrà attivato anche quando viene generato l'errore dell'altro catch.
  7. Per aggiungere una nuova cattura, fare clic su Aggiungi cattura.
  8. Per specificare a quali errori si applica il catch, utilizzare il campo "Seleziona errori" e selezionare l'errore appropriato.
  9. Facoltativo: per rimuovere un caso di errore da un blocco `catch`, deselezionare la casella di controllo corrispondente dal menu a discesa "Seleziona errori". Per eliminare tutti i casi di errore da un blocco catch, clicca sulla croce corrispondente al numero totale di casi di errore nel campo "Seleziona errori ".
  10. Facoltativo: per modificare l'ordine delle tue catture, usa le icone "Sposta in alto Icona Sposta giù " Icona Sposta su o "Sposta in basso ".
    Se un caso di errore è gestito da più catture, viene applicato il rilevamento all'inizio dell'elenco.
  11. Per aggiungere un elemento a un elemento di aggancio dalla tavolozza, fare clic sull'icona con il segno Segno più all'interno di un cerchio più nella posizione desiderata nel flusso di assemblaggio. Seleziona l'elemento che desideri applicare al catch cliccandoci sopra.
  12. Fare clic su Salva per salvare le modifiche.

Cosa fare successivamente

Se hai aggiunto un blocco catch per ConnectionError, SOAPError o OperationError, devi aggiungere lo stesso errore all'impostazione "Stop on error" della Invoke politica nel tuo assembly. In caso contrario, se l'errore si verifica durante l'esecuzione della Invoke politica, non viene rilevato, l'esecuzione della politica viene portata a termine e il flusso di assemblaggio prosegue. Per ulteriori dettagli sulla configurazione di una Invoke politica, consultare Invoke.

Per ulteriori dettagli su tutti gli errori che possono essere restituiti dall'assembly e che sono disponibili per la funzione catch, consultare la sezione "Casi di errore supportati dai catch dell'assembly ".