این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

خط مشی SOAPMessageValidation

شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید . اطلاعات

خط مشی SOAPMessageValidation موارد زیر را انجام می دهد:

هر پیام XML را در برابر طرحواره های XSD آنها اعتبار سنجی می کند
پیام های SOAP را در برابر تعریف WSDL اعتبار سنجی می کند
به خوبی شکل گیری پیام های JSON و XML را تعیین می کند

در حالی که نام این خط‌مشی در رابط کاربری «تأیید اعتبار پیام SOAP» است، این خط‌مشی بیش از پیام‌های SOAP را تأیید می‌کند. این بخش به این خط‌مشی با عنوان «خط‌مشی اعتبارسنجی پیام» اشاره می‌کند.

درباره خط مشی اعتبارسنجی پیام

مزایا

اعتبار سنجی پیام مزایای زیر را ارائه می دهد:

اگر درخواست‌هایشان ناسازگار یا ناقص باشد، بلافاصله به توسعه‌دهندگان برنامه‌هایی که API شما را مصرف می‌کنند، اطلاع می‌دهد .
مشکلات را در درخواست‌ها مشخص می‌کند ، مانند برچسب‌های XML که به درستی بسته نشده‌اند.
با مسدود کردن پیام‌های XML یا SOAP با ساختارهایی که ممکن است باعث رفتار غیرقابل پیش‌بینی شود، از خدمات باطن محافظت می‌کند .
زمان صرف شده برای عیب یابی، جستجوی انجمن ها یا مشاوره با پشتیبانی فنی را کاهش می دهد .
توسعه‌دهندگان را تشویق می‌کند تا با تعریف WSDL طرح XML آشنا شوند تا خطاهای اعتبارسنجی را حذف کنند، و طرح‌واره‌های XML را که به خوبی درک شده‌اند جزء کلیدی مستندات API شما قرار دهند.

ویدیوها

ویدیوهای زیر را تماشا کنید تا درباره خط‌مشی اعتبارسنجی پیام بیشتر بدانید:

ویدئو	توضیحات
اعتبار درخواست XML	درخواست XML برای یک API را با استفاده از خط مشی اعتبارسنجی پیام تأیید کنید.
درخواست JSON را تأیید کنید	با استفاده از خط مشی اعتبارسنجی پیام، درخواست JSON را برای یک API تأیید کنید.

عنصر `<MessageValidation>`

خط مشی اعتبارسنجی پیام را تعریف می کند.

مقدار پیش فرض	به برگه سیاست پیش‌فرض در زیر مراجعه کنید
مورد نیاز؟	اختیاری
تایپ کنید	شیء پیچیده
عنصر والد	n/a
عناصر کودک	`<DisplayName>` `<Element>` `<ResourceURL>` `<SOAPMessage>` `<Source>`

نحو

عنصر <MessageValidation> از نحو زیر استفاده می کند:

<MessageValidation
  continueOnError="[false|true]"
  enabled="[true|false]"
  name="policy_name"
>
    <!-- All MessageValidation child elements are optional -->
    <DisplayName>policy_display_name</DisplayName>
    <Element namespace="element_namespace">element_to_validate</Element>
    <SOAPMessage version="[ 1.1 | 1.2 | 1.1/1.2 ]"/>
    <Source>message_to_validate</Source>
    <ResourceURL>validation_WSDL_or_XSD</ResourceURL>

</MessageValidation>

خط مشی پیش فرض

مثال زیر تنظیمات پیش‌فرض را هنگام اضافه کردن یک خط‌مشی اعتبارسنجی پیام به جریان خود در رابط کاربری Edge نشان می‌دهد:

<MessageValidation continueOnError="false" enabled="true" name="SOAP-Message-Validation-1">
  <DisplayName>SOAP Message Validation-1</DisplayName>
  <Properties/>
  <Element namespace="http://sample.com">sampleObject</Element>
  <SOAPMessage/>
  <Source>request</Source>
  <ResourceURL>wsdl://SOAP-Message-Validation-1.wsdl</ResourceURL>
</MessageValidation>

این عنصر دارای ویژگی های زیر است که در همه سیاست ها مشترک است:

صفت	پیش فرض	ضروری؟	شرح
`name`	N/A	ضروری	نام داخلی سیاست. مقدار مشخصه `name` می تواند شامل حروف، اعداد، فاصله، خط تیره، زیرخط و نقطه باشد. این مقدار نمی تواند بیش از 255 کاراکتر باشد. در صورت تمایل، از عنصر `<DisplayName>` برای برچسب گذاری خط مشی در ویرایشگر پروکسی UI مدیریت با نامی به زبان طبیعی دیگر استفاده کنید.
`continueOnError`	نادرست	اختیاری	برای بازگرداندن خطا در صورت شکست خط مشی، روی "false" تنظیم کنید. این رفتار مورد انتظار برای اکثر سیاست ها است. روی "true" تنظیم کنید تا اجرای جریان حتی پس از شکست خط مشی ادامه یابد.
`enabled`	درست است، واقعی	اختیاری	برای اجرای این خط‌مشی روی «درست» تنظیم کنید. برای «خاموش کردن» خط مشی، روی «نادرست» تنظیم کنید. این سیاست حتی اگر به یک جریان وابسته باشد اجرا نخواهد شد.
`async`	نادرست	منسوخ	این ویژگی منسوخ شده است.

نمونه ها

مثال‌های زیر برخی از روش‌های استفاده از خط‌مشی اعتبارسنجی پیام را نشان می‌دهند:

1: اعتبار سنجی XSD

می‌توانید از خط‌مشی اعتبارسنجی پیام برای تأیید بار درخواست پیام XML در برابر طرح XSD استفاده کنید.

یک فایل منبع XSD جدید ایجاد کنید. به عنوان مثال، "note-schema.xsd":

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="note">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="to" type="xs:string"/>
        <xs:element name="from" type="xs:string"/>
        <xs:element name="heading" type="xs:string"/>
        <xs:element name="body" type="xs:string"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

خط مشی اعتبارسنجی پیام SOAP را به جریان اولیه نقطه پایانی پروکسی خود اضافه کنید:
1. محل فایل منبع XSD خود را با عنصر <ResourceURL> مشخص کنید. به عنوان مثال:
```
...
  <ResourceURL>xsd://note-schema.xsd</ResourceURL>
...
```
2. عناصر <SOAPMessage> و <Element> را از تعریف خط مشی حذف کنید.
تعریف خط مشی شما باید به شکل زیر باشد:
```
<MessageValidation continueOnError="false"
    enabled="true" name="validateXMLRequest">
  <DisplayName>My XML Validator</DisplayName>
  <Properties/>
  <Source>request</Source>
  <ResourceURL>xsd://note-schema.xsd</ResourceURL>
</MessageValidation>
```
همانطور که مثال زیر نشان می دهد، یک درخواست POST را با XML خود به عنوان بار پیام به پروکسی API خود ارسال کنید:
```
curl -v -X POST -H 'Content-Type: application/xml' http://my-test.apigee.net/v1/xsd-mock
  -d '<note>
  <to>Fred Rogers</to>
  <from>Nick Danger</from>
  <heading>Greetings from my neighborhood</heading>
  <body>Just writing to say hello.</body>
</note>'
```
توجه داشته باشید که هدر Content-type روی "application/xml" تنظیم شده است.
همچنین می توانید یک فایل داده برای payload ایجاد کنید و با دستوری مشابه زیر به آن ارجاع دهید:
```
curl -v -X POST -H 'Content-type: application/xml' http://my-test.apigee.net/v1/xsd-mock
  --data '@../examples/note-payload.xml'
```

شما باید یک پاسخ HTTP 200 دریافت کنید. بسته به نقطه پایانی هدف خود، ممکن است جزئیات بیشتری در مورد درخواست دریافت کنید. به عنوان مثال، اگر از http://httpbin.org/post به عنوان نقطه پایانی هدف خود استفاده می کنید و خروجی -v (کلامی) را مشخص می کنید، پاسخ باید شبیه به زیر باشد:

< HTTP/1.1 200 OK
< Date: Wed, 16 May 2018 21:24:54 GMT
< Content-Type: application/xml
< Content-Length: 431
< Connection: keep-alive
< Server: gunicorn/19.8.1
< Access-Control-Allow-Origin: *
< Access-Control-Allow-Credentials: true
< Via: 1.1 vegur
{
  "args":{},
  "data":"<note><to>fred</to><from>nick</from><heading>hello</heading>
    <body>Just writing to say hello.</body></note>",
  "files":{},
  "form":{},
  "headers": {
    "Accept":"*/*",
    "Connection":"close",
    "Content-Length":"106",
    "Content-Type":"application/xml",
    "Host":"httpbin.org",
    "User-Agent":"curl/7.58.0"
  },
  "json":null,
  "origin":"10.1.1.1, 104.154.179.1",
  "url":"http://httpbin.org/post"
}

برای تأیید اینکه اعتبارسنجی XSD شما کار می کند، سعی کنید یک برچسب دیگر را در متن درخواست خود وارد کنید. به عنوان مثال:

curl -v -X POST -H 'Content-Type: application/xml' http://my-test.apigee.net/v1/xsd-mock
  -d '<note>
  <to>Fred Rogers</to>
  <from>Nick Danger</from>
  <heading>Greetings from my neighborhood</heading>
  <body>Just writing to say hello.</body>
  <badTag>Not good</badTag>
</note>'

شما باید یک خطای اعتبار سنجی دریافت کنید.

2: اعتبارسنجی SOAP

می‌توانید از خط‌مشی اعتبارسنجی پیام برای تأیید بار بار درخواست پیام SOAP در برابر WSDL استفاده کنید.

یک فایل منبع WSDL جدید ایجاد کنید. به عنوان مثال، "example-wsdl.wsdl":

مشاهده کامل WSDL

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions targetNamespace="https://example.com/gateway"
    xmlns:tns="https://example.com/gateway"
    xmlns:types="https://example.com/gateway/types"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
    xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/">
  <wsdl:types>
    <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
        targetNamespace="https://example.com/gateway/types"
        elementFormDefault="qualified">
      <xsd:element name="MyType">
        <xsd:complexType>
          <xsd:sequence>
            <xsd:element name="ID" nillable="false" minOccurs="1" maxOccurs="1"/>
          </xsd:sequence>
        </xsd:complexType>
      </xsd:element>
    </xsd:schema>
    <schema attributeFormDefault="unqualified" elementFormDefault="qualified"
        targetNamespace="https://example.com/gateway"
        xmlns="http://www.w3.org/2001/XMLSchema">
      <xsd:import namespace="https://example.com/gateway/types"/>
      <element name="getID">
        <complexType>
          <sequence>
            <element ref="types:MyType"/>
          </sequence>
        </complexType>
      </element>
    </schema>
  </wsdl:types>

  <wsdl:message name="getRequest">
    <wsdl:part name="getRequest" element="tns:getID"/>
  </wsdl:message>
  <wsdl:message name="getResponse">
    <wsdl:part name="getResponse" element="tns:getID"/>
  </wsdl:message>

  <wsdl:portType name="PortType">
    <wsdl:operation name="get">
      <wsdl:input name="methodRequest" message="tns:getRequest"/>
      <wsdl:output name="methodResponse" message="tns:getResponse"/>
    </wsdl:operation>
  </wsdl:portType>

  <wsdl:service name="Gateway">
    <wsdl:port name="GatewaySoap" binding="tns:SoapBinding">
      <wsdlsoap:address location="https://example.com/gateway"/>
    </wsdl:port>
  </wsdl:service>

  <wsdl:binding name="SoapBinding" type="tns:PortType">
    <wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>

    <wsdl:operation name="get">
      <wsdlsoap:operation soapAction="get"/>
      <wsdl:input name="methodRequest"/>
      <wsdl:output name="methodResponse"/>
    </wsdl:operation>

  </wsdl:binding>
</wsdl:definitions>

خط مشی اعتبارسنجی پیام SOAP را به جریان اولیه نقطه پایانی پروکسی خود اضافه کنید:
1. ویژگی version عنصر <SOAPMessage> را روی نسخه ای از پروتکل SOAP که می خواهید بر اساس آن اعتبارسنجی کنید، تنظیم کنید. به عنوان مثال، "1.1":
```
...
  <SOAPMessage version="1.1"/>
...
```
2. مقدار عنصر <Element> را به عنصری که می خواهید اعتبار سنجی کنید تنظیم کنید:
```
...
  <Element namespace="https://example.com/gateway">getID</Element>
...
```
  <Element> اولین فرزند را در زیر عنصر <Body> در پاکت درخواست SOAP مشخص می کند.
  ویژگی namespace را به فضای نام برای آن فرزند تنظیم کنید.
3. محل فایل منبع WSDL خود را با عنصر <ResourceURL> مشخص کنید. به عنوان مثال:
```
...
  <ResourceURL>wsdl://example-wsdl.wsdl</ResourceURL>
...
```
تعریف خط مشی شما باید به شکل زیر باشد:
```
<MessageValidation continueOnError="false"
    enabled="true" name="validateSOAPRequest">
  <DisplayName>My SOAP Validator</DisplayName>
  <Properties/>
  <Source>request</Source>
  <SOAPMessage version="1.1"/>
  <Element namespace="https://example.com/gateway">getID</Element>
  <ResourceURL>wsdl://example-wsdl.wsdl</ResourceURL>
</MessageValidation>
```

همانطور که مثال زیر نشان می دهد، یک درخواست POST را با پاکت SOAP به عنوان بار پیام به پروکسی API خود ارسال کنید:

curl -v -X POST -H 'Content-Type: application/xml' http://my-test.apigee.net/v1/xsd-mock
  -d '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:prox="https://example.com/gateway" xmlns:typ="https://example.com/gateway/types">
  <soapenv:Header/>
  <soapenv:Body>
    <prox:getID>
      <typ:MyType>
        <typ:ID>42</typ:ID>
      </typ:MyType>
    </prox:getID>
  </soapenv:Body>
</soapenv:Envelope>'

توجه داشته باشید که هدر Content-type روی "application/xml" تنظیم شده است.

همچنین می توانید یک فایل داده برای payload ایجاد کنید و با دستوری مشابه زیر به آن ارجاع دهید:

curl -v -X POST -H 'Content-type: application/xml' http://my-test.apigee.net/v1/xsd-mock
  --data '@../examples/soap-payload.xml'

< HTTP/1.1 200 OK
< Date: Wed, 16 May 2018 21:24:54 GMT
< Content-Type: application/xml
< Content-Length: 431
< Connection: keep-alive
< Server: gunicorn/19.8.1
< Access-Control-Allow-Origin: *
< Access-Control-Allow-Credentials: true
< Via: 1.1 vegur
{
  "args":{},
  "data":"<note><to>fred</to><from>nick</from><heading>hello</heading>
    <body>Just writing to say hello.</body></note>",
  "files":{},
  "form":{},
  "headers": {
    "Accept":"*/*",
    "Connection":"close",
    "Content-Length":"106",
    "Content-Type":"application/xml",
    "Host":"httpbin.org",
    "User-Agent":"curl/7.58.0"
  },
  "json":null,
  "origin":"10.1.1.1, 104.154.179.1",
  "url":"http://httpbin.org/post"
}

3: XML/JSON خوش فرم

می‌توانید از خط‌مشی اعتبارسنجی پیام استفاده کنید تا تأیید کنید که بار پیام JSON یا XML به خوبی شکل گرفته است (نه مانند اعتبارسنجی ). این خط‌مشی تضمین می‌کند که ساختار و محتوا مطابق با استانداردهای پذیرفته شده از جمله:

یک عنصر ریشه واحد وجود دارد
هیچ شخصیت غیرقانونی در محتوا وجود ندارد
اشیاء و برچسب ها به درستی تو در تو قرار گرفته اند
تگ های آغاز و پایان مطابقت دارند

برای بررسی یک بار XML یا JSON خوب شکل گرفته:

خط مشی اعتبارسنجی پیام SOAP را به جریان اولیه نقطه پایانی پروکسی خود اضافه کنید.

عناصر <ResourceURL> ، <SOAPMessage> و <Element> را از تعریف خط مشی حذف کنید.

تعریف خط مشی شما باید به شکل زیر باشد:

<MessageValidation async="false" continueOnError="false"
    enabled="true" name="validateXMLRequest">
  <DisplayName>My JSON Checker</DisplayName>
  <Properties/>
  <Source>request</Source>
</MessageValidation>

همانطور که در مثال زیر نشان داده شده است، یک درخواست POST به پروکسی API خود ارسال کنید:
```
curl -v -X POST -H 'Content-Type: application/json' http://my-test.apigee.net/v1/xsd-mock
  -d '{
"note": {
  "to": "Fred Rogers",
  "from": "Nick Danger",
  "header": "Greetings from my neighborhood",
  "body": "Just writing to say hello."
  }
}'
```
توجه داشته باشید که هدر Content-type روی "application/json" تنظیم شده است.
برای بررسی درستی یک فایل XML ، از XML به عنوان بار پیام استفاده کنید و Content-type روی "application/xml" تنظیم کنید.

شما باید یک پاسخ HTTP 200 دریافت کنید. وقتی پیغامی ارسال می‌کنید که حاوی XML یا JSON مناسب نیست، باید یک خطای steps.messagevalidation.Failed دریافت کنید.

مرجع عنصر کودک

این بخش عناصر فرزند <MessageValidation> را توصیف می کند.

`<DisplayName>`

علاوه بر ویژگی name برای برچسب گذاری خط مشی در ویرایشگر پروکسی رابط کاربری مدیریت با نامی متفاوت و طبیعی تر، از آن استفاده کنید.

عنصر <DisplayName> در همه خط مشی ها مشترک است.

مقدار پیش فرض	n/a
مورد نیاز؟	اختیاری. اگر `<DisplayName>` حذف کنید، از مقدار ویژگی `name` خط مشی استفاده می شود
تایپ کنید	رشته
عنصر والد	< `PolicyElement` >
عناصر کودک	هیچ کدام

عنصر <DisplayName> از نحو زیر استفاده می کند:

نحو

<PolicyElement>
  <DisplayName>policy_display_name</DisplayName>
  ...
</PolicyElement>

مثال

<PolicyElement>
  <DisplayName>My Validation Policy</DisplayName>
</PolicyElement>

عنصر <DisplayName> هیچ ویژگی یا عنصر فرزند ندارد.

`<Element>`

عنصری را در پیام برای اعتبار سنجی مشخص می کند. این اولین فرزند زیر عنصر <Body> در پاکت درخواست SOAP است.

مقدار پیش فرض	نمونه شی
مورد نیاز؟	اختیاری
تایپ کنید	رشته
عنصر والد	`<MessageValidation>`
عناصر کودک	هیچ کدام

عنصر <Element> از نحو زیر استفاده می کند:

نحو

...
  <Element namespace="element_namespace">element_to_validate</Element>
...

مثال 1

مثال زیر یک عنصر واحد را تعریف می کند که باید اعتبار سنجی شود:

...
<Element namespace="https://example.com/gateway">getID</Element>
...

مثال 2

با افزودن چندین عنصر <Element> می توانید بیش از یک عنصر را برای اعتبارسنجی تعیین کنید:

...
<Element namespace="https://example.com/gateway">getID</Element>
<Element namespace="https://example.com/gateway">getDetails</Element>
...

عنصر <Element> دارای ویژگی های زیر است:

صفت	پیش فرض	مورد نیاز؟	توضیحات
`namespace`	"http://sample.com"	اختیاری	فضای نام عنصری که باید اعتبار سنجی شود را تعریف می کند.

`<ResourceURL>`

طرح XSD یا تعریف WSDL را برای اعتبارسنجی پیام منبع شناسایی می کند.

مقدار پیش فرض	wsdl:// `display_name` .wsdl
مورد نیاز؟	اختیاری
تایپ کنید	رشته
عنصر والد	`<MessageValidation>`
عناصر کودک	هیچ کدام

عنصر <ResourceURL> از نحو زیر استفاده می کند:

نحو

...
  <ResourceURL>[wsdl|xsd]://validation_WSDL_or_XSD</ResourceURL>
...

نمونه ها

برای یک فایل XML:

...
<ResourceURL>xsd://note-schema.xsd</ResourceURL>
...

برای WSDL:

...
<ResourceURL>wsdl://example-wsdl.wsdl</ResourceURL>
...

مقدار <ResourceURL> باید به یک فایل منبع در پروکسی API شما اشاره کند. نمی تواند به منابع خارجی از طریق HTTP یا HTTPS اشاره کند.

اگر مقداری را برای <ResourceURL> مشخص نکنید، اگر هدر Content-type به ترتیب "application/json" یا "application/xml" باشد، پیام از نظر JSON یا XML خوب بررسی می شود.

عنصر <ResourceURL> هیچ عنصر یا ویژگی فرزند ندارد.

استفاده از XSD برای اعتبارسنجی

اگر بار XML که با خط‌مشی اعتبارسنجی پیام تأیید می‌کنید به طرح دیگری ارجاع می‌دهد، باید پیشوند فایل XSD همراه با xsd را در ویژگی schemaLocation قرار دهید.

طرح مثال زیر از چندین XSD تشکیل شده است:

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
    elementFormDefault="qualified" attributeFormDefault="unqualified">
  <xs:include schemaLocation="xsd://note-schema.xsd"/>
  <xs:include schemaLocation="xsd://letter-schema.xsd"/>
  <xs:include schemaLocation="xsd://user-schema.xsd"/>
</xs:schema>

استفاده از WSDL برای اعتبارسنجی

یک WSDL باید حداقل یک طرح واره را تعریف کند. اگر حداقل به یک طرح ارجاع داده نشود، خط مشی اعتبارسنجی پیام با شکست مواجه می شود.

حداکثر عمق واردات برای یک طرح 10 است. اگر از این تعداد واردات تودرتو تجاوز کنید، خط‌مشی اعتبارسنجی پیام با شکست مواجه می‌شود.

`<SOAPMessage>`

نسخه SOAP را تعریف می کند که خط مشی اعتبارسنجی پیام با آن اعتبارسنجی می کند.

مقدار پیش فرض	n/a
مورد نیاز؟	اختیاری
تایپ کنید	n/a
عنصر والد	`<MessageValidation>`
عناصر کودک	هیچ کدام

عنصر <SOAPMessage> از نحو زیر استفاده می کند:

نحو

...
  <SOAPMessage version="[ 1.1 | 1.2 | 1.1/1.2 ]"/>
...

مثال

...
<SOAPMessage version="1.1"/>
...

عنصر <SOAPMessage> دارای ویژگی های زیر است:

صفت پیش فرض مورد نیاز؟ توضیحات

صفت	پیش فرض	مورد نیاز؟	توضیحات
`version`	هیچ کدام	اختیاری	نسخه SOAP که این خط‌مشی برای اعتبارسنجی پیام‌های SOAP استفاده می‌کند. مقادیر معتبر عبارتند از: "1.1" "1.2" "1.1/1.2"

version

هیچ کدام

اختیاری

نسخه SOAP که این خط‌مشی برای اعتبارسنجی پیام‌های SOAP استفاده می‌کند.

مقادیر معتبر عبارتند از:

"1.1"
"1.2"
"1.1/1.2"

برای اطلاعات بیشتر، از SOAP/1.1 تا SOAP نسخه 1.2 در 9 نقطه را ببینید.

`<Source>`

پیام منبعی را که باید تایید شود را شناسایی می کند. مقدار این عنصر نام پیامی است که می خواهید اعتبار سنجی کنید.

اگر <Source> تنظیم نکنید، این خط‌مشی به طور پیش‌فرض روی "پیام" است که به پیام درخواست کامل (در جریان درخواست) یا پیام پاسخ (در جریان پاسخ)، از جمله هر بار محموله اشاره دارد. همچنین می توانید به صراحت آن را روی «درخواست» یا «پاسخ» برای اشاره به درخواست یا پاسخ تنظیم کنید.

مقدار پیش فرض	درخواست کنید
مورد نیاز؟	اختیاری
تایپ کنید	رشته
عنصر والد	`<MessageValidation>`
عناصر کودک	هیچ کدام

عنصر <Source> از نحو زیر استفاده می کند:

نحو

...
  <Source>message_to_validate</Source>
...

مثال

...
<Source>request</Source>
...

علاوه بر "پیام"، "درخواست" و "پاسخ"، می توانید مقدار <Source> را برای نام هر پیامی در جریان خود تنظیم کنید. اگر این کار را انجام دهید، باید قبل از اجرای این خط مشی، یک پیام سفارشی با آن نام در جریان خود ایجاد کنید. در غیر این صورت با خطا مواجه خواهید شد.

اگر مقدار <Source> در جریان پیام قابل حل نباشد یا به یک نوع غیر پیام تبدیل شود، یکی از موارد زیر رخ می دهد:

اگر یک مقدار تهی باشد: Edge یک خطای steps.messagevalidation.SourceMessageNotAvailable را پرتاب می کند.
اگر یک نوع غیر پیام باشد: Edge یک خطای steps.messagevalidation.NonMessageVariable می‌اندازد.

عنصر <Source> هیچ ویژگی یا عنصر فرزند ندارد.

کدهای خطا

خطاهایی که از خط‌مشی‌های Edge برگردانده می‌شوند از یک قالب ثابت پیروی می‌کنند که در مرجع کد خطا توضیح داده شده است.

این بخش کدهای خطا و پیام‌های خطایی را که برگردانده می‌شوند و متغیرهای خطا را که توسط Edge تنظیم می‌شوند، هنگامی که این خط‌مشی خطا را راه‌اندازی می‌کند، توضیح می‌دهد. این اطلاعات برای دانستن اینکه آیا در حال توسعه قوانین خطا برای رسیدگی به خطاها هستید، مهم است. برای کسب اطلاعات بیشتر، آنچه را که باید در مورد خطاهای خط مشی و مدیریت خطاها بدانید را ببینید.

خطاهای زمان اجرا

این خطاها ممکن است هنگام اجرای سیاست رخ دهند.

کد خطا وضعیت HTTP علت ثابت

کد خطا	وضعیت HTTP	علت
`steps.messagevalidation.SourceMessageNotAvailable`	500	این خطا در صورتی رخ می دهد که متغیری که در عنصر `<Source>` خط مشی مشخص شده است یکی از این موارد باشد: خارج از محدوده (در جریان خاصی که سیاست در آن اجرا می شود موجود نیست) یا قابل حل نیست (تعریف نشده است)
`steps.messagevalidation.NonMessageVariable`	500	اگر عنصر `<Source>` در خط مشی SOAPMessageValidation روی متغیری تنظیم شود که از نوع پیام نیست، این خطا رخ می دهد. متغیرهای نوع پیام، کل درخواست‌ها و پاسخ‌های HTTP را نشان می‌دهند. متغیرهای جریان لبه داخلی `request` ، `response` و `message` از نوع پیام هستند. برای کسب اطلاعات بیشتر در مورد متغیرهای پیام، به مرجع متغیرها مراجعه کنید.
`steps.messagevalidation.Failed`	500	این خطا در صورتی رخ می دهد که خط مشی SOAPMessageValidation نتواند بار پیام ورودی را در برابر طرح XSD یا تعریف WSDL تأیید کند. همچنین اگر JSON یا XML نادرست در پیام بارگذاری وجود داشته باشد، رخ می دهد.

steps.messagevalidation.SourceMessageNotAvailable

500

این خطا در صورتی رخ می دهد که متغیری که در عنصر <Source> خط مشی مشخص شده است یکی از این موارد باشد:

خارج از محدوده (در جریان خاصی که سیاست در آن اجرا می شود موجود نیست)
قابل حل نیست (تعریف نشده است)

steps.messagevalidation.NonMessageVariable

500

اگر عنصر <Source> در خط مشی SOAPMessageValidation روی متغیری تنظیم شود که از نوع پیام نیست، این خطا رخ می دهد.

متغیرهای نوع پیام، کل درخواست‌ها و پاسخ‌های HTTP را نشان می‌دهند. متغیرهای جریان لبه داخلی request ، response و message از نوع پیام هستند. برای کسب اطلاعات بیشتر در مورد متغیرهای پیام، به مرجع متغیرها مراجعه کنید.

steps.messagevalidation.Failed 500 این خطا در صورتی رخ می دهد که خط مشی SOAPMessageValidation نتواند بار پیام ورودی را در برابر طرح XSD یا تعریف WSDL تأیید کند. همچنین اگر JSON یا XML نادرست در پیام بارگذاری وجود داشته باشد، رخ می دهد.

خطاهای استقرار

این خطاها ممکن است زمانی رخ دهند که یک پروکسی حاوی این خط مشی را مستقر می کنید.

نام خطا	علت	ثابت
`InvalidResourceType`	عنصر `<ResourceURL>` در خط مشی SOAPMessageValidation روی یک نوع منبع تنظیم شده است که توسط این خط مشی پشتیبانی نمی شود.
`ResourceCompileFailed`	اسکریپت منبع ارجاع شده در عنصر `<ResourceURL>` خط مشی SOAPMessageValidation حاوی خطایی است که از کامپایل آن جلوگیری می کند.
`RootElementNameUnspecified`	عنصر `<Element>` در خط مشی SOAPMessageValidation حاوی نام عنصر ریشه نیست.
`InvalidRootElementName`	عنصر `<Element>` در خط مشی SOAPMessageValidation حاوی یک نام عنصر ریشه است که برای نامگذاری عنصر معتبر به قوانین XML پایبند نیست.

خطاهای زمان اجرا

این خطاها ممکن است هنگام اجرای سیاست رخ دهند.

کد خطا وضعیت HTTP علت ثابت

کد خطا	وضعیت HTTP	علت
`steps.messagevalidation.SourceMessageNotAvailable`	500	این خطا در صورتی رخ می دهد که متغیری که در عنصر `<Source>` خط مشی مشخص شده است یکی از این موارد باشد: خارج از محدوده (در جریان خاصی که سیاست در آن اجرا می شود موجود نیست) یا قابل حل نیست (تعریف نشده است)
`steps.messagevalidation.NonMessageVariable`	500	اگر عنصر `<Source>` در خط مشی SOAPMessageValidation روی متغیری تنظیم شود که از نوع پیام نیست، این خطا رخ می دهد. متغیرهای نوع پیام، کل درخواست‌ها و پاسخ‌های HTTP را نشان می‌دهند. متغیرهای جریان لبه داخلی `request` ، `response` و `message` از نوع پیام هستند. برای کسب اطلاعات بیشتر در مورد متغیرهای پیام، به مرجع متغیرها مراجعه کنید.
`steps.messagevalidation.Failed`	500	این خطا در صورتی رخ می دهد که خط مشی SOAPMessageValidation نتواند بار پیام ورودی را در برابر طرح XSD یا تعریف WSDL تأیید کند. همچنین اگر JSON یا XML نادرست در پیام بارگذاری وجود داشته باشد، رخ می دهد.

steps.messagevalidation.SourceMessageNotAvailable

500

این خطا در صورتی رخ می دهد که متغیری که در عنصر <Source> خط مشی مشخص شده است یکی از این موارد باشد:

خارج از محدوده (در جریان خاصی که سیاست در آن اجرا می شود موجود نیست)
قابل حل نیست (تعریف نشده است)

steps.messagevalidation.NonMessageVariable

500

اگر عنصر <Source> در خط مشی SOAPMessageValidation روی متغیری تنظیم شود که از نوع پیام نیست، این خطا رخ می دهد.

خطاهای استقرار

این خطاها ممکن است زمانی رخ دهند که یک پروکسی حاوی این خط مشی را مستقر می کنید.

نام خطا	علت	ثابت
`InvalidResourceType`	عنصر `<ResourceURL>` در خط مشی SOAPMessageValidation روی یک نوع منبع تنظیم شده است که توسط این خط مشی پشتیبانی نمی شود.
`ResourceCompileFailed`	اسکریپت منبع ارجاع شده در عنصر `<ResourceURL>` خط مشی SOAPMessageValidation حاوی خطایی است که از کامپایل آن جلوگیری می کند.
`RootElementNameUnspecified`	عنصر `<Element>` در خط مشی SOAPMessageValidation حاوی نام عنصر ریشه نیست.
`InvalidRootElementName`	عنصر `<Element>` در خط مشی SOAPMessageValidation حاوی یک نام عنصر ریشه است که برای نامگذاری عنصر معتبر به قوانین XML پایبند نیست.

طرحواره ها

هر نوع خط مشی توسط یک طرح XML ( .xsd ) تعریف می شود. برای مرجع، طرح‌های خط‌مشی در GitHub در دسترس هستند.

خط مشی SOAPMessageValidation

درباره خط مشی اعتبارسنجی پیام

مزایا

ویدیوها

عنصر <MessageValidation>

نحو

خط مشی پیش فرض

نمونه ها

1: اعتبار سنجی XSD

2: اعتبارسنجی SOAP

3: XML/JSON خوش فرم

مرجع عنصر کودک

<DisplayName>

نحو

مثال

<Element>

نحو

مثال 1

مثال 2

<ResourceURL>

نحو

نمونه ها

استفاده از XSD برای اعتبارسنجی

استفاده از WSDL برای اعتبارسنجی

<SOAPMessage>

نحو

مثال

<Source>

نحو

مثال

کدهای خطا

خطاهای زمان اجرا

خطاهای استقرار

خطاهای زمان اجرا

خطاهای استقرار

طرحواره ها

موضوعات مرتبط

عنصر `<MessageValidation>`

`<DisplayName>`

`<Element>`

`<ResourceURL>`

`<SOAPMessage>`

`<Source>`