Bu sayfa, Cloud Translation API ile çevrilmiştir.

SOAPMessageVerify politikası

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. info

SOAPMessageValidation politikası aşağıdakileri yapar:

Tüm XML mesajlarını XSD şemalarıyla doğrular
SOAP mesajlarını bir WSDL tanımına göre doğrular
JSON ve XML mesajlarının düzgün biçimlendirilip biçimlendirilmediğini belirler

Kullanıcı arayüzündeki bu politikanın adı "SOAP Mesaj Doğrulaması" olsa da politika yalnızca SOAP mesajlarını doğrulamaz. Bu bölümde politika "Mesaj Doğrulama Politikası" olarak adlandırılmaktadır.

Mesaj Doğrulama Politikası hakkında

Avantajları

Mesaj doğrulama aşağıdaki avantajları sunar:

API'nizi kullanan uygulama geliştiricilerin isteklerinin uygun olmaması veya eksik olması durumunda geliştiricileri hemen bilgilendirir.
Düzgün şekilde kapatılmayan XML etiketleri gibi isteklerdeki sorunları tespit eder.
Tahmin edilemeyen davranışlara neden olabilecek yapılara sahip XML veya SOAP iletilerini engelleyerek arka uç hizmetlerini korur.
Sorun giderme, forumlarda arama yapma veya teknik desteğe danışmak için harcanan süreyi azaltır.
Doğrulama hatalarını ortadan kaldırmak için geliştiricileri XML şeması WSDL tanımı ile tanışmaya teşvik eder. Böylece, iyi anlaşılmış XML şemaları API dokümanlarınızın önemli bir bileşeni haline gelir.

Videolar

Mesaj Doğrulama Politikası hakkında daha fazla bilgi edinmek için aşağıdaki videoları izleyin:

Video	Açıklama
XML isteğini doğrulama	Mesaj Doğrulama politikasını kullanarak bir API için XML isteğini doğrulayın.
JSON isteğini doğrulama	Mesaj Doğrulama politikasını kullanarak bir API için JSON isteğini doğrulayın.

`<MessageValidation>` öğesi

İleti Doğrulama politikasını tanımlar.

Varsayılan Değer	Aşağıdaki Varsayılan Politika sekmesine bakın.
Zorunlu mu?	İsteğe bağlı
Tür	Karmaşık nesne
Üst Öğe	Yok
Alt Öğeler	`<DisplayName>` `<Element>` `<ResourceURL>` `<SOAPMessage>` `<Source>`

Söz dizimi

<MessageValidation> öğesi şu söz dizimini kullanır:

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

Varsayılan Politika

Aşağıdaki örnekte, Edge kullanıcı arayüzünde akışınıza Mesaj Doğrulama politikası eklediğinizde varsayılan ayarlar gösterilmektedir:

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

Bu öğe, tüm politikalarda ortak olan aşağıdaki özelliklere sahiptir:

Özellik	Varsayılan	Zorunlu mu?	Açıklama
`name`	Yok	Zorunlu	Politikanın dahili adı. `name` özelliğinin değeri harf, sayı, boşluk, kısa çizgi, alt çizgi ve nokta içerebilir. Bu değer 255 karakteri aşamaz. İsteğe bağlı olarak, politikayı yönetim kullanıcı arayüzü proxy düzenleyicisinde farklı, doğal bir dille etiketlemek için `<DisplayName>` öğesini kullanın.
`continueOnError`	yanlış	İsteğe bağlı	Politika başarısız olduğunda hata döndürmek için "false" değerine ayarlayın. Bu, çoğu politika için beklenen bir durumdur. Bir politika başarısız olsa bile akış yürütmenin devam etmesi için değeri "true" olarak ayarlayın.
`enabled`	true	İsteğe bağlı	Politikayı uygulamak için "true" (doğru) değerine ayarlayın. Politikayı "kapalı" hale getirmek için "false" değerine ayarlayın. Politika, bir akışa bağlı kalsa bile zorunlu kılınmaz.
`async`	yanlış	Kullanımdan kaldırıldı	Bu özellik kullanımdan kaldırıldı.

Örnekler

Aşağıdaki örneklerde, Mesaj Doğrulama Politikası'nı kullanabileceğiniz bazı yöntemler gösterilmektedir:

1: XSD Doğrulaması

Bir XML mesaj isteği yükünü XSD şemasıyla doğrulamak için Mesaj Doğrulama politikasını kullanabilirsiniz.

Yeni bir XSD kaynak dosyası oluşturun. Örneğin, "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 Mesaj Doğrulama politikasını proxy uç noktanızın ön akışına ekleyin:

<ResourceURL> öğesini kullanarak XSD kaynak dosyanızın konumunu belirtin. Örneğin:
```
...
  <ResourceURL>xsd://note-schema.xsd</ResourceURL>
...
```
<SOAPMessage> ve <Element> öğelerini politika tanımından kaldırın.

Politika tanımınız aşağıdaki gibi görünmelidir:

<MessageValidation continueOnError="false"
    enabled="true" name="validateXMLRequest">
  <DisplayName>My XML Validator</DisplayName>
  <Properties/>
  <Source>request</Source>
  <ResourceURL>xsd://note-schema.xsd</ResourceURL>
</MessageValidation>

Aşağıdaki örnekte gösterildiği gibi, API proxy'nize mesaj yükü olarak XML'inizi içeren bir POST isteği gönderin:

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 üstbilgisinin "application/xml" olarak ayarlandığını unutmayın.

Ayrıca, yük için bir veri dosyası oluşturabilir ve aşağıdakine benzer bir komutla bu dosyaya referans verebilirsiniz:

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

HTTP 200 yanıtı alırsınız. Hedef uç noktanıza bağlı olarak, istekle ilgili ek ayrıntılar alabilirsiniz. Örneğin, hedef uç noktanız olarak http://httpbin.org/post kullanır ve -v (ayrıntılı) çıkışı belirtirseniz yanıt aşağıdakine benzer olmalıdır:

< 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 doğrulamanızın çalıştığını doğrulamak için isteğinizin gövdesine başka bir etiket eklemeyi deneyin. Örneğin:

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

Doğrulama hatası alırsınız.

2: SOAP Doğrulaması

SOAP mesaj isteği yükü ile WSDL'yi karşılaştırarak doğrulamak için Mesaj Doğrulama politikasını kullanabilirsiniz.

Yeni bir WSDL kaynak dosyası oluşturun. Örneğin, "example-wsdl.wsdl":

Tam WSDL'yi görüntüleme

<?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 Mesaj Doğrulama politikasını proxy uç noktanızın ön akışına ekleyin:
1. <SOAPMessage> öğesinin version özelliğini, doğrulama yapmak istediğiniz SOAP protokolünün sürümüne ayarlayın. Örneğin, "1.1":
```
...
  <SOAPMessage version="1.1"/>
...
```
2. <Element> öğesinin değerini doğrulamak istediğiniz öğeye ayarlayın:
```
...
  <Element namespace="https://example.com/gateway">getID</Element>
...
```
  <Element>, SOAP isteğinin zarfındaki <Body> öğesinin altındaki ilk alt öğeyi belirtir.
  
  namespace özelliğini ilgili alt öğenin ad alanına ayarlayın.
3. <ResourceURL> öğesini kullanarak WSDL kaynak dosyanızın konumunu belirtin. Örneğin:
```
...
  <ResourceURL>wsdl://example-wsdl.wsdl</ResourceURL>
...
```
Politika tanımınız aşağıdaki gibi görünmelidir:
```
<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>
```

Aşağıdaki örnekte gösterildiği gibi, API proxy'nize mesaj yükü olarak SOAP zarfını içeren bir POST isteği gönderin:

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 üstbilgisinin "application/xml" olarak ayarlandığını unutmayın.

Ayrıca, yük için bir veri dosyası oluşturabilir ve aşağıdakine benzer bir komutla bu dosyaya referans verebilirsiniz:

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

HTTP 200 yanıtı alırsınız. Hedef uç noktanıza bağlı olarak, istekle ilgili ek ayrıntılar alabilirsiniz. Örneğin, hedef uç noktanız olarak http://httpbin.org/post kullanıyorsanız yanıt aşağıdakine benzer olmalıdır:

< 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: Düzgün biçimlendirilmiş XML/JSON

Bir JSON veya XML mesaj yayının iyi biçimlendirildiğini onaylamak için Mesaj Doğrulama politikasını kullanabilirsiniz (doğrulama ile aynı değildir). Politika, yapının ve içeriğin kabul edilen standartlara uygun olmasını sağlar. Bunlara aşağıdakiler de dahildir:

Tek bir kök öğe vardır.
İçerikte geçersiz karakterler bulunmamalıdır.
Nesneler ve etiketler düzgün bir şekilde iç içe yerleştirilmiş olmalıdır.
Başlangıç ve bitiş etiketleri eşleşiyor

Doğru biçimlendirilmiş bir XML veya JSON yükünü kontrol etmek için:

SOAP Mesaj Doğrulama politikasını proxy uç noktasınızın ön akışına ekleyin.

<ResourceURL>, <SOAPMessage> ve <Element> öğelerini politika tanımından kaldırın.

Politika tanımınız aşağıdaki gibi görünmelidir:

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

Aşağıdaki örnekte gösterildiği gibi API proxy'nize bir POST isteği gönderin:
```
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 üstbilgisinin "application/json" olarak ayarlandığını görebilirsiniz.

Bir XML dosyasının düzgün biçimlendirilip biçimlendirilmediğini kontrol etmek için mesaj yükü olarak XML'i kullanın ve Content-type değerini "application/xml" olarak ayarlayın.

HTTP 200 yanıtı alırsınız. İyi biçimlendirilmiş XML veya JSON içermeyen bir mesaj yükü gönderdiğinizde steps.messagevalidation.Failed hatası alırsınız.

Alt öğe referansı

Bu bölümde, <MessageValidation> öğesinin alt öğeleri açıklanmaktadır.

`<DisplayName>`

Yönetim kullanıcı arayüzü proxy düzenleyicisinde politikayı farklı ve daha doğal bir adla etiketlemek için name özelliğine ek olarak kullanın.

<DisplayName> öğesi tüm politikalar için ortaktır.

Varsayılan Değer	Yok
Zorunlu mu?	İsteğe bağlı. `<DisplayName>` öğesini atlarsanız politikanın `name` özelliğinin değeri kullanılır
Tür	Dize
Üst Öğe	<`PolicyElement`>
Alt Öğeler	Yok

<DisplayName> öğesi şu söz dizimini kullanır:

Söz dizimi

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

Örnek

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

<DisplayName> öğesinin özelliği veya alt öğesi yoktur.

`<Element>`

Mesajda doğrulanacak öğeyi belirtir. Bu, SOAP isteğinin zarfındaki <Body> öğesinin altındaki ilk alt öğedir.

Varsayılan Değer	sampleObject
Zorunlu mu?	İsteğe bağlı
Tür	Dize
Üst Öğe	`<MessageValidation>`
Alt Öğeler	Yok

<Element> öğesi şu söz dizimini kullanır:

Söz dizimi

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

1. Örnek

Aşağıdaki örnekte, doğrulanacak tek bir öğe tanımlanmaktadır:

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

2. Örnek

Birden fazla <Element> öğesi ekleyerek doğrulanacak birden fazla öğe belirtebilirsiniz:

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

<Element> öğesi şu özelliklere sahiptir:

Özellik	Varsayılan	Zorunlu mu?	Açıklama
`namespace`	"http://sample.com"	İsteğe bağlı	Doğrulanacak öğenin ad alanını tanımlar.

`<ResourceURL>`

Kaynak iletiyi doğrulamak için kullanılacak XSD şemasını veya WSDL tanımını tanımlar.

Varsayılan Değer	wsdl://`display_name`.wsdl
Zorunlu mu?	İsteğe bağlı
Tür	Dize
Üst Öğe	`<MessageValidation>`
Alt Öğeler	Yok

<ResourceURL> öğesi şu söz dizimini kullanır:

Söz dizimi

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

Örnekler

XML dosyası için:

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

WSDL için:

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

<ResourceURL> değeri, API proxy'nizdeki bir kaynak dosyasını işaret etmelidir. HTTP veya HTTPS üzerinden harici kaynaklara referans veremez.

<ResourceURL> için bir değer belirtmezseniz mesaj, Content-type üst bilgisi sırasıyla "application/json" veya "application/xml" ise iyi biçimlendirilmiş JSON ya da XML olup olmadığı açısından kontrol edilir.

<ResourceURL> öğesinin alt öğesi veya özelliği yoktur.

Doğrulama için XSD'leri kullanma

Mesaj Doğrulama politikasıyla doğruladığınız XML yükü başka bir şemaya referans veriyorsa schemaLocation özelliğinde, dahil edilen XSD dosyasının önüne xsd ön ekini eklemeniz gerekir.

Aşağıdaki örnek şema birden fazla XSD'den oluşur:

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

Doğrulama için WSDL'leri kullanma

WSDL'de en az bir şema tanımlanmalıdır. En az bir şemaya referans vermiyorsa İleti Doğrulama Politikası başarısız olur.

Bir şemanın maksimum içe aktarma derinliği 10'dur. İç içe yerleştirilmiş içe aktarma sayısını aşarsanız İleti Doğrulama politikası başarısız olur.

`<SOAPMessage>`

İleti Doğrulama politikasının doğrulama işlemini gerçekleştireceği SOAP sürümünü tanımlar.

Varsayılan Değer	Yok
Zorunlu mu?	İsteğe bağlı
Tür	Yok
Üst Öğe	`<MessageValidation>`
Alt Öğeler	Yok

<SOAPMessage> öğesi şu söz dizimini kullanır:

Söz dizimi

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

Örnek

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

<SOAPMessage> öğesi şu özelliklere sahiptir:

Özellik Varsayılan Zorunlu mu? Açıklama

Özellik	Varsayılan	Zorunlu mu?	Açıklama
`version`	Yok	İsteğe bağlı	Bu politikanın SOAP mesajlarını doğrulamak için kullandığı SOAP sürümü. Geçerli değerler şunlardır: "1.1" "1.2" "1.1/1.2"

version

Yok

İsteğe bağlı

Bu politikanın SOAP mesajlarını doğrulamak için kullandığı SOAP sürümü.

Geçerli değerler şunlardır:

"1.1"
"1.2"
"1.1/1.2"

Daha fazla bilgi için 9 maddede SOAP/1.1'den SOAP 1.2 sürümüne başlıklı makaleyi inceleyin.

`<Source>`

Doğrulanacak kaynak mesajı tanımlar. Bu öğenin değeri, doğrulamak istediğiniz mesajın adıdır.

<Source> ayarını yapmazsanız bu politika varsayılan olarak "mesaj" değerini alır. Bu değer, tüm yük dahil olmak üzere istek mesajının (istek akışında) veya yanıt mesajının (yanıt akışında) tamamını ifade eder. İsteği veya yanıtı belirtmek için bu özelliği açıkça "request" (istek) veya "response" (yanıt) olarak da ayarlayabilirsiniz.

Varsayılan Değer	istek
Zorunlu mu?	İsteğe bağlı
Tür	Dize
Üst Öğe	`<MessageValidation>`
Alt Öğeler	Yok

<Source> öğesi şu söz dizimini kullanır:

Söz dizimi

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

Örnek

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

<Source> değerini "mesaj", "istek" ve "yanıt"ın yanı sıra akışınızdaki herhangi bir mesajın adına da ayarlayabilirsiniz. Ancak bunu yaparsanız bu politika uygulanmadan önce akışınızda bu ada sahip bir özel mesaj oluşturmanız gerekir. Aksi takdirde hata alırsınız.

<Source> değeri mesaj akışında çözülemezse veya mesaj türü olmayan bir değere çözülürse aşağıdakilerden biri gerçekleşir:

Boş bir değerse: Edge bir steps.messagevalidation.SourceMessageNotAvailable hatası atar.
Mesaj türü değilse: Edge bir steps.messagevalidation.NonMessageVariable hatası atar.

<Source> öğesinin özelliği veya alt öğesi yoktur.

Hata kodları

Edge politikalarından döndürülen hatalar, Hata kodu referansı bölümünde açıklandığı gibi tutarlı bir biçime sahiptir.

Bu bölümde, bu politika bir hatayı tetiklediğinde Edge tarafından ayarlanan hata kodları ile hata mesajları ve döndürülen hata mesajları ile Edge tarafından ayarlanan hata değişkenleri açıklanmaktadır. Bu bilgiyi, hataları ele almak için hata kuralları geliştirip geliştirmediğinizi bilmeniz önemlidir. Daha fazla bilgi için Politika hataları hakkında bilmeniz gerekenler ve Hataları işleme bölümlerine bakın.

Çalışma zamanı hataları

Politika yürütüldüğünde bu hatalar ortaya çıkabilir.

Hata kodu HTTP durumu Neden Düzelt

Hata kodu	HTTP durumu	Neden
`steps.messagevalidation.SourceMessageNotAvailable`	500	Bu hata, politikanın `<Source>` öğesinde belirtilen bir değişken şunlardan biriyse ortaya çıkar: kapsam dışında (politikanın yürütüldüğü belirli akışta kullanılamaz) veya çözülemiyor (tanımlanmadı)
`steps.messagevalidation.NonMessageVariable`	500	Bu hata, SOAPMessageValidation politikasındaki `<Source>` öğesi, mesaj türünde olmayan bir değişkene ayarlanırsa ortaya çıkar. Mesaj türü değişkenleri, HTTP isteklerinin ve yanıtlarının tamamını temsil eder. Yerleşik Edge akış değişkenleri `request`, `response` ve `message` mesaj türündedir. Mesaj değişkenleri hakkında daha fazla bilgi için Değişkenler referansı başlıklı makaleyi inceleyin.
`steps.messagevalidation.Failed`	500	Bu hata, SOAPMessageValidation politikası, giriş mesajı yükünü XSD şeması veya WSDL tanımına göre doğrulayamazsa ortaya çıkar. Yük mesajında bozuk JSON veya XML bulunması da bu hataya neden olabilir.

steps.messagevalidation.SourceMessageNotAvailable

500

Bu hata, politikanın <Source> öğesinde belirtilen bir değişken şunlardan biriyse ortaya çıkar:

kapsam dışında (politikanın yürütüldüğü belirli akışta kullanılamaz)
çözülemiyor (tanımlanmadı)

steps.messagevalidation.NonMessageVariable

500

Bu hata, SOAPMessageValidation politikasındaki <Source> öğesi, mesaj türünde olmayan bir değişkene ayarlanırsa ortaya çıkar.

Mesaj türü değişkenleri, HTTP isteklerinin ve yanıtlarının tamamını temsil eder. Yerleşik Edge akış değişkenleri request, response ve message mesaj türündedir. Mesaj değişkenleri hakkında daha fazla bilgi için Değişkenler referansı başlıklı makaleyi inceleyin.

steps.messagevalidation.Failed 500 Bu hata, SOAPMessageValidation politikası, giriş mesajı yükünü XSD şeması veya WSDL tanımına göre doğrulayamazsa ortaya çıkar. Yük mesajında bozuk JSON veya XML bulunması da bu hataya neden olabilir.

Dağıtım hataları

Bu hatalar, bu politikayı içeren bir proxy dağıttığınızda ortaya çıkabilir.

Hata adı	Neden	Düzelt
`InvalidResourceType`	SOAPMessageValidation politikasındaki `<ResourceURL>` öğesi, politika tarafından desteklenmeyen bir kaynak türüne ayarlanmış.
`ResourceCompileFailed`	SOAPMessageValidation politikasının `<ResourceURL>` öğesinde başvurulan kaynak komut dosyası, derlemesini engelleyen bir hata içeriyor.
`RootElementNameUnspecified`	SOAPMessageValidation politikasındaki `<Element>`, kök öğenin adını içermiyor.
`InvalidRootElementName`	SOAPMessageValidation politikasındaki `<Element>` öğesi, geçerli öğe adlandırmaya yönelik XML kurallarına uymayan bir kök öğe adı içeriyor.

Şemalar

Her politika türü bir XML şemasıyla (.xsd) tanımlanır. Referans olarak kullanabileceğiniz politika şemalarını GitHub'da bulabilirsiniz.

SOAPMessageVerify politikası

Mesaj Doğrulama Politikası hakkında

Avantajları

Videolar

<MessageValidation> öğesi

Söz dizimi

Varsayılan Politika

Örnekler

1: XSD Doğrulaması

2: SOAP Doğrulaması

3: Düzgün biçimlendirilmiş XML/JSON

Alt öğe referansı

<DisplayName>

Söz dizimi

Örnek

<Element>

Söz dizimi

1. Örnek

2. Örnek

<ResourceURL>

Söz dizimi

Örnekler

Doğrulama için XSD'leri kullanma

Doğrulama için WSDL'leri kullanma

<SOAPMessage>

Söz dizimi

Örnek

<Source>

Söz dizimi

Örnek

Hata kodları

Çalışma zamanı hataları

Dağıtım hataları

Şemalar

İlgili konular

`<MessageValidation>` öğesi

`<DisplayName>`

`<Element>`

`<ResourceURL>`

`<SOAPMessage>`

`<Source>`