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:

To better understand how the New function works, check out the Using Apps with Data Service pages in the How To section.

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.

For more information on using the function, see the Using the New Function page.

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 o 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:

To better understand how the Filter function works, check out the Using Apps with Data Service pages in the How To section.

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:

Depending on your project's needs, you can choose to exclude certain conditions when using the Filter function. To exclude a condition, you can write an expression that resolves the filter field (first parameter of the condition array) to a null. For example, you can use the following:

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

In this case, the filter on City is only applied when the Dropdown contains a value other than blank.

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.