[Allegro] Fortbildung 0-3 : Info zur Datenbank [NEU]

[Bernhard Eversberg]

                                                              02-07-2015
allegro-Fortbildung                                          [NEU}

    0.3  Allgemeines : Info zur Datenbank

Gelegentlich braucht man schnell mal eben gewisse Fakten über die
Datenbank, an der man gerade tätig ist: Wo liegen die Dateien? Wieviele
Daten sind es? Wann war die letzte Änderung, die letzte Sicherungskopie
und wo liegt die? Usw. usf.
Dazu taugt die Hilfsfunktion "Info zu dieser Datenbank", die man im
Füllhorn findet, aber auch im Menü "Global" als letzten Punkt.
Was spielt sich dann ab und was kriegt man raus?

Dann wird ein Hilfetext abgerufen, und zwar "dbi.rtf". Den können Sie,
weil's eben ein Hilfetext ist, auch abrufen mit Eingabe von "h dbi".
Und da steht das alles drin.
"Einspruch!", werden Sie einlegen, "Ein Hilfetext, das ist doch nur
eine Textdatei, die kann doch nicht automatisch genau die Fakten
enthalten, die gerade zu der aktuellen Datenbank passen!?"
Doch, ein allegro-Hilfetext im rtf-Format kann das. Alle Angaben, die
dann in rot erscheinen, die stehen gar nicht fertig drin in der Datei
dbi.rtf, sondern werden eingefügt, wenn a99 diese Datei zwecks Anzeige
einliest. Beim Vorgang des Einlesens merkt a99, daß in der Datei
einige Dinge stecken, die nicht so als Text angezeigt werden sollen,
sondern im Moment des Einlesens ausgewertet. (Die rote Schriftfarbe
ist dafür nicht zwingend, sondern gewisse Steuerbefehle, die mit '%'
beginnen.) Wie so etwas genau geht, steht im Hilfetext über das
Hilfekonzept: h help. Genau sehen können Sie die Steuerbefehle beim
Betrachten der Datei dbi.rtf mit einem Texteditor.

Hier wollen wir mal zeigen und kommentieren, was geboten wird,
wenn wir gerade die aktuelle DemoBank benutzen.

Von oben nach unten sehen wir folgende Angaben :
(beginnend unter der Überschrift)

Admin                       [das steht ganz rechts, zum Anklicken]
          Bei Klick kommt das Menü für den Administrator

Thu, 2. Jul 2015    [bzw. ein anderes Datum]
          Das aktuelle Datum

Prog.Version:  a99 v35.6
          Die Programmversion von a99, die Sie gerade benutzen

Titel der Datenbank:  'allegro'-Demo-Datenbank   [in grün]
          entnommen aus der INI-Datei (DbTitle=...), wenn's aber da
          nicht drinsteht, dann aus den Indexparametern ( |a="..." )

Umfang (Sätze):		951 (davon gültig/ungültig/unbesetzt: 951/0/0)
          Zu den ungültigen gehören die gelöschten und diejenigen,
          die verlängert wurden und nicht mehr aktuell sind.
          Unbesetzte Satznummern gibt es nur nach einer "Bereinigung"
          siehe dazu Org-Menü (h org)

INI-Datei  	c:\allegro\demo2\orda.ini
          Pfad und Name der INI-Datei, mit der a99 gestartet wurde

Zugriff 	9
          Zugriffsberechtigung (Wert access=... in der INI-Datei)

Datenbank	cat
          Name der Index-Parameterdatei (DbName=... in der INI)

Pfad        	c:\allegro\demo2\
          Wohnort der Datenbank. Da liegen alle zugehörigen Dateien

Neue Daten kommen in die Datei  cat_1.ald
          Die .ald-Dateien sind diejenigen, in denen die Datensätze
          stehen. Neue Sätze müssen in eine dieser Dateien. Die
          Nummer hinter "cat_" kann von 1 bis 255 gehen.
          Die 1 gilt, falls nichts in der INI eingetragen ist unter
              InputFileNr=...
          und die Nummer auch nicht per FLEX (set n...) verstellt wurde

LogDatei  c:\allegro\demo2\cat.log
           Ort und Name der Log-Datei

Größe     1164 Bytes
           momentane Größe der LOG-Datei

Letzte Änd.     20150319/12:47:22
           Datum und Uhrzeit der letzten an der Datenbank erfolgten
           Änderung

Sich.Kopie     	c:\back
           Speicherort der letzten Sicherungskopie (mit  h backp )

erstellt am:   20150218/09:04:01
           Wann genau die Kopie gemacht wurde  [NEU in V35.6]

Progr.Ordner    c:\allegro\
           Wo die Programme liegen, u.a. a99

Version:  	v35.6
           Nochmals die Programmversion - doppelt hält besser

Konfiguration  	a (t/k=2/4)	
           Die Datenbank basiert auf $a.cfg  (INI: Konfiguration=...)
           (Wenn's die nicht gibt, dann a.cfg)
           Die Kategorienummern sind 2 Zeichen breit,
           der Feldinhalt beginnt auf Position 4

Anzeigeparam. 	d-wrtf
           (INI: DisplayParameter=...)
           Die Datei d-wrtf.apr wird verwendet, darin steht die
           Vorschrift zur Anzeige von Datensätzen

Druckparam.     p-w
           (INI: PrintParameter=...)
           Die Datei p-w.apr wird verwendet zum Drucken, darin steht
           die Vorschrift für die Druckaufbereitung der Sätze

Exportparam. 	e-w
           (INI: ExportParameter=...)
           Die Datei e-w.apr wird verwendet zum Exportieren, darin steht
           die Vorschrift für die Exportaufbereitung der Sätze

Exportdatei 	orda.adt
                (INI: OutputFile=...)
                 Dahinein kommen die exportierten Daten

Arbeitsordner  	c:\xyz...
                 Der Ordner, der in der Icon-Verknüpfung eingestellt ist
                 unter "Ausführen in:". (Änderbar per FLEX  set W...)
                 Dort werden Export- und andere Ausgabedateien abgelegt

TEMP-Ordner	C:\DOKUME~1\Bernhard\LOKALE~1\Temp\
                 Der Temp-Ordner des Windows-Systems. Wird automatisch
                 auch als Default für den Arbeitsordner eingestellt.
                 in FLEX mit  set W...  änderbar
                 In den kommen Ergebnismengen der aktuellen Sitzung und
                 der Inhalt des Offline-Speichers

Phrasendatei  	demophr.a99
                 Enthält die vom Nutzer verwendeten Phrasen.
                 INI-Datei:  Phrase=...

Text-Editor  	WinVi
                 Der vom Nutzer bevorzugte Texteditor, eingestellt in
                 der INI-Datei mit  Editor=...

User            xyz
                 Der in der INI-Datei mit Operator=... eingestellte Name

Sprache         ger
                 In der INI eingestellt mit  Language=...

Weitere Werte: siehe  FLEX-Variablen
                 Anklicken, dann kommt eine Liste interner Variablen,
                 die der Kenner u.U. mal prüfen will.

Register dieser Datenbank
ALL e1=ALL-Wortregister
PER 1=Personennamen
...
             Liste aller verfügbaren Register

Restriktionen
PYR=Erscheinungsjahr
TYP=DokumentTyp
BDT=Bestelldatum
             Liste der anwendbaren Restriktionen beim Suchen


Hinweis: Den Inhalt und das Layout dieser Anzeige kann man anpassen!
Dazu verändert man nur entsprechend die Textdatei dbi.rtf, die auf
dem Hilfeverzeichnis liegt. Die in rot erscheinenden Variablen
können beliebig anders positioniert oder auch beseitigt werden.
Aber Vorsicht bei Änderungen an solchen Angaben.
ACHTUNG: Editieren nur mit externem Editor, nicht im Anzeigefeld,
sonst klappen danach die eingebauten Variablen nicht mehr.

Geben Sie  h dbi.rtf, dann sehen Sie, wie die Datei von innen aussieht.
Veränderungen erfordern Kenntnisse des RTF-Textformats.
Die Datei ist ein Beispiel dafür, daß in Hilfetexte Variablen
eingebaut werden können und sogar FLEX-Skripte, die beim Laden der
Datei ausgeführt werden, bevor der Text in der Anzeige erscheint.

Übrigens:
Der FLEX dbinfo.flx, mit dem die Datei dbi.rtf normalerweise abgerufen
wird, enthält nur drei Zeilen:

var A
ins #uwA
help dbi

Die ersten zwei belegen die #u-Variable #uwA mit der Berechtigungszahl
der momentanen Sitzung. Die dritte ruft den Text ab. Beim Einlesen
wird a99 dann den Wert aus #uwA an der Stelle einsetzen, wo in der
Datei die Angabe  %#uwA  steht.
Die anderen Werte werden in der Datei mit einem darin verborgenen
FLEX ermittelt und in Variablen eingesetzt, die dann ebenso zum
Vorschein gebracht werden.  (Nur var A  geht nicht in einem FLEX, der
in eine .rtf eingebaut ist.)