10 Hilfesystem
Das infra-Hilfesystem besteht aus den Bereichen "Online-Handbuch", "Hilfe für Hilfefunktion" und "infra-Systeminformationen".
Aus den infra-Handbüchern, die mit dem Textsystem Word erstellt werden, wird die Online-Hilfe automatisch generiert. Es entstehen dazu zunächst Dateien im RTF-Format, die mit einem Hilfe-Compiler in die Online-Hilfedateien umgewandelt werden.
Das Layout der Onlinehilfe kann konfiguriert werden. Es gibt zwei Möglichkeiten:
|
HTML
|
Das HTML-Hilfesystem besteht aus den Dateien SIBPPS.CHM und ANWENDER.CHM und ist im Standard konfiguriert (siehe Kapitel "Bemerkungen zu HTML-Hilfesystem“).
|
|
HLP
|
Das Hilfesystem besteht aus HLP- und CNT-Dateien. Der Name der Hilfedatei entspricht dem Kürzel des Anwendungsbereichs (PDV.HLP für Produktionsdatenverwaltung, AUF.HLP für Auftragsabwicklung usw.).
|
Für die kontext-sensitive Hilfe benötigt der Hilfe-Compiler so genannte MAP-Nummern, die den einzelnen Abschnitten (Kapiteln) des Handbuchs zugeordnet werden und die in infra:NET in den HID-Dateien hinterlegt sind. Die Nummern aus den HID-Dateien müssen mit den MAP-Nummern, die beim Erstellen einer HLP-Datei vergeben werden, übereinstimmen. Je nach Tool für die Hilfedateierstellung existiert ein MAP-Editor, mit dem die MAP-Nummern den Kapitelüberschriften zugeordnet werden können.
Für jedes Modul gibt es eine HID-Datei. Zum Beispiel heißt für "111 Teilestamm bearbeiten" die HID-Datei PDV111.HID und für "435 Aufträge bearbeiten" entsprechend "AUF435.HID". Damit die passende Information zu einem Dialog (Bildschirmfenster) erscheint, muss in der HID-Datei für das Modul hinterlegt sein, welche Hilfedateinummer für welches Fenster gelten soll. Informationen über die interne Bezeichnung des Dialogs erhält man über den Modulstatus des jeweiligen Bildschirmfensters im Menü "INFOSYSTEM - SYSTEMÜBERSICHT", Register "Modul/Daten".
Für Listengeneratorprogramme müssen sowohl die LD*.HID als auch die LB*.HID erzeugt werden.
Die HID-Datei ist zeilenweise aufgebaut und besteht aus der Bezeichnung des Dialogs, der Hilfedateinummer, dem Namen der Hilfedatei und einem Kommentar. Die Angaben werden durch Kommata und Leerzeichen voneinander getrennt. Informationen über die Bezeichnung des Dialogs werden bei geöffnetem Dialog über das Fenster INFOSYSTEM - MODULSTATUS (F5) angezeigt. Dort ist eine Bezeichnung im Feld «Dialog» hinterlegt. Die Hilfedateinummer kann frei gewählt werden, sollte aber einen Zusammenhang mit dem Anwendungsbereich haben, damit die Übersichtlichkeit gewahrt bleibt. Es empfiehlt sich, die Nummerierung an die Nummer des Moduls anzulehnen (siehe Beispiel). Die einzelnen Dialoge werden in der Reihenfolge ihres Erscheinens im Handbuch durchnummeriert. Das muss nicht immer mit der Bezeichnung der Dialoge übereinstimmen. Für die maximale Zahl der Hilfedateinummer bzw. MAP-Nummer gibt es keine Beschränkung.
Beispiel:
Auszug aus dem Aufbau der Steuerdateien AUF438.HID ("438 Angebote/Aufträge kopieren"):
AUF438, 438, AUF.HLP, Direkteinstieg in AUF438
AUF438_1, 43801,, Anwahlfenster
AUF438_2, 43802,, Kopierfenster Angebot aus Angebot
AUF438_3, 43803,, Kopierfenster Auftrag aus Angebot
AUF438_4, 43804,, Kopierfenster Angebot aus Auftrag
AUF438_5, 43805,, Kopierfenster Auftrag aus Auftrag
AUF438_6, 43806,, Kopierfenster Gutschrift aus Auftrag
AUF438_7, 43807,, Kopierfenster Auftrag aus Gutschrift
AUF438_8, 43808,, Kopierfenster Gutschrift aus Gutschrift
Die HID-Dateien können mit einem ASCII-Editor bearbeitet werden. Dabei ist zu beachten, dass keine Kommata im Kommentar zulässig sind. Außerdem kann der Name der Hilfedatei ab der zweiten Zeile weggelassen werden. Die Zeilen, die in der Bezeichnung des Dialogs einen Unterstrich haben ("_") gelten nur für diesen Dialog. Zeilen ohne Unterstrich gelten für das gesamte Programm.
Der Anwender kann über die Steuerdateien der i|NES Gmbh auch selbsterstellte Hilfen je Dialog hinterlegen. Anleitungen zur Erstellung von Hilfedateien können der jeweiligen Betriebssystem-Literatur entnommen werden. Zur Auswertung der individuellen Hilfedatei muss als dritter Parameter in der HID-Datei der Dateiname der eigenen Hilfedatei angegeben und mit Komma abgeschlossen werden. Der Kommentar wird dann als vierter Parameter eingetragen. Zum Beispiel bedeutet "PDV111_1, 123, MYHELP, Kommentar": Hilfe kommt aus der Hilfedatei MYHELP.HLP.
Wenn mit dem Oberflächeneditor GRIT für ein Fenster, ein Bedienelement oder ein Eingabefeld eine feste Hilfedatei und/oder Hilfenummer eingetragen wird, so übersteuert diese Angabe den Eintrag in den Steuerdateien von i|NES Gmbh.
Interner Hinweis:
Momentan werden die Meldungsfenster ohne Hilfeschaltflächen ausgegeben. Falls in Zukunft eine solche Schaltfläche aufgenommen wird, kann zu jeder Meldung ein individueller Hilfetext hinterlegt werden. Dazu muss in der Datei SYSTEM.HID abhängig vom Schlüssel der Meldung (siehe "9951 Meldungen bearbeiten") ein Eintrag vorgenommen werden. Als Dialogname muss HLP_Meldungsschlüssel angegeben werden, zum Beispiel "HLP_F435005, 43599", um für die Meldung F435005 (Tabelleneintrag (@) ist 0) nähere Hinweise ausgeben zu können.
