Snitfladebeskrivelse Import og Eksport af.csv fil til Tabulex Skema Version 2.0 9. juli 2012 Side 1 af 8
Dokument oplysninger Dette dokument er udfærdiget af Tabulex ApS og beskyttet af copyright. Ret til ændringer forbeholdes. Version Dato Af Bemærkning 0.0 2012-05-30 MMI Første udkast 1.0 2012-06-27 MMI Til Skema version 16.2 2.0 2012-07-05 MMI Eksportformat tilføjet Dokument oplysninger... 2 Import og Eksport - fælles... 3 Indkodning... 3 Linieskift... 3 Feltseparator... 3 Import... 4 Header... 4 Kolonner... 4 Eksport... 6 Header... 6 Kolonner... 6 Eksempler... 7 Import... 7 Eksport... 8 Version 2.0 9. juli 2012 Side 2 af 8
I skemalægningsprogrammet Tabulex version 16.2 (herefter Skema) kan man importere uplacerede skemabrikker fra en CSV-fil under menupunktet: Filer > Importer fra CSV-fil. Det lagte skema kan også med variationer eksporteres til en CSV-fil under menupunktet: Filer > Eksporter til CSV-fil. Dette dokument beskriver snitfladen, dvs. filformatet, som bruges ved import og eksport, så skemabrikker fra andre programmer kan udveksles med Skema. Import og Eksport - fælles Indkodning Skema understøtter ikke unicode strenge, herunder filformatet UTF-8. Skema forventer, at indholdet i filen er indkodet med den Windows codepage, som på et dansk system som standard er 1252. Dette har betydning for de tegn, som ikke findes i det engelske alfabet, heriblandt æ, ø og å samt fx ö og ü. Filen skal derfor skrives med denne codepage, hvilket normalt er tilfældet, hvis det foregår på samme maskine. I registreringsdatabasen kan man kontrollere den af Skema benyttede codepage her: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage\ACP Linieskift Skema benytter standard Windows linieskift i filen, dvs. CR + LF. Feltseparator Den importerede fil skal have typen.csv og have værdierne adskilt af semikolon ;. Version 2.0 9. juli 2012 Side 3 af 8
Import Når.csv filer importeres, benyttes en header, der fortæller kolonnernes rækkefølge. Rækkefølgen af kolonnerne er ligegyldig, og der kan være andre kolonner end beskrevet, som blot ignoreres. Blandt de beskrevne kan kolonnerne enten være obligatoriske eller valgfrie, hvor de obligatoriske skal være til stede i filen. Header Den første linie i filen skal være en header, der som minimum har formatet [PERIODEBETEGNELSE;LÆRERBETEGNELSE;KLASSEBETEGNELSE;FAGBETEGNELSE; LOKALEBETEGNELSE;$DAG;$LEKTION] Kolonner Navn Header Beskrivelse Periodenavn PERIODEBETEGNELSE Ignoreres Lærerinitialer LÆRERBETEGNELSE Kan være blank, max 20 tegn Lærernavn LÆRERNAVN Kolonnen kan udelades, eller værdien være blank Klasse KLASSEBETEGNELSE Kan være blank, max 20 tegn Fag FAGBETEGNELSE Kan være blank, max 20 tegn Lokale LOKALEBETEGNELSE Kan være blank, max 20 tegn Dag nummer $DAG Ignoreres heltal, skriv blot 0 Lektion nummer $LEKTION Ignoreres heltal, skriv blot 0 Stjernemarkering ERDELETIME Kolonnen kan udelades, ellers * eller blank Hold KLASSER Kolonnen kan udelades, eller værdien være blank. Hvis ikke, er det en kommasepareret liste af klasser, som tilsammen udgør holdet med betegnelsen KLASSEBETEGNELSE Kolonnerne Lærerinitialer, Klasse, Fag og Lokale er obligatoriske. Kolonnerne Periodenavn, Dag- og Lektions-nummer er ligeledes obligatoriske, men værdierne ignoreres i Skema. Disse bør for tydelighed sættes til henholdsvis blank, 0 og 0. Bemærk, at skift i periodenavn bryder modulopdelingen af ellers ens lektioner. Hvis man fx indberetter 20 lektioner DAN i en klasse med samme periodebetegnelse, vil programmet danne 5 moduler á 4 lektioner. Hvis man indberetter 10 lektioner DAN med periode1 og derefter 10 lektioner DAN med periode2, vil programmet danne 5 moduler á 2 lektioner og derefter igen 5 moduler á 2 lektioner, dvs. i alt 10 moduler á 2 lektioner i stedet for 5 moduler á 4 lektioner. Kolonnerne Lærernavn, Hold og Stjernemarkering er valgfrie, men er de med, indlæses værdierne. Øvrige kolonner kan skrives til filen, men indholdet ignoreres. Kolonnerne Lærerinitialer, Klasse, Fag og Lokale vil få værdierne afkortet til 20 tegn, hvis værdierne overstiger dette. Version 2.0 9. juli 2012 Side 4 af 8
Hold Skal man lægge skema for hold bestående af flere klasser, skal man medtage Hold-kolonnen med headeren KLASSER. Hold-brikker, dvs. rækker, som gælder for mere end én klasse, skal have holdnavnet i Klasse-feltet og listen af klasser i Hold-feltet. Hvis man i Hold-kolonnen omdefinerer det samme hold undervejs (fx 1ÅRG bestående af 1A,1B og senere definerer 1ÅRG som 1A,1B,1C, vil det være den første registrering fundet i filen, der er gældende. Et hold må ikke defineres som inkluderende et andet hold. Hvis fx 1ÅRG er defineret som 1A,1B og 1AB, kan 1AB ikke efterfølgende oprettes som et hold bestående af 1A,1B. Rækker Hver række repæsenterer en skemabrik, som kan placeres i et skema af Skema programmet. En række, som beskriver, at Annette Eriksen (AE) skal have en lektion med 3A i MAT i et ikke nærmere bestemt lokale, er: ;AE;Annette Eriksen;3A;MAT;;0;0; Der skrives en linie for hver skema-brik, så hvis AE har fem af ovenstående lektioner, skal filen indeholde fem identiske rækker som ovenfor. Identiske rækker skal ligge i umiddelbar forlængelse. Moduler Skemabrikkerne indlæses i moduler på en eller flere fortløbende lektioner. Hvis der er netop to identiske rækker, laves et modul som dobbeltlektion. Ellers fordeles identiske rækker så ligeligt på fem moduler som muligt dvs. fx 12 rækker fordeles på fem moduler som to dobbeltlektioner og tre tripellektioner. Version 2.0 9. juli 2012 Side 5 af 8
Eksport Et lagt skema kan eksporteres til en.csv fil på flere måder. Der er tre menupunkter under Filer: 1) Eksporter til CSV-fil Standard 2) Eksporter CSV-fil til Uni-C Kolonnen ERDELETIME udelades 3) Eksporter til UC system Hvis man i programmet har navngivet dagene f.eks. 1: 03-09-2012, 2: 04-09-2012 osv. vil kolonnen $DAG indeholder dette dag-navn i stedet for dag nummer. Header Den første linie i filen er en header, der har formatet [$ID;PERIODEBETEGNELSE;LÆRERBETEGNELSE;KLASSEBETEGNELSE;FAGBETEGNELSE;LOKALEBETEGNELSE; $DAG;$LEKTION;RINGETIDSBETEGNELSE;ERDELETIME;KLASSER] For 2) udelades ERDELETIME; Kolonner Navn Header Beskrivelse Id $ID Heltal: løbenummer kan ignoreres Periodenavn PERIODEBETEGNELSE Blank Lærerinitialer LÆRERBETEGNELSE Kan være blank, max 20 tegn Klasse KLASSEBETEGNELSE Kan være blank, max 20 tegn Fag FAGBETEGNELSE Kan være blank, max 20 tegn Lokale LOKALEBETEGNELSE Kan være blank, max 20 tegn Dag nummer $DAG Heltal: 1: mandag 2: tirsdag osv. For 3) bruges de dagnavne, der er indskrevet under Værktøj > Indstillinger > Skemaindstilling > Skematider > Dage Lektion nummer $LEKTION Heltal: 1: første lektion 2: anden lektion osv. Stjernemarkering ERDELETIME * hvis Stjernemarket i program, ellers blank Udelades for 2) Hold KLASSER Kan være blank Hvis ikke, er det en kommasepareret liste af klasser, som tilsammen udgør holdet med betegnelsen KLASSEBETEGNELSE Det er kun det lagte skema, som eksporteres. Uplacerede og inaktive brikker udelades fra.csv filen (hvorfor der kan være spring i løbenumrene i Id kolonnen). Version 2.0 9. juli 2012 Side 6 af 8
Eksempler Import I det følgende eksempel har Annette Eriksen (AE) klassen 0A i tre lektioner i lokalet BHK og i et ikke nærmere bestemt fag. Vibeke Venge (VV) har 2A i to lektioner dansk i et ikke nærmere bestemt lokale Anna Axelsen (AA) har 2B i to lektioner dansk i et ikke nærmere bestemt lokale VV har holdet 2AAR, som består af 2A og 2B, i to lektioner billedkunst i billedkunstlokalet [PERIODEBETEGNELSE;LÆRERBETEGNELSE;LÆRERNAVN;KLASSEBETEGNELSE;FAGBETEGNELSE;LOKALEBETEGNELSE;$DAG;$LEKTION;KLASSER] ;AE;Annette Eriksen;0A;;BHK;0;0; ;AE;Annette Eriksen;0A;;BHK;0;0; ;AE;Annette Eriksen;0A;;BHK;0;0; ;VV;Vibeke Venge;2A;DAN;;0;0; ;VV;Vibeke Venge;2A;DAN;;0;0; ;AA;Anna Axelsen;2B;DAN;;0;0; ;AA;Anna Axelsen;2B;DAN;;0;0; ;VV;Vibeke Venge;2AAR;BIL;BIL;0;0;2A,2B ;VV;Vibeke Venge;2AAR;BIL;BIL;0;0;2A,2B Version 2.0 9. juli 2012 Side 7 af 8
Eksport Efter at filen ovenfor er importeret og skemaet fyldt, er brikken AE;0A;;BHK blevet fjernet fra skemaet (tirsdag 1. lektion) og deaktiveret. Så er skemaet eksporteret 1) Eksporter som CSV-fil [$ID;PERIODEBETEGNELSE;LÆRERBETEGNELSE;KLASSEBETEGNELSE;FAGBETEGNELSE;LOKALEBETEGNELSE;$DAG;$LEKTION;ERDELETIME;KLASSER] 0;;AE;0A;;BHK;3;1;;; 2;;AE;0A;;BHK;1;1;;; 3;;VV;2A;DAN;;2;1;;; 4;;VV;2A;DAN;;2;2;;; 5;;AA;2B;DAN;;2;1;;; 6;;AA;2B;DAN;;2;2;;; 7;;VV;2AAR;BIL;BIL;1;1;;2A,2B; 8;;VV;2AAR;BIL;BIL;1;2;;2A,2B; 2) Eksporter CSV-fil til Uni-C [$ID;PERIODEBETEGNELSE;LÆRERBETEGNELSE;KLASSEBETEGNELSE;FAGBETEGNELSE;LOKALEBETEGNELSE;$DAG;$LEKTION;KLASSER] 0;;AE;0A;;BHK;3;1;; 2;;AE;0A;;BHK;1;1;; 3;;VV;2A;DAN;;2;1;; 4;;VV;2A;DAN;;2;2;; 5;;AA;2B;DAN;;2;1;; 6;;AA;2B;DAN;;2;2;; 7;;VV;2AAR;BIL;BIL;1;1;2A,2B; 8;;VV;2AAR;BIL;BIL;1;2;2A,2B; 3) Eksporter til UC-system med dagnavnene 1: 03-09-2012, 2: 04-09-2012 og 3: 05-09-2012 [$ID;PERIODEBETEGNELSE;LÆRERBETEGNELSE;KLASSEBETEGNELSE;FAGBETEGNELSE;LOKALEBETEGNELSE;$DAG;$LEKTION;ERDELETIME;KLASSER] 0;;AE;0A;;BHK;05-09-2012;1;;; 2;;AE;0A;;BHK;03-09-2012;1;;; 3;;VV;2A;DAN;;04-09-2012;1;;; 4;;VV;2A;DAN;;04-09-2012;2;;; 5;;AA;2B;DAN;;04-09-2012;1;;; 6;;AA;2B;DAN;;04-09-2012;2;;; 7;;VV;2AAR;BIL;BIL;03-09-2012;1;;2A,2B; 8;;VV;2AAR;BIL;BIL;03-09-2012;2;;2A,2B; Version 2.0 9. juli 2012 Side 8 af 8