Documentation/Project K/Import procedure

Virtual research environment for collaborative analysis of classroom photographies. The initial metadata have been collected in Citavi system, which prones to errors and many cycles of data correction and validation. Metadata collected in Citavi was exported first to an Excel file and after to xml format.

Prerequisites

In order to have a meaningfull data, the following steps are necessary:

Cleaning up the data. Please verify that MSWord text formatting characters are not into Citavi file. If yes, please remove them.
Export Citavi file to Excel
Build up a schema for Excel file. This will be used to export excel file to XML format. XML format will be transformed using an .XSLT transformation script.

An example of the schema file is the following:

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="ItemsTable">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="ItemRow" minOccurs="0" maxOccurs="unbounded"/>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
    <xs:element name="ItemRow">
        <xs:complexType>
            <xs:sequence>
				<xs:element name="Jahrermittelt" type="xs:string"/>             
                <xs:element name="Titel" type="xs:string"/>
				<xs:element name="Dateiname_Artikel" type="xs:string"/>
				<xs:element name="Ort" type="xs:string"/>
				<xs:element name="Verlag" type="xs:string"/>
				<xs:element name="Zeitschrift_Zeitung" type="xs:string"/>
				<xs:element name="Nummer" type="xs:string"/>
				<xs:element name="Seiten_von_bis" type="xs:string"/>
				<xs:element name="Artikeltitel" type="xs:string"/>
				<xs:element name="Artikelseiten" type="xs:string"/>
				<xs:element name="Artikelautor" type="xs:string"/>
				<xs:element name="Fotoredaktion_Gestaltung" type="xs:string"/>
				<xs:element name="Fotountertitel" type="xs:string"/>
				<xs:element name="Jahrgang" type="xs:string"/>
				<xs:element name="Notiz" type="xs:string"/>
				<xs:element name="Rubrik" type="xs:string"/>
				<xs:element name="Redaktion" type="xs:string"/>
				<xs:element name="Autor" type="xs:string"/>
				<xs:element name="Fotoagentur" type="xs:string"/>
				<xs:element name="Kategorien" type="xs:string"/>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

Use the transformation procedure as it is described in: Excel to XML: How to Transfer Your Spreadsheet Data Onto an XML File

Import requirements

Import procedure requires:

a valid XML file, as result of the prequisites step.
a structure wiki page, for translating the categories into upper level categories. This page will be created by wiki admin into MediaWiki: namespace, MediaWiki:Structure.

Example:

*Setting
**Klassenraum
**Fachraum
**Flur
**Außenbereich
**Bühne
**Außerschulischer Lernort
**Setting uneindeutig
*Raumanordnung
**Parallele Sitzreihen
**Gruppentische
**U-Form
**Stuhlkreis
**ohne relevantes Mobiliar
**Tischkreis
**Einzeltische
**U-Form mit Quertischen
**Lehrertisch
**Tafel
*Akteure
**Lehrer
**Schüler
**Einzelperson
**Personengruppe
*Sozialformen des Unterrichts
**Frontalunterricht
**Plenumsunterricht
**Gruppenarbeit
**Partnerarbeit
**Einzelarbeit
*Lehrer-, Schüleraktivität
**Schüler arbeiten
**Lehrervortrag
**Schülervortrag
**Schüler verfolgen Vortrag
**Lehrer-Schüler-Interaktion
*Lehr- und Lernmittel
**Bücher
**Arbeitsblätter-Hefte-Mappen
**Schreib- und Zeichenutensilien
**Mal- und Bastelutensilien
**Werkzeuge-Instrumente-Gefäße
**Werkstoffe
**sonstige Lernmittel
**Musikinstrumente
**Visualisierungsmedien
**Computer
**Lehr- und Lernmittel uneindeutig
*Bildgröße
**2
**1,5
**1
**0,75
**0,5
**0,33
**0,25
**0,125
*Einstellungsgröße
**Totale
**Halbtotale
**Halbnahe
**Nahe Einstellung
**Großaufnahme
**Detailansicht
*Perspektive
**Zentralperspektive
**Froschperspektive
**Vogelperspektive
*Schärfe als Kontrastmittel
**Schärfe als Kontrastmittel
*Farbe
**Farbe
**Schwarz-Weiß
*Bildserie
**Bildserie

a .XSLT transformation file, to transform XML file to wiki content using wiki templates. These templates have to be previously created into wiki.

SMW extension for import

The extension ImportK is of type SpecialPage for MediaWiki. Requires:

a valid MediaWiki installation, version 1.29.x or later.
a valid Semantic MediaWiki installation, at least vesrion 2.5.4. For visualisation, Semantic Result Formats is also necessary.
other extensions: Parser Functions, Arrays, etc.
For how to install MediaWiki and extensions, please consult MediaWiki and Semantic MediaWiki sites.
enables MediaWiki to upload pictures

Installation

download the extension from:
install the extension as any other extensions of type SpecialPage for MediaWiki
edit LocalSettings.php file in order to set up the global variables, as follows:

$ikFullImagePath = 'path to the pictures';
$ikFullLocalPath = 'valid path where the temporary wiki files will be stored';
$ikServerHostUrl = 'mediawiki root path';
$ikFilePrefix = 'File:'; // Might be ''Datei: in German
$ikCurrProject = "MediaWiki:Structure"; // other valid wiki page

The valid XML file is in the extension root, under the name of exampl.xml. This can be changed too.

Customization

Navigationsmenü