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	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) Hinweis 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. Hinweis 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

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)
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

Diverse

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

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

Operatoren

Konstanten