NOTAT Spesifikasjon for datauttak fra TRIO, AD og Formula og sammenfletting i ny database. Saksnr. 10/ Dato:

Transkript

1 TROMS OG FINNMARK Sak: NOTAT Spesifikasjon for datauttak fra TRIO, AD og Formula og sammenfletting i ny database. Saksnr. 10/ Dato: Behandling Uttalelse Orientering Godkjenning Retur Frist Til: Kopi til: Fra: KYV-TF Senter for administrasjon og regnskap/harald Frantzen KYV-TF Senter for administrasjon og regnskap/fred Gjøran Einvik Pål Thomassen KYSTVERKET TROMS OG FINNMARK Sentral postadresse: Kystverket, postboks 1502, 6025 ÅLESUND Telefon: Telefaks: Internett: E-post: post@kystverket.no Besøksadr.: Fiskeriveien 3, HONNINGSVÅG Telefon: Bankgiro: Telefaks: Org.Nr.: Brev, sakskorrespondanse og e-post bes adressert til Kystverket, ikke til avdeling eller enkeltperson NO

2 Innhold Introduksjon... 2 Målsetning... 2 Hensikt... 2 Omfang... 3 Definisjoner og forkortelser... 3 Overordnet beskrivelse... 3 Produktbeskrivelse... 3 Produktfunksjoner... 3 Spesifikke krav... 3 Grensesnitt og data fra eksisterende systemer... 3 TRIO... Feil! Bokmerke er ikke definert.3 Formula... 4 Active Directory Telenor abonnementdata... 5 Tidbank brukerdata... 6 Kystsak brukerdata... 6 Samling av data i ny database... 6 Beskrivelse av programkode for importering av data... 7 Beskrivelse av programkode for generering av avviksrapport... 7 Introduksjon Målsetning Få samlet persondata fra forskjellige systemer i en felles database slik at denne informasjonen kan samles på en plass og kvalitetssikres med et enkelt grensesnitt. Det skal også være mulig å generere avviksrapport mellom de forskjellige systemene. Hensikt I dag finnes persondata i flere forskjellige systemer slik at endringer ikke alltid er konsistent over alle systemene. Persondataene skal derfor samles og sammenlignes i en felles database slik at endringer oppdages raskt og data forblir konsistente. Den felles databasen kan dermed bli brukt Side 2

3 til å hente ut persondata samlet fra alle systemene uten manuelt måtte hente den ut fra de forskjellige systemene og kombinere den selv. Omfang Fellesdatabasen vil i første omgang ta for seg informasjon fra Trio, Formula, Active Directory, proffnettdata fra Telenor, 4760, Tidbank og Kystsak. Flere systemer skal ikke være altfor vanskelig å integrere inn. Trio er et telefonsystem som ligger på klientmaskiner og håndterer telefonnummer, tilstedeværelse osv. Formula er et lønnsystem som inneholder alle ansatte og lønnsinformasjon om dem. Active Directory er en katalogtjeneste for håndtering av brukerer, brukerrettigheter og ressurskontroll. Proffnett er en abonnementstjeneste fra telenor er et telefonisystem for interne telefoner. Tidbank er et system for håndtering av fleksitid Kystsak er kystverkets saksbehandlingssystem, det bruker Software Innovations 360. Definisjoner og forkortelser LDAP Lightweight directory access protocol. AD Active Directory XML Extensible Markup Language SOAP Lettvekts meldingsutvekslings protokoll som bruker XML Overordnet beskrivelse Produktbeskrivelse Produktet skal være en samling av eksisterende systemers persondata. Informasjonen fra de forskjellige eksisterende systemene skal samles slik at man kan få all informasjon samlet på et t samt at man får tilgang til endringer rask. Slike endringer kan være bytte av avdeling, telefonnr osv. Ved å vedlikeholde systemene kan man dermed holde dataene konsistente på tvers av systemer. Produktfunksjoner Opprette en database med brukerdata Generere en avviksrapport som inneholder avvik i brukerdata på tvers av systemene. Informasjon trenger ikke umiddelbart å bli tilgjengelig, f.eks. så vil data fra Formula bare bli synkronisert hver tirsdag og torsdag. Spesifikke krav Grensesnitt og data fra eksisterende systemer TRIO Data fra TRIO blir hver natt eksportert til D:\Export\presentexport.txt på telefoni tjeneren. Dette er en semikolon separert fil, hvortrioparseren går gjennom filen og henter ut data. Data fra TRIO over ansatte: Navn Tittel Side 3

4 Hjemmeavdeling Avdeling Internnummer Internnummer Mobiltelefon Kundegruppe Plassering Svarsted E-post Oppgave Telefonnr Enhet Rom TRIO inneholder også informasjon om tilgjengeligheten til de ansatte, men dette er ikke interessant for fellesdatabasen Formula Hver tirsdag og torsdag blir det hentet ut en XML-fil fra Formula over ansatte. Denne filen finnes på tjeneren web03 under C:\current_web\integration\import\xml, dette er den samme filen som sendes til Current fra Formula. Data fra Formula over avdeling: Kode Beskrivelse Data fra Formula over ansatte: Ansattnr Fornavn, etternavn Adresse Postnummer Poststed Avdelingsnummer Avdelingsnavn E-post arbeid Ansatt fra Ansatt til Telefon arbeid Telefon arbeid alternativ Mobiltelefon arbeid Stilling Funksjon Utlønningsted Side 4

5 Active Directory Uthenting av data fra AD gjøres ved hjelp rå tekstdumper. Dette gjøres vha enkle LDAPspørringer som gjøres i selve AD. Denne filen har ikke noen automatisert generering ennå. Brukerdata som finnes i AD: Fornavn, etternavn og initialer Beskrivelse Kontor Telefonnr: hjem, mobil. E-post Login navn (Ansatt ID) Tittel Avdeling Firma Gruppemedlemskap I tillegg finnes felt for adresse, poststed, postnummer, postboks og land som ikke er i bruk nå, men som ønskes å bli tatt i bruk Fra 4760 finnes det to filer, en som heter All_Users.txt og en som heter DirKortNr.txt. Disse finnes på\\horten4760-1\import og oppdateres den 1. hver måned. I filen All_Users finnes følgende interessante felt: Node Internummer Directory name (ofte etternavn) Directory First Name (ofte fornavn) Etternavn og fornavn er ofte ikke helt konsistene, f.eks så finnes det S0 Video4 som Directory Name noen steder. I filen DirKortNr finnes følgende interessante felt: Node Directory First Name (Ofte fornavn) Direct Speed Dial No. prefix Call Number Phone book Name (Ofte etternavn med f.eks MO eller MOB) Displayed Name (ofte fornavn og deretter etternavn) Telenor abonnementsdata Telenor har støtte for å hente ut abonnementsdata via deres hjemmeside. En slik fil er en semikolon separert fil som inneholder abonnementsdata. Denne filen må per dags dato hentes manuelt fra telenors nettsider. De data som er interessante er: Side 5

6 Navn Brukerref 1, 2 og 3 Proffnett internnummer Abonnementstype Anropsnummer Tidbank brukerdata Tidbank har støtte for en webservice som tilbyr blant annet brukerdata. Denne har vi fått begrenset tilgang på i sommer fram til 13.august, etter denne perioden må tjenesten betales for. Brukerdata blir hentet ut fra webservicen vha SOAP. Data som er fra Tidbank: Ansattnummer Avdelingsnummer og navn Navn Postboks Adresse Postnummer Poststed Telefon Mobil Faks Epost Kystsak brukerdata Data fra Kystsak blir hentet ut vha av en database spørring, denne kan enten kjøres rett mot databasen eller man kan kjøre den i 360 administrasjonsverktøyet. Denne spørringen blir så lagret som en semikolon separert fil som blir behandlet av en parser. Data fra Kystsak: Fornavn og etternavn Avdelingsnavn Telefon Mobil Epost Ansattnummer (AD-bruker) Aktiv (om bruker er aktiv eller ikke) Sist bruker ble oppdatert. Samling av data i ny database Siden noen systemer bruker ansattnummer som unik ID, mens andre har egne interne identifikatorer så må den nye databasen ha egne primærnøkler på de forskjellige tabellene. Selve samlingen vil gå ut på å lage en brukertabell for hvert system i den nye databasen. Data vil bli hentet via de ulike grensesnittene til systemene før de blir importert i fellesdatabasen. På denne måten kan man med disse tabellene, spørre etter samme bruker og få ut informasjonen fra alle de forskjellige systemene og se hva som er likt og ulikt. Side 6

7 Beskrivelse av programkode for importering av data Programmet består av forskjellige programsnutter for behandling av data fra ulike systemer. En slik programsnutt vil lage en liste med dictionarys(hash-tabell) i python som inneholder de forskjellige feltenes nøkkel og tilhørende verdi. En del nøkler blir byttet ut med en mengde felles nøkler, slik som fornavn, etternavn osv slik at det er enkelt å se i databasen at disse er de samme feltene. Alle felt blir også oversatt til navn med små bokstaver. Hver av disse listene for de forskjellige systemene blir så opprettet som en egen tabell enten i en midlertidig intern sqlite-database i minnet på datamaskinen som kjører programmet eller i en permanent MSSQL-database. Hver av disse snuttene for behandling av filene er veldig spesialiserte ved at de oversetter en del feltnavn og ignorerer andre, de oppretter også databasetabeller for de forskjellige feltene. Beskrivelse av programkode for generering av avviksrapport Generering av avviksrapporter foregår ved at programmet sammenligner to databasetabeller og finner felles brukere gjennom et bestemt felt, f. eks ansattnummer. Sammenligningen finner først alle brukerne i en tabell og deretter slår det opp de samme brukerne i den andre tabellen. Når det er funnet to brukere blir alle felt med samme navn sammenlignet. Dette er som regel felt som navn, epost eller avdeling, men det kan også være andre felt. Side 7