F-Script

Adressierte Objekte

Argument	Beispiel	Kommentar
Main=[Alias, ] Source	Main= Firma,Addr	Muss, bzw. darf genau ein Mal vorkommen!
{ Related=Alias, Source, [Count], [OrderArray], [FilterExp] }	Related= FKP, Contact, One, , FKP.AddrNo = Firma.Number and FKP.IsMainContact = 1 Related= Konzern, Addr, , , Konzern.Number = Firma.HighParentCompany Related= KKP, Contact, , , KKP.AddrNo = Konzern.Number and KKP.IsMainContact = 1 Related= Top5KP, Contact, 5, [+Top5KP.Number], Top5KP.AddrNo = Addr.Number0	Kann n Mal vorkommen und muss jeweils eine Join-Vorschrift enthalten. Grundsätzlich wird ein "Left-Outer-Join" gebildet. Bei Relationen die maximal eine Row retournieren, kann der Relation-Specifier (Count) ToOne verwendet werden. In den Beispielen Links sind u.a. folgende Alias definiert: FKP = Alias für Haupt-Kontaktperson von "Firma". KKP= Alias für Haupt-Kontaktperson von "Konzern" Wichtig Wird mit OrderArray gearbeitet, müssen die Attribute zwischen eckige Klammern gesetzt werden. Siehe auch hier: Verwendete Definitionen Beachten Sie, dass Count=All und Count=One nicht funktionieren, wenn mit OrderArray gearbeitet wird.

Gewünschte Spalten

Argument	Beispiel	Kommentar
{ Column=[Alias], Attribute | ColumnExp }	Column=, Addr.Number Column=FirmaName, Addr.FullName Column=FirmaKontakt, AKP.FullName Column=KonzernNr, Konzern.Number Column=KonzernName, Konzern.FullName Column=KonzernKontakt, KKP.FullName Column=KontaktIdentisch, if(KKP.PersonId = AKP.PersonId, "Yes", "No") Column=, Cust.Remark	Kann n Mal vorkommen. Es können vordefinierte Relationen analog GetBo (hier "Cust") verwendet werden. Wichtig Der Alias ist nur für Attribute optional. Expressions müssen zwingend mit einem Alias erfasst werden.
{ Columns=Attribute {,Attribute} }	Columns=Addr.Number,Addr.FullName	Wenn keine Alias definiert werden müssen, kann direkt mit den Attributnamen gearbeitet werden. Diese können dann innerhalb einer "Definition" mittels "Columns" erfasst werden. Die einzelnen Attribute werden dabei mit Komma separiert. Achtung Diese Schreibweise ist nur für Attribute erlaubt. Nicht für Expressions!

Filter und Sortierung

Argument	Beispiel	Kommentar
[ Filter=FilterExp ]	Filter=Firma.HighParentCompany <> 0 and FKP.AddrNo <> NULL and KKP.AddrNo <> NULL Sie haben die Möglichkeit, Strings in Filtern spezifisch als "ohne Escaping" zu deklarieren. Die Deklaration erfolgt dabei mittels Backtick-Character. // Pfadangabe in einem Filter ohne Escaping der Backslash-Character Filter=PrintJob.PrinterDevice = `\\ServerName\Share`	Darf maximal ein Mal vorkommen! Das Schlüsselwort NULL ist nur mit Vergleich "<>" oder "=" erlaubt.
{ OrderBy= [+|-] Column[, StartValueLiteral] }	OrderBy=Konzern.Number OrderBy=-Firma.Number	Kann n Mal vorkommen. Die Reihenfolge ist relavant! Defaultwert ist + (Ascending) Notiz Bitte beachten Sie folgenden Umstand: OrderBy-Argument-Spalten werden automatisch zurückgegeben, wenn Scrolling aktiviert ist!
{ OrderByAsDate= [+|-] Column[, StartValueLiteral] }	OrderByAsDate=WhJob.Free6,12.08.2020 OrderByAsDate=-Addr.Free8	Sortieren als Datum, wobei als Folge jeweils strAsDate() angewendet werden.
{ OrderByAsNmb= [+|-] Column[, StartValueLiteral] }	OrderByAsNmb=SalDoc.Free7	Sortieren als Zahl, wobei als Folge jeweils strAsNmb() angewendet werden.
MaxRows=nn|All	MaxRows=15	Muss genau ein Mal vorkommen!
[Distinct=0|1] [Distinct=FALSE|TRUE]	Distinct=1 Distinct=TRUE	Rows mit gleichem Inhalt werden unterdrückt. Defaultwert ist 0/FALSE (nicht unterdrücken)

Scrolling

Argument	Beispiel	Kommentar
[Scrolling=code]	Scrolling=ne	Darf maximal ein Mal vorkommen! Default: Kein Scrolling. Unterstützt werden die Werte gem. GetBo, jedoch ohne e und eif. Notiz Beachten Sie folgenden Umstand: Wird Scrolling verwendet, müssen auch die Argumente MaxRows und OrderBy vorhanden sein!
[#RedoData=<Redo-Data-Token von Vorgänger-Response>]	#RedoData=[NE,[NULL,NULL,NULL],[14,3,16],[15,3,21]]	RedoData ist für die erste Page nicht notwendig. Inhalt 1:1 gemäss Response des Vorgänger-Request. Siehe auch Kapitel "Scrolling".
[#RedoArgs=code [,Direction] [,NmbOfRows]]	#RedoArgs=ne	RedoArgs ist für die erste Page nicht notwendig. Siehe auch Kapitel "Scrolling".

Verwendete Definitionen

Auswertungs-Reihenfolge

Eigene Ausdrücke

Query
Main=SalDoc
MaxRows=All
Filter=SalDoc.CustNo=2020
Columns=SalDoc.BoId,SalDoc.CustNo,SalDoc.SalProcLevelCd,SalDoc.ShortCut,SalDoc.Number,SalDoc.DocStateCd

Query
Main=SalDoc
MaxRows=All
Define=@Customer.Number,2020
Filter=SalDoc.CustNo = @Customer.Number
Columns=SalDoc.BoId,SalDoc.CustNo,SalDoc.SalProcLevelCd,SalDoc.ShortCut,SalDoc.Number,SalDoc.DocStateCd

Biz.Query
Main=MisSal(33,397,12,NULL,'C',2020,'M',1,36)
Column=MisSal2.Turnover,ifnull(MisSal2.Turnover,0)
Column=MisSal2.CoverCont,ifnull(MisSal2.CoverCont,0)
Column=MisSal2.Quantity,ifnull(MisSal2.Quantity,0)
Column=MisSal1.Turnover,ifnull(MisSal1.Turnover,0)
Column=MisSal1.CoverCont,ifnull(MisSal1.CoverCont,0)
Column=MisSal1.Quantity,ifnull(MisSal1.Quantity,0)
Column=MisSal0.Turnover,ifnull(MisSal0.Turnover,0)
Column=MisSal0.CoverCont,ifnull(MisSal0.CoverCont,0)
Column=MisSal0.Quantity,ifnull(MisSal0.Quantity,0)
MaxRows=25
Related=MisSal2,MisSal(33,397,12,MisSal.L2CumulId,'C',2020,'M',1,3),1,,
Related=MisSal1,MisSal(33,397,12,MisSal.L2CumulId,'C',2021,'M',1,3),1,,
Related=MisSal0,MisSal(33,397,12,MisSal.L2CumulId,'C',2022,'M',1,3),1,,
Related=L2Cuml,CustMisC2,1,,L2Cuml.BoId=MisSal.L2CumulId
Column=L2CumlId,L2Cuml.BoId
Column=L2CumlNumber,L2Cuml.BoNumber
OrderBy=-MisSal0.Turnover
OrderBy=MisSal.RowId
Scrolling=n

Biz.Query
Define=@L1Cumul,33
Define=@L1CumulId,397
Define=@L2Cumul,12
Define=@StartYearType,'C'
Define=@StartYearCurrent,2022
Define=@StartYearPrevious,2021
Define=@StartYearPrePrevious,2020
Define=@StartPeriodType,'M'
Define=@StartPeriod,1
Define=@MonthCountThreeYears,36
Define=@MonthCountThree,3
Define=@NullReplacementValue,0
Main=MisSal(@L1Cumul,@L1CumulId,@L2Cumul,NULL,@StartYearType,@StartYearPrePrevious,@StartPeriodType,@StartPeriod,@MonthCountThreeYears)
Column=MisSal2.Turnover,ifnull(MisSal2.Turnover,@NullReplacementValue)
Column=MisSal2.CoverCont,ifnull(MisSal2.CoverCont,@NullReplacementValue)
Column=MisSal2.Quantity,ifnull(MisSal2.Quantity,@NullReplacementValue)
Column=MisSal1.Turnover,ifnull(MisSal1.Turnover,@NullReplacementValue)
Column=MisSal1.CoverCont,ifnull(MisSal1.CoverCont,@NullReplacementValue)
Column=MisSal1.Quantity,ifnull(MisSal1.Quantity,@NullReplacementValue)
Column=MisSal0.Turnover,ifnull(MisSal0.Turnover,@NullReplacementValue)
Column=MisSal0.CoverCont,ifnull(MisSal0.CoverCont,@NullReplacementValue)
Column=MisSal0.Quantity,ifnull(MisSal0.Quantity,@NullReplacementValue)
MaxRows=25
Related=MisSal2,MisSal(@L1Cumul,@L1CumulId,@L2Cumul,MisSal.L2CumulId,@StartYearType,@StartYearPrePrevious,@StartPeriodType,@StartPeriod,@MonthCountThree),1,,
Related=MisSal1,MisSal(@L1Cumul,@L1CumulId,@L2Cumul,MisSal.L2CumulId,@StartYearType,@StartYearPrevious,@StartPeriodType,@StartPeriod,@MonthCountThree),1,,
Related=MisSal0,MisSal(@L1Cumul,@L1CumulId,@L2Cumul,MisSal.L2CumulId,@StartYearType,@StartYearCurrent,@StartPeriodType,@StartPeriod,@MonthCountThree),1,,
Related=L2Cuml,CustMisC2,1,,L2Cuml.BoId=MisSal.L2CumulId
Column=L2CumlId,L2Cuml.BoId
Column=L2CumlNumber,L2Cuml.BoNumber
OrderBy=-MisSal0.Turnover
OrderBy=MisSal.RowId
Scrolling=n

Fixe Datenwerte

Logik

Set

CodeValue	Syntax	Kommentar
count	count([relationName.boAttribute])	Falls eine Relation durch ihren Namen und ein Attribut der Source spezifiziert wird, wird die entsprechende Anzahl Rows zurückgegeben. Falls keine Relation angegeben wird, wird grundsätzlich die Anzahl passender Rows einer Query zurückgegeben. Wird eine count()-Spalte in Kombination mit anderen Spalten (z.B. Addr.CountrySc) verwendet, wird zusätzlich gemäss diesen Spalten gruppiert (z.B. eine Result-Row mit Anzahl pro Land).
countDistinct	countDistinct([relationName.boAttribute])	Es wird die Anzahl unterschiedlicher Rows einer Query zurückgegeben. Wichtig countDistinct kann nur mit einer Relation ausgeführt werden.
exists	exists(relationName)	Prüft, ob mindestens eine Row durch die übergebene Relation geliefert wird. Achtung Im Gegensatz zu den anderen Set-Funktionen hat exists keine gruppierende Wirkung!
max	max(number)	Bestimmt den Maximalwert mehrerer Zahlen. (Allfällige NULL-Werte werden ignoriert)
min	min(number)	Bestimmt den Minimalwert mehrerer Zahlen. (Allfällige NULL-Werte werden ignoriert)
least	least(int,int)	Liefert die kleinere der beiden Werte zurück. # Beispiel 1 least(-5, 4) # Ergebnis -5 # Beispiel 2 least('AB', 'CD') # Ergebnis 'AB' Diese Funktion kann auch für Datumsvergleiche verwendet werden. # Beispiel 3 least(strToDate("01.02.2022"), strToDate("30.01.2022")) # Ergebnis 30.01.2022
greatest	greatest(int,int)	Liefert die grössere der beiden Werte zurück. # Beispiel 1 least(-5, 4) # Ergebnis 4 # Beispiel 2 least('AB', 'CD') # Ergebnis 'CD' Diese Funktion kann auch für Datumsvergleiche verwendet werden. # Beispiel 3 least(strToDate("01.02.2022"), strToDate("30.01.2022")) # Ergebnis 01.02.2022
sum	sum(number)	Bestimmt die Summe mehrerer Zahlen. (Allfällige NULL-Werte werden ignoriert)
avg	avg(number)	Bestimmt den Durchschnittswert mehrerer Zahlen. (Allfällige NULL-Werte werden ignoriert)

String

Number

Date

CodeValue	Syntax	Kommentar
dayOfDate	dayOfDate(date)	Liefert den Tag eines Datums (als Nummer). Für NULL wird NULL zurückgegeben, für EMPTY_DATE wird 0 zurückgegeben.
monthOfDate	monthOfDate(date)	Liefert den Monat eines Datums (als Nummer). Für NULL wird NULL zurückgegeben, für EMPTY_DATE wird 0 zurückgegeben.
yearOfDate	yearOfDate(date)	Liefert das Jahr eines Datums (als Nummer). Für NULL wird NULL zurückgegeben, für EMPTY_DATE wird 0 zurückgegeben.
dateAdd	dateAdd(date, count [,datePartCd])	Addiert zu einem Datum eine bestimmte Anzahl "Datums-Teile". Standardmässig (wenn nicht weiter angegeben) werden Tage dazu addiert. Ansonsten können für "datePartCd" die Werte gemäss Code "DatePart" - also zum Beispiel "DatePart.Month" - verwendet werden. Wenn ein Argument NULL ist, wird NULL zurückgegeben. Ebenso wird für ein EMPTY_DATE-Argument NULL zurückgegeben. Beispiel: Zum Datum 31.10.2013 soll ein Monat addiert werden. Rückgabe: 30.11.2013
dateDiff	dateDiff(date1,date2 [,datePartCd])	Ermittelt die Differenz von "date1" minus "date2". Standardmässig (wenn nicht weiter angegeben) wird die Differenz in Anzahl Tagen geliefert. Ansonsten können für "datePartCd" die Werte gemäss Code "DatePart" - also zum Beispiel "DatePart.Month" - verwendet werden. Achtung Für diese Funktion wird DatePart.Week nicht unterstützt! Wenn ein Argument NULL ist, wird NULL zurückgegeben. Ebenso wird für ein EMPTY_DATE-Argument NULL zurückgegeben.
today	today()	Gibt das aktuelle Datum zurück.
time	time()	Gibt die aktuelle Zeit zurück.

Namen

• Redefinitionen (via Redefinition zugewiesene Konstanten) werden berücksichtigt.
• Übrige Definitionen (zum Beispiel freie Felder auf Pool-Items, abhängig von Parent-Pool) werden nicht berücksichtigt.

Konversionen

CodeValue	Syntax	Kommentar
nmbToStr	nmbToStr(number)	Konvertiert eine Zahl in einen String. Für NULL wird NULL zurückgegeben. Der Punkt wird als Dezimaltrennzeichen verwendet. Es werden keine überflüssigen Nachkommastellen erzeugt. Falls mehr als acht Nachkommastellen vorhanden sind, wird auf die achte Stelle gerundet.
strToNmb	strToNmb(str)	Konvertiert einen String in eine Zahl. Für NULL wird NULL zurückgegeben. Der Punkt wird als Dezimaltrennzeichen erkannt. Ein Leerstring liefert 0. Führende/Abschliessende Leerzeichen werden ignoriert.
strAsNmb	strAsNmb(str)	Konvertiert einen String in eine Zahl. Die Funktionsweise entspricht strToNmb, jedoch mit folgendem Unterschied: Ist keine Konvertierung möglich (z.B. weil der String Buchstaben enthält), hat dies keinen Fehler zur Folge, sondern es wird NULL zurückgegeben.
dateToStr	dateToStr(date)	Konvertiert ein Datum in einen String vom Format tt.mm.jjjj Für NULL wird NULL zurückgegeben, für EMPTY_DATE wird ein Leerstring zurückgegeben
strToDate	strToDate(str)	Konvertiert einen String vom Format tt.mm.jjjj in ein Datum. Für NULL wird NULL zurückgegeben, für Leerstrings wird EMPTY_DATE zurückgegeben.
strAsDate	strAsDate(str)	Konvertiert einen String vom Format tt.mm.jjjj in ein Datum. Die Funktionsweise entspricht strToDate, jedoch mit folgendem Unterschied: Ist keine Konvertierung möglich (z.B. weil der String Buchstaben enthält), hat dies keinen Fehler zur Folge, sondern es wird NULL zurückgegeben.
dateToInt	dateToInt(date)	Konvertiert ein Datum in einen Integer. Achtung! Die Abbildung ist Opacc-spezifisch und nur für den Datumsbereich 01.01.0201 bis 31.12.2500 definiert. Für NULL wird NULL zurückgegeben, für EMPTY_DATE wird 0 zurückgegeben.
intToDate	intToDate(int)	Konvertiert einen Integer in ein Datum. Achtung! Die Abbildung ist Opacc-spezifisch und nur für den Datumsbereich 01.01.0201 bis 31.12.2500 definiert. Für NULL wird NULL zurückgegeben, für EMPTY_DATE wird 0 zurückgegeben.
intToStr	intToStr(int)	Konvertiert einen Integer in einen String. Für NULL wird NULL zurückgegeben. Wird eine Fliesskommazahl übergeben, wird ein allfälliger Nachkommateil abgeschnitten. Notiz Wir empfehlen, wo immer möglich, die Verwendung von intToStr anstelle von nmbToStr.

Diverse

Biz.Query
MaxRows=50
Main=Addr
Column=RowNo,rowNo()
Columns=Addr.FullName
Filter=Addr.FullName<>''
OrderBy=Addr.FullName

...
...
Column=GUID,guid()
...
...

Operatoren

Konstanten