Usar o painel Pesquisar
Agora você pode usar o painel Pesquisar para localizar objetos — como arquivos de mídia, variáveis, coleções e fontes de dados — em seu aplicativo. Você também pode usar o painel Pesquisar para localizar instâncias repetidas de strings em fórmulas. Por exemplo, usando o painel Pesquisar, você pode procurar cada instância de HoverColor
para determinar a configuração dessa propriedade em outras áreas do seu aplicativo. Você pode usar o painel de Pesquisa para saber mais sobre o que está sendo usado pelo seu aplicativo, onde é possível ir direto aos resultados para fazer as atualizações necessárias. Além disso, é possível usar o recurso de substituição para atualizar uma ou mais instâncias de texto, variáveis, coleções ou referências de fórmula.
Pré-requisitos
- Inscreva-se no Power Apps.
- Crie um aplicativo usando um modelo, crie um aplicativo, ou abra um aplicativo existente no Power Apps.
- Saiba como configurar um controle.
Abrir o painel Pesquisar
É possível abrir o painel Pesquisar selecionando Pesquisar . Também é possível usar as teclas de atalho selecionando Ctrl+F quando o cursor estiver fora da barra de fórmulas ou selecionando Ctrl+Shift+F quando o cursor estiver dentro da barra de fórmulas.
Você também pode abrir o painel Pesquisar diretamente na funcionalidade Substituir selecionando Ctrl+H quando o cursor estiver fora da barra de fórmulas ou selecionando Ctrl+Shift+H quando o cursor estiver dentro da barra de fórmulas.
Observação
Selecionando Ctrl+F ou Ctrl+H dentro da barra de fórmulas abrirá o recurso Localizar e Substituir dentro da barra de fórmulas.
Filtrar resultados da pesquisa
Você pode filtrar os resultados da pesquisa selecionando uma ou mais categorias. Essas categorias ajudam você a afunilar a pesquisa ao restringir as áreas dentro do aplicativo — como telas, mídia e coleções.
Para selecionar as categorias nas quais você deseja pesquisar, use a opção de filtro ao lado da caixa de pesquisa. A seleção padrão é Tudo, que pesquisa em todas as categorias no aplicativo aberto.
O exemplo a seguir mostra os resultados da pesquisa filtrados para o termo de pesquisa Neve com as categorias selecionadas de Variáveis e Coleções.
Refinar sua pesquisa
Você pode usar mais opções de pesquisa para refinar ainda mais sua pesquisa. Estas opções estão disponíveis dentro da opção de filtro chamada Mais opções de pesquisa (abaixo da seção Categorias).
Diferenciar maiúsculas de minúsculas retorna resultados de pesquisa somente com correspondências especificadas de maiúsculas e minúsculas.
No exemplo a seguir, as instâncias de Neve (N maiúsculo) aparecerão como uma correspondência, mas neve (N minúsculo) não.
Corresponder palavra inteira retorna resultados de pesquisa com correspondências exatas de toda a sequência de caracteres.
No exemplo a seguir, Neve retorna apenas alguns resultados, embora Neve apareça nos nomes muitas vezes em todos os objetos do aplicativo.
Usar expressão regular (RegEx) retorna apenas resultados com correspondências em conformidade com a expressão regular especificada na área de entrada.
No exemplo a seguir, usar o recurso de pesquisa Expressão Regular com a fórmula
Snowboarding( Mountain | Dashboard)
retorna correspondências de Surf na neve quando ela aparece com Montanha ou Painel.
Trabalhar com resultados de pesquisa
A seleção de resultados de pesquisa em diferentes áreas do painel de pesquisa terá um comportamento diferente dependendo do contexto do resultado. Os resultados da pesquisa podem ser classificados em duas grandes categorias—Definições e Instâncias:
Definições descrevem o objeto referido em seu aplicativo, geralmente em uma fórmula.
Existem vários cabeçalhos de categoria dentro do painel Pesquisar que você pode usar para navegar pelos resultados. Categorias como Variáveis, Coleções, Dados, Mídia, Fluxos e Componentes são referidos como Definições.
A seleção dos resultados sob esses cabeçalhos de categoria de definição leva você para a tela de informações apropriada, como para Variáveis e Coleções, ou para o painel apropriado onde esse objeto está disponível em seu aplicativo (como Dados, Mídia, Fluxos ou Componentes).
Instâncias descrevem os resultados da pesquisa vinculados a um aplicativo, tela ou propriedade de controle individual na barra de fórmulas. Todos esses resultados estão ligados à categoria Telas com base na estrutura encontrada dentro do Exibição em Árvore. Quando seleciona um resultado nesta categoria Telas, você será levado a essa referência específica da barra de fórmulas ou ao controle relacionado, conforme aplicável.
Variáveis
Selecionar uma variável global ou de contexto sob o cabeçalho Variáveis nos resultados da pesquisa levará você para a tela de informações Variáveis para a seleção.
Conforme mostrado abaixo, você é levado à definição da variável global ou de contexto, dependendo de sua seleção nos resultados de pesquisa disponíveis.
Resultado da pesquisa:
Se estiver usando a versão preliminar do Power Apps Studio, selecione Variáveis de contexto ou Variáveis globais para ver mais informações sobre a variável.
Se estiver usando a versão clássica do Power Apps Studio, dependendo da variável global ou de contexto selecionada, você será levado para a tela de informações do tipo de variável selecionado.
Variável global selecionada:
Variável de contexto selecionada:
Coleções
Selecionar uma coleção sob o cabeçalho Coleções levará você para a tela de informações dessa coleção.
Dados
Selecionar um resultado no cabeçalho Dados abre o painel Dados e preenche previamente a entrada de pesquisa para esse painel usando o texto do resultado selecionado.
Mídia
Selecionar um resultado no cabeçalho Mídia abre o painel Mídia e preenche previamente a entrada de pesquisa para esse painel com o texto do resultado selecionado.
Fluxos
O cabeçalho Fluxos só aparecerá se você tiver habilitado o painel do Power Automate (versão preliminar). Selecionar um resultado aqui abre o painel Power Automate e preenche previamente a entrada de pesquisa para esse painel com o texto do resultado selecionado.
Componentes
Selecionar um resultado sob o cabeçalho Componentes leva você para a seção de componentes no painel Exibição em árvore e preenche previamente a entrada de pesquisa para esse painel com o texto do resultado selecionado.
Telas
Selecionar um resultado no cabeçalho Tela também seleciona o controle ou tela apropriado na tela e abre a propriedade do resultado na barra de fórmulas. O resultado selecionado também é destacado na barra de fórmulas.
Atualização dos resultados da pesquisa
Se você fizer alterações no aplicativo, precisará atualizar o painel de resultados para ver a alteração refletida nos resultados da pesquisa.
Limpar o termo de pesquisa
Os termos de pesquisa e os resultados são mantidos até que você não precise mais deles. Para limpar o termo de pesquisa e os resultados, selecione o X à direita da área de entrada.
Replace
Você pode substituir uma ou mais instâncias de determinados tipos de resultados de pesquisa, incluindo nomes de variáveis, nomes de coleções, qualquer texto de fórmula, incluindo cadeias de caracteres ou outras referências de fórmula.
Depois de realizar uma pesquisa, o pivô de substituição mostra a lista de resultados da pesquisa que podem ser substituídos.
Substituir resultados
Todos os resultados que podem ser substituídos são selecionados por padrão. Você pode refinar a lista de resultados a serem substituídos desmarcando resultados individuais ou categorias inteiras marcando a caixa de seleção ao lado do resultado ou título da categoria.
Você também pode filtrar a lista de resultados para mostrar somente as categorias de resultados selecionadas.
À medida que você refina a lista de resultados a serem substituídos, o botão Substituir na parte inferior do painel registra o número de substituições a serem feitas. Se todos os itens forem selecionados, o botão exibirá Substituir tudo com a contagem total de todos os itens substituíveis.
Se você selecionou resultados da lista, o botão é atualizado para ler Substituir selecionado com a contagem total de itens selecionados.
Você também pode interagir diretamente com resultados individuais na lista de resultados para realizar substituições selecionando as reticências à direita de cada resultado individual na lista de resultados.
Substituição de resultados de variáveis
A execução de uma substituição de resultados na categoria Variáveis substitui o nome da variável no nível de definição, o que significa que todas as instâncias do nome da variável correspondente serão substituídas em todo o aplicativo. Você também pode exibir os detalhes da variável na tela de informações para examinar o uso antes de fazer a substituição.
Substituição de resultados de coleções
De forma semelhante às variáveis, substituir um resultado na categoria Coleções substitui o nome da coleção no nível de definição, substituindo todas as instâncias correspondentes do nome da coleção no aplicativo. Você pode exibir os detalhes da coleta na tela de informações antes de fazer a substituição.
Substituição de resultados de telas
A categoria Telas mostra resultados substituíveis individuais seguindo a estrutura na exibição em árvore para que você possa substituir texto em fórmulas, referências de fórmulas e nomes de controle. As substituições feitas na categoria Telas substituem apenas a instância única do resultado correspondente selecionado, para que você possa escolher o que deseja substituir. Você também pode revisar a correspondência de fórmulas antes de fazer a substituição.
Concluir a substituição e desfazer as substituições
Depois de refinar sua seleção para os itens que deseja substituir, a seleção do botão solicita que você confirme a operação.
A confirmação da operação executa a substituição e uma notificação indica se a substituição foi bem-sucedida.
A operação de substituição pode falhar se um nome de controle já estiver em uso ou se forem incluídos caracteres não compatíveis.
Após a conclusão da substituição, você pode desfazer a substituição usando o botão de desfazer ou selecionando Ctrl+Z.
Limitações
O painel Pesquisar está limitado a retornar no máximo 2.000 resultados. Uma notificação será exibida se você exceder esse limite.