infra:NET Expert
 
×
15.03 infra-Globalvariablen
infra-Globalvariablen sind Datenelemente, in denen infra:NET verschiedenste Informationen verwaltet und zum Beispiel zur Ausgabe in Dialogen oder auf infra-Medien (Druckausgabe) zur Verfügung stellt. Eine Globalvariable wird über einen eindeutigen Namen identifiziert. Globalvariablen können zum Beispiel über das infra-Makro "GV" (siehe Kapitel 15.01 infra-Makros) ausgelesen werden. Im Kapitel "Angaben in CGW-Dateien" wird in der Sektion [GuiBuffer] beschrieben, wie über den Schlüssel "GlobVar" eine Verbindung zwischen Dialogelementen (zum Beispiel einem Eingabefeld) und Globalvariablen hergestellt werden kann.
Eine Globalvariable kann fast beliebig viel Inhalt umfassen (bis zu 2.147.483.646 Zeichen/Bytes). Dies gilt sowohl für den Namen der Globalvariablen als auch für den Inhalt.
Die folgenden Globalvariablen sind standardmäßig definiert - jedes infra-Programm kann allerdings weitere (eigene) Globalvariablen definieren, die dann im jeweiligen Steckbrief beschrieben sind. Viele der Variablen dienen internen Verwaltungsfunktionen und sollten nicht verändert werden.
Name
Format
Beschreibung
GV_a04eing
numerisch
Teilt der Drucker-/Medienkonfiguration mit, welcher Dialog gestartet werden soll
1
Druckerauswahl
2
Konfiguration
GV_abbr
numerisch
Zustand für Abbruch
0
kein Abbruch
1
Abbruchanforderung
2
Abbruch
3
Programmende
GV_abfrtab
alpha
32 Zeichen Abfragetabelle (Eingabekürzel) aus KO.DAT
GV_applcaller
numerisch
Application-Handle des rufenden Programms beim Start eines untergeordneten Programms
GV_applcond
alpha
Enthält die Startbedingungen eines Programms aus dem zugehörigen FK-Parameter (Position 111, Länge 5)
GV_appldata
alpha
Aufrufparameter eines Programms aus CBsExecModProc (i.d.R. Menünummer)
GV_applparentobj
void
Objectpointer des grafisch übergeordneten Vaterobjekts eines Programms
GV_applrunmodal
numerisch
Beim Start eines Programms wird das übergeordnete Programm gesperrt - Verwendung durch Multi-Programmwahl (0=modeless / 1=modal)
GV_arbzeit
alpha
Arbeitszeit aus KO.DAT
GV_auskdata
void
Zeiger auf Übergabestruktur für infra:query Aufruf
GV_auskeing
numerisch
Startmodus für infra:query Aufruf (0=alle Auskünfte, 1=Selektionsdialog Default-Query, 2=Ausführen Default-Query, 3=gespeicherte Daten zu Default-Query öffnen
GV_autolabel
numerisch
Automatische Bestimmung der Position des nächsten Etiketts auf dem Etikettenträger (0=nein / 1=ja)
GV_autostart
numerisch
Automatischer Aufruf eines Programms beim Start von infra:NET (0=nein / 1=ja)
GV_awkz
alpha
Währungskennzeichen alternative Währung
GV_bsp
numerisch
Benutze Beispieldaten (0=nein / 1=ja)
GV_bukennz
alpha
Buchungskennzeichen aus KO.DAT
GV_canceldlg
void
Objectpointer auf Abbruchdialog (wenn angezeigt)
GV_cancelstate
numerisch
Zustand des Abbruchdialogs
0
nicht abgebrochen
1
Abbruch bestätigt
GV_computer
alpha
Name des Computers, auf dem infra:NET gerade läuft
GV_database
alpha
Ident des aktuell verwendeten Datenbestands (Datenquelle)
GV_datapath
alpha
Pfad des aktuellen Datenbestands (nur bei klassischer Datenbank). Wird mit aktueller Version nicht mehr versorgt (siehe aber "GV_ddbinpath").
GV_datum
alpha
infra-Arbeitsdatum (Buchungsdatum) in der Form JJMMTT
GV_dbcolor
alpha
Container-Farbe des aktuell verwendeten Datenbestands
GV_DBError
numerisch
Enthält den Fehlercode des letzten DBSelect- oder DBFetchNext-Makros und kann zum Beispiel in einer Drucksteuertabelle (MIL) zur Prüfung des letzten Dateizugriffs verwendet werden.
Enthält auch das Ergebnis der letzten Makro-Datenbankmanipulation mit DBInsert, DBDelete oder DBUpdate (0=“erfolgreich“, ansonsten Fehler laut Kapitel 12.02 Kernsystemfehler)
GV_dbname
alpha
Name des aktuell verwendeten Datenbestands (Datenquelle)
GV_dbsformat
alpha
Zeichensatz der Datenbank aus INI-Datei DBSFormat (ISO/ASC)
GV_ddbinpath
alpha
Enthält Laufwerk und Pfad des aktuell geladenen DataDictionaries (SIBDB.INI). Quelle ist der Eintrag "DataDictionary:" in der Datei SIBDB.INI.
GV_divers
alpha
Diverse Kennbuchstaben aus KO.DAT
GV_eurowkz
alpha
Währungskennzeichen EURO
GV_execparent
numerisch
Application-Handle des Programms, das das aktuelle Programm aufgerufen hat
GV_filindex
alpha
Übergabe des Datei-Index der beim Aufruf des Datenbankstatus anzuzeigenden Dateidefinition
GV_firma
alpha
Firmenbezeichnung, Lizenznehmer
GV_firstlabelnr
numerisch
Nächste Etikettenposition auf Etikettenträger
GV_gjbeginn
alpha
Aktueller Geschäftsjahresbeginn (siehe Einstellung in 935 Konfigurationsparameter AUF und MwSt) mit 4-stelligem Jahrhundert (JJJJMMTT). Falls kein Geschäftsjahr konfiguriert ist, wird der 1.1. des aktuellen Jahres genommen.
GV_guiprofile
alpha
Pfad und Name der GUI-Datei dieser Sitzung
GV_inipath
alpha
Pfad des INI-Verzeichnisses
GV_inisession
alpha
Sitzungsident aus infra-Programmstart für INI-Maschine
GV_languageid
alpha
Sprachkennzeichen aus INI-Datei (default 049)
GV_lcodepath
alpha
Pfad zur infra-Lizenzdatei
GV_loginname
alpha
Benutzerangabe aus Anmeldefenster
GV_loginrequ
numerisch
Login-Dialog beim Start aufrufen (0=nein / 1=ja)
GV_lwkz
alpha
Währungskennzeichen Landeswährung
GV_maindlg
alpha
GRIT-ID des infra-Hauptdialogs (in der Regel SIBPPS_MAIN)
GV_maindlgorg
alpha
GRIT-ID des Dialogs, aus dem das Hauptfenster gepatched wurde
GV_maintitle
alpha
Originalfenstertitel des infra-Hauptdialogs aus CGW
GV_medialist
alpha
Enthält eine stets aktuelle Liste aller verfügbaren Druck-/Ausgabemedien in der Form: medienbezeichnung1 (medienident1)\nmedienbezeichnung2 (medienident2)\n...
GV_megmode
alpha
Enthält den Modus in Stammdatenprogrammen:
1
Modus ändern
2
Modus anzeigen
3
Modus erfassen
4
Modus suchen
Siehe z.B. Abfrage in 251-TAUSCH.IMA
GV_menue
alpha
3stellige Menünummer des aktuellen Programms
GV_mddlanguageid
alpha
Sprachkennzeichen, das den Namen der Sektion bestimmt, in der beim Übersetzen fester Texte bei der Druckausgabe (S-Operator) in der Datei SIBPPS.MSG nach passenden Übersetzungen gesucht wird.
GV_milcapwin
void
Objectpointer des Dialogs, aus dessen Inhalt beim Druck die Selektionen ausgegeben werden sollen
GV_mitprotdialog
alpha
Kann im Drucksystem verwendet werden, um ein Protokollfenster zu identifizieren (siehe Operator C:$PROT oder C:$MA).
Aufbau "CGW,Dialog-ID"
GV_mitprotprompt
alpha
kann einen Text enthalten, der im Drucksystem bei der Protokollausgabe dem Protokolltext vorangestellt wird (siehe Operator C:$PROT oder C:$MA).
GV_modul
alpha
3stelliger Modul-Ident des aktuellen Programms (z.B. AUF)
GV_mostfeld
numerisch
Aktuelle Eingabefeldnummer für Modulstatus
GV_mostmdd
alpha
Aktuelle Drucksteuerdatei (MIL) für Modulstatus
GV_mostpp
numerisch
Aktueller Programmpunkt für Modulstatus
GV_multiscroll
numerisch
Anzahl auszuführender Zeilensprünge in Rolldialog
GV_multithread
numerisch
Multithread-Unterstützung aktivieren (immer 0)
GV_mwi
alpha
MWI-Zeichenkette aus KO.DAT
GV_mwistat1
alpha
MWI-Statis aus KO.DAT
GV_mwistat2
alpha
MWI-Statis aus KO.DAT
GV_MyEMail
alpha
Mail-Adresse des angemeldeten Benutzers aus den Sachbearbeiter-Daten. Kann zum Beispiel bei der Konfiguration von Mail-Accounts für das infraMail-Plugin (Sektion [PLUGIN]) verwendet werden.
GV_names
void
Objectpointer auf SCSysMsg-Object mit Modulbezeichnungen (SIBPPS.NAM)
GV_nroflics
numerisch
Anzahl Lizenzen aus Lizenzdatei
GV_popupdefault
numerisch
Letzte Popup-Menüaktion war eine Default-Aktion (Doppelklick) (0=nein / 1=ja)
GV_popupmenu
void
Zeiger auf die zuletzt erzeugte Popup-Menüstruktur
GV_print
numerisch
Druckzustand (0=Druck inaktiv/1=Druck aktiv)
GV_processexitcode
numerisch
Wird als %errorlevel% an den Kommandoprozessor (Batch) zurückgegeben
GV_prscrbypass
numerisch
Druckausgabefenster unterdrücken (0=nein / 1=ja)
GV_queryreqfunc
alpha
Diese Variable kann von einem Anwendungsprogramm mit dem Namen einer CallBack versorgt werden, über die das Auskunftssystem infra:query Daten über die erlaubten Auskünfte sammeln kann
GV_reportlinkobject
alpha
Enthält den Inhalt (den Text) des zuletzt in einem Dokument angeklickten Objekts (siehe Sektion [REPORTLINKS]). Diese Variable kann benutzt werden, um Informationen aus einem Dokument über eine Verknüpfung an ein anderes Programm weiterzugeben.
GV_reportlinkobjid
numerisch
Enthält die interne numerische Objekt-ID des zuletzt in einem Dokument angeklickten Objekts (siehe Sektion [REPORTLINKS]).
GV_rest
alpha
Zeichenkette aus KO.DAT
GV_runaschild
numerisch
Mutliprogrammwahl beim nächsten Programmstart (0=nein / 1=ja)
GV_sbkurz
alpha
Sachbearbeiterkürzel des aktuellen Benutzers
GV_session
alpha
Sitzungsident aus infra-Programmstart
GV_silentrepair
numerisch
Autorepair-Dialog anzeigen oder heimlich reparieren - z.B. in infra:Tour (0=Repairdialog / 1=heimlich)
GV_sms
alpha
SMS Zeichenkette aus KO.DAT
GV_standort
alpha
2-stellige Standortkennung des aktuellen Benutzers
GV_startapplmodal
numerisch
Alle Programme modal starten - wird von infra:Tour benutzt (0=nein / 1=ja)
GV_startnextappl
alpha
Enthält beim Sprung zu einem anderen Programm (CBsGotoModProc) die Funktionsnummer des zu startenden Programms
GV_startupdata
alpha
Enthält Daten, die beim Programmstart mit CBsExecModProc an das zu startende Programm übergeben werden. Die Daten können beim Aufruf durch Doppelpunkt getrennt hinter der Funktionsnummer angegeben werden (z.B. "731:Meine Daten")
GV_station
alpha
Inhalt der Umgebungsvariablen SIBSTATION (infra-Stationsname). Bei der Verwendung des infra-Makros GV(GV_station) zur Abfrage der Globalvariablen GV_station (Stationsname des jeweiligen infra-Arbeitsplatzes) muss immer das Trim()-Makro eingesetzt werden, da die Varíable unter Umständen ein Null-Zeichen (Hex 0) enthält, was je nach Einsatz der Variablen zu Problemen führen kann. Das Trim()-Makro entfernt dieses Zeichen.
Beispiel
Trim(GV(GV_station))
GV_stationnr
numerisch
infra-Stationsnummer dieser Station, entspricht der Zeilennummer des Stationsnameneintrags in der Datei STATION.SIB
GV_syshinst
void
Windows Handle der aktiven Programminstanz
GV_teilnr
alpha
Letzte bearbeitete Teilenummer
GV_termin
alpha
Aktuelles infra-Arbeitsdatum (Buchungsdatum) mit 4stelligem Jahrhundert (JJJJMMTT). Wird bei jedem Programmwechsel immer mit aktuellem Datum versorgt.
Hinweis: gvsSysTermin und gvsSysDatum und gvsSysWoche werden über den Ticker (Plugin INFRATIC.DLL) laufend neu versorgt, auch innerhalb eines Programms, und können damit z.B. bei Schnittstellenprogrammen, die über Nacht laufen, verwendet werden, um den Datumswechsel zu erkennen
GV_textpath
alpha
Textepfad aus INI-Sektion [PATH]
GV_textopsilent
numerisch
Erlaubt durch die Zuweisung von "1" die Unterdrückung der Formatwarnungen beim Speichern von Textbausteinen. Bei "0" werden weiterhin Warnungen erzeugt, wenn die Länge einer Textzeile das Maximum überschreitet und ein automatischer Umbruch eingefügt wird.
GV_useframeparent
numerisch
Beim Erzeugen eines Dialogs soll der tatsächliche grafische Vater als Vater benutzt werden, unabhängig vom Application-Handle (0=nein / 1=ja)
GV_username
alpha
Interner Datenbankbenutzer für LCD-Eintrag (station+session)
GV_vers
alpha
Versionsnummer des aktuellen Programms
GV_winsysdir
alpha
Stellt das Windows-Systemverzeichnis des jeweiligen PCs als Zeichenkette zur Verfügung. Bei Einstellungen in der INI-Datei lassen sich so Verweise auf Systemprogramme einrichten, ohne den Speicherort auf den verschiedenen Clients in unterschiedlichen INI-Dateien angeben zu müssen.
GV_woche
alpha
Aktuelle infra-Arbeitswoche (Buchungsdatum) in der Form JJWW
GV_actyear
alpha
4-stellige Jahreszahl des aktuellen Kalenderjahres
GV_lastyear
alpha
4-stellige Jahreszahl des Vorjahres
GV_actquarter
alpha
2-stellige Quartalszahl des aktuellen Quartals, führende Null
GV_lastquarter
alpha
2-stellige Quartalszahl des vorherigen Quartals, führende Null
GV_lastquarteryear
alpha
4-stellige Jahreszahl zu GV-lastquarter
GV_actmonth
alpha
2-stelliger aktueller Monat, führende Null
GV_lastmonth
alpha
2-stellige Monatszahl zum vorherigen Monat, führende Null
GV_lastmonthyear
alpha
4-stellige Jahreszahl zu GV_lastmonth
GV_actweek
alpha
2-stellige aktuelle Woche, führende Null
GV_lastweek
alpha
2-stellige Wochenzahl zur vorherigen Woche, führende Null
GV_lastweekyear
alpha
4-stellige Jahreszahl zu GV_lastweek
GV_actstatper
alpha
2-stellige aktuelle Periode (Jahr, Monat, Quartal oder Woche) laut Statistikkonfiguration in "934 Konfigurationsparameter MWI"
GV_laststatper
alpha
2-stellige vorherige Periode (Jahr, Monat, Quartal oder Woche) laut Statistikkonfiguration in "934 Konfigurationsparameter MWI"
GV_laststatperyear
alpha
4-stelliges Jahr zu GV_laststatper