Utiliza referencias de campo, literales, operadores y funciones para generar fórmulas para campos calculados en Adobe Acrobat Sign.
Introduce fórmulas en la propiedad Fórmula de un campo configurado con tipo de valor > Calculado. Esta referencia describe la sintaxis de expresión disponible para generar esas fórmulas.
Para configurar el campo en sí, consulte Crear un campo calculado.
Generar una fórmula
Una fórmula puede contener uno o más de estos elementos:
| Elemento | Utilícelo para | Ejemplo |
|---|---|---|
| Referencia de campo | Usar un valor de otro campo | precio * cantidad |
| Literal | Incluir un número fijo, valor de texto o fecha | total * 0.10 |
| Operador | Realizar operaciones aritméticas, de comparación o de texto | subtotal + impuestos |
| Función | Realizar un cálculo predefinido u operación lógica | max(value1, value2) |
Las fórmulas también pueden hacer referencia a otros campos calculados.
Hacer referencia a campos por nombre
Utilice el nombre del campo para hacer referencia a su valor en una fórmula.
Por ejemplo:
price * quantity
Utiliza los valores de campos llamados price y quantity.
Si el nombre de un campo contiene espacios, encierra el nombre completo entre corchetes:
[Unit price] * cantidad
Use nombres de campo únicos y significativos para que las fórmulas sigan siendo comprensibles cuando cambie un formulario.
Consulta Propiedades del campo de formulario para conocer los requisitos de nombre de campo.
Usar valores literales
Un literal es un valor fijo incluido directamente en la fórmula.
Algunos ejemplos son:
- Números: 10
- Texto: "Aprobado"
- Fechas utilizadas por las funciones de fecha compatibles
Incluir las cadenas de texto entre comillas simples o dobles.
Por ejemplo:
"Aprobado"
Los valores literales se pueden combinar con campos, operadores y funciones.
Operadores compatibles
Utilizar operadores para realizar cálculos, combinar texto o comparar valores.
| Operador | Operación |
|---|---|
| + | Añadir |
| - | Restar |
| / | Dividir |
| * | Multiplicar |
| & | Combinar cadenas de texto |
| = | Igual a |
| != | No igual a |
| < | Menor que |
| <= | Menor o igual a |
| > | Mayor que |
| >= | Mayor o igual a |
| % | Devolver el resto después de la división |
| ^ | Elevar un valor a una potencia |
Los operadores de comparación devuelven un resultado verdadero o falso y se pueden utilizar dentro de funciones lógicas.
Por ejemplo:
total >= 1000
evalúa si el valor de total es al menos 1000.
Funciones matemáticas
| Función | Resultado |
|---|---|
| abs(number1) | Devuelve el valor absoluto de un número. |
| roundUp(number1) | Redondea un número hacia arriba. |
| roundDown(number1) | Redondea un número hacia abajo. |
| round(number1) | Redondea un número al entero más cercano. |
| min(number1, number2) | Devuelve el menor de dos números. |
| max(number1, number2) | Devuelve el mayor de dos números. |
Ejemplo
max(Amount1, Amount2)
devuelve el que sea mayor de los dos valores de campo.
Funciones de fecha
| Función | Resultado |
|---|---|
| datePart(part, date) | Devuelve una parte especificada de una fecha como un número entero. |
| dateAdd(part, date, addition) | Añade un número especificado de partes de fecha a una fecha. Use un valor negativo para restar. |
| dateDiff(part, date1, date2) | Devuelve la diferencia entre dos fechas usando la parte de fecha especificada. |
| daysIn(part, date) | Devuelve el número de días en la parte especificada de una fecha. |
| date(string) | Convierte un Valor de texto que representa una fecha en un Valor de fecha que puede ser usado por otras funciones. |
| now() | Devuelve la fecha y hora cuando se evalúa la fórmula. |
Valores de partes de fecha
Use estos valores para el argumento de parte en las funciones de fecha compatibles:
| Valor | Parte de fecha u hora |
|---|---|
| y | Año |
| q | Trimestre |
| m | Mes |
| d | Día |
| h | Hora |
| n | Minuto |
| s | Segundo |
Ejemplo
dateAdd("d", StartDate, 30)
añade 30 días al valor del campo StartDate.
Use un número negativo para calcular una fecha anterior:
dateAdd("d", StartDate, -7)
Funciones lógicas
Use funciones lógicas cuando un Valor calculado dependa de una o más condiciones.
| Función | Resultado |
|---|---|
| if(logical_test, value_if_true, value_if_false) | Devuelve un valor cuando la prueba es verdadera y otro cuando es falsa. |
| and(logical1, logical2, ...) | Devuelve verdadero solo cuando todas las condiciones especificadas son verdaderas. |
| or(logical1, logical2, ...) | Devuelve verdadero cuando al menos una condición especificada es verdadera. |
| not(logical) | Invierte un resultado verdadero o falso. |
| lookup(sourceField, values, default_value) | Devuelve un valor asociado con el campo fuente o un valor predeterminado cuando no se encuentra ninguna coincidencia. |
Usa if para elegir entre resultados
Por ejemplo:
if(Total >= 1000, "Approval required", "Approved")
devuelve un valor de texto cuando Total es al menos 1000 y otro cuando no lo es.
Los resultados verdadero y falso pueden contener expresiones.
Combinar condiciones lógicas (and, or, not)
Usa and cuando todas las condiciones deben ser verdaderas:
and(Age >= 18, Consent = "Yes")
Utiliza o cuando cualquier condición puede ser verdadera:
or(State = "CA", State = "OR")
Usa not cuando necesites lo opuesto de una condición:
not(Status = "Closed")
Asignar un Valor a otro con lookup
Usa lookup cuando un Valor fuente debe devolver un Valor correspondiente.
Por ejemplo:
lookup(State, "CA=California,UT=Utah,WA=Washington", "Other")
devuelve el nombre del estado asignado cuando existe una coincidencia y Other cuando no la hay.
Esto es útil cuando el valor fuente proviene de un conjunto definido de opciones, como un campo desplegable o botón de opción.
Ejemplos de fórmulas
Calcular una cantidad
cantidad * [Precio unitario]
Multiplica una cantidad por un precio unitario.
Agregar varios valores
subtotal + impuesto + envío
Suma valores de tres campos.
Calcular un porcentaje
subtotal * tasaImpuesto
Multiplica un campo por una tasa almacenada en otro campo.
Devolver un valor condicionalmente
if(cantidad >= 10, [Precio unitario] * 0.9, [Precio unitario])
devuelve un valor con descuento cuando la cantidad alcanza el umbral definido.
Calcular una fecha futura
dateAdd("m", FechaInicio, 12)
devuelve una fecha 12 meses después de FechaInicio.
Combinar texto
NombreDestinatario & " - " & Compañía
combina valores de campo y texto literal en un resultado.
Generar fórmulas que sean más fáciles de mantener
Utilice nombres de campo descriptivos y mantenga los cálculos relacionados tan simples como permita el formulario.
Al revisar una fórmula, confirme que:
- Todos los campos referenciados existen.
- Los nombres de campo coinciden con los nombres utilizados en la fórmula.
- Los campos que contienen espacios están encerrados entre corchetes.
- Los literales de texto están encerrados entre comillas.
- Las funciones contienen los argumentos requeridos.
- El campo calculado produce el valor previsto para los datos de entrada esperados del destinatario.
Para configurar el campo calculado y dar formato a los resultados numéricos, consulte Crear un campo calculado.
Optimizar tu trabajo con Acrobat Sign
Gestiona y firma documentos online de forma rápida y sencilla.
