Exportcenter:GetVeterinaryLaboratoryList:v2.2: различия между версиями

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
 
(не показано 10 промежуточных версий 2 участников)
Строка 1: Строка 1:
==Общие сведения==
==Общие сведения==


Операция '''GetLaboratoryList''' предназначена для получения списка актуальных записей о лабораториях (active=true, last=true). Поддерживается постраничный вывод.  
Операция '''GetVeterinaryLaboratoryList''' предназначена для получения списка актуальных записей о лабораториях (active=true, last=true). Поддерживается постраничный вывод.  


==Используемые пространства имён==
==Используемые пространства имён==
Строка 30: Строка 30:
|-
|-
|001
|001
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''<ws:getLaboratoryListRequest>'''}}         
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''<ws:getVeterinaryLaboratoryListRequest>'''}}         
|
|
|
|
Строка 46: Строка 46:
|[0..1]
|[0..1]
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
|<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>
<span style="white-space:nowrap; font-weight: normal;">1.1. Максимальное запрашиваемое количество объектов в списке.</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
<div class="mw-collapsible-content" style="font-weight: normal;">
* По умолчанию значение 100;
* По умолчанию значение 100;
Строка 57: Строка 57:
|[0..1]
|[0..1]
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
|<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>
<span style="white-space:nowrap; font-weight: normal;">1.2. Номер элемента, по которому осуществляется смещение первого элемента списка.</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
<div class="mw-collapsible-content" style="font-weight: normal;">
* По умолчанию значение 0.</div>
* По умолчанию значение 0.</div>
Строка 69: Строка 69:
|-
|-
|006
|006
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''</ws:getLaboratoryListRequest>'''}}         
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''</ws:getVeterinaryLaboratoryListRequest>'''}}         
|
|
|
|
Строка 75: Строка 75:
|-
|-
|}
|}
==Спецификация ответа==
{| class="wikitable"
! #
! Название XML-элемента
! Тип
! Обязат.
! Описание (нажмите [...] для отображения дополнительного описания)
|-
|001
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''<ws:getVeterinaryLaboratoryListResponse>'''}}       
|
|
| style="width:52em;"|
|-
|002
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|dt:}}veterinaryLaboratoryList {{color|Red|count&#61;}}{{color|#007f15|"?"}} {{color|Red|total&#61;}}{{color|#007f15|"?"}} {{color|Red|offset&#61;}}{{color|#007f15|"?"}}>'''}}
|[[VeterinaryLaboratoryList_v2.3|dt:VeterinaryLaboratoryList]]
|[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;">2. Список лабораторий</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
* total - 1.3. всего записей;
* offset - 1.2. смещение относительно первого элемента;
* count - 1.1. количество выводимых записей.</div>
</div>
|-
|003
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|dt:}}veterinaryLaboratory>'''}}
|[[VeterinaryLaboratory_v2.3|dt:VeterinaryLaboratory]]
|[0..*]
| style="width:52em;"| 2.1. Сведения о лаборатории
|-
|004
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|bs:}}uuid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}uuid>'''}}
|[[UUID|bs:UUID]]
|[1..1]
| style="width:52em;"| 2.1.1. Уникальный идентификатор версии записи
|-
|005
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}}
|[[UUID|bs:UUID]]
|[1..1]
| style="width:52em;"| 2.1.2. Глобальный идентификатор записи
|-
|006
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|bs:}}active>'''}}{{color|#131313|?}}{{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;">2.1.3. Флаг, указывающий на то, активна ли запись</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|?}}{{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;">2.1.4. Флаг, указывающий на то, является ли запись последней</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|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}status>'''}}
|[[VersionStatus|bs:VersionStatus]]
|[1..1]
| style="width:52em;"| 2.1.5. Статус версии записи
|-
|009
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|bs:}}createDate>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}createDate>'''}}
|[http://www.w3.org/TR/xmlschema-2/#DateTime xs:DateTime]
|[1..1]
| style="width:52em;"| 2.1.6. Дата создания версии записи
|-
|010
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|bs:}}updateDate>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}updateDate>'''}}
|[http://www.w3.org/TR/xmlschema-2/#DateTime xs:DateTime]
|[1..1]
| style="width:52em;"| 2.1.7. Дата последнего обновления версии записи
|-
|011
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|bs:}}previous>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}previous>'''}}
|[[UUID|bs:UUID]]
|[0..1]
| style="width:52em;"| 2.1.8. Идентификатор предыдущей версии записи
|-
|012
|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;"| 2.1.9. Наименование лаборатории
|-
|013
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}fullName>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}fullName>'''}}
|[[String255|bs:String255]]
|[1..1]
| style="width:52em;"| 2.1.10. Полное наименование лаборатории
|-
|014
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}address>'''}}
|[[Address_v2.0|dt:Address]]
|[1..1]
| style="width:52em;"| 2.1.11. Сведения об адресе лаборатории
|-
|015
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|dt:}}addressView>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}addressView>'''}}
|[[String255|bs:String255]]
|[1..1]
| style="width:52em;"| 2.1.11.1. Строковое представление адреса
|-
|016
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}address>'''}}
|
|
| style="width:52em;"|
|-
|017
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}serviceList>'''}}
|[[VeterinaryServiceList_v2.2|dt:VeterinaryServiceList]]
|[0..1]
| style="width:52em;"| 2.1.12. Список услуг, оказываемых лабораторией
|-
|018
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|dt:}}service>'''}}
|[[VeterinaryService_v2.2|dt:VeterinaryService]]
|[1..1]
| style="width:52em;"| 2.1.12.1. Услуга
|-
|019
|style="font-weight: ; font-family: Courier;" |···············{{color|#190dbf|'''<{{color|#660e7a|dt:}}serviceType>'''}}{{color|#131313|WBR_COMPLIENCE_STATEMENT}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}serviceType>'''}}
|[[VeterinaryServiceType_v2.2|dt:VeterinaryServiceType]]
|[1..1]
| style="width:52em;"| 2.1.12.1.1. Признак выдачи заключений ВБР данной лабораторией
|-
|020
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''</{{color|#660e7a|dt:}}service>'''}}
|
|
| style="width:52em;"|
|-
|021
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}serviceList>'''}}
|
|
| style="width:52em;"|
|-
|022
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''</{{color|#660e7a|dt:}}veterinaryLaboratory>'''}}
|
|
| style="width:52em;"|
|-
|023
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''</{{color|#660e7a|dt:}}veterinaryLaboratoryList>'''}}
|
|
| style="width:52em;"|
|-
|024
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''</ws:getVeterinaryLaboratoryListResponse>'''}}       
|
|
| style="width:52em;"|
|-
|}
== Примеры запросов ==
=== 8.10.RQ1. Пример запроса списка всех лабораторий. ===
<br />
<div id="example6">
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
'''8.10.Request.Example'''
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<ws:getVeterinaryLaboratoryListRequest
xmlns:ws="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2"
xmlns:bs="http://api.vetrf.ru/schema/cdm/base">       
</ws:getVeterinaryLaboratoryListRequest>
</syntaxhighlight>
</div>
</div>
<br />
<div id="example6">
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
'''8.10.Response.Example'''
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<ws:getVeterinaryLaboratoryListResponse
xmlns:ws="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2"
xmlns:bs="http://api.vetrf.ru/schema/cdm/base"
xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2">       
  <dt:veterinaryLaboratoryList count="2" total="2" offset="0">
      <dt:veterinaryLaboratory>
        <bs:uuid>2874c443-9060-46a7-89b8-bf4219ac373a</bs:uuid>
        <bs:guid>2874c443-9060-46a7-89b8-bf4219ac373a</bs:guid>
        <bs:active>true</bs:active>
        <bs:last>true</bs:last>
        <bs:status>100</bs:status>
        <bs:createDate>2023-01-01T00:00:00</bs:createDate>
        <bs:updateDate>2023-01-01T00:00:00</bs:createDate>
        <dt:name>string</dt:name>
        <dt:fullName>string</dt:fullName>
        <dt:address>
            <dt:addressView>string</dt:addressView>
        </dt:address>
        <dt:serviceList>
            <dt:service>
              <dt:serviceType>WBR_COMPLIENCE_STATEMENT</dt:serviceType>
            </dt:service>
        </dt:serviceList>
      </dt:veterinaryLaboratory>
      <dt:veterinaryLaboratory>
        <bs:uuid>2874c443-9060-46a7-89b8-bf4219ac373a</bs:uuid>
        <bs:guid>2874c443-9060-46a7-89b8-bf4219ac373a</bs:guid>
        <bs:active>true</bs:active>
        <bs:last>true</bs:last>
        <bs:status>100</bs:status>
        <bs:createDate>2023-01-01T00:00:00</bs:createDate>
        <bs:updateDate>2023-01-01T00:00:00</bs:createDate>
        <dt:name>string</dt:name>
        <dt:fullName>string</dt:fullName>
        <dt:address>
            <dt:addressView>string</dt:addressView>
        </dt:address>
      </dt:veterinaryLaboratory>
  </dt:veterinaryLaboratoryList>
</ws:getVeterinaryLaboratoryListResponse>
</syntaxhighlight>
</div>
</div>
<br />

Текущая версия на 09:58, 5 июня 2023

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

Операция GetVeterinaryLaboratoryList предназначена для получения списка актуальных записей о лабораториях (active=true, last=true). Поддерживается постраничный вывод.

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

Пространство имён (xmlns) XSD-схема, содержащая описание типов
xmlns:bs="http://api.vetrf.ru/schema/cdm/base" https://api.vetrf.ru/schema/platform/exportcenter/v2.0b-20210906/base_v2.0.xsd
xmlns:ws="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2" https://api.vetrf.ru/schema/platform/exportcenter/v2.0b-20210906/registry_ws_definitions_v2.2.xsd
xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2" https://api.vetrf.ru/schema/platform/exportcenter/v2.0b-20210906/dictionary_v2.2.xsd

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

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

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

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

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

  • По умолчанию значение 0.
005 ···</bs:listOptions>
006 </ws:getVeterinaryLaboratoryListRequest>

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

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

2. Список лабораторий

  • total - 1.3. всего записей;
  • offset - 1.2. смещение относительно первого элемента;
  • count - 1.1. количество выводимых записей.
003 ······<dt:veterinaryLaboratory> dt:VeterinaryLaboratory [0..*] 2.1. Сведения о лаборатории
004 ·········<bs:uuid>?</bs:uuid> bs:UUID [1..1] 2.1.1. Уникальный идентификатор версии записи
005 ·········<bs:guid>?</bs:guid> bs:UUID [1..1] 2.1.2. Глобальный идентификатор записи
006 ·········<bs:active>?</bs:active> xs:boolean [1..1]

2.1.3. Флаг, указывающий на то, активна ли запись

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

2.1.4. Флаг, указывающий на то, является ли запись последней

  • true - да;
  • false - нет.
008 ·········<bs:status>?</bs:status> bs:VersionStatus [1..1] 2.1.5. Статус версии записи
009 ·········<bs:createDate>?</bs:createDate> xs:DateTime [1..1] 2.1.6. Дата создания версии записи
010 ·········<bs:updateDate>?</bs:updateDate> xs:DateTime [1..1] 2.1.7. Дата последнего обновления версии записи
011 ·········<bs:previous>?</bs:previous> bs:UUID [0..1] 2.1.8. Идентификатор предыдущей версии записи
012 ·········<dt:name>?</dt:name> bs:String255 [1..1] 2.1.9. Наименование лаборатории
013 ·········<dt:fullName>?</dt:fullName> bs:String255 [1..1] 2.1.10. Полное наименование лаборатории
014 ·········<dt:address> dt:Address [1..1] 2.1.11. Сведения об адресе лаборатории
015 ············<dt:addressView>?</dt:addressView> bs:String255 [1..1] 2.1.11.1. Строковое представление адреса
016 ·········</dt:address>
017 ·········<dt:serviceList> dt:VeterinaryServiceList [0..1] 2.1.12. Список услуг, оказываемых лабораторией
018 ············<dt:service> dt:VeterinaryService [1..1] 2.1.12.1. Услуга
019 ···············<dt:serviceType>WBR_COMPLIENCE_STATEMENT</dt:serviceType> dt:VeterinaryServiceType [1..1] 2.1.12.1.1. Признак выдачи заключений ВБР данной лабораторией
020 ············</dt:service>
021 ·········</dt:serviceList>
022 ······</dt:veterinaryLaboratory>
023 ···</dt:veterinaryLaboratoryList>
024 </ws:getVeterinaryLaboratoryListResponse>

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

8.10.RQ1. Пример запроса списка всех лабораторий.


8.10.Request.Example

<ws:getVeterinaryLaboratoryListRequest
	xmlns:ws="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2" 
	xmlns:bs="http://api.vetrf.ru/schema/cdm/base">         
</ws:getVeterinaryLaboratoryListRequest>


8.10.Response.Example

<ws:getVeterinaryLaboratoryListResponse
	xmlns:ws="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2" 
	xmlns:bs="http://api.vetrf.ru/schema/cdm/base"
	xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2">         
   <dt:veterinaryLaboratoryList count="2" total="2" offset="0">
      <dt:veterinaryLaboratory>
         <bs:uuid>2874c443-9060-46a7-89b8-bf4219ac373a</bs:uuid>
         <bs:guid>2874c443-9060-46a7-89b8-bf4219ac373a</bs:guid>
         <bs:active>true</bs:active>
         <bs:last>true</bs:last>
         <bs:status>100</bs:status>
         <bs:createDate>2023-01-01T00:00:00</bs:createDate>
         <bs:updateDate>2023-01-01T00:00:00</bs:createDate>
         <dt:name>string</dt:name>
         <dt:fullName>string</dt:fullName>
         <dt:address>
            <dt:addressView>string</dt:addressView>
         </dt:address>
         <dt:serviceList>
            <dt:service>
               <dt:serviceType>WBR_COMPLIENCE_STATEMENT</dt:serviceType>
            </dt:service>
         </dt:serviceList>
      </dt:veterinaryLaboratory>
      <dt:veterinaryLaboratory>
         <bs:uuid>2874c443-9060-46a7-89b8-bf4219ac373a</bs:uuid>
         <bs:guid>2874c443-9060-46a7-89b8-bf4219ac373a</bs:guid>
         <bs:active>true</bs:active>
         <bs:last>true</bs:last>
         <bs:status>100</bs:status>
         <bs:createDate>2023-01-01T00:00:00</bs:createDate>
         <bs:updateDate>2023-01-01T00:00:00</bs:createDate>
         <dt:name>string</dt:name>
         <dt:fullName>string</dt:fullName>
         <dt:address>
            <dt:addressView>string</dt:addressView>
         </dt:address>
      </dt:veterinaryLaboratory>
   </dt:veterinaryLaboratoryList>
</ws:getVeterinaryLaboratoryListResponse>