Teknisk dokumentation för systemadministratörer - importformat

INNEHÅLLSFÖRTECKNING

• 1. Om denna dokumentation
• 2. Sammanfattning av importprocessen
• 3. Backupformat för Moodle (MBZ)
  • Import av kursstruktur
  • Innehållstyper som stöds
• 4. Common Cartridge Format (IMSCC)
  • Om Common Cartridge
  • Innehållstyper som stöds
• 5. Att tänka på vid rik text
  • 5.1 Vad exporteras
  • 5.2 Kända begränsningar – rik text-formatering och HTML-nivåer
    • 5.2.1 Taggar och attribut
• 6. Felsökning
  • 6.1 Problem med formatering av rik text
  • 6.2 Saknat innehåll efter import
  • 6.3 Länkar och media som inte fungerar
  • 6.4 H5P-innehåll som inte fungerar
  • 6.5 Generella problem med formatering
• 7. När man ska kontakta supporten

1. Om denna dokumentation

Den här artikeln ger en översikt över de två filformat som stöds för att importera innehåll till itslearning: MBZ och IMSCC.

Det är inte en steg-för-steg-guide, utan snarare en referens som hjälper dig att förstå:

• Vilka typer av innehåll varje format stöder

• Hur itslearning hanterar struktur och formatering

• Kända begränsningar och felsökningstips

Den här artikeln är avsedd att komplettera steg-för-steg-instruktionerna som finns i guiderna för kursimport/export. Den är särskilt relevant för systemadministratörer och lärare som överför innehåll från Moodle eller andra LMS.

2. Sammanfattning av importprocessen

• Innehåll importeras till en befintlig itslearning-kurs

• Varje import skapar en mapp i sektionen Innehåll, namngiven efter källkursen.

• Kursstruktur och innehåll återskapas i den mappen

• Flera importer kan utföras i samma kurs

3. Backupformat för Moodle (MBZ)

Import av kursstruktur

• En huvudmapp skapas med hjälp av Moodle-kursens titel

• Om en sammanfattning finns i Moodle-kursen, används den som beskrivning för mappen.

• Varje avsnitt i Moodle-kursen blir en undermapp

• Avsnittsnamn och beskrivningar bevaras

• Innehållet placeras i motsvarande mappar

Innehållstyper som stöds

Obs! Innehållstyper som inte stöds, till exempel Glossary, Workshop, och Database hoppas över i importen.

4. Common Cartridge Format (IMSCC)

Om Common Cartridge

Common Cartridge (CC) är ett standardformat utvecklat av 1EdTech för att stödja interoperabilitet mellan olika LMS. Det möjliggör konsekvent paketering av digitala lärresurer för återanvändning och migrering.

Innehållstyper som stöds

5. Att tänka på vid rik text

Rikt textinnehåll (som beskrivningar i uppgifter, diskussioner och sidor) exporteras som HTML, men det finns vissa begränsningar att vara medveten om.

5.1 Vad exporteras

• Det mesta av formatering, tabeller och bilder bevaras

• Emoticons (smileys) är borttagna

• Relativa länkar (t.ex. länkar till andra resurser inom kursen) exporteras i befintligt skick och kommer inte att tolkas korrekt efter import.

• Tredjeparts-plugins (som t.ex. H5P) inbäddade i textredigeraren fungerar inte efter import

• Bilder och media med absoluta URL:er bevaras

• Bilder och media med relativa URL:er importeras inte

5.2 Kända begränsningar – rik text-formatering och HTML-nivåer

Alla lärplattformar, såsom Moodle och itslearning, är utrustade med en textredigerare som gör det möjligt för användare att infoga formatering, tabeller, bilder med mera i textfält som finns tillgängliga över hela plattformen

Det kan finnas vissa skillnader mellan hur rik text-beskrivningar visas i till exempel Moodle och hur de visas i itslearning efter import.

5.2.1 Taggar och attribut

Hur text ska visas beskrivs tekniskt i HTML-formatet (HyperText Markup Language). I HTML-formatet används taggar för att tala om för webbläsaren hur texten ska visas. Till exempel kan HTML-taggen "<b>" användas för att tala om för webbläsaren att texten ska visas i fetstil. Där "</b>" används för att ange var den fetstilta texten slutar. Så om HTML-koden innehåller "<b>denna text är fet</b> och den här texten är det inte" kommer det att se ut som "denna text är fetstil och den här texten är det inte". Dessutom kan en tagg ha attribut. Till exempel kan attributet "bredd" användas för att tala om för webbläsaren hur bred en tabell eller bild ska vara.

Av säkerhetsskäl tillåter itslearning inte alla HTML-taggar och attribut. Detta kan begränsas ytterligare med en användarrättighet i itslearning, som kan beviljas via Profiler eller Policyer. Denna användarrättighet kallas "Tillåten HTML-kodnivå" och ju mer begränsad den är, desto färre HTML-element och attribut får du använda. Generellt sett tillåter "Mycket begränsad" endast enkel formatering som fetstil, kursiv stil och understrykning samt nya rader eller stycken. Skillnaderna mellan "Begränsad" och "Mindre begränsad" är små och kommer sannolikt knappast att märkas.

• Användare med HTML-nivån Mycket begränsad kan inte importera bilder, länkar eller media

• Iframes visas bara om det är tillåtet enligt domänens vitlista.

• H5P-innehåll stöds inte och kommer att visas som platshållartext (e.g., @@PLUGINFILE@@/filename.h5p)

6. Felsökning

6.1 Problem med formatering av rik text

Problem: Rik text-innehåll ser annorlunda eller förenklat ut efter import 

Symptom:

• Textformateringen har förlorats eller ändrats
• Bilder, tabeller eller media saknas i beskrivningar
• Innehållet visas som vanlig text istället för formaterad text

Lösning:

1. Kontrollera inställningen "Tillåten HTML-kodnivå" i itslearning-användarprofilen
2. Kontakta systemadministratören för att justera HTML-begränsningar om det behövs
3. Verifiera att användaren har rätt behörighet för rikt text-innehåll

6.2 Saknat innehåll efter import

Problem: Förväntat innehåll visas inte i itslearning efter import 

Symptom:

• Kursavsnitt är tomma
• Specifika aktiviteter eller resurser saknas
• Importen verkar lyckad men innehållet är ofullständigt

Lösning:

1. Kontrollera att innehållstypen stöds för ditt importformat (MBZ/IMSCC)
2. Kontrollera tabellen över innehållstyper som stöds i det här dokumentet
3. Innehållstyper som inte stöds(Glossary, Workshop, Database) hoppas automatiskt över
4. Granska importloggen för eventuella felmeddelanden

6.3 Länkar och media som inte fungerar

Problem: Länkar och mediefiler fungerar inte efter import 

Symptom:

• Bilderna visas som trasiga/saknas
• Länkar leder till felsidor
• Mediefiler spelas inte upp eller visas inte

Lösning:

• För bilder/media: Kontrollera om det ursprungliga innehållet använde relativa URL:er (stöds inte).
• För länkar: Verifiera om länkarna var interna kurslänkar (kommer att brytas efter import)
• Workaround: Ladda upp mediefiler direkt till itslearning igen
• Workaround: Uppdatera länkar så att de pekar på nya itslearning-platser

6.4 H5P-innehåll som inte fungerar

Problem: Interaktivt H5P-innehåll visas som platshållartext 

Symptom:

• Text visar"@@PLUGINFILE@@/filename.h5p"
• Interaktivt innehåll ersätts med icke-funktionell text
• H5P-aktiviteter saknas i kursen

Lösning:

• Förstå att: H5P-innehåll stöds inte av importsystemet för närvarande
• Workaround: Återskapa H5P-innehåll med itslearnings inbyggda verktyg
• Alternativ: Exportera H5P-innehåll separat och importera det igen med hjälp av itslearnings H5P-integration (om tillgänglig)

6.5 Generella problem med formatering

Problem: Kursens layout eller formatering ser annorlunda ut än förväntat 

Symptom:

• Tabeller visas förenklade
• Färger eller stil saknas
• Layoutelement har flyttats eller tagits bort

Lösning:

1. Förstå att: Viss formatering är förenklad av säkerhetsskäl
2. Kontrollera: Verifiera dina behörigheter på HTML-kodnivå
3. Workaround: Justera formateringen manuellt i itslearning efter import

7. När man ska kontakta supporten

Kontakta din systemadministratör när:

• HTML-kodnivå behöver justeras
• Användarbehörigheter behöver ändras
• Konfiguration av domänvitlista krävs

Kontakta itslearning-supporten när:

• Importprocessen misslyckas helt
• Innehållstyper som stöds importeras inte korrekt
• Tekniska fel under importprocessen