Diese Seite enthält einige Beispiele zur Ausgabe von
Daten aus dem 
UnivIS-System.
Die Beschreibung der Anwendung folgt in Kürze. Bis dahin können über die Standard-XHTML-Vorlagen im Downloadbereich die notwendigen Skripten und Beispieldateien geladen werden.
Einrichtungssuche
Mit der Suche nach Einrichtungen können Daten für das Organigramm erstellt werden, aber auch wichtige Metainformationen abgerufen werden. (Zum Beispiel die notwendige Organisationsnummer für die eigene Einrichtung).
Einbindung in Webseiten
Der Einbau des Organigrammes in eine HTML-Seite erfolgte durch die Angabe der SSI-Anweisung:
<!--#include virtual="/cgi-bin/univis/organigramm.pl"-->
Der Einbau der alphabetischen Mitarbeiterliste in eine HTML-Seite erfolgte durch die Angabe der SSI-Anweisung:
<!--#include virtual="/cgi-bin/univis/organigramm.pl"-->
Konfiguration
Die allgemeine Konfiguration kann über die Konfigurationsdatei vkdaten/univis.conf beeinflußt werden.
Wenn Konfigurationseinstellungen über die Datei nicht angegeben oder geändert werden, wirken die Voreinstellungen.
Folgende Konstanten können zur Konfiguration in der Konfigurationsdatei verwendet werden:
| Konstante | Voreinstellung | Beschreibung |
|---|---|---|
| UnivISOrgNr | 86400 | Zentrale UnivIS-Orgnummer. Diese wird verwendet bei Abfragen, die eine vorgegebene Einrichtung betreffen. Dies ist die wichtigste EInstellung und die einzige die wirklich angegeben werden muß. Um die UnivIS-Orgnummer zu erhalten, wenden Sie sich entweder an den UnivIS-Support oder verwenden die Einrichtungsssuche in den UnivIS-Daten. (Diese liefert jedoch bei einigen Einrichtungen aufgrund von technischen Problemen keine Angabe). |
| Personenanzeige_Datenverzeichnis | /wir-ueber-uns/ | Webverzeichnis mit Zusatzinformationen zu einer Person.
Dieses Verzeichnis ist relativ zum Webverzeichnis und sollte aus dem Web erreichbar sein.
Die Datendateien für Personen haben immer die festgelegte Syntax:
vorname-nachname.$Endung, wobei $Endung je nach Funktion entweder "txt", "jpg" oder "gif" sein kann |
| URL_Mitarbeiter | /wir-ueber-uns/personal.shtml | Angabe der URL zu der dynamischen Mitarbeiterseite. In dieser HTML-Datei muss die
Anweisung <!--#include virtual="/cgi-bin/univis/mitarbeiter.pl"--> enthalten sein. |
| Personenanzeige_Bildsuche | 1 | Wenn dieser Wert auf 1 gesetzt ist, wird in dem Datenverzeichnis nach einem Personenbild gesucht. Dieses muss die Form "vorname-nachname.jpg" oder "vorname-nachname.gif" haben und sollte festgelegte Größen haben (Bitte lassen Sie bei Bilder niemals den Browser skalieren, sondern tun dies mit einem geeigneten Grafikprogramm selbst!) |
| Personenanzeige_BildBreite | 120 | Standardmäßige Bildbreite in Pixel |
| Personenanzeige_BildHoehe | 150 | Standardmäßige Bildhöhe in Pixel |
| Personenanzeige_Bildfehlt | /img/kein-bild2-120px.gif | Wenn kein Personenbild gefunden wurde, kann hier bestimmt werden, was andernfalls passiert. Wenn hier die URI eines Ersatzbildes angegeben wird, wird dieses vertwendet. Wenn dieser Wert leer ist, wird gar kein Bild angezeigt. |
| TimeoutCache | 86400 | Maximale Zeit in Sekunden in der Inhalte aus dem Cache entnommen werden anstelle, daß sie direkt von UnivIS geholt werden |
| DIR_SeitenCache | ./cache/ | Verzeichnis für temporäre Ergebnisse, die für die Dauer der Cachetime zur Ausgabe verwendet werden |
| SeitenCache | 3600 | Zeit in Sekunden die angibt, wie lange eine einmal erstellte Personenseite zwischengespeichert und nicht neu erstellt wird. |
| SUFFIX_Mitarbeiterurl | .shtml | Suffix fuer Mitarbeiter-URLs. Dient im Prinzip nur der Täuschung gegen Angriffe und dem einheitlichen Erscheinungsbild der Adresse. Ist aber eigentlich nicht notwendig |
| Index_Ankerliste | 1 | Wenn dies 1 ist, wird über die Liste der Personen eine Ankerliste entsprechend der vorgegebenen Sortierung gemacht |
| SortIndex | univis | Definiert wie der Index der Personen einer Einrichtung sortiert werden soll.
Mögliche Werte:
|
| Personenanzeige_LehrtypFilter | lehrbe | Hier wird (kommasepariert) angegeben, welche Personen nicht angezeigt werden sollen. (Default: "lehrbe" = Lehrbeauftragte.) Hier werden die internen UnivIS-Bezeichner verwendet. |
| Personenanzeige_Lehrveranstaltungen | 1 | Ist dieser Wert = 1 werden die Lehrveranstaltungen der Person gesucht und angezeigt wenn vorhanden. Achtung: Dies Funktioniert nur dann, wenn die Person auch als "Lehrperson" (ja) im UnivIS eingetragen ist. |
| Personenanzeige_Publikationen | 0 | Ist dieser Wert = 1 werden die Publikationen der Person gesucht und angezeigt wenn vorhanden. Achtung: Die Suche verlangsamt den Aufruf merkbar. |
| Personenanzeige_ZusatzdatenInDatei | 1 | Ist dieser Wert =1 wird in dem Datenverzeichnis
nach Dateien der Form "vorname-nachname.txt"
gesucht. Ist eine solche Datei vorhanden, wird dessen Inhalt gemäß dem Template-Angaben unverändert ausgegeben.
Die Dateiendung .txt bedeutet nicht, daß kein HTML verwendet werden kann.
Die Einbindung im Template erfolgt durch folgende Angaben:
<#if "<#print type="var" name="LadePersonendatei">"#>
<#include type="file" value="<#print type="var" name="Personendatei">"#>
<#endif#>
|
| Personenanzeige_Zusatzdateifehlt | Allgemeiner Dateiname mit Inhalt für den Fall das keine individuellen Personendateien angegeben sein sollen. | |
| Organigramm-ZeigeOrgAdresse | 1 | Bei der Anzeige des Organigrammes wird per default auch nochmal die Einrichtungsadresse mit ausgegeben Wenn dieses aktiv ist, kann man es mit der GET-/PATH-Variable HideOrgAdresse wieder deaktivieren |
| Organigramm_PersonenDescriptionFilter | Webmaster, UnivIS, Sicherheit, Postmaster | Filter fuer die Jobanzeige bei der Organigrammansicht. Personengruppen die diese Strings in der UnivIS-XML-Variable "description" haben, werden nicht extra (nochmal) angezeigt |
| Layout_Organigramm_Index | layout/organigramm-index.html | Index- und Metaseite des Organigramms. Darin eingebettet werden diverse Ausgaben von folgenden Teiltemplates |
| Layout_PersonenIndex | layout/personen-index.html | Ausgabe des Index der Personen einer Einrichtung |
| Layout_PersonenIndex_Zeile | layout/personen-index-zeile.html | Einzelne Zeile |
| Layout_PersonenSeite | layout/personen-seite.html | Seite / Visitenkarte einer einzelnen Person |
| Layout_Personen_Seite_Lectures | layout/personen-seite-lectures.html | Anzeige der von einer Person gehaltenen Lehrveranstaltungen |
| Layout_Personen_Seite_Publications | layout/personen-seite-publications.html | Tenplate der von einer Person gehaltenen Publicationen |
| START_SOMMERSEMESTER | 1.4. | Wird verwendet für die automatische Erkennung welches Semester aktuell ist. |
| START_WINTERSEMESTER | 1.10. | Wird verwendet für die automatische Erkennung welches Semester aktuell ist. |
Es werden programmintern weitere Konstanten definiert. Diese sollten jedoch nicht verändert werden und werden deswegen hier nicht aufgeführt.
Templates
Die Ausgabe der Daten erfolgt mit Hilfe vordefinierter Templates. Dabei handet es sich um HTML-Dateien, in denen die
Gestaltung, Position und Angabe der jeweiligen Daten bestimmt ist.
Diese Dateien finden sich im Verzeichnis /cgi-bin/univis/layout/ unterhalb des Stammverzeichnisses jedes Webauftritts.
Template-Dateien
| organigramm-index.html | Index- und Metaseite des Organigramms.Darin eingebettet werden diverse Ausgaben von folgenden Teiltemplates. |
|---|---|
| personen-index.html | Ausgabe des Index der Personen einer Einrichtung |
| personen-index-zeile.html | Einzelne Zeile mit den Daten einer Person. Diese Zeile wird bei der Indexübersicht, die mit dem Template personen-index.html
nacheinander für alle Personen der Einrichtung angezeigt. |
| personen-seite.html | Dieses Template beschreibt den Inhalt einer Personenvisitenkarte; Die Komplettdarstellung einer Person. |
| personen-seite-lectures.html | Wenn per Konfiguration in der Personenvisitenkarte auch die aktuellen Vorlesungen angezeigt werden sollen, werden die Veranstaltungen mit diesem Template gestaltet. |
| personen-seite-publications.html | Wenn per Konfiguration in der Personenvisitenkarte auch die im UnivIS eingetragenen Publikationen an der die jeweillige Person beteiliugt war, angezeigt werden sollen, werden diese mit diesem Template gestaltet. |
Anwendungsbeispiele
Organigramm
Ansicht einer Mitarbeiterliste einer Einrichtung in hierarchischer Ansicht (wie es aus dem UnivIS gewohnt ist).
Der Einbau des Organigrammes in eine HTML-Seite erfolgte durch die Angabe der SSI-Anweisung:
<!--#include virtual="/cgi-bin/univis/organigramm.pl"-->
Mitarbeiterliste
Die Mitarbeiterliste zeigt alle Mitarbeiter einer Organisation an. (Bzw.
einer Oberorganisation mit dessen untereinheiten, beginnend mit einer Id).
Für jeden Mitarbeiter wird eine eigene "Visitenkarte" erstellt, die
auch bookmarkbar ist. Diese Visitenkarte besteht aus allen Daten, die
im UnivIS zu der Person eingetragen sind und zusätzlich optional aus
lokal abgespeicherten Daten.
Der Einbau der Mitarbeiterliste in eine HTML-Seite erfolgte durch die Angabe der SSI-Anweisung:
<!--#include virtual="/cgi-bin/univis/mitarbeiter.pl"-->