Referencia de fórmula: aplicaciones de lienzo
En este artículo, conozca todas las funciones disponibles en aplicaciones de lienzo.
Las fórmulas en aplicaciones de lienzo combinan numerosos elementos. A continuación se enumera lo siguiente:
- Las funciones toman parámetros, realizan una operación y devuelven un valor. Por ejemplo, Sqrt(25) devuelve 5. Las funciones se modelan basadas en funciones de Microsoft Excel. Algunas funciones tienen efectos secundarios, como SubmitForm, y solo son adecuadas en una fórmula de comportamiento como Button.OnSelect.
- Las señales devuelven información sobre el entorno. Por ejemplo, Location devuelve las coordenadas GPS actuales del dispositivo. Las señales no toman parámetros ni tienen efectos secundarios.
- Las enumeraciones devuelven un valor constante predefinido. Por ejemplo, Color es una enumeración que tiene valores predefinidos para Color.Red, Color.Blue, etc. Aquí se incluyen enumeraciones comunes; las enumeraciones específicas de funciones se describen con la función.
- Los operadores con nombre, como ThisItem y Self, proporcionan acceso a información desde un contenedor.
Otros elementos incluyen:
A
Abs: valor absoluto de un número.
Acceleration: lee el sensor de aceleración del dispositivo.
Acos: devuelve el arco coseno de un número, en radianes.
Acot: devuelve el arco tangente de un número, en radianes.
AddColumns: devuelve una tabla con columnas agregadas.
And: lógica booleana Y. Devuelve true si todos los argumentos son true. También puede usar el operador &&.
AIClassify – clasifica el texto en una o más de las categorías.
AIExtract – extrae entidades específicas, como números de registro, números de teléfono o nombres de personas.
AIReply – redacta una respuesta al mensaje que proporcione.
AISentiment – detecta el sentimiento del texto que proporcionas.
AISummarize – resume el texto que usted proporciona.
AITranslate – traduce texto de otro idioma.
App: proporciona información sobre la aplicación en ejecución y el control sobre el comportamiento de esta.
Asin: devuelve el arco seno de un número, en radianes.
Assert: se evalúa como "true" o "false" en una prueba.
As: designa el registro actual en funciones de galería, formulario y ámbito de registro, como ForAll, With y Sum.
AsType: trata una referencia del registro como un tipo de tabla específico.
Atan: devuelve el arco tangente de un número, en radianes.
Atan2: devuelve el arco tangente en función de una coordenada (x,y), en radianes.
Average: calcula la media de una expresión de tabla o un conjunto de argumentos.
B
Back: muestra la pantalla anterior.
Blank: devuelve un valor blank que puede utilizarse para insertar un valor NULL en un origen de datos.
Boolean: convierte una cadena de texto, un número o un valor sin tipo en un valor booleano.
C
Calendar: recupera información sobre el calendario para la configuración regional actual.
Char: traduce un código de carácter en una cadena.
Choices: devuelve una tabla de posibles valores para una columna de búsqueda.
Clear: elimina todos los datos de una colección.
ClearCollect: elimina todos los datos de una colección y, después, agrega un conjunto de registros.
ClearData: borra una colección o todas las colecciones del host de una aplicación, como un dispositivo local.
Clock: recupera información sobre el reloj para la configuración regional actual.
Coalesce: reemplaza valores blank y deja los valores que no son blank.
Collect: crea una colección o agrega datos a un origen de datos.
Color: establece una propiedad en un valor de color integrado.
ColorFade: atenúa un valor de color.
ColorValue: traduce un nombre de color CSS o un código hexadecimal en un valor de color.
Column – Recupera nombres de columnas y valores de un tipo de datos de objeto sin tipo.
ColumnNames – Recupera nombres de columnas y valores de un tipo de datos de objeto sin tipo.
Compass: devuelve el encabezado de brújula.
Concat: concatena cadenas en un origen de datos.
Concatenate: concatena cadenas.
Concurrent: evalúa varias fórmulas simultáneamente entre sí.
Connection: devuelve información sobre la conexión de red.
Copy - Copia texto al portapapeles en el dispositivo donde se ejecuta la aplicación.
Count: cuenta los registros de la tabla que contienen números.
Cos: devuelve el coseno de un ángulo especificado en radianes.
Cot: devuelve la cotangente de un ángulo especificado en radianes.
CountA: cuenta los registros de la tabla que no están vacíos.
CountIf: cuenta los registros de la tabla que cumplen una condición.
CountRows: cuenta los registros de la tabla.
D
DataSourceInfo: proporciona información sobre un origen de datos.
Date: devuelve un valor de fecha y hora en función de los valores Year, Month y Day.
DateAdd: agrega días, meses, trimestres o años a un valor de fecha y hora.
DateDiff: resta dos valores de fecha y muestra el resultado en días, meses, trimestres o años.
DateTime: devuelve un valor de fecha y hora, en función de los componentes de fecha y hora.
DateTimeValue: convierte una cadena de fecha y hora en un valor de fecha y hora.
DateValue: convierte una cadena de fecha en un valor de fecha y hora.
Day: recupera la parte de día de un valor de fecha y hora.
Dec2Hex: convierte un número en una cadena de texto hexadecimal.
Defaults: devuelve los valores predeterminados para un origen de datos.
Degrees: convierte radianes en grados.
Disable: deshabilita una señal, como Location para leer el GPS.
Distinct: resume los registros de una tabla, para lo que quita los duplicados.
Download: descarga un archivo de la Web en el dispositivo local.
DropColumns: devuelve una tabla a la que se han quitado una o varias columnas.
E
EDate: suma o resta meses a una fecha, sin cambiar el día del mes.
EditForm: restablece un control Form para la edición de un elemento.
Enable: habilita una señal, como Location para leer el GPS.
EncodeHTML: codifica caracteres que deben tener escape para usarse en un contexto HTML.
EncodeUrl: codifica caracteres especiales mediante la codificación de la dirección URL.
EndsWith: comprueba si una cadena de texto termina con otra cadena de texto.
EOMonth: suma o resta meses a una fecha y devuelve el último día de ese mes.
Error: crea un error personalizado o pasa un error.
Errors: proporciona información de error para los cambios anteriores en un origen de datos.
exactin: comprueba si una cadena de texto está contenida en otra cadena de texto o tabla, distinguiendo mayúsculas de minúsculas. También se utiliza para comprobar si un registro está en una tabla.
Exit: sale de la aplicación actualmente en ejecución y opcionalmente cierra la sesión del usuario actual.
Exp: devuelve e elevado a una potencia.
F
Filter: devuelve una tabla filtrada en función de uno o varios criterios.
Find: comprueba si una cadena aparece dentro de otra y devuelve la ubicación.
First: devuelve el primer registro de una tabla.
FirstN: devuelve el primer conjunto de registros (registros N) de una tabla.
ForAll: calcula valores y realiza acciones para todos los registros de una tabla.
G
GroupBy: devuelve una tabla con los registros agrupados.
GUID: convierte una cadena de GUID en un valor GUID o crea un valor GUID.
H
HashTags: extrae los hashtags (#strings) de una cadena.
Hex2Dec: convierte una cadena de texto hexadecimal en un número.
Host - Proporciona información sobre el host actual que ejecuta la aplicación.
Hour: devuelve la parte de hora de un valor de fecha y hora.
I
If: devuelve un valor si una condición es true y otro valor si no lo es.
IfError: detecta errores y proporciona un valor alternativo o lleva a cabo una acción.
in: comprueba si una cadena de texto está contenida en otra cadena de texto o tabla, sin distinguir mayúsculas de minúsculas. También se utiliza para comprobar si un registro está en una tabla.
Index: devuelve un registro de una tabla en función de la posición ordenada.
Int: redondea al entero más cercano.
IsBlank: busca un valor blank.
IsBlankOrError: comprueba un valor blanco o error.
IsEmpty: busca una tabla vacía.
IsError: comprueba un error.
IsMatch: comprueba una cadena con un patrón. Se pueden usar expresiones regulares.
IsNumeric: busca un valor numérico.
ISOWeekNum: devuelve el número de semana ISO de un valor de fecha / hora.
IsToday: comprueba si un valor de fecha/hora es en algún momento de hoy en la zona horaria del usuario.
IsType: comprueba si una referencia del registro hace referencia a un tipo de tabla específico.
IsUTCToday: comprueba si un valor de fecha/hora es en algún momento de hoy en tiempo universal coordinado (UTC).
J
JSON: genera una cadena de texto JSON para una tabla, un registro o un valor.
L
Language: devuelve la etiqueta de idioma del usuario actual.
Last: devuelve el último registro de una tabla.
LastN: devuelve el último conjunto de registros (registros N) de una tabla.
Launch: inicia una página web o una aplicación de lienzo.
Left: devuelve la parte del extremo izquierdo de una cadena.
Len: devuelve la longitud de una cadena.
Ln: devuelve el logaritmo natural.
LoadData: carga una colección desde el host de una aplicación, como un dispositivo local.
Location: devuelve la ubicación como una coordinada de mapa mediante el sistema de posicionamiento global (GPS) y otra información.
Log: devuelve el logaritmo en cualquier base de un número.
LookUp: busca un único registro en una tabla en función de uno o varios criterios.
Lower: convierte todas las letras de una cadena de texto en minúsculas.
M
Match: extrae una subcadena basada en un patrón. Se pueden usar expresiones regulares.
MatchAll: extrae varias subcadenas basadas en un patrón. Se pueden usar expresiones regulares.
Max: valor máximo de una expresión de tabla o un conjunto de argumentos.
Mid: devuelve la parte media de una cadena.
Min: valor mínimo de una expresión de tabla o un conjunto de argumentos.
Minute: recupera la parte de minuto de un valor de fecha y hora.
Mod: devuelve el resto después de que un dividendo se divida entre un divisor.
Month: recupera la parte de mes de un valor de fecha y hora.
N
Navigate: cambia la pantalla que se muestra.
NewForm: restablece un control Form para la creación de un elemento.
Not: lógica booleana NO. Devuelve true si su argumento es false y devuelve false si su argumento es true. También puede usar el operador !.
Notify: muestra un mensaje de pancarta al usuario.
Now: devuelve el valor de fecha/hora actual en la zona horaria del usuario.
O
Or: lógica booleana O. Devuelve true si alguno de sus argumentos es true. También puede usar el operador ||.
P
Param: parámetros de acceso pasados a una aplicación de lienzo cuando se inicia.
Parent: proporciona acceso a las propiedades de un control contenedor.
ParseJSON: convierte el documento JSON representado como texto en un valor de Objeto Untyped.
Patch: modifica o crea un registro en un origen de datos, o bien combina registros fuera de un origen de datos.
PDF - Exporta contenido de la pantalla actual a un objeto para usarlo en múltiples escenarios.
Pi: devuelve el número π.
PlainText: quita las etiquetas HTML y XML de una cadena.
Power: devuelve un número elevado a una potencia. También puede usar el operador ^.
Proper: convierte la primera letra de cada palabra de una cadena en mayúsculas y el resto en minúsculas.
R
Radians: convierte grados en radianes.
Rand: devuelve un número pseudoaleatorio entre 0 y 1.
RandBetween: devuelve un número pseudoaleatorio entre dos números.
ReadNFC: lee una etiqueta de comunicación de campo cercano (NFC).
RecordInfo: proporciona información sobre un registro o una fuente de datos.
Refresh: actualiza los registros de un origen de datos.
Relate: relaciona los registros de dos tablas mediante una relación de uno a varios o de varios a varios.
Remove: quita uno o más registros específicos de un origen de datos.
RemoveIf: elimina los registros de un origen de datos en función de una condición.
RenameColumns: cambia el nombre de las columnas de una tabla.
Replace: reemplaza parte de una cadena por otra cadena, por posición inicial de la cadena.
RequestHide: oculta un formulario de SharePoint.
Reset: restablece un control de entrada al valor predeterminado, descartando cualquier modificación del usuario.
ResetForm: restablece un control Form para la edición de un elemento existente.
Revert: recarga y borra errores para los registros de un origen de datos.
RGBA: devuelve un valor de color para un conjunto de componentes rojo, verde, azul y alfabético.
Right: devuelve la parte del extremo derecho de una cadena.
Round: redondea al número más cercano.
RoundDown: redondea hacia abajo al número anterior más grande.
RoundUp: redondea hacia arriba al siguiente número más pequeño.
S
SaveData – Guarda una colección en el host de una aplicación, como un dispositivo local.
Search: busca registros en una tabla que contengan una cadena en una de sus columnas.
Second: recupera la parte de segundo de un valor de fecha y hora.
Select: simula una acción de selección en un control, lo que provoca la evaluación de la fórmula OnSelect.
Self: ofrece acceso a las propiedades del control actual.
Sequence: generar una tabla de números secuenciales, lo que puede resultar útil al iterar con ForAll.
SendAppNotification (versión preliminar): envíe una notificación en la aplicación con acciones opcionales a un destinatario.
Set: establece el valor de una variable global.
SetFocus: mueve el foco de entrada a un control específico.
SetProperty: simula interacciones con controles de entrada.
ShowColumns: devuelve una tabla exclusivamente con las columnas seleccionadas.
ShowHostInfo: muestra información al usuario en la aplicación.
Shuffle: reordena aleatoriamente los registros de una tabla.
Sin: devuelve el seno de un ángulo especificado en radianes.
Sort: devuelve una tabla ordenada en función de una fórmula.
SortByColumns: devuelve una tabla ordenada en función de una o varias columnas.
Split: divide una cadena de texto en una tabla de subcadenas.
Sqrt: devuelve la raíz cuadrada de un número.
StartsWith: comprueba si una cadena de texto comienza con otra cadena de texto.
StdevP: devuelve la desviación estándar de sus argumentos.
Substitute: reemplaza parte de una cadena por otra cadena, por coincidencia de cadenas.
SubmitForm: guarda el elemento en un control Form para el origen de datos.
Sum: calcula la suma de una expresión de tabla o un conjunto de argumentos.
Switch: busca la coincidencia con un conjunto de valores y luego evalúa una fórmula correspondiente.
T
Table: crea una tabla temporal.
Tan: devuelve la tangente de un ángulo especificado en radianes.
Text: convierte cualquier valor y da formato de cadena de texto a un número o valor de fecha y hora.
ThisItem: devuelve el registro del elemento actual en un control Gallery o Form.
ThisRecord: devuelve el registro del elemento actual en una función de ámbito de registros, como ForAll, With y Sum.
Time: devuelve un valor de fecha y hora, en función de los valores Hour, Minute y Second.
TimeValue: convierte una cadena de hora en un valor de fecha y hora.
TimeZoneOffset: devuelve la diferencia entre la hora UTC y la hora local del usuario en minutos.
Today: devuelve el valor de solo fecha actual.
Trace: proporciona información adicional en los resultados de las pruebas.
Trim: quita los espacios adicionales de los extremos y el interior de una cadena de texto.
TrimEnds: quita los espacios adicionales únicamente de los extremos de una cadena de texto.
Trunc: Trunca el número a la parte entera eliminando cualquier parte decimal.
U
Ungroup: quita una agrupación.
UniChar: traduce un código Unicode en una cadena.
Unrelate: anula la relación de dos tablas de dos entidades de una relación de uno a varios o de varios a varios.
Update: reemplaza un registro en un origen de datos.
UpdateContext: establece el valor de una o varias variables de contexto de la pantalla actual.
UpdateIf: modifica un conjunto de registros en un origen de datos en función de una condición.
Upper: convierte todas las letras de una cadena de texto en mayúsculas.
User: devuelve información sobre el usuario actual.
UTCNow: devuelve el valor de fecha/hora actual en hora universal coordinada (UTC).
UTCToday: devuelve el valor actual de solo fecha en hora universal coordinada (UTC).
V
Validate: comprueba si el valor de una sola columna o un registro completo es válido para un origen de datos.
Value: convierte una cadena en un número.
VarP: devuelve la varianza de sus argumentos.
ViewForm: restablece un control Form para la visualización de un elemento existente.
W
Weekday: recupera la parte de día de la semana de un valor de fecha y hora.
WeekNum: devuelve el número de semana de un valor de fecha / hora.
With: calcula valores y realiza acciones para un único registro, incluidos los registros insertados de valores con nombre.
Y
Year: recupera la parte de año de un valor de fecha y hora.