Modulare Parameter für allegro-C - technische Dokumentation - Die dynamischen Menüs

Abschnitt 3.4
Inhaltsverzeichnis
Abschnitt 3.5: Standard-Mechanismen

Die Auswahl der Inhalte für die dynamischen Menüs erfolgt nach:
  • Bestandteilen des Dateinames der FLX-Dateien
  • Art des Aufrufs (Paramter)
  • Merkmalen des gerade angezeigten Datensatzes
  • aktuellen Rechten das angemeldeten Benutzers

Sortiert werden die Menüzeilen nach
  • dem in den FLX-Dateien abgelegten SRT-Parameter
  • nach dem Dateinamen (bei gleichem Sortierparameter)

Die Steuerung der Menüs wird über folgende Dateien realisiert:
  • mp-fkt.flx startet über MP_FuncList() aus MP_FktLst.flb das Menü
  • onerror.flx startet mp-fkt.flx mit dem Inhalt des Schreibfelds, hiermit köönen Flex-Funktionen über die Eingabe eines Kürzels im Schreibfeld aufgerufen werden
  • onkontext.flx startet mit dem über MP_RecordTypGet ermittelten Satztyp-Kürzel mp-fkt.flx zur Anzeige des Menüs
  • onf8.flx startet onkontext.flx (nicht unter alcarta)
  • onhelp.flx realisiert den Aufruf von menüpunktspezifischen Hilfe­dateien

Es werden folgende Szenarien für die Funktionsauswahl unterstützt;
  1.  alle Funktionen, deren Aktivierungsbedingung erfüllt ist, werden angeboten
  2.  alle Funktionen wie 1) werden angeboten, die außerdem im Dateinamen den Teilstring (kürzel) enthalten

Der Inhalt jeder Flexdatei in {DB} wird zeilenweise ausgewertet, bis eine Leerzeile oder die Zeichenkombination @@ auftritt.
Dabei werden alle Zeilen interpretiert, die einen String XXX: enthalten:
 
Menü-Steuertoken in Flex-Dateien
XXX Bedeutung / Syntax
CHR Char-Set, in dem die Beschreibungen und Texte codiert sind. Werte: ansi oder ascii
default: ascii
FKT Zeile enthält die Bezeichnung der Funktion so, wie diese in der angebotenen Auswahl angezeigt werden soll
HELP rtf- oder hml-Datei, wird im Menü über dem jeweiligen Funktionseintrag angezeigt
für Anzeige: rtf-Datei (ohne Endung angeben)
für janas: html-Datei (mit Endung)
Beispiele:
HELP: Name.html
oder
HELP: Name
PAR Parameter, der der Funktions-Flexdatei übergeben werden soll
SRT Wert, nach dem die Einträge der fertigen Liste sortiert werden; Wertebereich: (0 ... 65535)
Fehlt SRT, gilt SRT: 0.
Folgende Bereiche dienen der Gliederung nach Funktionsgruppen (ab MP V3.x, vorher noch nicht so systematisch ;-):
von bis Bereich/Gruppe
0 399 Hilfe
400 499 usr-Hilfen
500 999 Service- (unterstützende Hilfsfunktionen)
600 - 699 Mail
1000 1999 Katalogisierung
2000 2999 Exportfunktionen
2001 Neuerwerbung
2500 Listen
2600 Schriftverkehr
 
3000 3999 Import
4000 4999 Statistiken/Auswertungen
5000 5999 Leihfunktionen (FlexLend)
5200 Mahnfunktionen
5300 Kasse
6000 6999 Bestellfunktionen (FlexOr)
7000 7499 ZS-Verwaltung/Abos
7500 7999 Umlaufverwaltung
8000 8999 Einstellungen
8000 - private Einstellungen
8800 - Web-OPAC
8900 - Zweigstellen
9000 9999 Systemfunktionen
9000 - Systemkonfiguration
9900 - Zweigstellen
10000 10999 Ânwender-Prüffunktionen
11000 11999 System-Prüffunktionen
11950 - Index-Checks
MNU Kontextmenü bedingt unterdrücken
0 - Kontextmenü verbieten, wenn nur eine Auswahl möglich ist
1 - Kontextmenü erzwingen - auch, wenn nur eine Auswahl möglich ist
default: durch globale Variable gesteuert
ACC mindestens erforderlicher Berechtigungs-Level
REQ Bedingungen, die für die Aufnahme der Funktion in die Auswahl erfüllt sein müssen. Eine Bedingung kann wie folgt definiert werden:
[!]{(feld)[$(teilfeld)][(op)(teilstring)]|(if-bedingung)}
(feld) Kategorie oder Variable, z.B: #20, #u11, $xyz
(teilfeld) Teilfeldzeichen
(op) Operator
= - beginnt mit 
% - enthält
(teilstring) Zeichenkette, die in der Kategorie bzw. in deren Teilfeld gesucht werden soll; darf keine Leerzeichen enthalten
(if-bedingung) unterstützt wird als (if-bedingung):
main
New
hasAuf
hasAuf[@({registernummer}|{register})],
hasVol[@({registernummer}|{register})],
fe{dir}={Dateiname}; 
{dir} kann sein: P, D, W oder M, oder
B – Tools-Verzeichnis ({BIN})
F – Flex-Verzeichnis ({FX})
H – Help-Verzeichnis ({HP})
L - Html-Verzeichnis
Beispiel: feB=SendEmail.exe
 
ChkReg@{cstring}
prüft, ob Registereintrag vorhanden ist; {cstring} in Syntax , der mit var in einen Parameter für MP_ChkReg umgewandelt werden kann: Beispiel
ChkReg@#00(e"+") 64 124 "9" 64 "1"
ergibt
{teil-id aus #00}@|9@1
in cstring dürfen nicht vorkommen: [|;=@ \x09\x0d\x0a] (durch codes ersetzen)
EM
Ergebnismenge muss vorhanden sein
 
 
  • Mehrere Bedingungen werden durch ';' (AND) oder '|' (OR) getrennt.
  • Die Funktion wird nur aufgelistet, wenn die definierte(n) Bedingung(en) durch den aktuell geladenen Satz erf³llt ist/sind.
  • Rang der Operatoren (aufsteigend): |;!=%
  • Leerzeichen sind im Ausdruck nicht erlaubt, Klammerungen werden nicht unterstützt.

Beispiele:
#9B muß vorhanden sein und mit 0 oder 1 beginnen: REQ: #9B=0|#9B=1
#9B muß vorhanden sein, darf aber nicht mit 2 beginnen: REQ: #9B;!#9B=2
Im Satz solle #00 und #20 oder #00 und #19 enthalten sein  REQ: #20;#00|#19;#00
Test auf verknüpft gespeicherten Aufsatz ('*' in #00) REQ: #00%*

Einschränkung auf Suchkürzel:
Da ohne (kürzel) alle Flexe aktiviert werden, deren Bedingung erfüllt ist, werden u.U. zu viele Funktionen angeboten.
Damit ein Funktionsflex nur angeboten wird, wenn ein (kürzel) als Parameter angegeben wurde, kann mittels REQ: #uÆp=(kürzel) genauer eingegrenzt werden. (Variablenname #uÆp ist ascii-codiert)

Beispiel:
wahr, wenn als Such(kürzel)  'new' angegeben wurde REQ: #uÆp=new
Mehrere REQ:-Zeilen werden aneinandergehängt. Folge-Zeilen muessen demzufolge mit "|" oder ";" beginnen.
 
   

Kommentare:
Zeilen, die mit "//" beginnen, wirken als Leerzeile und beenden die Auswertung der aktuellen Flexdatei

Besonderheit vor a99, V27.2:


In Anzeigeparametern muss ein Abschnitt #-ì (236 dez) enthalten sein, der die Umwandlung der Var. #uÆp in Kleinschreibung realisiert:

;------- Abschnitt zur Umcodierung, verwendet in MP_FuncList -----------
#-ì
!uÆp y2 dÆp aÆp // Æ = Code 146dez
#+#
 
Artikel zuletzt bearbeitet am: 20.06.2023 16:27
.
© 2024 Anando Eger | Alsenstraße 3 | 01157 Dresden (aneg-srv5)  |  Impressum  |  Datenschutzerklärung