Introdução às fórmulasGet started with formulas

Configure a sua aplicação com fórmulas que não só calculam valores e fazem outras tarefas (tal como fazem no Excel), como também respondem à intervenção dos utilizadores (como as aplicações devem fazer).Configure your app with formulas that not only calculate values and perform other tasks (as they do in Excel) but also respond to user input (as an app requires).

  • No Excel, pode criar fórmulas que, por exemplo, povoam células e criam tabelas e gráficos.In Excel, you build formulas that, for example, populate cells and create tables and charts.
  • No PowerApps, pode criar fórmulas semelhantes quando configura controlos em vez de células.In PowerApps, you build similar formulas as you configure controls instead of cells. Além disso, estas fórmulas aplicam-se especificamente a aplicações, em vez de folhas de cálculo.In addition, you build formulas that apply specifically to apps instead of spreadsheets.

Por exemplo, pode criar uma fórmula que determina como é que a aplicação responde quando um utilizador seleciona um botão, ajusta um controlo de deslize ou tem outra intervenção.For example, you build a formula to determine how your app responds when users select a button, adjust a slider, or provide other input. Estas fórmulas podem mostrar um ecrã diferente, atualizar uma origem de dados externa à aplicação ou criar uma tabela que contenha um subconjunto dos dados de uma tabela já existente.These formulas might show a different screen, update a data source that's external to the app, or create a table that contains a subset of the data in an existing table.

Pode utilizar fórmulas para diversos cenários.You can use formulas for a wide variety of scenarios. Por exemplo, pode utilizar o GPS do seu dispositivo, um controlo de mapa e uma fórmula que utilize a Latitude da Localização e a Longitude da Localização para apresentar a sua localização atual.For example, you can use your device's GPS, a map control, and a formula that uses Location.Latitude and Location.Longitude to display your current location. À medida que se move, o mapa regista automaticamente a sua localização.As you move, the map automatically tracks your location.

Este tópico oferece apenas uma descrição geral para trabalhar com fórmulas.This topic provides only an overview of working with formulas. Navegue pela referência da fórmula para obter mais detalhes e a lista completa de funções, operadores e outros blocos modulares que pode utilizar.Browse the formula reference for more details and the complete list of functions, operators, and other building blocks you can use.

Pré-requisitosPrerequisites

Mostrar um valor simplesShow a simple value

No Excel, pode introduzir dados específicos, como o número 42 ou a expressão Olá, Mundo, ao escrevê-los numa célula.In Excel, you can enter a specific piece of data, such as the number 42 or the phrase Hello World, by typing it into a cell. Essa célula mostrará sempre os dados exatamente como os escreveu.That cell will always show that data exactly as you typed it. Do mesmo modo, no PowerApps, pode especificar dados que não são alterados ao definir a propriedade Text de uma etiqueta como a sequência exata dos carateres que pretende, entre aspas.In PowerApps, you can similarly specify a piece of data that doesn't change by setting the Text property of a label to the exact sequence of characters that you want, surrounded by double quotation marks.

  1. Selecione Novo, no menu Ficheiro (junto à extremidade esquerda do ecrã).Select New on the File menu (near the left edge of the screen).
  2. Em Criar uma aplicação, selecione Esquema de telemóvel, no mosaico Aplicação vazia.Under Create an app, select Phone layout on the Blank app tile.

    A barra de fórmulas está na parte superior do ecrã.The formula bar sits at the top of the screen.

    Barra de fórmulas

    Esta barra tem duas partes:This bar has two parts:

    • Lista de propriedades: cada controlo e cada ecrã tem um conjunto de propriedades.Property list: Each control and screen has a set of properties. Utilize esta lista para selecionar uma propriedade específica.Use this list to select a specific property.
    • Fórmula: a fórmula a calcular para esta propriedade, composta por valores, operadores e funções.Formula: The formula to be calculated for this property, made up of values, operators, and functions.

      Na barra de fórmulas, pode ver e editar as propriedades do controlo selecionado ou do ecrã, se não forem selecionados controlos.In the formula bar, you can see and edit properties for the selected control or for the screen if no controls are selected. Pode ver o nome do controlo selecionado no separador Conteúdo:You can see the name of the selected control on the Content tab:

      A barra de conteúdo mostra o controlo atualmente selecionado

      Pode alterar o nome do controlo selecionado no separador Conteúdo ao clicar no nome.You can change the name of the selected control in the Content tab by clicking the name.

  3. Adicione um controlo Etiqueta ao ecrã.Add a Label control to the screen.

    Controlo TextBox adicionado

    Quando adiciona uma etiqueta, a lista de propriedades mostra automaticamente a propriedade Text, que determina o que o controlo mostra.When you add a label, the property list automatically shows the Text property, which drives what the control shows. Por predefinição, o valor desta propriedade é "Text".By default, the value of this property is "Text".

  4. Defina o valor da propriedade Text como "Olá, Mundo" ao escrever essa cadeia, entre aspas, na barra de fórmulas:Set the value of the Text property to "Hello World" by typing that string, surrounded by double quotes, into the formula bar:

    Utilizar a etiqueta "Olá, Mundo"

    A etiqueta reflete este valor novo à medida que o escreve.The label reflects this new value as you type it. O ecrã poderá mostrar ícones de ponto de exclamação amarelos enquanto escreve.The screen may show yellow exclamation-point icons while you type. Estes ícones indicam erros, mas desaparecem quando termina de introduzir um valor válido.These icons indicate errors, but they'll go away when you finish entering a valid value. Por exemplo, uma cadeia sem aspas no princípio e no fim não é válida.For example, a string without double quotation marks on both ends isn't valid.

    No Excel, pode mostrar um número, tal como 42, ao escrevê-lo numa célula ou ao escrever uma fórmula que seja resolvida para esse número, tal como =SUM(30,12).In Excel, you can show a number, such as 42, by typing it into a cell or by typing a formula that resolves to that number, such as =SUM(30,12). No PowerApps, pode obter o mesmo efeito ao definir a propriedade Text de um controlo, como uma etiqueta, como 42 ou Sum(30,12).In PowerApps, you can achieve the same effect by setting the Text property of a control, such as a label, to 42 or Sum(30,12). A célula e a etiqueta mostrarão sempre esse número, independentemente de outras alterações que possam ocorrer na folha de cálculo ou na aplicação.The cell and the label will always show that number regardless of what else changes in the worksheet or the app.

    Nota: no PowerApps, as fórmulas não são precedidas de um sinal de igual ou de mais, como acontece no Excel.Note: In PowerApps, you don't precede a formula with an equals sign or a plus sign as you do in Excel. Por predefinição, a barra de fórmulas trata tudo o que aí escrever como uma fórmula.The formula bar treats anything you type there as a formula by default. Do mesmo modo, as fórmulas não são colocadas entre aspas, ao contrário do que fez anteriormente para especificar uma cadeia de texto.You also don't surround a formula with double quotation marks ("), as you did earlier to specify a string of text.

  5. Na propriedade Text da etiqueta, substitua “Hello World” por Sum(1,2,3).In the Text property of the label, replace "Hello World" with Sum(1,2,3).

    Escrever a função parcial Sum(1,2,3 sem fechar os parêntesis apresenta erros

    A barra de fórmulas ajuda-o à medida que escreve, ao mostrar a descrição e os argumentos esperados para essa função.While you type, the formula bar helps you by showing the description and the expected arguments for this function. Tal como sucede com as aspas de fecho em Olá, Mundo, o ecrã mostra pontos de exclamação amarelos para indicar a existência de erros até que escreva o parêntesis no fim da fórmula:As with the final double quotation mark in "Hello World", the screen shows yellow exclamation points to indicate an error until you type the final parenthesis of this formula:

    Utilizar a fórmula completa Sum(1,2,3)

Alterar um valor com base numa entradaChange a value based on input

No Excel, escreve =SUM(A1:A2) numa célula para mostrar a soma dos valores presentes nas células A1 e A2.In Excel, you type =SUM(A1:A2) into a cell to show the sum of whatever values cells A1 and A2 contain. Se um ou ambos os valores forem alterados, a célula que contém a fórmula mostra automaticamente o resultado atualizado.If either or both of those values change, the cell that contains the formula automatically shows the updated result.

Ilustração do Excel a recalcular a soma de dois números

No PowerApps, pode obter um resultado semelhante ao adicionar controlos e definir as respetivas propriedades.In PowerApps, you can achieve a similar result by adding controls and setting their properties. Este exemplo mostra a etiqueta do procedimento anterior e dois controlos de Introdução de texto chamados TextInput1 e TextInput2.This example shows the label from the previous procedure and two Text input controls, named TextInput1 and TextInput2.

Ilustração do PowerApps a recalcular a soma de dois números

Independentemente dos números que escrever nos controlos de introdução de texto, a etiqueta mostra sempre a soma desses números, porque a propriedade Text está definida com a fórmula seguinte:Regardless of what numbers you type in the text-input controls, the label always shows the sum of those numbers because its Text property is set to this formula:
TextInput1 + TextInput2TextInput1 + TextInput2

Ilustração do PowerApps a recalcular a soma de dois números

No Excel, pode utilizar a formatação condicional para mostrar, por exemplo, valores negativos a vermelho.In Excel, you can use conditional formatting to show, for example, negative values in red. No PowerApps, é utilizada uma fórmula que contém a função if, que tem um comportamento semelhante ao comportamento no Excel.In PowerApps, you use a formula that contains the If function, which behaves similarly to how it behaves in Excel.

  1. Defina a propriedade Color da etiqueta para esta fórmula:Set the Color property of the label to this formula:
    If( Value(TextBox1.Text) < 0, Red, Black )If( Value(TextBox1.Text) < 0, Red, Black )

    Nota: numa fórmula, especifique a propriedade de um controlo ao indicar o nome do mesmo, seguido de ponto final, seguido do nome da propriedade.Note: In a formula, specify the property of a control by providing the name of the control, followed by a period, followed by the name of the property. Por exemplo, escreva TextBox1.Text para especificar a propriedade Text de TextBox1.For example, specify the Text property of TextBox1 by typing TextBox1.Text.

    Ilustração do PowerApps a recalcular a alteração da cor de uma etiqueta com base no valor da mesma

  2. Em TextInput1 e TextInput2, especifique dois números que, quando somados, resultam num número negativo.In TextInput1 and TextInput2, specify two numbers that, when added together, result in a negative number.

    Ilustração do PowerApps a recalcular a alteração da cor de uma etiqueta com base no valor da mesma

    O valor na etiqueta é apresentado a vermelho.The value in the label appears in red.

Alterar uma cor com base numa entrada do utilizadorChange a color based on user input

Pode configurar a sua aplicação com fórmulas, para que os utilizadores possam alterar o aspeto ou comportamento da aplicação.You can configure your app with formulas so that users can change your app's appearance or behavior. Por exemplo, pode criar um filtro que mostre apenas os dados que contenham uma cadeia de texto especificada pelos utilizadores ou pode permitir que estes ordenem um conjunto de dados com base numa determinada coluna desse conjunto.For example, you can create a filter to show only data that contains a string of text that the user specifies, or you can let users sort a set of data based on a certain column in the data set. Neste procedimento, vai permitir que os utilizadores alterem a cor do ecrã mediante o ajuste de um ou mais controlos de deslize.In this procedure, you'll let users change the color of the screen by adjusting one or more sliders.

  1. Remova os controlos dos procedimentos anteriores ou crie uma aplicação em branco como fez antes e adicione três controlos de deslize à mesma:Remove the controls from the previous procedures, or create a blank app as you did previously, and add three slider controls to it:

    Inserir um controlo de deslize

  2. Disponha os controlos de deslize de modo a não se sobreporem, adicione três etiquetas e configure-as para mostrar Vermelho, Verde e Azul:Arrange the sliders so they don't overlap, add three labels, and configure them to show Red, Green, and Blue:

    Dispor os controlos de deslize e adicionar etiquetas para cada componente de cor

  3. Defina a propriedade Max de cada controlo de deslize como 255, que é o valor máximo dos componentes de cor da função RGBA.Set the Max property of each slider to 255, which is the maximum value of a color component for the RGBA function.

    Pode especificar a propriedade Max ao selecioná-la no separador Conteúdo ou na lista de propriedades:You can specify the Max property by selecting it on the Content tab or in the property list:

    Alterar o valor máximo de cada controlo de deslize

  4. Selecione o ecrã ao clicar fora de qualquer controlo e, em seguida, defina a propriedade Fill do ecrã como esta fórmula:Select the screen by clicking away from any control, and then set the screen's Fill property to this formula:
    RGBA( Slider1.Value, Slider2.Value, Slider3.Value, 1 )RGBA( Slider1.Value, Slider2.Value, Slider3.Value, 1 )

    Como já foi descrito, para aceder às propriedades do controlo, é utilizado o operador .As already described, you access control properties by using the . .operator. Slider1.Value refere-se à propriedade Value do controlo de deslize, que reflete onde o utilizador colocou o controlo de deslize entre os valores Mín e Máx.Slider1.Value refers to the slider's Value property, which reflects where the user has placed the slider between the Min and Max values. À medida que escreve esta fórmula, cada controlo contido na mesma apresenta um código de cor entre o ecrã e a barra de fórmulas:As you type this formula, each control that it contains is color coded between the screen and the formula bar:

    Alterar a fórmula da cor de preenchimento do fundo do ecrã, mas ainda por concluir

    À medida que escreve o parêntesis final, o fundo do ecrã muda para cinzento escuro com base no valor predefinido de cada controlo de deslize, que é 50.As you type the closing parenthesis, the screen's background will change to dark gray based on the default value of each slider, which is 50. Quando terminar de escrever a fórmula, esta é calculada e utilizada como o valor da cor do preenchimento do fundo.At the moment when you finish typing the formula, it's calculated and used as the value of the background fill color. Pode interagir com a sua aplicação quando está na área de trabalho predefinida sem ter de abrir a Pré-visualização:You can interact with your app while in the default workspace without needing to open Preview:

    Alterar o valor máximo de cada controlo de deslize

  5. Ajuste os controlos de deslize e veja como as alterações afetam a cor de fundo.Adjust the sliders, and see how your changes affect the background color.

    À medida que cada controlo de deslize é alterado, a fórmula que contém a função RGBA é recalculada, o que muda imediatamente a forma como o ecrã aparece.As each slider changes, the formula that contains the RGBA function is recalculated, which immediately changes how the screen appears.

    Alterar a fórmula da cor de preenchimento do fundo do ecrã, agora concluída

Gerir o comportamento da aplicaçãoManage app behavior

Pode utilizar fórmulas não só para fazer novos cálculos e alterar o aspeto, mas também para efetuar ações.You can use formulas not only to perform calculations and change appearance but also to take action. Por exemplo, pode definir a propriedade OnSelect de um botão como uma fórmula que inclua a função Navegar.For example, you can set the OnSelect property of a button to a formula that includes the Navigate function. Quando um utilizador seleciona este botão, é apresentado o ecrã que especificou na fórmula.When a user selects that button, the screen that you specify in the formula appears.

Pode utilizar algumas funções, como Navegar e Recolher, apenas nas fórmulas de comportamento.You can use some functions, such as Navigate and Collect, only in behavior formulas. A referência da fórmula avisa se puder utilizar uma função apenas neste contexto.The formula reference calls out if you can use a function only in this context.

Pode efetuar mais de uma ação numa fórmula de comportamento se separar as funções por ponto e vírgula (;).You can take more than one action in a behavior formula if you separate functions with a semi-colon (;). Por exemplo, poderá querer atualizar uma variável de contexto, enviar dados para uma origem de dados e, finalmente, navegar para outro ecrã.For example, you might want to update a context variable, push data to a data source, and finally navigate to another screen.

Ver uma lista de propriedades por categoriaView a list of properties by category

A lista de propriedades mostra as propriedades por ordem alfabética, mas também pode ver todas as propriedades de um controlo organizadas por categoria se selecionar a opção Avançada no separador Vista:The properties list shows properties alphabetically, but you can also view all the properties of a control, organized by category, if you select the Advanced option on the View tab:

Vista avançada

Pode editar fórmulas diretamente nesta vista.You can edit formulas directly within this view. Com o seletor de controlos, na parte superior do painel, pode encontrar rapidamente um controlo com o qual trabalhar.With the control selector at the top of the pane, you can quickly find a control to work with. E com a pesquisa de propriedades, pode encontrar rapidamente uma propriedade desse controlo.And with the property search, you can quickly find a property of that control.

De início, esta vista mostra as propriedades mais importantes.Initially, this view shows the most important properties. Para revelar todas as propriedades, clique na seta para baixo, na parte inferior do painel.To reveal all the properties, click the down arrow at the bottom of the pane. Cada controlo tem uma longa lista de propriedades que controlam todos os pormenores do respetivo comportamento e aspeto.Each control has a long list of properties that govern all aspects of the control's behavior and appearance. Pode percorrer a lista ou escrever uma propriedade na caixa, na parte superior do painel, para a procurar.You can scroll through the list or search for a property by typing in the box at the top of the pane.

Sintaxe das fórmulasFormula syntax

À medida que escreve uma fórmula na barra de fórmulas, os diferentes elementos de sintaxe são apresentados com cores diferentes para melhorar a legibilidade e ajudá-lo a compreender fórmulas longas.As you type a formula in the formula bar, different syntax elements appear in different colors to improve readability and help you understand long formulas. Apresentamos a seguir a lista de código de cor no PowerApps.Here is the color code list in PowerApps.

realce da sintaxe