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.

Puede controlar cómo se muestran las fórmulas en sus documentos:

• como valores o como referencias
• cuando se muestran como referencias, mostrar el texto fuente, símbolo o nombre.

Por defecto, las fórmulas 4D se muestran como valores. Cuando inserta una fórmula 4D, 4D Write Pro calcula y muestra su valor actual. Si desea saber qué fórmula se utiliza o cual es su nombre, debe mostrarla como una referencia.

Para mostrar las fórmulas como referencias, puede:

• marcar la opción Mostrar referencias en la lista de Propiedades (ver Configurar propiedades Vista), o
• utilizar la acción estándar visibleReferences (ver Expresiones dinámicas), o
• utilizar el comando WP SET VIEW PROPERTIES con el selector wk visible references en True.

Las referencias a fórmulas pueden mostrarse como:

• textos fuente (por defecto)
• símbolos
• nombres

Cuando las fórmulas se muestran como referencias, por defecto el texto fuente de la fórmula aparece en su documento, con un fondo gris por defecto (puede personalizarse utilizando el selector wk formula highlight). 

Por ejemplo, si ha insertado la fecha actual junto con un formato, la fecha se muestra:

Si muestra las fórmulas como referencias, la fuente de la fórmula se muestra:  

Cuando los textos fuente de las fórmulas se muestran en un documento, el diseño puede resultar confuso si se trabaja con plantillas sofisticadas que utilizan tablas, por ejemplo, y cuando las fórmulas son complejas:

En este caso, puede mostrar las referencias a las fórmulas como símbolos , para que el documento sea más compacto:

Para mostrar las referencias de fórmula como símbolos, puede:

• marcar la opción Mostrar fuente de fórmula como símbolo en la lista de Propiedades (ver Configurar propiedades Vista), o
• utilizar la acción estándar displayFormulaAsSymbol (ver Utilizar las acciones estándar 4D Write Pro), o
• utilizar el comando WP SET VIEW PROPERTIES con el selector wk display formula as symbol en True.

Puede asignar nombres a las fórmulas, haciendo que los documentos plantilla 4D Write Pro sean más fáciles de leer y comprender para los usuarios finales. Cuando las fórmulas se muestran como referencias (y no como símbolos) y se ha definido un nombre para una fórmula, se muestra el nombre de la fórmula. 

Por ejemplo, las siguientes referencias de fórmulas se muestran como texto fuente por defecto:

Si asigna nombres de fórmula, se muestran en lugar de textos:

Para asignar un nombre a una fórmula, debe utilizar el comando WP INSERT FORMULA con un parámetro objeto. Por ejemplo:

Nota: sólo las fórmulas en línea pueden tener un nombre (las fórmulas para imágenes ancladas, líneas de ruptura y las fórmulas de fuentes de datos de tablas no pueden tener nombres).

Sea cual sea el modo de visualización de las fórmulas, puede obtener información adicional sobre ellas a través de los consejos que se muestran al pasar el ratón sobre las fórmulas.

• Cuando las fórmulas no tienen nombre, los consejos ofrecen el texto fuente de las fórmulas:
  

• Cuando las fórmulas tienen nombre pero se muestran como valores o como símbolos, el consejo suministra el nombre de las fórmulas:
  
  En este contexto, puede visualizar el texto fuente de la fórmula presionando Ctrl (Windows) o Cmd (macOS) mientras pasa el ratón por encima de la fórmula.

• Cuando las fórmulas tienen nombres y se muestran como nombres, no se muestra ningún consejo por defecto.
  Puede mostrar el texto fuente de la fórmula presionando Ctrl (Windows) o Cmd (macOS) mientras pasa el ratón sobre la fórmula: