Skip to content

Funciones en plantillas de documentos

Las funciones se pueden usar al formatear automáticamente documentos mediante plantillas. Las funciones simplifican cómo se muestran los datos en sus documentos. Por ejemplo, puede usar fórmulas para mostrar números como palabras automáticamente o calcular el coste de un pedido.

Fórmulas

Para agregar una fórmula a un documento, utilice la siguiente sintaxis: %%%FORMULA%%%.

Una FORMULA es una expresión para calcular el valor de un campo, al igual que en un campo calculado.

Ejemplo:

%%%TEXT({{DataTag.Service.Quantity}}*{{DataTag.Service.Cost}};".2f")%%%

En el ejemplo anterior, los datos de la etiqueta de datos "Service" se añaden a la fórmula usando las variables correspondientes. Los dos valores se multiplican y el resultado es el valor del coste total de un servicio o producto específico. La función TEXT() formatea el valor como una cadena de texto legible para humanos.

Importante

Por ejemplo:

  • Las fórmulas deben escribirse en una sola cadena y no se pueden dividir pulsando Enter. Si necesita insertar un salto de línea, use la secuencia "\n".
  • Sin un salto de línea
%%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{Datatag.Service calculation.Quantity}} + " " + {{Datatag.Service calculation."Unit"}} + " (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
  • Con un salto de línea
%%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{atatag.Service calculation.Quantity}} + " " + {{{Datatag.Service calculation."Unit"}} + "\n (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
  • Las variables en la fórmula no pueden tener formato, por ejemplo, en negrita o cursiva.
  • Si desea que el resultado de la fórmula aparezca en negrita, aplique el formato a toda la fórmula, incluidos los símbolos de porcentaje.

Funciones

Todas las funciones disponibles en las fórmulas de plantillas de documentos:

La función SUM

SUM() es una función que suma todos los valores obtenidos al calcular una fórmula. Se aplica a cada elemento de una variable multiplicadora.

Por ejemplo, supongamos que tiene una etiqueta de datos "Service" y desea calcular el coste total de todos los servicios en un documento. Usaría la siguiente función: 

SUM({{DataTag.Service.Cost}})

Para obtener el coste total de los servicios prestados, debe multiplicar el coste del servicio por la cantidad pedida. Esta es la fórmula que debe usar en su documento: 

SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}))

Tenga en cuenta que la función SUM() puede contener cualquier fórmula compuesta por funciones.

La función PLURALFORM

Se usa para añadir un sufijo a una palabra o para cambiar la propia palabra si es un sustantivo irregular, en función del número indicado antes de ella en la plantilla del documento.

Formato: 

PLURALFORM(number; "text1"; "text2";)

Dependiendo del valor calculado del número, la función selecciona uno de los dos parámetros. Los parámetros deben especificarse en orden estricto según el algoritmo.

Por ejemplo, necesita flexionar la palabra "dollar". Siga el algoritmo:

Primero, escriba la palabra requerida con el número 1:

  • 1 dollar

Esto significa que el primer parámetro en la función "debe ser la palabra "dollar" en lugar de "text1".

Luego, escriba la palabra con el número 2:

  • 2 dollars

Esto significa que el segundo parámetro en la función "debe ser la palabra "dollars" en lugar de "text2".

Finalmente, puede especificar la siguiente función PLURALFORM() en el documento:

PLURALFORM(SUM({{Datatag.Service.Cost}}*{{Datatag.Service.Quantity}}); "dollar"; "dollars")

La función NUMBERASWORDS

Es una función que devuelve un número en palabras. Solo se escribe la parte entera del número.

Formato: 

NUMBERASWORDS(number; Output; "language")

Donde:

  • number — es un número o fórmula
  • Output — define cómo se mostrará el numeral (de 0 a 6)
  • language — cadena que especifica el idioma de salida. Si se deja vacío (""), se usa el idioma del usuario que genera el documento.

Idiomas y sus métodos de Output:

  • Inglés ("en")
    • 0-3 — predeterminado (número cardinal)
    • 4-6 — predeterminado con mayúscula
  • Alemán ("de")
    • 0 — predeterminado (neutro en cuanto al género)
    • 1 — escrito en femenino
    • 2 — escrito en masculino
    • 3 — escrito en neutro
    • 4 — capitalizado en femenino
    • 5 — capitalizado en masculino
    • 6 — capitalizado en neutro
  • Francés ("fr")
    • 0 — predeterminado (número cardinal)
    • 1 — escrito en femenino
    • 2 — escrito en masculino
    • 4 — capitalizado en femenino
    • 5 — capitalizado en masculino

Por ejemplo, para mostrar un número en palabras en un documento, use la siguiente función: 

NUMBERASWORDS(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2; "en")

La función FRACTIONALPART

Esta función muestra la parte fraccionaria de un número. Puede especificar el número de dígitos después del punto decimal que desea ver.

Formato: 

FRACTIONALPART(number; NumberOfDigitsAfterDecimal)

Por ejemplo, para mostrar el número de céntimos del coste de un servicio en un documento, use la siguiente función: 

FRACTIONALPART(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2)

Esta función muestra los dos dígitos después del punto decimal:

  • 176.03 — la función devuelve 03.
  • 15.15 — la función devuelve 15.
  • 16.156 — la función redondea los dos primeros decimales a 16.

Ir a

Obtenido de «http://planfix.com/es/help/index.php?title=Funciones_en_plantillas_de_documentos&oldid=2090»