Сообщение отчета сообщает вызывающей стороне об окончании обработки полученных сообщений. Элемент «code» содержит код ошибки, элемент «description» - описание ошибки.

Таблица 2.1


Наименование элемента

Описание

ZWSA_DOCUMENTS. Response →code

Код ошибки (int)

ZWSA_DOCUMENTS. Response →description

Описание ошибки

ZWSA_DOCUMENTS. Response →docid

Идентификатор документа (long)


Пример сообщения
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas. xmlsoap. org/soap/envelope/"><SOAP-ENV:Header/><SOAP-ENV:Body>                <urn: ZWSA_DOCUMENTS. Response xmlns:urn="urn:sap-com:document:sap:rfc:functions">   <docid>57611591</docid>   <code>0</code>

  <description>ok</description>

               </urn: ZWSA_DOCUMENTS. Response>        </soapenv:Body> </soapenv:Envelope>


Описание ошибок и их кодов

Code

Description

-1

Неизвестная ошибка

0

Запрос успешно обработан


Приложение 1. WSDL описание сервиса


<definitions xmlns="http://schemas. xmlsoap. org/wsdl/" xmlns:s0="urn:sap-com:document:sap:rfc:functions" xmlns:xsd="http://www. w3.org/2001/XMLSchema"xmlns:soap="http://schemas. xmlsoap. org/wsdl/soap/" xmlns:http="http://schemas. xmlsoap. org/wsdl/http/" targetNamespace="urn:sap-com:document:sap:rfc:functions"> <types> <xsd:schema targetNamespace="urn:sap-com:document:sap:rfc:functions"> <xsd:element name="ZWSA_DOCUMENTS"> <xsd:complexType> <xsd:all> <xsd:element name="BIN" minOccurs="0" type="xsd:string"/> <xsd:element name="ETDDOCID" minOccurs="0" type="xsd:string"/> <xsd:element name="FORMNAME" minOccurs="0" type="xsd:string"/> <xsd:element name="XML" minOccurs="0" type="xsd:string"/> </xsd:all> </xsd:complexType> </xsd:element> <xsd:element name="ZWSA_DOCUMENTS. Response"> <xsd:complexType> <xsd:all> <xsd:element name="CODE" type="xsd:string"/> <xsd:element name="DESCRIPTION" type="xsd:string"/> <xsd:element name="DOCID" type="xsd:string"/> </xsd:all> </xsd:complexType> </xsd:element> </xsd:schema> </types> <message name="ZWSA_DOCUMENTSInput"> <part name="parameters" element="s0:ZWSA_DOCUMENTS"/> </message> <message name="ZWSA_DOCUMENTSOutput"> <part name="parameters" element="s0:ZWSA_DOCUMENTS. Response"/> </message> <portType name="ZWSA_DOCUMENTSPortType"> <operation name="ZWSA_DOCUMENTS"> <input message="s0:ZWSA_DOCUMENTSInput"/> <output message="s0:ZWSA_DOCUMENTSOutput"/> </operation> </portType> <binding name="ZWSA_DOCUMENTSBinding" type="s0:ZWSA_DOCUMENTSPortType"> <soap:binding style="document" transport="http://schemas. xmlsoap. org/soap/http"/> <operation name="ZWSA_DOCUMENTS"> <soap:operation soapAction="http://www. /ZWSA_DOCUMENTS"/> <input> <soap:body use="literal"/> </input> <output> <soap:body use="literal"/> </output> </operation> </binding> <service name="ZWSA_DOCUMENTSService"> <documentation>SAP Service ZWSA_DOCUMENTS via SOAP</documentation> <port name="ZWSA_DOCUMENTSPortType" binding="s0:ZWSA_DOCUMENTSBinding"> <soap:address location="http://sapws. :8037/sap/bc/soap/rfc"/> </port> </service> </definitions>

Спецификация на сервис передачи данных документа

НЕ нашли? Не то? Что вы ищете?

Предисловие.

Данный документ является нормативным и должен применяться для реализации и использования функциональности SOAP сервиса. Документ содержит формат и структуру XML сообщений запроса и ответа, и описание сервиса. Структура описывается поэлементно с сохранением вложенности.

Технические требования

Список технических требований к сервису:

    Предоставить автоматически генерируемый ресурс описывающий сервис в формате WSDL v.1.1. Блокировать на время прием со стороны клиентов передающих дубликаты одинаковых сообщений для снижения нагрузки на сервис.

Список технических требований к клиенту:

Снизить к минимуму количество дубликатов одинаковых сообщений передаваемых сервису при помощи интерпретации сообщений отчетов; Все передаваемые сообщения должны соответствовать описанному в данном документе формату; Вызывающая сторона должна корректно обработать сообщение отчета и выполнить определенные действия на основе интерпретированных данных; Сообщение должны передаваться в кодировке UNICODE в частности UTF-8. Использовать вызов на основании спецификации SOAP версии 1.1 .

Описание формата и структуры сообщений

Формат и структура сообщений участвующих в процессе коммуникации SOAP сервиса описаны на основании спецификации XML Schema 1.1 . XML схема вложена в описание сервиса формата WSDL (Приложение 1).

Сервис передачи данных документа

Данный сервис используется для передачи данных документов

Формат и структура сообщения данных

Вложенность элементов указывается через «→». Вложенность не должна быть нарушена.

Номер поля в форме

Наименование элемента

Тип

Формат

Обязат ельность

Описание поля

1

DocdataRequest ->DOCID

Long

Да

Идентификатор корректируемого документа

2

DocdataRequest ->FORMNAME

String

Да

Наименование документа

3

DocdataRequest ->XML

String

Да

Модель данных документа

4

DocdataRequest ->BIN

String

Да

Документ в base64-gzip


Пример сообщения запроса



Пример сообщения

<soapenv:Envelope xmlns:soapenv="http://schemas. xmlsoap. org/soap/envelope/" xmlns:sign="http://www. ru/wwwsign">

       <soapenv:Header/>

       <soapenv:Body>

               <sign:DocdataRequest>

<DOCID>57611591</DOCID>

<FORMNAME>Пакет документов</FORMNAME>

<DOCDATA><![CDATA[<data><formname>Пакет документов</formname><serviceTag1>2</serviceTag1><serviceTag2/></data>]]></DOCDATA>

<BIN>application/vnd. xfdl;content-encoding="base64-gzip"

H4sIAAAAAAAAAO19eXMjyXXn3+anKFERYtNssu4C0M3GCDybzZsET4WCUQCKIJoACo2DBPjXaGxJdlixs5Ylr9ZrnetY78buhltzWKMZz8xXAL/CfpLNrCoAdWRWZeEoAN05HdONqnp5vXz58vi9fG/56HfTLOinJOtZZaIE3Ra2YSBx31FrcIta3muUhn9TCSnzITwJjVrk7bEv+hH8Yo950yr+XjnyGwSxUNp+WLd7sINg6xhWfSD536rBDhz+wiaBvOorEl/1Hc3NKJvsm7zrS+wLBs+mVeIdQoMW9q4BIM78r+MpJT7e4QBvcufBl2X2fGNtJ/n/AcPmYjr9yAMA</BIN>

               <sign:DocdataRequest>

       </soapenv:Body>

</soapenv:Envelope>


Пример сообщения ответа



Пример сообщения

<soapenv:Envelope xmlns:soapenv="http://schemas. xmlsoap. org/soap/envelope/" xmlns:sign="http://www. ru/wwwsign">

       <soapenv:Header/>

       <soapenv:Body>

               <sign:DocdataResponse>

<docid>57611591</docid>

<code>0</code>

<description>ok</description>

               <sign:DocdataResponse>

       </soapenv:Body>

</soapenv:Envelope>


    Описание ошибок и их кодов

Code

Description

-1

Неизвестная ошибка

0

Запрос успешно обработан


Приложение 1

<wsdl:definitions xmlns:wsdl="http://schemas. xmlsoap. org/wsdl/" xmlns:sch="http://www. ru/wwwsign" xmlns:soap="http://schemas. xmlsoap. org/wsdl/soap/"xmlns:tns="http://www. ru/wwwsign" targetNamespace="http://www. ru/wwwsign">

<wsdl:types>

<schema xmlns="http://www. w3.org/2001/XMLSchema" attributeFormDefault="unqualified" elementFormDefault="unqualified" targetNamespace="http://www. ru/wwwsign">

<element name="SignRequest">

<complexType>

<sequence>

<element name="DOCID" type="string"/>

<element minOccurs="0" name="FINISHED" type="int"/>

<element minOccurs="0" name="FIO" type="string"/>

<element name="FORMNAME" type="string"/>

<element minOccurs="0" name="PACKAGEID" type="string"/>

<element minOccurs="0" name="POST" type="string"/>

<element minOccurs="0" name="POSTANDNAME" type="string"/>

<element minOccurs="0" name="POSTREJECT" type="string"/>

<element minOccurs="0" name="REASON" type="string"/>

<element name="SIGNDATE" type="string"/>

<element minOccurs="0" name="SIGNNUM" type="int"/>

<element name="SIGNTIME" type="string"/>

</sequence>

</complexType>

</element>

<element name="SignResponse">

<complexType>

<sequence>

<element name="code" type="int"/>

<element name="description" type="string"/>

</sequence>

</complexType>

</element>

<element name="DocdataRequest">

<complexType>

<sequence>

<element name="DOCID" type="long"/>

<element name="FORMNAME" type="string"/>

<element name="XML" type="string"/>

<element name="BIN" type="string"/>

</sequence>

</complexType>

</element>

<element name="DocdataResponse">

<complexType>

<sequence>

<element name="code" type="int"/>

<element name="description" type="string"/>

<element name="docid" type="long"/>

</sequence>

</complexType>

</element>

</schema>

</wsdl:types>

<wsdl:message name="SignRequest">

<wsdl:part element="tns:SignRequest" name="SignRequest"></wsdl:part>

</wsdl:message>

<wsdl:message name="DocdataResponse">

<wsdl:part element="tns:DocdataResponse" name="DocdataResponse"></wsdl:part>

</wsdl:message>

<wsdl:message name="SignResponse">

<wsdl:part element="tns:SignResponse" name="SignResponse"></wsdl:part>

</wsdl:message>

<wsdl:message name="DocdataRequest">

<wsdl:part element="tns:DocdataRequest" name="DocdataRequest"></wsdl:part>

</wsdl:message>

<wsdl:portType name="SignWww">

<wsdl:operation name="Sign">

<wsdl:input message="tns:SignRequest" name="SignRequest"></wsdl:input>

<wsdl:output message="tns:SignResponse" name="SignResponse"></wsdl:output>

</wsdl:operation>

<wsdl:operation name="Docdata">

<wsdl:input message="tns:DocdataRequest" name="DocdataRequest"></wsdl:input>

<wsdl:output message="tns:DocdataResponse" name="DocdataResponse"></wsdl:output>

</wsdl:operation>

</wsdl:portType>

<wsdl:binding name="SignWwwSoap11" type="tns:SignWww">

<soap:binding style="document" transport="http://schemas. xmlsoap. org/soap/http"/>

<wsdl:operation name="Sign">

<soap:operation soapAction=""/>

<wsdl:input name="SignRequest">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="SignResponse">

<soap:body use="literal"/>

</wsdl:output>

</wsdl:operation>

<wsdl:operation name="Docdata">

<soap:operation soapAction=""/>

<wsdl:input name="DocdataRequest">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="DocdataResponse">

<soap:body use="literal"/>

</wsdl:output>

</wsdl:operation>

</wsdl:binding>

<wsdl:service name="SignWwwService">

<wsdl:port binding="tns:SignWwwSoap11" name="SignWwwSoap11">

<soap:address location="http://адрес_сервера/WWW/SignWww/services"/>

</wsdl:port>

</wsdl:service>

</wsdl:definitions>



Из за большого объема этот материал размещен на нескольких страницах:
1 2 3 4 5 6 7