ModPar-Funktionen - Das Listen- und Exportcenter (LEC)

Version 2.67

Funktion

Das Listen- und Export-Center (LEC) dient der übersichtlichen Verwaltung und Nutzung von Export- und Listenfunktionen.

Dazu werden die jeweils zu einer Export- oder Listenerstellungsaufgabe gehörenden Einstellungen und Parameter zu Parametersätzen zusammengefasst und so gespeichert, dass sie sich jederzeit unter dem beim Speichern vergebenen Namen wieder aufrufen lassen.
 

Voraussetzungen

• a99 ab Version 28
• Javascript im Internet-Explorer erlaubt

Anpassungen für den Betrieb des LEC

• in _endflex.flx sollte die Zeile
  janas 0
  stehen, damit das Janas-Fenster beim Beenden von a99 nicht offen bleibt.
• vorzugsweise werden nur Parameterdateien angeboten, die eine pn=...- Zeile enthalten,
    in der die Kennung (LEC) gefunden wird. Beispiel: pn=formatierte Liste (LEC)

Bedienung

Die Bedienung ist mit Hilfe der Janas-Oberfläche des a99 realisiert.
 

Start:	X mp-lec [parametersatzname] [/all]
	parametersatzname	Name der Parametersatz-Datei ohne Extension
	/all	wenn angegeben, werden alle Parameterdateien in den Auswahllisten angeboten - auch die ohne (LEC)-Kennung (s.a. Anpassungen für den Betrieb des LEC)

Bedienelemente des LEC-Hauptdialogs

Parametersatz	Auswahlliste für vorgefertigte Einstellungen
Datenquelle	Als Grundlage für den Export kann eine vorhandene Ergebnismenge dienen. Wird Volltext markiert, dient als Quelle die gesamte Datenbank, die dann nach nach dem im nebenstehenden Feld eingetragen Suchbegriff durchsucht wird. Die Syntax des Suchbegriff folgt den in h ftr dokumentierten Regeln. Markiert man Find-Befehl, so wird der im nebenstehenden Feld angegebene Begriff als solcher interpretiert. Dessen Ergebnis dient dann als Datenquelle.
Sortierparameter	Zur Sortierung der Datensätze können spezielle Sortierparameter herangezogen werden. Diese Parameterdateien erzeugen zu jedem Datensatz zusätzlich einen Sortierkopf, nach dem dann sortiert wird.
Ausgabe-Parameter	Diese Parameterdateien bestimmen das Aussehen der Liste bzw. das Format der erzeugten Datei
Ausgabe in	Hier gibt man den Dateinamen an, unter dem das Exportergebnis oder die Liste abgelegt werden soll.     Ein Pfad kann in der Form C:/pfad/filename.ext angegeben werden, wobei evtl. eingegebene \ automatisch in / umgewandelt werden.     Fehlt eine Pfadangabe, so wird die Datei im Startverzeichnis abgelegt.
Anzeige/ Weiterbearbeitung	Mit Hilfe dieser Einstellungen kann man bestimmen, was nach dem Ende des Exports mit dem Ergebnis geschehen soll: 'keine' wählt man, wenn nichts weiter getan werden soll 'durch System' bewirkt die Übergabe des Programm an den Explorer, der dann ein passendes (nach der Dateinamenserweiterung bzw. Extension) Programm startet. 'durch Programm' markiert man, wenn man das zu startende Programm selbst angeben will. In das darunter befindliche Feld gibt man dann den Namen bzr. die volle Pfadangabe des zu startenden Programms ein.
[speichern]	Mit Hilfe dieser Schaltfläche lassen sich gewählte Einstellungen als Parametersatz speichern.
[löschen]	Der ausgewählte Parametersatz läßt sich damit löschen.
[Abbruch]	beendet den LEC-Dialog
[Start]	startet die Ausführung des Exports

  

Bedienelemente des Speichern-Dialogs

Parametersatz-Dateiname	Name der Datei, unter dem der Parametersatz gespeichert werden soll (ohne Erweiterung und ohne Pfadangabe)
Parametersatz-Abstract	Einzeilige Kurzbeschreibung zum Parametersatz, unter der der Satz in der Auswahl aufgelistet wird
Parametersatz-Beschreibung	Ausführliche Hinweise zum Parametersatz (Besonderheiten, Zweck, Randbedingungen usw.)

Alle weiteren Felder werden nur zur Information angezeigt und sind nicht beschreib- oder änderbar.

zugehörige Dateien

mp-lec.rtf      diese Beschreibung
mp-lec.flx      start des Listen-Centers
mp-lec.htpl     Template zur Bedienoberfläche
mp-lexec.flx    wird durch Janas zur Ausführung der gewählten Aktion gestartet
mp-lsave.flx    Funktion zum Sichern der Parametersätze
mp-lsave.htpl   Template für Speichern-Dialog
*.lec           Listendefinitions-Dateien (Parametersatz)
(listhead.rtf)  wird im Programmverzeichnis erwartet
mp_janas.flb    Funktionsbibliothek mit Janas-Funktionen
aneg.flb        allgemeine Funktionsbibliothek
e-grund.apr     wird für Grunddatei-Ausgabe vorausgesetzt

Die Format- und Sortierparameter werden aus dem Programm- und dem Datenbankverzeichnis gelesen.

s-*.?pr         Sortierparameter
p-*.?pr/e-*.?pr Ausgabeparameter

Aus historichen Gründen gibt es im Allegro-Verezichnis eine Reihe von Parameterdateien mit verschiedenen Dateinamen, aber gleicher pn-Zeile. Sinnvollerweise sollte man diese Dateien so korrigieren, dass sie in den Auswahllisten unterschieden werden können.

Format der Parametersatz-Definitionsdatei

Bedeutung der Variablen in der Parametersatz-Definitionsdatei:

str        - Zeichenkette (allgemein)
filename   - Datei-Name ohne Pfad
FSP        - Dateiname mit Pfad

Die Spalte Zeile gibt an, in welcher Zeile der lec-Datei der Parameter stehen muß.
--------------------------------------------------------------------------------------
Name            Zeile Typ        janas  Bedeutung
--------------------------------------------------------------------------------------
$lec_Header     1     str        -      (klartextbezeichnung);(version)
                                         z.B.: Neuerwerbungsliste;1.00
$lec_Descr      2     str        #uPD    Klartext-Beschreibung der Listendefinition
$lec_Source           str        #uSR    res     akt. Ergebnismenge soll verwendet
                                                 werden
                                         srch    Suchbegriff soll für Volltextsuchever-
                                                 wendet werden
                                         find    Suchbegriff ist find-Befehl
$lec_SortFile         filename   #uSs    Name der Sortierparameterdatei
$lec_FormatFile       filename   #uSf    Name der Format-Parameter
$lec_Search           str        #uFC    Suchausdruck (RegEx) oder find-Befehl
$lec_DestFile         FSP        #uFN    Filespezifikation für Zieldatei   
$lec_Execute          str        #uRS    none    keine Behandlung des Exportergebnisses
                                         Sys     Exportergebnis wird an System
                                                 übergeben
                                         Prog    Ergebnis wird durch Programm weiter-
                                                 verarbeitet
                               
$lec_Program          FSP        #uRP    FSP der ausführbahren Datei, an die das
                                         Exportergebnis übergeben wird (wenn $lec_
                                         Execute = Prog)
--------------------------------------------------------------------------------------