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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
(Новая страница: «==Общие сведения== Операция '''GetSubProductByProductList''' предназначена для получения списка видов п…»)
 
Строка 1: Строка 1:
==Общие сведения==
==Общие сведения==


Операция '''GetSubProductByProductList''' предназначена для получения списка видов продукции, отфильтрованного по указанному продукту. В список попадают только актуальные последние записи (active=true, last=true). Метод поддерживает возможность постраничного вывода. Выполнение операции заканчивается либо возвратом списка видов продукции, либо ошибкой, в случае если параметры запроса не корректны, если запись по запросу не найдена или произошла иная ошибка выполнения запроса.
Операция '''GetSubProductByProductList''' предназначена для получения списка видов продукции (3 уровень иерархического справочника), отфильтрованного по указанному продукту (2 уровень иерархического справочника). В список попадают только актуальные последние записи (active=true, last=true). Метод поддерживает возможность постраничного вывода. Выполнение операции заканчивается либо возвратом списка видов продукции, либо ошибкой, в случае если параметры запроса не корректны, если запись по запросу не найдена или произошла иная ошибка выполнения запроса.
 
<!--===Используемые пространства имён и типы===
===Используемые пространства имён и типы===


{{столбцы}}
{{столбцы}}
Строка 22: Строка 21:
** [[UUID|bs:UUID]]
** [[UUID|bs:UUID]]
** [[ListOptions|bs:ListOptions]]
** [[ListOptions|bs:ListOptions]]
{{столбцы/конец}}
{{столбцы/конец}}-->


==Данные запроса==
===Входные данные===
* параметры выводимого списка.
* идентификатор продукта (2 уровень иерархического справочника)


===Объект getSubProductByProductListRequest===
===Выходные данные===
* данные запрошенного вида продукции (3 уровень иерархического справочника).


Корневой объект запроса.
==Спецификация запроса==
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| [[#Объект ..Request/listOptions|'''listOptions''']] || Параметры запрашиваемого списка. || [[ListOptions|bs:ListOptions]] || 0..1
|-
| '''productGuid''' || Глобальный идентифкатор продукции, по которому производится отбор. || [[UUID|bs:UUID]] || 1
|}
 
===Объект [[#Объект getSubProductByProductListRequest|..Request]]/'''listOptions'''===


Объект содержит параметры запрашиваемого списка продукции.
==Спецификация ответа==
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''count''' || Количество значений в списке.
* По умолчанию значение равно 100;
* Максимально допустимое значение равно 1000.
|| [http://www.w3.org/TR/xmlschema-2/#nonNegativeInteger xs:nonNegativeInteger] || 0..1
|-
| '''offset''' || Смещение в списке относительно начала. || [http://www.w3.org/TR/xmlschema-2/#nonNegativeInteger xs:nonNegativeInteger] || 0..1
|}
 
==Данные ответа==
 
===Объект getSubProductByProductListResponse===
 
Корневой элемент ответа.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| [[#Объект ..Response/subProductList|'''subProductList''']] || Список видов продукции указанной в запросе. || [[SubProductList|prod:SubProductList]] || 1
|}
 
===Объект [[#Объект getSubProductByProductListResponse |..Response]]/'''subProductList'''===
 
Список продукции, полученной в результате запроса.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''[[#Объект ..Response/subProductList/subProduct|subProduct]]''' || Данные о продукции. || [[SubProduct|prod:SubProduct]] || 0..*
|}
 
===Объект [[#Объект getProductByTypeListResponse |..Response]]/[[#Объект ..Response/subProductList|subProductList]]/'''subProduct'''===
 
Описание вида продукции.
 
{{Ветис.API ProductService Subproduct}}


==Описание ошибок==
==Описание ошибок==
Строка 102: Строка 52:
<div class = "mw-collapsible-content">
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
 
                  xmlns:ws="http://api.vetrf.ru/schema/cdm/argus/production/ws-definitions"
                  xmlns:base="http://api.vetrf.ru/schema/cdm/base"
                  xmlns:prod="http://api.vetrf.ru/schema/cdm/argus/production">
  <soapenv:Header/>
  <soapenv:Body>
    <ws:getSubProductByProductListRequest>
      <base:listOptions>
        <base:count>3</base:count>
        <base:offset>2</base:offset>
      </base:listOptions>
      <prod:productGuid>337f79dc-4376-6e33-dabe-d5447913b97d</prod:productGuid>
    </ws:getSubProductByProductListRequest>
  </soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
</syntaxhighlight>
</div>
</div>
Строка 125: Строка 61:
<div class = "mw-collapsible-content">
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
 
  <S:Body xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <ws:getSubProductByProductListResponse xmlns:bs="http://api.vetrf.ru/schema/cdm/base"
                                          xmlns:pro="http://api.vetrf.ru/schema/cdm/argus/production"
                                          xmlns:ws="http://api.vetrf.ru/schema/cdm/argus/production/ws-definitions">
      <pro:subProductList count="3" total="23" offset="2">
        <pro:subProduct>
          <bs:uuid>41e78ed2-f727-ec66-4d76-25fda8c61316</bs:uuid>
          <bs:guid>c7cf9fdc-6b23-def0-dc46-20c124bb793e</bs:guid>
          <bs:active>true</bs:active>
          <bs:last>true</bs:last>
          <bs:status>100</bs:status>
          <bs:createDate>2008-01-01T00:00:00+03:00</bs:createDate>
          <bs:updateDate>2008-01-01T00:00:00+03:00</bs:updateDate>
          <pro:name>курица домашняя: "части тушек обваленные, охлажденные"</pro:name>
          <pro:code>0207131</pro:code>
          <pro:productGuid>337f79dc-4376-6e33-dabe-d5447913b97d</pro:productGuid>
        </pro:subProduct>
        <pro:subProduct>
          <bs:uuid>f73981a2-7c2c-d412-8e89-b3be6a1c15e1</bs:uuid>
          <bs:guid>23175390-cfa2-94a4-8eac-6237f4a47385</bs:guid>
          <bs:active>true</bs:active>
          <bs:last>true</bs:last>
          <bs:status>100</bs:status>
          <bs:createDate>2008-01-01T00:00:00+03:00</bs:createDate>
          <bs:updateDate>2008-01-01T00:00:00+03:00</bs:updateDate>
          <pro:name>курица домашняя: "части тушек необваленные, охлажденные"</pro:name>
          <pro:code>0207132-0207137</pro:code>
          <pro:productGuid>337f79dc-4376-6e33-dabe-d5447913b97d</pro:productGuid>
        </pro:subProduct>
        <pro:subProduct>
          <bs:uuid>ca4a9f4d-3845-4194-d4b6-07f3d8e6f3e0</bs:uuid>
          <bs:guid>4c7ee80b-d421-5239-7d98-a764707b81f8</bs:guid>
          <bs:active>true</bs:active>
          <bs:last>true</bs:last>
          <bs:status>100</bs:status>
          <bs:createDate>2008-01-01T00:00:00+03:00</bs:createDate>
          <bs:updateDate>2008-01-01T00:00:00+03:00</bs:updateDate>
          <pro:name>курица домашняя: "части тушек обваленные мороженые"</pro:name>
          <pro:code>0207141</pro:code>
          <pro:productGuid>337f79dc-4376-6e33-dabe-d5447913b97d</pro:productGuid>
        </pro:subProduct>
      </pro:subProductList>
    </ws:getSubProductByProductListResponse>
  </S:Body>
</soapenv:Envelope>
</syntaxhighlight>
</syntaxhighlight>
</div>
</div>

Версия 22:53, 29 октября 2017

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

Операция GetSubProductByProductList предназначена для получения списка видов продукции (3 уровень иерархического справочника), отфильтрованного по указанному продукту (2 уровень иерархического справочника). В список попадают только актуальные последние записи (active=true, last=true). Метод поддерживает возможность постраничного вывода. Выполнение операции заканчивается либо возвратом списка видов продукции, либо ошибкой, в случае если параметры запроса не корректны, если запись по запросу не найдена или произошла иная ошибка выполнения запроса.

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

  • параметры выводимого списка.
  • идентификатор продукта (2 уровень иерархического справочника)

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

  • данные запрошенного вида продукции (3 уровень иерархического справочника).

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

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

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

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

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

Запрос данных 3 видов продукции со смещением 2 от начала списка.


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

Источник — http://help.vetrf.ru/index.php?title=GetSubProductByProductList_v2.0&oldid=22222