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.
Tham khảo tài liệu về Apigee X. thông tin

UnresolvedVariable

Mã lỗi

steps.assignmessage.UnresolvedVariable

Nội dung phản hồi về 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 (không xác định)

Ví dụ: lỗi này xảy ra nếu chính sách 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 chỉ định thông báo 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 chỉ định Chính sách 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 thuộc tính 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 xác định và có trong luồng mà chính sách Gán thông báo đang thực thi hay không.

  4. Nếu biến là:

    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 (không xác định)

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

    Ví dụ: giả sử chính sách Chỉ định tin nhắn hiển thị ở trên thực thi trong luồng yêu cầu. Hãy 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

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

Để sửa chính sách ví dụ 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 thông báo loại tồn tại 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 về 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 thông báo.

Các biến loại thông báo đại diện cho toàn bộ yêu cầu HTTP và phản hồi. Các biến luồng Edge tích hợp sẵn request, response và message 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 bài viết Tài liệu tham khảo về biến.

Chẩn đoán

  1. Xác định Chính sách chỉ định thông báo 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 Gán chính sách thông báo 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 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 này hay không:

    1. Tìm mã trong gói Proxy API, nơi biến được xác định trước.
    2. Sau khi tìm hiểu chính sách mà biến được xác định và điền trước, 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 loại thì biến được coi là một chuỗi.
    3. Nếu loại biến không phải là thông điệp (chẳng hạn như 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 gán 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 việc chỉ định 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 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 bạn đã đặt thuộc tính source trong phần tử <Copy> trong chính sách Chỉ định thông báo không thành công thành biến luồng loại thông báo tồn tại.

Để sửa chính sách này, bạn có thể sửa đổi thuộc tính source trong phần tử <Copy> để chỉ định một biến có kiểu thông báo. Ví dụ: nếu dự kiến thực thi chính sách Gán thông báo trong luồng yêu cầu, thì bạn có thể sử dụng biến kiểu 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>