Das Listen- und Export-Center (LEC)

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
- Javasript 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. Fehlt eine Pfadangabe, so wird die Datei im Startverzeichnis abgelegt.

Anzeige/		Mit Hilfe dieser Einstellungen kann man bestimmen, was nach dem Ende 
Weiterbearbeitung	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-Abstrct		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")
--------------------------------------------------------------------------------------

(C) Anando Eger 2008-2010