GetSubProductByUuid v2.0: различия между версиями

Версия 15:55, 27 сентября 2020

Общие сведения

Операция GetSubProductByUuid предназначена для получения информации о конкретной версии записи вида продукции (3 уровень иерархического справочника) по её уникальному идентификатору. Выполнение операции заканчивается либо возвратом записи той версии, которая значится под указанным UUID, то есть запись может быть не последней и/или не актуальной (active=false, last=false), либо ошибкой, в случае если параметры запроса не корректны, если запись по запросу не найдена или произошла иная ошибка выполнения запроса.

Входные данные

уникальный идентификатор версии вида продукции.

Выходные данные

данные о виде продукции.

Спецификация запроса

#	Название XML-элемента	Тип	Обязат.	Описание (нажмите [...] для отображения дополнительного описания)
001	<ws:getSubProductByUuidRequest>
002	···<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии вида продукции. третий уровень иерархического справочника продукции ИС Меркурий
003	</ws:getSubProductByUuidRequest>

Спецификация ответа

#	Название XML-элемента	Тип	Обязат.	Описание	Пример
1	<ws:getSubProductByUuidResponse>
2	···<dt:subProduct>	dt:Product	[1..1]	Вид продукции третий уровень иерархического справочника продукции ИС Меркурий
3	······<bs:uuid>	bs:UUID	[1..1]	Идентификатор версии вида продукции.	<bs:uuid>d9078e32-353c-eb56-3839-9bc09e79bdf5</bs:uuid>
4	······<bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор вида продукции.	<bs:guid>bb7ab7a7-4d5c-f81d-50a9-da5bf9bbb1e9</bs:guid>
5	······<bs:active>	xs:boolean	[1..1]	Является ли запись активной: true - запись активна; false - запись не активна.	<bs:active>true</bs:active>
6	······<bs:last>	xs:boolean	[1..1]	Является ли версия записи последней: true - да; false - нет.	<bs:last>true</bs:last>
7	······<bs:status>	bs:VersionStatus	[1..1]	Статус версии записи.	<bs:status>100</bs:status>
8	······<bs:createDate>	xs:DateTime	[1..1]	Дата создания записи.	<bs:createDate>2017-07-07T12:00:00</bs:createDate>
9	······<bs:updateDate>	xs:DateTime	[1..1]	Дата изменения записи.	<bs:updateDate>2017-07-07T12:00:00</bs:updateDate>
10	······<bs:previous>	bs:UUID	[0..1]	Идентификатор предыдущей версии записи.	<bs:previous>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:previous>
11	······<bs:next>	bs:UUID	[0..1]	Идентификатор следующей версии записи.	<bs:next>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:next>
12	······<dt:name>	bs:String255	[1..1]	Название вида продукции.	<dt:name>мясо птицы</dt:name>
13	······<dt:code>	bs:String255	[1..1]	Код ТН ВЭД вида продукции.	<dt:code>0207</dt:code>
14	······<dt:productGuid	bs:UUID	[1..1]	Глобальный идентификатор продукции второй уровень иерархического справочника продукции ИС Меркурий	<dt:productGuid>337f79dc-4376-6e33-dabe-d5447913b97d</dt:productGuid>
15	···</dt:subProduct>
16	</ws:getSubProductByUuidResponse>

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

Ошибка	Описание
InternalServiceFault	Внутренняя ошибка сервиса.
IncorrectRequestFault	Некорректный запрос. Происходит в случае, если запрос не соответствует требованиям указанным в xsd, то есть сообщение не проходит валидацию.
EntityNotFoundFault	Объект с заданными параметрами не найден в базе.

Пример запроса

Запрос данных о виде продукции.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2" xmlns:bs="http://api.vetrf.ru/schema/cdm/base">
   <soapenv:Header/>
   <soapenv:Body>
      <ws:getSubProductByUuidRequest>
         <bs:uuid>d9078e32-353c-eb56-3839-9bc09e79bdf5</bs:uuid>
      </ws:getSubProductByUuidRequest>
   </soapenv:Body>
</soapenv:Envelope>

Ответ на запрос.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
      <v2:getSubProductByUuidResponse xmlns:bs="http://api.vetrf.ru/schema/cdm/base" xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2" xmlns:v2="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2">
         <dt:subProduct>
            <bs:uuid>d9078e32-353c-eb56-3839-9bc09e79bdf5</bs:uuid>
            <bs:guid>bb7ab7a7-4d5c-f81d-50a9-da5bf9bbb1e9</bs:guid>
            <bs:active>true</bs:active>
            <bs:last>true</bs:last>
            <bs:status>100</bs:status>
            <bs:createDate>2008-12-21T21:15:06+03:00</bs:createDate>
            <bs:updateDate>2008-12-21T21:15:06+03:00</bs:updateDate>
            <dt:name>мясо птицы</dt:name>
            <dt:code>0207</dt:code>
            <dt:productGuid>337f79dc-4376-6e33-dabe-d5447913b97d</dt:productGuid>
         </dt:subProduct>
      </v2:getSubProductByUuidResponse>
   </soap:Body>
</soapenv:Envelope>

@@ Строка 30: / Строка 30: @@
 ! Тип
 ! Обязат.
-! Описание
+! Описание (нажмите [...] для отображения дополнительного описания)
-! Пример
 |-
-|1
+|001
-|style="font-weight: bold; font-family: Courier;" |<ws:getSubProductByUuidRequest>
+|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''<ws:getSubProductByUuidRequest>'''}}
 |
 |
-|
+| style="width:52em;"|
-|style="font-family: Courier;" |
 |-
-|2
+|002
-|style="font-weight: bold; font-family: Courier;" |···<bs:uuid>
+|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|bs:}}uuid>'''}}{{color|#131313|UUID}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}uuid>'''}}
 |[[UUID|bs:UUID]]
 |[1..1]
-|Идентификатор версии вида продукции
+|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
-* третий уровень иерархического справочника продукции ИС Меркурий
+<span style="white-space:nowrap; font-weight: normal;">Идентификатор версии вида продукции.
-|style="font-family: Courier;" |<bs:uuid>d9078e32-353c-eb56-3839-9bc09e79bdf5</bs:uuid>
+</span>
+<div class="mw-collapsible-content" style="font-weight: normal;">
+* третий уровень иерархического справочника продукции ИС Меркурий</div>
+</div>
 |-
-|3
+|003
-|style="font-weight: bold; font-family: Courier;" |</ws:getSubProductByUuidRequest>
+|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''</ws:getSubProductByUuidRequest>'''}}
-|
 |
 |
-|style="font-family: Courier;" |
+| style="width:52em;"|
 |-
 |}