Online-Bausteinhilfe für Anwenderbausteine in D7-SYS D7-SYS FAQ August 2009 Service & Support Answers for industry.
Fragestellung Dieser Beitrag stammt aus dem Service&Support Portal der Siemens AG, Sector Industry, Industry Automation and Drive Technologies. Es gelten die dort genannten Nutzungsbedingungen (www.siemens.com/nutzungsbedingungen). Durch den folgenden Link gelangen Sie direkt zur Downloadseite dieses Dokuments. http://support.automation.siemens.com/ww/view/de/37003712 Frage Wie können Sie eine Online-Bausteinhilfe für Anwenderbausteine in D7-SYS erstellen? Antwort Folgen Sie zur umfassenden Beantwortung dieser Frage den in diesem Dokument aufgeführten Handlungsanweisungen und Hinweisen. 2 Version 1.0, Beitrags-ID: 37003712
Inhaltsverzeichnis Inhaltsverzeichnis 1 Erstellung der Online-Hilfe... 4 1.1 Anwender-Baustein mit FB-Generator erstellen... 4 1.2 Erzeugung der Online-Bausteinhife mit RoboHelp... 8 2 Erstellen der spezifischen Baustein-Online-Hilfe in Word... 12 2.1 Anlegung der Überschriften... 12 2.2 Darstellung der Texte in der Online-Hilfe... 17 2.3 Einfügen von Bildern in die Online-Hilfe... 19 Version 1.0, Beitrags-ID: 37003712 3
1 Erstellung der Online-Hilfe 1 Erstellung der Online-Hilfe 1.1 Anwender-Baustein mit FB-Generator erstellen Als erstes ist im Funktionsbausteingenerator ein neues Projekt zu erstellen. In diesem Beispiel wird als Projektname Example gewählt. Abbildung 1-1, Funktionsbausteingenerator 4 Version 1.0, Beitrags-ID: 37003712
1 Erstellung der Online-Hilfe Nach der Bestätigung der Eingaben mit OK wird nun ein neues Projekt erstellt. Abbildung 1-2, Projektansicht Nun muss eine neue Bibliothek eingefügt werden. Abbildung 1-3, Bibliothek Version 1.0, Beitrags-ID: 37003712 5
1 Erstellung der Online-Hilfe Als nächsten Schritt wird eine Anwenderbibliothek erstellt. In diesem Beispiel erhält diese Bibliothek den Namen FBAONL. Abbildung 1-4, Erstellung einer Anwender-Bibliothek Nach der Bestätigung der Eingaben mit OK, wird eine neue Anwenderbibliothek erzeugt. Abbildung 1-5, Anwender-Bibliothek erzeugt 6 Version 1.0, Beitrags-ID: 37003712
1 Erstellung der Online-Hilfe Nun wird ein neuer Anwenderbaustein erstellt. In diesem Beispiel wird der Bausteinname FB_ONL gewählt. Abbildung 1-6, Erzeugung eines Anwenderbausteins Nach der Bestätigung der Eingaben mit OK, erzeugt der Bausteingenerator folgendes Ergebnis. Abbildung 1-7, Anwenderbaustein erzeugt Version 1.0, Beitrags-ID: 37003712 7
1 Erstellung der Online-Hilfe 1.2 Erzeugung der Online-Bausteinhife mit RoboHelp Zu Beginn der Erzeugung der Online-Bausteinhilfe muss das Programm RoboHelp for Word gestartet werden. Dieses ist zu finden unter: Start > Programme > RoboHelp Office > RoboHelp for Word. Nun fordert der RoboHelp Explorer zur Eingabe eines neuen Help Project auf. Abbildung 1-8, RoboHelp Explorer Nach Bestätigung des OK Buttons erscheint folgende Maske. Abbildung 1-9, New Project Fenster Im New Project Fenster (Abbildung 1-9) ist die Einstellung WinHelp 2000 zu wählen und das Fenster mit OK zu schließen. 8 Version 1.0, Beitrags-ID: 37003712
1 Erstellung der Online-Hilfe Als nächstes erscheint der New Project Wizard (Abbildung 1-10). Hier müssen einige Eingaben vorgenommen werden. Der Titel der Hilfe-Datei für die Anwenderbibliothek steht in der ersten Eingabezeile. In der zweiten Eingabezeile gibt der Anwender den Namen seines project file an. Dieser entspricht der erstellten Anwenderbibliothek. Der Namenszusatz _x kennzeichnet hierbei die Sprachkennung: a für Deutsch b für Englisch Abbildung 1-10, Wizard In der dritten Eingabezeile kann der Anwender den Ablageort des Projekts einstellen. Version 1.0, Beitrags-ID: 37003712 9
1 Erstellung der Online-Hilfe Nach dem Drücken des Buttons Fertig stellen öffnet sich nun Microsoft Word. Hier kann der Hilfe-Text eingeben und auch Bilder einfügen werden. (siehe Kap.2) Die Generierung der Online-Hilfe in Word erfolgt durch Anklicken des Generate Primary Layout Symbols. Abbildung 1-11, Word Fenster Daraufhin erscheint das folgende RoboHelp Generierfenster. Abbildung 1-12, Generierfenster von RoboHelp Durch Betätigung des View Result -Buttons wird nun die Online-Hilfe erstellt. 10 Version 1.0, Beitrags-ID: 37003712
1 Erstellung der Online-Hilfe Abbildung 1-13, Online-Hilfe für Bibliothek FBAONL Diese Online-Hilfe hat den Namen Online-Hilfe für Bibliothek FBAONL. Dieser Name wurde im New Project Wizard (Abbildung 1-10) vorgegeben. Version 1.0, Beitrags-ID: 37003712 11
2 Erstellen der spezifischen Baustein-Online-Hilfe in Word 2 Erstellen der spezifischen Baustein-Online- Hilfe in Word 2.1 Anlegung der Überschriften Die folgenden Bilder zeigen ein Beispiel zur Erstellung einer Beschreibung für den Anwenderbaustein. Der Name des Anwenderbausteins - in diesem Beispiel FB_ONL - erhält als Formatvorlage die Überschrift 1. Abbildung 2-1, Eingabe der Überschrift 1 12 Version 1.0, Beitrags-ID: 37003712
2 Erstellen der spezifischen Baustein-Online-Hilfe in Word Andere im Text übergeordneten Gliederungspunkte erhalten als Formatvorlage die Überschrift 2. Abbildung 2-2, Eingabe der Überschrift 2 Version 1.0, Beitrags-ID: 37003712 13
2 Erstellen der spezifischen Baustein-Online-Hilfe in Word Mit Betätigung des Ikons New Topic generiert RoboHelp eine neue Überschrift (Topic Title) der Hilfe. Im Falle der Anwenderbausteine muss diese Überschrift mit dem Namen des Anwenderbausteins (FB_ONL) übereinstimmen. Abbildung 2-3, Betätigung von New Topic 14 Version 1.0, Beitrags-ID: 37003712
2 Erstellen der spezifischen Baustein-Online-Hilfe in Word RoboHelp wendet automatisch die Formatvorlage Überschrift 1 für jeden neuen standard topic Titel an. Mit Anwählen des Add To Index - Kästchens fügt RoboHelp den Titel in den Index hinzu. Abbildung 2-4, New Topic Element FB_ONL In der Document Zeile wird das Dokument für dieses Thema (topic) eingetragen. Die Topic ID ist ein eindeutiges Kennzeichen für die soeben erzeugte Überschrift. Im Falle der Anwenderbausteine sind Topic Title und Topic ID identisch. Nach der Eingabe ist dieses Fenster durch die Betätigung des OK Buttons zu schließen. Version 1.0, Beitrags-ID: 37003712 15
2 Erstellen der spezifischen Baustein-Online-Hilfe in Word Abbildung 2-5, Generate Primary Layout Mit dem Anklicken des Generate Primary Layout -Icons übersetzt RoboHelp das Source-File und erstellt die eigentliche Hilfedatei (Endung.hlp). Abbildung 2-6, Erzeugung der Hilfedatei 16 Version 1.0, Beitrags-ID: 37003712
2 Erstellen der spezifischen Baustein-Online-Hilfe in Word Durch die Betätigung des Buttons View Result wird nun die Online-Hilfe generiert. Abbildung 2-7, Online-Hilfe für Bibliothek FBAONL 2.2 Darstellung der Texte in der Online-Hilfe Um das Erscheinungsbild der Online-Hilfe zu verbessern, ist die Verwendung von verschiedenen Schriftfarben möglich. Abbildung 2-8, Schriftfarben Im Menü RoboHelp die Set non-scrolling region auswählen und folgende Einstellung vornehmen: Version 1.0, Beitrags-ID: 37003712 17
2 Erstellen der spezifischen Baustein-Online-Hilfe in Word Abbildung 2-9, Einstellung der non-scrolling Region Diese Angabe bewirkt, dass in der Hilfe-Datei beim Scrollen der Titel am Beginn der Seite immer sichtbar bleibt. 18 Version 1.0, Beitrags-ID: 37003712
2 Erstellen der spezifischen Baustein-Online-Hilfe in Word 2.3 Einfügen von Bildern in die Online-Hilfe Das Einfügen von Bildern in die Online-Hilfe geschieht durch Anwahl des Icons New Help Image. Abbildung 2-10, New Help Image Mit der Betätigung dieses Icons öffnet sich das Insert Help Image (Abbildung 2-11). Hier haben Sie die Möglichkeit ein gewünschtes Bild auszuwählen. Version 1.0, Beitrags-ID: 37003712 19
2 Erstellen der spezifischen Baustein-Online-Hilfe in Word Abbildung 2-11, Insert Help Image Abbildung 2-12, Auswahl eines Bildes Die Auswahl des Bildes mit OK bestätigen. 20 Version 1.0, Beitrags-ID: 37003712
2 Erstellen der spezifischen Baustein-Online-Hilfe in Word Nun mit dem Anklicken des Generate Primary Layout -Icons (siehe Abbildung 2-5) eine neue Übersetzung anstoßen. Daraufhin in dem erscheinenden WinHelp Fenster (Abbildung 2-6) den Button View Result betätigen. Anschließend erscheint die Online-Hilfe, wie sie in der folgenden Abbildung zu sehen ist. Abbildung 2-13, Online-Hilfe für Baustein FB_ONL Nun noch die Hilfedatei fbaonl_b.hlp in das Verzeichnis \sdblocks (in diesem Verzeichnis befindet sich auch die Anwenderbibliothek) kopieren. Version 1.0, Beitrags-ID: 37003712 21