Criterio AssertCondition

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Panoramica

Il criterio AssertCondition valuta un'istruzione condizionale in fase di esecuzione nei flussi di richiesta o risposta. Puoi definire una condizione in base alle variabili del flusso e utilizzare questo criterio per affermarla. Una condizione restituisce sempre un valore booleano, true o false. Per ulteriori informazioni sulla scrittura di un'istruzione condizionale, consulta la Guida di riferimento alle condizioni.

Dopo aver valutato la condizione, il criterio AssertCondition memorizza 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 restituisce true, il valore della variabile viene impostato su true, false in caso contrario. Se hai definito più criteri AssertCondition, il carattere policy-name nel nome della variabile ti aiuta a identificarla in modo univoco.

Questo criterio è un criterio standard e può essere implementato in qualsiasi tipo di ambiente. Per informazioni sui tipi di criteri e sulla loro disponibilità in base a ciascun 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 unite da un operatore logico. Per informazioni su tutti gli operatori supportati in una condizione, consulta Operatori.

Il risultato di un'istruzione condizionale è un valore booleano che può essere true o false.

Valore predefinito	N/D
Obbligatorio?	Obbligatorio
Tipo	Tipo complesso
Elemento principale	N/D
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.

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

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

Il seguente esempio 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 quindi 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 viene impostata su false.

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

Attributo	Predefinito	Obbligatorio?	Descrizione
name	N/D	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. Se vuoi, 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 quando un criterio non va a buon fine. Questo è un comportamento previsto per la maggior parte dei criteri. Imposta su true per continuare l'esecuzione del flusso anche dopo un fallimento del criterio. Vedi anche: Le regole di errore vengono attivate SOLO in uno stato di errore (informazioni su continueOnError) Gestione degli errori all'interno del flusso corrente
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	Ritirato	Questo attributo è stato ritirato.

Riferimento all'elemento secondario

Questa sezione descrive gli elementi secondari di <AssertCondition>.

<Condition>

Specifica la condizione da valutare. Per ulteriori informazioni su come scrivere un'istruzione condizionale in Apigee, consulta la Guida di riferimento alle condizioni.

Valore predefinito	N/D
Obbligatorio?	Obbligatorio
Tipo	Stringa
Elemento principale	<AssertCondition>
Elementi secondari	Nessuno

<DisplayName>

Da utilizzare insieme 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/D
Obbligatorio?	Facoltativo. Se ometti <DisplayName>, viene utilizzato il valore dell'attributo name del criterio.
Tipo	Stringa
Elemento principale	<PolicyElement>
Elementi secondari	Nessuno

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 di errore e i messaggi di errore restituiti e le variabili di errore impostate da Apigee quando questo criterio attiva un errore. Queste informazioni sono importanti se stai sviluppando regole di errore per gestire gli errori. Per scoprire di più, consulta Informazioni importanti sugli errori relativi alle norme e Gestione degli errori.

Errori di runtime

Questi errori possono verificarsi durante l'esecuzione del criterio.

Codice guasto	Stato HTTP	Causa
steps.assertcondition.ConditionEvaluationFailed	500	Impossibile valutare l'istruzione condizionale. Esistono molti motivi per cui si verifica questo errore, tra cui valori errati nelle variabili in fase di esecuzione.

Errori di deployment

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

Nome dell'errore	Causa
InvalidCondition	Il criterio non è stato in grado di convalidare l'istruzione condizionale. Questo errore può essere causato da molti motivi, tra cui condizioni con formato non corretto o 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. Spesso i messaggi di errore generati dal sistema potrebbero non essere pertinenti nel contesto del tuo prodotto. Ti consigliamo di personalizzare i messaggi di errore in base al tipo di errore per renderli più significativi.

Per personalizzare i messaggi di errore, puoi utilizzare le regole di errore o il criterio RaiseFault. Per informazioni sulle differenze tra le regole di errore e il criterio RaiseFault, consulta Regole di errore e criterio RaiseFault. Devi verificare la presenza di condizioni utilizzando l'elemento Condition sia nelle regole di errore sia nel criterio RaiseFault. Apigee fornisce variabili di errore univoche per ogni criterio e i valori delle variabili di errore vengono impostati quando un criterio attiva errori di runtime. Utilizzando queste variabili, puoi verificare la presenza di condizioni di errore specifiche e intraprendere le azioni appropriate. Per ulteriori informazioni su come controllare le condizioni di errore, consulta Condizioni di compilazione.

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

Variabili	Dove	Esempio
fault.name="FAULT_NAME"	FAULT_NAME è il nome dell'errore, come indicato nella tabella Errori di runtime. Il nome dell'errore è l'ultima parte del codice dell'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 relativi alle norme, consulta Informazioni importanti sugli errori relativi alle norme.