Sobre expressões

Introdução

Observação:

Para entender melhor como as expressões funcionam, confira a página de Usar expressões na seção Como fazer.

As expressões consistem em várias operações que permitem transformar, modificar e computar os dados em um aplicativo para retornar o resultado de uma saída. As expressões podem ser usadas em vários cenários, tais como:

• Associar com variáveis, saída de processo e outros valores de controle do painel de recursos.
• Concatenar strings usando o símbolo &.
• Executar operações comparativas.
• Criar operadores lógicos em operações comparativas.
• Definir valores de controle por meio da função If adicionada às operações comparativas.
• Executar operações aritméticas com a ajuda de expressões.
• Declarar dados estáticos como “String”, true/false, 123 etc ou listas estáticas de primitivos como uma lista de strings.
• Controlar hidden, disabled, font/background color properties.
• Referenciar um registro ou campo selecionado em um registro de outro controle.

Configuração de expressões

As seguintes operações podem ser usadas ao configurar expressões:

• Funções
• Operadores nomeados

Funções

As seguintes funções são disponibilizadas para o Apps:

Função	Description
And, Or, Not	A função And retornará true se todos os argumentos forem verdadeiros. A função Or retornará true se algum dos argumentos for verdadeiro. A função Not retornará true se seus argumentos forem falsos e retornará “false” se seu argumento for verdadeiro.
CONCAT	Combina várias strings em uma
Contém	Retornará “true” se uma string incluir um fragmento de texto.
Termina com	Retornará “true” se uma string terminar com um fragmento de texto.
If	Retornará um valor SE uma condição for true e outro valor se não for verdadeira.
IsBlank	Verifica um valor em branco.
Tamanho	Retornará o comprimento de uma string de texto.
Inicia com	Retornará “true” se uma string começar com um fragmento de texto.
Soma	Soma uma coluna específica em uma tabela ou controle de lista personalizada.
Classificar	Classifique as informações de uma fonte com base em seus campos.
Agora	Retorna a data e hora atuais em seu fuso horário.
Hoje	Retorna a data atual em seu fuso horário.
Hora	Retorna a hora atual em seu fuso horário.
Ano	Retorna o componente do ano de um valor de Data/hora.
Mês	Retorna o componente do mês de um valor de Data/hora.
Dia	Retorna o componente do dia de um valor de Data/hora.
Hora	Retorna o componente da hora de um valor de Data/hora.
Minuto	Retorna o componente do minuto de um valor de Data/hora.
Novo	Cria uma nova entidade na memória.
Busca	Encontre e retorne o primeiro registro em uma tabela que satisfaça uma fórmula ou condição.
Filtro	Filtre uma tabela com base em seus campos.

Operadores

Além das funções, as expressões do Apps também são compatíveis com condicionais e operadores matemáticos. Para obter os operadores compatíveis, consulte a tabela abaixo.

Categoria	Operador
Expressão aditiva	+, -
Expressão Atômica	(), Literal, Variável, Funções
Expressão de comparação	<, <=, >, >=, in
Expressão de concatenação	&
Expressão de igualdade	==, !=
Expressão de exponenciação	^
Expressão lógica	&&, and, AND, | |, or, OR
Expressão multiplicativa	*, /, %
Expressão unária	!, not, NOT, unária +, unária -

Onde as expressões podem ser usadas

As expressões podem ser usadas para o seguinte:

• Controles
• Regras

Controles

As expressões são habilitadas em relação às propriedades ocultas e desabilitadas dos controles a seguir e seus valores de exibição:

• Botão — Texto (ícone não é compatível)
• Caixa de seleção — Rótulo, verificado
• DatePicker — Texto de dica
• Menu suspenso — Texto de dica e Padrão selecionado
• Alternador — Rótulo, On
• Área de texto — Texto padrão, Texto de dica
• Caixa de texto — Texto padrão, Texto de dica
• Rótulo — Texto
• Cabeçalho — Texto
• Imagem — URL

Observação:

Quando usadas em propriedades de controle, as expressões são reavaliadas no tempo de execução caso algum de seus valores dependentes for alterado.

Regras

As regras são usadas para habilitar a lógica condicional. É possível usar expressões nas seguintes regras:

• If — Comparar, agrupar
• Abrir URL — URL
• Mostrar mensagem — Título, Mensagem
• Exibir/ocultar controle giratório — Mensagem
• Iniciar processo — Substituição de entrada
• Definir valor — Valor

Observação:

As expressões não são reavaliadas continuamente quando usadas em regras, apenas no momento em que a regra for acionada.