Risoluzione dei problemi di errore di runtime di Assegna messaggio

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X.
info

UnresolvedVariable

Codice di errore

steps.assignmessage.UnresolvedVariable

Corpo della risposta di errore

{
    "fault": {
        "faultstring": "AssignMessage[policy_name]: unable to resolve variable [variable_name]",
        "detail": {
            "errorcode": "steps.assignmessage.UnresolvedVariable"
        }
    }
}

Causa

Questo errore si verifica se una variabile specificata nel criterio Assegna messaggio è:

  • fuori ambito (non disponibile nel flusso specifico in cui viene eseguito il criterio) o
  • non può essere risolto (non è definito)

Ad esempio, questo errore si verifica se il criterio Assegna messaggio viene eseguito nel flusso di richiesta, ma l'attributo source nell'elemento <Copy> è impostato sulla variabile response o error o su qualsiasi altra variabile personalizzata che non esiste nel flusso di richiesta.

Diagnosi

  1. Identifica la policy Assegna messaggio in cui si è verificato l'errore e il nome della variabile non disponibile. Puoi trovare entrambi questi elementi nell'elemento faultstring della risposta di errore.

    Ad esempio, nel seguente faultstring, il nome della policy è googleBook e la variabile è var:

    "faultstring": "AssignMessage[googleBook]: unable to resolve variable var"
    
  2. Nel file XML della policy di assegnazione del messaggio non riuscita, verifica che il nome della variabile utilizzata corrisponda al nome della variabile identificato nella stringa di errore (passaggio 1 sopra). Ad esempio, la seguente policy imposta l'attributo source nell'elemento <Copy> su una variabile denominata var, che corrisponde a quanto presente in faultstring:

    <AssignMessage async="false" continueOnError="false" enabled="true" name="Assign-Message-1">
       <DisplayName>googleBook</DisplayName>
       <Properties />
       <Copy source="var">
          <Headers>
             <Header name="user-agent" />
          </Headers>
       </Copy>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <AssignTo createNew="true" transport="http" type="request">googleBookReq</AssignTo>
    </AssignMessage>
    
  3. Determina se la variabile è definita e disponibile nel flusso in cui viene eseguita la policy Assegna messaggio.

  4. Se la variabile è:

    1. fuori ambito (non disponibile nel flusso specifico in cui viene eseguito il criterio) o
    2. non può essere risolto (non è definito)

    allora è questa la causa dell'errore.

    Ad esempio, supponiamo che il criterio Assegna messaggio mostrato sopra venga eseguito nel flusso di richiesta. Controlla se la variabile var è definita in una delle policy eseguite prima della policy Assign Message nel flusso di richiesta. Se la variabile non è stata definita, riceverai il codice di errore:

    steps.assignmessage.UnresolvedVariable
    

Risoluzione

Assicurati che la variabile a cui viene fatto riferimento nella policy esista e sia disponibile nel flusso specifico in cui viene eseguita la policy Assegna messaggio.

Per correggere la policy di esempio mostrata sopra, puoi modificare l'attributo di origine nell'elemento <Copy> in modo che sia la variabile di richiesta o qualsiasi altra variabile personalizzata di tipo messaggio esistente nel flusso di richiesta.

<AssignMessage async="false" continueOnError="false" enabled="true" name="Assign-Message-1">
   <DisplayName>googleBook</DisplayName>
   <Properties />
   <Copy source="request">
      <Headers>
         <Header name="user-agent" />
      </Headers>
   </Copy>
   <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
   <AssignTo createNew="true" transport="http" type="request">googleBookReq</AssignTo>
</AssignMessage>

VariableOfNonMsgType

Codice di errore

steps.assignmessage.VariableOfNonMsgType

Corpo della risposta di errore

{
    "fault": {
        "faultstring": "AssignMessage[policy_name]: value of variable [variable] is not of type Message",
        "detail": {
            "errorcode": "steps.assignmessage.VariableOfNonMsgType"
        }
    }
}

Causa

Questo errore si verifica se l'attributo source nell'elemento <Copy> è impostato su una variabile di tipo diverso da message.

Le variabili di tipo di messaggio rappresentano intere richieste e risposte HTTP. Le variabili di flusso Edge integrate request, response e message sono di tipo messaggio. Per scoprire di più sulle variabili dei messaggi, consulta la Guida di riferimento alle variabili.

Diagnosi

  1. Identifica la policy di assegnazione dei messaggi in cui si è verificato l'errore e il nome della variabile il cui tipo non è corretto. Puoi trovare entrambi questi elementi nell'elemento faultstring della risposta di errore. Ad esempio, nel seguente faultstring, il nome della policy è GenerateGeocodingRequest e la variabile è PostalCode:

    "faultstring": "AssignMessage[GenerateGeocodingRequest]: value of variable PostalCode is not of type Message"
    
  2. Nel file XML della policy di assegnazione dei messaggi non riuscita, verifica che il nome della variabile impostata nell'elemento <Copy> corrisponda al nome della variabile identificato nella stringa di errore (passaggio 1 sopra). Ad esempio, la seguente policy imposta un attributo di origine su una variabile denominata PostalCode, che corrisponde a ciò che è presente in faultstring:

    <AssignMessage name="GenerateGeocodingRequest">
       <AssignTo createNew="true" type="request">GeocodingRequest</AssignTo>
       <AssignVariable>
          <Name>PostalCode</Name>
          <Ref>request.queryparam.postalcode</Ref>
       </AssignVariable>
       <AssignVariable>
          <Name>Country</Name>
          <Ref>request.queryparam.country</Ref>
       </AssignVariable>
       <Copy source="PostalCode">
          <QueryParams>
             <QueryParam name="q" />
          </QueryParams>
       </Copy>
    </AssignMessage>
    
  3. Determina se questa variabile è di tipo messaggio o meno:

    1. Individua il codice all'interno del bundle del proxy API in cui è stata definita per la prima volta la variabile.
    2. Una volta individuata la policy in cui la variabile viene definita e compilata per prima, devi determinare il tipo di variabile nel seguente modo:
      1. Controlla il valore dell'attributo type (se presente).
      2. Se l'attributo type non è presente, la variabile viene considerata una stringa.
    3. Se il tipo di variabile non è un messaggio (ad esempio una stringa), questo è il motivo dell'errore. Puoi scoprire di più sulle variabili comuni e sui relativi tipi nella Guida di riferimento alle variabili.

    Ad esempio, esamina la variabile PostalCode nel codice XML riportato sopra. A questa variabile viene assegnato il valore della variabile di flusso request.queryparam.postalcode nell'elemento <AssignVariable>. Questo valore è una stringa perché nell'assegnazione della variabile non è presente alcun attributo di tipo.

    Ora, ricorda che la variabile PostalCode viene utilizzata nell'elemento <Copy> del criterio Assegna messaggio:

    <Copy source="PostalCode">
       <QueryParams>
          <QueryParam name="PostalCode" />
       </QueryParams>
    </Copy>
    

    Poiché PostalCode non è di tipo messaggio (è una stringa in questo esempio), ricevi il codice di errore:

    steps.assignmessage.VariableOfNonMsgType
    

Risoluzione

Assicurati che l'attributo source nell'elemento <Copy> nel criterio Assegna messaggio non riuscito sia impostato su una variabile di flusso di tipo messaggio esistente.

Per correggere la policy, puoi modificare l'attributo source nell'elemento <Copy> per specificare una variabile di tipo messaggio. Ad esempio, se la norma Assegna messaggio deve essere eseguita nel flusso di richiesta, puoi utilizzare la variabile del tipo di messaggio request o qualsiasi altra variabile personalizzata di tipo messaggio.

<AssignMessage name="GenerateGeocodingRequest">
   <AssignTo createNew="true" type="request">GeocodingRequest</AssignTo>
   <AssignVariable>
      <Name>PostalCode</Name>
      <Ref>request.queryparam.postalcode</Ref>
   </AssignVariable>
   <AssignVariable>
      <Name>Country</Name>
      <Ref>request.queryparam.country</Ref>
   </AssignVariable>
   <Copy source="request">
      <QueryParams>
         <QueryParam name="PostalCode" />
      </QueryParams>
   </Copy>
</AssignMessage>