web services main

web v 0.11 web (Alexander Litvinenko)

web v 0.11

2

1. .............................................................................................................................................. 4 2. web . ................................................................ 5 2.1. . .................................................................................................. 6 2.2. . ................................................................................................................... 7 2.3. . ............................................................................................................................. 9 2.4. EDBO. ....................................................................................................................... 10 2.5. . .................................................................................................................................... 11 2.5.1. . ........................................................................................................... 11 2.6. . ................................................................................................................ 13 2.7. ................................................................................................................... 15 2.7.1. - ........................................................................................ 15 2.7.1.1. - . .................................................................. 15 2.7.1.2. . ..................................................... 16 2.7.2. .................................................................................................... 17 2.7.3. . ........................................................ 17 2.7.3.1. . ............................................................................................. 17 2.7.3.2. .......................... 18 2.8. ............................................................................................... 20 2.8.1. . ................................................................................................... 20 2.8.2. ............................................................................................................................................. 20 2.9. .............................................................................................................................. 21 2.9.1. . ............................................................................................................ 21 2.9.2. . ..................................................................................................... 21 2.9.3. . ................................................................................................................ 22 3. ............................................................................................................................................. 23 3.1. . ....................................................................................................................... 23 3.1.1. ........................................................................................................................ 23 3.1.2. ................................... 23 3.1.3. ............................. 24 3.1.4. . ...................... 25 3.2. .................................................................... 26 3.2.1. .............................................................................................................. 26 3.2.2. ......................................................................................................................... 26 3.3. . ........................................................................................ 27 3.3.1. (). ................................................... 27 3.3.2. () () .................................................................................................................................................... 27 3.3.3. ..................................................................................................... 28 3.3.4. () .......................................................................................................... 28 3.3.5. ......................................................................................................... 29 3.3.6. ........................................................................................... 29 3.3.7. . ................................................................... 29 3.3.8. . ....................................................... 29 4. . .......................................................................................................... 30 5. . ................................................................................................................................. 31 6. . ........................................................................................................................... 33 7. . ............................................................................................................................................ 34 7.1. PHP ...................................................................................................................................................... 34 7.2. C# (Framework 2.0, WinForm) ............................................................................................................ 35 8. ........................................................................................................ 37

0.11 ............................................................................................................................................. 37

web v 0.11

3

0.10 ............................................................................................................................................. 37 0.9 ............................................................................................................................................... 37 0.8 ............................................................................................................................................... 37 0.7 ............................................................................................................................................... 37 0.6 ............................................................................................................................................... 37 0.5 ............................................................................................................................................... 37 0.4 ............................................................................................................................................... 38 0.3 ............................................................................................................................................... 38 0.2 ............................................................................................................................................... 38 0.1 ............................................................................................................................................... 38

web v 0.11

4

1.

(

) web ,

, ,

.

, ,

. .

web .

1. http://test.edbo.gov.ua:8080/EDBOGuides/EDBOGuides.asmx - web

EDBO. web

Manual_EDBOGuides.pdf.

2. http://test.edbo.gov.ua:8080/EDBOPerson/EDBOPerson.asmx- web

(, ..). web

Manual_EDBOPerson.pdf.

web SOAP (Simple Object Access Protocol).

SOAP

XML.

, ..

http://forum.edbo.gov.ua/

http://test.edbo.gov.ua/EDBOCLientW/ web

.

web v 0.11

5

2. web .

web ,

, .

web web :

1. .

2. .

web , :

Login .

Logout .

ChangePassword .

LanguagesGet .

GlobaliInfoGet EDBO

GetLastError .

web .

.

Manual_EDBOGuides.pdf Manual_EDBOPerson.pdf..

web v 0.11

6

2.1. .

(

, ). ( )

, ,

.

:

Int ,

. , 1 2 -

.

GUID uniqueidentifier -

(

).

, GUID 00000000-0000-

0000-0000-000000000000 (, 2E0B9E77-E6F3-473F-B917-0526E435939B).

String ,

.

, , .

, , .

, ,

.

web v 0.11

7

2.2. .

web

.

Int . Add, Edit, Del.

String , Login.

Array , Get.

Nil Get

.

Array.

.NET web

GET.

, LanguagesGet .

public class dLanguages { public int Id_Language { get; set; } public string Code { get; set; } public string NameLanguage { get; set; } }

LanguagesGet List (

dLanguages).

, SOAP

XML. , LanguagesGet

:

-

-

1

UK

-

2

RU

-

3

EN

English

web v 0.11

8

, .

web .

Get null (Nil) return

. XML :

GetLastError.

web v 0.11

9

2.3. .

web EDBO .

1. , web .

2. , .

3. web .

web EDBO.

, web EDBO.

web , , .

web

, , (,

UniversityFacultetAdd 0). web

, .

,

, GetLastError,

.

.

( )

100-198 , ( ) .

199 web .

200 , .

1000-1999 web .

web v 0.11

10

2.4. EDBO.

web Login

GUID . GUID

, web

.

.

, ,

ClearPreviewSession .

, 30

.

web v 0.11

11

2.5. . web

.NET SOAP HTTP POST

.

, Login

http://193.23.225.254/EDBOCommon/EDBOCommon.asmx?op=Login

SOAP 1.1 SOAP 1.2

HTTP POST.

web .

web ,

( ) web . :

SessionGUID - GUID , web .

.

Id_Language , ,

EDBO.

.

1 .

ActualDate . EDBO

,

.

.. ::. UniversityFacultetsGet

ActualDate 25.06.1975 04:00:00 .

2.5.1. . , .

web

.

,

.

, .

~###~###~###

Type .

Value .

web v 0.11

12

,

. .

.

, Get

.

Get1.

Id_Get 55,56,57

: ~1#55#56#57

Id_Get 41,42,43 Id_GetGroup 101

:

~1#41#42#43~2#101

Id_Get 41,42,43, Id_GetGroup, 01-01-2012

: ~1#41#42#43~2#101~3#2012-01-01 00:00:00

Id_Get 41,42,43, Id_GetGroup, 01-01-2012

* : ~1#41#42#43~2#101~3#2012-01-01 00:00:00~4#*

Id_Get 41,42,43, *

:

~1#41#42#43~4#*

~1#41#42~4#*~1#43

1 Id_Get

2 Id_GetGroup

3 Id_Get

-- ::

4

web v 0.11

13

2.6. .

,

.

- .

-

.

,

1 .

.

Web Web

EDBOGuides

LanguagesGet EDBOGuides, EDBOPerson

KOATUUGet, KOATUUGetL1, KOATUUGetL2, KOATUUGetL3

EDBOGuides

EducationTypesGet EDBOGuides

StreetTypesGet EDBOGuides

SpecRedactionsGet EDBOGuides

UniversityAcreditatinTypesGet EDBOGuides

UniversityGetCurentRequestSeason EDBOGuides

. UniversitiesGet EDBOGuides

. UniversityFacultetsGet EDBOGuides

. UniversityFacultetSpecialitiesGet EDBOGuides

SubjectsGet EDBOGuides

BenefitsGet EDBOGuides

UniversityCoursesGet EDBOGuides

SpecDirectionsSubjectsGet EDBOGuides

QuotasGet EDBOGuides


EDBOPerson

PersonSexTypesGet EDBOPerson

PersonContactTypesGet EDBOPerson

PersonDocumentTypesGet EDBOPerson

PersonEducationTypesGet EDBOPerson

PersonEducationFormsGet EDBOPerson

. PersonRequestSeasonsGet EDBOPerson

PersonRequestExaminationCausesGet EDBOPerson

PersonRequestStatusTypesGet EDBOPerson

web v 0.11

14

PersonEnteranceTypesGet EDBOPerson

web v 0.11

15

2.7. ( )

.

2.7.1. - , .

PersonEntrantAdd

.

PersonEntrantAutoAdd .

, , .

.

2.7.1.1. -

. ,

.

PersonEntrantAdd web EDBOPerson.

.

:

Resident 0 ( ) 1 ().

KOATUUCode 0000000000 Adress

.

Adress .

KOATUUCode .

.

0000000000

Id_StreetType .

Adress .

.

HomeNumber .

, . , .

(, ).

AttestatSeries, AttestatNumber, AttestatDate .

. ,

.

.

web v 0.11

16

AttestatValue . .

2 . :

/

, ..

.

(Kode_School),

.

. - (

PersonEntrantAdd PersonEntrantAutoAdd)

.

,

GUID .

.

2.7.1.2.

. , , , . . 2011 . PersonEntrantAutoAdd web EDBOPerson.

. :

.

.

.

.

.

.

( 2011 ).

.

(, , ).

(, , , ).

web v 0.11

17

(Kode_School),

( 2011

)

( ).

( PersonEntrantAdd

PerosnEntrantAutoAdd ) -

.

,

GUID .

.

2.7.2.

.

PersonDocumentsZnoAdd web EDBOPerson.

PersonDocumentsZnoAdd Id_Person,

(, , ).

.

PersonDocumentsZnoAdd

. web

PersonDocumentsZnoAdd (

) .

2.7.3.

.

2.7.3.1. . A. , ,

PersonsFind, (

).

D. B.

web v 0.11

18

B. PersonsFind

.

, D. C.

C. , .

D.

D. , Person*Get.

E.

E. (,

, , ..) ,

. F.

F. (

5 3 )

PersonRequestCheckCanAdd. G.

G. .

(

)

2.7.3.2.

. N

.

PersonDocumentsZnoAdd. .

A. , PersonsFind,

(

). .

B.

B. PersonsFind

.

, . ,

C.

C. PersonDocumentsZnoAdd.

web v 0.11

19

web v 0.11

20

2.8.

.

1. -

2. , .

.

, BenefitsGet web EDBOGuides.

(2) (1).

PersonBenefitsAdd

.

2.8.1. .

.

.

, , ,

(

OlympiadsAwardsGet web EDBOGuides).

,

.

, .

2.8.2.

.

.

,

. , , , ,

,

.

web v 0.11

21

2.9. , .

2.9.1. . .

A.

, ,

, ( B). , ,

,

, , .

B. ,

PersonRequestCheckCanAdd ,

. .

C. PersonRequestAdd,

. D.

D. (

PersonRequestAdd), ,

PersonRequestQuotas*.

2.9.2. . .

.

.

A. (1)

, (8) .

(9).

B.

UniversityFacultetsGetRequests

B. () (4)

(2). (9)

.

(3). (3)

5/3. 4 .

C. () (4) .

(5) (6).

5 D. (6)

(5).

D. (5)

(7)

web v 0.11

22

Id_PersonRequestStatusType

, .

. - .

-

1 (2), (3), (4), (9)

2 (4) 3 5/3. ( 8) ( 1) 4 (5), (6), (2) 5 (7), (6) 6 (5) 7 . 8 , (2), (3), (4),

(9)

9 (2), (3), (4)

,

PersonRequestsStatusesGet.

2.9.3. .

( )

.

.

()

.

UniversityFacultetSpecialitiesSubjectsGet web EDBOGuides.

PersonRequestExaminationsAdd web EDBOPerson.

PersonRequestExaminationsValueChange.

PersonRequestExaminationsGet.

web v 0.11

23

3. .

3.1. . :

.

.

.

.

.

3.1.1. . PersonEntrantAdd

PersonEntrantAddFromString.

web EDBOPersons. , , ,

..

, .

,

,

(, , , )

.

,

. , PersonsFind

. 2

3.1.2.

( )

, .

web v 0.11

24

3.1.3.

,

.

, .

, , ,

.

,

( )

.

web . ,

.

, .

PersonEducationsAdd.

Id_PersonEducationHistoryType (

PersonEducationHistoryTypesGet):

10 ( ).

.

15 . .

20 . .

50 . .

61 .

.

.

Id_PersonEducationForm .

PersonEducationDateBegin .

Id_PersonEducationPaymentType

SpecCode , . SpecGet. () . , , SpecCode 5.06010105

web v 0.11

25

Id_PersonEducationHistoryType ,

PersonEducationHistoryDateBegin Id_PersonEducationHistoryType. , .

Id_Qualification .

Id_Course

Id_AcademicYear . , ,

Id_PersonEducationHistoryOrders , . 3.2.1.

Id_PersonDocument , .

:

.

. ,

.

(

Id_PersonEducation)

.

PersonEducationsStatusChange*

. 3.3

3.1.4.

. .

PersonsStudentsGrupsGet ,

, ,

, , ()

PersonsStudentsGrupsPersonsGet .

web v 0.11

26

PersonsStudentsGrupsPersonsFind .

PersonEducationsGet (

)

PersonEducationHistoryGet

.

3.2.

, .

3.2.1.

.

.

PersonEducationHistoryOrdersGet

PersonEducationHistoryOrdersAdd

PersonEducationHistoryOrdersEdit .

PersonEducationHistoryOrdersDel .

PersonEducationHistoryOrdersStatusChange .

PersonEducationHistoryOrdersDataGet

.

( PersonEducationHistoryType)

(

PersonEducationHistoryTypesGet).

. ,

110 .

, ,

- .

3.2.2. .

UniversityGroupsAdd

web v 0.11

27

UniversityGroupsEdit

UniversityGroupsDel

UniversityGroupsGet .

.

, , , ,

.

. ,

.

3.3. .

(

PersonEducationAdd)

PersonEducationsStatusChange*.

3.3.1.

().

PersonEducationsStatusChangePaymentType

.

Id_PersonEducationHistoryType =12 .

:

.

3.3.2.

()

() ()

PersonEducationsStatusChangeMove :

web v 0.11

28

Id_PersonEducationHistoryType = 14 .

:

.

3.3.3.

PersonEducationsStatusChangeSetGroups.

.

.

:

.

3.3.4. () ()

PersonEducationsStatusChangeCancelEducation. ()


:

web v 0.11

29

3.3.5. ()

PersonEducationsStatusChangeRenewal. ()


, .

3.3.6.

PersonEducationsStatusChangeAcademicLeaveTo. ()

Id_PersonEducationHistoryType = 60

.

:

.

3.3.7.

.

PersonEducationsStatusChangeAcademicLeaveFrom. ()


,

3.3.8.

. , ,

PersonEducationsHistoryLastDel.

. , , .

( ),

.

,

.

web v 0.11

30

4. .

web

/.

.

:

.

,

, , .

, ,

.

,

.

, .

web v 0.11

31

5. . .

()

GUID

SessionGUID string Login

Id_Language int LanguagesGet

KOATUUCode string KOATUUGet

. ( )

Id_KOATUU int KOATUUGet

Id_EducationType int EducationTypesGet

Id_StreetType int StreetTypesGet

Id_SpecRedactions int SpecRedactionsGet

GUID

SpecCode string SpecGet

GUID

SpecIndastryCode string SpecGet

GUID

SpecDirectionsCode string SpecGet

GUID

SpecSpecialityCode string SpecGet

GUID

SpecScecializationCode string SpecGet

GUID Kode_School string SchoolsGet

Id_UniversityAcreditatinType int UniversityAcreditatinTypesGet

GUID . UniversityKode string UniversitiesGet

, .

Id_University int UniversitiesGet

GUID

UniversityFacultetKode string UniversityFacultetsGet

, .

Id_UniversityFacultet int UniversityFacultetsGet

GUID

UniversitySpecialitiesKode string UniversityFacultetSpecialitiesGet

.

Id_UniversitySpecialities

int UniversityFacultetSpecialitiesGet

web v 0.11

32

Id_Benefit int BenefitsGet

Id_BenefitGroup int BenefitsGet

Id_UniversityCourse int UniversityCoursesGet

GUID

UniversityCourseCode string UniversityCoursesGet

GUID

PersonCodeU

string PersonsFind

Id_PersonSex int PersonSexTypesGet

Id_PersonContactType int PersonContactTypesGet

Id_PersonContact

int PersonContactsGet

Id_PersonAddress int PersonAddressesGet

Id_PersonDocumentType int PersonDocumentTypesGet

.

Id_PersonDocument int PersonDocumentsGet

.

Id_PersonEducationType int PersonEducationTypesGet

.

Id_PersonEducationForm int PersonEducationFormsGet

Id_PersonEducation int PersonEducationsGet

.

Id_PersonRequestSeasons int PersonRequestSeasonsGet

.

Id_PersonRequest int PersonRequestsGet

.

Id_PersonRequestStatusType int PersonRequestStatusTypesGet

. .

Id_Person int PersonsFind

Id_Subject int SubjectsGet

Id_PersonBenefit int PersonBenefitsGet

web v 0.11

33

6. .

6.1. , http://test.edbo.gov.ua

, , .

,

.

.

6.2. ,

.

6.3. .

web v 0.11

34

7. .

web

GetLanguage.

7.1. PHP buildObject($value); break; } } if(is_integer($key)){ $res[] = $this->buildObject($value); } } } else { $res = $data; } if(is_array($res) && count($res) == 1) $res = $res[0]; return $res; } public function invoke($method, $params){ try{ $invs = $this->soapClient->__soapCall($method, array($params)); $sresult = $invs->{$method."Result"}; $res = $this->buildObject($sresult); return $res; }catch(Exception $e){

web v 0.11

35

print "Exception in try call method $method\n"; print "Parameters:\n"; print_r($params); print "\n"; throw $e; } } public function __construct(){ global $soapClient; $this->soapClient = $soapClient; } } global $soap; $soap = new Soap(); $sessionId = $soap->invoke("Login", array("User" => "user", "Password" => "123456", "ClearPreviewSession" => 1, "ApplicationKey" =>"" )); if(preg_match("/([a-f\\d]{8})-([a-f\\d]{4})-([a-f\\d]{4})-([a-f\\d]{4})-([a-f\\d]{12})/i", $sessionId)){ $languages = $soap->invoke("LanguagesGet", array("SessionGUID" => $sessionId)); print_r($languages); } else print $sessionId; ?>

7.2. C# (Framework 2.0, WinForm) web reference EDBOGuide web

http://193.23.225.254/EDBOGuides/EDBOGuides.asmx

using System; using System.Collections.Generic; using System.ComponentModel; using System.Data; using System.Drawing; using System.Text; using System.Windows.Forms; using System.Web.Services.Description; using TestEDBOWebService.EDBOGuide; namespace TestEDBOWebService { public partial class Form1 : Form { public Form1() { InitializeComponent(); } private void button_Start_Click(object sender, EventArgs e) { EDBOGuides eg = new EDBOGuides(); string GUIDSession = eg.Login("user", "123456", 1, ""); Guid gSession =new Guid(); try { gSession =new Guid(GUIDSession); } catch (Exception) {

web v 0.11

36

MessageBox.Show(GUIDSession); } try { dLanguages[] lang = eg.LanguagesGet(gSession.ToString()); if (lang==null) { dLastError[] er=eg.GetLastError(gSession.ToString()); throw new Exception("Error code: "+er[0].LastErrorCode.ToString()+". "+er[0].LastErrorDescription); } } catch (Exception ex) { MessageBox.Show(ex.Message); } } } }

web v 0.11

37

8.

0.11 3.

0.10 2.5.1 .

0.9 web EDBOPerson v0.15.

0.8 .

0.7 .

.

0.6

.

SpecDirectionsSubjectsGet EDBOGuides

QuotasGet EDBOGuides


PersonRequestExaminationCausesGet EDBOPerson

PersonRequestStatusTypesGet EDBOPerson

PersonEnteranceTypesGet EDBOPerson

0.5 .

.

.

BenefitsGet EDBOGuides


web v 0.11

38

Id_Benefit int BenefitsGet

Id_BenefitGroup int BenefitsGet

Id_UniversityCourse int UniversityCoursesGet

GUID

UniversityCourseCode string UniversityCoursesGet

Id_PersonBenefit int PersonBenefitsGet

0.4 .

SubjectsGet EDBOGuides

. .

Id_Person int PersonsFind

Id_Subject int SubjectsGet

EducationTypesGet EDBOGuides

0.3 PHP

C# (Framework 2.0 WinForm)

0.2 3. .

4. .

0.1

web services main

Documents

web alexander litvinenko