HTML Details

Hintergrund Informationen über HTML und die Verwendung als Report Format


Allgemeines

Wenn Sie sich zum ersten mal mit dem Reporting der IRIS beschäftigen, so werden Sie sich wahrscheinlich darüber wundern, dass wir ausgerechnet HTML als Format verwendet haben. Dies erscheint doch in Zeiten der Marktdominanz von Microsoft und der Übedrmacht von WinWord erstaunlich. Dies um so mehr als auch viele andere Report Programme nur auf WinWord setzen. Hier nun eine kleine Liste von Argumenten, die erläutert, warum wir HTML für das überlegene Format halten:

Natürlich hat HTML nicht nur Vorteile. Wir wollen die Nachteile nicht verschweigen. Hier sind sie:


Report-Datei-Organisation

Alle Reports werden derzeit im IRIS-Verzeichnis - und dort im Unterverzeichnis "Reports" erstellt. (Veränderbar mit Datei->Verzeichnisse)
Jeder Report hat ein eigenes Verzeichnis in welchem die HTML-Datei und alle Bilder gespeichert werden.
Die HTML-Datei hat immer den Namen: index.htm - Spätere Versionen werden Seitennummern (01.htm, 02.htm, ...) unterstützen.
Die von IRIS erzeugten Bilder haben immer die Namen: pic##.bmp wobei ## zwei Zahlen repräsentiert. Bei mehr als 99 Bildern wird pic100.bmp benutzt. Der Bilder-Nummern-Zähler wird beim Start eines neuen Reports (und auch bei der Benutzung einer Vorlage) auf eins gesetzt.

Vorlagen-Organisation

Es wird empfohlen, alle Vorlagen in einem eigenen Applikations-Verzeichnis zu halten. Jede Vorlage sollte wiederum ein eigenes Verzeichnis haben. Eingebette Bilder MÜSSEN (derzeit) im selben Verzeichnis liegen. Die Benutzung relativer Pfade wird nicht unterstützt.
Es ist möglich mit Datei->Verzeichnisse selbst einen Standard-Pfad anzugeben, in dem alle Vorlagen liegen.

Beispiel zur Definition der eigenen Verzeichnisse:

Pfad für eigene Reports: c:\th32.rep
Pfad für Vorlagen c:\th32.app\reports

Eigener, leerer Report

IRIS erstellt bei AutoReport->Datei->Neu einen leeren Report gemäss der untenstehenden Formatierung.
Möchten Sie einen eigenen, leeren Report erstellen der z.B. immer Ihr Logo oder andere Elemente enthält - und absichtlich NICHT eine Vorlage verwenden, so können Sie dies wiefolgt erreichen:

Findet IRIS eine solche Seite, so wird sie statt der leeren Seite verwendet. Es ist also dann die "normale" leere Vorlage.


HTML Detail Informationen

Das Grundformat einer leeren, neuen Datei

Ist keine anderweitige Standard-Vorlage vorhanden, so erstellt IRIS dieses 'Grunddokument':

<html> Beginn des HTML-Dokuments
<head> Beginn der Kopfzeilen, die NICHT sichtbar sind, sondern globaler Information dienen
<meta....> Content-Typ (text/html) und deutscher Zeichensatz (ISO-8859-1)
<meta....> Generator-Bezeichnung (PicWin-IRIS)
(Wird von anderen Editoren später gandenlos überschrieben)
<title> PicWin-IRIS Report </title> Titel des Reports - Erscheint im Titel des Internet Explorers - nicht im Dokument
</head> Ende der Kopfzeilen
<body bgcolor="#FFFFFF"> Beginn des Inhalts - Hintergrund wird auf WEISS gesetzt
</body> Ende des Inhalts
</html> Ende des HTML-Dokuments
   

Dies ist die nahezu kleinst mögliche, sinnvolle HTML-Datei.

Wie und wo IRIS Informationen hinzufügt:

Wann immer der Report Generator etwas zum Report hinzufügt, so sucht IRIS den Text </body> im Dokument - und fügt die notwendigen Informationen VOR diesem 'Endezeichen' ein. Damit ist sicher gestellt, dass weitere Informationen immer am Ende angefügt werden.

Wie IRIS Bilder hinzufügt

Wann immer ein Bild hinzugefügt werden soll, so schreibt IRIS erst einmal eine BMP-Datei ins aktuelle Report-Verzeichnis.
Die erste Datei hat diesen Namen: pic01.bmp.
Dann wird am Ende (vor </body>) folgender Text eingefügt:
<img src="pic01.bmp">

Der Zeilenwechsel

Ein Zeilenwchsel hat dieses Format: <br>
Man beachte, dass es KEIN </br> gibt. Solch eine Anweisung hat weder Anfang noch Ende!

Format einer Text-Zeile

<p> Dies ist ein Text </p>

Format von Datum und Uhrzeit:

10.12.2002 - 14:23:59

Einfache Überschriften:

Um eine Überschrift einzufügen, benutzen Sie den +HTML Befehl. Es stehen Überschriften in sechs Ebenen (von sehr gross (1) bis recht klein (6) ) zur Verfügung. Hier zwei Beispiele:

<h1> Überschrift Ebene 1 </h1>

<h3> Überschrift Ebene 3 </h3>

Man beachte, dass auf ein <h1> - das eine Überschrift eröffnet IMMER auch ein </h1> folgen muss, dass die Überschrift wieder beendet.
Vergisst man das </h1> (mit dem Schrägstrich drin), so wird der gesamte folgende Text als Überschrift angezeigt. Das ist so HTML-Regel.

Trennlinien (horizontal)

Eine lange horizontale Trennline erzeugt man am einfachsten mit dem HTML-Befehl: <hr>
Hierbei gibt es kein 'Ende' , es existiert also KEIN </hr> !


Strichaufzählungen

Eine Strichaufzählung wird mit diesen Elementen unterstützt: <ul> </ul> (ul: unsorted lsit)
Dies sind die HTML Token für eine 'unsortierte Liste'. Jedes Element einer solchen Liste als solches gekennzeichnet: <li> ... </li> (li: list item). Eine Liste mit den Worten "eins zwei drei" sieht dann wiefolgt aus:

<ul>      
  <li> eins </li>
  <li> zwei </li>
  <li> drei </li>
</ul>      

Tabellen

Das Erzeugen von Tabellen ist wesentlich aufwendiger, als alle anderen HTML-Befehle. Es können auch geschachtelte Tabellen in einer Tabelle erzeugt werden, was aber nur noch komplizierter ist. Die Erzeugung von Tabellen ist NUR mit dem Makro-Rekorder sinnvoll.

Beispiel für eine Tabelle:

<table>     Beginnt eine Tabelle
  <tr>   Beginnt eine Zeile (tr = Table Row)
    <td> Beginnt die erste Spalte
    Text1 Text, der ein der ersten Spalte angezeigt wird
    </td> Ende der ersten Spalte
    <td> Beginnt die zweite Spalte
    Text2 Tetx, der in der zweiten Spalte angezeigt wird
    </td> Ende der zweiten Spalte
  </tr>   Ende der ersten Zeile
  <tr>   Beginn der zweiten Zeile
    <td> ..
    Text Da hier nur eine Spalte verwendet wird, geht diese über die ganze Breite der Tabelle !
    <td> ..
  </tr>   Ende der zweiten Zeile
</table>     Ende der Tabelle
       

Zeichenformatierung

Es gibt unzählige Anweisungen um Texte verschiedenartig erscheinen zu lassen. Font (Zeichensatz), Größe, Farbe, Hintergrund... HTML hat sehr viele Optionen. Wir raten von exzessivem Gebrauch ab. Oftmals können andere Zeichensätze auf anderen Computern (trotz gleicher Softwareaustattung) nicht richtig dargestellt werden. Sie sollten sich mit den grundsätzlichen Möglichkeiten begnügen: Kursive Schrift, Fette Schrift, Unterstreichungen, Überschriften in sechs verschiedenen Arten. Hier die zugehörigen HTML-Befehle:

Kursiv <em> Kursiver Schrift </em> Kursive Schrift
Fett <b> Fette Schrift (bold) </b> Fette Schrift
Unterstrichen <u> Unterstrichene Schrift </u> Unterstrichene Schrift
Überschrift Ebene 1 <h1> Überschrift Ebene 1 </h1>

Überschrift 1

Überschrift Ebene 6 <h6> Überschrift Ebene 6 </h6>
Überschrift 6
Fett (alternativ) <strong> Fette Schrift </strong> Fette Schrift

Seitenwechsel

HTML kennt keinen Seitenbegriff. Wann immer eine Seite zu lang wird, muss auf dem Bildschirm gescrollt werden. Leider ist auch keine standardisierte Methode verfügbar, wann beim Ausdruck Blattvorschübe gemacht werden. Wenn Sie saubere Einzelseiten benötigen, so beginnen Sie bitte jeweils ein neues Dokument (einen neuen Report).

Manche korrekten Treiber und Werkzeuge beginnen bei <h1> Überschrift 1 </h1> automatisch eine neue Seite. Dies ist aber nur selten gewährleistet!

Die Funktion Datei->Seitenwechsel erstellt eine leere Datei 02.htm (03.htm, 04.htm...) im selben Report Verzeichnis. Damit ist es möglich, in einem Makro auch einige Dutzend Seiten automatisch zu erstellen, ohne dass diese unerträglich lang werden. Diese Funktion setzt den Bilderzähler NICHT zurück. Derzeit ist NICHT vorgesehen, auf vorherige Seiten zurück zu schalten - oder einen ganzen Stabel von solchen HTML-Seiten zu drucken. Daher ist diese Funktion nur für Hardcore Makro-Programmierer empfehlenswert.


Bilder nebeneinander anordnen

Werden zwei Bilder direkt nacheinander in den Report übernommen, so werden diese üblicherweise nebeneinander dargestellt - soweit die Seite - bzw. der Bildschirm - reicht. Ansonsten wird empfohlen, eine Tabelle zu erstellen, die soviele Spalten enthält, wie Bilder nebeneinander dargestellt werden sollen.


Weitergehende Formatierung

Man kann sich sehr viel und sehr breit mit HTML auseinander setzen. Im Endeffekt wird es nur immer komplizierter. Wenn Sie nicht gerade eben 1000 Seiten vom selben Typ herstellen müssen, so empfehlen wir DRINGEND, alle notwendigen Bilder und Daten "einfach so" in den Report zu übernehmen - und diesen danach mit WinWord oder einem guten HTML-Editor weiter zu bearbeiten. Es kann ausgesprochen UFERLOS sein, solche Details selbst programmieren zu wollen.


Der Report-Generator und der Makro-Recorder

Fast alle Befehle des Report-Generators können vom Makro-Recorder aufgezeichnet und schnell wieder abgespielt werden. Damit ist auch das Erstellen von hunderten von Seiten kein Problem ! Nur die Standard-Verzeichnisse können nicht im Makro geändert werden.
Neuere IRIS-Versionen sollten im XAMP (Example - Beispiel) Verzeichnis auch Report-Makros enthalten, die demonstrieren, wie man Tabellen aus Messwerten in einen Report bringt, oder wie man Bilder in Tabellenform darstellen kann.

!!! Vorsicht !!!

IRIS bringt keine Warnungen, wenn ein Report mit einem existierenden Namen durch den Makro-Rekorder Ablauf erstellt wird!
Wir gehen davon aus, dass bei automatischen Abläufen keine Warnung zum Überschreiben von Dutzenden von Dateien erwünscht sind.

Besonderheiten beim Makro-Ablauf

Der Befehl ---> Report - New (standard) <--- erstellt immer einen Report mit dem Namen 'standard'.
Wenn Sie den Namen während des Ablaufs des Makros von Hand eingeben wollen, so benutzen Sie den Stern '*' als Namen in Makro:
---> Report - New (*) <--- . Der Makro stoppt dann und sie können den Namen von Hand eingeben.

Ebenso können Sie beim Befehl ---> Report aus Vorlage (name,c:\iris\reports\standard\1.htm) <--- statt des vordefinierten Namens auch einen Stern verwenden. Auch dann können Sie den Namen des Reports während des Makro Ablaufs frei definieren.


Das Löschen und Verwalten von Reports

PicWin-IRIS stellt keine Werkzeuge für das Löschen und/oder Verwalten von Reports zur Verfügung. Bitte löschen Sie die Reports mit dem Windows-Explorer indem sie einfach das gesamte Verzeichnis entfernen, in dem sich ein Report befindet.

Zur Verwaltung von Reports bieten sich aufgrund der universellen HTML-Struktur ein Unzahl von Werkzeugen der Freeware oder Shareware Szene an. Sobald wir selbst Erfahrungswerte mit solchen Werkzeugen haben, geben wir hierzu gerne Tips.


Ende