25.02.2015 Views

The following operations are supported

The following operations are supported

The following operations are supported

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Population Manager Web Service<br />

WSPopMan<br />

• GetPerson<br />

Hämtar en persons uppgifter utifrån ett fullständigt angivet personnummer.<br />

Tjänsten söker först i det aktiva befolkningsregistret. Om det ej blir träff söker<br />

tjänsten i registret för avregistrerade.<br />

Vid ej träff här har tjänsten framöver möjlighet att söka efter utomlänspersoner<br />

online i Skatteverkets Befolkningsregister. Detta förutsätter dock att Landstinget<br />

har avtalat om detta med Skatteverket och att anropande system har tillåtelse från<br />

landstinget att göra en sådan slagning.<br />

• GetPopListByPnr<br />

Hämtar en post från tabellen Befolkning utifrån ett fullständigt personnummer. Om<br />

ett ofullständigt personnummer anges erhålls en lista av poster (Max 200 1 ).<br />

• GetPopListByName<br />

Hämtar en post eller en lista av poster från tabellen Befolkning utifrån angivet<br />

namn eller delar av det (Max 200 2 ).<br />

• GetCanListByPnr<br />

Hämtar en post eller en lista av poster från tabellen Avregistrerade utifrån ett<br />

personnummer eller delar av det (Max 200 3 ).<br />

• GetCanListByName<br />

Hämtar en post eller en lista av poster från tabellen Avregistrerade utifrån angivet<br />

namn eller delar av det (Max 200 4 ).<br />

Alla dessa tjänster returnerar en formaterad xml-string.<br />

Exempel på tjänsteanrop (C#):<br />

string GetPopListByPnr(Login login,string sPnr, string sortBy)<br />

string GetPopListByName(Login login,string sName, string sortBy)<br />

string GetCanListByPnr(Login login, string sPnr, string sortBy)<br />

string GetCanListByName(Login login, string sName, string sortBy)<br />

string GetPerson(Login login,string sPnr, bool flagOtherArchive)<br />

login = Klass definierad i webtjänsten. Den består av 2 ”properties”: UserName och Password.<br />

sPnr = Personummer<br />

sName = Efternamn<br />

sortBy = Fält namn<br />

flagOtherArchive = Indikerar om tjänsten ska leta efter personuppgifter i ett annat<br />

arkiv (t.ex. Skatteverket) i det fall personen inte finns i det lokala<br />

befolkningsregistret 5 (True = Ja).<br />

1 Antalet max poster är konfigurerbart<br />

2 Antalet max poster är konfigurerbart<br />

3 Antalet max poster är konfigurerbart<br />

4 Antalet max poster är konfigurerbart<br />

5 OBS att systemet också måste ha tillstånd från landstinget för att kunna göra slagningen mot Skatteverket


Webbtjänsten returnerar även extra information via SOAP meddelande:<br />

• HeaderErrorInfoValue: klass som returnerar eventuella felmeddelande med<br />

respektive fel kod.<br />

• HeaderInfoValue: klass som returnerar antalet träffar, maximalt antal poster<br />

som webtjänsten kan leverera (definieras i webbserverns konfigurationsfil,<br />

Web.Config) och namnet på källan där uppgifterna hämtas.<br />

Programmerings exempel (C#):<br />

…<br />

…<br />

string xmlResult;<br />

string sPNR = ”191212121212”;<br />

DataSet ds = new DataSet();<br />

PopManServer.Login myLogin= new PopManServer.Login();<br />

myLogin.UserName="sven";<br />

myLogin.Password="solen";<br />

PopManServer.WsPopMan myWs = new PopManServer.WsPopMan();<br />

//Anropar GetPerson med önskan om att gå vid<strong>are</strong> till<br />

//Skatteverket om personen ej återfinns eller är utflyttad.<br />

xmlResult=myWs.GetPerson(myLogin,sPNR,true);<br />

try<br />

{<br />

//Kolla om webtjänsten returnerar ngn fel<br />

if (myWs.HeaderErrorInfoValue.Code !=0)<br />

{<br />

MessageBox.Show(myWs.HeaderErrorInfoValue.Description +" -<br />

Code: " +<br />

myWs.HeaderErrorInfoValue.Code.ToString()<br />

);<br />

}<br />

else<br />

{<br />

//Kolla om man har fått ngn träff<br />

if (myWs.HeaderInfoValue.RowsCount > 0)<br />

{<br />

//Kopierar resultatet i en DataSet<br />

//som sedan kan bearbetas vid<strong>are</strong> enl dokumentationen<br />

//för retursvar.<br />

ds.ReadXml(new StringReader(xmlResult));<br />

}<br />

}<br />

}<br />

Catch(Exception ex)<br />

{<br />

MessageBox.Show(ex.Message);<br />

}

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!