Referência de fórmula para o Power Apps

As fórmulas combinam muitos elementos. Abaixo, encontram-se descritos:

  • As funções aceitam parâmetros, executam uma operação e devolvem 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 devolvem informações sobre o ambiente. Por exemplo, Localização devolve as coordenadas GPS atuais do dispositivo. Os sinais não aceitam parâmetros nem têm efeitos secundários.
  • As enumerações devolvem 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.
  • Os operadores com nome, como ThisItem e Self, proporcionam acesso a informações de um contentor.

Outros elementos incluem:

A

Abs – valor absoluto de um número.

Acceleration – lê o sensor de aceleração no seu dispositivo.

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

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

AddColumns – devolve uma tabela com colunas adicionadas.

And – o valor lógico booleano AND. Devolve true se todos os argumentos forem verdadeiros. Também pode utilizar o operador &&.

App – fornece informações sobre a aplicação a ser atualmente executada e permite controlar o comportamento da mesma.

Asin – devolve o arco de seno de um número, em radianos.

Assert – avalia se algo é verdadeiro ou falso num teste.

As – atribui um nome ao registo atual nas funções de galeria, formulário e âmbito de registo, tais como ForAll, With e Sum.

AsType – trata a referência de um registo como um tipo de entidade específico.

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

Atan2 – devolve o arco de tangente com base numa coordenada (x,y), em radianos.

Average – calcula a média de uma expressão de tabela ou conjunto de argumentos.

B

Back – mostra o ecrã anterior.

Blank – devolve um valor em branco que pode ser utilizado para inserir um valor NULO numa origem de dados.

C

Calendar – obtém informações sobre o calendário para a região atual.

Char – converte um código do caráter numa cadeia.

Choices – devolve uma tabela com os valores possíveis de uma coluna de pesquisa.

Clear – elimina todos os dados de uma coleção.

ClearCollect – elimina todos os dados de uma coleção e, em seguida, adiciona um conjunto de registos.

Clock –obtém as informações sobre o relógio para a região atual.

Coalesce – substitui os valores em branco, mantendo os valores que não estão em branco inalterados.

Collect – cria uma coleção ou adiciona dados a uma origem de dados.

Color – define uma propriedade para um valor de cor incorporado.

ColorFade – desvanece um valor de cor.

ColorValue – converte um nome de cor CSS ou um código hexadecimal num valor de cor.

Compass – devolve o cabeçalho de bússola.

Concat – concatena cadeias numa origem de dados.

Concatenar – concatena cadeias.

Concurrent – avalia múltiplas fórmulas em simultâneo.

Connection – devolve informações sobre a ligação de rede.

Count – conta os registos de tabela que contêm números.

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

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

CountA – conta os registos de tabela que não estão vazios.

CountIf – conta os registos de tabela que satisfazem uma condição.

CountRows – conta os registos de tabela.

D

DataSourceInfo – fornece informações sobre uma origem de dados.

Date – 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.

DateTimeValue – converte uma cadeia de data e hora num valor de data/hora.

DateValue – converte uma cadeia só de data num valor de data/hora.

Day – obtém a parte do dia de um valor de data/hora.

Defaults – devolve os valores predefinidos para uma origem de dados.

Degrees – converte radianos em graus.

Disable – desativa um sinal, tal como Location para ler o GPS.

Distinct – resume os registos de uma tabela, removendo os duplicados.

Download – transfere um ficheiro da Web para o dispositivo local.

DropColumns – devolve uma tabela com uma ou mais colunas removidas.

E

EditForm – repõe um controlo de formulário para a edição de um item.

Enable – ativa um sinal, tal como Location para ler o GPS.

EncodeUrl – codifica carateres especiais com codificação do URL.

EndsWith – verifica se uma cadeia de texto termina com outra cadeia de texto.

Errors – fornece informações de erro relativas a alterações anteriores a uma origem de dados.

exactin – verifica se uma cadeia de texto está contida noutra cadeia de texto ou tabela, dependente de maiúsculas/minúsculas. Também usado para verificar se um registo está numa tabela.

Exit – sai da aplicação actualmente em execução e opcionalmente autentica o utilizador actual.

Exp – devolve e elevado a uma potência.

F

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

Find – verifica se uma cadeia é apresentada dentro de outra e devolve a localização.

First – devolve o primeiro registo de uma tabela.

FirstN – devolve o primeiro conjunto de registos (N registos) de uma tabela.

ForAll – calcula valores e realiza ações para todos os registos de uma tabela.

G

GroupBy – devolve uma tabela com registos agrupados.

GUID – converte uma cadeia GUID num valor GUID ou cria um novo valor GUID.

H

HashTags – extrai as hashtags (#cadeias) de uma cadeia.

Hour – 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 for.

IfError – deteta erros e fornece um valor alternativo ou efetua uma ação.

in – verifica se uma cadeia de texto está contida noutra cadeia de texto ou tabela, independente de maiúsculas/minúsculas. Também usado para verificar se um registo está numa tabela.

IsBlank – verifica a existência de um valor em branco.

IsEmpty – verifica a existência de uma tabela vazia.

IsError – verifica a existência de um erro.

IsMatch – verifica uma cadeia em relação a um padrão. Podem ser utilizadas expressões regulares.

IsNumeric – verifica a existência de um valor numérico.

IsToday – verifica se um valor de data/hora é algures hoje.

IsType – verifica se a referência de um registo se refere a um tipo de entidade específico.

J

JSON – gera uma cadeia de texto JSON para uma tabela, registo ou valor.

L

Language – devolve a etiqueta de idioma do utilizador atual.

Last – devolve o último registo de uma tabela.

LastN – devolve o último conjunto de registos (N registos) de uma tabela.

Launch – lança uma página Web ou uma aplicação de tela.

Left – devolve a parte mais à esquerda de uma cadeia.

Len – devolve o comprimento de uma cadeia.

Ln – devolve o registo natural.

LoadData – carrega uma coleção a partir do armazenamento local de um dispositivo.

Location – devolve a sua localização como uma coordenada de mapa através do GPS (Global Positioning System) e outras informações.

Lookup – pesquisa um único registo numa tabela com base em um ou mais critérios.

Lower – converte as letras de uma cadeia de texto em letras minúsculas.

M

Match – extrai uma subcadeia com base num padrão. Podem ser utilizadas expressões regulares.

MatchAll – extrai múltiplas subcadeias com base num 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 do meio de uma cadeia.

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

Minute – obtém a parte do minuto de um valor de data/hora.

Mod – devolve o resto depois de um dividendo ser dividido por um divisor.

Month – obtém a parte do mês de um valor de data/hora.

N

Navigate – altera o ecrã que é apresentado.

NewForm – repõe um controlo de formulário para a criação de um item.

Not – o valor lógico booleano NOT. Devolve true se o respetivo argumento for falso e devolve false se o respetivo argumento for verdadeiro. Também pode utilizar o operador !.

Notify – apresenta uma mensagem em faixa ao utilizador.

Now – devolve o valor de data/hora atual.

O

Or – o valor lógico booleano OR. Devolve true se qualquer um dos respetivos argumentos for verdadeiro. Também pode utilizar o operador ||.

P

Param – parâmetros de acesso transmitidos a uma aplicação de tela quando iniciados.

Parent – proporciona acesso às propriedades de um controlo de recipiente.

Patch – modifica ou cria um registo numa origem de dados ou une registos fora de uma origem de dados.

Pi – devolve o número π.

PlainText – remove etiquetas HTML e XML de uma cadeia.

Power – devolve um número elevado a uma potência. Também pode utilizar o operador ^.

Proper – converte a primeira letra de cada palavra numa cadeia em maiúsculas e converte o resto em minúsculas.

R

Radians – converte graus em radianos.

Rand – devolve um número pseudo-aleatório.

Refresh – atualiza os registos de uma origem de dados.

Relate – associa os registos de duas entidades através de uma relação um-para-muitos ou muitos-para-muitos.

Remove – remove um ou mais registos específicos de uma origem de dados.

RemoveIf – remove registos de uma origem de dados com base numa condição.

RenameColumns – muda o nome de colunas de uma tabela.

Replace – substitui parte de uma cadeia por outra cadeia, pela posição inicial da cadeia.

RequestHide – oculta um formulário do SharePoint.

Reset – repõe o valor predefinido de um controlo de entrada, eliminando quaisquer alterações do utilizador.

ResetForm – repõe um controlo de formulário para a edição de um item existente.

Revert – recarrega e limpa os erros dos registos de uma origem de dados.

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

Right – devolve a parte mais à direita de uma cadeia.

Round – arredonda para o número mais próximo.

RoundDown – arredonda para baixo até ao número anterior maior.

RoundUp – arredonda para cima até ao número seguinte mais pequeno.

S

SaveData – guarda uma coleção para o armazenamento local de um dispositivo.

Search – localiza registos numa tabela que contêm uma cadeia numa das respetivas colunas.

Second – obtém a segunda parte de um valor de data/hora.

Select – simula uma ação de seleção num controlo e faz com que a fórmula OnSelect seja avaliada.

Self – Dá acesso às propriedades do controlo atual.

Sequence – gera uma tabela de números sequenciais, útil quando é feita a iteração com ForAll.

Set – define o valor de uma variável global.

SetFocus – move o foco de introdução para um controlo específico.

SetProperty – simula interações com controlos de introdução.

ShowColumns – devolve uma tabela apenas com as colunas selecionadas.

Shuffle – reordena de forma aleatória os registos de uma tabela.

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

Sort – devolve uma tabela ordenada com base numa fórmula.

SortByColumns – devolve uma tabela ordenada com base em uma ou mais colunas.

Split – divide uma cadeia de texto numa tabela de subcadeias.

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 respetivos argumentos.

Substitute – substitui parte de uma cadeia por outra cadeia, por cadeias correspondentes.

SubmitForm – guarda o item de um controlo de formulário numa origem de dados.

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

Switch – faz a correspondência com um conjunto de valores e, em seguida, avalia uma fórmula correspondente.

T

Table – cria uma tabela temporária.

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

Text – converte qualquer valor e formata um valor de número ou data/hora numa cadeia de texto.

ThisItem – devolve o registo para o item atual numa galeria ou controlo de formulário.

ThisRecord – devolve o registo para o item atual numa função de âmbito de registo, tal como ForAll, With e Sum.

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

TimeValue – converte uma cadeia só de hora num valor de data/hora.

TimeZoneOffset – devolve a diferença entre UTC e a hora local do utilizador em minutos.

Today – devolve o valor de data/hora atual.

Trace – fornece informações adicionais nos resultados do seu teste.

Trim – remove os espaços extra das extremidades e do interior de uma cadeia de texto.

TrimEnds – remove os espaços extra das extremidades de uma cadeia só de texto.

U

Ungroup – remove um agrupamento.

Unrelate – desassocia os registos de duas entidades de uma relação um-para-muitos ou muitos-para-muitos.

Update – substitui um registo numa origem de dados.

UpdateContext – define o valor de uma ou mais variáveis de contexto do ecrã atual.

UpdateIf – modifica um conjunto de registos numa origem de dados com base numa condição.

Upper – converte as letras de uma cadeia de texto em letras maiúsculas.

User – devolve informações sobre o utilizador atual.

V

Validate – verifica se o valor de uma única coluna ou de um registo completo é válido para uma origem de dados.

Value – converte uma cadeia num número.

VarP – devolve a variância dos respetivos argumentos.

ViewForm – repõe um controlo de formulário para a visualização de um item existente.

W

Weekday – obtém a parte do dia da semana de um valor de data/hora.

With – calcula valores e realiza ações num único registo, incluindo registos inline de valores com nome.

Y

Year – obtém a parte do ano de um valor de data/hora.