Criterio AssertCondition

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

icona delle norme

Panoramica

Il criterio AssertCondition valuta un'istruzione condizionale in fase di runtime nei flussi di richiesta o risposta. Puoi definire una condizione in base alle variabili di flusso e utilizzare questo criterio per rivendicare la condizione. Una condizione restituisce sempre un valore booleano, vero o falso. Per ulteriori informazioni sulla scrittura di un'affermazione condizionale, consulta la sezione Riferimento alle condizioni.

Dopo aver valutato la condizione, il criterio AssertCondition archivia il risultato della valutazione nella variabile di flusso assertcondition.policy-name.truthValue. Puoi utilizzare la variabile di flusso risultante nei callout successivi o nella logica orchestrata. Se una condizione ha valore true, il valore della variabile viene impostato su true, altrimenti su false. Se hai definito più criteri AssertCondition, policy-name nel nome della variabile ti consente di identificare in modo univoco la variabile.

Questo è un criterio standard e può essere implementato in qualsiasi tipo di ambiente. Non tutti gli utenti devono conoscere i tipi di criteri e di ambiente. Per informazioni sui tipi di criteri e sulla disponibilità con ogni tipo di ambiente, consulta Tipi di criteri.

<AssertCondition>

Definisce un criterio <AssertCondition>. Utilizzando questo criterio, puoi valutare un'istruzione condizionale con una o più condizioni associate da un operatore logico. Per informazioni su tutti gli operatori supportati in una condizione, consulta la sezione Operatori.

Il risultato di un'istruzione condizionale è un valore booleano che può essere true o false.
Valore predefinito N/A
Obbligatorio? Obbligatorio
Tipo Tipo complesso
Elemento principale N/A
Elementi secondari <Condition>
<DisplayName>

La tabella seguente fornisce una descrizione generale degli elementi secondari di <AssertCondition>:

Elemento secondario Obbligatorio? Descrizione
<Condition> Sì Specifica la condizione da valutare.
<DisplayName> Facoltativo Un nome personalizzato per il criterio.

L'elemento <AssertCondition> utilizza la seguente sintassi:

Sintassi

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssertCondition">
    <!-- Display name for this policy -->
    <DisplayName>DISPLAY_NAME</DisplayName>
    <!-- Assertion's condition where operators are defined -->
    <Condition>CONDITIONAL_STATEMENT</Condition>
</AssertCondition>

Esempio

L'esempio seguente verifica se la variabile google.dialogflow.my-prefix.claimAmount è maggiore di 0 e minore di 1000.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssertCondition continueOnError="false" enabled="true"
        name="MyAssertCondition">
    <DisplayName>Assert My Condition</DisplayName>
    <Condition>(google.dialogflow.my-prefix.claimAmount > 0)
                and
               (google.dialogflow.my-prefix.claimAmount LesserThan 1000)</Condition>
</AssertCondition>

In questo esempio:

  • Se il valore della variabile google.dialogflow.my-prefix.claimAmount è 500, la condizione restituisce true e, di conseguenza, la variabile assertcondition.MyAssertCondition.truthValue viene impostata su true.
  • Tuttavia, se il valore della variabile google.dialogflow.my-prefix.claimAmount è 1200, la variabile assertcondition.MyAssertCondition.truthValue è impostata su false.

Questo elemento ha i seguenti attributi comuni a tutti i criteri:

Attributo Predefinito Obbligatorio? Descrizione
name N/A Obbligatorio

Il nome interno del criterio. Il valore dell'attributo name può contenere lettere, numeri, spazi, trattini, trattini bassi e punti. Questo valore non può superare i 255 caratteri.

Facoltativamente, utilizza l'elemento <DisplayName> per etichettare il criterio nell'editor proxy dell'interfaccia utente di gestione con un nome diverso in linguaggio naturale.
continueOnError falso Facoltativo Imposta su false per restituire un errore in caso di errore del criterio. Questo è un comportamento previsto per la maggior parte dei criteri. Imposta su true per continuare l'esecuzione del flusso anche dopo un errore nel criterio. Vedi anche:
enabled true Facoltativo Imposta su true per applicare il criterio. Imposta su false per disattivare il criterio. Il criterio non verrà applicato anche se rimane collegato a un flusso.
async   falso Deprecato Questo attributo è stato ritirato.

Riferimento elemento secondario

In questa sezione vengono descritti gli elementi secondari di <AssertCondition>.

<Condition>

Specifica la condizione da valutare. Per maggiori informazioni sulla scrittura di un'istruzione condizionale in Apigee, consulta la pagina Riferimento alle condizioni.

Valore predefinito N/A
Obbligatorio? Obbligatorio
Tipo Stringa
Elemento principale <AssertCondition>
Elementi secondari Nessun valore

<DisplayName>

Utilizzalo in aggiunta all'attributo name per etichettare il criterio nell'editor proxy dell'interfaccia utente di gestione con un nome diverso e più naturale.

L'elemento <DisplayName> è comune a tutti i criteri.

Valore predefinito N/A
Obbligatorio? Facoltativo. Se ometti <DisplayName>, viene utilizzato il valore dell'attributo name del criterio.
Tipo Stringa
Elemento principale <PolicyElement>
Elementi secondari Nessuna esperienza

La sintassi dell'elemento <DisplayName> è la seguente:

Sintassi

<PolicyElement>
  <DisplayName>POLICY_DISPLAY_NAME</DisplayName>
  ...
</PolicyElement>

Esempio

<PolicyElement>
  <DisplayName>My Validation Policy</DisplayName>
</PolicyElement>

L'elemento <DisplayName> non ha attributi o elementi secondari.

Codici di errore

Questa sezione descrive i codici e i messaggi di errore che vengono restituiti e le variabili di errore impostate da Apigee quando questo criterio attiva un errore. Queste informazioni sono importanti per sapere se si stanno sviluppando regole di errore per gestire gli errori. Per scoprire di più, consulta gli articoli Cosa devi sapere sugli errori relativi alle norme e Gestione degli errori.

Errori di runtime

Questi errori possono verificarsi quando il criterio viene eseguito.

Codice di errore Stato HTTP Causa
steps.assertcondition.ConditionEvaluationFailed 500 Impossibile valutare l'istruzione condizionale. Questo errore può essere causato da molte ragioni, tra cui valori errati nelle variabili al momento dell'esecuzione.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Nome errore Causa
InvalidCondition Il criterio non è stato in grado di convalidare l'istruzione condizionale. I motivi possono essere diversi, tra cui condizioni non corrette o l'utilizzo di operatori non supportati.

Variabili di errore

Ogni volta che si verificano errori di esecuzione in un criterio, Apigee genera messaggi di errore. Puoi visualizzare questi messaggi di errore nella risposta di errore. Molte volte, i messaggi di errore generati dal sistema potrebbero non essere pertinenti nel contesto del prodotto. Per rendere i messaggi più significativi, potresti voler personalizzare i messaggi in base al tipo.

Per personalizzare i messaggi di errore, puoi utilizzare regole di errore o il criterio AlzaFault. Per informazioni sulle differenze tra le regole di errore e il criterio AlzaFault, consulta Confronto tra le regole di errore e il criterio AlzaFault. Devi verificare le condizioni utilizzando l'elemento Condition sia nelle regole di errore sia nel criterio AlzaFault. Apigee fornisce variabili di errore univoche per ciascun criterio e i relativi valori vengono impostati quando un criterio attiva gli errori di runtime. Utilizzando queste variabili, puoi verificare le condizioni di errore specifiche e intraprendere le azioni appropriate. Per saperne di più sul controllo delle condizioni di errore, consulta Condizioni degli edifici.

La tabella seguente descrive le variabili di errore specifiche di questo criterio.

Variabili Dove Esempio
fault.name="FAULT_NAME" FAULT_NAME è il nome dell'errore, come elencato nella tabella Errori di runtime. Il nome del guasto è l'ultima parte del codice di errore. fault.name Matches "ConditionEvaluationFailed"
AssertCondition.POLICY_NAME.failed POLICY_NAME è il nome specificato dall'utente del criterio che ha generato l'errore. AssertCondition.My-AssertCondition.failed = true
Per ulteriori informazioni sugli errori dei criteri, consulta la sezione Cosa devi sapere sugli errori dei criteri.