Los documentos 4D Write Pro pueden contener referencias a fórmulas 4D tales como variables, campos, expresiones, métodos proyecto, o comandos 4D. Variables específicas como el número de página también se pueden referenciar (ver Insertar expresiones de documento y de página abajo).

La inserción de fórmulas en áreas 4D Write Pro se realiza con el comando WP INSERT FORMULA y se pueden leer con el comando WP Get formulas. También se devuelven por el comando WP Get text.

Se evalúan las fórmulas:

• cuando se insertan en un objeto de formulario que muestra valores calculados
• cuando el objeto 4D Write Pro se carga en un objeto de formulario que muestra valores calculados
• cuando se llama al comando WP COMPUTE FORMULAS
• cuando están "congelados" utilizando el comando WP FREEZE FORMULAS (si aún no se ha calculado)
• antes de imprimir (si aún no se ha calculado)
• antes de exportar a .docx (si la fórmula no se puede asignar con fórmulas de MS Word)
• cuando se llaman las acciones estándar para congelar, imprimir, exportar o calcular fórmulas. Ver Acciones estándar.

Las fórmulas no se evalúan cuando se carga un documento (utilizando WP New, WP INSERT DOCUMENT o wpArea:=[table]field):

• si el documento solo está fuera de pantalla,
• si el documento se muestra en pantalla pero el objeto de formulario solo muestra referencias.

Las fórmulas se convierten en valores estáticos si llama al comando WP FREEZE FORMULAS (excepto por el número de página y el recuento de páginas, ver abajo).

Nota de compatibilidad: el manejo de expresiones utilizando los comandos ST INSERT EXPRESSION, ST Get expression, ST COMPUTE EXPRESSIONS y ST FREEZE EXPRESSIONS es obsoleto, sin embargo, aún es soportado en 4D Write Pro por razones de compatibilidad.

Usted quiere reemplazar la selección en un área 4D Write Pro con el contenido de una variable:

Puede insertar expresiones especiales relacionadas con atributos documentos o atributos página en toda área de documento (cuerpo, encabezado, pie) utilizando el comando WP INSERT FORMULA.

(*) Importante: This .pageNumber y This .pageCount deben utilizarse solo directamente en una fórmula 4D Write Pro (deben estar presentes en la cadena formula.source). Devolverán valores incorrectos si son utilizados por el lenguaje 4D dentro de un método llamado por la fórmula. Sin embargo, se pueden pasar como parámetros a un método llamado directamente por la fórmula:

• Esto funcionará: « formatNumber(This.pageNumber) »
• Esto NO funcionará: « formatNumber » con el método formatNumber procesando This.pageNumber.

Por ejemplo, para insertar el número de página en el área de pie de página:

Nota de compatibilidad: las variables $wp_ variables en documentos de versiones anteriores a 4D v18 R2 aún se soportan y evalúan.

Fecha

Cuando el comando Current date, una variable fecha o un método que devuelve una fecha se inserta en una fórmula, se transformará automáticamente en texto utilizando el formato corto de fecha del sistema.

Hora

Cuando el comando Current time, una variable tiempo o un método que devuelve un tiempo se inserta en una fórmula, debe incluirse dentro de un comando String porque el tipo de tiempo no es soportado en JSON. Considere los siguientes ejemplos de fórmulas:

Las expresiones de tabla y campo insertadas en documentos 4D Write Pro soportan la definición de estructura virtual de la base. La estructura virtual expuesta a las fórmulas se define mediante los comandos SET FIELD TITLES(...;*) y SET TABLE TITLES(...;*).

Cuando se define una estructura virtual:

• las referencias a expresiones que contienen campos muestran nombres virtuales cuando el documento 4D Write Pro muestra referencias y no valores.
• WP Get text devuelve los nombres de la estructura virtual si la opción wk expressions as source está definida en el parámetro expresiones.
• WP INSERT FORMULA ignora la estructura virtual y siempre espera nombres reales de tabla/campo.

Nota: cuando se muestra un documento en el modo "expresiones de visualización", las referencias a tablas o campos que no pertenecen a la estructura virtual se muestran con "?" caracteres, por ejemplo [VirtualTableName]? cuando el campo no está definido en la estructura virtual.