Besøksadresse
Fridtjof Nansens vei 19
0369 OSLO
Tore Vatnan, 2004-2010
Endringshistorikk | |
---|---|
2010-09-30 |
Endret navn fra "Frida" til
"Cristin" |
2009-05-25 |
organisasjon/enhet/akronym
økt til 12 tegn |
2008-09-03 | Lagt til fnrErstatter for person |
Cristin forutsetter at enkelte data om brukerinstitusjonen ligger i databasen før registrering gjøres. Det gjelder:
Disse dataene må importeres jevnlig slik at de er mest mulig oppdatert i Cristin.
Importformatet er XML hvor strukturen er definert av et XML schema (se under). De enkelte elementene og attributtene er navngitt etter "Java-standard" med små (engelske) bokstaver. Det innebærer at navnene starter med liten forbokstav. I navn som er satt sammen av flere ord skrives ordene i ett - det første ordet med liten forbokstav, og de påfølgende med stor forbokstav, f.eks. "stednavnBokmal".
Importformatet angir de elementene som er naturlig å importere i forhold til den funksjonaliteten som er implementert i Cristin i dag, eller som er planlagt implementert i nær fremtid. Ny funksjonalitet i Cristin vil kunne fordre at importformatet utvides/endres.
Det skal benyttes vest-europeisk tegnsett (ISO Latin 1 / ISO
8859-1). Dette skal angis i første linje i filen som da
skal
være
<?xml version="1.0" encoding="ISO-8859-1"?>
Elementer angis som rektangler med navn øverst og evt.
datatype nederst til høyre. Elementene inneholder enten ett
eller flere underelementer, eller de inneholder tekst.
Stiplede linjer angir ikke-obligatoriske elementer.
Seksvenser angis med . Dette betyr at underelementene må forekomme i angitt rekkefølge.
"+" og "-" (pluss og minus) angir om elementet/sekvensen/valget er ekspandert (om underelementene er synlige/ikke-synlige). For oversiktlighetens skylde er en del beskrivelser av elementer splittet opp på en slik måte at noen av underelementene ikke er ekspandert/beskrevet, men at beskrivelse er gitt et annet sted.
Antallet lovlige forekomster av et element er angitt under dersom det avviker fra 0..1 (angitt med stiplet linje) eller 1.
En importfil består av beskrivelse av dokumentet (kilde og dato) og informasjon om institusjon (navn og kontaktadresser), organisasjon (enheter som representerer en hierarkisk struktur), samt personer (med ansettelser).
En importfil bør være komplett i den forstand at alle nåværende enheter og personer med ansettelser, bør inngå i filen. Dette muliggjør validering av filen m.h.t. referanser internt og mellom hovedenhetene.
For enkel validering bør "namespace" angis i hovedelementet som
<fridaImport xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://frida.usit.uio.no/import/institusjonsdata/schema/Frida-import-1_0.xsd">
Beskrivelse består av elementene "kilde" og "dato". Denne informasjonen blir ikke importert i Cristin.
Elementet "institusjon" brukes for å angi navn, akronym, samt URL og e-postadresse for lokal informasjon/brukerstøtte i forbindelse med Cristin.
Elementet "organisasjon" består av én eller flere forekomster av elementet "enhet" som representerer data om institusjon, fakultet, institutt eller gruppe. Hver enhet identifiseres med et tuppel bestående av institusjonsnr, avdnr (avdelingsnummer - fakultet), undavdnr (underavdelingsnummer - institutt) og gruppenr. Dette utgjør nøkkelen for enheten i databasen, og skal således være entydig. I tillegg til nøkkelen skal hver enhet også ha en fremmednøkkel som peker til "forelder" i institusjonshierarkiet. Toppnivået på institusjonen har en "foreldrepeker" til seg selv.
Selv om nøkkelnavnene indikerer at en kan representere et hierarki med fire nivåer, gir bruken av fremmednøkler mulighet til å representere et hierarki av langt flere nivåer. Det anbefales imidlertid at en begrenser seg til maksimalt fire nivåer. Det er heller ingen begrensning når det gjelder "kobling på tvers". F.eks. kan en avdeling/fakultet med et gitt avdelingsnummer i teorien godt ha underliggende enheter med helt andre avdelingsnumre.
Obligatoriske elementer for enhet er nøkkel og fremmednøkkel, samt offisielt navn på enheten på bokmål. Det anbefales imidlertid sterkt å også ta med "kontaktdata" (adresse, telefonnr, telefaxnr og e-postdaresse).
Når en enhet erstattes av en annen (f.eks. ved at enheten flyttes i organisasjonen e.l.), kan dette angis ved å brukes underelementene i enhetErstattesAv. Underelementene utgjør fremmednøkkel til en annen enhet som må være definert tidligere i denne eksporten fra det lokale systemet.
Elementet "personer" kan inneholde ett eller flere personelementer. Et personelement inneholder "ansettelser" som skal inneholde ett eller flere ansettelseselementer.
Alle personer som det skal refereres til må importeres til Cristin. Disse vil i utgangspunktet også bli opprettet som brukere med rett til å bl.a. registrere resultater og foreta endringer i egen kompetanseprofil. Fullt fødselsnummer er obligatorisk for disse.
Disse personene må ikke blandes sammen med navn på eksterne personer (forfattere o.l.) der referansen kun er navn som ikke (nødvendigvis) identifiserer bestemte personer. Disse eksterne personene trengs ikke å være registrert i Cristin før registrering.
Elementet person har to attributter:
Følgende persondata inngår:
Hver person skal ha minst én ansettelse som er aktiv på det tidspunktet eksport til Cristin foretas. Følgende elementer inngår i ansettelseselementet:
gjester brukes for å angi andre tilknytningsforhold enn ansettelser.