Compartilhar via


Referência de fórmula - aplicativos de tela

Neste artigo, conheça todas as funções disponíveis nos aplicativos de tela.

As fórmulas nos aplicativos de tela combinam vários elementos. São mostrados abaixo:

  • Funções recebem parâmetros, executam uma operação e retornam um valor. Por exemplo, Sqrt(25) retorna 5. As funções são modeladas de acordo com as funções do Microsoft Excel. Algumas funções têm efeitos colaterais, como SubmitForm, que são apropriadas apenas em uma fórmula de comportamento, como Button.OnSelect.
  • Os sinais retornam informações sobre o ambiente. Por exemplo, Location retorna as coordenadas de GPS atuais do dispositivo. Sinais não usam parâmetros nem têm efeitos colaterais.
  • Enumerações retornam um valor constante predefinido. Por exemplo, Color é uma enumeração que tem valores predefinidos para Color.Red, Color.Blue e assim por diante. As enumerações comuns são incluídas aqui; enumerações específicas de função são descritas com a função.
  • Operadores nomeados, como ThisItem e Self, fornecem acesso a informações de dentro de um contêiner.

Outros elementos incluem:

A

Abs – Valor absoluto de um número.

Aceleração – Lê o sensor de aceleração do seu dispositivo.

Acos – Retorna o arco cosseno de um número, em radianos.

Acot – Retorna o arco-tangente de um número, em radianos.

AddColumns – Retorna uma tabela com colunas adicionadas.

E – booliano lógica E. Retornará true se todos os argumentos forem true. Você também pode usar 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 – Esboça uma resposta para a mensagem que você fornece.

AISentiment – Detecta o sentimento do texto que você fornece.

AISummarize – Resume o texto que você fornece.

AITranslate – Traduz texto de outro idioma.

Aplicativo – Fornece informações sobre o aplicativo em execução no momento e controle sobre o comportamento do aplicativo.

Asin – Retorna 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 galeria, formulário e escopo de registro, como ParaTodos, Com e Soma.

AsType – Trata uma referência de registro como um tipo de tabela específico.

Atan – Retorna o arco tangente de um número, em radianos.

Atan2 – Retorna o arco tangente com base em uma 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.

Blank – Retorna um valor em branco que pode ser usado para inserir um valor NULL em um fonte de dados.

booliano – Converte uma sequência de texto, número ou valor não digitado em um valor booliano.

C

Calendário – Recupera informações sobre o calendário para o local atual.

Char – Traduz um código de caractere em uma string.

Choices – 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 então 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 para o local atual.

Coalescer – Substitui valores em branco , deixando valores nãoem branco inalterados.

Coletar – Cria uma coleção ou adiciona dados a um fonte de dados.

Cor – Define uma propriedade para um valor de cor integrado.

ColorFade – Desvanece um valor de cor.

ColorValue – Traduz um CSS nome de cor ou um código hexadecimal para um valor de cor.

Coluna – Recupera nomes e valores de colunas 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 – Retorna a direção da sua bússola.

Concat – Concatena strings em um fonte de dados.

Concatenar – Concatena strings.

Concorrente – Avalia várias fórmulas simultaneamente.

Conexão – Retorna informações sobre sua conexão de rede.

Copiar – Copia o texto para a área de transferência no dispositivo onde o aplicativo está sendo executado.

Contagem – Conta registros de tabela que contêm números.

Cos – Retorna o cosseno de um ângulo especificado em radianos.

Cot – Retorna a cotangente de um ângulo especificado em radianos.

CountA – Conta registros de 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 fonte de dados.

Data – Retorna 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 – Retorna um valor de data/hora, com base nos componentes de data e hora.

DateTimeValue – Converte uma sequência de data e hora em um valor de data/hora.

DateValue – Converte uma string somente de data em um valor de data/hora.

Dia – Recupera a parte do dia de um valor de data/hora.

Dec2Hex – Converte um número em uma sequência de texto hexadecimal.

Defaults – Retorna os valores padrão para um fonte de dados.

Graus – Converte radianos em graus.

Desativar – Desativa um sinal, como Localização para leitura do GPS.

Distinct – Resume registros de uma tabela, removendo duplicatas.

Download – Baixa um arquivo da web para o dispositivo local.

DropColumns – Retorna 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.

Habilitar – 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 sequência de texto termina com outra sequência de texto.

EOMonth – Adiciona ou subtrai meses de 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 fonte de dados.

exactin – Verifica se uma sequência de texto está contida em outra sequência de texto ou tabela, dependendo de maiúsculas e minúsculas. Também é usado para verificar se um registro está em uma tabela.

Sair – Sai do aplicativo em execução no momento e, opcionalmente, desconecta o usuário atual.

Exp – Retorna e elevado a uma potência.

F

Filter – Retorna uma tabela filtrada com base em um ou mais critérios.

Find – Verifica se uma string aparece dentro de outra e retorna a localização.

First – Retorna o primeiro registro de uma tabela.

FirstN – Retorna o primeiro conjunto de registros (N registros) de uma tabela.

ForAll – Calcula valores e executa ações para todos os registros de uma tabela.

G

GroupBy – Retorna uma tabela com registros agrupados.

GUID – Converte uma string GUID em um valor GUID ou cria um novo valor GUID.

H

HashTags – Extrai as hashtags (#strings) de uma string.

Hex2Dec – Converte uma sequência de texto hexadecimal em um número.

Host – Fornece informações sobre o host atual que executa o aplicativo.

Hora – Retorna a parte da hora de um valor de data/hora.

I

If – Retorna um valor se uma condição for verdadeira e outro valor se não for.

IfError – Detecta erros e fornece um valor alternativo ou toma medidas.

in – Verifica se uma sequência de texto está contida em outra sequência de texto ou tabela, independentemente de maiúsculas e minúsculas. Também é usado para verificar se um registro está em uma tabela.

Índice – Retorna um registro de uma tabela com base na posição ordenada.

Int – Arredonda para baixo para o inteiro mais próximo.

IsBlank – Verifica se há um valor em branco .

IsBlankOrError – Verifica se há um valor em branco ou erro.

IsEmpty – Verifica se há uma tabela vazia.

IsError – Verifica se há um erro.

IsMatch – Verifica uma string em relação a um padrão. Expressões regulares podem ser usadas.

IsNumeric – Verifica se há um valor numérico.

ISOWeekNum – Retorna o número da semana ISO de um valor de data/hora.

IsToday – Verifica se um valor de data/hora é algum momento de hoje no fuso horário do usuário.

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 é algum momento de hoje no Tempo Universal Coordenado (UTC).

J

JSON – Gera uma string de texto JSON para uma tabela, um registro ou um valor.

L

Idioma – Retorna a tag de idioma do usuário atual.

Último – Retorna o último registro de uma tabela.

LastN – Retorna o último conjunto de registros (N registros) de uma tabela.

Iniciar – Inicia uma página da web ou um aplicativo de tela.

Left – Retorna a porção mais à esquerda de uma string.

Len – Retorna o comprimento de uma string.

Ln – Retorna o logaritmo natural.

LoadData – Carrega uma coleção de um host de aplicativo, como um dispositivo local.

Localização – Retorna sua localização como uma coordenada de mapa usando o Sistema de Posicionamento Global (GPS) e outras informações.

Log – Retorna o logaritmo em qualquer base de um número.

LookUp – Pesquisa um único registro em uma tabela com base em um ou mais critérios.

Inferior – Converte todas as letras de uma sequência de texto em minúsculas.

M

Match – Extrai uma substring com base em um padrão. Expressões regulares podem ser usadas.

MatchAll – Extrai várias substrings com base em um padrão. Expressões regulares podem ser usadas.

Max – Valor máximo de uma expressão de tabela ou de um conjunto de argumentos.

Mid – Retorna a parte do meio de uma string.

Min – Valor mínimo de uma expressão de tabela ou de um conjunto de argumentos.

Minuto – Recupera a parte do minuto de um valor de data/hora.

Mod – Retorna o resto após um dividendo ser dividido por um divisor.

Mês – Recupera a parte do mês de um valor de data/hora.

N

Navegar – Altera qual tela é exibida.

NewForm – Redefine um controle de formulário para criação de um item.

Não – booliano lógica NÃO. Retornará true se o argumento for false e retornará false se o argumento for true. Você também pode usar o operador !.

Notificar – Exibe uma mensagem de banner para o usuário.

Now – Retorna o valor de data/hora atual no fuso horário do usuário.

O

Ou – booliano lógica OU. Retorna true se qualquer um dos argumentos for true. Você também pode usar o operador ||.

P

Param – Parâmetros de acesso passados para um aplicativo Canvas quando iniciado.

pai – Fornece acesso às propriedades de um controle de contêiner.

ParseJSON – Converte o documento JSON representado como texto em um valor objeto sem tipo .

Patch – Modifica ou cria um registro em um fonte de dados, ou mescla registros fora de um fonte de dados.

PDF – Exporte conteúdo da tela atual para um objeto para uso em vários cenários.

Pi – Retorna o número π.

PlainText – Remove tags HTML e XML de uma string.

Potência – Retorna um número elevado a uma potência. Você também pode usar o operador ^.

Adequado – Converte a primeira letra de cada palavra em uma string para maiúscula e converte o restante para minúscula.

R

Radianos – Converte graus em radianos.

Rand – Retorna um número pseudoaleatório entre 0 e 1.

RandBetween – Retorna um número pseudoaleatório entre dois números.

ReadNFC – Lê uma tag Near Field Communication (NFC).

RecordInfo – Fornece informações sobre um registro de um fonte de dados.

Atualizar – Atualiza os registros de um fonte de dados.

Relate – Relaciona registros de duas tabelas por meio de um relacionamento um-para-muitos ou muitos-para-muitos.

Remover – Remove um ou mais registros específicos de um fonte de dados.

RemoveIf – Remove registros de um fonte de dados com base em uma condição.

RenameColumns – Renomeia colunas de uma tabela.

Substituir – Substitui parte de uma string por outra string, pela posição inicial da string.

RequestHide – Oculta um SharePoint formulário.

Redefinir – Redefine um controle de entrada para seu valor padrão, descartando quaisquer alterações do usuário.

ResetForm – Redefine um controle de formulário para edição de um item existente.

reverter – Recarrega e limpa erros para os registros de um fonte de dados.

RGBA – Retorna um valor de cor para um conjunto de componentes vermelho, verde, azul e alfa.

Right – Retorna a parte mais à direita de uma string.

Round – 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 – Encontra registros em uma tabela que contêm uma string em uma de suas colunas.

Segundo – Recupera a segunda parte de um valor de data/hora.

Select – Simula uma ação Select em um controle, fazendo com que a fórmula OnSelect seja avaliada.

Self – Fornece acesso às propriedades do controle atual.

Sequência – Gera uma tabela de números sequenciais, útil ao iterar com ForAll.

SendAppNotification (versão preliminar) – 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 usuário no aplicativo.

Shuffle – Reordena aleatoriamente os registros de uma tabela.

Sin – Retorna o seno de um ângulo especificado em radianos.

Sort – Retorna uma tabela classificada com base em uma fórmula.

SortByColumns – Retorna uma tabela classificada com base em uma ou mais colunas.

Split – Divide uma sequência de texto em uma tabela de substrings.

Sqrt – Retorna a raiz quadrada de um número.

StartsWith – Verifica se uma sequência de texto começa com outra sequência de texto.

StdevP – Retorna o desvio padrão de seus argumentos.

Substituir – Substitui parte de uma string por outra string, correspondendo strings.

SubmitForm – Salva o item em um controle de formulário no fonte de dados.

Sum – Calcula a soma de uma expressão de tabela ou de um conjunto de argumentos.

Switch – Corresponde a um conjunto de valores e então avalia uma fórmula correspondente.

T

Tabela – Cria uma tabela temporária.

Tan – Retorna a tangente de um ângulo especificado em radianos.

Texto – Converte qualquer valor e formata um número ou valor de data/hora em uma sequência de texto.

ThisItem – Retorna o registro do item atual em uma galeria ou controle de formulário.

ThisRecord – Retorna o registro do item atual em uma função de escopo de registro, como ForAll, With e Sum.

Hora – Retorna um valor de data/hora, com base nos valores de Hora, Minuto e Segundo .

TimeValue – Converte uma string somente de hora em um valor de data/hora.

TimeZoneOffset – Retorna a diferença entre UTC e o horário local do usuário em minutos.

Hoje – Retorna o valor atual somente da data.

Rastrear – Forneça informações adicionais nos resultados do seu teste.

Trim – Remove espaços extras das extremidades e do interior de uma sequência de texto.

TrimEnds – Remove espaços extras somente das extremidades de uma sequência de texto.

Trunc – Trunca o número para apenas a parte inteira, removendo qualquer parte decimal.

U

Desagrupar – Remove um agrupamento.

UniChar – Traduz um código Unicode em uma string.

Unrelate – Desvincula registros de duas tabelas de um relacionamento um-para-muitos ou muitos-para-muitos.

Atualização – Substitui um registro em um fonte 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 fonte de dados com base em uma condição.

Upper – Converte letras em uma sequência de texto para todas maiúsculas.

Usuário – Retorna informações sobre o usuário atual.

UTCNow – Retorna o valor de data/hora atual no Tempo Universal Coordenado (UTC).

UTCToday – Retorna o valor atual somente da 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 fonte de dados.

Valor – Converte uma string em um número.

VarP – Retorna a variância de seus argumentos.

ViewForm – Redefine um controle de formulário para visualização de um item existente.

W

Dia da semana – Recupera a parte do dia da semana de um valor de data/hora.

WeekNum – Retorna o número da semana de um valor de data/hora.

Com – Calcula valores e executa ações para um único registro, incluindo registros em linha de valores nomeados.

Y

Ano – Recupera a parte do ano de um valor de data/hora.