ODIN-webservice ændringer release 2010 v2.0

Transkript

1 DOKUMENTATION OG VEJLEDNING ODIN-webservice ændringer release 2010 v2.0 Indholdsfortegnelse 1. Nye webservice metoder Anvendelse af køretøjer og personel fra fremmede beredskaber ifm. indberetning af udrykningsaktivitet Angivelse af assisterende beredskab(er i en rapport, således at der oprettes en underrapport ved det assisterende beredskab Ændring af funktion på eksisterende metoder Anvendelse af eksisterende metoder Udfyldelse af underrapporter...6 Bilag a... 7 Bilag b... 8 Bilag c... 9 Bilag d Beredskabsstyrelsen Datavej 16, 3460 Birkerød Tel brs@brs.dk

2 ODIN-webservice ændringer release 2010 v Nye webservice metoder 1.1 Anvendelse af køretøjer og personel fra fremmede beredskaber ifm. indberetning af udrykningsaktivitet Given situation: Beredskab B slukker i en del af Beredskab A s område (jf. aftale, med køretøjer/personel fra Station B-1. Udrykningsrapport skal indrapporteres af Beredskab A (skadested ligger i Beredskab A s område. Køretøjer/personel fra station B-1 skal fremgå af rapporten, der indrapporteres. Beredskab A anvender ODIN-webservice og Beredskab B anvender ODIN. OBS: For at kunne angive køretøjer fra Station B-1 i Beredskab B på den rapport der indrapporteres af Beredskab A via ODIN-webservice, er det en forudsætning, at: - Beredskab B i ODIN-webgrænsefladen har valgt at dele Station B-1 og stationens ressourcer (køretøjer/personel med Beredskab A. Beredskab A ODIN-webservice: Indrapportering med angivelse af delte ressourcer fra Beredskab B Beredskab B Station B-1 Station A-1 Hovedrapport I ODIN release 2010 v2.0 vil der blive oprettet følgende nye metoder til at gennemføre ovenstående indrapportering: 1.1.a Ny metode til at se andre stationer fra fremmed beredskab, der har valgt at dele ressourcer (køretøjer og personel med det beredskab, der indberettes udrykningsaktivitet for. Webservice metodens navn: GetAssociatedStationer Metoden vil returnere StationsListDTO med stationer, med delte ressourcer. Dokumentation fremgår af bilag a.

3 ODIN-webservice ændringer release 2010 v b To nye metoder til at liste hhv. køretøjer og personel fra delte stationer, som kan anvendes i indrapporteringen. Webservice metodernes navne: - SearchAssociatedRessourceKoeretoej - SearchAssociatedRessourcePersonel Metoderne vil returnere hhv. StationWithKoeretoejerDTO og StationWithPersonerDTO. Dokumentation fremgår af bilag b og bilag c. 1.2 Angivelse af assisterende beredskab(er i en rapport, således at der oprettes en underrapport ved det assisterende beredskab Given situation: Beredskab A slukker normalt, men tilkalder i dette tilfælde assistance fra Beredskab B til skadested beliggende i Beredskab A s område. Den korrekte indrapportering er, at udrykningsrapport (hovedrapport indrapporteres af Beredskab A (skadested ligger i Beredskab A s område, med angivelse af assisterende beredskab(er. Herved dannes i ODIN en underrapport hos det/de assisterende beredskab(er. Beredskab A anvender ODIN-webservice og Beredskab B anvender ODIN. Beredskab A ODIN-webservice: Indrapportering med angivelse af ass. beredskab(er Beredskab B Station B-1 Station A-1 Hovedrapport Underrapport

4 ODIN-webservice ændringer release 2010 v2.0 4 I ODIN release 2010 v2.0 vil der blive oprettet følgende nye metode til at gennemføre ovenstående indrapportering: 1.2.a Ny metode der returnerer alle beredskaber med undtagelse af brugerens eget beredskab, med oplysninger, der kan anvendes til metoden UdrykningUpdate. Webservice metodens navn: GetOtherRedningsberedskaber Metoden vil returnere RedningsberedskabDTO objekt. Dokumentation fremgår af bilag d.

5 ODIN-webservice ændringer release 2010 v2.0 5 I UdrykningUpdate-metoden anvendes følgende DTO til at angive assisterende beredskaber. Det assisterende beredskab angives vha. af tagget <ID>string</ID>, hvor ID (GUID på assisterende beredskab indsættes. ID hentes fra ovennævnte nye metode GetOtherRedningsberedskaber. <AssisterendeRedningsberedskaber xmlns=" <RedningsberedskabDTO> <Adresse>string</Adresse> < >string</ > <ID>string</ID> <IsFalckRedningsberedskab>boolean</IsFalckRedningsberedskab> <Navn>string</Navn> <PostAdresse>string</PostAdresse> <Telefon>string</Telefon> <TilknyttedeKommunerFK xsi:nil="true" /> </RedningsberedskabDTO> DTO en gentages, hvis der er flere assisterende beredskaber. 2. Ændring af funktion på eksisterende metoder Webservice metoderne: - UpdatePerson - UpdatePersonKommunerEkstra (funktion for en person - UpdatePersonUddannelse returnerer nu et OdinBasicResult og ikke Void. I forbindelse med anvendelse af metoderne. OdinBasicResult vil være ID på selve objektet dvs. hhv. ID på person, funktion og uddannelse.

6 ODIN-webservice ændringer release 2010 v Anvendelse af eksisterende metoder 3.1 Udfyldelse af underrapporter I relation til afsnit 2, hvor der i forbindelse med en indrapportering af udrykningsaktivitet for et beredskab, oprettes underrapport(er hos assisterende beredskaber (fremmede, kan den omvendte situation også være til stede. Given situation: Beredskab B slukker normalt, men tilkalder i dette tilfælde assistance fra Beredskab A til skadested i Beredskab B s område. Den korrekte indrapportering er, at udrykningsrapport (hovedrapport indrapporteres af Beredskab B (skadested ligger i Beredskab B s område, med angivelse af assisterende beredskab(er. Herved dannes i ODIN en underrapport hos det/de assisterende beredskab(er. Beredskab A anvender ODIN-webservice og Beredskab B anvender ODIN Beredskab A Beredskab B Station B-1 Station A-1 ODIN-webservice: Læsning og opdatering af underrapport. Hovedrapport Underrapport Den dannede underrapport hos Beredskab A, skal læses via ODIN-webservice og opdateres med information om køretøjer og personel fra station A-1. Underrapporter findes via SearchAlarm metoden. I listen af rapporter, der returneres, fremsøges underrapporterne ved at finde dem med parameteren Hovedalarm = False. <Hovedalarm xmlns=" Underrapporterne opdateres som vanligt ved metoden UdrykningUpdate med køretøjer og personel ved at angive rapportens ID som parameter.

7 ODIN-webservice ændringer release 2010 v2.0 7 Bilag a Tilføjet [public StationListDTO[] GetAssociatedStationer(string ticket] Syntax Visual Basic (Declaration Public Function GetAssociatedStationer ( _ ticket As String _ As StationListDTO( C# public StationListDTO[] GetAssociatedStationer( string ticket Visual C++ public: array<stationlistdto^>^ GetAssociatedStationer( String^ ticket JavaScript function getassociatedstationer(ticket; Parameters ticket The ticket. Return Value An array of StationListDTO containing associated stationer.

8 ODIN-webservice ændringer release 2010 v2.0 8 Bilag b Tilføjet [public StationWithKoeretoejerDTO[] SearchAssociatedResourceKoeretoej(string stationsid, string ticket] Syntax Visual Basic (Declaration <WebMethodAttribute> _ Public Function SearchAssociatedResourceKoeretoej ( _ stationsid As String, _ ticket As String _ As StationWithKoeretoejerDTO( C# public StationWithKoeretoejerDTO[] SearchAssociatedResourceKoeretoej( string stationsid, string ticket Visual C++ public: array<stationwithkoeretoejerdto^>^ SearchAssociatedResourceKoeretoej( String^ stationsid, String^ ticket JavaScript function searchassociatedresourcekoeretoej(stationsid, ticket; Parameters stationsid Id of Station. If this parameter is not null, only Køretøjer from the specifik Station is returned ticket Security token can be fetched using the Logon method Return Value An array StationWithKoeretoejerDTO

9 ODIN-webservice ændringer release 2010 v2.0 9 Bilag c Tilføjet [public StationWithPersonerDTO[] SearchAssociatedResourcePersonel(string stationsid, string ticket] Syntax Visual Basic (Declaration <WebMethodAttribute> _ Public Function SearchAssociatedResourcePersonel ( _ stationsid As String, _ ticket As String _ As StationWithPersonerDTO( C# public StationWithPersonerDTO[] SearchAssociatedResourcePersonel( string stationsid, string ticket Visual C++ public: array<stationwithpersonerdto^>^ SearchAssociatedResourcePersonel( String^ stationsid, String^ ticket JavaScript function searchassociatedresourcepersonel(stationsid, ticket; Parameters stationsid Id of Station. If this parameter is not null, only Personer from the specifik Station is returned ticket Security token can be fetched using the Logon method Return Value An array StationWithPersonerDTO

10 ODIN-webservice ændringer release 2010 v Bilag d Tilføjet [public RedningsberedskabDTO[] GetOtherRedningsberedskaber(string ticket] Syntax Visual Basic (Declaration <WebMethodAttribute> _ Public Function GetOtherRedningsberedskaber ( _ ticket As String _ As RedningsberedskabDTO( C# public RedningsberedskabDTO[] GetOtherRedningsberedskaber( string ticket Visual C++ public: array<redningsberedskabdto^>^ GetOtherRedningsberedskaber( String^ ticket JavaScript function getotherredningsberedskaber(ticket; Parameters ticket Security token can be fetched using the Logon method Return Value The RedningsberedskabDTO objects, every redningsberedskab exercpt the one user is associated to.