Gütigkeitsbereich
Beschreibung
VAR
Mithilfe von VAR können
zusammengesetzte Inhalte oder Formeln für das SQL-Statement vordefiniert
werden.
VAR Name A.AdressName+', '+A.AdressVorname
FIELD Nummer,S.KundNummer,I4,8
FIELD Name,Name,char,20
SQL select :FIELDS from
Kundenstamm s join Anschriftstamm a on
a.adressid=s.adressidhauptadr
Das SQL wird erweitert
auf:
Select S.KUNDNUMMER,A.AdressName+', '+A.AdressVorname NAME, from Kundenstamm s join Anschriftstamm a on a.adressid=s.adressidhauptadr
FIELD
Beschreibung einer Spalte. Die ersten vier Parameter müssen immer in einer festen Reihenfolge angegeben werden:
1) Spaltenüberschrift. Die Überschrift kann sich in der AW 2.0 über mehrere Zeilen erstrecken. Um das zu erreichen, fügt man mit <br> einen Zeilenumbruch ein.
2) Datenbankfeld. Der Name muss eindeutig sein.
3) Feldtyp
4) Breite der Spalte in Zeichen. Für die F3-Auswahl 2.0 gibt diese Zahl die maximale Breite an, in der die Spalte dargestellt wird, da hier die Breite der Spalte aus dem Feldinhalt errechnet wird.
…
FIELD Name,name,char,20
FIELD Typ,KundTyp,FS KundTyp,10
FIELD Matchcode,MA,char,15
FIELD
Kunden-<br>bezeichnung,Kundbezeich,char,30
…
Zusätzlich existieren noch weitere Parameter, die wiederrum über ein Schlüsselwort verfügen. Sie können in beliebiger Kombination verwendet werden.
|
|
| ||||
|
GROUP= |
Siehe Anwendungsregister/Gruppierung
| ||||
|
SUM= oder |
|||||
|
SUMFORMAT= | |||||
|
COLOR= |
|||||
|
BGCOLOR= | |||||
|
FGCOLOR= | |||||
|
STYLE= | |||||
|
HIDDEN |
Spalte wird zwar angelegt
jedoch nicht angezeigt. Sie kann über den Gestaltungsdialog
jederzeit eingeblendet werden. | ||||
|
NOINFO |
Diese Spalte wird nicht im Infofenster dargestellt.
| ||||
|
ROWS= |
Innerhalb des Infofensters kann eine Spalte in mehreren Zeilen angezeigt werden. Hinter Rows gibt man die maximale Anzahl Zeilen an.
| ||||
|
MULTILINE=
oder |
Die Auswahlliste 2.0 kann Daten über mehrere Zeilen darstellen. Gibt man ein Gleichheitszeichen gefolgt von einer Zahl an, so werden maximal so viele Zeilen dargestellt.
| ||||
|
EXTENDEDFILTER |
Nur Auswahlliste 2.0. Siehe Feldauswahl der Auswahlliste
| ||||
|
Nur Auswahlliste 2.0 und F3-Auswahl 2.0. Siehe auch Feldauswahl der Auswahlliste Diese Option konkurriert mit
EXTENDEDFILTER und wird dann nicht ausgewertet. Man kann hier
angeben, wie die Filterzeile suchen soll. Möglicher Werte
sind: •gleich •ungleich •kleiner •kleiner oder gleich •größer als •größer oder gleich •beginnt mit •beginnt nicht mit •endet mit •endet nicht mit •enthält •enthält nicht
Die Werte können mit oder ohne Leerzeichen angegeben werden, also „endet nicht mit“ oder „endetnichtmit“. Groß- und Kleinschreibung muss nicht beachtet werden. Beispiel:
FIELD Bezeichnung,sachkontbez,char,53,FILTERCOMPARISION=BeginntMit
| |||||
|
TIPTEXT= |
Hinter diesem Schlüsselwort folgt ein beschreibender Text zu dieser Spalte. Enthält der Text ein Komma, so muss der Text in Anführungszeichen stehen. Der Text erscheint, wenn man mit dem Mauszeiger über die entsprechende Spalte geht.
| ||||
|
TITEL=
oder |
Hinter dem Gleichheitszeichen folgt der Name einer Datenbankprozedur. Mit dieser Prozedur kann der Titel dynamisch angepasst werden. Diese Datenbankprozedur hat einen Parameter (char 255) in dem der originale Titel geliefert wird. Sie soll eine Überschrift liefern, die dann verwendet wird. Liefert die Funktion als Rückgabewert „-DONOTSHOW-“, dann wird die Spalte ausgeblendet. Dieses Beispiel sorgt dafür, dass die entsprechenden Spalten ausgeblendet werden, wenn keine Daten nach Handelsrecht geführt werden. create function "admin"."anka_ueberschrift"( in in_alt char(255) ) returns char(255) begin declare dc_Ergebnis char(255); Set dc_Ergebnis=(select FIRST(AnKaNachSteuerrecht) from anlagenkartei where AnKaNachSteuerrecht=1 order by ankainventarNummer ); if dc_Ergebnis is NULL then set dc_Ergebnis ='-DONOTSHOW-'; else set dc_ergebnis = in_alt; endif; return dc_Ergebnis; end;
| ||||
|
MINWIDTH= |
Nur für die F3-Auswahl 2.0.
. FIELD
Bezeichnung,AnkaGrupBezeich,char,40,MINWIDTH=30
| ||||
|
XML= |
| ||||
|
JVARS(owner,Feldname)
oder
JAVARS_OWNER_FELDNAME |
Nur Auswahlliste 2.0. Ist hinter einer FIELD – Zeile
dieses Schlüsselwort angegeben, so wird immer dann, wenn genau ein
Datensatz markiert ist, der Wert aus der Datentabelle in die JVar
mit dem angegebenen Owner und Feldnamen geschrieben. Diese JVars
werden nicht automatisch gelöscht.
FIELD Konto,KontoNummer,I4,10,
JVARS(10001,Kontonummer)
oder
FIELD Konto,KontoNummer,I4,10,
JVARS_10001_Kontonummer)
|
SQL
Enthält das SQL-Statement, welches die darzustellenden Daten liefert.
SQL select :FIELDS
from AnKaGruppe
where
(1=1
:AUSW_ANKAGRUPPE
order by AnKaGrupNummer
FIELDS fast alle mit FIELD und VAR
angegebenen Spalten zusammen (siehe oben).
AUSW_ANKAGRUPPE ist der für
die F2-Bereichsauswahl verwendete Variablenname.
IDENT
AW
Eine Liste von bis zu vier Feldern, die dazu dienen, eine Datenzeile eindeutig zu identifizieren.
IDSQL
AW
Ein SQL-Statement, mit dem der in der Auswahlliste markierte Datensatz eindeutig identifiziert wird. Innerhalb dieses Statements kann auf die hinter IDENT stehenden Felder über die Platzhalter ID1, ID2, ID3 und ID4 zugegriffen werden.
…
IDENT s.KundId
IDSQL select *
from KUNDENSTAMM s
where s.kundid =
:ID1
…
RETURN
Eine Liste von Feldern, die an das Programm zurückgeliefert werden sollen.
FIXCOL
Legt die Anzahl der Spalten fest, die beim horizontalen Scrollen nicht bewegt werden, also immer Links in der Datentabelle stehen bleiben. In der Auswahlliste 2.0 lässt sich durch den kleinen Pin in der Titelzeile jede Spalte fixieren. Diese Einstellung wird beim erneuten Aufruf der Variante wieder verwendet.
Dem Schlüsselwort OPTIONS folgen ein oder mehreren durch Komma getrennte weitere Schlüsselwörter.
|
|
Bereich |
Bedeutung |
|
ONEONLY oder
|
AW |
Es kann immer nur eine Zeile zurzeit in der Auswahlliste markiert werden.
|
|
NOPOINT |
|
Der NULL-Wert wird nicht durch einen Punkt dargestellt, sondern die Zelle bleibt einfach leer. Die Darstellung des NULL-Wertes wird in der Auswahlliste 2.0 über das Darstellungsregister festgelegt.
|
|
NOSORT |
AW |
Die Funktion zum Sortieren einer Auswahlliste durch Klicken in die Kopfzeile einer Spalte wird nicht ausgeführt. Es kann also keine Individuelle Sortierung vorgenommen werden
|
|
VONBIS2DBVAR |
AW |
Die Werte, die in der
Bereichsauswal angegeben wurden, werden in Datenbankvariablen
hinterlegt. Die Namen lauten db_von_1, db_bis_1, usw. Diese Werte
sollten nur sparsam verwendet werden, da sie jeweils von der
nächsten Anwendung wieder überschrieben werden. |
|
NOSTAPEL |
AW |
Die Stapelfunktionalität steht für diese Variante nicht zur Verfügung.
|
|
STAPELMODUS |
AW 2.0 |
Die Variante ist immer im Stapel-Bearbeitungsmodus. Im StapelModus muss ein Feld STAPEL_ID aus der Tabelle STAPEL_CONTENT in der Fieldanweisung existieren, es kann auch auf HIDDEN gestellt sein.
FIELD Stapel ID,stapel_id,I4,10,HIDDEN
Beispiel siehe Vorgangstapel (Direksprung [VRS])
|
|
INFOBOX |
IB |
Statt die F3-Auswahl bei Auswahl einer Zeile zu schließen, wird die F3 Funktion, die in der Optionbox eingerichtet ist, ausgelöst.
|
|
INSERT |
IB |
Bewirkt, dass das Ergebnis dem Feld, auf dem die F3-Auswahl aufgerufen wurde, hinzugefügt wird (also das Feld nicht überschrieben wird) und das Feld nicht verlassen wird.
|
|
NOTAB |
IB |
Das Feld, zu dem man aus der F3-Auswahl zurückkehrt, wird nicht verlassen.
|
|
OLDSTYLE |
IB |
Diese F3-Auswahl wird immer im alten Design dargestellt, unabhängig von den Einstellungen im Bedienerstamm.
|
|
NEWSTYLE
|
IB |
Wird das Schlüsselwort „NEWSTYLE“ verwendet, so wird die F3-Auswahl im neuen Design (F3-Auswahl 2.0) dargestellt, unabhängig von den Einstellungen im Bedienerstamm.
|
|
OHNEEINSTIEGSVARIANTE |
IB |
Die Prüfung auf dem Feld wird bei gesetzter OPTION OHNEEINSTIEGSVARIANTE mit der von AMIC vorgesehenen Variante durchgeführt. Unabhängig davon wird bei F3 die vom Anwender eingestellte Variante aufgerufen.
|
|
NOITEMWAHL |
IB 2.0 |
Das Eingabefeld für die
Eingrenzung über das SQL-Statement per ITEMWAHL steht nicht zur
Verfügung und kann somit auch nicht mit F2 bzw. Strg+Y eingeblendet
werden. |
|
ALFA oder NUM |
IB |
Wenn man in einem Eingabefeld sowohl nach Nummer als auch nach Text suchen möchte, dann muss man eine F3-Auswahl für die Suche nach Nummer definieren und als ALTER(native) eine weitere F3-Auswahl für die Suche nach einem Text definieren. Die F3-Auswahl für die Suche nach Nummer muss OPTIONS NUM enthalten, die für die Suche nach Text muss OPTIONS ALFA enthalten
|
|
MATCH |
IB |
Für F3-Auswahlen mit dieser Option wird LOOKUP nicht ausgewertet.
|
|
MARKALL |
AW |
Beim Betreten der Variante werden sofort alle Zeilen markiert. Wird in der Auswahlliste 2.0 nicht mehr unterstützt.
|
ALTER
IB
Eine Liste von F3-Auswahlen, die zur Auswahl angeboten werden:
WARNINGFUNTION
AW 2.0
Es ist möglich ein Hintergrundbild einzublenden. Die Funktion wird bei jedem Refresh der Auswahlliste aufgerufen und muss einen Wert vom Typen Integer zurück liefern. Gültige Werte sind:
0 = Kein Hintergrundbild
1 = Information
2 = Warnung
3 = Fehler
Syntax-Beispiel
WARNINGFUNCTION p_namederdatenbankfuntion() //ACHTUNG: Vollständig mit Klammern
oder
WARNINGFUNCTION if db_bedienerid=-1 then 3 else 0 endif
STRIKEOUT
AW 2.0
Man
kann Werte einer Zeile durchgestrichen darstellen. Dazu dient das
Schlüsselwort STRICKEOUT gefolgt von dem Feld, welches angibt, ob das Feld
durchgestrichen ist(Wert = 1) oder nicht(Wert=0)
STRICKEOUT f.dsgvo_loekennz
SAVE
AW
SAVE
gefolgt vom Datenbankfeldname:
SAVE Spaltenname
Der Spaltenname muss ohne Handle angegeben werden und natürlich in der Datenbankabfrage vorhanden sein. Dieses Schlüsselwort bewirkt, dass beim Klicken in eine Zeile der Wert aus dem Feld in die Zwischenablage geschrieben wird und somit anschließend mit Strg+V irgendwo eingefügt werden kann.
XML
AW
Die Farblegende der Auswahlliste
DELPROC
AW
Veraltete Technik um Löschfunktionen für Anwendungen anzubinden.
INFOWINDOW
AW 1.0
Hiermit kann gesteuert werden, wie das Informationsfenster beim Öffnen der Anwendung reagiert. Mögliche Einstellungen sind:
|
|
Bedeutung |
|
INFOWINDOW AN |
Das Informationsfenster wird sofort aktiv geöffnet |
|
INFOWINDOW AUS |
Dies ist die Standardeinstellung. Das Informationsfenster muss per Funktionsaufruf gestartet werden. |
|
INFOWINDOW NIE |
Die Funktionalität des Informationsfensters steht für diese Variante nicht zur Verfügung. |
Das Informationsfenster wird nur für Anwendungen angeboten, die auf unterster Ebene geöffnet wurden.
DEFAULT
AW 2.0
Im SQL-TEXT für die neue Auswahlliste existiert ein neues Schlüsselwort DEFAULT:
DEFAULT fa_kundnummer=:GETVALUE (IDENT,Kundnummer),fa_belegreferenz=:GETVALUE (IDENT,belegreferenz)
Oder
DEFAULT fa_kundnummer=":GETVALUE (IDENT,Kundnummer)",fa_belegreferenz=":GETVALUE (IDENT,belegreferenz)"
Liefert beides mal dasselbe Ergebnis, die Hochkomma werden entfernt. Hochkamma sind dann notwendig, wenn das, was zurückgeliefert wird, ein Komma enthält. Komma sind ansonsten Trennzeichen:
DEFAULT KundSQL="select kundnummer , Kundbezeich from kundenstamm where Kundid=:GETVALUE(IDENT,KUNDID)"
|
Parameter |
Bedeutung |
|
IDENT |
Wert aus der IDENTLISTE der darunterliegenden Auswahlliste |
|
RETURN |
Wert aus der RETURNLISTE der darunterliegenden Auswahlliste |
|
FELD |
Wert eines Feldes aus der darunterliegenden Maske |
|
SVMAIN |
Ein Wert aus dem letzten SVMAIN-Kontext |
|
CEMAIN |
Ein Wert aus dem letzten CEMAIN-Kontext |
Siehe auch Standardvorbelegung.
ACHTUNG: Da GETVALUE sich auf die vorherige MASKE/Auswahlliste bezieht, ist es hier nicht möglich von der Auswahlliste 2.0 die Funktion F4 (Druck/Quickreport) aufzurufen.
PILEAPP und
PILE_TYP
AW
Es gibt einen Mechanismus zur Stapelbildung von Vorgängen. Auswahllisten mit dem Schlüsselwort PILEAPP signalisieren dem System, dass es sich um eine Auswahllisten mit Vorgangsdaten handelt. Hinter PILEAPP muss der Name der Anwendung folgen, die dann beim Umschalten in die Stapelverarbeitung verwendet werden soll. Innerhalb der PILEAPP-Anwendung muss dann das Schlüsselwort PILE_TYP verwendet werden.
INFO
IB
Die
Bezeichnung der F3-Auswahl, wie sie in der Varianten-Auswahl
erscheint:
INFO nach Bezeichnung
MASK
IB 1.0
Gibt
die verwendete Dialogmaske der F3-Auswahl - und damit die Größe – an.
Dieses Feld ist optional. Mögliche Werte sind ITEM60, ITEM80, ITEM100 und
ITEM200: Ist keiner dieser Werte gesetzt, dann wird ITEM 80
verwendet
MASK ITEM100
TITLE
IB
Titelzeile der F3-Auswahl im alten Design.
TITLE Gesamtverzeichnis Direktsprünge
IB
Gibt
den Text an, der vor dem Eingabefeld steht.
IB_LABEL Bezeichnung wie
BEEP
IB
Mit diesem Schlüsselwort wird festgelegt, dass ein System-Beep gesendet wird, bevor die F3-Auswahl geöffnet wird. Es muss die Frequenz und die Dauer in ms angegeben werden. Fehlt die Angabe der Dauer, so wird ein Ton für die Dauer von 1 Sek ausgegeben.
Die dritten und nachfolgenden Parameter sind eine Liste von JVARS, des Owners 1971 (JVAR_BEEP), die gesetzt sein müssen, damit dieser Beep ausgelöst wird. Fehlt die Angabe gänzlich, wird der Beep in jedem Fall ausgelöst.
BEEP 800, 350, SVPOSBAR2BEEP
OPTIONBOX
IB
Mit diesem Schlüsselwort kann man an die Optionbox der F3-Auswahl eine weitere Optionbox anhängen. In dieser Optionbox können dann z.B. Funktionen für den Aufruf für Stammdatenpfleger oder die Hilfe-Funktion enthalten sein.
OPTIONBOX OB_IB_KOSTENSTELLEN
PARAMS
IB
Die PARAMS-Anweisung dient dazu, vom Programm übermittelte Parameter mit einem Standardwert zu versorgen. Diese werden nur angenommen, wenn die entsprechenden Parameter nicht versorgt worden sind. Dies Standardwerte werden auch verwendet, um die F3-Auswahl zu testen. Wie bei allen Kommandos kann das PARAMS -Statement auch mehrere durch Komma getrennte Parameter enthalten
PARAMS KONTO = 70000,JAHR = 2012, PERI = 12
Im SQL können dann KONTO, JAHR, PERI wie folgt verwendet werden:
…
where a.kontonummer = :KONTO
and c.Jahrnummer = :JAHR
and c.Perinummer =
:PERI
…
LPARAMS
Wie
PARAMS, nur werden LPARAMS in den durch das Schlüsselwort COPY erstellten
SQL-Texten überschrieben.
COPY AW_Preise_VK_Preise
LPARAMS EKVK=EK
ITEMWAHL
IB
ITEMWAHL hat zwei Bedeutungen-
1) Verwendet man ITEMWAHL als Schlüsselwort, so dient es dazu, den Typen der Eingabe genauer zu bestimmen:
|
|
|
|
ALFA |
Standardeinstellung. Es erfolgt keine Prüfung, man kann alles eingeben. |
|
INT |
Nur Integer-Zahlen werden durchgelassen. |
|
REAL |
Nur Floating Zahlen werden durchgelassen. |
|
DAT |
Datumseingaben sind erlaubt.
Gibt man hier etwas an, so wird ein Hinweistext ausgegeben: |
Hinter dem Typen kann durch Komma getrennt ein Vorbelegung eingetragen werden, die Verwendet wird, falls kein Wert an die F3Auswahl übergeben wurde. Wird bei Typ Datum keine Vorbelegung angegeben, so wird das Tagesdatum verwendet um einen SQL-Syntaxfehler zu vermeiden.
2) Verwendet man
ITEMWAHL mit vorangestelltem Doppelpunkt im SQL-Text, dann wird dort vor
dem Ausführen des Statements der Wert aus dem Eingabefeld
eingesetzt
SQL select
SachKontBezeich,KontoNummer, SachKontOPKennz,SachKontSteuKenn,SachKontZinsKenn,SachKontErfSperr,SachKontJWKKennz
from SachKontstamm
where isnull(sachkontloekennz,0)=0 and kontonummer >= ':ITEMWAHL'
ITEM1
ITEM2
IB
Benötigt man zwei Kriterien, um die Suchabfrage einzugrenzen, so kann man im Eingabefeld die Werte durch kommt getrennt eingeben und im SQL-Text dann die Platzhalter ITEM1 und ITEM2 verwenden. Es gelten dieselben Bedeutungen wie für ITEMWAHL.
Im Folgendem Beispiel wird nach der Bezeichnung und dem Vornamen gesucht:
SQL
select :FIELDS
from KundenStamm kus, AnschriftStamm
where (AdressIdHauptAdr = AdressId)
and (KundBezeich like ':ITEM1%')
and (AdressVorname like ':ITEM2%') and (KundLoeKennz = 0)
MUSTENTER nn
IB
Gibt
an, dass mindestens nn Zeichen eingeben werden müssen, bevor das
SQL-Statement ausgeführt wird.
Für die IB 2.0 gilt:
Es kann auch MUSTENTER 0 angegeben werden. Dann startet das Laden der Daten nicht sofort, es muss aber kein .Zeichen eingegeben werden.
Dieses Kennzeichen kann - ohne private Ableitung zu bilden - über die Funktion „Mindesteingabe“ zentral pro F3-Auswahl gesetzt werden. Das ermöglicht es private Ableitungen zu vermeiden.
Vom Entwickler kann mit der Funktion FLD_ITEM_OPTION ein Wert gesetzt werden.
FLD_ITEM_OPTION("IB_Artikel_nu","MUSTENTER 4")
LOOKUP
IB
LOOKUP dient dazu, einen Datensatz eindeutig zu Identifizieren und muss im SQL-Befehl angegeben werden, wenn die F3-Auswahl dazu dient, zu prüfen, ob ein Datensatz existiert.
SQL select kontobezeich kundbezeich, :FIELDS
from kontostamm k
where k.KontoNummer >=':ITEMWAHL'
and ( KontoTyp in (1,2) )
:LOOKUP
order by k.KontoNummer
LOOKUP and k.Kontonummer = ':ITEMWAHL'
Bei der Auflistung wird LOOKUP im SQL weggelassen, bei der Prüfung jedoch eingesetzt. Es ergibt sich dann folgendes Statement wenn als Konto 10000 ausgewählt.wurde:
select kontobezeich kundbezeich, :FIELDS
from kontostamm k
where k.KontoNummer >='10000'
and ( KontoTyp in (1,2) )
and k.Kontonummer = '10000'
order by k.KontoNummer
FIBU_INFO
IB
Spezialität der Konteninformation in der Finanzbuchhaltung.
FORM nnnn
IB
Veraltet. Hier konnte die Formularnummer des Formulars für die Kurzliste hinterlegt werden.
VERIFY
und
VERIFY_INFO
IB
Wenn eine F3-Auswahl eine Ergebnismenge liefert, die ggf. nicht gültig sind, kann hier eine F3-Auswahl angegeben werden, mit deren Hilfe die Gültigkeit noch einmal geprüft werden kann. Durch Komma getrennt gibt man den Feldnamen an, der für ITEMWAHL - also als Eingabe - verwendet werden soll. Das Schlüsselwort VERIFY_INFO enthält den Text, der ausgegeben wird, wenn die Prüfung fehlschlägt.
VERIFY IB_VERIFY_BAUSTELLE_ARTIKEL,ArtikelId
VERIFY_INFO Artikel gehört nicht zur Baustelle
PRESQL und
CTRLSTR
AW
Hier
kann eine JPL-Funktion aufgerufen werden. Diese läuft vor dem
SQL-Statement und kann z.B. dafür verwendet werden, JVARS zu setzen, die
dann im SQL verwendet werden.
PRESQL ^jpl rollenkontext_prepare
CTRLSTR ^jpl del_aw_rwsbearb_temp
FIXEDSIZE
IB 2.0
Die neue F3-Auswahl bestimmt die Spaltenbreite und die Breite des gesamten Fensters anhand der breite der Daten. Ist das nicht gewollt und möchte man die Größe der F3-Auswahl festgelegen, so geschieht dies mit diesem Schlüsselwort. Dabei stehen hinter dem Schlüsselwort die Breite und die Höhe in Pixeln.
FIXEDSIZE 1152,512
Die Größe lässt sich auch Programgesteuert festlegen. Dies geschieht über FLD_ITEM_OPTION und der Syntax ist ein klein wenig anders, da die Breite und Höhe hier in Klammern und ohne Leerzeichen stehen muss.
FLD_ITEM_OPTION(itemBox, "FIXEDSIZE(1152,512)" )
Ist vom Programm eine feste Größe vorgegeben, kann diese in der Itembox mit
FIXEDSIZE 0,0
wieder abgestellt werden.