Unikum är byggt för att samverka med andra IT-system. Därför kan man importera skolor, grupper och användare med hjälp av enkla textfiler.
Filformatet är en tab-, komma- eller semikolonavgränsad texfil i formatet UTF-8 eller ISO-8859-1.
För de personer som redan finns i Unikum kommer uppgifterna i importfilen skriva över uppgifterna som finns lagrade i Unikum. Om en användare ändrat sitt telefonnummer i Unikum kommer alltså ändringen gå förlorad om importfilen innehåller ett telefonnummer för användaren.
Med användare avses alla individer: elever, personal eller vårdnadshavare. En fil med användare kan laddas upp på olika sätt:
Uppgifterna skall ligga i följande ordning (Om ni redigerar i Excel läggs ett värde i varje kolumn med början i kolumn A, B, C osv). Poster med fet stil måste alltid finnas med i importfilen, de andra är valfria.
Kalle,Kallesson,kalle@nomail.com,20000101-0000,,08-123456,070-0123456,,Unikumvägen 1,74634,Grönköping,false,true,false,true,,,070-0123456,user
Pelle,Pellesson,pelle@nomail.com,20000102-0000,,08-654321,070-6543210,,Unikumvägen 2,74634,Grönköping,false,true,true,true,,,user
Mer instruktioner angående personer här >>
Exempel på textfil för personer >>
klazz1,Klass 1,,6,7,En fin klass,class
klazz2,Klass 2,,7,8,,class
klazz3,Klass 3,,,,,class
Mer instruktioner angående klasser här >>
Exempel på textfil för klasser >>
Skolor ska ha en angiven skolform, i standardiserad punktnotation (jfr. skolverkets struktur)
| Värde | Betydelse |
|---|---|
| se.forskoleverksamhet.forskola | Förskola |
| se.forskoleverksamhet.familjedaghem | Familjedaghem |
| se.forskoleverksamhet.oppenforskola | Öppen förskola |
| se.grundskoleutbildning.forskoleklass | Förskoleklass |
| se.grundskoleutbildning.grundskola | Grundskola |
| se.grundskoleutbildning.specialskola | Specialskola |
| se.grundskoleutbildning.sameskola | Sameskola |
| se.grundskoleutbildning.sarskola.grundsarskola | Grundsärskola |
| se.grundskoleutbildning.sarskola.traningsskola | Träningsskola |
| se.gymnasieutbildning.gymnasieskola | Gymnasieskola |
| se.gymnasieutbildning.gymnasiesarskola | Gymnasiesärskola |
| se.vuxenutbildning.grundlaggande | Grundläggande vuxenutbildning |
| se.vuxenutbildning.sfi | Svenska för invandrare (sfi) |
| se.vuxenutbildning.sarvux | Särvux |
| se.vuxenutbildning.gymnasial | Gymnasial vuxenutbildning |
| se.vuxenutbildning.kompletterande | Kompletterande vuxenutbildning |
| se.vuxenutbildning.pabyggnads | Påbyggnadsutbildning |
| se.folkhogskola | Folkhögskola |
| se.ky | Kvalificerad yrkesutbildning |
| se.universitet | Universitet |
| se.personal.medarbetarsamtal | Medarbetarsamtal |
unikaskolan,144123456,Unika skolan,,7,12,,http://www.unikaskolan.se,08-100000,,Unikumgatan 1,74634,Grönköping,,school
lillaskolan,145123456,Lilla skolan,,7,9,,,,,,,,,school
Mer instruktioner angående skolor här >>
Exempel på textfil för skolor >>
Genom all ladda upp en relationsfil kan du skapa och ta bort relationer mellan befintliga användare och grupper. Relationsfilen är tabbavgränsad och innehåller instruktioner som kopplar ihop befintliga användare och grupper.
För att kunna koppla ihop användare och grupper måste både användarna och grupperna ha unika identifierare. För personer är det personnummer i formen ååååmmdd-nnnn. När det gäller grupper föreslår vi identifierare som ser ut ungefär så här:
Klass 7E i som började i Lilla Skolan, Grönköping 2007: gronkoping_lillaskolan_E_2007 - på det sättet kan gruppen behålla sitt ID även när klassen blir klass 8E nästa år.
school_in_org (skola i kommun)
class_in_school (klass i skola)
student_in_class (elev i klass)
teacher_in_class (lärare i klass)
mentor_for (mentor för)
guardian_for (vårdnadshavare för)
external_user_in_school (vårdnadshavare i skolan)
student_in_school (elev i skola)
staff_in_school (personal i skola)
administrator_for (administratör för)
add 19700101-0101 guardian_for 19900202-0202
remove 19700101-0101 guardian_for 19810202-0202
add 19900202-0202 student_in_class gronkoping_lillaskolan_E_2007
Mer info angående koppling klass i skola här >>
Mer info angående koppling elev i klass här >>
Mer info angående koppling lärare i klass här >>
Mer info angående koppling mentor för elev här >>
Mer info angående koppling vårdnadshavare för elev här >>
Mer info angående koppling personal i skola här >>
Importförfarandet kan automatiseras på följande sätt:
1. Avsändande kommunen genererar filer i Unikums format. Filer med användare, grupper, skolor skall ha filändelsen ".principals". Filer innehållande relationer skall ha filändelsen ".relations".
2. Avsändande kommun packar filerna (zip).
3. För att garantera säkerheten används PGP för att kryptera och signera filen. Kontakta support@unikum.net för att få vår publika PGP-nyckel.
4. Filen skickas via FTP till en FTP-server (kontakta support@unikum.net för inloggningsuppgifter).
5. Unikum hämtar filpaketet en gång per dag, avkrypterar och kör importen.
6. Alla administratörer på kommunnivå får en rapport med resultatet av importen.
Mer om autosynk här >>