Referência de fórmulas - aplicações de tela
Neste artigo, conheça todas as funções disponíveis em aplicações de tela.
As fórmulas em aplicações de tela combinam muitos elementos. Abaixo, encontram-se descritos:
- As funções usam parâmetros, executam uma operação e retornam um valor. Por exemplo, Sqrt(25) devolve 5. As funções são modeladas após as funções do Microsoft Excel. Algumas funções têm efeitos secundários, tais como SubmitForm, que são adequadas apenas numa fórmula de comportamento como Button.OnSelect.
- Os sinais retornam informações sobre o ambiente. Por exemplo, Location devolve as coordenadas GPS atuais do dispositivo. Os sinais não aceitam parâmetros nem têm efeitos secundários.
- As enumerações retornam um valor constante predefinido. Por exemplo, Cor é uma enumeração que tem valores predefinidos para Color.Red, Color.Blue, etc. As enumerações comuns são incluídas aqui; as enumerações específicas de uma função são descritas com a função.
- Operadores nomeados, como ThisItem e Self, fornecem acesso a informações de dentro de um contentor.
Outros elementos incluem:
A
Abs – Valor absoluto de um número.
Aceleração – Lê o sensor de aceleração no seu dispositivo.
Acos – Devolve o arco cosseno de um número, em radianos.
Acot – Devolve a arccotangente de um número, em radianos.
AddColumns– Retorna uma tabela com colunas adicionadas .
E – booleano lógica E. Devolve true se todos os argumentos forem verdadeiros. Também pode utilizar o operador &&.
AIClassify – Classifica o texto em uma ou mais categorias.
AIExtract – Extrai entidades especificadas, como números de registro, números de telefone ou nomes de pessoas.
AIReply – Elabora uma resposta à mensagem que você fornece.
AISentiment – Deteta o sentimento do texto que você fornece.
AISummarize – Resume o texto que você fornece.
AITranslate – Traduz texto de outro idioma.
App – Fornece informações sobre o aplicativo em execução no momento e controle sobre o comportamento do aplicativo.
Asin – Devolve o arco seno de um número, em radianos.
Assert – Avalia como verdadeiro ou falso em um teste.
Como – Nomeia o registro atual em funções de escopo de galeria, formulário e registro, como ForAll, With e Sum.
AsType – Trata uma referência de registro como um tipo de tabela específico.
Atan – Devolve o arco tangente de um número, em radianos.
Atan2 – Devolve o arco tangente com base numa coordenada (x,y), em radianos.
Média – Calcula a média de uma expressão de tabela ou de um conjunto de argumentos.
B
Voltar – Exibe a tela anterior.
Em branco – Retorna um valor em branco que pode ser usado para inserir um valor NULL em um origem de dados.
booleano – Converte uma cadeia de texto, um número ou um valor não tipado em um valor booleano.
C
Calendário – Recupera informações sobre o calendário da localidade atual.
Char – Traduz um código de caráter em uma cadeia de caracteres.
Opções – Retorna uma tabela dos valores possíveis para uma coluna de pesquisa.
Limpar – Exclui todos os dados de uma coleção.
ClearCollect – Exclui todos os dados de uma coleção e, em seguida, adiciona um conjunto de registros.
ClearData – Limpa uma coleção ou todas as coleções de um host de aplicativo, como um dispositivo local.
Clock – Recupera informações sobre o relógio da localidade atual.
Coalesce – Substitui valores em branco , deixando valores não em branco inalterados.
Coletar – Cria uma coleção ou adiciona dados a um origem de dados.
Cor – Define uma propriedade como um valor de cor interno.
ColorFade– Desvanece um valor de cor.
ColorValue – Traduz um nome de CSS cor ou um código hexadecimal para um valor de cor.
Coluna – Recupera nomes e valores de coluna de um tipo de dados objeto sem tipo.
ColumnNames – Recupera nomes e valores de colunas de um tipo de dados objeto sem tipo.
Bússola – Devolve a direção da bússola .
Concat – Concatena cadeias de caracteres em um origem de dados.
Concatenar – Concatena cadeias de caracteres.
Simultânea – Avalia várias fórmulas simultaneamente entre si.
Conexão – Retorna informações sobre sua conexão de rede.
Copiar – Copia texto para a área de transferência no dispositivo onde o aplicativo está a ser executado.
Contagem – Conta os registros da tabela que contêm números.
Cos – Devolve o cosseno de um ângulo especificado em radianos.
Berço – Devolve a cotangente de um ângulo especificado em radianos.
CountA – Conta os registros da tabela que não estão vazios.
CountIf – Conta os registros da tabela que satisfazem uma condição.
CountRows – Conta registros de tabela.
D
DataSourceInfo – Fornece informações sobre um origem de dados.
Data – Devolve um valor de data/hora, com base nos valores de Ano, Mês e Dia .
DateAdd – Adiciona dias, meses, trimestres ou anos a um valor de data/hora.
DateDiff – Subtrai dois valores de data e mostra o resultado em dias, meses, trimestres ou anos.
DateTime – Devolve um valor de data/hora, com base nos componentes de data e hora.
DateTimeValue – Converte uma cadeia de caracteres de data e hora em um valor de data/hora.
DateValue – Converte uma cadeia de caracteres somente data em um valor de data/hora.
Dia – Recupera a parte do dia de um valor de data/hora.
Dec2Hex – Converter um número em uma cadeia de texto hexadecimal.
Defaults – Retorna os valores padrão de um origem de dados.
Graus – Converte radianos em graus.
Desativar – Desativa um sinal, como Localização para ler o GPS.
Distinto – Resume registros de uma tabela, removendo duplicatas.
Download – Baixa um arquivo da Web para o dispositivo local.
DropColumns– Devolve uma tabela com uma ou mais colunas removidas .
E
EDate – Adiciona ou subtrai meses a uma data, sem alterar o dia do mês.
EditForm – Redefine um controle de formulário para edição de um item.
Ativar – Habilita um sinal, como Localização para leitura do GPS.
EncodeHTML – Codifica caracteres que precisam ser escapados para serem usados em um contexto HTML.
EncodeUrl – Codifica caracteres especiais usando codificação de URL.
EndsWith – Verifica se uma cadeia de texto termina com outra cadeia de texto.
EOMonth – Adiciona ou subtrai meses a uma data, retornando o último dia desse mês.
Erro – Crie um erro personalizado ou passe por um erro.
Erros – Fornece informações de erro para alterações anteriores em um origem de dados.
exactin – Verifica se uma cadeia de caracteres de texto está contida em outra cadeia de texto ou tabela, dependendo de maiúsculas e minúsculas. Também usado para verificar se um registo está numa tabela.
Sair – Sai do aplicativo em execução no momento e, opcionalmente, desconecta o utente atual.
Exp – Devolve e elevado a uma potência.
F
Filtrar – Devolve uma tabela filtrada com base num ou mais critérios.
Localizar – Verifica se uma cadeia de caracteres aparece dentro de outra e retorna o local.
Primeiro – Devolve o primeiro registo de uma tabela.
FirstN – Devolve o primeiro conjunto de registos (N registos) de uma tabela.
ForAll – Calcula valores e executa ações para todos os registros de uma tabela.
G
GroupBy – Devolve uma tabela com registos agrupados.
GUID – Converte uma cadeia de caracteres GUID em um valor GUID ou cria um novo valor GUID.
H
HashTags – Extrai as hashtags (#strings) de uma string.
Hex2Dec – Converter uma cadeia de texto hexadecimal em um número.
Host – Fornece informações sobre o host atual que executa o aplicativo.
Hora – Devolve a parte da hora de um valor de data/hora.
I
If – Devolve um valor se uma condição for verdadeira e outro valor se não.
IfError – Deteta erros e fornece um valor alternativo ou executa uma ação.
in – Verifica se uma cadeia de texto está contida em outra cadeia de texto ou tabela, independente de maiúsculas e minúsculas. Também usado para verificar se um registo está numa tabela.
Índice – Devolve um registo de uma tabela com base na posição ordenada.
Int – Arredonda para baixo para o número inteiro mais próximo.
IsBlank – Verifica se há um valor em branco .
IsBlankOrError – Verifica se há um valor ou erro em branco .
IsEmpty – Verifica se há uma tabela vazia.
IsError – Verifica se há um erro.
IsMatch – Verifica uma cadeia de caracteres em relação a um padrão. Podem ser utilizadas expressões regulares.
IsNumeric – Verifica se há um valor numérico.
ISOWeekNum – Devolve o número da semana ISO de um valor de data/hora.
IsToday – Verifica se um valor de data/hora está em algum momento hoje no fuso horário do utente.
IsType – Verifica se uma referência de registro se refere a um tipo de tabela específico.
IsUTCToday – Verifica se um valor de data/hora está em algum momento hoje em Tempo Universal Coordenado (UTC).
J
JSON – Gera uma cadeia de texto JSON para uma tabela, um registro ou um valor.
L
Idioma – Retorna a marca de idioma do utente atual.
Last – Devolve o último registo de uma tabela.
LastN – Devolve o último conjunto de registos (N registos) de uma tabela.
Iniciar – Inicia uma página da Web ou um aplicativo de tela.
Esquerda – Devolve a parte mais à esquerda de uma cadeia de caracteres.
Len – Devolve o comprimento de uma cadeia de caracteres.
Ln – Devolve o registo natural.
LoadData – Carrega uma coleção de um host de aplicativo, como um dispositivo local.
Localização – Devolve a sua localização como uma coordenada de mapa utilizando o Sistema de Posicionamento Global (GPS) e outras informações.
Log – Devolve o logaritmo em qualquer base de um número.
Pesquisar – Procura um único registro em uma tabela com base em um ou mais critérios.
Inferior – Converte letras em uma cadeia de caracteres de texto em todas as letras minúsculas.
M
Match – Extrai uma substring com base em um padrão. Podem ser utilizadas expressões regulares.
MatchAll – Extrai várias substrings com base em um padrão. Podem ser utilizadas expressões regulares.
Max – Valor máximo de uma expressão de tabela ou um conjunto de argumentos.
Mid – Devolve a parte intermédia de uma cadeia de caracteres.
Mín – Valor mínimo de uma expressão de tabela ou de um conjunto de argumentos.
Minuto – Recupera a parte minuto de um valor de data/hora.
Mod – Devolve o restante depois de um dividendo ser dividido por um divisor.
Mês – Recupera a parte do mês de um valor de data/hora.
N
Navigate – Altera a tela exibida.
NewForm – Redefine um controle de formulário para a criação de um item.
Não – booleano lógica NÃO. Devolve true se o respetivo argumento for falso e devolve false se o respetivo argumento for verdadeiro. Também pode utilizar o operador !.
Notificar – Exibe uma mensagem de banner para o utente.
Agora – Devolve o valor de data/hora atual no fuso horário do utilizador.
O
Ou – booleano lógica OU. Devolve true se qualquer um dos respetivos argumentos for verdadeiro. Também pode utilizar o operador ||.
P
Param – Parâmetros de acesso passados para um aplicativo de tela quando iniciado.
elemento principal – Fornece acesso às propriedades de um controle de contentor.
ParseJSON – Converte o documento JSON representado como texto em um valor objeto sem tipo .
Patch – Modifica ou cria um registro em um origem de dados ou mescla registros fora de um origem de dados.
PDF – Exporte conteúdo da tela atual para um objeto para uso em vários cenários.
Pi – Devolve o número π.
PlainText – Remove marcas HTML e XML de uma cadeia de caracteres.
Power – Devolve um número elevado a um power. Também pode utilizar o operador ^.
Adequado – Converte a primeira letra de cada palavra em uma cadeia de caracteres em maiúsculas e converte o restante em minúsculas.
R
Radianos – Converte graus em radianos.
Rand – Devolve um número pseudoaleatório entre 0 e 1.
RandBetween – Devolve um número pseudoaleatório entre dois números.
ReadNFC – Lê uma tag NFC (Near Field Communication).
RecordInfo – Fornece informações sobre um registro de um origem de dados.
Atualizar – Atualiza os registros de um origem de dados.
Relacionar – Relaciona registros de duas tabelas por meio de uma relação um-para-muitos ou muitos-para-muitos.
Remover – Remove um ou mais registros específicos de um origem de dados.
RemoveIf – Remove registros de um origem de dados com base em uma condição.
RenameColumns – Renomeia colunas de uma tabela.
Substituir – Substitui parte de uma cadeia de caracteres por outra cadeia de caracteres, iniciando a posição da cadeia de caracteres.
RequestHide – Oculta um SharePoint formulário.
Redefinir – Redefine um controle de entrada para seu valor padrão, descartando quaisquer alterações do utente.
ResetForm – Redefine um controle de formulário para edição de um item existente.
reverter – Recarrega e limpa erros para os registros de um origem de dados.
RGBA – Retorna um valor de cor para um conjunto de componentes vermelho, verde, azul e alfa.
Direita – Devolve a parte mais à direita de uma cadeia de caracteres.
Redondo – Arredonda para o número mais próximo.
RoundDown – Arredonda para baixo para o maior número anterior.
RoundUp – Arredonda para cima para o menor número seguinte.
S
SaveData – Salva uma coleção em um host de aplicativo, como um dispositivo local.
Pesquisar – Localiza registros em uma tabela que contêm uma cadeia de caracteres em uma de suas colunas.
Segundo – Recupera a segunda parte de um valor de data/hora.
Selecionar – Simula uma ação de seleção em um controle, fazendo com que a fórmula OnSelect seja avaliada.
Self – Fornece acesso às propriedades do controle atual.
Sequência – Gere uma tabela de números sequenciais, útil ao iterar com ForAll.
SendAppNotification (pré-visualização) – Envie uma notificação no aplicativo com ações opcionais para um destinatário.
Set – Define o valor de uma variável global.
SetFocus – Move o foco de entrada para um controle específico.
SetProperty – Simula interações com controles de entrada.
ShowColumns – Retorna uma tabela com apenas colunas selecionadas.
ShowHostInfo – Exibe informações para o utente no aplicativo.
Shuffle – Reordena aleatoriamente os registros de uma tabela.
Pecado – Devolve o seno de um ângulo especificado em radianos.
Ordenar – Devolve uma tabela ordenada com base numa fórmula.
SortByColumns – Devolve uma tabela ordenada com base numa ou mais colunas.
Dividir – Divide uma cadeia de caracteres de texto em uma tabela de substrings.
Sqrt – Devolve a raiz quadrada de um número.
StartsWith – Verifica se uma cadeia de texto começa com outra cadeia de texto.
StdevP – Devolve o desvio padrão dos seus argumentos.
Substituto – Substitui parte de uma cadeia de caracteres por outra cadeia de caracteres, combinando cadeias de caracteres.
SubmitForm – Salva o item em um controle de formulário para o origem de dados.
Soma – Calcula a soma de uma expressão de tabela ou de um conjunto de argumentos.
Switch – Corresponde a um conjunto de valores e, em seguida, avalia uma fórmula correspondente.
T
Tabela – Cria uma tabela temporária.
Tan – Devolve a tangente de um ângulo especificado em radianos.
Texto – Converte qualquer valor e formata um número ou valor de data/hora em uma cadeia de caracteres de texto.
ThisItem – Retorna o registro para o item atual em uma galeria ou controle de formulário.
ThisRecord – Retorna o registro para o item atual em uma função de escopo de registro, como ForAll, With e Sum.
Hora – Devolve um valor de data/hora, com base nos valores de Hora, Minuto e Segundo .
TimeValue – Converte uma cadeia de caracteres somente de tempo em um valor de data/hora.
TimeZoneOffset – Devolve a diferença entre o UTC e a hora local do utilizador em minutos.
Hoje – Devolve o valor apenas de data atual.
Rastreamento – Forneça informações adicionais nos resultados do teste.
Trim – Remove espaços extras das extremidades e do interior de uma cadeia de texto.
TrimEnds – Remove espaços extras das extremidades de uma cadeia de caracteres apenas de texto.
Trunc– Trunca o número apenas para a parte inteira removendo qualquer parte decimal.
U
Desagrupar – Remove um agrupamento.
UniChar – Traduz um código Unicode em uma cadeia de caracteres.
Não relacionar – Relaciona registros de duas tabelas de uma relação um-para-muitos ou muitos-para-muitos.
Update – Substitui um registro em um origem de dados.
UpdateContext – Define o valor de uma ou mais variáveis de contexto da tela atual.
UpdateIf – Modifica um conjunto de registros em um origem de dados com base em uma condição.
Superior – Converte letras em uma cadeia de caracteres de texto em maiúsculas.
Usuário – Retorna informações sobre o utente atual.
UTCNow – Devolve o valor de data/hora atual em Tempo Universal Coordenado (UTC).
UTCToday – Devolve o valor atual apenas de data em Tempo Universal Coordenado (UTC).
V
Validar – Verifica se o valor de uma única coluna ou de um registro completo é válido para um origem de dados.
Value – Converte uma cadeia de caracteres em um número.
VarP – Devolve a variância dos seus argumentos.
ViewForm – Redefine um controle de formulário para exibição de um item existente.
W
Dia da semana – Recupera a parte do dia da semana de um valor de data/hora.
WeekNum – Devolve o número da semana de um valor de data/hora.
Com – Calcula valores e executa ações para um único registro, incluindo registros embutidos de valores nomeados.
Y
Ano – Recupera a parte do ano de um valor de data/hora.