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)
|
Zur Nutzung eines fertigen Parametersatzes kann man diesen also direkt beim Start des LEC angeben, im Beispiel ist liste1 der Name des Parametersatzes:
X mp-lec liste1
Alternativ läßt sich ein vorhandener Parametersatz auch über die Auswahlliste der LEC-Oberfläche einstellen.
Um mal schnell eine Liste oder einen Export zu erstellen, kann man auch alle Einstellungen und Parameterdateien per Hand auswählen und danach über die Schaltfläche [Start] die Ausführung starten.
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 |
Über den mit der Schaltfläche [speichern] aufgerufenen Dialog Listen- und Export-Center: Parameter speichern lassen sich einmal vorgenommene Einstellungen in ihrer Gesamtheit für die spätere Wiederverwendung ablegen:
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
Im Datenbank-Verzeichnis
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.
Namenskonventionen für die Parameter:
s-*.?pr Sortierparameter
p-*.?pr/e-*.?pr Ausgabeparameter
Jeder der Sortier- und Ausgabeparameterdateien müssen, um in die Auswahlliste aufgenommen werden zu können, die pn-Kennzeile besitzen, deren Inhalt in den Auswahllisten angezeigt wird. Die Kennung (LEC) wird für die Anzeige ausgeblendet.
Beispiel:
pn=Bezeichnung der Parameterdatei (LEC)
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
Die Datei besteht aus einer Liste mit $-Variablen in Kleinschreibung (flüchtiger Typ)
Dateiname: *.lec
Bedeutung der Variablen in der Parametersatz-Definitionsdatei:
Bedeutung der Abkürzungen in der Tabelle:
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)
--------------------------------------------------------------------------------------
Artikel zuletzt bearbeitet am: 29.11.2019 09:37