Formeln vom Plug-In 4D View konvertieren

Home

4D v19

Überblick

Wie auf der Seite 4D View Dokumente konvertieren bereits erläutert ist, lassen sich die meisten Eigenschaften und Angaben in Dokumenten aus dem Plug-In 4D View in Dokumente in 4D View Pro übernehmen.

Auch Formeln werden konvertiert. Jedoch unterscheiden sich die Formularsprachen von 4D View und 4D View Pro in ein paar Punkten. 4D View Pro führt standardmäßige Sicherheitsfunktionen ein, die den Zugriff auf die Daten der Anwendung steuern. Deshalb müssen u.U. Operatoren, Konstanten und Funktionen, aber auch Referenzen auf Methoden und Datenfelder angepasst werden.

Es gibt drei Fälle der Kompatibilität:

Ein 4D View Feature (Operator, Konstante, Funktion) ist genau dasselbe wie in 4D View Pro: In diesem Fall ist die Konvertierung transparent.
Ein 4D View Feature oder ein 4D Befehl wird in 4D View Pro über eine unterschiedliche Funktion bzw. Operator unterstützt: In diesem Fall wird die Anpassung automatisch durchgeführt
Ein 4D View Feature wird teilweise oder nicht in 4D View Pro unterstützt: In diesem Fall müssen Ihre konvertierten Formeln angepasst werden, damit sie wie erwartet funktionieren. Das gilt für Referenzen auf Methoden, Variablen oder Felder

Nachfolgende Tabellen zeigen die Funktionalitäten in 4D View Formeln und ihre Entsprechung in 4D View Pro.

Operatoren

	4D View	4D View Pro
Numerische Operatoren
Addition	+	+
Substraktion	-	-
Multiplikation	*	*
Division	/	/
Restwert	\	MOD
Ganzzahlige Division	÷	TRUNC(a/b)
Exponent	^	^
Modulo	%	%

Boolean Operatoren
AND	&	AND
OR	\|	OR
Not	~	NOT

String Operatoren
Verbindung	+	&
Ersetzung	-	SUBSTITUTE, Beispiel: "Down Trend" - "Down" wird ersetzt durch SUBSTITUTE("Down Trend","Down","")
Position	\	FIND (unterscheidet Klein- und Großschreibung) oder SEARCH (keine Unterscheidung zwischen Klein- und Großschreibung)

Datumsoperatoren
Datum+Tage->Datum	+	+
Datum+Zeit->Datum+Tageszeit	+	+
Datum-Tage->Datum	-	-
Datum-Datum->Anzahl Tage	-	-

Zeitoperatoren
Addition	+	+
Substraktion	-	-
Multiplikation	*	*
Division	/	/

Vergleichsoperatoren
ist gleich	=	=
ist ungleich	#	<>
größer als	>	>
kleiner als	<	<
größer als oder gleich	>=	>=
kleiner als oder gleich	<=	<=

Funktionen und 4D Befehle

In der nachfolgenden Tabelle erscheinen 4D Befehle kursiv. 4D View Funktionen in normaler Schrift.

4D & 4D View	4D View Pro	Kommentar
Abs	ABS
Add to date, AddToDate	DATE	AddToDate(date;years;months;days) wird ersetzt durch DATE(YEAR(date)+years,MONTH(date)+months,DAY(date)+days)
date+time	TIME	DATE(date) + TIME(time)
And	AND
ArcCos	ACOS
ArcSin	ASIN
Arctan, ArcTan	ATAN
Area	-	n/a (es gibt keinen Plug-In Bereich mehr)
Average	AVERAGE
Cell	INDIRECT
Char	Char
Character code	CODE
Column	COLUMNLETTER	COLUMN gibt eine Nummer zurück (keinen Buchstaben)
Cos	COS
Count	COUNTA
Current date, CurrentDate	TODAY
Current time, CurrentTime	NOW
CVCompound	PV	CVCompound(1%;5;1000) wird ersetzt durch PV(1%,5,-1000)
CVSimple	PV	CVSimple(1%;5;5*1000) wird ersetzt durch PV(1%,5,,-1000) -- Achten Sie auf die beiden aufeinanderfolgenden Kommas
Date, Date	DATEVALUE	Parameter müssen im ISO Format formatiert werden ("YYYY-MM-DDTHH:MM:SS")
Day of	DAY
Dec	MOD
Empty	ISBLANK
Eval4D	-	Derzeit nicht verfügbar
Exp	EXP
False, False	FALSE
Find	LOOKUP
FindCell	FINDCELL
FVCompound	FV	FVCompound(1%;35;35*1000) wird ersetzt durch FV(1%,35,-1000)
FVSimple	FV	FVSimple(12%;35;351000) wird ersetzt durch FV(12%,35,,-351000) -- Achten Sie auf die beiden aufeinanderfolgenden Kommas
If	IF
Insert string	REPLACE
Int	INT
Length, Length	LEN
Log, Log	LN
Lowercase	LOWER
Max	MAX
Min	MIN
Mod, Mod	MOD
MonthlyValue	PMT	MonthlyValue(10.5%/12,48,6500) wird ersetzt durch PMT(10.5%/12,48,-6500)
Month of	MONTH
Not	NOT
Num	VALUE	Warnung: Dezimaltrenner
Or	OR
PeriodNumber1	NPER	PeriodNumber1(10.5%/12;166.42;6500) wird ersetzt durch NPER(10.5%/12,-166.42,6500)
PeriodNumber2	NPER	PeriodNumber2(10.5%/12,5000,3000) wird ersetzt durch NPER(10.5%/12,,3000,-5000) -- Achten Sie auf die beiden aufeinanderfolgenden Kommas
Pi	PI
Position	SEARCH	Nur die beiden ersten Parameter werden berücksichtigt
Random, Random	RAND
Range	INDIRECT	Range("A1";"A3") wird ersetzt durch INDIRECT("A1:A3") -- Achten Sie auf das Spaltenzeichen zwischen A1 und A3
Rate1	RATE	Rate1(5;1000;3000) wird ersetzt durch RATE(5,-1000,3000)
Rate2	RATE	Rate2(5,6000,2800) wird ersetzt durch RATE(5,,2800,-6000) -- Achten Sie auf die beiden aufeinanderfolgenden Kommas
Replace string	SUBSTITUTE
Round, Rounding	ROUND
Row	ROW
Sin, Sin	SIN
SquareRoot	SQRT
StdDeviation	STDEV.P
String, String	TEXT	Warnung: Ist nur ein Parameter übergeben, wird beim Konvertieren ein leerer String hinzugefügt, da TEXT zwei Parameter benötigt.
Substring, SubString	MID
Sum	SUM
Tan	TAN
Time	TIMEVALUE
True, True	TRUE
Trunc	TRUNC
Type	TYPE	In 4D View Pro zurückgegebene Typen unterscheiden sich von 4D View
Uppercase	UPPER
Variance	VAR.P
Year of	YEAR

Hinweise zu 4D Befehlen:

Erscheint ein 4D Befehl nicht in dieser Liste der zugelassenen Befehle, wird er umgewandelt in UNSUPPORTED_4DCOMMAND(<command name>,param1,...,paramN).
Parameter vom Typ Ausdruck eines 4D Befehls, die von einer 4D View Formel aufgerufen werden, werden in die entsprechende SpreadJS Syntax umgewandelt.

Projektmethoden

Beim Konvertieren eines 4D View Dokuments werden Aufrufe von 4D Projektmethoden in Formeln in Aufrufe von 4D View Pro Benutzerfunktionen mit demselben Namen und Parametern umgewandelt. Beachten Sie, dass in 4D View Pro Klammern zum Aufrufen von Funktionen zwingend sind und Parameter durch Komma (,) voneinander getrennt werden.

Dieses Beispiel in 4D View:

=myMethod
=myMethod(1;5)

wird so in 4D View Pro konvertiert:

=myMethod()
=myMethod(1,5)

Namen von Projektmethoden müssen die Regeln der JavaScript Identifier Grammar (siehe ECMA Script standard) einhalten. Insbesondere sind Leerzeichen nicht erlaubt. Jeder nicht regelkonforme Methodenname wird umgewandelt in UNSUPPORTED_4DMETHOD_NAME("<method name>",param1,...paramN).

Hinweis: Hat eine 4D Projektmethode in einer Formel den gleichen Namen wie eine SpreadJS function, verwendet 4D View Pro diese Funktion und die Projektmethode wird nicht aufgerufen.

Umgewandelte Projektmethoden müssen zur Sicherheit und Verfügbarkeit von 4D View Pro Anforderungen für Methoden passen.

Weitere Informationen dazu finden Sie im Abschnitt Referenzen auf Projektmethoden.

Felder

Beim Konvertieren eines 4D View Dokuments werden Aufrufe von Feldern der 4D Datenbank in Formeln in 4D View Pro Benutzerfunktionen mit Namen "TABLETITLE_FIELDTITLE()" umgewandelt.

Dieses Beispiel in 4D View:

=[myTable]MyField

wird so in 4D View Pro umgewandelt:

=MYTABLE_MYFIELD()

Virtuelle Struktur
4D View Pro konvertiert Feldnamen in 4D View Formeln, die von der "virtuellen" Struktur (definiert durch Aufrufe des Befehls SET TABLE TITLES bzw. SET FIELD TITLES) oder von der Datenbankstruktur kommen (wenn keine virtuelle Struktur definiert wurde).
Aus Sicherheitsgründen berücksichtigt 4D View Pro jedoch nur in der virtuellen Struktur deklarierte Felder (siehe Anforderungen für Feldreferenzen). Das bedeutet, dass Sie den Befehl SET TABLE TITLES bzw. SET FIELD TITLES in Ihrer Datenbank aufrufen müssen, wenn 4D View Pro Referenzen auf Felder verwenden soll. Wir empfehlen, eine virtuelle Struktur vor dem Konvertieren der Dokumente zu deklarieren, denn dann können Sie die Felder und Tabellen auswählen und als Funktionen im 4D View Pro Dokument einbinden.

Hinweis: Konvertierte Felder der Struktur, die nicht in einer virtuellen Struktur deklariert wurden, zeigen beim Öffnen des konvertierten Dokuments ?NAME Fehler in den Zellen an.

Anforderungen beim Konvertieren

Während dem Konvertieren muss die Originalstruktur verfügbar sein. Sonst werden Referenzen auf Felder und Tabellen nur mit den jeweiligen Nummern konvertiert (z.B. Tabelle_6_Feld_5) und müssen zusätzlich bearbeitet werden.
Namen von Tabellen und Feldern müssen die Regeln der JavaScript Identifier Grammar (siehe ECMA Script standard) einhalten. Sonst werden sie in ein String vom Format "UNSUPPORTED_TABLE_FIELD_TITLE(<virtual structure name>)" umgewandelt.

Hinweis: Hat ein Feld in einer Formel den gleichen Namen wie eine zugelassene 4D Projektmethode, verwendet 4D View Pro die Referenz auf das Feld und die Projektmethode wird nicht aufgerufen.

Weitere Informationen dazu finden Sie im Abschnitt Feldreferenzen.

Siehe auch

4D View Dokumente konvertieren