SOG-Helpcenter Logo SOG Business - Software

Syntax der Umgebungsauflösung - CSharp


Innerhalb der CSharp Umgebung kann mit Variablen gearbeitet werden, die zur Laufzeit automatisch aufgelöst werden.
Die CSharp-Umgebungsauflösung wurde dabei um einige Element erweitert, die es erlauben, bestimmte Funktionen auszuführen, oder Daten abzurufen.

 

Syntax eines Umgebungsstrings

 

 

${fn:HHDATE}

Tagesdatum im Format JJJJMMTT

${fn:HHTIME}

Uhrzeit im Format hhmmss

${fn:DD}

Aktueller Tag

${fn:DD}

Aktueller Tag

${fn:MM}

Aktueller Monat

${fn:YYYY}

Aktuelles Jahr

${fn:hh}

Aktuelle Stunde

${fn:mm}

Aktuelle Minute

${fn:ss}

Aktuelle Sekunde

${fn:ms}

Aktuelle Millisekunde

${fn:pid}

Aktuelle Prozess-ID

${fn:tid}

Aktuelle Thread-ID

${fn:ifset:Var:Text}

Ist die Variable Var gesetzt, wird Text zurückgeliefert.

${fn:rnd:max}

Liefert eine Zufallszahl für die gilt: 0 <= Zahl < max.

${fn:path:prog.exe}

Durchsuchen der aktuellen Startvariablen des Projektes nach "prog.exe". Der Ausdruck liefert den vollständigen Pfad einer Anwendung. Dabei werden auch die Definitionen des aktuellen Ausführungsverzeichnisses über die Datei "hhuse05.txt" berücksichtigt.

${fn:winsysdir}

Liefert das Windows-Systemverzeichnis.

${fn:sogdotnetexedir}

Liefert das aktuelle DOTNET-Ausführungsverzeichnis

${fn:dat:Definition}

Liefert ein bestimmtes Datum (Siehe unten)

${fn:getfield:Trennzeichen:Feldnummer:Daten}

Liefert einen Teilbegriff eines Strings.
Beispiel: Die Angabe von "${fn:getfield: :3:Text1 Text2 Text3 Text4}" würde den Wert "Text3" liefern.

${fn:substr:Start:Länge:Daten}

Liefert einen Teilstring fester Länge eines Strings.
Beispiel: Die Angabe von "${fn:substr:2:3:abcdefghi}" würde den Wert "cde" liefern.
Achtung: Das erste Zeichen wird mit "0" gezählt.

${fn:spool:user[:Benutzer[:Ordner]]}

Liefert den Pfad eines Benutzer-Spoolverzeichnisses. Ist kein Benutzer angegeben, wird der aktuelle Benutzer verwendet. Ist kein Ordner angegeben, wird der Ordner "Neu" verwendet.

${fn:ref:RefString}

Liefert einen SOG ERP (VACOS)-Referenzstring. (Siehe unten)

${fn:projdev}

Liefert den Pfad des lokalen Entwicklungsverzeichnisses zu einem Projekt.

${fn:appdom}

Liefert den Pfad des Applikation-Domain-Verzeichnisses der aktuellen Anwendung.

${fn:uuid}

Erzeugt eine UUID. Das bei unterschiedlichen Aufrufen dieser Funktion die gleiche UUID erzeugt wird, ist extrem unwahrscheinlich. Ein UUID ist 36 Stellen lang.

${fn:eval:Expression}

Berechnung eines berechneten Ausdrucks.

${fn:evalfmt:Format:Expression}

Berechnung eines berechneten Ausdrucks. Aufbereitung des Ausdrucks über das angegebene Format.

${fn:gui:Expression}

Der nachfolgende Ausdruck wird unter Verwendung der GUI-CultureInfo aufbereitet und ausgegeben.

${fn:io:Expression}

Der nachfolgende Ausdruck wird unter Verwendung der IO-CultureInfo aufbereitet und ausgegeben.

${fn:soggenproj}

Name des generierten SOG-Projektes (Kunden Projektname)

${fn:oledb:Typen:Komponente}

Liefert einen Teilbegriff aus einer OleDb-Definition. Typen ist eine kommagetrennte Liste von OleDb-Variablennamen (z. B. Mask,Global). Komponente kann entweder srv oder db sein. Es wird dann Entweder der SQLServerName der der Datenbankname aus der Variablen OleDbMask oder OleDbGlobal geliefert.

${fn:filefrompathenv:PATHVariable:Dateiname}

Löst den Dateinamen über die angegebene PATHVariable auf.

 

${fn:fieldfrompathenv:PATHVariable:Feldnummer}

Liefert das angegebene Feld aus der PATHVariablen. Ist die Feldnummer größer als das Maximum, wird das letzte Element geliefert.

 

${fn:option:optionname:Variante}

Liefert den Inhalt der angegebenen Option. Variante: bool, int, string oder leer.

 

${fn:sachoption:optionname:Variante}

Liefert den Inhalt der angegebenen Option. Variante: bool, int, string oder leer.

 

${fn:sach}

Liefert die Id des aktuellen Sachbearbeiters.

 

 

##############

Wird durch den aktuellen Zeitpunkt im hhupd-Format ersetzt.

##hhupd##

Wird durch den aktuellen Zeitpunkt im hhupd-Format ersetzt.

##date##

Wird durch das aktuelle Datum ersetzt.

##uuid##

Wird durch eine eindeutige UUID ersetzt.

Verschachtelung


Soweit es Sinn macht, können die Funktionen ineinander geschachtelt werden.
Beispiel:

${fn:dat:now}                                       =>   "24.03.2009 09:33:24"
${fn:getfield: :1:${fn:dat:now}}                    =>   "24.03.2009"
${fn:getfield:.:3:${fn:getfield: :1:${fn:dat:now}}} =>   "2009"

Oder:

${fn:dat:now}                                       =>   "24.03.2009 09:33:24"
${fn:substr:3:7:${fn:dat:now}}                      =>   "03.2009"

Die Environment-Funktion "dat"


Über die Environmentfunktion "dat" kann auf Daten zugegriffen werden, die von SOG ERP (VACOS) bereitgestellt werden können. Das Allgemeine Format sieht folgendermaßen aus:
${fn:dat:Basisdatum:ModifierFunktion:ModifierWert:Format:Culture}

Basisdatum


Legt fest, auf welches Datum Bezug genommen werden soll. Mögliche Daten:
"now" => Aktueller Zeitpunkt (Initialwert).
"utcnow" => Aktueller Zeitpunkt im UTC Format.
"jobdate" => Aktuelles Jobdatum. Inhalt der Variablen "SOGJOBDATE" im Format "TTMMJJ" oder aktuelles Datum.
"bumo" => Beginn des aktuellen SOG ERP (VACOS)-Buchungmonats.
"gjs" => Beginn des aktuellen Geschäftjahres.
"gje" => Ende des aktuellen Geschäftsjahres.

ModifierFunktion


Ermöglicht die Veränderung des Bezugsdatums.
"adddays": Addiert eine Anzahl Tage auf das Bezugsdatum.
"addmonths": Addiert eine Anzahl Monate auf das Bezugsdatum.
"addyears": Addiert eine Anzahl Jahre auf das Bezugsdatum.
"lastmonth": Addiere eine Anzahl Monate, und liefere den letzten Tag des Monats.
"firstmonth": Addiere eine Anzahl Monate, und liefere den ersten Tag des Monats.
"firstyear": Addiere eine Anzahl Jahre, und liefere den ersten Tag des Jahres.
"lastyear": Addiere eine Anzahl Jahre, und liefere den letzten Tag des Jahres.

ModifierWert


Anzahl für die Veränderung des Bezugsdatums. Hier können auch negative Werte angegeben werden!

Format


Formatierung des Ausgabedatums. Hier können die unter Microsoft .NET übliche Datumsformatierungen verwendet werden.

Culture


Information zur verwendeten Kultur. Die Kulturinformation legt fest, wie Standard-Datumsformatierungen wie z. B. "d" wirken sollen.
Mögliche Angaben sind hier:

 

io

Standard-Kultur für Datenaustausch.

gui

Standardkultur für Benutzeraktionen.

"Numerischer Wert"

Zu verwendende Windows-Codepage.

CultureString

Windows-Codepage-Name. (z. B. en-us, de-de u.s.w.)

SOG ERP (VACOS)-Referenzstrings


Folgende Referenzstrings können über die Env-Funktion ${fn:ref:xxx} abgerufen werden:

 

sach

Name des aktuellen Sachbearbeiters.

auswertkzvk:{1-n}

Liefert die Beschriftung eines Auswertungskennzeichens Verkauf

auswertkzek:{1-n}

Liefert die Beschriftung eines Auswertungskennzeichens Einkauf

artikelauswertkz:{1-n}

Liefert die Beschriftung eines Auswertungskennzeichens Artikel

selkzvk:{1-n}

Liefert die Beschriftung eines Selektionskennzeichens Verkauf

selkzek:{1-n}

Liefert die Beschriftung eines Selektionskennzeichens Einkauf

artikelselkz:{1-n}

Liefert die Beschriftung eines Selektionskennzeichens Artikel

selkzpartner:{1-n}

Liefert die Beschriftung eines Selektionskennzeichens Partner

Zurzeit sind jeweils 10 Kennzeichen konfigurierbar (n=10).
Testen von Referenzstrings:
Mit dem Programm "SOGERPConsole" kann die Auflösung von Referenzstrings geprüft werden:

    sogerpconsole -expand "${fn:ref:selkzvk:1}"

#env