Exportcenter:GetProductChangesList:v2.0 - История изменений

Rocheva-aj: /* Спецификация ответа */

2021-09-03T06:46:36Z

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

← Предыдущая версия		Версия от 06:46, 3 сентября 2021
Строка 133:		Строка 133:
	\|[1..1]		\|[1..1]
	\|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;">		\|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
	<span style="white-space:nowrap; font-weight: normal;">~~Продукция~~.</span>		<span style="white-space:nowrap; font-weight: normal;">Список продукции.</span>
	<div class="mw-collapsible-content" style="font-weight: normal;">		<div class="mw-collapsible-content" style="font-weight: normal;">
	* ~~второй уровень иерархического справочника продукции ИС Меркурий~~</div>		* total - всего записей;
			* offset - смещение относительно первого элемента;
			* count - количество выводимых записей.</div>
	</div>		</div>
	\|-		\|-
Строка 142:		Строка 144:
	\|[[Product_v2.0\|dt:Product]]		\|[[Product_v2.0\|dt:Product]]
	\|[0..*]		\|[0..*]
	\| style="width:52em;"\| ~~Идентификатор версии~~ продукции.		\| style="width:52em;"\|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " 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>
	\|-		\|-
	\|004		\|004
Строка 148:		Строка 154:
	\|[[UUID\|bs:UUID]]		\|[[UUID\|bs:UUID]]
	\|[1..1]		\|[1..1]
	\| style="width:52em;"\| ~~Глобальный идентификатор~~ продукции.		\| style="width:52em;"\| Идентификатор версии продукции.
	\|-		\|-
	\|005		\|005
	\|style="font-weight: ; font-family: Courier;" \|·········{{color\|#190dbf\|'''<{{color\|#660e7a\|bs:}}guid>'''}}{{color\|#131313\|GUID}}{{color\|#190dbf\|'''</{{color\|#660e7a\|bs:}}guid>'''}}		\|style="font-weight: ; font-family: Courier;" \|·········{{color\|#190dbf\|'''<{{color\|#660e7a\|bs:}}guid>'''}}{{color\|#131313\|GUID}}{{color\|#190dbf\|'''</{{color\|#660e7a\|bs:}}guid>'''}}
	\|[[UUID\|bs:UUID]]		\|[[UUID\|bs:UUID]]
			\|[1..1]
			\| Глобальный идентификатор продукции.
			\|-
			\|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]		\|[1..1]
	\|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;">		\|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
Строка 161:		Строка 173:
	</div>		</div>
	\|-		\|-
	\|~~006~~		\|007
	\|style="font-weight: ; font-family: Courier;" \|·········{{color\|#190dbf\|'''<{{color\|#660e7a\|bs:}}~~active~~>'''}}{{color\|#131313\|true}}{{color\|#190dbf\|'''</{{color\|#660e7a\|bs:}}~~active~~>'''}}		\|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]		\|[http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean]
	\|[1..1]		\|[1..1]
	\|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;">		\| style="width:52em;"\|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
	<span style="white-space:nowrap; font-weight: normal;">Описывает, является ли версия записи последней.		<span style="white-space:nowrap; font-weight: normal;">Описывает, является ли версия записи последней.
	</span>		</span>
Строка 173:		Строка 185:
	</div>		</div>
	</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]~~
	~~\| style="width:52em;"\| Статус версии записи.~~
	\|-		\|-
	\|008		\|008
Строка 184:		Строка 190:
	\|[[VersionStatus\|bs:VersionStatus]]		\|[[VersionStatus\|bs:VersionStatus]]
	\|[1..1]		\|[1..1]
	\| style="width:52em;"\| ~~Дата создания~~ записи.		\| style="width:52em;"\| Статус версии записи.
	\|-		\|-
	\|009		\|009
Строка 190:		Строка 196:
	\|[http://www.w3.org/TR/xmlschema-2/#DateTime xs:DateTime]		\|[http://www.w3.org/TR/xmlschema-2/#DateTime xs:DateTime]
	\|[1..1]		\|[1..1]
	\| style="width:52em;"\| Дата ~~изменения~~ записи.		\| style="width:52em;"\| Дата создания записи.
	\|-		\|-
	\|010		\|010
Строка 196:		Строка 202:
	\|[http://www.w3.org/TR/xmlschema-2/#DateTime xs:DateTime]		\|[http://www.w3.org/TR/xmlschema-2/#DateTime xs:DateTime]
	\|[1..1]		\|[1..1]
	\| style="width:52em;"\| ~~Идентификатор предыдущей версии~~ записи.		\| style="width:52em;"\| Дата изменения записи.
	\|-		\|-
	\|011		\|011
Строка 202:		Строка 208:
	\|[[UUID\|bs:UUID]]		\|[[UUID\|bs:UUID]]
	\|[0..1]		\|[0..1]
	\| style="width:52em;"\| Идентификатор ~~следующей~~ версии записи.		\| style="width:52em;"\| Идентификатор предыдущей версии записи.
	\|-		\|-
	\|012		\|012
Строка 208:		Строка 214:
	\|[[UUID\|bs:UUID]]		\|[[UUID\|bs:UUID]]
	\|[0..1]		\|[0..1]
	\| style="width:52em;"\| ~~Название продукции~~.		\| style="width:52em;"\| Идентификатор следующей версии записи.
	\|-		\|-
	\|013		\|013
Строка 214:		Строка 220:
	\|[[String255\|bs:String255]]		\|[[String255\|bs:String255]]
	\|[1..1]		\|[1..1]
	\| style="width:52em;"\| ~~Код ТН ВЭД~~ продукции.		\| style="width:52em;"\| Название продукции.
	\|-		\|-
	\|014		\|014
Строка 220:		Строка 226:
	\|[[String255\|bs:String255]]		\|[[String255\|bs:String255]]
	\|[1..1]		\|[1..1]
	\|~~<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " 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>~~
	\|-		\|-
	\|015		\|015
Строка 230:		Строка 232:
	\|[[ProductType_v2.0\|dt:ProductType]]		\|[[ProductType_v2.0\|dt:ProductType]]
	\|[1..1]		\|[1..1]
	\| style="width:52em;"\|		\| style="width:52em;"\|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " 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>
	\|-		\|-
	\|016		\|016

Rocheva-aj в 13:42, 2 сентября 2021

2021-09-02T13:42:36Z

Внесённые изменения

Rocheva-aj: Новая страница: «==Общие сведения== Операция '''GetProductChangesList''' предназначена для получения списка изменённо...»

2021-09-02T12:58:39Z

Новая страница: «==Общие сведения== Операция '''GetProductChangesList''' предназначена для получения списка изменённо...»

Новая страница

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

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

===Используемые пространства имён и типы===

{{столбцы}}
{{столбец}}
* [[NameSpaces#http://www.w3.org/2001/XMLSchema|xs]] (<nowiki>http://www.w3.org/2001/XMLSchema</nowiki>)
** [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean]
** [http://www.w3.org/TR/xmlschema-2/#dateTime xs:dateTime]
** [http://www.w3.org/TR/xmlschema-2/#string xs:string]
** [http://www.w3.org/TR/xmlschema-2/#nonNegativeInteger xs:nonNegativeInteger]
{{столбец}}
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/argus/production|prod]] (<nowiki>http://api.vetrf.ru/schema/cdm/argus/production</nowiki>)
** [[Product|prod:Product]]
** [[ProductType|prod:ProductType]]
** [[ProductList|prod:ProductList]]
{{столбец}}
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/base|bs]] (<nowiki>http://api.vetrf.ru/schema/cdm/base</nowiki>)
** [[UUID|bs:UUID]]
** [[DateInterval|bs:DateInterval]]
** [[ListOptions|bs:ListOptions]]
** [[String255|bs:String255]]
{{столбцы/конец}}

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

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

==Данные запроса==

===Объект getProductChangesListRequest===
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| [[#Объект ..Request/listOptions|'''listOptions''']] || Параметры запрашиваемого списка. || [[ListOptions|bs:ListOptions]] || 0..1
|-
| [[#Объект ..Request/updateDateInterval|'''updateDateInterval''']] || Интервал дат, за которые запрашивают изменения. || [[DateInterval|bs:DateInterval]] || 1
|}

===Объект [[#Объект getProductChangesListRequest|..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
|-
|}

===Объект [[#Объект getProductChangesListRequest|..Request]]/'''updateDateInterval'''===

Объект содержит данные об интервале дат, за которые происходили изменения.

{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''beginDate''' || Начальная дата интервала. || [http://www.w3.org/TR/xmlschema-2/#dateTime xs:dateTime] || 1
|-
| '''endDate''' || Конечная дата интервала.
* Если конечная дата не задана, то по умолчанию используется текущая дата.
|| [http://www.w3.org/TR/xmlschema-2/#dateTime xs:dateTime] || 0..1
|}

==Данные ответа==

===Объект getProductChangesListResponse===

Корневой элемент ответа.

{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| [[#Объект ..Response/productList|'''productList''']] || Список продукции выбранного типа. || [[ProductList|prod:ProductList]] || 1
|}

===Объект [[#Объект getProductChangesListResponse |..Response]]/'''productList'''===

Список продукции, полученной в результате запроса.

{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| [[GetProductChangesList#Объект ..Response/productList/product|'''product''']] || Данные о продукции. || [[Product|prod:Product]] || 0..*
|}

'''Атрибуты списка productList'''
{{Ветис.API EntityList Attributes}}

===Объект [[#Объект getProductChangesListResponse |..Response]]/[[#Объект ..Response/productList|productList]]/'''product'''===

Описание продукции.

{{Ветис.API ProductService Product|1}}

==Описание ошибок==
{| class="wikitable"
|-
! Ошибка !! Описание
|-
| '''InternalServiceFault''' || Внутренняя ошибка сервиса.
|-
| '''IncorrectRequestFault''' || Некорректный запрос. Происходит в случае, если запрос не соответствует требованиям указанным в xsd, то есть сообщение не проходит валидацию.
|-
| '''OffsetOutOfRangeFault''' || Заданный в запросе отступ больше числа записей в результате запроса.
|}

==Примеры запросов==

<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Запрос на получение данных о трех первых изменениях за период с 01.01.2013 по 01.10.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:getProductChangesListRequest>
<base:listOptions>
<base:count>3</base:count>
<base:offset>0</base:offset>
</base:listOptions>
<base:updateDateInterval>
<base:beginDate>2013-01-01T00:00:00</base:beginDate>
<base:endDate>2016-10-01T00:00:00</base:endDate>
</base:updateDateInterval>
</ws:getProductChangesListRequest>
</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:getProductChangesListResponse 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:productList count="3" total="36" offset="0">
<pro:product>
<bs:uuid>f10930be-e0ab-ba27-b0dd-45f196897685</bs:uuid>
<bs:guid>785350ed-900d-d57a-b0c3-6f91bfab99ac</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>2015-09-30T15:02:10+03:00</bs:updateDate>
<bs:next>28d732d8-f25d-42e1-9a6f-aeacd75f3f34</bs:next>
<pro:name>рыбы</pro:name>
<pro:code>0106</pro:code>
<pro:productType>3</pro:productType>
</pro:product>
<pro:product>
<bs:uuid>adc13368-6ae2-0dba-b46c-2d4a2e90faf7</bs:uuid>
<bs:guid>e50674d5-cc38-4543-f594-1621f26bd671</bs:guid>
<bs:active>false</bs:active>
<bs:last>false</bs:last>
<bs:status>100</bs:status>
<bs:createDate>2012-03-16T13:41:46+03:00</bs:createDate>
<bs:updateDate>2014-10-17T14:20:18+03:00</bs:updateDate>
<bs:next>9bfa8f21-d5ff-43d5-a427-5ffd709a89b4</bs:next>
<pro:name>минтай сушеный спинка</pro:name>
<pro:code>1604</pro:code>
<pro:productType>7</pro:productType>
</pro:product>
<pro:product>
<bs:uuid>61f70b47-2eef-4760-c08b-592cfe6304fd</bs:uuid>
<bs:guid>8cdb6321-7d86-33a3-32d1-7a1c6a39320e</bs:guid>
<bs:active>false</bs:active>
<bs:last>false</bs:last>
<bs:status>100</bs:status>
<bs:createDate>2012-03-16T13:41:58+03:00</bs:createDate>
<bs:updateDate>2014-10-17T14:18:43+03:00</bs:updateDate>
<bs:next>2a6406b6-9a49-4751-aa7e-77718e58be57</bs:next>
<pro:name>минтай сушеный с перцем шинкованный</pro:name>
<pro:code>1604</pro:code>
<pro:productType>7</pro:productType>
</pro:product>
</pro:productList>
</ws:getProductChangesListResponse>
</S:Body>
</soapenv:Envelope>
</syntaxhighlight>
</div>
</div>
<br />

<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Запрос на получение данных о пяти первых изменениях за период с 10.05.2014 по текущую дату, со смещением равным трем.
<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:getProductChangesListRequest>
<base:listOptions>
<base:count>5</base:count>
<base:offset>3</base:offset>
</base:listOptions>
<base:updateDateInterval>
<base:beginDate>2014-05-10T00:00:00</base:beginDate>
</base:updateDateInterval>
</ws:getProductChangesListRequest>
</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:getProductChangesListResponse 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:productList count="5" total="26" offset="3">
<pro:product>
<bs:uuid>bdb9c4a6-af35-9e34-c30f-329596675f4b</bs:uuid>
<bs:guid>ab2a9460-38a5-438b-37f6-ede0b5cfba2e</bs:guid>
<bs:active>false</bs:active>
<bs:last>false</bs:last>
<bs:status>100</bs:status>
<bs:createDate>2012-03-16T13:42:12+03:00</bs:createDate>
<bs:updateDate>2014-10-17T14:19:41+03:00</bs:updateDate>
<bs:next>44d915e0-995b-40eb-900a-e0f06a5327ea</bs:next>
<pro:name>минтай сушеный спинка с перцем</pro:name>
<pro:code>1604</pro:code>
<pro:productType>7</pro:productType>
</pro:product>
<pro:product>
<bs:uuid>518cb109-e660-458c-b9e9-18945f259c73</bs:uuid>
<bs:guid>29065aac-27be-4c45-b7b5-782571b7d728</bs:guid>
<bs:active>false</bs:active>
<bs:last>false</bs:last>
<bs:status>100</bs:status>
<bs:createDate>2013-05-08T14:26:32+03:00</bs:createDate>
<bs:updateDate>2014-10-17T14:15:46+03:00</bs:updateDate>
<bs:next>710f8d1d-e468-4f97-adba-558108ce26cc</bs:next>
<pro:name>минтай солено-сушеный стружка</pro:name>
<pro:code>1604</pro:code>
<pro:productType>7</pro:productType>
</pro:product>
<pro:product>
<bs:uuid>f39dac4c-8f6a-4e19-b17b-7c868546fa8e</bs:uuid>
<bs:guid>14cf212f-1d94-43f4-9584-aaa169faa40d</bs:guid>
<bs:active>true</bs:active>
<bs:last>true</bs:last>
<bs:status>100</bs:status>
<bs:createDate>2014-05-15T13:48:54+03:00</bs:createDate>
<bs:updateDate>2014-05-15T13:48:54+03:00</bs:updateDate>
<pro:name>Даманы</pro:name>
<pro:code>0106</pro:code>
<pro:productType>3</pro:productType>
</pro:product>
<pro:product>
<bs:uuid>04ab2ca3-2051-403d-9650-55946084dd0a</bs:uuid>
<bs:guid>64f91817-7c6f-4e1e-a2fb-b3d51934ed79</bs:guid>
<bs:active>false</bs:active>
<bs:last>false</bs:last>
<bs:status>100</bs:status>
<bs:createDate>2014-09-16T15:56:22+03:00</bs:createDate>
<bs:updateDate>2014-10-17T14:16:26+03:00</bs:updateDate>
<bs:next>7bdd3340-5c1a-4fdb-91c1-131d4de7b928</bs:next>
<pro:name>копченая икра кефали</pro:name>
<pro:code>1604</pro:code>
<pro:productType>7</pro:productType>
</pro:product>
<pro:product>
<bs:uuid>50c02b08-ed03-49c9-81a0-fcb72bba83ed</bs:uuid>
<bs:guid>2e327835-1f39-487e-adb0-61dfe31cf836</bs:guid>
<bs:active>false</bs:active>
<bs:last>false</bs:last>
<bs:status>100</bs:status>
<bs:createDate>2014-10-13T10:45:22+03:00</bs:createDate>
<bs:updateDate>2014-10-17T14:19:23+03:00</bs:updateDate>
<bs:next>f2e817a0-5c33-481c-9bd1-82c67d44280c</bs:next>
<pro:name>Филе форели консервированное</pro:name>
<pro:code>1604</pro:code>
<pro:productType>7</pro:productType>
</pro:product>
</pro:productList>
</ws:getProductChangesListResponse>
</S:Body>
</soapenv:Envelope>
</syntaxhighlight>
</div>
</div>

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