Documentarea serviciului web de conectare programatică la ...



Documentarea serviciului web de conectare programatică la date şi export

Istoric modificari

|Versiune |Data |Autor |Sumar |

|1.0. |21/12/2012 |Indaco Systems |Prima versiune |

| | | | |

| | | | |

| | | | |

| | | | |

| | | | |

| | | | |

Cuprins

1. Introducere 4

2. Descrierea serviciului web de acces la date 4

3. Exemplu de apelare 10

Introducere

Acest document reprezintă serviciul web de interconectare şi export a datelor din Portal.

Descrierea serviciului web de acces la date

Serviciul web permite accesul la datele din portal despre dosare, părţi şi şedinţe.

Datele serviciului web sunt descrise în tabelul următor:

|  Denumire |Adresa interfata / namespace |Adresa WSDL |Descriere |

|Query |Adresa interfata | pentru interogat baza de |

| |{AdresaInterfata}: |sdl   |date de dosare, părţi, şedinţe |

| | /Query.asmx   | |ECRIS la nivel naţional |

| |Adresa namespace : http:// | | |

| |portalquery.just.ro/Query | | |

Se pot folosi link-urile din tabel pentru a accesa din browser o interfaţă web cu descrierea serviciilor.

Serviciile Web au fost create folosind platforma .NET 3.5 şi . Astfel, cei care utilizeaza aceste servicii folosind .NET se vor putea integra uşor. Totuşi, nu ar trebui să fie nici o dificultate pentru apelul acestor servicii folosind orice altă platformă de dezvoltare software (PHP, Java, etc.).

Serviciile Web folosesc mai multe enumerări SOAP ca tipuri de date simple cum ar fi Institutie care poate avea doar valorile conform listei de instanţe.

Aceste enumerări pot fi găsite în WSDL-urile serviciilor pe langă alte tipuri complexe de date.

Serviciile Web au fost create pentru apeluri de tip SOAP 1.1 sau SOAP 1.2.

Accesul la metodele servicului se face fără autentificare.

2.1 Descrierea metodelor

CautareDosare

Metoda se găseşte la adresa: {AdresaInterfata}?op= CautareDosare

Prototipul metodei este următorul:

[WebMethod(Description = "Cautare dosare dupa numar, obiect, institutie")]

public Dosar[] CautareDosare(

string numarDosar,

string obiectDosar,

string numeParte,

Institutie? institutie,

DateTime? dataStart,

DateTime? dataStop

)

Parametrii metodei sunt descrişi în tabelul următor:

|Nr. |Parametru |Tip |Descriere |Observatii |

| |numarDosar |string |Numărul dosarului (număr unic | |

| | | |dosar, format | |

| | | |[numar]/[identificator | |

| | | |institutie]/[an]) | |

| |obiectDosar |string |Obiectul dosarului | |

| |numeParte |string |Numele părţii din dosar | |

| |institutie |Institutie |Instituţia dosarului |Conform listei de |

| | | | |instituţii. |

| | | | | |

| |dataStart |DateTime |Data dosarului mai mare sau egală | |

| | | |cu dataStart | |

| |dataStop |DateTime |Data dosarului mai mică sau egală | |

| | | |cu dataStop | |

Valoarea returnată este: Dosar[] şi conţine datele despre dosare, părţi din dosare, căi de atac, şedinţe ale dosarelor conform criteriilor de căutare.

Se vor prezenta maxim 1000 de dosare care corespund criteriilor de căutare. Se pot folosi filtre suplimentare ca de exemplu Institutie, intervalul de timp al datei dosarului pentru a limita numărul de dosare la un subset mai restrâns.

Se va completa obligatoriu cel putin unul din parametrii: numarDosar, obiectDosar, numeParte.

CautareSedinte

Metoda se găseşte la adresa: {AdresaInterfata}?op= CautareSedinte

Prototipul metodei este următorul:

[WebMethod(Description = "Cautare sedinte dupa data, institutie")]

public Sedinta[] CautareSedinte(

DateTime dataSedinta,

Institutie institutie

)

Parametrii metodei sunt descrişi în tabelul următor:

|Nr. |Parametru |Tip |Descriere |Observatii |

| |dataSedinta |DateTime |Data şedinţelor dosarului | |

| |institutie |Institutie |Instituţia dosarului |Conform listei de |

| | | | |instituţii. |

| | | | | |

Valoarea returnată este: Sedinta[] si contine datele despre şedinţele şi listele de şedinţe conform criteriilor de căutare.

Se vor completa obligatoriu parametrii: dataSedinta şi institutie.

2.2 Descrierea tipurilor de date

Dosar

|Nr. |Membru |Tip |Descriere |Observatii |

| |numar |string |Numărul dosarului (format număr | |

| | | |unic) | |

| |Numar vechi |string |Număr în format vechi |Poate lipsi |

| |data |DateTime |Data dosarului | |

| |institutie |Institutie |Instituţia dosarului |Conform listei de instituţii |

| |departament |string |Departamentul (secţia) | |

| |categorieCaz |CategorieCaz |Categoria cazului |Conform listei de categorii |

| |stadiuProcesual |StadiuProcesual |Stadiu procesual al dosarului |Conform listei de stadii |

| |parti |DosarParte |Lista de partţi din dosar | |

| |sedinte |DosarSedinta |Lista de termene ale dosarului | |

| |caiAtac |DosarCaleAtac |Lista de căi de atac | |

DosarParte

|Nr. |Membru |Tip |Descriere |Observatii |

| |nume |string |Numele părţii din dosar |Nume, prenume sau denumire (dacă |

| | | | |este cazul) |

| |calitateParte |string |Calitatea părţii în dosar | |

DosarSedinta

|Nr. |Membru |Tip |Descriere |Observatii |

| |complet |string |Numele completului de judectă | |

| |data |DateTime |Data şedinţei | |

| |ora |string |Ora şedinţei | |

| |soluţie |string |Soluţia |Dacă se aplică (dacă la şedinţă |

| | | | |s-a înregistrat o soluţie) |

| |soluţieSumar |string |Soluţia descrisă pe scurt |Dacă se aplică (dacă la şedinţă |

| | | | |s-a înregistrat o soluţie) |

| |dataPronuntare |DateTime |Data pronunţării soluţiei | |

| |documentSedinta |DocumentSedinta |Tipul de document final în dosar| |

| |numarDocument |string |Numărul documentului final | |

| | | |dindosar | |

| |dataDocument |DateTime |Data documentului final dindosar| |

DosarCaleAtac

|Nr. |Membru |Tip |Descriere |Observatii |

| |dataDeclarare |DateTime |Data declarării căii de atac | |

| |parteDeclaratoare |string |Partea care a declarat calea de | |

| | | |atac | |

| |tipCaleAtac |string |Tipul căii de atac | |

Sedinta

|Nr. |Membru |Tip |Descriere |Observatii |

| |departament |string |Departamentul (secţia) | |

| |complet |string |Numele completului de judectă | |

| |data |DateTime |Data şedinţei | |

| |ora |string |Ora şedinţei | |

| |dosare |SedintaDosar |Lista de dosare din şedinţă | |

SedintaDosar

|Nr. |Membru |Tip |Descriere |Observatii |

| |numar |string |Numărul dosarului (format numar | |

| | | |unic) | |

| |numar vechi |string |Număr în format vechi |Poate lipsi |

| |data |DateTime |Data dosrului | |

| |ora |string |Ora şedinţei | |

| |categorieCaz |CategorieCaz |Categoria cazului |Conform listei de categorii |

| |stadiuProcesual |StadiuProcesual |Stadiu procesual dosarului |Conform listei de stadii |

2.3 Descrierea WSDL

Descrierea WSDL se găseşte la adresa:

Exemplu de apelare

Ataşat la documentaţia de descriere a serviciului se găseşte un exemplu de apelare a serviciului folosind o aplicaţie .Net Windows Forms.

Pentru configurarea referinţei la serviciul WEB se foloseste adresa

Apelul la metodele serviciului se poate face ca în exemplul următor:

public partial class Form1 : Form

{

……

private void buttonCautareSedinte_Click(object sender, EventArgs e)

{

PortalWS.Query ws = new PortalWS.Query();

PortalWS.Sedinta[] ret = ws.CautareSedinte(Convert.ToDateTime(“01/01/2012”),

PortalWS.Institutie.CurteadeApelALBAIULIA);

if (ret != null)

MessageBox.Show(ret.Length.ToString() + " rezultate");

}

private void buttonCautareDosare_Click(object sender, EventArgs e)

{

PortalWS.Query ws = new PortalWS.Query();

PortalWS.Dosar[] ret = ws.CautareDosare(null, null, “ionescu”, null, null, null);

if (ret != null)

MessageBox.Show(ret.Length.ToString() + " rezultate");

}

……

}

................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download