Converter fórmulas plug-in 4D View

4D v19

Visão Geral

Como se indica na página Conversão de documentos 4D View, a maioria dos conteúdos e propriedades do documento de plug-in 4D View podem ser convertidos em documentos 4D View Pro.

As fórmulas también são convertidos. Entretanto, as linguagens de fórmula de 4D View e 4D View Pro são um pouco diferentes e 4D View Pro implementa propriedades normais de segurança que controlam o acesso ao dados do banco de dados. Como resultado, algumas adaptações podem ser necessárias quanto a operadores, constantes e funções, assim como em referências a métodos e campos de bancos de dados.

Três casos de compatibilidade podem ocorrer:

uma funcionalidade 4D View (operador, constante, função) é exatamente a mesma em 4D View Pro: neste caso, a conversão é transparente.
uma funcionalidade 4D View é compatível com 4D View Pro através de uma função ou operador diferente: neste caso, se realiza uma atribuição automática
uma funcionalidade 4D View é parcial ou não é compatível com 4D View Pro: neste caso, será necessário adaptar suas fórmulas convertidas para que funcionem como se esperava.

As tabelas abaixo listam as funcionalidades da fórmula 4D View e suas funcionalidades correspondentes em 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 string
concatenation	+	&
destruction	-	SUBSTITUTE, ex.: "Down Trend"-"Down" se substitui por SUBSTITUTE("Down Trend","Down","")
position	\	FIND (sensíveis a maiúsculas ou minúsculas) ou SEARCH (não diferencia maiúsculas e minúsculas)

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

Operadores duração
addition	+	+
substraction	-	-
multiplication	*	*
division	/	/

Operadores comparação
equality	=	=
difference	#	<>
greater than	>	>
less than	<	<
greater than or equal to	>=	>=
less than or equal to	<=	<=

Funções

Na tabela abaixo os comandos 4D são mostrados em itálicos. Funções 4D View são exibidos em fonte normal.

4D View	4D View Pro	Comentário
Abs	ABS
Add to date, AddToDate	DATE	AddToDate(date;years;months;days) se substitui 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 plug-in area)
Average	AVERAGE
Cell	INDIRECT
Char	Char
Character code	CODE
Column	COLUMNLETTER	COLUMN devolve um número (não uma letra)
Cos	COS
Count	COUNTA
Current date, CurrentDate	TODAY
Current time	RUNTIME_CURRENT_TIME
CurrentTime	NOW
CVCompound	PV	CVCompound(1%;5;1000) se substitui por PV(1%,5,-1000)
CVSimple	PV	CVSimple(1%;5;5*1000) se substitui por PV(1%,5,,-1000) -- note as duas vírgulas consecutivas
Date, Date	DATEVALUE	Los parámetros deben tener formato ISO ("YYYY-MM-DDTHH:MM:SS")
Day of	DAY
Dec	MOD
Empty	ISBLANK
Eval4D	-	Não disponível
Exp	EXP
False, False	FALSE
Find	LOOKUP
FindCell	FINDCELL
FVCompound	FV	FVCompound(1%;35;35*1000) se substitui por FV(1%,35,-1000)
FVSimple	FV	FVSimple(12%;35;351000) se substitui por FV(12%,35,,-351000) -- note as duas vírgulas 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 substitui por PMT(10.5%/12,48,-6500)
Month of	MONTH
Not	NOT
Num	VALUE	Atenção: separador decimal
Or	OR
PeriodNumber1	NPER	PeriodNumber1(10.5%/12;166.42;6500) se substitui por NPER(10.5%/12,-166.42,6500)
PeriodNumber2	NPER	PeriodNumber2(10.5%/12,5000,3000) se substitui por NPER(10.5%/12,,3000,-5000) -- note as duas vírgulas consecutivas
Pi	PI
Position	SEARCH	Solo los primeros dos parámetros se tienen en cuenta
Random, Random	RAND
Range	INDIRECT	Range("A1";"A3") se substitui por INDIRECT("A1:A3") -- note o ponto e vírgula entre A1 e A3
Rate1	RATE	Rate1(5;1000;3000) se substitui por RATE(5,-1000,3000)
Rate2	RATE	Rate2(5,6000,2800) se substitui por RATE(5,,2800,-6000) -- note as duas vírgulas consecutivas
Replace string	SUBSTITUTE
Round, Rounding	ROUND
Row	ROW
Sin, Sin	SIN
SquareRoot	SQRT
StdDeviation	STDEV.P
String, String	TEXT	Atenção: se passar só um parâmetro, a conversão agrega um parâmetro de string vazio porque TEXT requer dois parâmetros.
Substring, SubString	MID
Sum	SUM
Tan	TAN
Time	TIMEVALUE
True, True	TRUE
Trunc, Trunc	TRUNC
Type, Type	TYPE	Tipos devolvidos em 4D View Pro são diferentes de 4D View
Uppercase	UPPER
Variance	VAR.P
Year of	YEAR

Notas sobre os comandos 4D:

Se um comando 4D não formar parte da lista anterior de comandos autorizados, é convertida a: UNSUPPORTED_4DCOMMAND(<nome comando>,parâmetro 1,...,parâmetro n).
Os parâmetros de expressão de um comando 4D chamado desde uma fórmula 4D View são convertidos à sintaxe SpreadJS equivalente.

Métodos de Projeto

Quando um documento de 4D View for convertido, chamadas a métodos de projeto 4D em fórmulas são convertidas a chamadas a funções de usuário 4D View Pro com o mesmo nome e parâmetros. Note que parêntesis são obrigatórios em 4D View Pro para que chame funções. Além disso, parâmetros são separados por vírgulas (,).

Por exemplo, em 4D View:

=myMethod
=myMethod(1;5)

vai ser convertida para 4D View Pro:

=myMethod()
=myMethod(1,5)

Nomes de métodos de projeto devem cumprir com JavaScript Identifier Grammar (ver ECMA Script standard). Note em particular que caracteres de espaço não são permitidos. Qualquer nome de método que não cumpra com as regras é convertido a UNSUPPORTED_4DMETHOD_NAME("<method name>",param1,...paramN).

Nota: Se um método de projeto 4D em uma fórmula tiver o mesmo nome que uma SpreadJS function, 4D View Pro vai usar a função e o método de projeto não vai ser chamado.

Quando for convertido, métodos de projeto devem cumprir com segurança e disponibilidade 4D View Pro Exigências para métodos.

Para saber mais sobre métodos de chamada em fórmulas 4D View Pro, veja a página Project method references.

Campos

Quando um documento 4D View for convertido, chamadas a campos de banco de dados 4D são convertidos a chamadas a funções de usuário 4D View Pro nomeadas "TABLETITLE_FIELDTITLE()".

Por exemplo, em 4D View:

=[myTable]MyField

vai ser convertida para 4D View Pro:

=MYTABLE_MYFIELD()

Estrutura Virtual
4D View Pro converte nomes de campos em fórmulas 4D View que vem da estrutura "virtual" (estrutura definida através de chamadas aos comandos SET TABLE TITLES ou SET FIELD TITLES ) ou da estrutura de banco de ados (se nenhuma estrutura virtual tiver sido definida).
Entretanto, por razões de segurança, só campos declarados na estrutura virtual serão considerados por 4D View Pro (ver Exigências para Field references). isso significa que deve chamar os comandos SET TABLE TITLES ou SET FIELD TITLES em seu banco de dados se quiser que 4D View Pro use referências de campo. È recomendado declarar uma estrutura virtual antes de converter o documento, assim é possível selecionar campos e tabelas para embeber as funções no documento 4D View Pro.

Nota: Campos de estruturas convertidas que não forem declarados em uma estrutura virtual vão gerar erros ?NAME nas células quando o documento convertido for aberto.

Exigências de Conversão

Durante a conversão, a estrutura orginal deve estar disponível. Senão, referências de campo e tabelas serão convertidas só com seus números (por exemplo, Table_6_Field_5) e precisa de processamento adicional.
Tabela e nomes de campos devem cumprir com JavaScript Identifier Grammar (veja ECMA Script standard). Senão, nomes de tabela ou campos são convertidos a uma string com este formato: "UNSUPPORTED_TABLE_FIELD_TITLE(<virtual structure name>)"

Nota: Se um campo em uma fórmula tiver o mesmo nome que um método de projeto 4D permitido. 4D View Pro vai usar a referência de campo e o método de projeto não vai ser chamado.

Para saber mais sobre referência de campos em fórmulas 4D View Pro, veja Field references.

Ver também

Conversão de documentos 4D View