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

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


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


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


===[[#Объект getSubProductChangesListRequest|Входные данные]]===
===Входные данные===
* параметры запрашиваемого списка;
* параметры запрашиваемого списка;
* интервал дат, за которые нужно получить изменения.
* интервал дат, за которые нужно получить изменения.


===[[#Объект getSubProductChangesListResponse|Выходные данные]]===
===Выходные данные===
* список видов продукции, изменённых за указанный период времени.
* список видов продукции, изменённых за указанный период времени.


==Данные запроса==
==Спецификация запроса==
 
===Объект getSubProductChangesListRequest===
 
Корневой элемент запроса.
{| class="wikitable"
{| class="wikitable"
! #
! Название XML-элемента
! Тип
! Обязат.
! Описание (нажмите [...] для отображения дополнительного описания)
|-
|001
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''<ws:getSubProductChangeListRequest>'''}}
|
|
| style="width:52em;"|
|-
|002
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|bs:}}listOptions>'''}}
|[[ListOptions|bs:ListOptions]]
|[0..1]
| style="width:52em;"| Параметры запрашиваемого списка.
|-
|-
! Поле !! Описание !! Тип данных !! Обязательность
|003
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|bs:}}count>'''}}{{color|#131313|10}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}count>'''}}
|[http://www.w3.org/TR/xmlschema-2/#nonNegativeInteger xs:nonNegativeInteger]
|[0..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;">Максимальное запрашиваемое количество объектов в списке.
</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
* По умолчанию значение 100;
* Максимально возможное значение 1000.</div>
</div>
|-
|-
| [[#Объект ..Request/listOptions|'''listOptions''']] || Параметры запрашиваемого списка. || [[ListOptions|bs:ListOptions]] || 0..1
|004
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|bs:}}offset>'''}}{{color|#131313|2}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}offset>'''}}
|[http://www.w3.org/TR/xmlschema-2/#nonNegativeInteger xs:nonNegativeInteger]
|[0..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;">Номер элемента, по которому осуществляется смещение первого элемента списка.  
</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
* По умолчанию значение 0.</div>
</div>
|-
|005
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''</{{color|#660e7a|bs:}}listOptions>'''}}
|
|
| style="width:52em;"|
|-
|006
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|bs:}}updateDateInterval>'''}}
|[[DataInterval|bs:DataInterval]]
|[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;"> Интервал времени обновления.
</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
* В список попадают все записи, дата обновлений которых попадает в указанный интервал.</div>
</div>
|-
|007
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|bs:}}beginDate>'''}}{{color|#131313|2017-07-07T00:00:00}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}beginDate>'''}}
|[http://www.w3.org/TR/xmlschema-2/#dateTime xs:dateTime]
|[1..1]
| style="width:52em;"| Начало временного интервала.
|-
|008
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|bs:}}endDate>'''}}{{color|#131313|2017-07-25T00:00:00}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}endDate>'''}}
|[http://www.w3.org/TR/xmlschema-2/#dateTime xs:dateTime]
|[0..1]
| style="width:52em;"| Конец временного интервала.
|-
|009
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''</{{color|#660e7a|bs:}}updateDateInterval>'''}}
|
|
| style="width:52em;"|
|-
|010
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''</ws:getSubProductChangeListRequest>'''}}
|
|
| style="width:52em;"|
|-
|-
| [[#Объект ..Request/updateDateInterval|'''updateDateInterval''']] || Интервал дат, за которые запрашивают изменения. || [[DateInterval|bs:DateInterval]] || 1
|}
|}


===Объект [[#Объект getSubProductChangesListRequest|..Request]]/'''listOptions'''===
==Спецификация ответа==
 
Объект содержит параметры запрашиваемого списка видов продукции.
 
{| class="wikitable"
{| class="wikitable"
! #
! Название XML-элемента
! Тип
! Обязат.
! Описание (нажмите [...] для отображения дополнительного описания)
|-
|001
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''<ws:getSubProductChangeListResponse>'''}}
|
|
| style="width:52em;"|
|-
|-
! Поле !! Описание !! Тип данных !! Обязательность
|002
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|dt:}}subProductList {{color|Red|total&#61;}}{{color|#007f15|"2"}} {{color|Red|offset&#61;}}{{color|#007f15|"0"}} {{color|Red|count&#61;}}{{color|#007f15|"2"}}>'''}}
|[[SubProductList_v2.0|dt:SubProductList]]
|[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;">Список видов продукции.
</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
* total - всего записей;
* offset - смещение относительно первого элемента;
* count - количество выводимых записей.</div>
</div>
|-
|-
| '''count''' || Количество значений в списке.
|003
* По умолчанию значение равно 100;
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|dt:}}subProduct>'''}}
* Максимально допустимое значение равно 1000.
|[[SubProduct_v2.0|dt:SubProduct]]
|| [http://www.w3.org/TR/xmlschema-2/#nonNegativeInteger xs:nonNegativeInteger] || 0..1
|[0..*]
|<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;">Вид продукции.
</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
* третий уровень иерархического справочника продукции ИС Меркурий</div>
</div>
|-
|-
| '''offset''' || Смещение в списке относительно начала. || [http://www.w3.org/TR/xmlschema-2/#nonNegativeInteger xs:nonNegativeInteger] || 0..1
|004
|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]
| style="width:52em;"| Идентификатор версии вида продукции.
|-
|-
|}
|005
 
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|GUID}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}}
===Объект [[#Объект getSubProductChangesListRequest|..Request]]/'''updateDateInterval'''===
|[[UUID|bs:UUID]]
 
|[1..1]
Объект содержит данные об интервале дат, за которые происходили изменения.
| style="width:52em;"| Глобальный идентификатор вида продукции.
 
|-
{| class="wikitable"
|006
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|bs:}}active>'''}}{{color|#131313|true}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}active>'''}}
|[http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean]
|[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;">Описание, является ли запись активной.
</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
* true - запись активна;
* false - запись не активна.</div>
</div>
|-
|007
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|bs:}}last>'''}}{{color|#131313|true}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}last>'''}}
|[http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean]
|[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;">Описание, является ли версия записи последней.
</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
* true - да;
* false - нет. </div>
</div>
|-
|008
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|bs:}}status>'''}}{{color|#131313|100}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}status>'''}}
|[[VersionStatus|bs:VersionStatus]]
|[1..1]
| style="width:52em;"| Статус версии записи.
|-
|009
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|bs:}}createDate>'''}}{{color|#131313|2017-07-07T12:00:00}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}createDate>'''}}
|[http://www.w3.org/TR/xmlschema-2/#DateTime xs:DateTime]
|[1..1]
| style="width:52em;"| Дата создания записи.
|-
|010
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|bs:}}updateDate>'''}}{{color|#131313|2017-07-07T12:00:00}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}updateDate>'''}}
|[http://www.w3.org/TR/xmlschema-2/#DateTime xs:DateTime]
|[1..1]
| style="width:52em;"| Дата изменения записи.
|-
|011
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|bs:}}previous>'''}}{{color|#131313|UUID}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}previous>'''}}
|[[UUID|bs:UUID]]
|[0..1]
| style="width:52em;"| Идентификатор предыдущей версии записи.
|-
|012
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|bs:}}next>'''}}{{color|#131313|UUID}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}next>'''}}
|[[UUID|bs:UUID]]
|[0..1]
| style="width:52em;"| Идентификатор следующей версии записи.
|-
|-
! Поле !! Описание !! Тип данных !! Обязательность
|013
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}name>'''}}{{color|#131313|мясо птицы}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}name>'''}}
|[[String255|bs:String255]]
|[1..1]
| style="width:52em;"| Название вида продукции.
|-
|-
| '''beginDate''' || Начальная дата интервала. || [http://www.w3.org/TR/xmlschema-2/#dateTime xs:dateTime] || 1
|014
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}code>'''}}{{color|#131313|0207}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}code>'''}}
|[[String255|bs:String255]]
|[1..1]
| style="width:52em;"| Код ТН ВЭД вида продукции.
|-
|-
| '''endDate''' || Конечная дата интервала.
|015
* Если конечная дата не указана, то по умолчанию берётся текущая дата.
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}productGuid>'''}}{{color|#131313|GUID}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}productGuid>'''}}
|| [http://www.w3.org/TR/xmlschema-2/#dateTime xs:dateTime] || 0..1
|[[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;">Глобальный идентификатор продукции.
 
</span>
===Объект getSubProductChangesListResponse===
<div class="mw-collapsible-content" style="font-weight: normal;">
 
* второй уровень иерархического справочника продукции ИС Меркурий</div>
Корневой элемент ответа.
</div>
 
{| class="wikitable"
|-
|-
! Поле !! Описание !! Тип данных !! Обязательность
|016
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''</{{color|#660e7a|dt:}}subProduct>'''}}
|
|
| style="width:52em;"|
|-
|-
| [[#Объект ..Response/subProductList|'''subProductList''']] || Список продукции выбранного типа. || [[SubProductList|prod:SubProductList]] || 1
|017
|}
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''</{{color|#660e7a|dt:}}subProductList>'''}}
 
|
'''Атрибуты списка subProductList'''
|
 
| style="width:52em;"|
{{Ветис.API EntityList Attributes}}
 
===Объект [[#Объект getSubProductChangesListResponse |..Response]]/'''subProductList'''===
 
Список видов продукции, полученной в результате запроса.
 
{| class="wikitable"
|-
|-
! Поле !! Описание !! Тип данных !! Обязательность
|018
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''</ws:getSubProductChangeListResponse>'''}}
|
|
| style="width:52em;"|
|-
|-
| '''[[#Объект ..Response/subProductList/subProduct|subProduct]]''' || Данные о продукции. || [[SubProduct|prod:SubProduct]] || 0..*
|}
|}
===Объект [[#Объект getSubProductChangesListResponse |..Response]]/[[#Объект ..Response/subProductList|subProductList]]/'''subProduct'''===
Описание вида продукции.
{{Ветис.API ProductService Subproduct|1}}


==Описание ошибок==
==Описание ошибок==
Строка 124: Строка 276:
|}
|}


==Примеры запросов==
==Пример запроса==
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Запрос списка первых трех изменённых видов продукции с 01.01.2016 по текущий день, без смещения.
<div class = "mw-collapsible-content">
<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">
  <soapenv:Header/>
  <soapenv:Body>
    <ws:getSubProductChangesListRequest>
      <base:listOptions>
        <base:count>3</base:count>
        <base:offset>0</base:offset>
      </base:listOptions>
      <base:updateDateInterval>
        <base:beginDate>2016-01-01</base:beginDate>
        <base:endDate></base:endDate>
      </base:updateDateInterval>
    </ws:getSubProductChangesListRequest>
  </soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
</div>
</div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Ответ на запрос.
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <ws:getSubProductChangesListResponse 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="57" offset="0">
        <pro:subProduct>
          <bs:uuid>180e80cb-96bc-b51a-e03e-5eb90d29cbde</bs:uuid>
          <bs:guid>20824271-2c13-e259-8525-48bf8aaa97ef</bs:guid>
          <bs:active>true</bs:active>
          <bs:last>true</bs:last>
          <bs:status>100</bs:status>
          <bs:createDate>2016-09-08T17:55:09+03:00</bs:createDate>
          <bs:updateDate>2016-09-08T17:55:09+03:00</bs:updateDate>
          <pro:name>барда кормовая</pro:name>
          <pro:code>2303</pro:code>
          <pro:productGuid>cbd7826f-5470-1425-544f-3064651514ae</pro:productGuid>
          </pro:subProduct>
        <pro:subProduct>
          <bs:uuid>d17a6541-583e-5c65-4c96-cf047e6ac6d4</bs:uuid>
          <bs:guid>31849753-bbe2-61b3-5b71-23426e5d7342</bs:guid>
          <bs:active>true</bs:active>
          <bs:last>true</bs:last>
          <bs:status>100</bs:status>
          <bs:createDate>2016-09-08T17:55:09+03:00</bs:createDate>
          <bs:updateDate>2016-09-08T17:55:09+03:00</bs:updateDate>
          <pro:name>вика</pro:name>
          <pro:code>1214</pro:code>
          <pro:productGuid>cbd7826f-5470-1425-544f-3064651514ae</pro:productGuid>
        </pro:subProduct>
        <pro:subProduct>
          <bs:uuid>0f2b9965-7c56-2751-6c42-16cdceb445c6</bs:uuid>
          <bs:guid>13bfab8b-deb8-0bc7-8328-3f8b956949a2</bs:guid>
          <bs:active>true</bs:active>
          <bs:last>true</bs:last>
          <bs:status>100</bs:status>
          <bs:createDate>2016-09-08T17:55:09+03:00</bs:createDate>
          <bs:updateDate>2016-09-08T17:55:09+03:00</bs:updateDate>
          <pro:name>капуста кормовая</pro:name>
          <pro:code>1214</pro:code>
          <pro:productGuid>cbd7826f-5470-1425-544f-3064651514ae</pro:productGuid>
        </pro:subProduct>
      </pro:subProductList>
    </ws:getSubProductChangesListResponse>
  </S:Body>
</soapenv:Envelope>
</syntaxhighlight>
</div>
</div>


<br />
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Запрос списка первых пяти изменённых видов продукции с 21.02.2015 по 06.10.2015, со смещением равным трем.
Запрос списка первых трех изменённых видов продукции с 20.10.2016 по текущий день без смещения.
<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/"  
<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">
                  xmlns:ws="http://api.vetrf.ru/schema/cdm/argus/production/ws-definitions"  
  <soapenv:Header/>
                  xmlns:base="http://api.vetrf.ru/schema/cdm/base">
  <soapenv:Body>
  <soapenv:Header/>
      <ws:getSubProductChangesListRequest>
  <soapenv:Body>
        <bs:listOptions>
    <ws:getSubProductChangesListRequest>
            <bs:count>3</bs:count>
      <base:listOptions>
            <bs:offset>0</bs:offset>
        <base:count>5</base:count>
        </bs:listOptions>
        <base:offset>3</base:offset>
        <bs:updateDateInterval>
      </base:listOptions>
            <bs:beginDate>2016-10-20T00:00:00</bs:beginDate>
      <base:updateDateInterval>
        </bs:updateDateInterval>  
        <base:beginDate>2015-02-21</base:beginDate>
      </ws:getSubProductChangesListRequest>
        <base:endDate>2015-10-06</base:endDate>
  </soapenv:Body>
      </base:updateDateInterval>
    </ws:getSubProductChangesListRequest>
  </soapenv:Body>
</soapenv:Envelope>
</soapenv:Envelope>
</syntaxhighlight>
</syntaxhighlight>
Строка 236: Строка 305:
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
       <ws:getSubProductChangesListResponse 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">
       <v2:getSubProductChangesListResponse 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">
         <pro:subProductList count="5" total="92" offset="3">
         <dt:subProductList count="3" total="946" offset="0">
             <pro:subProduct>
             <dt:subProduct>
               <bs:uuid>55990442-66a7-4146-9f7f-f3d4ce0d0727</bs:uuid>
               <bs:uuid>c51f5855-ea43-116e-3a5b-f7dcd2766d8a</bs:uuid>
               <bs:guid>90720b98-0605-4453-b006-ae30acdec1b4</bs:guid>
               <bs:guid>2160cc9f-0380-6200-dce9-0f0b3c86a8aa</bs:guid>
               <bs:active>true</bs:active>
               <bs:active>false</bs:active>
               <bs:last>true</bs:last>
               <bs:last>false</bs:last>
               <bs:status>100</bs:status>
               <bs:status>100</bs:status>
               <bs:createDate>2015-03-02T17:11:14+03:00</bs:createDate>
               <bs:createDate>2008-01-01T00:00:00+03:00</bs:createDate>
               <bs:updateDate>2015-03-02T17:11:14+03:00</bs:updateDate>
               <bs:updateDate>2016-11-11T14:03:00+03:00</bs:updateDate>
               <pro:name>инкубационное яйцо кур СПФ</pro:name>
               <bs:next>619e5808-3262-4c19-aaa3-77ce377524ee</bs:next>
               <pro:code>0407</pro:code>
              <dt:name>молочная паста</dt:name>
               <pro:productGuid>6037d907-19c7-b1f1-37be-712f9f4bf5ed</pro:productGuid>
               <dt:code>0405</dt:code>
             </pro:subProduct>
               <dt:productGuid>686b55f7-c199-9788-5ee5-a755eb2b8d2a</dt:productGuid>
             <pro:subProduct>
             </dt:subProduct>
               <bs:uuid>f2cfd513-fd43-4c6d-b2eb-230cf024d127</bs:uuid>
             <dt:subProduct>
               <bs:guid>633ae86b-0602-4e16-9fd5-0b22d3dc8a8e</bs:guid>
               <bs:uuid>6d71c9e1-3cf4-2afb-9d9a-75ea2ab95a12</bs:uuid>
               <bs:active>true</bs:active>
               <bs:guid>c847eca1-641f-24e7-a44a-c71c28fb377f</bs:guid>
               <bs:last>true</bs:last>
               <bs:active>false</bs:active>
               <bs:last>false</bs:last>
               <bs:status>100</bs:status>
               <bs:status>100</bs:status>
               <bs:createDate>2015-03-10T10:28:13+03:00</bs:createDate>
               <bs:createDate>2008-01-01T00:00:00+03:00</bs:createDate>
               <bs:updateDate>2015-03-10T10:28:13+03:00</bs:updateDate>
               <bs:updateDate>2017-03-10T10:06:36+03:00</bs:updateDate>
               <pro:name>салака соленая пряного посола</pro:name>
               <bs:next>4a6238db-dda6-4b51-8910-6d1cc6e63d69</bs:next>
               <pro:code>1604</pro:code>
              <dt:name>икра лососевых пород рыб мороженая соленая</dt:name>
               <pro:productGuid>46fde18a-f6af-f7b0-de47-044281271112</pro:productGuid>
               <dt:code>1604</dt:code>
             </pro:subProduct>
               <dt:productGuid>46fde18a-f6af-f7b0-de47-044281271112</dt:productGuid>
             <pro:subProduct>
             </dt:subProduct>
               <bs:uuid>b86ea789-12bd-43be-a814-a56dc82627f1</bs:uuid>
             <dt:subProduct>
               <bs:guid>37d4e7c8-3823-41a2-b32e-1beed138222e</bs:guid>
               <bs:uuid>b694de27-45e0-ea26-c936-684f7db0dfd4</bs:uuid>
               <bs:active>true</bs:active>
               <bs:guid>799e561f-4228-9bd5-fa45-11a6db084dfc</bs:guid>
               <bs:last>true</bs:last>
               <bs:active>false</bs:active>
               <bs:last>false</bs:last>
               <bs:status>100</bs:status>
               <bs:status>100</bs:status>
               <bs:createDate>2015-03-11T09:10:13+03:00</bs:createDate>
               <bs:createDate>2009-11-17T14:45:40+03:00</bs:createDate>
               <bs:updateDate>2015-03-11T09:10:13+03:00</bs:updateDate>
               <bs:updateDate>2016-11-11T14:03:00+03:00</bs:updateDate>
              <pro:name>фарш кальмаровый варено-мороженый</pro:name>
               <bs:next>097c5951-aae6-4e1a-9152-cca3f9f8d295</bs:next>
              <pro:code>1605</pro:code>
               <dt:name>белок молочный сухой</dt:name>
              <pro:productGuid>f47dfeee-1673-22fe-9fb6-fa84247a9ebd</pro:productGuid>
               <dt:code>3504</dt:code>
            </pro:subProduct>
               <dt:productGuid>686b55f7-c199-9788-5ee5-a755eb2b8d2a</dt:productGuid>
            <pro:subProduct>
             </dt:subProduct>
              <bs:uuid>3baa715c-da87-4cf5-ad74-4fe142ff85dd</bs:uuid>
         </dt:subProductList>
              <bs:guid>2dbdc467-eb84-4c90-9b90-a4f7fef91843</bs:guid>
       </v2:getSubProductChangesListResponse>
              <bs:active>true</bs:active>
   </soap:Body>
              <bs:last>true</bs:last>
              <bs:status>100</bs:status>
              <bs:createDate>2015-03-13T13:18:01+03:00</bs:createDate>
              <bs:updateDate>2015-03-13T13:18:01+03:00</bs:updateDate>
              <pro:name>мангуст карликовый</pro:name>
              <pro:code>0106</pro:code>
              <pro:productGuid>a9c0ff1b-9824-3045-16f5-a37d74c78e74</pro:productGuid>
            </pro:subProduct>
            <pro:subProduct>
              <bs:uuid>feb2b6b6-8c67-4f7b-832b-6ca3f6557957</bs:uuid>
              <bs:guid>6b3224b3-b977-4100-8205-f62a0c65fb7e</bs:guid>
              <bs:active>true</bs:active>
               <bs:last>true</bs:last>
              <bs:status>100</bs:status>
              <bs:createDate>2015-03-13T14:01:38+03:00</bs:createDate>
              <bs:updateDate>2015-03-13T14:01:38+03:00</bs:updateDate>
               <pro:name>пунчана</pro:name>
               <pro:code>0106</pro:code>
               <pro:productGuid>8b734283-b446-eb70-a8ba-1afbde1fcf5b</pro:productGuid>
             </pro:subProduct>
         </pro:subProductList>
       </ws:getSubProductChangesListResponse>
   </S:Body>
</soapenv:Envelope>
</soapenv:Envelope>
</syntaxhighlight>
</syntaxhighlight>
</div>
</div>
</div>
</div>
<br />


[[Category:Ветис.API]]
[[Category:Ветис.API]]
[[Category:ProductService]]
[[Category:ProductService]]

Текущая версия на 16:01, 27 сентября 2020

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

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

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

  • параметры запрашиваемого списка;
  • интервал дат, за которые нужно получить изменения.

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

  • список видов продукции, изменённых за указанный период времени.

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

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <ws:getSubProductChangeListRequest>
002 ···<bs:listOptions> bs:ListOptions [0..1] Параметры запрашиваемого списка.
003 ······<bs:count>10</bs:count> xs:nonNegativeInteger [0..1]

Максимальное запрашиваемое количество объектов в списке.

  • По умолчанию значение 100;
  • Максимально возможное значение 1000.
004 ······<bs:offset>2</bs:offset> xs:nonNegativeInteger [0..1]

Номер элемента, по которому осуществляется смещение первого элемента списка.

  • По умолчанию значение 0.
005 ···</bs:listOptions>
006 ···<bs:updateDateInterval> bs:DataInterval [1..1]

Интервал времени обновления.

  • В список попадают все записи, дата обновлений которых попадает в указанный интервал.
007 ······<bs:beginDate>2017-07-07T00:00:00</bs:beginDate> xs:dateTime [1..1] Начало временного интервала.
008 ······<bs:endDate>2017-07-25T00:00:00</bs:endDate> xs:dateTime [0..1] Конец временного интервала.
009 ···</bs:updateDateInterval>
010 </ws:getSubProductChangeListRequest>

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

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <ws:getSubProductChangeListResponse>
002 ···<dt:subProductList total="2" offset="0" count="2"> dt:SubProductList [1..1]

Список видов продукции.

  • total - всего записей;
  • offset - смещение относительно первого элемента;
  • count - количество выводимых записей.
003 ······<dt:subProduct> dt:SubProduct [0..*]

Вид продукции.

  • третий уровень иерархического справочника продукции ИС Меркурий
004 ·········<bs:uuid>UUID</bs:uuid> bs:UUID [1..1] Идентификатор версии вида продукции.
005 ·········<bs:guid>GUID</bs:guid> bs:UUID [1..1] Глобальный идентификатор вида продукции.
006 ·········<bs:active>true</bs:active> xs:boolean [1..1]

Описание, является ли запись активной.

  • true - запись активна;
  • false - запись не активна.
007 ·········<bs:last>true</bs:last> xs:boolean [1..1]

Описание, является ли версия записи последней.

  • true - да;
  • false - нет.
008 ·········<bs:status>100</bs:status> bs:VersionStatus [1..1] Статус версии записи.
009 ·········<bs:createDate>2017-07-07T12:00:00</bs:createDate> xs:DateTime [1..1] Дата создания записи.
010 ·········<bs:updateDate>2017-07-07T12:00:00</bs:updateDate> xs:DateTime [1..1] Дата изменения записи.
011 ·········<bs:previous>UUID</bs:previous> bs:UUID [0..1] Идентификатор предыдущей версии записи.
012 ·········<bs:next>UUID</bs:next> bs:UUID [0..1] Идентификатор следующей версии записи.
013 ·········<dt:name>мясо птицы</dt:name> bs:String255 [1..1] Название вида продукции.
014 ·········<dt:code>0207</dt:code> bs:String255 [1..1] Код ТН ВЭД вида продукции.
015 ·········<dt:productGuid>GUID</dt:productGuid> bs:UUID [1..1]

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

  • второй уровень иерархического справочника продукции ИС Меркурий
016 ······</dt:subProduct>
017 ···</dt:subProductList>
018 </ws:getSubProductChangeListResponse>

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

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

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

Запрос списка первых трех изменённых видов продукции с 20.10.2016 по текущий день без смещения. 

<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:getSubProductChangesListRequest>
         <bs:listOptions>
            <bs:count>3</bs:count>
            <bs:offset>0</bs:offset>
         </bs:listOptions>
         <bs:updateDateInterval>
            <bs:beginDate>2016-10-20T00:00:00</bs:beginDate>
         </bs:updateDateInterval>   
      </ws:getSubProductChangesListRequest>
   </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:getSubProductChangesListResponse 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:subProductList count="3" total="946" offset="0">
            <dt:subProduct>
               <bs:uuid>c51f5855-ea43-116e-3a5b-f7dcd2766d8a</bs:uuid>
               <bs:guid>2160cc9f-0380-6200-dce9-0f0b3c86a8aa</bs:guid>
               <bs:active>false</bs:active>
               <bs:last>false</bs:last>
               <bs:status>100</bs:status>
               <bs:createDate>2008-01-01T00:00:00+03:00</bs:createDate>
               <bs:updateDate>2016-11-11T14:03:00+03:00</bs:updateDate>
               <bs:next>619e5808-3262-4c19-aaa3-77ce377524ee</bs:next>
               <dt:name>молочная паста</dt:name>
               <dt:code>0405</dt:code>
               <dt:productGuid>686b55f7-c199-9788-5ee5-a755eb2b8d2a</dt:productGuid>
            </dt:subProduct>
            <dt:subProduct>
               <bs:uuid>6d71c9e1-3cf4-2afb-9d9a-75ea2ab95a12</bs:uuid>
               <bs:guid>c847eca1-641f-24e7-a44a-c71c28fb377f</bs:guid>
               <bs:active>false</bs:active>
               <bs:last>false</bs:last>
               <bs:status>100</bs:status>
               <bs:createDate>2008-01-01T00:00:00+03:00</bs:createDate>
               <bs:updateDate>2017-03-10T10:06:36+03:00</bs:updateDate>
               <bs:next>4a6238db-dda6-4b51-8910-6d1cc6e63d69</bs:next>
               <dt:name>икра лососевых пород рыб мороженая соленая</dt:name>
               <dt:code>1604</dt:code>
               <dt:productGuid>46fde18a-f6af-f7b0-de47-044281271112</dt:productGuid>
            </dt:subProduct>
            <dt:subProduct>
               <bs:uuid>b694de27-45e0-ea26-c936-684f7db0dfd4</bs:uuid>
               <bs:guid>799e561f-4228-9bd5-fa45-11a6db084dfc</bs:guid>
               <bs:active>false</bs:active>
               <bs:last>false</bs:last>
               <bs:status>100</bs:status>
               <bs:createDate>2009-11-17T14:45:40+03:00</bs:createDate>
               <bs:updateDate>2016-11-11T14:03:00+03:00</bs:updateDate>
               <bs:next>097c5951-aae6-4e1a-9152-cca3f9f8d295</bs:next>
               <dt:name>белок молочный сухой</dt:name>
               <dt:code>3504</dt:code>
               <dt:productGuid>686b55f7-c199-9788-5ee5-a755eb2b8d2a</dt:productGuid>
            </dt:subProduct>
         </dt:subProductList>
      </v2:getSubProductChangesListResponse>
   </soap:Body>
</soapenv:Envelope>


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