Einschub: So dankbar ich für FrameScript bin, so gerne nutze ich für bestimmte Aufgaben auch »echte« C-Plug-ins mit FrameMaker, insbesondere mit strukturierten Dokumenten. Zum Beispiel AXCM, InsetPlus, FrameSLT…

Bei diesen Schulungen fällt immer wieder auf, dass FrameScript keine Deklaration der Variablen erfordert, man kann einfach schreiben

Set lvValues = MyFunction{};

und die Variable lvValues wird den Datentyp des Ergebnisses der Funktion MyFunction annehmen. Was einerseits sehr praktisch zu sein scheint, führt aber beim kleinsten Tippfehler im Namen einer Variable oft nicht zu einem gemeldeten Fehler, sondern schlicht zu unerwartetem Verhalten des Skripts. Tipps ich ein paar Zeilen weiter beispielsweise

Display lvValue;

bekomme ich diese wenig aussagekräftige Anzeige, weil ich das Plural-s beim Variablenbezeichner »vergessen« habe.

Es gibt aber eine Möglichkeit, solche Fehler melden zu lassen, und ich möchte heute dazu aufrufen, diese Möglichkeit sehr diszipliniert zu verwenden. Seit einigen Versionen gibt es die Session-Variable DeclareVarMode, die dazu verwendet werden kann, dass alle Variablen explizit entweder als Local oder als GlobalVar deklariert werden müssen. Folgende zwei Zeilen gehören in jedes Skript:

Set DeclareVarMode = True;
Set PlatformEncodingMode = True;

(Wegen der Rückwärtskompatibilität sind beide nicht standardmäßig gesetzt; den PlatformEncodingMode können Sie ignorieren, wenn Sie für FrameMaker 8 oder später im UTF-8-Mode programmieren.)

Und dann natürlich in jede Funktion oder Subroutine die entsprechenden Anweisungen Local oder GlobalVar.

Haben Sie das bereits ausprobiert? Wie sind Ihre Erfahrungen? Wie lange haben Sie schon nach Fehlern gesucht, nur um schließlich feststellen zu müssen, dass Sie sich bei einem Variablen-Bezeichner vertippt haben…

Vor zwölf Jahren, im November 1997, wurde die erste Version des FrameMaker-Plug-ins FrameScript vorgestellt. Wegen einer Vorbelegung dieses Namens durch eine deutsche Firma (historische Infos dazu auf framescript.eu) hieß das Produkt hierzulande ElmScript — man wollte jedwedem Streit aus dem Wege gehen.

Vor knapp zehn Jahren, im Januar 2000, beschaffte ich meine erste ElmScript-Lizenz.

Diese beiden Daten bilden den Rahmen, um in Absprache mit FML alle Anwender, die noch ältere Versionen von FrameScript einsetzen, auf den aktuellen Stand zu bringen. Bis zum 30.11.2009 sparen Sie dabei pro Lizenz €30!

Die wichtigsten Vorteile der Version 5:

• Unterstützung von FrameMaker 8 und 9, d.h. insbesondere der Unicode-Fähigkeiten
• Dokumente beim Öffnen oder Speichern von XML-Dateien modifizieren
• Verbesserte Performance durch optimierten Skript-Parser (V.4)
• Debugger zum Testen Ihrer Skripte Zeile für Zeile (V.4)
• Gestaltung eigener Dialoge (V.4)
• Neu gegliederte Dokumentation
• Beispielskripte für neue Funktionen

Informationen zum Bestellprozess und die Sonderpreise finden Sie unter

• Service > FrameScript

Hier finden Sie meine Vortragsfolien mit aktiven Links, die ganze Präsentation können Sie über die Adobe eSeminar-Webseite (nach einer Registrierung) nochmals ansehen.

• Vortragsfolien mit Links
• Adobe eSeminare »Recordings«

Ein schönes Wochenende!

Jetzt liegt es an den Anwendern, das Update zu laden und untereinander die besten Tipps zum effizienten Ausnutzen der raren Lochkarten zu tauschen.

• http://de.wikipedia.org/wiki/Lochkarte

Auf der Liste der relevanten Neuerungen der aktuellen Beta-Version stehen:

• Unterstützung des Unicode-Modus in FrameMaker 8
• Die Methoden eSys.GetDefFontEncoding und eSys.SetDefFontEncoding unterstützen den Typ UTF-8 (neben FrameRoman, JISX0208.ShiftJIS [oder Japanese], BIG5 [oder TradChinese], GB2312-80.EUC [oder SimpChinese], KSC5601-1992 [oder Korean]); die Einstellung ist global für die aktuelle FrameMaker-Session
• Die Methode eStr.ConvertText erlaubt die Konvertierung von Strings aus dem aktuellen Default Encoding in verschiedene Kodierungen: ASCII, ANSI, FrameRoman, UTF8, und noch etliche mehr
• Lesen und Schreiben von Textdateien in UTF-8-Kodierung

Bei der Installation wird auch im Windows-Verzeichnis ein Programm RunEslBatch.exe installiert. Dieser Speicherort erlaubt Ihnen den Aufruf von beliebiger Stelle aus. Der kann z.B. so aussehen:

runeslbatch -f"BatchTest.fsl" -a"TEST 1" -a"TEST 2"

Wenn Sie dann im aktuellen Verzeichnis zum Beispiel das folgende Skript haben, werden Ihnen die übergebenen Parameter angezeigt. Das Skript zeigt die zwei möglichen Arten des Zugriffs auf die Parameter:

• das globale Array Args
• die globalen Variablen Arg1, Arg2, usw.

Dies ist eine gute Gelegenheit darauf hinzuweisen, selbstdefinierte Variable immer mit v, lv, gv oder ähnlichen Buchstaben beginnen zu lassen, um keinen Namenskonflikt zu bekommen. Und ganz nebenbei lernen Sie die Funktion Evaluate{} kennen…

//BatchTest.fsl
Set lvString = '';
Loop LoopVar(lvX) InitVal(1) Incr(1) 
        While(lvX <= Args.Count)
    Set lvString = lvString + 'Args[' + lvX + ']: ' 
        + Args[lvX] + CharLF;
EndLoop
Display 'Args[n]:' + CharLF + lvString;

Set lvString = '';
Loop LoopVar(lvX) InitVal(1) Incr(1) 
        While(lvX <= Args.Count)
    Set lvString = lvString + 'Arg' + lvX + ': ' 
        + eUtl.Evaluate{'Arg'+lvX} + CharLF;
EndLoop
Display 'ArgN:' + CharLF + lvString;

Und jetzt steht Ihren weiteren Fortschritten bei der Automation noch weniger im Weg!

Tutorial »Frame-Doktor«

Zusammenfassung der Fragen und Antworten:

• Tastenkombinationen
  • Cursor in nächste Tabelle: Nein, per Skript
  • Dokumentfenster max/minimieren: Nein, per Skript, s. Beispiel:
    If (ActiveDoc.IsIconified)
  Set ActiveDoc.IsIconified = False;
Else
  Set ActiveDoc.IsIconified = True;
EndIf
  • Zoomen:
    englisches UI: Esc z i, Esc z o, Esc z 0
    deutsches UI: Esc Z G, Esc Z K, Esc Z O
    mit Toolbar Plus: ^F2, ^F3, ^F1
  • Wechseln zwischen Dokument und Katalog:
    in Dokument: Shift+F7
    in Kataloge: geht nicht, aber besser Formatauswahl mit F9 (¶) und F8(ƒ)
• Font-Warnung bei Druckerwechsel vermeiden?
  Ursache sind die unterschiedlichen Fonts, die dem Betriebssystem vom jeweiligen Druckertreiber zusätzlich zu den tatsächlich installierten Fonts gemeldet werden. Um das Problem zu umgehen, könnte man die fehlenden Fonts real installieren oder diese dem Druckertreiber Adobe PDF als quasi-vorhanden beibringen; letzteres wäre gemogelt und erfordert eine Modifikation der PPD-Datei im Windows-Verzeichnis, ist also nur die letzte Wahl.
• Bedingungsfarben selektiv anzeigen?
  Das geht nicht direkt, es ist aber möglich die Darstellungsfarben der Textbedingungen per Skript oder mittels entsprechender Musterdokumente (Datei > Importieren > Formate, Textbedingungen) anzupassen.
• Per FrameScript den DPI-Wert »Unknown« auslesen?
  Wenn eine Grafik per Maus skaliert wurde, setzt FrameMaker die Eigenschaft .InsetFixedSize auf true bzw. 1.
• Konvertierungs-Tool für Onlinehilfe?
  Für strukturierte Dokumente empfehle ich das Speichern als XML mit einer anschließenden XSL-Transformationen.
  Bei unstrukturierten Dokumente würde ich zunächst Mif2Go evaluieren, für FrameMaker 8 auch RoboHelp 7 (dazu wird es noch weitere Infos von mir geben), Webworks ePublisher ist für etliche Anwender aufgrund der Preis- und Lizenzpolitik keine Alternative mehr.
• Ein Wingdings-Symbol in einem Querverweisformat ist nach einer Buchaktualisierung nicht korrekt formatiert?
  Dies ist ein Bug. Der Workaround besteht darin, nach der Buchaktualisierung alle Dokumente nochmals zu öffnen (Shift-Taste + Menü Datei > Alle Dateien öffnen), denn dann wird das Symbol richtig aktualisiert.
• Lfd. Kopfzeile mit Überschrift aus vorangegangener Datei füllen?
  Dies ist leider nur mit Workarounds möglich (Marken, unsichtbare Absätze).
• Logik des Ein/Ausblendens von bedingtem Text bei FrameMaker 8?
  Dazu gibt es einen eigenen Beitrag, generell arbeiten Sie nicht mit Angabe der gewünschten Bedingungen sondern mit Angabe der nicht gewünschten Texte; die Formulierung lautet dann
  NOT "…" ANDNOT "…"
  Dokumente dazu finden Sie auch bei http://www.adobe.com/devnet/framemaker/.
• Langer Kolumnentitel verdrängt Text?
  Wenn sich zwei separate Informationen in der Kopfzeile nicht gegenseitig verdrängen sollen, dann kann es helfen, die Kopfzeile als unsichtbare Tabelle aufzubauen.

Zum Schluss wies ich nochmal auf meine RSS-Feeds auf dieser Website und auf der neuen Website http://www.fminit.eu/ mit Informationen zu FrameMaker-Erweiterungen hin.

Vortragsbewertung

INF132: Frame-Doktor – Expertenlösungen für Ihre Probleme

Teilnehmerzahl: 14, abgegebene Bewertungen: 12, Gesamtnote: 1,58

• Shop

Update:

Den neuen Registrierungsprozess kann man mit Fug und Recht als Rückschritt betrachten, vor allem – aber nicht nur – für Firmen mit mehreren Lizenzen. Ich habe das intensiv gegenüber FML kommuniziert (schön formuliert, gell?) und habe die starke Hoffnung, dass über Änderungen zumindest nachgedacht wird. Klare Aussagen fehlen noch.

Aber zunächst noch ein paar gute Nachrichten:

• Wer FrameScript nach dem 1.8.2007 gekauft hat, bekommt die Lizenz für Version auf Anfrage kostenlos!
• Bis zum 30.9.2007 gelten zusätzlich 10% günstigere Preise für neue Lizenzen und Upgrades, um den Umstieg so attraktiv wie möglich zu machen

Jetzt aber zu den Neuigkeiten:

• ElmStudio Script Editor in einer eigenständig nutzbaren Version mit ScriptBuilder Funktionalität
• Unterstützung für Structured Import/Export (das ging bisher nur per C-Plug-in)
• XML-Parser zur Interpretation von externen XML-Daten (EExPatXml Object).
• Konfigurierbarer Text-Parser (ETextParser Object)
• Neue Bausteine für eigene Dialoge: Tab Control, Grid Control, Images (standard icons, Exclamation, Question, Error, Information)
• Neue Datentypen: DataList, DataRecord
• Verbesserte Funktionen für Arrays
• Neue Hilfsfunktionen (eUtl.GetPropertyValue, SetPropertyValue und FormatString)
• Neue globale Variablen: ThisProc, TextItemNameList, NotificationNameList, CharPropChangeNameList
• Ein neuer Registrier-Prozess, der nicht mehr auf die FrameMaker-Lizenznummer angewiesen ist

Nur zur Erinnerung, die wichtigsten Neuigkeiten der Version 4 waren ein völlig überarbeiteter Skript-Parser (schnellere Interpretation) und der Debug-Modus (schnellere Skriptentwicklung).