Vejledning - System til systemindberetning via ReportingService

Transkript

1 21. februar 2018 JMN Erhvervslivets Udvikling Vejledning - System til systemindberetning via ReportingService Generelt ReportingService Det er muligt at indberette fondsstatistikken til Danmarks Statistik via en webservice den såkaldte ReportingService. Webservicen er i stand til at modtage indberetninger i xml-format. For at en indberetning kan modtages korrekt, skal XML en overholde et bestemt format. XML-formatet er beskrevet ved hjælp af et XML-skema (XSD), dette skema kan ligeledes hentes ved kald til webservicen. URL Webservicen findes her: Test miljø: Prod miljø: Webservicen indeholder tre metoder, en til at hente et xml-skema for tællingen og to til at foretage en indberetning. Disse er beskrevet i nedenstående metodiske afsnit Krav Husk det er vigtigt at: Læse hele denne vejledning igennem, for at det er muligt at sætte en system til system løsning korrekt op De indberettede variable skal leve op til de formatkrav der er specificeret i nedenstående afsnit om variabeldefinitioner At teste op imod testmiljøet inden applikationen gives fri til at foretage kald til produktionsmiljøet Så vidt muligt at give brugeren mulighed for at se/rette i oplysningerne inden afsendelse. På den måde er det muligt at foretage en rimelighedsvurdering. At reagere på eventuelle fejl, der returneres fra servicen. Der vil ikke være foretaget en indberetning, hvis SubmitReport fejler. Danmarks Statistik forsøger så vidt muligt at undgå ændringer i XML-skemaet, men der kan naturligvis være tilfælde der gør dette nødvendigt. 1/13

2 Metode beskrivelse af webservice Metode 1: GetSurveyDefinition(string surveyid, DateTime periodbegin, DateTime periodend) Beskrivelse Metoden henter et XmlSchema, der beskriver indberetningsformatet for en given tælling. Det anbefales endvidere at benytte skemaet til verifikation af indberetningen inden indsendelse. surveyid er en streng der identificerer tællingen. periodbegin og periodend er henholdsvis start og slutdato for tællingsperioden. Metode 2: SubmitReport(XElement report) Beskrivelse Metoden foretager en indberetning af data til Danmarks Statistik. Xml-input kan valideres med xml-skemaet fra ovenstående metode. Metode 3: SubmitReportString(string report) Beskrivelse Metoden svarer til SubmitReport xml en leveres blot som en string. 2/13

3 Sådan bruges ReportingService Kodeeksempel class Program static void Main(string[] args) //client is a reference to the webservice using (var client = new ReportingServiceClient()) //Get xsd for the specified survey string xsdmarkup = client.getsurveydefinition("140701", new DateTime(2013,10, 01), new DateTime(2013, 12, 31)); //Collect data for the survey XElement surveydata = XElement.Load(@"..\..\ xml"); //Create a Xdocument from collected data XmlSchemaSet schemas = new XmlSchemaSet(); schemas.add("", XmlReader.Create(new StringReader(xsdMarkup))); XDocument xdoc = new XDocument(surveyData); //Validate survey data against dowloaded xsd bool errorvalidating = false; xdoc.validate(schemas, (o, e) => Console.WriteLine("0}", e.message); errorvalidating = true; }); } } } //If there was no error while validating send survey data to DST if (!errorvalidating) try client.submitreport(surveydata); } catch (FaultException ex) string faultcode = ex.code.name; //Get fault exception code } } 3/13

4 Exceptions (fejlkoder) Fejlkode Besked 1001 TaellingsraekkeId can not be null 1002 PeriodeStart can not be null 1003 PeriodeSlut can not be null 1004 CVR can not be null 1005 PeriodeStart has an invalid value 1006 PeriodeSlut has an invalid value 1007 Xml did not validate with msg: <Reason> 1008 String is not valid xml 1009 PeriodeStart cannot be later than PeriodeSlut 2001 Too many entities with provided CVR you need to be more specific (use EnhedsId) 2002 No entity for provided CVR and trid combination 2003 It is not posible to report data for the present unit 2004 The survey does not exist for surveyid: <surveyid>, period: <periodbegin>-<periodend> 2005 The survey is not ready for use 3001 An error has occurred, please try again later Unspecified error 4/13

5 Variabeldefinitioner Der efterspørges i indberetningen de følgende variable: Variabel Beskrivelse TaellingsraekkeID PeriodeStart YYYY PeriodeSlut YYYY CVR ######## EnhedsID ########00 KontaktpersonNavn Navn på kontaktperson KontaktpersonTelefon Telefonnummer til kontaktperson Kontaktperson Mail til kontaktperson FIL_titel Nøglefelt som derfor skal være unik for hver enkelt indberetning FIL_Hovednr Anvendes ikke FIL_bev_aar Året hvori bevillingen er givet FIL_udbetalt Sum der er udbetalt på bevillingen i referenceåret FIL_bevilling Bevillingssum FIL_formaal Skal udfyldes i henhold til definitionen af formål. Se bilag A FIL_hovedomr Skal udfyldes i henhold til definitionen af hovedområder. Se bilag B FIL_virkemiddel Skal udfyldes i henhold til definitionen af virkemidler. Se bilag C FIL_modt_geo Her angives modtagerens geografi De accepterede koder er: MG_01_Udenlandsk MG_02_Indenlandsk MG_03_Ukendt geografi FIL_modt_art FIL_modt_inst FIL_modt_cvr FIL_modt_postnr FIL_modt_ORCID FIL_modt_koen Koderne vil blive valideret på de første 5 tegn. Hvis modtageren er udenlandsk angives fx koden MG_01_ Udenlandsk, men det vil også være tilladt at angive fx MG_01 eller MG_01_Udl Skal udfyldes i henhold til definitionen af modtagertype (art). Se bilag D Her angives navnet på modtager institutionen, såfremt der er tale om en ikke personlig modtager. Modtagerens CVR-nummer, såfremt det kendes Modtagerens postnr., såfremt det kendes Modtagerens ORCID 1, såfremt det kendes Modtager Køn (1=mand, 1 ORCID er en unik identifikation af personer, der oftest anvendes inden for forskerverdenen 5/13

6 FIL_modt_PI_nvn FIL_aav_VIP FIL_aav_TAP FIL_aav_PHD FIL_aav_POSTDOC FIL_udb_vid FIL_udb_kul FIL_udb_soc FIL_udb_inthum FIL_udb_nat FIL_udb_sun FIL_udb_udd FIL_udb_erhv FIL_udb_rel FIL_udb_and 2=kvinde), såfremt det er registreret PI navn (navnet på den person (PI) der står som ansøger), såfremt det er registreret Årsværk VIP (i måneder), hvis relevant Årsværk TAP (i måneder), hvis relevant Årsværk ph.d (i måneder), hvis relevant Årsværk Postdoc (i måneder), hvis relevant videnskabelige formål i året kulturelle formål i året sociale formål i året internationale humanitære formål i året natur- og miljø formål i året sundhed og idrætsformål i året uddannelses- og folkeoplysningsformål i året erhvervs- og regionaludviklingsformål i året religiøse formål i året andre formål i året Variablene markeret med rødt, er en del af en gentaget gruppe (FIL_bevil_raekke), og disse skal således udfyldes for hver enkelt bevilling fra fonden. Det er meget vigtigt, at man holder sig for øje, at variablen FIL_titel fungerer som nøglefelt, og denne skal derfor være unik for hver enkelt indberetning. Har man fx 5 bevillinger til ph.d-stipendiat, skal disse navngives unikt, fx ph.d-stipendiat1, ph.d-stipendiat2, osv. 6/13

7 Bilag A: Formål Nedenstående liste angiver accepterede koder til kolonnen Formål. Bemærk at der kun kræves sammenlignelighed på de første 5 tegn: FO_01_Videnskabelige formål FO_02_Kulturelle formål FO_03_Sociale formål FO_04_Internationale humanitære formål FO_05_Natur og miljøformål FO_06_Sundhed og motionsformål FO_07_Uddannelses- og folkeoplysningsformål FO_08_Erhvervs- og regionaludviklingsformål FO_09_Religiøse formål FO_10_Andre formål 7/13

8 Videnskabelige formål Naturvidenskab Sundhedsvidenskab Teknisk videnskab Samfundsvidenskab Humaniora Bilag B: Hovedområder Nedenstående liste angiver accepterede koder til kolonnen Hovedområde. Bemærk at der kun kræves sammenlignelighed på de første 5 tegn: V_H01_Matematik V_H02_Datalogi V_H03_Fysik (inkl. biofysik) V_H04_Kemi V_H05_Geologi og fysisk geografi V_H06_Biokemi V_H07_Biologi V_H08_Øvrig naturvidenskab V_H09_Basal medicin V_H10_Farmaci, farmakologi og medicinal kemi V_H11_Klinisk medicin V_H12_Odontologi (tandlægevidenskab) V_H13_Sundhedstjeneste V_H14_Pleje og omsorg mv. V_H15_Samfundsmedicin og folkesundhed V_H16_Medicinsk bioteknologi V_H17_Øvrig sundhedsvidenskab V_H18_Byggeri, anlæg og transport V_H19_Elektronik, elektroteknik og kommunikation V_H20_Maskinkonstruktion og produktionsteknik V_H21_Kemi teknik V_H22_Materialer V_H23_Medico teknik V_H24_Energi- og miljøteknik V_H25_Bioteknologi inden for energi og miljø V_H26_Industriel bioteknologi V_H27_Nanoteknologi V_H28_Øvrig teknisk videnskab V_H29_Psykologi V_H30_Nationaløkonomi V_H31_Erhvervsøkonomi V_H32_Pædagogik V_H33_Sociologi, antropologi og etnografi V_H34_Retsvidenskab (Jura) V_H35_Statskundskab/ politologi V_H36_Byplanlægning og fysisk planlægning V_H37_Øvrig samfundsvidenskab V_H38_Historie V_H39_Arkæologi V_H40_Sprogvidenskab og filologi 8/13

9 Jordbrugs- og veterinærvidenskab Tværvidenskabelig forskning V_H41_Litteraturvidenskab V_H42_ Filosofi og idehistorie V_H43_Teologi og religion V_H44_Musik- og teatervidenskab V_H45_Kunst- og arkitekturvidenskab V_H46_Film- og medievidenskab V_H47_Medier og kommunikation V_H48_Øvrig humanistisk videnskab V_H49_Landbrugsplanter og gartneri V_H50_Skov- og havebrug V_H51_Fiskeri V_H52_Animalsk produktion V_H53_Veterinær- og fødevarevidenskab V_H54_Bioteknologi inden for jordbrug V_H55_Øvrig jordbrugs- og veterinærvidenskab V_H56_Tværvidenskabelig forskning Kulturelle formål Kulturarv og museer Medier, biblioteker og litteratur Scene og musik Visuel kunst og design Anden kulturel aktivitet K_H01_Arkiver K_H02_Fredede bygninger K_H03_Fredede fortidsminder K_H04_Kulturmiljøer og landskaber K_H05_Museer K_H06_Zoologiske anlæg K_H07_Kulturarv og museer i øvrigt K_H08_Biblioteker K_H09_Litteratur og bøger K_H10_Film K_H11_Biografer K_H12_Medier K_H13_Medier, biblioteker og litteratur i øvrigt K_H14_Musik K_H15_Scenekunst K_H16_Scene og musik i øvrigt K_H17_Arkitektur K_H18_Billedkunst K_H19_Design K_H20_Kunsthåndværk K_H21_Visuel kunst og design i øvrigt K_H22_Byfester o.lign. K_H23_Andet kultur i øvrigt Sociale formål 9/13

10 Indsatser rettet mod børn og unge Indsatser rettet mod voksne Indsatser rettet mod ældre Andre sociale forhold S_H01_Indsatser rettet mod børn og unge: målrettet mennesker med handicap S_H02_Indsatser rettet mod børn og unge: målrettet socialt udsatte S_H03_Indsatser rettet mod børn og unge: målrettet flygtninge, indvandrere og efterkommere S_H04_Indsatser rettet mod børn og unge: målrettet forebyggende indsatser S_H05_Indsatser rettet mod børn og unge: øvrige S_H06_Indsatser rettet mod voksne: målrettet mennesker med handicap S_H07_Indsatser rettet mod voksne: målrettet socialt udsatte S_H08_Indsatser rettet mod voksne: målrettet flygtninge, indvandrere og efterkommere S_H09_Indsatser rettet mod voksne: målrettet forebyggende indsatser S_H10_Indsatser rettet mod voksne: øvrige S_H11_Indsatser rettet mod ældre: målrettet mennesker med handicap S_H12_Indsatser rettet mod ældre: målrettet socialt udsatte S_H13_Indsatser rettet mod ældre: målrettet flygtninge, indvandrere og efterkommere S_H14_Indsatser rettet mod ældre: målrettet forebyggende indsatser S_H15_Indsatser rettet mod ældre: øvrige S_H16_Andre sociale formål Natur og miljøformål Natur og miljø N_H01_Natur N_H02_Vand N_H03_Energi N_H04_Klima N_H05_Kemikalier N_H06_Andre natur og miljøformål Sundhed og motionsformål Sundhed og motion M_H01_Sundhed M_H02_Idræt M_H03_Motion og fritid Uddannelses- og folkeoplysningsformål Uddannelse og folkeoplysning U_H01_Daginstitutioner U_H02_Grundskolen U_H03_Ungdomsuddannelser U_H04_Erhvervsuddannelser U_H05_Videregående uddannelser U_H06_Folkehøjskoler U_H07_Folkeoplysning 10/13

11 Erhvervs- og regionaludviklingsformål E_H01_Erhvervsformål E_H02_Regionale formål E_H03_Byudvikling Internationale humanitære formål hu- International manitær Erhvervs- og regionalformål Religiøse formål Religion I_H01_Internationle humanitære formål R_H01_Religiøse formål Andre formål Andet A_H01_Andre formål 11/13

12 Bilag C: Virkemidler Nedenstående liste angiver accepterede koder til kolonnen Virkemidler. Bemærk at der kun kræves sammenlignelighed på de første 5 tegn: VM_01_Anlæg VM_02_Bygninger VM_03_Ny natur VM_04_Naturgenopretning VM_05_Klimatilpasning VM_06_Forskning VM_07_Postdoc VM_08_Forskningsprojekter (max 10 mio. kr.) VM_09_Store forskningssatsninger (over 10 mio. kr. og under 50 mio. kr.) VM_10_Kæmpe forskningssatsninger (fra 50 mio. kr. og opefter) VM_11_Forskningsinfrastruktur VM_12_Forskeruddannelse (ph.d) VM_13_Forskningsformidling VM_14_Priser og legater VM_15_Ikke øremærkede midler VM_16_Aktivitet VM_17_Bevaring, registrering, og tilgængeliggørelse af kultur VM_18_Kulturskabende/udøvende VM_19_Kulturelle udstillinger VM_20_Formidling VM_21_Anskaffelser/erhvervelser VM_22_Innovation VM_23_Udvikling af indsatser VM_24_Afprøvning af indsatser VM_25_Implementering af indsatser VM_26_Andet 12/13

13 Bilag D: Modtagertype (art) Nedenstående liste angiver accepterede koder til kolonnen Modtagertype (art). Bemærk at der kun kræves sammenlignelighed på de første 5 tegn: MA_01_Universiteter MA_02_Hospitaler MA_03_Professionshøjskoler MA_04_Erhvervsakademier MA_05_Kunstneriske uddannelsesinstitutioner MA_06_Maritime uddannelsesinstitutioner MA_07_Stats- og sektorforskningsinstitutioner MA_08_Godkendte teknologiske serviceinstituttter (GTS-institutter) MA_09_Museer, biblioteker og lignende kulturinstitutioner MA_10_Øvrige offentlige institutioner eller myndigheder MA_11_Individuelle personer som ikke er tilknyttet en institution MA_12_Studerende fra videregående uddannelsesinstitutioner MA_13_Private virksomheder MA_14_Foreninger og organisationer MA_15_Egne aktiviteter MA_16_Andre 13/13