Conversion des formules du plug-in 4D View

4D v19

Présentation

Comme indiqué dans la page Conversion des documents 4D View, la plupart des contenus et des propriétés des documents du plug-in 4D View peuvent être convertis dans les documents 4D View Pro.

Les formules sont également converties. Cependant, les langages des formules de 4D View et 4D View Pro sont un peu différents et 4D View Pro ajoute des fonctions de sécurité renforcées pour l'accès aux données de la base. Par conséquent, des adaptations pourront être nécessaires quant aux opérateurs, constantes et fonctions, ainsi que pour les références aux méthodes et aux champs de la base.

Trois cas de compatibilité peuvent être rencontrés :

une fonctionnalité 4D View (opérateur, valeur, fonction) existe à l'identique dans 4D View Pro : dans ce cas, la conversion est transparente.
une fonctionnalité 4D View ou une commande 4D est prise en charge dans 4D View Pro mais via un opérateur ou une fonction différent(e) : dans ce cas, une correspondance automatique est effectuée au moment de la conversion.
une fonctionnalité 4D View est prise en charge partiellement ou n'est pas prise en charge : dans ce cas, il vous sera nécessaire d'adapter vos formules converties afin qu'elles fonctionnent de la manière souhaitée. C'est le cas pour les références de méthodes, variables et champs.

Les sections suivantes listent les fonctionnalités des formules de 4D View et leur équivalent dans 4D View Pro.

Opérateurs

	4D View	4D View Pro
Opérateurs numériques
Addition	+	+
Soustraction	-	-
Multiplication	*	*
Division	/	/
Modulo	\	MOD
Division entière	÷	TRUNC(a/b)
Exposant	^	^
Pourcentage	%	%

Opérateurs booléens
AND	&	AND
OR	\|	OR
Not	~	NOT

Opérateurs sur les chaînes
concaténation	+	&
destruction	-	SUBSTITUTE, ex : "Down Trend"-"Down" est remplacé par SUBSTITUTE("Down Trend","Down","")
position	\	FIND (sensible à la casse) ou SEARCH (non sensible à la casse)

Opérateurs sur les dates
jours+jours->date	+	+
date+heure->date+heure du jour	+	+
date-jours->date	-	-
date-date->nombre de jours	-	-

Opérateurs sur les durées
addition	+	+
soustratction	-	-
multiplication	*	*
division	/	/

Opérateurs de comparaison
égalité	=	=
différence	#	<>
supérieur à	>	>
inférieur à	<	<
supérieur ou égal à	>=	>=
inférieur ou égal à	<=	<=

Fonctions et commandes

Dans le tableau suivant, les commandes 4D sont écrites en caractères italiques. Les fonctions 4D View sont en caractères normaux.

4D & 4D View	4D View Pro	Commentaire
Abs	ABS
Add to date, AjouterADate	DATE	AjouterADate(date;années;mois;jours) est remplacé par DATE(YEAR(date)+années,MONTH(date)+mois,DAY(date)+jours)
Year of	YEAR
ArcCos	ACOS
ArcSin	ASIN
Arctan, ArcTan	ATAN
Round, Arrondi	ROUND
Char	CHAR
Cellule	INDIRECT
String	RUNTIME_STRING
Chaine	RUNTIME_VIEW_STRING
Chercher	LOOKUP
ChercherCellule	FINDCELL
Character code	CODE
Colonne	COLUMNLETTER	COLUMN retourne un numéro (et non une lettre)
Compter	COUNTA
Cos	COS
Date, Date	RUNTIME_DATE
date+heure	TIME	DATE(date) + TIME(heure)
Current date, DateDuJour	TODAY
Dec	MOD
Ecart type	STDEV.P
Int	INT
Et	AND
Eval4D	-	Actuellement non disponible
Exp	EXP
False, Faux	FALSE
Random, Hasard	RAND	Hasard (0->32767) est remplacé par RAND (0->1)
Time	RUNTIME_TIME
Current time, HeureCourante	NOW
Insert string	REPLACE
Day of	DAY
Ligne	ROW
Length, Longueur	LEN
Log, Log	LN
Uppercase	UPPER
Max	MAX
Min	MIN
Lowercase	LOWER
Mod, Mod	MOD
Month of	MONTH
Moyenne	AVERAGE
NbPeriode1	NPER	NbPeriode1(10.5%/12;166.42;6500) est remplacé par NPER(10.5%/12,-166.42,6500)
NbPeriode2	NPER	NbPeriode2(10.5%/12,5000,3000) est remplacé par NPER(10.5%/12,,3000,-5000) -- notez les deux virgules consécutives
Non	NOT
Num	VALUE	Attention au séparateur décimal
Ou	OR
Pi	PI
Plage	INDIRECT	Plage("A1";"A3") est remplacé par INDIRECT("A1:A3") -- notez le caractère deux-points entre A1 et A3
Position	SEARCH	Seuls les deux premiers paramètres sont pris en compte
RacineCarree	SQRT
Replace string	SUBSTITUTE
Si	IF
Sin, Sin	SIN
Somme	SUM
Substring, SousChaine	MID
Tan	TAN
Taux1	RATE	Taux1(5;1000;3000) est remplacé par RATE(5,-1000,3000)
Taux2	RATE	Taux2(5,6000,2800) est remplacé par RATE(5,,2800,-6000) -- notez les deux virgules consécutives
Trunc	TRUNC
Type, Type	TYPE	Les types dans 4D View Pro sont différents de ceux de 4D View
VAComposee	PV	VAComposee(1%;5;1000) est remplacé par PV(1%,5,-1000)
ValeurMensuelle	PMT	ValeurMensuelle(10.5%/12,48,6500) est remplacé par PMT(10.5%/12,48,-6500)
Variance	VAR.P
VASimple	PV	VASimple(1%;5;5*1000) est remplacé par PV(1%,5,,-1000) -- notez les deux virgules consécutives
VFComposee	FV	VFComposee(1%;35;35*1000) est remplacé par FV(1%,35,-1000)
VFSimple	FV	VFSimple(12%;35;351000) est remplacé par FV(12%,35,,-351000) -- notez les deux virgules consécutives
Vide	ISBLANK
True, Vrai	TRUE
Zone	-	n/a (plus de zone de plug-in)

Notes à propos des commandes 4D :

Si une commande 4D n'appartient pas à la liste des commandes autorisées fournie ci-dessus, elle est convertie sous la forme : UNSUPPORTED_4DCOMMAND(<nom commande>,param1,...,paramN).
Les paramètres expression d'une commande 4D appelés depuis une formule 4D View sont convertis dans leur syntaxe SpreadJS équivalente.

Méthodes projet

Lorsqu'un document 4D View est converti, les appels aux méthodes projet 4D dans les formules sont convertis en fonctions utilisateur 4D View Pro avec les mêmes nom et le(s) même(s) paramètre(s). A noter que dans 4D View Pro, les parenthèses sont obligatoires pour appeler des fonctions et les paramètres sont séparés par des virgules (,).

Par exemple, dans 4D View :

=myMethod
=myMethod(1;5)

sera converti dans 4D View Pro :

=MYMETHOD()
=MYMETHOD(1,5)

Les noms des méthodes projet doivent être conformes à JavaScript Identifier Grammar (voir ECMA Script standard). A noter en particulier que les espaces ne sont pas autorisés. Tout nom de méthode non conforme est converti en UNSUPPORTED_4DMETHOD_NAME("<nom méthode>",param1,...paramN).

Note : Si une méthode projet 4D dans une formule a le même nom qu'une fonction SpreadJS, 4D View Pro utilisera la fonction et la méthode projet ne sera jamais appelée.

Une fois converties, les méthodes projet doivent respecter les Conditions requises de 4D View Pro relatifs à la sécurité et la disponibilité pour les méthodes.

Pour plus d'informations sur les appels de méthodes dans les formules 4D View Pro, veuillez vous reporter à la page Références de méthodes projet.

Champs

Lorsqu'un document 4D View est converti, les appels aux champs de la base de données 4D dans les formules sont convertis en fonctions utilisateur 4D View Pro nommées "TITRETABLE_TITRECHAMP()".

Par exemple, dans 4D View :

=[myTable]MyField

sera converti dans 4D View Pro :

=MYTABLE_MYFIELD()

Structure virtuelle
4D View Pro convertit depuis les formules 4D View les noms de champs qui proviennent de la structure "virtuelle" (structure définie via des appels aux commandes SET TABLE TITLES et/ou SET FIELD TITLES) ou de la structure de la base (si aucune structure virtuelle n'a été définie).
Cependant, pour des raisons de sécurité, seuls les champs déclarés dans la structure virtuelle seront pris en compte par 4D View Pro (voir Conditions requises pour le Références de champ). Cela signifie que vous devez appeler les commandes SET TABLE TITLES et/ou [#cmd id="602"/] dans votre base si vous voulez que 4D View Pro utilise des références de champs. Il est recommandé de déclarer une structure virtuelle avant de convertir le document, afin que vous puissiez sélectionner les champs et les tables à définir comme fonctions dans le document 4D View Pro.

Note : Les champs de structure convertis qui ne sont pas déclarés dans une structure virtuelle génèreront des erreurs ?NAME dans les cellules à l'ouverture du document converti.

Prérequis pour la conversion

Lors de la conversion, la structure d'origine doit être accessible. Dans le cas contraire, les références de tables et de champs seront uniquement convertis avec leurs numéros (par exemple, Table_6_Field_5) et nécessiteront un traitement manuel supplémentaire.
Les noms des tables et des champs doivent être conformes à JavaScript Identifier Grammar (voir ECMA Script standard). Sinon, le nom de table ou de champ sera converti en chaîne au format : "UNSUPPORTED_TABLE_FIELD_TITLE(<nom structure virtuelle>)"

Note : Si un champ dans une formule a le même nom qu'une méthode projet autorisée, 4D View Pro utilisera la référence de champ et la méthode projet ne sera jamais appelée.

Pour plus d'informations sur les références de champs dans les formules 4D View Pro, veuillez vous reporter à la page Références de champ.

Voir aussi

Conversion des documents 4D View