Служба доступу до даних Комплексу
Опис служби доступу
Служба доступу до даних Комплексу являє собою веб-сервіс, побудований на основі технології протоколу обміну даними SOAP через з’єднання HTTP/HTTPS. Поточна версія служби 1.0.1.Х.
Вимоги до середовища функціонування
Для роботи служби доступу необхідним є задоволення наступних вимог:
- операційна система: Microsoft Windows Server 2008 і вище;
- наявність Microsoft .Net framework 4.0 і вище;
- Microsoft Internet Information Services (IIS) 6 або вище, з підтримкою ASP.Net.
Порядок встановлення служби
- Створити в файловій системі сервера каталог – ISPROSoap, скопіювати в неї вміст дистрибутиву.
- Створити на сервері користувача ISPROSoap або використовувати користувача-адміністратора системи (у разі останнього пп. 4-6 пропустити).
- Включити створеного користувача в групи:
- користувачі;
- IIS_WPG (або IIS_IUSRS, в залежності від версії IIS).
- Видати права на читання / запис на каталог ISPROSoap (з вкладеннями) користувачу ISPROSoap.
- Запустити менеджер IIS.
- Створити пул (групу) додатків ISPROSoap.
- Для пулу відкрити властивості й на закладці Ідентифікація вибрати пункт Особливий обліковий запис, вказати обліковий запис створеного користувача ISPROSoap.
- Створити віртуальний каталог ISPROSoap, вказати каталог ISPROSoap. Викликати властивості й вказати створений пул додатків ISPROSoap.
У разі необхідності роботи з COM об'єктами ISpro, додатково виконати наступні дії:
- Зареєструвати COM-сервер обміну даними з Комплексом ISpro (див. https://ispro.ua/faq);
- Включити створеного користувача ISPROSoap в групи Користувачів DCOM;
- Налаштувати для користувача ISPROSoap права на запуск і звернення до
COM-сервера ISpro. Для цього:
- у командному рядку виконати команду mmc comexp.msc або для 64-бітових систем mmc comexp.msc / 32;
- відкрити Служби компонентів / Комп'ютери / Мій комп'ютер / Налаштування DCOM;
- відшукати в списку додаток з кодом {8D6387DB-CDBE-43df-B071-B9FA4BF150F1};
- відкрити вікно Властивості, закладку Безпека;
- налаштувати параметри Дозволи на запуск і активацію і Дозволи на доступ – додати в список користувача ISPROSoap і включити Локальний запуск, Локальна активація, Локальний доступ;
- Видати права користувачеві ISPROSoap:
- читання / запису на каталог обміну з Комплексом ISpro;
- читання / запису до серверної частини Комплексу ISpro;
- створити обліковий запис в Комплексі, під яким буде виконуватись робота.
Порядок налаштування служби доступу
Файл ISPROSoap \ Web.config містить приклади значень параметрів. Підключення до БД MS SQL проводиться засобами стандартного клієнта Framework. Підключення до БД ORACLE проводиться або засобами встановленого Oracle Client (рекомендується), або засобами Instance Client, що входить в дистрибутив.
Необхідно вказати наступні параметри:
- Загальносистемні параметри:
- Рівень деталізації протоколу (applicationSettings\LogLevel):
- OFF – протоколювання відключено;
- ERROR – виводити помилки;
- WARNING – виводити попередження;
- TRACE – виводити детальну інформацію про роботу служби.
- Шлях до каталогу збереження файлів протоколу (applicationSettings\LogDir).
- Установки для перегляду БД ISpro:
- Рядок підключення до бази даних MS SQL (connectionStrings\StrDbConnectMSSQL).
Установки для перегляду MS SQL Server:
- Data Source – ім'я сервера;
- Initial Catalog – найменування бази даних;
- User ID – логін для підключення до сервера;
- Password – пароль для підключення до сервера;
- Trusted_Connection = Yes – підключення використовуючи аутентифікацію Windows.
- Рядок підключення до бази даних ORACLE
(connectionStrings\StrDbConnect).
- Установки для перегляду Oracle Server:
- Data Source – ім'я сервера;
- User ID – логін для підключення до сервера;
- Password – пароль для підключення до сервера;
- Trusted_Connection = Yes – підключення використовуючи аутентифікацію Windows.
- Якщо база даних ORACLE, вказати тип підключення
(connectionStrings\LoadOracleClient):
- false – підключення проводиться через встановлений стандартний клієнт;
- true – підключення проводиться через Instance Client.
- Тип СКБД ISpro (applicationSettings\IsProDBType). Приймає значення ORACLE або MS SQL.
- Найменування системної бази (applicationSettings\StrDbConnectSys).
- Параметри для інтеграції з COM-об'єктами ISpro:
- Шлях до серверної частини ISpro (applicationSettings\ServerPath).
- Параметри авторизації в системі ISpro (applicationSettings\Login\Pass).
- Код підприємства в системі ISpro (applicationSettings\Firm).
- Код структурної одиниці в системі ISpro (applicationSettings\SE).
- Ознака необхідності перевірки COM-об'єктів ISpro
(connectionStrings\TestConnectCOM).
- Параметри для інтеграції з системою АСДС (Авторозподіл).
- Код посади судді в довіднику ISpro (applicationSettings\JudgePosCodes).
- Кількість місяців вивантажується історії причин непрацездатності по обліковому періоду (applicationSettings\JudgeUpHistoryMon).
- Рядок підключення до бази даних ORACLE
(connectionStrings\StrDbConnect).
Доступні методи
У поточній версії служби доступні дві підсистеми обробки даних:
- Підсистема обробки даних для системи Авторозподіл.
- Доступна за адресою IsproSoapGate.asmx
- Методи:
- JudgesDistribSettings - виконує вивантаження даних в систему АСДС на задану дату.
Запит:
| Параметр | Тип даних | опис |
| Dt | date | дата, на яку проводиться розрахунок |
Відповідь:
Результат в xml-форматі згідно зі схемою валідації auto_common.xsd.
- Підсистема довідкової інформації.
- Доступна за адресою IPDict.asmx.
Методи:
- Specializations - Довідник спеціалізацій (категорій) справ
Запит:
| параметр | Тип даних | опис |
Відповідь:
Список структур в JSON-форматі з наступним набором полів:
| параметр | Тип даних | опис |
| ID | Int64 | код записи |
| DBID | Int64 | код бази |
| RefID | Int64 |
Код записи батька
|
| CODE | string | символьний код |
| NAME | string | Найменування |
| WEIGHT | Int64 | перша інстанція |
| WEIGHT2 | Int64 | апеляційна інстанція |
| WEIGHT3 | Int64 | касаційна інстанція |
| HOLYDAYS | Int | Розподіл у вихідні дні |
| CALCTODAY | Int | Розрахунок навантаження за поточний день |
- GetCourtsInfoByUSRCC2007 – Отримання інформації про суд за кодом ЕДРСР 2007
Запит:
| параметр | Тип даних | опис |
| code_2007 | string [] | Код ЕДРСР 2007 |
Відповідь: Масив структур з наступним набором полів
| параметр | Тип даних | опис |
| edrpou | string | код ЄДРПОУ |
| code_2007 | string | Код ЕДРСР 2007 |
| code_2013 | string | Код ЕДРСР 2013 |
| name | string | Назва в називному відмінку |
| name_2 | string | Назва в давальному відмінку |
| address | string | Адреса |
| phone | string | Телефон |
GetCourtsInfoByEDRPOU – Отримання інформації про суд по коду ЄДРПОУ
Запит:
| параметр | Тип даних | опис |
| edrpou | string [] | код ЄДРПОУ |
Відповідь: Масив структур з наступним набором полів
| параметр | Тип даних | опис |
| edrpou | string | код ЄДРПОУ |
| code_2007 | string | Код ЕДРСР 2007 |
| code_2013 | string | Код ЕДРСР 2013 |
| name | string | Назва в називному відмінку |
| name_2 | string | Назва в давальному відмінку |
| address | string | Адреса |
| phone | string | Телефон |
- GetCourtsInfoByUSRCC2013– Отримання інформації про суд за кодом ЕДРСР 2013
Запит:
| параметр | Тип даних | опис |
| code_2013 | string [] | Код ЕДРСР 2013 |
Відповідь: Масив структур з наступним набором полів
| параметр | Тип даних | опис |
| edrpou | string | код ЄДРПОУ |
| code_2007 | string | Код ЕДРСР 2007 |
| code_2013 | string | Код ЕДРСР 2013 |
| name | string | Назва в називному відмінку |
| name_2 | string | Назва в давальному відмінку |
| address | string | Адреса |
| phone | string | Телефон |
- GetCourtInfoByEDRPOU – Отримання інформації про суд по коду ЄДРПОУ
Запит:
| параметр | Тип даних | опис |
| edrpou | string | код ЄДРПОУ |
Відповідь: Структура з наступним набором полів
| параметр | Тип даних | опис |
| edrpou | string | код ЄДРПОУ |
| code_2007 | string | Код ЕДРСР 2007 |
| code_2013 | string | Код ЕДРСР 2013 |
| name | string | Назва в називному відмінку |
| name_2 | string | Назва в давальному відмінку |
| address | string | Адреса |
| phone | string | Телефон |
- GetJudgesInfoByName – Отримання інформації про суддю за кодом ЄДРПОУ суду і ПІБ судді
Запит: Масив структур з наступним набором полів
| параметр | Тип даних | опис |
| edrpou | string | код ЄДРПОУ |
| name | string | ПІБ |
Відповідь: Масив структур з наступним набором полів
| параметр | Тип даних | опис |
| name | string | ПІБ |
| idrn | string | ІПН |
- GetJudgeInfoByName– Отримання інформації про суддю за кодом ЄДРПОУ суду і ПІБ судді
Запит:
| параметр | Тип даних | опис |
| edrpou | string | код ЄДРПОУ |
| name | string | ПІБ |
Відповідь:Масив структур з наступним набором полів
| параметр | Тип даних | опис |
| name | string | ПІБ |
| idrn | string | ІПН |
- GetSecretariesInfoByName – Отримання інформації про секретаря по коду ЄДРПОУ суду і ПІБ судді
Запит:
Масив структур з наступним набором полів
| параметр | Тип даних | опис |
| edrpou | string | код ЄДРПОУ |
| name | string | ПІБ |
Відповідь: Масив структур з наступним набором полів
| параметр | Тип даних | опис |
| name | string | ПІБ |
| idrn | string | ІПН |
- GetSecretaryInfoByName – Отримання інформації про секретаря по коду ЄДРПОУ суду і ПІБ судді
Запит:
| параметр | Тип даних | опис |
| edrpou | string | код ЄДРПОУ |
| name | string | ПІБ |
Відповідь: Масив структур з наступним набором полів
| параметр | Тип даних | опис |
| name | string | ПІБ |
| idrn | string | ІПН |
Контрольний приклад використання служби доступу
Після встановлення, налаштування та запуску служби доступ до її методів проводиться за адресою [ip]: [port] / [ім'я форми] або [ім'я вузла] / [ім'я форми], де [ім'я форми] = IsproSoapGate.asmx або IPDict.asmx.
Звернувшись за цією адресою в браузері можна отримати список доступних методів і завантажити файл настройки wsdl для реалізації виклику методів з іншого ПО.