Indhold Ændringshistorik... 2 Formål... 2 Om programmet... 2 Systemkrav... 2 Installation... 3 Event Log... 5 Installationsprogrammets skærmbillede... 6 Konfigurering af xml-opsætningsfil... 7 Beskrivelse af entitterne i FetchesXMLFile.xml... 9 1
Ændringshistorik Dato Beskrivelse 14.04.2010 Indsat billede i dokumentation vedrørende installationens skærmbillede. 17.06.2010 Opdateret dokument med Indlæs eksisterende konfigurationsfil funktionalitet 28.07.2010 Opdateret screenshot i afsnittet Installationsprogrammets skærmbillede Formål Formålet med dette dokument er at give en systemansvarlig et dokument som beskriver hvordan ØSLDV RAY Windows service til indberetning af data til Økonomistyrelsen Lokale Data Vare Hus (ØSLDV) skal sættes op lokalt. Om programmet Programmet ØSLDV RAY Windows service er en applikation som sættes op på en Windows server (se under systemkrav for krav til systemer.) Programmet importerer rejseafregningsdata fra RejsUd til Økonomistyrelsen Lokale Data Vare Hus (ØSLDV) Importering af data sker ved at ØSLDV RAY Windows Service kontakter en webserver hos Økonomistyrelsen via Secure Socket Layer (SSL) HTTPS port 443. Programmet kører som en Windows Service under Windows Network Service account. Programmet importerer data 1 gang i døgnet. Dette kan dog ændres (Se under konfiguration) Programmet installeres under Windows standard programbibliotek (Program Files/Programmer) Programmet kan fjernes igen via Windows kontrol panel og funktionen Tilføj Fjern programmer/add Remove Programs. Systemkrav Microsoft Windows Server 2003 eller nyere Microsoft.NET Framework 3.5 Microsoft SQL Server 2005 SP3 2
Yderligere systemkrav følger vejledningen til ØSLDV som forefindes på http://www.oes.dk/sw40572.asp 200 mb fri plads på disk Installation Pakken indeholdende opsætning og applikation hentes på Økonomistyrelsens hjemmeside. Udpak ZIP filen. RejsUD_Installer_1_1.zip Du vil nu have en folder der hedder RejsUD_Installer_1_1. Naviger ned i folderen RejsUD_Installer_1_1 følgende filer vil være at se (Figur 1) Klik på Setup.exe (Setup.exe skal startes af Windows brugeren Administrator. Eks højreklik på filen og vælg "Run as administrator" ) Nu starter installationsprogrammet af Windows Servicen der henter data fra RAY s centrale database til en eller flere lokale databaser. I installationsprogrammet skal du konfigurere Windows Servicen til din organisation. Se mere om dette på næste side. Hvis servicen allerede er installeret på den computer hvorpå installationsprogrammet afvikles, kan programmet benyttes til at konfigurere servicen. Programmet vil i dette tilfælde indlæse den eksisterende konfiguration, og videre konfigurering er så muligt. Du bør være klar med oplysninger om din databaseserver samt det brugernavn og kodeord du har modtaget fra ØS. Brugernavnet er nummeret på din institution. Kombinationen brugernavn og kodeord fungerer som login til RAYs centrale webservice. 3
1. Indtast adressen til ØS Webservice Eks. https://rejsudadm.oes.dk/ray/getdata.svc (Figur) 2. Tag stilling til om login oplysningerne til databasen er korrekte. Eks. Windows Security eller SQL server login skal benyttes (se. pkt. 7 under Installationsprogrammets skærmbillede) 3. Vælg eller indtast jeres SQL Server som indeholder dataset Eks. SERVER2\SQL24 4. Vælg den database som ligger på den SQL server du har valgt 5. Indtast dit institutionens EAN-nummer (Institutionsnummer) 6. Indtast dit kodeord (Password) 7. VIGTIGT! Afprøv forbindelsen til database og webservice ved at klikke på se under mulige fejlkilder hvis der fremkommer fejlinformation. 8. Klik på knappen og din database tilføjes til listen. 9. Gentag proceduren fra pkt. 3 hvis der er flere institutioner på samme server farm. 10. Hvis dette er en førstegangsinstallation(servicen er ikke installeret endnu) vil der være en knap nederst i skærmbilledet. Ved at klikke på denne installerer installationprogrammet Windows Servicen under Windows (x86) %ProgramFiles%. Eks. C:\Program Files (x86)\osldv\osldv.raywindowsservice\ Hvis dette ikke er en førstegangsinstallation(programmet er installeret på computeren i forvejen) vil der være en nederst i skærmbilledet. Ved at klikke på denne opdateres den eksisterende service med den ændrede konfiguration. Der vil i dette tilfælde ikke foregå nogen installation For manuelt at sikre at servicen er installeret se under windows service i kontrolpanel. I listen over Windows Services fremkommer. Er denne service ikke fremkommet skal du sikre dig at du har gennemført alle trin. 4
Uddybning af installationsskærmbilledet finder du under afsnittet Installationsprogrammets Skærmbillede. Mulige fejlkilder i ovenstående trin Database servernavn er forkert Windows integrated security er slået fra, og der skal benyttes SQL server login Du som bruger har ikke rettigheder til at tilgå databasen. Dit login til webservice er forkert, du får et dialog boks med "Forkert login til webservice" Dit login til databasen er forkert, du får en dialog boks med "Forkert login til database" Event Log Informationer om installationen og eventuelle fejl er også tilgængelig via Windows EventLog under Windows Logs Application. Hvis data ikke kommer frem eller der opstår problemmer med at tilgå webservices eller databaser vil dette fremgå af Windows Event Log. I Event Loggen har applikationen navnet OSLDV Service. 5
Installationsprogrammets skærmbillede Installationen af Windows Servicen har ét konfigurationsskærmbillede: 1 3 2 4 5 7 6 8 9 11 12 13 10 14 15 16 1. Adressen på den centrale webservice hvorfra data skal hentes 2. Navnet på den SQL-server hvor data skal flyttes til 3. Navnet på den database hvor data skal flyttes til. Her kan enten vælges en eksisterende database i dropdownen (efter tryk på Opdater ), eller indtaste navnet på en ny. Hvis der indtastes navnet på en ny database, skal felterne i (6) indtastes og herefter trykkes på (12) 4. Institutionsnummeret 5. Institutionens password til RejsUd 6
6. Oplysninger i denne boks benyttes kun hvis der oprettes en database gennem denne wizard. Som udgangspunkt vil servicens opdatering af data i databasen altid benytte servicekontoen Network Service 7. Brug integrated security ved oprettelse af database 8. SQL-brugernavn til brug ved oprettelse af database (kun tilgængelig når (7) er slået fra) 9. SQL-password til brug ved oprettelse af database (kun tilgængelig når (7) er slået fra) 10. Giver read/write rettigheder til servicen Network Service på denne database. Det er denne konto der som standard benyttes af servicen til at indsætte data i databasen 11. Test af databaseforbindelse og webserviceforbindelse, herunder bekræftelse af password 12. Opretter den indtastede database (3) på SQL-serveren 13. Tilføjer den indtastede institution til listen (14) 14. Liste over de institutioner der er tilføjet til installationen 15. Fjern den valgte institution fra listen 16. Denne knap kan have to tekster a. Installer: Start installationen af servicen med de valgte settings. Denne knap vil være synlig hvis servicen ikke allerede er installeret på computeren b. Gem: Gemmer settings til den allerede installerede service Hvis der efter installation ønskes en yderliger opsætning af systemet, herunder tilføjelse af institutioner/jobs, kan dette gøres gennem en XML-konfigurationsfil (se næste afsnit) eller ved at køre programmet igen. Konfigurering af xml-opsætningsfil Filen FetchesXMLFile.xml er fra Økonomistyrelsen side opsat med standard konfiguration. Efter installationsprogrammet er kørt og du har konfigureret Windows Servicens opsætning, bliver XML filen ændret og tilpasset de oplysninger du har givet. Skulle der på et givent tidspunkt opstå problemer, eller du får nyt kodeord, kan rettelser foretages i denne XML fil. Filen findes under installationsbibliotekket hvor du installerede Webservicen. Eks. C:\Program Files (x86)\osldv\osldv.raywindowsservice\ FetchesXMLFile.xml Efter installation oprettes automatisk en xml-konfigurationsfil i installationsbiblioteket med navnet FetchesXMLFile.xml. Det er her alle hent-kommandoerne er defineret. En definition består af et institutionsnummer, info om hvilken database der skal hentes data til, info om hvornår jobbet skal køre samt hvilke data der skal hentes. Det er muligt at have flere jobs med samme institutionsnummer, hvis man f.eks. kun ønsker at hente deltadata i løbet af ugen og hente et fuldt datasæt i weekenden. Det er på samme måde muligt at hente information om samme institution til flere forskellige databaser. Herunder ses et eksempel på et job. De enkelte felters funktion er forklaret: <Fetch> 7
<!--The institution number--> <Institutionsnummer>5750001234567</Institutionsnummer> <!--The RAY password of the institution--> <Password>PASSWORD01</Password> <!--The SQL-server that hosts the database--> <DatabaseServer>local</DatabaseServer> <!--The name of the database, data should be fetched to--> <DatabaseNavn>osldv01</DatabaseNavn> <!--Only used with FetchOperation is "HentDataInterval". The start month in the interval--> <StartMonth>200901</StartMonth> <!--Only used with FetchOperation is "HentDataInterval". The end month in the interval--> <EndMonth>200912</EndMonth> <!--The status of the fetch: Done Running NotRun --> <FetchStatus>NotRun</FetchStatus> <!--The type of operation: TestForbindelse HentDataFuld HentDataDelta HentDataInterval --> <FetchOperation>HentDataFuld</FetchOperation> <!--How often the operation is run: once daily weekly monthly --> <FetchFrequency>once</FetchFrequency> <!--Used in "weekly": monday, tuesday wednesday thursday friday saturday sunday --> <FetchWeekday>monday</FetchWeekday> <!--Used in every operation except "once". The time the task is to be executed--> <StartTime>12:00</StartTime> <!--The elements to be syncronized. Every element in this block should be either true or false. The elements corresponds to a table in the database. Only elements set to true in this block will be fetched--> <FetchHentliste> <Accountcharts>true</Accountcharts> <Cardtypes>true</Cardtypes> <Companyunits>true</Companyunits> 8
<Countrycodes>true</Countrycodes> <Currencycodes>true</Currencycodes> <Documentheader>true</Documentheader> <Documentrow>true</Documentrow> <Documenttypes>true</Documenttypes> <Driveevents>true</Driveevents> <Employeedata>true</Employeedata> <Expensegroups>true</Expensegroups> <Expensetypes>true</Expensetypes> <Methofpayments>true</Methofpayments> <Objectgroups>true</Objectgroups> <Objectvalues>true</Objectvalues> <Postingentries>true</Postingentries> <Taxbases>true</Taxbases> <Traveldays>true</Traveldays> <Travelpurpose>true</Travelpurpose> <Travelrules>true</Travelrules> <Traveltargets>true</Traveltargets> <Vehicletypes>true</Vehicletypes> </FetchHentliste> <!--Not used currently--> <FetchDay>2009-07-20T00:00:00</FetchDay> <!--only used in "monthly" frequency for the day of the month--> <MonthDay>20</MonthDay> </Fetch> Beskrivelse af entitterne i FetchesXMLFile.xml Felt Beskrivelse Institutionsnummer Password DatabaseServer DatabaseNavn FetchOperation Institutionens unikke nummer Password til RAY-webservice. Udleveres af ØS Navnet på den server hvor den lokale database ligger Navnet på den database der skal hentes data til Operation. Denne kan antage værdierne: TestForbindelse Tester forbindelsen til ØS s centrale webservice. Der overføres ikke data i denne operation HentDataFuld Henter al data for den aktuelle organisation til den lokale database HentDataDelta Henter data for den aktuelle organisation til den lokale database. Der hentes kun de data der er ændret eller tilføjet siden sidste HentDataFuld eller HentDataDelta operation HentDataInterval 9
FetchFrequency StartMonth, EndMonth Henter data for den aktuelle organisation til den lokale database. Der hentes kun de data der har er ændret eller tilføjet inden for et bestemt interval (StartMonth til EndMonth) Frekvens af operationen. Denne kan antage værdierne: once Operationen udføres kun en enkelt gang daily Operationen udføres hver dag weekly Operationen udføres én gang om ugen monthly Operationen udføres én gang om måneden Benyttes kun når FetchOperation er HentDataInterval. Bestemmer hvilket interval der skal hentes data for FetchStatus FetchWeekday StartTime FetchHentliste Den aktuelle status af operationen. Denne kan have værdierne: Done Running NotRun Benyttes kun når FetchFrequency er weekly. Bestemmer hvilken ugedag operationen skal afvikles på. Kan antage værdierne: monday tuesday wednesday thursday friday saturday sunday Benyttes når FetchFrequency er daily, weekly eller monthly. Bestemmer hvornår på dagen operationen skal udføres Bestemmer hvilke data der skal overføres. Under dette element er child-elementer der hver repræsenterer en tabel i databasen. Hvert af disse elementer kan antage værdien true eller false. Det er kun rækker fra de tabeller der har værdien true der overføres under operationen MonthDay Benyttes når frekvensen er monthly. Bestemmer den dag på måneden operationen skal afvikles 10
Vejledning afsluttet. 11