Коллеги, правильно понимаю, что на данный момент есть только спецификация прошлого года (2020), а новой пока нет.
Насколько она будет отличаться от прошлой неизвестно? Можно ли по ней уже что-то начинать делать или лучше подождать новой?

Отредактировано пользователем 23 марта 2021 г. 16:52:04(UTC)  | Причина: Не указана

Проект спецификации от 09.02.2021:

Specifikacija servisa vzaimodejjstvija API 2 proekt 09.02.2021.docx (611kb) загружен 14 раз(а).

Отредактировано пользователем 9 февраля 2021 г. 13:46:42(UTC)  | Причина: Не указана

Коллеги, если будете копировать XSD-схемы из документа docx, рекомендую временно отключить автоматическую расстановку переносов, иначе часть тегов скопируются с вставленными дефисами.
Кроме того, обратите внимание на XSD-схему в разделе 3.2.11.1 - там текст схемы вставлен дважды

Архив с файлами XSD-схем для API (версия спецификации 1.8.5):

XSD skhemy versija specifikacii 1.8.5.zip (109kb) загружен 6 раз(а).

API спецификация версия 1.8.6 (от 23.03.2021):
Спецификация версия 1.8.6

Обновленные XSD-схемы:
Specifikacija versija 1.8.6 (XSD skhemy).zip (99kb) загружен 1 раз(а).

Описание изменений:

Версия спецификации 1.8.6 (изменения относительно версии 1.8.5):

1. Справочники (раздел 3.1, шаг 1, таблица справочников)
удалены: olyProfiles - Профили олимпиад;
добавлен: olympicsProfilesList - Перечень профилей олимпиад;
добавлен: olympicsProfilesSubjects - Сопоставление профилей олимпиады olympicsProfilesList с общеобразовательными предметами subject
изменены: название olympics -> olympicsList;
изменены: описание olympicsProfiles изменилось описание на "сопоставление олимпиад с профилем olympicsProfilesList и уровнями olympicLevel"

2. измененение в разделе 3.2.15.5.7
изменено описание ТЭГа IDOlympic - Идентификатор олимпиады (заполняется из классификатора olympicsList)

3. добавлен раздел 3.2.36 orgDirection
в архив добавлены соответствующие xsd и xml для orgDirection

API спецификация версия 1.8.8 (от 22.04.2021):

22.04.2021_Specifikacija servisa vzaimodejjstvija (API-2) versija 1.8.8.docx (980kb) загружен 11 раз(а).

Файлы XSD XML схем:

22.04.2021_XSD 1.8.8.zip (100kb) загружен 4 раз(а).

Описание изменений:

версия спецификации 1.8.8 (изменения относительно версии 1.8.7):

1. стр. 269 исправлено описание поля DocumentCategoryFields

2. стр. 273 исправлено
XML пример пакета с данными для редактирования - Аналогично п. 3.2.15.1

3. стр. 282 исправлено
XML пример с данными для удаления - Аналогично п.3.2.15.3

4. в приложении 1 выделены цветом Header, Payload и Signature

5. стр. 280 строка в схеме <xs:element type="xs:string" name="Base64File"/>
изменена на <xs:element type="xs:string" name="Base64File" minOccurs="0"/> - фалй становится необязательным

6. стр. 125 убран тег name так как это связь с кафедрой или образовательной программой (убраны из соответсвующих схем ниже по тексту)

7. стр. 91 в таблице в описание исправлено на: IDLevelBudget Идентификатор уровня образования – содержит ссылку на id справочника levelBudget


архив xsd и xml:

1. document: поле base64file сделано не обязательным.

2. competitiveGroupProgram: убран тег name так как это связь с кафедрой или образовательной программой.

3. entrant: поменять здесь и ниже схемы в сепцификации
1)Теги City, Area, CityArea, Building1,Building2 ,Apartment - сделаны не обязательными
2)IsRegistration поменялся тип поля с int на bool
3)убран тег UidEpgu
4)Добавлен тег Place - Населенный пункт

4. identification:
1)из get и remove тег FileName - убран

5. documents:
1)убран тег IDDocumentSysCategory
2)добален тег IDDocVersion - версия документа – содержит ссылку на поле DocVersion справочника documentTypes

Документ "Спецификация 1.8.8":

6. Пакет CompetitiveGroup - добавлено описание тэга IDOCSO

7. Пакет subdivisionOrg - В разделе "Получение данных" исправлена XSD-схема

8. Пакет subdivisionOrg - В разделе "Удаление данных" добавлены XML и XSD-схемы

9. Пакет campaing - В разделе "Получение данных" исправлена XML-схема

10. Пакет achievement - В разделе "Удаление данных" добавлены XML и XSD-схемы

11. Пакет competitiveGroup - В разделе "Редактирование данных" исправлена XML-схема

12. Пакет competitiveGroupProgram - В разделе "Редактирование данных" добавлена XML-схема

13. Пакет competitiveBenefit - В разделе "Получение данных" исправлена XML-схема

14. Пакет entranceTest - В разделе "Редактирование данных" добавлена XML-схема

15. Пакет entranceTestBenefit - В разделе "Редактирование данных" добавлена XML-схема

16. Пакет entranceTestBenefit - В разделе "Удаление данных" добавлены XML и XSD-схемы

17. Пакет entranceTestLocation - В разделе "Добавление данных" изменены XML и XSD-схемы

18. Пакет entranceTestLocation - В разделе Получение данных" изменены XML и XSD-схемы

19. Пакет entrant - В разделе "Добавление данных" изменены XML и XSD-схемы

20. Пакет identification - В разделе "Добавление данных" изменена XML-схема

21. Пакет identification - В разделе "Получение данных" изменена XML-схема

22. Пакет identification - В разделе "Удаление данных" изменена XSD-схема

23. Пакет appAchievment - В разделе "Получение данных" изменена XML-схема

24. Пакет restartDocumentCheckList - В разделе "Добавление данных" изменен XML-пакет с примером данных для загрузки

25. Пакет editApplicationStatusList - В разделе "Добавление данных" изменен XML-пакет с примером данных для загрузки

26. Пакет appAchievement - В разделе "Удаление данных" изменена XSD схема для формирования XML-пакета с данными, изменен XML пример с данными для удаления

27. Пакет entranceTestAgreedList - В разделе "Добавление данных" изменен XML-пакет с примером данных для загрузки

28. Пакет entranceTestResultList - В разделе "Добавление данных" изменен XML-пакет с примером данных для загрузки

29. Пакет sentToEpguEtc - В разделе "Добавление данных" изменен XML-пакет с примером данных для загрузки

30. Пакет competitiveGroupApplicationsList - В разделе "Добавление данных" изменен XML-пакет с примером данных для загрузки

31. Пакет applicationsRating - изменена XSD схема для формирования XML-пакета с данными, изменен XML-пакет с примером данных для загрузки

32. Пакет CompetitiveGroup - IDOCSO (Непонятно имя справочника, также отсутствует в описании элементов пакета) - ИСПРАВЛЕНО

33. Пакет entranceTest - UIDReplaceEntranceTest (Уточнить является ли он другим полем сущности entranceTest или отдельной сущностью) - ИСПРАВЛЕНО

34. Пакет educationProgram - IDOCSO (IDOKSO) - ИСПРАВЛЕНО

35. Повторяющиеся сущности editApplicationStatusList (в версии 1.8.7 два пункта в оглавлении (3.2.18 и 3.2.25) имеют одинаковое имя сущности) - Удален раздел 3.2.25 как копия - ИСПРАВЛЕНО

36. Повторяющиеся сущности AppAchievement (в версии 1.8.7 два пункта в оглавлении (3.2.17 и 3.2.27) имеют одинаковое имя сущности) - удален раздел 3.2.27 как копия - ИСПРАВЛЕНО

37. Пакет entranceTestLocation - повторяющиеся куски в xsd схеме - ИСПРАВЛЕНО

38. Пакет competitiveGroupSpeciality - IDOCSO (IDOKSO) - ИСПРАВЛЕНО

39. Почему принято решение публиковать спецификацию в формате PDF? Docx удобнее в работе - Решение принимает Минобр.

40. Кто должен гарантировать, что категория документа будет соответствовать типу документа?
Справочника категорий вроде не наблюдается? И если Категория однозначно соответствует Типу, то зачем две ссылки? - Есть справочник категорий документов documentCategories.

41. Учтены ли указанные неточности в новой версии спецификации, которая была обещана к публикации вчера 05/04/2021- Да

42. Кроме этого, в самой документации в примере с XML-пакетом Entrant, есть теги <Building1>, <Building2>, а в таблице с описанием что значит каждый тег – их нет. Нужны ли они, и если да, то что они значат. - ИСПРАВЛЕНО

43. В спецификации 1.8.7 в XML Entrant в элементе Address есть следующие теги, которые на данный момент указаны как обязательные:
<FullAddr>
<IndexAddr>
<IsRegistration>
<IDRegion>
<Area>
<City>
<CityArea>
<Street>
<House>
<Building1>
<Building2>
<Apartment>
Однако, при заполнении адреса абитуриента у него может, например, присутствовать город, но отсутствовать населенный пункт или наоборот. Возможны разные комбинации тегов.
Уточните, какие из этих являются необязательными. - ИСПРАВЛЕНО

44. Для пакета appAchievement - Ответ: добавлено описание "UIDCampaignAchievement" - это ссылка на UID Achivment http://10.10.11.222/proj.../wiki/Achievement-scheme

45. Для пакета document - DocumentCategoryFields - нечто динамическое. Куски описания разбросаны по типам документов. Нет сводного описания всех возможных Fields? Ответ: в динамические поля в документах будет перерабатываться, планируется отдавать динамические поля в составе классификатора documentTypes.

46. Для пакет applicationList - по сути это список/коллекция элементов сущности Application. Есть отдельное описание Application? - Нет отдельного описания Application. Ответ: applicationList- схема предполагающая несколько элементов Application, будет переделан в один элемент Application.

47. Что обозначает тег <IsRegistration>, нужен ли он (в описании тегов его нет)? И если нужен, то какие параметры он может принимать? Ответ: IsRegistration -призанак является ли адрес, адресом регистрации, может принимать заначения true или false тип boolean

48. Для пакета CompetitiveBenefit - Creative и Athletic в описание признаки текстовые а в примере стоит false - Ответ: Creative и Athletic их заменит поле IDOlimpicType которое необходимо заполнять из нового классификатора olympicTypes

49. Для пакета entranceTestLocation проверить поля в частности UIDEPGU - Ответ: проверить поля в частности UIDEPGU - поле убрано

50. Переименовать в спецификации Calendar На location - Ответ: обновили в redmine

Отредактировано пользователем 26 апреля 2021 г. 11:43:16(UTC)  | Причина: Не указана

API спецификация версия 1.0.3 (от 23.03.2022):

Specifikacija API 20220323 1.0.3.docx (807kb) загружен 13 раз(а).

Файлы XSD XML схем:

xsd_API 20220323.zip (115kb) загружен 7 раз(а).

API спецификация версия 1.1.1 (от 27.05.2022):

Specifikacija API 20220527 1.1.1.docx (847kb) загружен 29 раз(а).

Файлы XSD XML схем:

xsd_API 20220527.zip (105kb) загружен 17 раз(а).