Compartilhar via


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.

O painel Pesquisar visível dentro do Power Apps Studio .

Pré-requisitos

Abrir o painel Pesquisar

É possível abrir o painel Pesquisar selecionando Pesquisar Ícone 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.

Opção de filtro selecionada no painel Pesquisar.

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).

Mais opções de pesquisa em Categorias na opção de filtro.

  • 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.

    Um exemplo de correspondência de maiúsculas e minúsculas para resultados de pesquisa com resultados para palavras-chave maiúsculas.

  • 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.

    Um exemplo de correspondência da palavra inteira no resultado da pesquisa que limita a pesquisa apenas pela palavra exata.

  • 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.

    Um exemplo de sintaxe de expressão regular correspondente ao pesquisar texto.

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:

Variáveis globais e de contexto disponíveis no 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.

A seleção de uma variável global ou de contexto leva você à tela de informações.

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:

Selecionar uma variável global levará você para a tela de informações das variáveis globais selecionadas.

Variável de contexto selecionada:

Selecionar uma variável de contexto levará você para a tela de informações das variáveis de contexto selecionadas.

Coleções

Selecionar uma coleção sob o cabeçalho Coleções levará você para a tela de informações dessa coleção.

Coleções selecionadas nos resultados da pesquisa mostrando os detalhes relevantes da 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.

Coleções selecionadas nos resultados da pesquisa mostrando os detalhes relevantes dos dados de conexão.

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.

Mídias selecionadas nos resultados da pesquisa mostrando os detalhes relevantes da mídia.

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.

Fluxo selecionado nos resultados da pesquisa mostrando os detalhes relevantes do fluxo.

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.

Componente selecionado nos resultados da pesquisa mostrando os detalhes relevantes do componente.

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.

Telas selecionadas nos resultados da pesquisa mostrando os detalhes relevantes da tela.

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.

Use o botão Atualizar para atualizar os resultados da pesquisa com base nas alterações nos elementos do aplicativo.

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.

Limpar os termos de pesquisa

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.

Lista de resultados de pesquisa qualificados para substituição.

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.

Refine a lista de resultados a serem substituídos.

Você também pode filtrar a lista de resultados para mostrar somente as categorias de resultados selecionadas.

Filtre 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.

Resultados mostrando o total de substituições encontradas.

Se você selecionou resultados da lista, o botão é atualizado para ler Substituir selecionado com a contagem total de itens selecionados.

Botão Substituir selecionado mostrando o número total de itens a serem substituídos.

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.

Selecione as reticências para substituir um resultado individual.

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.

Tela mostrando os resultados das variáveis de 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.

Tela mostrando os resultados das coleções de 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.

Substituição de resultados de telas.

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.

Selecione Substituir para confirmar a substituição e desfazer as substituições.

A confirmação da operação executa a substituição e uma notificação indica se a substituição foi bem-sucedida.

Confirmação de substituições.

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.

A operação de substituição falhou.

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.

Número máximo de resultados alcançado.

Confira também

Usar Localizar e Substituir na barra de fórmulas