Khắc phục sự cố khi chỉ định thời gian chạy của Thông báo

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

UnresolvedVariable

Mã lỗi

steps.assignmessage.UnresolvedVariable

Nội dung phản hồi lỗi

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

Nguyên nhân

Lỗi này xảy ra nếu một biến được chỉ định trong chính sách Chỉ định thông báo là:

  • nằm ngoài phạm vi (không có trong quy trình cụ thể mà chính sách đang được thực thi) hoặc
  • không thể phân giải (chưa được xác định)

Ví dụ: lỗi này xảy ra nếu chính sách Assign Message (Chỉ định thông báo) thực thi trong luồng yêu cầu, nhưng thuộc tính source trong phần tử <Copy> được đặt thành biến response hoặc error hoặc bất kỳ biến tuỳ chỉnh nào khác không tồn tại trong luồng yêu cầu.

Chẩn đoán

  1. Xác định chính sách Assign Message (Chỉ định thông báo) nơi xảy ra lỗi và tên của biến không có sẵn. Bạn có thể tìm thấy cả hai mục này trong phần tử faultstring của phản hồi lỗi.

    Ví dụ: trong faultstring sau đây, tên chính sách là googleBook và biến là var:

    "faultstring": "AssignMessage[googleBook]: unable to resolve variable var"

  2. Trong XML Assign Message Policy (Chính sách chỉ định thông báo) không thành công, hãy xác minh rằng tên của biến được dùng khớp với tên biến được xác định trong chuỗi lỗi (bước 1 ở trên). Ví dụ: chính sách sau đây đặt thuộc tính nguồn trong phần tử <Copy> thành một biến có tên là var, khớp với nội dung trong 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. Xác định xem biến có được xác định và có sẵn trong luồng mà chính sách Chỉ định thông báo đang được thực thi hay không.

  4. Nếu biến là một trong hai trường hợp sau:

    1. nằm ngoài phạm vi (không có trong quy trình cụ thể mà chính sách đang được thực thi) hoặc
    2. không thể phân giải (chưa được xác định)

    thì đó là nguyên nhân gây ra lỗi.

    Ví dụ: giả sử chính sách Assign Message (Chỉ định thông báo) nêu trên thực thi trong luồng yêu cầu. Kiểm tra xem biến var có được xác định trong bất kỳ chính sách nào được thực thi trước chính sách Chỉ định thông báo trong luồng yêu cầu hay không. Nếu biến chưa được xác định, bạn sẽ nhận được mã lỗi:

    steps.assignmessage.UnresolvedVariable

Độ phân giải

Đảm bảo rằng biến được tham chiếu trong chính sách tồn tại và có sẵn trong quy trình cụ thể, nơi chính sách Chỉ định thông báo đang được thực thi.

Để sửa chính sách mẫu nêu trên, bạn có thể sửa đổi thuộc tính nguồn trong phần tử <Copy> thành biến yêu cầu hoặc bất kỳ biến tuỳ chỉnh nào khác thuộc loại thông báo có trong luồng yêu cầu.

<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

Mã lỗi

steps.assignmessage.VariableOfNonMsgType

Nội dung phản hồi lỗi

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

Nguyên nhân

Lỗi này xảy ra nếu thuộc tính source trong phần tử <Copy> được đặt thành một biến không thuộc loại message.

Các biến thuộc loại thông báo đại diện cho toàn bộ yêu cầu và phản hồi HTTP. Các biến luồng Edge tích hợp sẵn request, response và message thuộc loại thông báo. Để tìm hiểu thêm về các biến thông báo, hãy xem phần Tài liệu tham khảo về biến.

Chẩn đoán

  1. Xác định Chính sách gán thông báo nơi xảy ra lỗi và tên của biến có kiểu không chính xác. Bạn có thể tìm thấy cả hai mục này trong phần tử faultstring của phản hồi lỗi. Ví dụ: trong faultstring sau đây, tên chính sách là GenerateGeocodingRequest và biến là PostalCode:

    "faultstring": "AssignMessage[GenerateGeocodingRequest]: value of variable PostalCode is not of type Message"

  2. Trong XML Assign Message Policy không thành công, hãy xác minh rằng tên của biến được đặt trong phần tử <Copy> khớp với tên biến được xác định trong chuỗi lỗi (bước 1 ở trên). Ví dụ: chính sách sau đây đặt một thuộc tính nguồn thành một biến có tên là PostalCode, khớp với nội dung trong 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. Xác định xem biến này có thuộc loại thông báo hay không:

    1. Xác định vị trí đoạn mã trong gói API Proxy, nơi biến được xác định lần đầu tiên.
    2. Sau khi tìm ra chính sách mà biến được xác định và điền sẵn trước tiên, bạn cần xác định loại biến đó như sau:
      1. Kiểm tra giá trị của thuộc tính loại (nếu có).
      2. Nếu không có thuộc tính type, thì biến được coi là một chuỗi.
    3. Nếu loại của biến không phải là thông báo (chẳng hạn như một chuỗi), thì đó là nguyên nhân gây ra lỗi. Bạn có thể tìm hiểu về các biến phổ biến và loại biến trong Tài liệu tham khảo về biến.

    Ví dụ: hãy xem biến PostalCode trong XML ở trên. Giá trị này được chỉ định cho giá trị của biến luồng request.queryparam.postalcode trong phần tử <AssignVariable>. Giá trị này là một chuỗi, vì không có thuộc tính loại nào trong phép gán biến.

    Bây giờ, hãy nhớ rằng biến PostalCode được dùng trong phần tử <Copy> của chính sách Assign Message (Chỉ định thông báo):

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

    Vì PostalCode không thuộc loại thông báo (trong ví dụ này, đó là một chuỗi), nên bạn sẽ nhận được mã lỗi:

    steps.assignmessage.VariableOfNonMsgType

Độ phân giải

Đảm bảo rằng thuộc tính source trong phần tử <Copy> trong chính sách Assign Message (Chỉ định thông báo) không thành công được đặt thành một biến luồng thuộc loại message hiện có.

Để sửa đổi chính sách, bạn có thể sửa đổi thuộc tính source trong phần tử <Copy> để chỉ định một biến thuộc loại thông báo. Ví dụ: nếu chính sách Assign Message (Chỉ định thông báo) được giả định thực thi trong luồng yêu cầu, thì bạn có thể sử dụng biến loại thông báo request hoặc bất kỳ biến tuỳ chỉnh nào khác thuộc loại thông báo.

<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>