Kapitelübersicht
4 Parameter
4.1 Parameterzuordnung
4.2 Parameternamen
4.3 Parameter mit Eigenschaften versehen
4.4 Parameterart
4.5 Parameterregel
4.6 Parameter zum Ausfuehrungszeitpunkt aktualisieren
4 Parameter
Kapitelübersicht
Inhaltsverzeichnis
Stichwortverzeichnis
Durch die Parametrisierung einer Anforderung kann diese
fuer verschiedene Fragestellungen geoeffnet werden.
Vor dem Ausfuehren muss dann in einer Promt-Maske gesagt
werden, wie die Statistik konkret aussehen soll:
Das Resultat ist eine Statistik, die dieser
aktuellen Vorgabe entspricht:
4.1 Parameterzuordnung
Kapitelübersicht
Inhaltsverzeichnis
Stichwortverzeichnis
Parameter koennen ueberall dort eingebunden werden,
wo das zu ersetzende Element in einer Auswertung
verwendet wird. Der Parametername beginnt stets mit '&&':
--------------------------
Anstelle eines SCHLUESSELS:
--------------------------
PFAD: SCHLUESSEL --> Position rechts bei 'Ausgewaehlt' markieren
--> PARAMETER
Hier steht der Parameter &&Z_SCHL anstelle eines frei waehlbaren
Zeilenschluessels:
---------------------------------
Anstelle eines SCHLUESSELINHALTES:
---------------------------------
PFAD: ausgewaehlten Schluessel im Bearbeiten-Blatt markieren
--> INHALTE
--> ZUSATZAUSWAHL
--> Name des Paramters bei DIREKTEINGABE eintragen
Hier steht der Parameter &&GEBIET anstelle eines frei waehlbaren
Gebietes:
---------------------
Anstelle eines WERTES:
---------------------
PFAD: WERTE --> ZUSATZAUSWAHL
--> Name des Paramters bei DIREKTEINGABE eintragen
Beispiel:
Nach dem OK in dieser Maske steht der Parameter &&WERT
anstelle des dritten Wertes.
Er ist frei waehlbar und wird neben 'Neubeitrag' und
'Neuanzahl' berechnet:
-------------------------
Anstelle eines ZEITRAUMES:
-------------------------
PFAD: ZEITRAEUME --> DIREKTEINGABE
--> Name des Paramters bei DIREKTEINGABE eintragen
Hier steht der Parameter &&ZE anstelle eines frei waehlbaren
Zeitpunktes oder Zeitintervalls:
Der Ausfuehrende muss dann in der Promptmaske
die Zuordnung der Parameterinhalte festlegen.
Er bestimmt so das Aussehen der Statistik:
4.2 Parameternamen
Kapitelübersicht
Inhaltsverzeichnis
Stichwortverzeichnis
Parameternamen beginnen immer mit &&, gefolgt von
einem maximal 8-stelligen Namen. Sie koennen mittels
Direkteingabe anstelle eines Schluessels, einer
Auspraegung, einer Schluesselgruppierung, eines Wertes,
einer Zeitangabe etc. angefordert werden.
Ausnahme: Zeitraumparameter max. 4-stellig (z.B.: &&ZE ,
-------- &&BM )
4.3 Parameter mit Eigenschaften versehen
Kapitelübersicht
Inhaltsverzeichnis
Stichwortverzeichnis
Ueber die Schaltflaeche 'Parameter' verzweigt man
aus dem Blatt Bearbeiten zum Parameter-Blatt.
Hier werden die angeforderten Parameter mit
den noetigen Eigenschaften versehen:
Dazu gibt es folgende Schaltflaechen:
UEBERNEHMEN: Die eingegebenen Aenderungen werden auf syntaktische und
semantische Richtigkeit und auf Vollstaendigkeit geprueft.
ZURUECKSETZEN: Die eingegebenen Aenderungen werden verworfen und der
vorhandene uebernommene Stand wieder eingelesen.
AUSWAEHLEN: Fuer die markierte Zelle erscheint in Abhaengigkeit vom
Feldtyp und ggf. von der Parameterart ein Auswahl-Dialog.
TITEL: Hier kann der Titeltext der Promptmaske festgelegt und
kommentiert werden.
FILTER: Hier wird kann ein Filter fuer die Anzeige der
Auspraegungen beim Auswaehlen eingegeben. Dies betrifft
nur die Parameterart 'AU' und das Feld 'PARINHALT'.
ASS-Excel sucht beim Aktivieren des Parameterblattes in
der bisher erstellten Anforderung nach bereits
eingetragenen Parametern und macht dann entsprechende
Voreinstellungen.
Beim Einstellen eines Parameters (z.B. beim Schluesselinhalt)
wird erwartet, dass der Benutzer mit einer vorgeschalteten
Auswahllistbox ausfuehren will. Alle Voreinstellungen
koennen frei ueberschrieben oder durch Doppelklick auf
die betreffende Zelle belegt werden.
Es gibt folgende Eingabefelder fuer Parameter:
- PROMPTKENNZEICHEN
Ueber dieses Feld wird festgelgt, ob die Parametermaske
vor der Ausfuehrung der Anforderung oder der
Startanforderung einer Anwendung immer eingeblendet wird
( 'J' ), oder nicht ( 'N' ).
- TEXT IN PROMPTMASKE (PARTEXT)
In diesem Feld kann ein Hinweis eingegeben werden, der
beim Aufruf der Parametermaske zu diesem Parameter
angezeigt wird.
- NAME DES PARAMETERS (PARNAME)
Der Name des Parameters, unter dem der Parameter in der
Anforderung angesprochen wird. Dieser hat die Form
'&&Name' , wobei Name ein maximal 8-stelliger Bezeichner
ist.
- INHALT ALS VORBELEGUNG (PARINHALT)
In diesem Feld wird die Vorbesetzung der Parameter
festgelegt. Die Festlegung kann durch Direkteingabe oder
ueber die Schaltflaeche 'Auswaehlen' erfolgen.
Bei Schluesseln mit sehr vielen Auspraegungen kann mittels
der Schaltflaeche 'Filter' ein Filter fuer die Anzeige der
Auspraegungen ueber die Schaltflaeche 'Auswaehlen' vorgegeben
werden.
Die zulaessigen Eingaben haengen von der Parameterart ab.
Allgemein gilt, dass solche Eingaben akzeptiert werden,
die auch als direkte Angabe (einer Schluesselbezeichnung,
Auspraegung, Zeitangabe oder Wertebezeichnung) in einer
Anforderung zulaessig sind.
ASS-Excel unterscheidet bei Parametern zwischen
einer Standardeinstellung fuer Parameterinhalte im
Parameterblatt und einem Ausfuehrmodus.
Damit ueberschreiben die Einstellungen in der Promptmaske
die des Parameterblattes n i c h t.
Durch diese Entkoppelung kann das Erscheinungsbild der
der Statistik getestet werden.
- PARAMETER-ART (PARART)
Das Feld beschreibt, welches Element durch einen
Parameter ersetzt werden kann
(vgl. folgendes Kapitel).
- PARAMETER-REGEL (PARREGEL)
Mit diesem Feld wird festgelegt, wie der Parameter in
der Parametermaske aktualisiert werden kann. Die Regeln
haengen von der Art ab (vgl. folgendes Kapitel).
- SCHLUESSELNUMMER (KENR)
ggf. Schluesselnummer fuer die Arten 'AU', 'GR', 'SA', 'SM'
- SCHLUESSELBEZEICHNUNG (KEBEZ)
Schluesselbezeichnung des Schluessels in 'KENR'. Dieser wird
automatisch gepflegt, falls KENR vorgegeben.
- FILTER FUER INHALTE (PARFILTER)
Hier kann der Name eines Parameterfilters eingegeben
werden. Ein Parameterfilter schraenkt die in der
Promptmaske zur Auswahl stehenden Elemente in Listboxen
ein.
Parameter-Filter werden in der Bibliotheksart Q
abgespeichert. Sie koennen aus der Bibliotheksuebersicht erstellt
und bearbeitet werden (vgl. ONLINE-HILFE).
Besonderheiten bei Filtern fuer Schluesselauspraegungen:
Elemente der Bibliotheksart Q koennen ebenso wie Anforderungen
kommentiert werden. Bei Filtern fuer Schluesselauspraegungen
(Parart = AU, Parregel = AU, OG, AB oder OB),
die im Kommentar den Text FILTER_AUFLOESEN enthalten, werden
die zulaessigen Schluesselauspraegungen nicht in der Reihenfolge
der Schluessel-Datenbank angezeigt, sondern in der Reihenfolge,
wie es im Filter vorgegeben ist.
Hierbei werden maximal 500 Elemente angezeigt. Ein Weiterblaettern
ist nicht moeglich. Diese Filter sollten daher so definiert werden,
dass die maximale Treffermenge den Wert von 500 nicht uebersteigt.
Eintraege im Filter, die mit '<<' beginnen, werden als ST31-
Gruppierungen betrachtet, die anderen als Schluesselauspraegungen.
4.4 Parameterart
Kapitelübersicht
Inhaltsverzeichnis
Stichwortverzeichnis
Moegliche Angaben sind:
- Zeitpunkt (ZE)
Ersetzen einer Zeitangabe. Der Parameter darf jedoch
nicht mit einem Zeitintervall besetzt werden. Diese
Angabe ist sinnvoll, wenn Bestandswerte angefordert sind
oder der Parameter den Bezugsmonat bestimmt. Es ist nur
moeglich, Zeitpunkte auszuwaehlen, fuer die in das
Arbeitsgebiet eingespeichert wurde.
- Zeitintervall (ZI)
Ersetzen einer Zeitangabe. Es duerfen auch Zeitintervalle
angegeben werden. Wie bei ZE ist es nur moeglich,
Zeitintervalle auszuwaehlen, die im Einspeicherungsintervall
liegen.
- Zeitpunkt mit Tag (TE)
Ersetzen einer Zeitangabe auf Tagesbasis. Ein Tag muss
dabei angegeben werden. Zeitintervalle sind nicht zulaeessig.
- Zeitintervall mit Tag (TI)
Ersetzen einer Zeitangabe auf Tagesbasis. Ein Tag muss
dabei angegeben werden. Zeitintervalle sind zulaeessig.
- Auspraegung (AU)
Der Parameter kann anstelle einer Schluesselauspraegung
oder einer Auspraegungsmenge, die auf der
Anforderungsdatenbank als Gruppierung abgelegt wurde,
verwendet werden.
- Auspraegung ohne Maskierung (AO)
Diese Regel funtioniert wie AU. Allerdings sind hier
Maskierierungen (! oder ?) als Parameterinhalt unzulaessig.
- Schluesselbezeichnung (KY)
Der Parameter kann anstelle einer Schluesselbezeichnung
verwendet werden.
- Wert (WE)
Der Parameter kann anstelle einer Wertebezeichnung
verwendet werden.
- Arbeitsgebiet (AG)
Der Parameter kann anstelle eines Arbetsgebiets
verwendet werden.
- Gruppierung (GR)
Auswahl einer Schluesselgruppierung ueber diesen
Parameter.
- Wertegruppierungen (WG)
Die Variable kann fuer eine Wertegruppierung stehen.
- Verketteter Schluessel (RE)
Wird in der Anforderung eine Schluesselrelation
angesprochen und soll diese mit einem Parameter besetzt
werden, so ist folgendermassen vorzugehen:
Fuer jeden Schluessel, der ueber die Relation verkettet
wird, wird ein eigener Parameter vergeben. Diese
Parameter muessen in der Reihenfolge, in der die
zugehoerigen Schluessel in der Relation stehen, direkt
hintereinander definiert werden. Sie erhalten alle die
Art RE.
Beim ersten Parameter muss die Regel DI, bei den anderen
die Regel SP angegeben werden.
Beim Aktualisieren der Parameter ueber die Parametermaske
kann dann der Begriff zusammenhaengend bearbeitet werden.
- Neutral (NE)
Hier koennen dem Parameter beliebige Angaben zugeordnet
werden. Die Angaben werden nicht geprueft. Diese Art ist
fuer spezielle Faelle vorgesehen, wie Einblendungen in
Ueberschriften oder Parameter, die vom ASS-Systembetreuer
eingestellt werden (z.B. Bezugsmonat).
- Schluesselmenge (SA)
Der angegebene Schluessel ist der erste Schluessel einer
Schluesselmenge.
- Schluesselmenge (SM)
Der angegebene Schluessel ist Bestandteil der
Schluesselmenge, deren erster Schluessel unter der Art SA
angegeben wurde.
- Rechnen mit Zeiten (Monat: NM)
Rechnen mit Parametern, deren Inhalte in einem von
mehreren Zeitformaten vorliegen. Die Rechenoperation
bezieht sich auf die Monate.
- Rechnen mit Zeiten (Jahr: NJ)
Rechnen mit Parametern, deren Inhalte in einem von
mehreren Zeitformaten vorliegen. Die Rechenoperation
bezieht sich auf die Jahre.
- Rechnen mit Zeiten (Tag: NT)
Rechnen mit Parametern, deren Inhalte in einem von
mehreren Zeitformaten vorliegen. Die Rechenoperation
bezieht sich auf die Tage.
- Teilstring (SU)
Der Parameter wird fuer die Bildung eines Teilstrings(Substrings)
verwendet. Als Inhalt ist anzugeben:
SUBSTR (Inhalt, Start, Laenge) oder SU (Inhalt, Start, Laenge)
Inhalt ist dabei der Name eines anderen, vorher definierten
Parameters.
- Feldbezeichner (FB)
kann in Join-Anforderungen anstelle eines Feldbezeichners
(Kopf-/Zeilenschluessel in Praesentation) angegeben werden.
- Spaltenbezeichner (SB)
kann in Join-Anforderungen anstelle eines Spaltenbezeichners
(Schluessel in Praesentation) angegeben werden.
Spaltenbezeichner (SB)
kann in Join-Anforderungen anstelle eines Spaltenbezeichners
(Wert in Praesentation) angegeben werden.
- Relation (AR)
kann anstelle eines Inhaltes einer Schluesselrelation angegeben
werden.
- Relation ohne Maskierungen (AP)
wie AP, aber Maskierungen sind als Parameterinhalte unzulaessig.
4.5 Parameterregel
Kapitelübersicht
Inhaltsverzeichnis
Stichwortverzeichnis
Moegliche Angaben sind:
- direkt (DI)
Der Parameter kann nur direkt eingegeben in der
Parametermaske ueberschrieben werden.
- Auswahl (AU)
Diese Regel gilt nur fuer die Art AU. Sie erlaubt es, den
Parameterinhalt direkt zu ueberschreiben oder eine
Auspraegung in der Listbox zu markieren.
- ohne Gruppierungen (OG)
Diese Regel gilt fuer die Art AU. Auch hier kann der Parameter-
inhalt direkt ueberschrieben werden oder durch Markierung in
der Listbox besetzt werden.
Hier sind keine Gruppierungen oder Maskierungen als Inhalte
zulaessig, nur Einzelauspraegungen.
- umgekehrt sortiert (OR)
Auch diese Regel gilt nur fuer die Art AU. Die moeglichen
Parameterinhalte werden in der Listbox in umgekehrter Reihenfolge
angeboten. Auch hier sind keine Gruppierungen als Inhalte
zulaessig.
- Auspraegungs-Auswahl, Suche nach Bezeichnung (AB)
Diese Regel gilt nur fuer die Art AU. Sie entspricht der Regel
AU. Wenn beim Ausfuehren der Anforderung in der Parameter-
Maske ein Auswahl-Button erscheint ist im folgenden Dialog
'Suche nach Bezeichnung' anstelle von 'Suche nach Inhalt'
voreingestellt.
- ohne Gruppierungen, Suche nach Bezeichnung (OB)
wie 'AB', ohne Auswahl von Gruppierungen.
- umgekehrt sortiert (OI)
derzeit wie 'OR'.
- Auswahl (SA)
Diese Regel ist nur fuer die Art KY gueltig. Sie erlaubt
neben der Direkteingabe auch die Auswahl eines
Schluessels durch Markierung in der Listbox.
- Auswahl (WE)
Diese Regel ist nur fuer die Art WE gueltig. Sie erlaubt
neben der Direktangabe auch die Auswahl eines Wertes
durch Markierung in der Listbox.
- Gruppierungs-Auswahl (GR)
Die Regel gilt nur fuer die Art GR. Sie ist ausserdem die
einzige, die fuer die Art GR zulaessig ist, falls der Parameter
fuer einen normalen Schluessel (keine Relation) definiert ist.
Der Parameter kann nur durch Markierung in der Listbox besetzt
werden.
- Gruppierungs-Auswahl (Relation) (RE)
Die Regel gilt nur fuer die Art GR. Sie ist anzugeben, wenn der
Parameter in einer Schluesselrelation definiert wurde. Der Parameter
kann nur durch Markierung in der Listbox besetzt werden.
- Auswahl (WG)
Diese Regel gilt nur fuer Art WG. Sie erlaubt es, die
Variable direkt zu ueberschreiben. Ausserdem ist es
moeglich, eine Gruppierung durch Markierung in der Listbox
auszuwaehlen.
- Auswahl (AG)
Diese Regel ist nur fuer die Art AG gueltig. Sie erlaubt
neben der Direktangabe auch die Auswahl eines Arbeitsgebiets
durch Markierung in der Listbox.
- Auswahl (FB)
Diese Regel ist nur fuer die Art FB gueltig. Sie erlaubt
neben der Direktangabe auch die Auswahl eines Feldbezeichners
durch Markierung in der Listbox.
- Auswahl (SB)
Diese Regel ist nur fuer die Art SB gueltig. Sie erlaubt
neben der Direktangabe auch die Auswahl eines Spaltenbezeichners
durch Markierung in der Listbox.
- gesperrt (SP)
Der Parameter ist fuer Ueberschreibungen gesperrt, er kann
also in der Parametermaske nicht individuell besetzt
werden. Diese Regel ist fuer Parameter gedacht, die fuer
alle Anwender identisch sein sollen, aber nur vom
Systemverwalter geaendert werden duerfen.
Desweiteren ist es denkbar, dass der Parameter in einer
Anwendung ueber Drill-Down besetzt wird und nicht ueber
die Parametermaske aktualisiert werden soll.
- gesperrt lokal (SL)
Parameter mit Regel SL verhalten sich lokal, d.h. sie werden z.B.
in Anwendungen nicht durch Parameterauswahl vorhergehender
Anforderungen ueberschrieben.
- gesperrt userabhaengig (SU)
- gesperrt userabhaengig mit Voreinstellung (SD)
Fuer die Parameterarten SA, SM, NM, NJ, NT, SU muss die Regel SP
gewaehlt werden, wie auch aus folgender Tabelle
hervorgeht:
I REGEL
ART I SP DI AU KY GR RE SA WE WG FB SB AG OG OR AB OB OI SL SU SD
-----------------------------------------------------------------
AU I x x x x x x x x x x x x
AR I x x x x x x x x x x x x
AO I x x x x x x x x x x x x
AP I x x x x x x x x x x x x
GR I x x
KY I x x x x x x
RE I x x x x x
SA I x x x x
SM I x x x x
WE I x x x x x x
WG I x x x x x x
ZE I x x x x x
ZI I x x x x x
TE I x x x x x
TI I x x x x x
NM I x x x x x
NJ I x x x x x
NT I x x x x x
FB I x x x x x x
SB I x x x x x x
AG I x x x x x x
NE I x x x x x
SU I x x x x
4.6 Parameter zum Ausfuehrungszeitpunkt aktualisieren
Kapitelübersicht
Inhaltsverzeichnis
Stichwortverzeichnis
Zum Zeitpunkt der Ausfuehrung einer Anforderung koennen
die Parameter in einer eigenen Maske aktualisiert
werden, falls das Promptkennzeichen auf 'J' gesetzt
wurde
(vgl. Kap.4.1, Feld Promptkennzeichen):
Die Maske ist in ihrer Groesse und ihrem Erscheinungsbild
dynamisch. Je nach Parameterregel wird pro Parameter
eine reine Ausgabeinformation, ein einfaches
Eingabefeld, ein Auswahlfeld (DropDown) oder ein
kombiniertes Eingabe/Auswahlfeld angeboten.
Es gibt eine Besonderheit im Erscheinungsbild der Maske,
die kontextabhaengig auftreten kann. Im Bild ist dies am
Beispiel 'Agentur' zu sehen:
Wenn Schluesselinhaltsparameter verwendet werden, so
kann, aehnlich wie bei der Schluesselinhalts- oder
Bedingungsmaske, der Fall eintreten, dass ein Schluessel
mit sehr vielen Auspraegungen gewaehlt wurde. Bei einer
Anforderung mit sehr vielen Parametern ist es
unwahrscheinlich, dass die Voreinstellung wesentlich
uebersteuert werden soll. Um zu vermeiden, dass Tausende
von Saetzen uebertragen werden muessen, von denen man nicht
weiss, ob der Anwender sie ueberhaupt ansprechen will,
wird in einem solchen Fall die Voreinstellung fuer diesen
Parameter in ein einfaches Eingabefeld eingestellt.
Derzeit liegt die Grenze fuer die Anzahl von Inhalten,
die noch uebertragen werden, als Standard bei 100, ist aber
installationsabhaengig.
Um dennoch eine Auswahl zu ermoeglichen, ist die
Schaltflaeche 'Auswahl' in diese Zeile integriert, mit der
zusaetzliche Inhalte bei Bedarf eingelesen werden koennen.
Nach deren Betaetigung werden Filterkriterien analog zur
Schluesselinhaltsauswahl erfragt.
Da die Grenze von 500 Elementen je Listfeld (installationsabh.)
besteht, ist bei Massenschluesseln eine Filterung
unumgaenglich, um alle Elemente zu sehen.
Durch das Betaetigen der Schaltflaeche wird aus dem
Bearbeitungsfeld ein DropDown-Feld, mit der Moeglichkeit
der Direkteingabe.
Installationsabhaengig kann durch Einstellen einer
Bibliothek in der Listbox Speichern die
Parametereinstellung weggesichert werden.
Falls die Anforderung mehr als 30 Parameter besitzt, erscheinen
unten Pfeiltasten, mit denen geblaettert werden kann.
Vorheriges Kapitel: 3 Formeln
Nächstes Kapitel: 5 Formvorgabe