Sobre funções

Para ajudá-lo a definir Expressões específicas ou incluir operações individuais durante o desenvolvimento de seu aplicativo, dentro do designer vem um conjunto de Funções prontas para usar.

Observação: dependendo das especificações da função, algumas têm uma representação gráfica, enquanto outras não.

Comece usando as funções disponíveis, selecionando o operador necessário, insira os parâmetros e aguarde o valor de saída a ser retornado.

Observação:

• Os parâmetros aceitos podem ser o mesmo tipo de argumentos ou elenco de armentos implícitos.
• O valor de saída pode ser primitivo ou um objeto.

Função: operadores

Operações e Funções matemáticas

Para obter mais detalhes, acesse esta página.

Operadores aritméticos

Operador	Description	Exemplo
+	adição	x = y + 2
-	Subtração	x = y - 2
*	Multiplicação	x = y * 2
/	Divisão	x = y / 2
%	Módulo (divisão restante)	x = y % 2
++	Incremento	x = ++y
--	Decremento	x = --y x = y--

Operadores de String

Vamos usar a seguinte hipótese para apresentar os operadores da string: text1 = "Good ", text2 = "Morning", and text3 = "".

Operador	Exemplo	text1	text2	text3
+=	text1 += text2	“Bom dia”	“dia”	“”
&	text3 = text1 + text2	“Bom "	“dia”	“Bom dia”

Operadores de comparação

Vamos usar a seguinte hipótese para apresentar os operadores de comparação: x = 5.

Operador	Description	Comparando	Retorna
=, ==	igual a (“=” é o mesmo que ”==”)	x == 8 x == 5	falso True
>	maior que	x > 8	falso
>=	maior ou igual a	x >= 8	falso
!=	diferente de	x != 8	True
<	menor que	x < 8	True
<=	menor ou igual a	x <= 8	True

Operadores de lógica

Vamos usar a seguinte hipótese para apresentar os operadores lógicos: x=6 e y=3.

Operador	Função	Description	Exemplo
!, not, NOT	Não()	não	!(x === y) is true
&&, and, AND	E()	e	(x < 10 && y > 1) is true
||, or, OR	Ou()	ou	(x === 5 || y === 5) is false

Outros operadores

O operador in retornará um resultado verdadeiro se a propriedade especificada estiver no objeto especificado, caso contrário, retornará um resultado falso.

Observação:

O operador in só é compatível com tipos de dados primitivos, como string, number, boolean e null.

O operador in não é compatível com os cenários do Data Service usando choice-set. Você pode usar o operador contains em vez disso, mas apenas para uma entrada.

Função: Guid

Use esta função para gerar um identificador exclusivo.

Sintaxe	Description
Guid()	Retorna um identificador exclusivo.

Função: nova

Observação: para entender melhor como a função Novo funciona, confira as páginas Como usar Apps com o Data Service na seção Como fazer.

Use esta função para criar uma nova entidade na memória. Essa entidade não será armazenada no Data Service até executar uma regra Criar entidade.

Você pode usar a função Novo para criar um novo registro de entidade, já a função Pesquisar cria um contexto de dados que só pode ser usado para atualizar um registro de entidade existente.

Para obter mais informações sobre como usar a função, consulte a página Como usar a função Novo.

Sintaxe	Description	Exemplo
Novo(Entidade)	Cria uma nova entidade em memória.

Quando uma nova entidade é criada usando a função Novo, os valores padrão serão preenchidos automaticamente.

Função: pesquisar

Dica: para entender melhor como a função Pesquisar funciona, confira as páginas Como usar Apps com o Data Service na seção Como fazer.

Use essa função para localizar e retornar o primeiro registro em uma tabela que satisfaz uma fórmula ou condição.

Sintaxe	Description	Exemplo
Pesquisar(Entidade, Condição)	Retorna o primeiro registro da entidade que corresponde à condição.

Função: filtro

Observação: para entender melhor como a função Filtrar funciona, confira as páginas Como usar Apps com o Data Service na seção Como fazer.

Use essa função para filtrar uma tabela com base em seus campos.

Essa função executa uma verificação que não diferencia entre maiúsculas e minúsculas.

Observação:

Dependendo das necessidades do seu projeto, você pode optar por excluir certas condições ao usar a função Filtro . Para excluir uma condição, você pode escrever uma expressão que resolva o campo de filtro (primeiro parâmetro da matriz de condição) para um null. Por exemplo, você pode usar o seguinte:

Filter(Customer, [If(IsBlank(Dropdown.Value), null, City), "=", Dropdown.Value])

Neste caso, o filtro por Cidade só é aplicado quando o Dropdown contém um valor diferente de em branco.

Sintaxe	Description	Exemplo
Filtrar(Entidade, Condição)	A função retorna todos os registros que resultam em “verdadeiro”. Essas expressões podem fazer referência a campos/colunas por nome.