查看 Apigee Edge 說明文件。
前往
Apigee X說明文件。 資訊
UnresolvedVariable
錯誤代碼
steps.assignmessage.UnresolvedVariable
錯誤回應主體
{ "fault": { "faultstring": "AssignMessage[policy_name]: unable to resolve variable [variable_name]", "detail": { "errorcode": "steps.assignmessage.UnresolvedVariable" } } }
原因
如果指派訊息政策中指定的變數出現以下情形,就會發生這個錯誤:
- 超出範圍 (不適用於執行政策的特定流程)
- 無法解析 (未定義)
舉例來說,如果在要求流程中執行「指派訊息」政策,但 <Copy>
元素中的 source
屬性設為 response
或 error
變數,或是要求流程中沒有的任何其他自訂變數,就會發生這個錯誤。
診斷
找出發生錯誤的「指派訊息政策」,以及無法使用的變數名稱。您可以在錯誤回應的
faultstring
元素中找到這兩個項目。舉例來說,下列
faultstring
中的政策名稱為googleBook
,變數為var
:"faultstring": "AssignMessage[googleBook]: unable to resolve variable var"
在失敗的「指派訊息政策」XML 中,驗證使用的變數名稱與錯誤字串中識別的變數名稱 (上述步驟 #1)。舉例來說,下列政策會將
<Copy>
元素中的來源屬性設為名為var
的變數,此變數與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>
確定是否已在執行「指派訊息」政策的流程中定義及可用的變數。
如果變數為以下任一變數:
- 超出範圍 (不適用於執行政策的特定流程)
- 無法解析 (未定義)
這就是發生錯誤的原因
舉例來說,假設上方顯示的「指派訊息」政策會在要求流程中執行。檢查在要求流程中「指派訊息」政策之前執行的政策,是否已定義
var
變數。如果尚未定義變數,您會收到錯誤代碼:steps.assignmessage.UnresolvedVariable
解析度
確保政策中參照的變數存在於執行「指派訊息」政策的特定流程中。
如要修正上述範例政策,您可以將 <Copy>
元素中的來源屬性修改為要求變數,或是要求流程中現有的其他類型訊息類型自訂變數。
<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
錯誤代碼
steps.assignmessage.VariableOfNonMsgType
錯誤回應主體
{ "fault": { "faultstring": "AssignMessage[policy_name]: value of variable [variable] is not of type Message", "detail": { "errorcode": "steps.assignmessage.VariableOfNonMsgType" } } }
原因
如果 <Copy>
元素中的 source
屬性設為非 message 類型的變數,就會發生這個錯誤。
訊息類型變數代表整個 HTTP 要求和回應。內建 Edge 流程變數 request
、response
和 message
是訊息類型。如要進一步瞭解訊息變數,請參閱變數參考資料。
診斷
找出發生錯誤的「指派訊息政策」,以及類型不正確的變數名稱。您可以在錯誤回應的
faultstring
元素中找到這兩個項目。舉例來說,下列faultstring
中的政策名稱為GenerateGeocodingRequest
,變數為PostalCode
:"faultstring": "AssignMessage[GenerateGeocodingRequest]: value of variable PostalCode is not of type Message"
在失敗的「指派訊息政策」XML 中,驗證
<Copy>
元素中設定的變數名稱與錯誤字串中識別的變數名稱 (前述步驟 1) 相符。舉例來說,下列政策會將來源屬性設為名為PostalCode
的變數,且該變數與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>
判斷這個變數是否為訊息類型:
- 在 API Proxy 組合中找出先定義變數的程式碼。
- 找到先定義及填入變數的政策後,您必須依下列方式判斷該變數的類型:
- 檢查類型屬性值 (如果有的話)。
- 如果沒有類型屬性,則系統會將變數視為字串。
- 如果變數類型為非訊息 (例如字串),就會造成錯誤。如要瞭解常見變數和它們的類型,請參閱變數參考資料。
例如,請查看上述 XML 中的 PostalCode 變數。而是在
<AssignVariable>
元素中指派流程變數request.queryparam.postalcode
的值。這個值是字串,因為變數指派中沒有類型屬性。現在,請記得在「指派訊息」政策的
<Copy>
元素中使用 PostalCode 變數:<Copy source="PostalCode"> <QueryParams> <QueryParam name="PostalCode" /> </QueryParams> </Copy>
由於 PostalCode 不是訊息類型 (本例中為字串),因此您會收到錯誤代碼:
steps.assignmessage.VariableOfNonMsgType
解析度
請確認失敗的「指派訊息」政策中 <Copy>
元素的 source
屬性已設為現有的「訊息」類型流程變數。
如要修正政策,請修改 <Copy>
元素中的 source
屬性,指定訊息類型的變數。舉例來說,如果應在要求流程中執行「指派訊息」政策,您可以使用訊息類型變數 request
或任何其他類型訊息的自訂變數。
<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>