Conversión de fórmulas del plug-in 4D View

4D v19

Generalidades

Como se indica en la página Conversión de documentos 4D View, la mayoría de los contenidos y propiedades del documento del plug-in 4D View se pueden convertir en documentos 4D View Pro.

Las fórmulas también se convierten. Sin embargo, los lenguajes de fórmula de 4D View y 4D View Pro son algo diferentes y 4D View Pro implementa funcionalidades de seguridad por defecto que controlan el acceso a la base de datos. Como resultado, pueden ser necesarias algunas adaptaciones sobre operadores, constantes y funciones, así como también referencias a métodos y campos de base de datos.

Tres casos de compatibilidad pueden ocurrir:

una funcionalidad 4D View (operador, constante, función) es exactamente la misma en 4D View Pro: en este caso, la conversión es transparente.
una funcionalidad 4D View o un comando 4D se soporta en 4D View Pro a través de una función u operador diferente: en este caso, se realiza una asignación automática
una funcionalidad 4D View es parcial o no es compatible con 4D View Pro: en este caso, será necesario adaptar sus fórmulas convertidas para que funcionen como se esperaba. Este es el caso de referencias a métodos, variables o campos.

Las siguientes secciones listan las funcionalidades de la fórmula 4D View y sus funcionalidades correspondientes en 4D View Pro.

Operadores

	4D View	4D View Pro
Operadores numéricos
Addition	+	+
Substraction	-	-
Multiplication	*	*
Division	/	/
Remainder	\	MOD
Integer division	÷	TRUNC(a/b)
Exponent	^	^
Percentage	%	%

Operadores Booleanos
AND	&	AND
OR	\|	OR
Not	~	NOT

Operadores cadena
concatenation	+	&
destruction	-	SUBSTITUTE, ej.: "Down Trend"-"Down" se remplaza por SUBSTITUTE("Down Trend","Down","")
position	\	FIND (sensibles a mayúsculas o minúsculas) o SEARCH (case insensitive)

Operadores Fecha
date+days->date	+	+
date+time->date+time of day	+	+
date-days->date	-	-
date-date->number of days	-	-

Operadores duración
addition	+	+
substraction	-	-
multiplication	*	*
division	/	/

Operadores comparación
equality	=	=
difference	#	<>
greater than	>	>
less than	<	<
greater than or equal to	>=	>=
less than or equal to	<=	<=

Funciones y comandos

En la tabla siguiente, los comandos 4D se muestran en cursiva. Las funciones de 4D View se muestran en una fuente normal.

4D y 4D View	4D View Pro	Comentario
Abs	ABS
Add to date, AddToDate	DATE	AddToDate(date;years;months;days) se remplaza por 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 (no área de plug-in)
Average	AVERAGE
Cell	INDIRECT
Char	Char
Character code	CODE
Column	COLUMNLETTER	COLUMN devuelve un número (no una letra)
Cos	COS
Count	COUNTA
Current date, CurrentDate	TODAY
Current time	RUNTIME_CURRENT_TIME
CurrentTime	NOW
CVCompound	PV	CVCompound(1%;5;1000) se remplaza por PV(1%,5,-1000)
CVSimple	PV	CVSimple(1%;5;5*1000) se remplaza por PV(1%,5,,-1000) -- note las dos comas consecutivas
Date, Date	RUNTIME_DATE
Day of	DAY
Dec	MOD
Empty	ISBLANK
Eval4D	-	Currently not available
Exp	EXP
False, False	FALSE
Find	LOOKUP
FindCell	FINDCELL
FVCompound	FV	FVCompound(1%;35;35*1000) se remplaza por FV(1%,35,-1000)
FVSimple	FV	FVSimple(12%;35;351000) se remplaza por FV(12%,35,,-351000) -- note las dos comas consecutivas
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) se remplaza por PMT(10.5%/12,48,-6500)
Month of	MONTH
Not	NOT
Num	VALUE	Atención: separador decimal
Or	OR
PeriodNumber1	NPER	PeriodNumber1(10.5%/12;166.42;6500) se remplaza por NPER(10.5%/12,-166.42,6500)
PeriodNumber2	NPER	PeriodNumber2(10.5%/12,5000,3000) se remplaza por NPER(10.5%/12,,3000,-5000) -- note las dos comas consecutivas
Pi	PI
Position	SEARCH	Solo los primeros dos parámetros se tienen en cuenta
Random, Random	RAND	Random (0->32767) se remplaza por RAND (0->1)
Range	INDIRECT	Range("A1";"A3") se remplaza por INDIRECT("A1:A3") -- note el punto y coma entre A1 y A3
Rate1	RATE	Rate1(5;1000;3000) se remplaza por RATE(5,-1000,3000)
Rate2	RATE	Rate2(5,6000,2800) se remplaza por RATE(5,,2800,-6000) -- note las dos comas consecutivas
Replace string	SUBSTITUTE
Round, Rounding	ROUND
Row	ROW
Sin, Sin	SIN
SquareRoot	SQRT
StdDeviation	STDEV.P
String, String	TEXT
Substring, SubString	MID
Sum	SUM
Tan	TAN
Time	RUNTIME_TIME
True, True	TRUE
Trunc, Trunc	TRUNC
Type, Type	TYPE	Tipos devueltos en 4D View Pro son diferentes de 4D View
Uppercase	UPPER
Variance	VAR.P
Year of	YEAR

Notas sobre los comandos 4D:

Si un comando 4D no forma parte de la lista anterior de comandos autorizados, se convierte a: UNSUPPORTED_4DCOMMAND(<nombre comando>,parámetro 1,...,parámetro N).
Los parámetros de expresión de un comando 4D llamado desde una fórmula 4D View se convierten a la sintaxis SpreadJS equivalente.

Métodos proyecto

Cuando se convierte un documento de 4D View, llama a los métodos proyecto 4D en fórmulas se convierten en llamadas a funciones de usuario 4D View Pro con el mismo nombre y parámetros. Tenga en cuenta que los paréntesis son obligatorios en 4D View. Además, los parámetros están separados por comas (,).

Por ejemplo, en 4D View:

=myMethod
=myMethod(1;5)

se convertirá en 4D View Pro:

=myMethod()
=myMethod(1,5)

Los nombres de los métodos proyecto deben cumplir con JavaScript Identifier Grammar (ver ECMA Script standard). Tenga en cuenta, en particular, que los caracteres de espacio no están permitidos. Cualquier nombre de método no conforme se convierte a UNSUPPORTED_4DMETHOD_NAME("<method name>",param1,...paramN).

Nota: si un método proyecto 4D en una fórmula tiene el mismo nombre que un SpreadJS function, 4D View Pro utilizará la función y no se llamará al método del proyecto.

Una vez convertidos, los métodos proyecto deben cumplir con la seguridad y disponibilidad de 4D View Pro Requiremientos para métodos.

Para más información sobre las llamadas a métodos en 4D View Pro, consulte la página Referencias método proyecto.

Campos

Cuando se convierte un documento de 4D View, las llamadas a los campos de la base de datos 4D a las funciones de usuario de 4D View Pro llamadas "TABLETITLE_FIELDTITLE ()".

Por ejemplo, en 4D View:

=[myTable]MyField

se convertirá en 4D View Pro:

=MYTABLE_MYFIELD()

Estructura virtual
4D View Pro convierte los nombres de campo en fórmulas 4D View que provienen de la estructura "virtual" (estructura definida a través de llamadas a los comandos SET TABLE TITLES y/o SET FIELD TITLES) o desde la estructura de la base (si no se definió una estructura virtual).
Sin embargo, por razones de seguridad, solo los campos declarados en la estructura virtual serán tenidos en cuenta por 4D View Pro (ver Requerimientos para las Referencias de campo). Esto significa que debe llamar a los comandos SET TABLE TITLES y/o SET FIELD TITLES en su base de datos si desea que 4D View Pro utilice las referencias de campo. Se recomienda declarar una estructura virtual antes de convertir el documento, de modo que pueda seleccionar campos y tablas para anidar como funciones en el documento 4D View Pro.

Nota: los campos de estructura convertidos que no están declarados en una estructura virtual generarán errores ?NAME en las celdas cuando se abra el documento convertido.

Requisitos de conversión

Durante la conversión, la estructura original debe estar disponible. De lo contrario, las referencias de campo y tabla se convertirán con sus números (por ejemplo, Table_6_Field_5) y necesitarán un procesamiento adicional.
Los nombres de tabla y campo deben cumplir con JavaScript Identifier Grammar (ver ECMA Script standard). De lo contrario, el nombre de tabla o campo se convierte en una cadena con este formato: "UNSUPPORTED_TABLE_FIELD_TITLE(<virtual structure name>)"

Nota: si un campo en una fórmula tiene el mismo nombre que un método proyecto 4D permitido, 4D View Pro usará la referencia de campo y no se llamará al método proyecto.

Para más información sobre las referencias de campo en fórmulas 4D View Pro, consulte la página Referencias de campo.

Ver también

Conversión de documentos 4D View