3.2Сценарий использования веб-сервиса Основными сценариями использования веб-сервиса являются:
Приём документов и выдача ответа одной операцией (синхронная обработка документов).
Передача документов клиенту веб-сервиса.
Приём документов от клиента веб-сервиса.
Проверка работоспособности сервера.
Далее в данном разделе документа будет расмотренны общие правила формирования и получения информации из сообщений веб-сервиса. Описание конкретных сообщений и правила их использования приведены в описаниях протоколов передачи данных.
3.2.1Параметры испытаний на тестовой середе Синхронная обработка документов веб-сервисом применяется в том случае, когда либо не требуется предоставлять ответ на поступивший документ, либо предоставление ответа может быть выполнено в короткие сроки (до 10 секунд) в автоматическом режиме. В настоящее время данная функция используется для предоставления следующих сведений:
Предоставления внешнему контрагенту данных ведомственных справочников ФССП России.
Приём документов от единого портала государственных услуг.
Предоставление сведений о наличии или отсутствии исполнительных производств по физическому или юридическому лицу (индивидуальному предпринимателю).
При использовании сценария синхронной обработки документов за один вызов операции веб-сервиса может быть передан только один документ.
Д Рис. 3.2.1.1: Синхронный вызов
ля выполнения синхронного вызова требуется сформировать сообщение, включающее в себя передаваемый документ и передать это сообщение веб-сервису. Результатом вызова будет сообщение, включающее в себя либо автоматически сформированный документ-ответ на поступивший запрос, либо квитанцию о приеме документа (см. рисунок 3.2.1.1).
Последовательность передачи сообщений показана на рисунке 2
Веб-сервисом при формировании ответа указывается идентификатор документа, переданного запросом. Структура сообщений запроса и ответа показана на рисунке 3.2.1.2.
П Рис.3.2.1.2: Сообщения синхронного вызова
ри использовании синхронного обмена документами веб-сервис не отслеживает, доставлен-ли ответ клиенту. При отсутствии ответа клиент должен повторить вызов веб-сервиса.
3.2.2Асинхронный обмен документами Асинхронный режим передачи документов используется в следующих случаях:
Обработка запроса в ФССП России требует значительного времени, делающего невозможным синхронный обмен информацией.
Документы передаются от ФССП России внешнему контрагенту для дальнейшей обработки. Также, в этом режиме выполняется приём ответов и документов от внешних контрагентов.
Обработка направляемых документов в ФССП России выполняется сотрудниками организации.
Документы направляются в адрес территориальных подразделений ФССП России.
Для повышения производительности обмена, при передаче документов используется пакетный режим. При этом несколько документов, возможно, разных типов, направляемые в адрес одного получателя включаются в состав единой структуры-пакета документов. Общая структура пакета документов показана на рисунке 3.2.2.1.
П Рис. 3.2.2.1: Пакет документов
осле приёма пакета документов, получатель (веб-сервис или внешний контрагент) должен сформировать и передать отправителю документов квитанцию о результате приёма пакета документов. Это необходимо для того, чтобы исключить повторную передачу документов в случае, если приём документов прошёл успешно. В случае неудачного приёма одного или нескольких документов по различным причинам (системный сбой, несоответствие документа электронной подписи, ошибки форматно-логического контроля и т. д.), на основании квитанции, отправителем документов производятся соответствующие действия (повторная отправка документов, уведомление отправителя о невозможности передать документ и пр.).
Общая структура квитанции показана на рисунке 3.2.2.2.
П Рис. 3.2.2.2: Квитанция
ри передаче пакета документов, каждому пакету и документу присваиваются уникальные идентификаторы, позволяющие в квитанции ссылаться как на пакет документов (при одновременной передача нескольких пакетов документов), так и на каждый документ в составе пакета. При формировании квитанции на пакет документов следует использовать данные идентификаторы для указания, к какому пакету относится квитанция и к какому документу относится часть квитанции, свидетельствующая о приёме документа. Схема связывания квитанции с пакетом документов приведена на рисунке 3.2.2.3.
При успешном приёме пакета документов, сведения о принятых документах могут быть опущены. В этом случае сервер считает, что документы, для которых в квитанции нет подтверждения, приняты успешно.
Рис. 3.2.2.3: Схема связывания квитанции с пакетом документов
3.2.2.1Передача документов внешнему контрагенту Для получения пакета документов в свой адрес, клиент должен сформировать запрос на пакет документов и передать его веб-сервису. Результатом выполнения операции будет пакет документов или уведомление об отсутствии в настоящий момент документов в адрес клиента.
После получение пакета документов, или нескольких пакетов документов, на каждый пакет документов должна быть сформирована квитанция. Эта квитанция передаётся отдельным вызовом веб-сервису.
Если веб-сервис не получил в течение установленного времени (20 минут, на тестовом сервере может быть меньше) подтверждения от клиента о приеме пакетов, переданный ранее клиенту пакет считается утраченным. Пакет документов включается в очередь пакетов в адрес клиента и будет передан ещё раз. При превышении установленного количества попыток отправить пакет клиенту (10 раз), передача пакета прекращается.
Для своевременного получения внешним контрагентом документов, направляемых в его адрес, клиентом веб-сервиса должен производиться периодический опрос сервера на предмет наличия подготовленных к передаче документов.
Процесс обмена сообщениями при передаче документов в адрес клиента веб-сервиса показан на рисунке 3.2.2.1.1.
Рис. 3.2.2.1.1: Передача документов клиенту
3.2.2.2Передача документов в адрес ФССП России Для передачи документов в адрес ФССП России или его подразделений, клиент должен сформировать пакет документов и передать его веб-сервису. В результате приёма пакета документов, веб-сервис формирует квитанцию и передаёт её клиенту.
Процесс обмена сообщениями при передаче документов в адрес ФССП России показан на рисунке 3.2.2.2.1.
Рис.3.2.2.2.1: Передача документов серверу
3.2.3Проверка работоспособности сервера Для проверки работоспособности сервера, веб-сервисом реализована специальная функция. Особенностью работы данной функции является то, что при передача серверу определённого сообщения, в ответ будет сформировано сообщение, которое зависит только от сообщения запроса и настроек сервера. То есть, при передаче веб-сервису одного и того же сообщения, клиенту всегда будет возвращено одинаковое сообщение.
Контрольные сообщения для всех протоколов включены в комплект документации.
С Рис.3.2.3.1: Схема обмена контрольными сообщениями
хема обмена контрольными сообщениями приведена на рисунке 3.2.3.1.
|