You are on page 1of 38

web v 0.

11
web

(Alexander Litvinenko)

web v 0.11

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

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

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

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

2.1.

(
, ). ( )
, ,
.
:

Int ,
. , 1 2 .
GUID uniqueidentifier -

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

, , .
, ,
.

web v 0.11

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> (
dLanguages).
, SOAP

XML. , LanguagesGet
:
<?xml version="1.0" encoding="utf-8" ?>
- <ArrayOfDLanguages xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://tempuri.org/">
- <dLanguages>
<Id_Language>1</Id_Language>
<Code>UK</Code>
<NameLanguage></NameLanguage>
</dLanguages>
- <dLanguages>
<Id_Language>2</Id_Language>
<Code>RU</Code>
<NameLanguage></NameLanguage>
</dLanguages>
- <dLanguages>
<Id_Language>3</Id_Language>
<Code>EN</Code>
<NameLanguage>English</NameLanguage>
</dLanguages>
</ArrayOfDLanguages>

web v 0.11

, .

web .
Get null (Nil) return
. XML :
<?xml version="1.0" encoding="utf-8" ?>
<ArrayOfDLanguages xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xsi:nil="true"
xmlns="http://tempuri.org/" />


GetLastError.

web v 0.11

2.3.

web EDBO .
1. , web .
2. , .
3. web .

web EDBO.
, web EDBO.
web , , .
web
, , (,
UniversityFacultetAdd 0). web
, .
,
, GetLastError,
.
.
( )
100-198
199
200
1000-1999

, (
) .
web .
,
.
web .

web v 0.11

2.4.

EDBO.

web Login
GUID . GUID
, web
.
.
, ,

ClearPreviewSession .
, 30

.

10

web v 0.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
.
,
.
, .
~<Type1>#<Value11>#<Value12>#<Value13>~<Type2>#<Value21>#<Value22>#<Value23>~<TypeN>#<Val
ueN1>#<ValueN2>#<ValueN3>

Type .
Value .

11

web v 0.11

,
. .
.
, Get
.
Get1.

1
2
3
4


Id_Get

Id_GetGroup

Id_Get



- ::

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

12

web v 0.11

2.6.

,
.
- .
-
.
,
1 .
.



.
.
.






Web
EDBOGuides
LanguagesGet
KOATUUGet, KOATUUGetL1,
KOATUUGetL2,
KOATUUGetL3
EducationTypesGet
StreetTypesGet
SpecRedactionsGet
UniversityAcreditatinTypesGet

Web

EDBOGuides,
EDBOPerson
EDBOGuides

EDBOGuides
EDBOGuides
EDBOGuides
EDBOGuides

UniversityGetCurentRequestSeason

EDBOGuides

UniversitiesGet
UniversityFacultetsGet
UniversityFacultetSpecialitiesGet
BenefitsGet
UniversityCoursesGet
SpecDirectionsSubjectsGet

EDBOGuides
EDBOGuides
EDBOGuides
EDBOGuides
EDBOGuides
EDBOGuides
EDBOGuides

QuotasGet
UniversityCoursesGet

EDBOGuides
EDBOGuides

SubjectsGet

EDBOPerson
PersonSexTypesGet
PersonContactTypesGet
PersonDocumentTypesGet
PersonEducationTypesGet
PersonEducationFormsGet
PersonRequestSeasonsGet
PersonRequestExaminationCausesGet
PersonRequestStatusTypesGet

EDBOPerson
EDBOPerson
EDBOPerson
EDBOPerson
EDBOPerson
EDBOPerson
EDBOPerson
EDBOPerson

13

web v 0.11

PersonEnteranceTypesGet

EDBOPerson

14

web v 0.11

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 .
. ,
.
.

15

web v 0.11

AttestatValue . .
2 . :
< >/< >


, ..
.
(Kode_School),
.

. - (
PersonEntrantAdd PersonEntrantAutoAdd)
.
,
GUID .

.

2.7.1.2.

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

. :

.
.
.
.
.
.
( 2011 ).

(, , ).
(, , , ).

16

web v 0.11

(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.

17

web v 0.11

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.

18

web v 0.11

19

web v 0.11

2.8.

.
1. -
2. , .

.
, BenefitsGet web EDBOGuides.
(2) (1).
PersonBenefitsAdd
.

2.8.1.


.
.
, , ,
(
OlympiadsAwardsGet web EDBOGuides).
,

.
, .

2.8.2.


.
.
,
. , , , ,
,
.

20

web v 0.11

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)

21

web v 0.11


Id_Pers
onReque
stStatu
sType
1

,
.

.
- .
-

2
3
4
5
6
7
8

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


(9)
(4)
5/3.
(5), (6), (2)
(7), (6)
(5)
.
(2), (3), (4),
(9)
(2), (3), (4)

( 8) ( 1)

,
PersonRequestsStatusesGet.

2.9.3.


( )
.
.
()
.
UniversityFacultetSpecialitiesSubjectsGet web EDBOGuides.

PersonRequestExaminationsAdd web EDBOPerson.

PersonRequestExaminationsValueChange.
PersonRequestExaminationsGet.

22

web v 0.11

3.
.

3.1.

.
.
.
.

3.1.1.

PersonEntrantAdd
PersonEntrantAddFromString.
web EDBOPersons. , , ,
..
, .
,
,
(, , , )
.
,
. , PersonsFind

. 2

3.1.2.


( )
, .

23

web v 0.11

3.1.3.


,

.

, .
, , ,
.
,
( )
.
web . ,
.

, .
PersonEducationsAdd.

Id_PersonEducationHistoryType (
PersonEducationHistoryTypesGet):

10 ( ).
.
15 . .
20 . .
50 . .
61 .
.


.
Id_PersonEducationForm
PersonEducationDateBegin
Id_PersonEducationPaymentType
SpecCode

.
.

,
.
SpecGet.
()

. , ,

SpecCode
5.06010105

24

web v 0.11

Id_PersonEducationHistoryType
PersonEducationHistoryDateBegin

Id_Qualification
Id_Course
Id_AcademicYear

Id_PersonEducationHistoryOrders

Id_PersonDocument

,


Id_PersonEducationHistoryType.
,
.
.

.
,
,

,
.

3.2.1.

,
.



. ,
.
(
Id_PersonEducation)
.
PersonEducationsStatusChange*
. 3.3

3.1.4.

.
.
PersonsStudentsGrupsGet ,
, ,
, , ()
PersonsStudentsGrupsPersonsGet .

25

web v 0.11

PersonsStudentsGrupsPersonsFind .
PersonEducationsGet (
)
PersonEducationHistoryGet
.

3.2.

, .

3.2.1.


.
.

PersonEducationHistoryOrdersGet
PersonEducationHistoryOrdersAdd
PersonEducationHistoryOrdersEdit .
PersonEducationHistoryOrdersDel .
PersonEducationHistoryOrdersStatusChange .
PersonEducationHistoryOrdersDataGet
.

( PersonEducationHistoryType)
(
PersonEducationHistoryTypesGet).
. ,
110 .
, ,
- .

3.2.2.

UniversityGroupsAdd

26

web v 0.11

UniversityGroupsEdit
UniversityGroupsDel
UniversityGroupsGet .


.
, , , ,

.
. ,

.

3.3.

(
PersonEducationAdd)
PersonEducationsStatusChange*.

3.3.1.

().

PersonEducationsStatusChangePaymentType
.
Id_PersonEducationHistoryType =12 .
:

3.3.2.

()
()
()
PersonEducationsStatusChangeMove :

27

web v 0.11


Id_PersonEducationHistoryType = 14 .
:

3.3.3.


PersonEducationsStatusChangeSetGroups.
.
.

3.3.4.

()

()
PersonEducationsStatusChangeCancelEducation. ()
Id_PersonEducationHistoryType = 110 .
:

28

web v 0.11

3.3.5.

()
PersonEducationsStatusChangeRenewal. ()
Id_PersonEducationHistoryType = 20 .
, .

3.3.6.


PersonEducationsStatusChangeAcademicLeaveTo. ()
Id_PersonEducationHistoryType = 60
.
:

3.3.7.

.

PersonEducationsStatusChangeAcademicLeaveFrom. ()

Id_PersonEducationHistoryType = 61 .
,

3.3.8.

.
, ,

PersonEducationsHistoryLastDel.
. , , .
( ),

.
,
.

29

web v 0.11

4. .
web
/.
.

:

,
, , .
, ,
.
,
.

, .

30

web v 0.11

5. .
.


GUID

(

)



GUID

GUID

GUID

GUID

GUID

GUID


GUID .

,

.
GUID


,


.
GUID




.

SessionGUID

string


()
Login

Id_Language

int

LanguagesGet

KOATUUCode

string

KOATUUGet

Id_KOATUU

int

KOATUUGet

Id_EducationType

int

EducationTypesGet

Id_StreetType
Id_SpecRedactions

int
int

StreetTypesGet
SpecRedactionsGet

SpecCode

string

SpecGet

SpecIndastryCode

string

SpecGet

SpecDirectionsCode

string

SpecGet

SpecSpecialityCode

string

SpecGet

SpecScecializationCode

string

SpecGet

Kode_School
Id_UniversityAcreditatinType

string
int

SchoolsGet
UniversityAcreditatinTypesGet

UniversityKode
Id_University

string
int

UniversitiesGet
UniversitiesGet

UniversityFacultetKode

string

UniversityFacultetsGet

Id_UniversityFacultet

int

UniversityFacultetsGet

UniversitySpecialitiesKode

string

UniversityFacultetSpecialitiesGet

Id_UniversitySpecialities

int

UniversityFacultetSpecialitiesGet

31

web v 0.11



GUID

Id_Benefit

int

BenefitsGet

Id_BenefitGroup

int

BenefitsGet

Id_UniversityCourse

int

UniversityCoursesGet

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

32

web v 0.11

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

.
6.2. ,

.
6.3. .

33

web v 0.11

7. .
web
GetLanguage.

7.1.

PHP

<?php
global $soapHost;
global $soapAddress;
$soapHost = "http://test.edbo.gov.ua:8080/";
$soapAddress = $soapHost."EDBOGuides/EDBOGuides.asmx?WSDL";

global $soapClient;
$soapClient = new SoapClient($soapAddress, array('encoding'=>'utf-8'));
class Soap{
private $soapClient;
private function buildObject($data){
$res = null;
if(is_array($data) || is_object($data)){
$res = array();
foreach($data as $key=>$value){
if(is_string($key)){
switch($key){
case "string":
$res[] = $value;
break;
case "int":
$res[] = $value;
break;
case "any":// xml
$res[] = simplexml_load_string("<?xml version=\"1.0\"?><document>".$value."</document>");
break;
default:
$res[] = $this->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){

34

web v 0.11
print "Exception in try call method $method<br>\n";
print "Parameters:<br>\n";
print_r($params);
print "<br>\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)
{

35

web v 0.11
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);
}

}
}
}

36

web v 0.11

8.
0.11

3.

0.10

2.5.1 .

0.9

web EDBOPerson v0.15.


0.8

0.7

.
.

0.6

SpecDirectionsSubjectsGet

EDBOGuides

QuotasGet
UniversityCoursesGet

EDBOGuides
EDBOGuides

PersonRequestExaminationCausesGet
PersonRequestStatusTypesGet
PersonEnteranceTypesGet

EDBOPerson
EDBOPerson
EDBOPerson

0.5

.
.
.

BenefitsGet
UniversityCoursesGet

EDBOGuides
EDBOGuides

37

web v 0.11


GUID

Id_Benefit

int

BenefitsGet

Id_BenefitGroup

int

BenefitsGet

Id_UniversityCourse

int

UniversityCoursesGet

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

38